From 61b3bf8b7c054cf8190ecc6e6bacce8bcf954dcc Mon Sep 17 00:00:00 2001 From: James Babcock Date: Sat, 5 Sep 2026 21:40:20 -0700 Subject: [PATCH 01/99] Project setup for iOS version of the app --- .gitignore | 2 +- App_Resources/iOS/Info.plist | 30 ++ App_Resources/iOS/build.xcconfig | 5 + README.md | 4 +- app/app.ios.css | 12 + app/app.ts | 10 +- app/bootstrap.android.ts | 8 + app/bootstrap.ios.ts | 47 +++ iOS/Faceclaw.xcodeproj/project.pbxproj | 350 ++++++++++++++++++ .../contents.xcworkspacedata | 7 + .../AccentColor.colorset/Contents.json | 11 + .../AppIcon.appiconset/Contents.json | 85 +++++ iOS/Faceclaw/Assets.xcassets/Contents.json | 6 + iOS/Faceclaw/ContentView.swift | 24 ++ iOS/Faceclaw/FaceclawApp.swift | 17 + package-lock.json | 8 + package.json | 5 + webpack.config.js | 12 + 18 files changed, 633 insertions(+), 10 deletions(-) create mode 100644 App_Resources/iOS/Info.plist create mode 100644 App_Resources/iOS/build.xcconfig create mode 100644 app/app.ios.css create mode 100644 app/bootstrap.android.ts create mode 100644 app/bootstrap.ios.ts create mode 100644 iOS/Faceclaw.xcodeproj/project.pbxproj create mode 100644 iOS/Faceclaw.xcodeproj/project.xcworkspace/contents.xcworkspacedata create mode 100644 iOS/Faceclaw/Assets.xcassets/AccentColor.colorset/Contents.json create mode 100644 iOS/Faceclaw/Assets.xcassets/AppIcon.appiconset/Contents.json create mode 100644 iOS/Faceclaw/Assets.xcassets/Contents.json create mode 100644 iOS/Faceclaw/ContentView.swift create mode 100644 iOS/Faceclaw/FaceclawApp.swift diff --git a/.gitignore b/.gitignore index 5f98a77a..0559f6db 100644 --- a/.gitignore +++ b/.gitignore @@ -42,4 +42,4 @@ faceclaw_settings.xml # Developer configs build_paths.sh - +**/xcuserdata/ diff --git a/App_Resources/iOS/Info.plist b/App_Resources/iOS/Info.plist new file mode 100644 index 00000000..98cc8471 --- /dev/null +++ b/App_Resources/iOS/Info.plist @@ -0,0 +1,30 @@ + + + + + CFBundleDevelopmentRegion + en + CFBundleExecutable + $(EXECUTABLE_NAME) + CFBundleName + $(PRODUCT_NAME) + CFBundlePackageType + APPL + CFBundleDisplayName + Faceclaw + CFBundleShortVersionString + 1.0.0 + CFBundleVersion + 1 + LSRequiresIPhoneOS + + UILaunchScreen + + UISupportedInterfaceOrientations + + UIInterfaceOrientationPortrait + + UIRequiresFullScreen + + + diff --git a/App_Resources/iOS/build.xcconfig b/App_Resources/iOS/build.xcconfig new file mode 100644 index 00000000..e11b5908 --- /dev/null +++ b/App_Resources/iOS/build.xcconfig @@ -0,0 +1,5 @@ +IPHONEOS_DEPLOYMENT_TARGET = 15.1; +TARGETED_DEVICE_FAMILY = 1; +CODE_SIGN_STYLE = Automatic; + +// Select the local signing team in Xcode or pass --teamId to the iOS scripts. diff --git a/README.md b/README.md index bbc693aa..be3f29bd 100644 --- a/README.md +++ b/README.md @@ -29,6 +29,9 @@ walk you through pairing with the glasses and installing custom firmware. ## Compiling +For the initial NativeScript iOS port, see [iOS development](notes/ios-development.md). +The instructions below build the Android app. + If you want to customize faceclaw, the best way to do it is to download the source code and using a coding agent such as Codex or Claude Code. @@ -186,4 +189,3 @@ mention them and link to that provider's privacy policy. For services that involve a user-provided API key, we assume that the user agreed to any terms associated with that service when they generated the key. For services that don't involve API keys, more caution may be required. - diff --git a/app/app.ios.css b/app/app.ios.css new file mode 100644 index 00000000..71b27f3c --- /dev/null +++ b/app/app.ios.css @@ -0,0 +1,12 @@ +Page { + background-color: #f5f5f2; + color: #202820; +} + +Button { + background-color: #285c45; + color: #ffffff; + border-radius: 12; + padding: 16; + font-size: 17; +} diff --git a/app/app.ts b/app/app.ts index b1f9e59b..ea0c6024 100644 --- a/app/app.ts +++ b/app/app.ts @@ -4,13 +4,7 @@ You can use this file to perform app-level initialization, but the primary purpose of the file is to pass control to the app’s first module. */ -import { Application } from '@nativescript/core' -import { registerShareIntentHandler } from './native/share-intents' -import { installNativeUserAgent } from './util/http' - -installNativeUserAgent() -registerShareIntentHandler() - -Application.run({ moduleName: 'app-root' }) +// NativeScript resolves the matching .android.ts or .ios.ts implementation. +import './bootstrap' // Don't place any code after the application has been started diff --git a/app/bootstrap.android.ts b/app/bootstrap.android.ts new file mode 100644 index 00000000..c160dda1 --- /dev/null +++ b/app/bootstrap.android.ts @@ -0,0 +1,8 @@ +import { Application } from '@nativescript/core' +import { registerShareIntentHandler } from './native/share-intents' +import { installNativeUserAgent } from './util/http' + +installNativeUserAgent() +registerShareIntentHandler() + +Application.run({ moduleName: 'app-root' }) diff --git a/app/bootstrap.ios.ts b/app/bootstrap.ios.ts new file mode 100644 index 00000000..c2a43d2c --- /dev/null +++ b/app/bootstrap.ios.ts @@ -0,0 +1,47 @@ +import { Application, Button, Device, Label, Page, ScrollView, StackLayout } from '@nativescript/core' +import { bytesToHex, hexToBytes } from './util/hex-util' + +// Milestone 1: exercise native UI, TypeScript, and an existing shared utility +// without loading the Android services used by the full glasses application. +Application.run({ + create: () => { + const page = new Page() + page.actionBarHidden = true + const scroll = new ScrollView() + const content = new StackLayout() + content.padding = 28 + content.verticalAlignment = 'middle' + + const label = (text: string, fontSize = 17) => { + const view = new Label() + view.text = text + view.fontSize = fontSize + view.textWrap = true + view.marginBottom = 20 + content.addChild(view) + return view + } + + label('Faceclaw', 36) + label('iOS port · First launch', 24) + label(`NativeScript is running on ${Device.model} (iOS ${Device.osVersion}).`) + label('Glasses pairing and the Android features are still to be ported.') + const status = label('Tap below to test native input and shared TypeScript code.') + const button = new Button() + button.text = 'Run shared-code check' + button.accessibilityIdentifier = 'shared-code-check' + let checks = 0 + button.on('tap', () => { + const result = bytesToHex(hexToBytes('46 61 63 65 63 6c 61 77')) + const passed = result === '46616365636C6177' + checks += 1 + status.text = `${passed ? 'Passed' : 'Failed'} · Check ${checks}\nShared hex utilities returned ${result}.` + console.log(`[ios-bootstrap] Shared-code check ${checks}: ${passed ? 'PASS' : 'FAIL'} (${result})`) + }) + content.addChild(button) + scroll.content = content + page.content = scroll + page.on('loaded', () => console.log('[ios-bootstrap] Faceclaw launch screen loaded')) + return page + }, +}) diff --git a/iOS/Faceclaw.xcodeproj/project.pbxproj b/iOS/Faceclaw.xcodeproj/project.pbxproj new file mode 100644 index 00000000..03d18354 --- /dev/null +++ b/iOS/Faceclaw.xcodeproj/project.pbxproj @@ -0,0 +1,350 @@ +// !$*UTF8*$! +{ + archiveVersion = 1; + classes = { + }; + objectVersion = 77; + objects = { + +/* Begin PBXFileReference section */ + 45A0A8CB304D0DD5008BD93B /* Faceclaw.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = Faceclaw.app; sourceTree = BUILT_PRODUCTS_DIR; }; +/* End PBXFileReference section */ + +/* Begin PBXFileSystemSynchronizedRootGroup section */ + 45A0A8CD304D0DD5008BD93B /* Faceclaw */ = { + isa = PBXFileSystemSynchronizedRootGroup; + path = Faceclaw; + sourceTree = ""; + }; +/* End PBXFileSystemSynchronizedRootGroup section */ + +/* Begin PBXFrameworksBuildPhase section */ + 45A0A8C8304D0DD5008BD93B /* Frameworks */ = { + isa = PBXFrameworksBuildPhase; + buildActionMask = 2147483647; + files = ( + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXFrameworksBuildPhase section */ + +/* Begin PBXGroup section */ + 45A0A8C2304D0DD5008BD93B = { + isa = PBXGroup; + children = ( + 45A0A8CD304D0DD5008BD93B /* Faceclaw */, + 45A0A8CC304D0DD5008BD93B /* Products */, + ); + sourceTree = ""; + }; + 45A0A8CC304D0DD5008BD93B /* Products */ = { + isa = PBXGroup; + children = ( + 45A0A8CB304D0DD5008BD93B /* Faceclaw.app */, + ); + name = Products; + sourceTree = ""; + }; +/* End PBXGroup section */ + +/* Begin PBXNativeTarget section */ + 45A0A8CA304D0DD5008BD93B /* Faceclaw */ = { + isa = PBXNativeTarget; + buildConfigurationList = 45A0A8D6304D0DD6008BD93B /* Build configuration list for PBXNativeTarget "Faceclaw" */; + buildPhases = ( + 45A0A8C7304D0DD5008BD93B /* Sources */, + 45A0A8C8304D0DD5008BD93B /* Frameworks */, + 45A0A8C9304D0DD5008BD93B /* Resources */, + ); + buildRules = ( + ); + dependencies = ( + ); + fileSystemSynchronizedGroups = ( + 45A0A8CD304D0DD5008BD93B /* Faceclaw */, + ); + name = Faceclaw; + packageProductDependencies = ( + ); + productName = Faceclaw; + productReference = 45A0A8CB304D0DD5008BD93B /* Faceclaw.app */; + productType = "com.apple.product-type.application"; + }; +/* End PBXNativeTarget section */ + +/* Begin PBXProject section */ + 45A0A8C3304D0DD5008BD93B /* Project object */ = { + isa = PBXProject; + attributes = { + BuildIndependentTargetsInParallel = 1; + LastSwiftUpdateCheck = 2640; + LastUpgradeCheck = 2640; + TargetAttributes = { + 45A0A8CA304D0DD5008BD93B = { + CreatedOnToolsVersion = 26.4.1; + }; + }; + }; + buildConfigurationList = 45A0A8C6304D0DD5008BD93B /* Build configuration list for PBXProject "Faceclaw" */; + developmentRegion = en; + hasScannedForEncodings = 0; + knownRegions = ( + en, + Base, + ); + mainGroup = 45A0A8C2304D0DD5008BD93B; + minimizedProjectReferenceProxies = 1; + preferredProjectObjectVersion = 77; + productRefGroup = 45A0A8CC304D0DD5008BD93B /* Products */; + projectDirPath = ""; + projectRoot = ""; + targets = ( + 45A0A8CA304D0DD5008BD93B /* Faceclaw */, + ); + }; +/* End PBXProject section */ + +/* Begin PBXResourcesBuildPhase section */ + 45A0A8C9304D0DD5008BD93B /* Resources */ = { + isa = PBXResourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXResourcesBuildPhase section */ + +/* Begin PBXSourcesBuildPhase section */ + 45A0A8C7304D0DD5008BD93B /* Sources */ = { + isa = PBXSourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXSourcesBuildPhase section */ + +/* Begin XCBuildConfiguration section */ + 45A0A8D4304D0DD6008BD93B /* Debug */ = { + isa = XCBuildConfiguration; + buildSettings = { + ALWAYS_SEARCH_USER_PATHS = NO; + ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES; + CLANG_ANALYZER_NONNULL = YES; + CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE; + CLANG_CXX_LANGUAGE_STANDARD = "gnu++20"; + CLANG_ENABLE_MODULES = YES; + CLANG_ENABLE_OBJC_ARC = YES; + CLANG_ENABLE_OBJC_WEAK = YES; + CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES; + CLANG_WARN_BOOL_CONVERSION = YES; + CLANG_WARN_COMMA = YES; + CLANG_WARN_CONSTANT_CONVERSION = YES; + CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES; + CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR; + CLANG_WARN_DOCUMENTATION_COMMENTS = YES; + CLANG_WARN_EMPTY_BODY = YES; + CLANG_WARN_ENUM_CONVERSION = YES; + CLANG_WARN_INFINITE_RECURSION = YES; + CLANG_WARN_INT_CONVERSION = YES; + CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES; + CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES; + CLANG_WARN_OBJC_LITERAL_CONVERSION = YES; + CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR; + CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER = YES; + CLANG_WARN_RANGE_LOOP_ANALYSIS = YES; + CLANG_WARN_STRICT_PROTOTYPES = YES; + CLANG_WARN_SUSPICIOUS_MOVE = YES; + CLANG_WARN_UNGUARDED_AVAILABILITY = YES_AGGRESSIVE; + CLANG_WARN_UNREACHABLE_CODE = YES; + CLANG_WARN__DUPLICATE_METHOD_MATCH = YES; + COPY_PHASE_STRIP = NO; + DEBUG_INFORMATION_FORMAT = dwarf; + ENABLE_STRICT_OBJC_MSGSEND = YES; + ENABLE_TESTABILITY = YES; + ENABLE_USER_SCRIPT_SANDBOXING = YES; + GCC_C_LANGUAGE_STANDARD = gnu17; + GCC_DYNAMIC_NO_PIC = NO; + GCC_NO_COMMON_BLOCKS = YES; + GCC_OPTIMIZATION_LEVEL = 0; + GCC_PREPROCESSOR_DEFINITIONS = ( + "DEBUG=1", + "$(inherited)", + ); + GCC_WARN_64_TO_32_BIT_CONVERSION = YES; + GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR; + GCC_WARN_UNDECLARED_SELECTOR = YES; + GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE; + GCC_WARN_UNUSED_FUNCTION = YES; + GCC_WARN_UNUSED_VARIABLE = YES; + LOCALIZATION_PREFERS_STRING_CATALOGS = YES; + MTL_ENABLE_DEBUG_INFO = INCLUDE_SOURCE; + MTL_FAST_MATH = YES; + ONLY_ACTIVE_ARCH = YES; + SWIFT_ACTIVE_COMPILATION_CONDITIONS = "DEBUG $(inherited)"; + SWIFT_OPTIMIZATION_LEVEL = "-Onone"; + }; + name = Debug; + }; + 45A0A8D5304D0DD6008BD93B /* Release */ = { + isa = XCBuildConfiguration; + buildSettings = { + ALWAYS_SEARCH_USER_PATHS = NO; + ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES; + CLANG_ANALYZER_NONNULL = YES; + CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE; + CLANG_CXX_LANGUAGE_STANDARD = "gnu++20"; + CLANG_ENABLE_MODULES = YES; + CLANG_ENABLE_OBJC_ARC = YES; + CLANG_ENABLE_OBJC_WEAK = YES; + CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES; + CLANG_WARN_BOOL_CONVERSION = YES; + CLANG_WARN_COMMA = YES; + CLANG_WARN_CONSTANT_CONVERSION = YES; + CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES; + CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR; + CLANG_WARN_DOCUMENTATION_COMMENTS = YES; + CLANG_WARN_EMPTY_BODY = YES; + CLANG_WARN_ENUM_CONVERSION = YES; + CLANG_WARN_INFINITE_RECURSION = YES; + CLANG_WARN_INT_CONVERSION = YES; + CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES; + CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES; + CLANG_WARN_OBJC_LITERAL_CONVERSION = YES; + CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR; + CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER = YES; + CLANG_WARN_RANGE_LOOP_ANALYSIS = YES; + CLANG_WARN_STRICT_PROTOTYPES = YES; + CLANG_WARN_SUSPICIOUS_MOVE = YES; + CLANG_WARN_UNGUARDED_AVAILABILITY = YES_AGGRESSIVE; + CLANG_WARN_UNREACHABLE_CODE = YES; + CLANG_WARN__DUPLICATE_METHOD_MATCH = YES; + COPY_PHASE_STRIP = NO; + DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym"; + ENABLE_NS_ASSERTIONS = NO; + ENABLE_STRICT_OBJC_MSGSEND = YES; + ENABLE_USER_SCRIPT_SANDBOXING = YES; + GCC_C_LANGUAGE_STANDARD = gnu17; + GCC_NO_COMMON_BLOCKS = YES; + GCC_WARN_64_TO_32_BIT_CONVERSION = YES; + GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR; + GCC_WARN_UNDECLARED_SELECTOR = YES; + GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE; + GCC_WARN_UNUSED_FUNCTION = YES; + GCC_WARN_UNUSED_VARIABLE = YES; + LOCALIZATION_PREFERS_STRING_CATALOGS = YES; + MTL_ENABLE_DEBUG_INFO = NO; + MTL_FAST_MATH = YES; + SWIFT_COMPILATION_MODE = wholemodule; + }; + name = Release; + }; + 45A0A8D7304D0DD6008BD93B /* Debug */ = { + isa = XCBuildConfiguration; + buildSettings = { + ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; + ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor; + CODE_SIGN_STYLE = Automatic; + CURRENT_PROJECT_VERSION = 1; + ENABLE_APP_SANDBOX = YES; + ENABLE_PREVIEWS = YES; + ENABLE_USER_SELECTED_FILES = readonly; + GENERATE_INFOPLIST_FILE = YES; + "INFOPLIST_KEY_UIApplicationSceneManifest_Generation[sdk=iphoneos*]" = YES; + "INFOPLIST_KEY_UIApplicationSceneManifest_Generation[sdk=iphonesimulator*]" = YES; + "INFOPLIST_KEY_UIApplicationSupportsIndirectInputEvents[sdk=iphoneos*]" = YES; + "INFOPLIST_KEY_UIApplicationSupportsIndirectInputEvents[sdk=iphonesimulator*]" = YES; + "INFOPLIST_KEY_UILaunchScreen_Generation[sdk=iphoneos*]" = YES; + "INFOPLIST_KEY_UILaunchScreen_Generation[sdk=iphonesimulator*]" = YES; + "INFOPLIST_KEY_UIStatusBarStyle[sdk=iphoneos*]" = UIStatusBarStyleDefault; + "INFOPLIST_KEY_UIStatusBarStyle[sdk=iphonesimulator*]" = UIStatusBarStyleDefault; + INFOPLIST_KEY_UISupportedInterfaceOrientations_iPad = "UIInterfaceOrientationPortrait UIInterfaceOrientationPortraitUpsideDown UIInterfaceOrientationLandscapeLeft UIInterfaceOrientationLandscapeRight"; + INFOPLIST_KEY_UISupportedInterfaceOrientations_iPhone = "UIInterfaceOrientationPortrait UIInterfaceOrientationLandscapeLeft UIInterfaceOrientationLandscapeRight"; + IPHONEOS_DEPLOYMENT_TARGET = 26.4; + LD_RUNPATH_SEARCH_PATHS = "@executable_path/Frameworks"; + "LD_RUNPATH_SEARCH_PATHS[sdk=macosx*]" = "@executable_path/../Frameworks"; + MACOSX_DEPLOYMENT_TARGET = 26.4; + MARKETING_VERSION = 1.0; + PRODUCT_BUNDLE_IDENTIFIER = org.jimrandomh.Faceclaw; + PRODUCT_NAME = "$(TARGET_NAME)"; + REGISTER_APP_GROUPS = YES; + SDKROOT = auto; + STRING_CATALOG_GENERATE_SYMBOLS = YES; + SUPPORTED_PLATFORMS = "iphoneos iphonesimulator macosx xros xrsimulator"; + SWIFT_APPROACHABLE_CONCURRENCY = YES; + SWIFT_DEFAULT_ACTOR_ISOLATION = MainActor; + SWIFT_EMIT_LOC_STRINGS = YES; + SWIFT_UPCOMING_FEATURE_MEMBER_IMPORT_VISIBILITY = YES; + SWIFT_VERSION = 5.0; + TARGETED_DEVICE_FAMILY = "1,2,7"; + XROS_DEPLOYMENT_TARGET = 26.4; + }; + name = Debug; + }; + 45A0A8D8304D0DD6008BD93B /* Release */ = { + isa = XCBuildConfiguration; + buildSettings = { + ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; + ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor; + CODE_SIGN_STYLE = Automatic; + CURRENT_PROJECT_VERSION = 1; + ENABLE_APP_SANDBOX = YES; + ENABLE_PREVIEWS = YES; + ENABLE_USER_SELECTED_FILES = readonly; + GENERATE_INFOPLIST_FILE = YES; + "INFOPLIST_KEY_UIApplicationSceneManifest_Generation[sdk=iphoneos*]" = YES; + "INFOPLIST_KEY_UIApplicationSceneManifest_Generation[sdk=iphonesimulator*]" = YES; + "INFOPLIST_KEY_UIApplicationSupportsIndirectInputEvents[sdk=iphoneos*]" = YES; + "INFOPLIST_KEY_UIApplicationSupportsIndirectInputEvents[sdk=iphonesimulator*]" = YES; + "INFOPLIST_KEY_UILaunchScreen_Generation[sdk=iphoneos*]" = YES; + "INFOPLIST_KEY_UILaunchScreen_Generation[sdk=iphonesimulator*]" = YES; + "INFOPLIST_KEY_UIStatusBarStyle[sdk=iphoneos*]" = UIStatusBarStyleDefault; + "INFOPLIST_KEY_UIStatusBarStyle[sdk=iphonesimulator*]" = UIStatusBarStyleDefault; + INFOPLIST_KEY_UISupportedInterfaceOrientations_iPad = "UIInterfaceOrientationPortrait UIInterfaceOrientationPortraitUpsideDown UIInterfaceOrientationLandscapeLeft UIInterfaceOrientationLandscapeRight"; + INFOPLIST_KEY_UISupportedInterfaceOrientations_iPhone = "UIInterfaceOrientationPortrait UIInterfaceOrientationLandscapeLeft UIInterfaceOrientationLandscapeRight"; + IPHONEOS_DEPLOYMENT_TARGET = 26.4; + LD_RUNPATH_SEARCH_PATHS = "@executable_path/Frameworks"; + "LD_RUNPATH_SEARCH_PATHS[sdk=macosx*]" = "@executable_path/../Frameworks"; + MACOSX_DEPLOYMENT_TARGET = 26.4; + MARKETING_VERSION = 1.0; + PRODUCT_BUNDLE_IDENTIFIER = org.jimrandomh.Faceclaw; + PRODUCT_NAME = "$(TARGET_NAME)"; + REGISTER_APP_GROUPS = YES; + SDKROOT = auto; + STRING_CATALOG_GENERATE_SYMBOLS = YES; + SUPPORTED_PLATFORMS = "iphoneos iphonesimulator macosx xros xrsimulator"; + SWIFT_APPROACHABLE_CONCURRENCY = YES; + SWIFT_DEFAULT_ACTOR_ISOLATION = MainActor; + SWIFT_EMIT_LOC_STRINGS = YES; + SWIFT_UPCOMING_FEATURE_MEMBER_IMPORT_VISIBILITY = YES; + SWIFT_VERSION = 5.0; + TARGETED_DEVICE_FAMILY = "1,2,7"; + XROS_DEPLOYMENT_TARGET = 26.4; + }; + name = Release; + }; +/* End XCBuildConfiguration section */ + +/* Begin XCConfigurationList section */ + 45A0A8C6304D0DD5008BD93B /* Build configuration list for PBXProject "Faceclaw" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 45A0A8D4304D0DD6008BD93B /* Debug */, + 45A0A8D5304D0DD6008BD93B /* Release */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; + 45A0A8D6304D0DD6008BD93B /* Build configuration list for PBXNativeTarget "Faceclaw" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 45A0A8D7304D0DD6008BD93B /* Debug */, + 45A0A8D8304D0DD6008BD93B /* Release */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; +/* End XCConfigurationList section */ + }; + rootObject = 45A0A8C3304D0DD5008BD93B /* Project object */; +} diff --git a/iOS/Faceclaw.xcodeproj/project.xcworkspace/contents.xcworkspacedata b/iOS/Faceclaw.xcodeproj/project.xcworkspace/contents.xcworkspacedata new file mode 100644 index 00000000..919434a6 --- /dev/null +++ b/iOS/Faceclaw.xcodeproj/project.xcworkspace/contents.xcworkspacedata @@ -0,0 +1,7 @@ + + + + + diff --git a/iOS/Faceclaw/Assets.xcassets/AccentColor.colorset/Contents.json b/iOS/Faceclaw/Assets.xcassets/AccentColor.colorset/Contents.json new file mode 100644 index 00000000..eb878970 --- /dev/null +++ b/iOS/Faceclaw/Assets.xcassets/AccentColor.colorset/Contents.json @@ -0,0 +1,11 @@ +{ + "colors" : [ + { + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/iOS/Faceclaw/Assets.xcassets/AppIcon.appiconset/Contents.json b/iOS/Faceclaw/Assets.xcassets/AppIcon.appiconset/Contents.json new file mode 100644 index 00000000..ffdfe150 --- /dev/null +++ b/iOS/Faceclaw/Assets.xcassets/AppIcon.appiconset/Contents.json @@ -0,0 +1,85 @@ +{ + "images" : [ + { + "idiom" : "universal", + "platform" : "ios", + "size" : "1024x1024" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "dark" + } + ], + "idiom" : "universal", + "platform" : "ios", + "size" : "1024x1024" + }, + { + "appearances" : [ + { + "appearance" : "luminosity", + "value" : "tinted" + } + ], + "idiom" : "universal", + "platform" : "ios", + "size" : "1024x1024" + }, + { + "idiom" : "mac", + "scale" : "1x", + "size" : "16x16" + }, + { + "idiom" : "mac", + "scale" : "2x", + "size" : "16x16" + }, + { + "idiom" : "mac", + "scale" : "1x", + "size" : "32x32" + }, + { + "idiom" : "mac", + "scale" : "2x", + "size" : "32x32" + }, + { + "idiom" : "mac", + "scale" : "1x", + "size" : "128x128" + }, + { + "idiom" : "mac", + "scale" : "2x", + "size" : "128x128" + }, + { + "idiom" : "mac", + "scale" : "1x", + "size" : "256x256" + }, + { + "idiom" : "mac", + "scale" : "2x", + "size" : "256x256" + }, + { + "idiom" : "mac", + "scale" : "1x", + "size" : "512x512" + }, + { + "idiom" : "mac", + "scale" : "2x", + "size" : "512x512" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/iOS/Faceclaw/Assets.xcassets/Contents.json b/iOS/Faceclaw/Assets.xcassets/Contents.json new file mode 100644 index 00000000..73c00596 --- /dev/null +++ b/iOS/Faceclaw/Assets.xcassets/Contents.json @@ -0,0 +1,6 @@ +{ + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/iOS/Faceclaw/ContentView.swift b/iOS/Faceclaw/ContentView.swift new file mode 100644 index 00000000..6694b8d3 --- /dev/null +++ b/iOS/Faceclaw/ContentView.swift @@ -0,0 +1,24 @@ +// +// ContentView.swift +// Faceclaw +// +// Created by James Babcock on 9/5/26. +// + +import SwiftUI + +struct ContentView: View { + var body: some View { + VStack { + Image(systemName: "globe") + .imageScale(.large) + .foregroundStyle(.tint) + Text("Hello, world!") + } + .padding() + } +} + +#Preview { + ContentView() +} diff --git a/iOS/Faceclaw/FaceclawApp.swift b/iOS/Faceclaw/FaceclawApp.swift new file mode 100644 index 00000000..d1309702 --- /dev/null +++ b/iOS/Faceclaw/FaceclawApp.swift @@ -0,0 +1,17 @@ +// +// FaceclawApp.swift +// Faceclaw +// +// Created by James Babcock on 9/5/26. +// + +import SwiftUI + +@main +struct FaceclawApp: App { + var body: some Scene { + WindowGroup { + ContentView() + } + } +} diff --git a/package-lock.json b/package-lock.json index 783099da..677da298 100644 --- a/package-lock.json +++ b/package-lock.json @@ -20,6 +20,7 @@ }, "devDependencies": { "@nativescript/android": "9.0.4", + "@nativescript/ios": "9.0.3", "@nativescript/types": "~9.0.0", "@nativescript/webpack": "~5.0.25", "typescript": "~5.4.0" @@ -515,6 +516,13 @@ "integrity": "sha512-MzL7R/nPZU2qnvDWWuJ8RB7H3luEwANgFX/d/ILdg7bSYxl6uANCfzlueHnWgrQmBxu6dTkvPsFW2WNVUxlhUg==", "license": "Apache-2.0" }, + "node_modules/@nativescript/ios": { + "version": "9.0.3", + "resolved": "https://registry.npmjs.org/@nativescript/ios/-/ios-9.0.3.tgz", + "integrity": "sha512-1IE9OIkBac4D8IPeFZ7kNxQRUr9s7BgFwOoS8XwhX5RvJHE/oSqjbSp+ag9A7MennpyDs/qxduGkwpS1EmmxOg==", + "dev": true, + "license": "Apache-2.0" + }, "node_modules/@nativescript/theme": { "version": "3.1.0", "resolved": "https://registry.npmjs.org/@nativescript/theme/-/theme-3.1.0.tgz", diff --git a/package.json b/package.json index c4a1783e..210a9ed8 100644 --- a/package.json +++ b/package.json @@ -4,6 +4,10 @@ "version": "1.0.0", "private": false, "scripts": { + "build:ios": "scripts/ios.sh build ios --for-device", + "run:ios": "scripts/ios.sh run ios", + "prepare:ios": "scripts/ios.sh prepare ios", + "doctor:ios": "scripts/ios.sh doctor ios", "build": "./build.sh", "run": "./build_and_run.sh", "release": "scripts/release.sh", @@ -23,6 +27,7 @@ }, "devDependencies": { "@nativescript/android": "9.0.4", + "@nativescript/ios": "9.0.3", "@nativescript/types": "~9.0.0", "@nativescript/webpack": "~5.0.25", "typescript": "~5.4.0" diff --git a/webpack.config.js b/webpack.config.js index d26aaac4..94bb49ff 100644 --- a/webpack.config.js +++ b/webpack.config.js @@ -4,6 +4,18 @@ const { resolve } = require("path"); module.exports = (env) => { webpack.init(env); + if (env.ios) { + // The initial iOS UI is constructed in code. Skip automatic registration + // of every XML page (and its Android-only service/worker dependencies). + // Explicit imports can still share any platform-independent app code. + webpack.chainWebpack((config) => { + const entry = config.entry('bundle'); + entry.values().forEach((value) => { + if (value.includes('virtual-entry-typescript')) entry.delete(value); + }); + }); + } + // Learn how to customize: // https://docs.nativescript.org/webpack From 99793a37a76bf62a8feb200382e0bca8194f60fa Mon Sep 17 00:00:00 2001 From: James Babcock Date: Sat, 5 Sep 2026 22:59:37 -0700 Subject: [PATCH 02/99] iOS porting: Main screen and compositor --- App_Resources/iOS/Info.plist | 2 + App_Resources/iOS/Podfile | 13 ++ App_Resources/iOS/src/FaceclawGraphics.h | 6 + App_Resources/iOS/src/FaceclawGraphics.m | 56 ++++++ App_Resources/iOS/src/module.modulemap | 4 + app/apps/calculator/calculator.ts | 12 +- app/bootstrap.ios.ts | 49 +---- app/g2/ios-preview-controller.ts | 220 +++++++++++++++++++++++ app/graphics/icons.ts | 24 +-- app/graphics/surface-compositor.ts | 75 ++++++++ app/native/ios-graphics.ts | 21 +++ app/native/settings-store.ios.ts | 28 +++ app/native/svg-rasterizer.ios.ts | 14 ++ app/native/svg-rasterizer.ts | 9 + app/phone-ui/main-page.ios.ts | 141 +++++++++++++++ app/phone-ui/phone-gestures.ts | 70 ++++++++ app/ui/shell/shell.ts | 9 +- scripts/ios.sh | 17 ++ tests/cloud-stt.test.cjs | 195 ++++++++++++++++++++ tests/helpers/load-typescript.cjs | 28 +++ tests/phone-gestures.test.cjs | 56 ++++++ tests/surface-compositor.test.cjs | 49 +++++ tests/transcribe.test.cjs | 94 ++++++++++ tests/tsconfig.json | 2 + 24 files changed, 1124 insertions(+), 70 deletions(-) create mode 100644 App_Resources/iOS/Podfile create mode 100644 App_Resources/iOS/src/FaceclawGraphics.h create mode 100644 App_Resources/iOS/src/FaceclawGraphics.m create mode 100644 App_Resources/iOS/src/module.modulemap create mode 100644 app/g2/ios-preview-controller.ts create mode 100644 app/graphics/surface-compositor.ts create mode 100644 app/native/ios-graphics.ts create mode 100644 app/native/settings-store.ios.ts create mode 100644 app/native/svg-rasterizer.ios.ts create mode 100644 app/native/svg-rasterizer.ts create mode 100644 app/phone-ui/main-page.ios.ts create mode 100644 app/phone-ui/phone-gestures.ts create mode 100755 scripts/ios.sh create mode 100644 tests/cloud-stt.test.cjs create mode 100644 tests/helpers/load-typescript.cjs create mode 100644 tests/phone-gestures.test.cjs create mode 100644 tests/surface-compositor.test.cjs create mode 100644 tests/transcribe.test.cjs diff --git a/App_Resources/iOS/Info.plist b/App_Resources/iOS/Info.plist index 98cc8471..4be2ce2c 100644 --- a/App_Resources/iOS/Info.plist +++ b/App_Resources/iOS/Info.plist @@ -23,6 +23,8 @@ UISupportedInterfaceOrientations UIInterfaceOrientationPortrait + UIInterfaceOrientationLandscapeLeft + UIInterfaceOrientationLandscapeRight UIRequiresFullScreen diff --git a/App_Resources/iOS/Podfile b/App_Resources/iOS/Podfile new file mode 100644 index 00000000..c643ad84 --- /dev/null +++ b/App_Resources/iOS/Podfile @@ -0,0 +1,13 @@ +platform :ios, '15.1' +pod 'SVGKit', '3.0.0' + +# SVGKit 3's physical-DPI lookup asserts on arm64 simulators. Our icons use +# only viewBox/pixel units, so that lookup is irrelevant to their rendering. +post_install do |installer| + installer.pods_project.targets.each do |target| + next unless target.name == 'SVGKit' + target.build_configurations.each do |config| + config.build_settings['ENABLE_NS_ASSERTIONS'] = 'NO' + end + end +end diff --git a/App_Resources/iOS/src/FaceclawGraphics.h b/App_Resources/iOS/src/FaceclawGraphics.h new file mode 100644 index 00000000..3dc2e7d5 --- /dev/null +++ b/App_Resources/iOS/src/FaceclawGraphics.h @@ -0,0 +1,6 @@ +#import + +@interface FaceclawGraphics : NSObject ++ (UIImage *)preview:(NSData *)gray width:(NSInteger)width height:(NSInteger)height green:(BOOL)green; ++ (NSData *)renderSVG:(NSString *)svg size:(NSInteger)size; +@end diff --git a/App_Resources/iOS/src/FaceclawGraphics.m b/App_Resources/iOS/src/FaceclawGraphics.m new file mode 100644 index 00000000..96a5e25e --- /dev/null +++ b/App_Resources/iOS/src/FaceclawGraphics.m @@ -0,0 +1,56 @@ +#import "FaceclawGraphics.h" +#import + +@implementation FaceclawGraphics ++ (UIImage *)preview:(NSData *)gray width:(NSInteger)width height:(NSInteger)height green:(BOOL)green { + if (width <= 0 || height <= 0 || gray.length != width * height) return nil; + NSMutableData *rgba = [NSMutableData dataWithLength:width * height * 4]; + const uint8_t *src = gray.bytes; + uint8_t *dst = rgba.mutableBytes; + uint8_t lut[256]; + for (int i = 0; i < 256; i++) lut[i] = (uint8_t)round(pow(i / 255.0, 0.7) * 255.0); + for (NSInteger i = 0; i < width * height; i++) { + uint8_t value = lut[src[i]]; + dst[i * 4] = green ? 0 : value; + dst[i * 4 + 1] = value; + dst[i * 4 + 2] = green ? 0 : value; + dst[i * 4 + 3] = 255; + } + CGColorSpaceRef space = CGColorSpaceCreateDeviceRGB(); + CGDataProviderRef provider = CGDataProviderCreateWithCFData((__bridge CFDataRef)rgba); + CGImageRef image = CGImageCreate(width, height, 8, 32, width * 4, space, + kCGBitmapByteOrder32Big | (CGBitmapInfo)kCGImageAlphaPremultipliedLast, provider, NULL, false, kCGRenderingIntentDefault); + UIImage *result = image ? [UIImage imageWithCGImage:image scale:1 orientation:UIImageOrientationUp] : nil; + if (image) CGImageRelease(image); + CGDataProviderRelease(provider); + CGColorSpaceRelease(space); + return result; +} ++ (NSData *)renderSVG:(NSString *)svg size:(NSInteger)size { + if (size <= 0 || size > 1024) return nil; + SVGKImage *image = [SVGKImage imageWithData:[svg dataUsingEncoding:NSUTF8StringEncoding]]; + if (!image) return nil; + image.size = CGSizeMake(size, size); + UIGraphicsImageRendererFormat *format = [UIGraphicsImageRendererFormat defaultFormat]; + format.scale = 1; + format.opaque = NO; + UIGraphicsImageRenderer *renderer = [[UIGraphicsImageRenderer alloc] initWithSize:image.size format:format]; + UIImage *raster = [renderer imageWithActions:^(UIGraphicsImageRendererContext *context) { + [image.CALayerTree renderInContext:context.CGContext]; + }]; + NSMutableData *rgba = [NSMutableData dataWithLength:size * size * 4]; + CGColorSpaceRef space = CGColorSpaceCreateDeviceRGB(); + CGContextRef context = CGBitmapContextCreate(rgba.mutableBytes, size, size, 8, size * 4, space, + kCGBitmapByteOrder32Big | (CGBitmapInfo)kCGImageAlphaPremultipliedLast); + CGContextDrawImage(context, CGRectMake(0, 0, size, size), raster.CGImage); + NSMutableData *gray = [NSMutableData dataWithLength:size * size]; + const uint8_t *src = rgba.bytes; + uint8_t *dst = gray.mutableBytes; + for (NSInteger i = 0; i < size * size; i++) { + dst[i] = (uint8_t)round(0.2126 * src[i * 4] + 0.7152 * src[i * 4 + 1] + 0.0722 * src[i * 4 + 2]); + } + CGContextRelease(context); + CGColorSpaceRelease(space); + return gray; +} +@end diff --git a/App_Resources/iOS/src/module.modulemap b/App_Resources/iOS/src/module.modulemap new file mode 100644 index 00000000..560d5493 --- /dev/null +++ b/App_Resources/iOS/src/module.modulemap @@ -0,0 +1,4 @@ +module FaceclawGraphics { + header "FaceclawGraphics.h" + export * +} diff --git a/app/apps/calculator/calculator.ts b/app/apps/calculator/calculator.ts index 5f47d785..1a02dfed 100644 --- a/app/apps/calculator/calculator.ts +++ b/app/apps/calculator/calculator.ts @@ -82,10 +82,11 @@ export class CalculatorLayer implements Layer { constructor( private readonly coordinator: MathCoordinator, private readonly actions: LayerActions, + private readonly textInput?: () => Promise, ) { this.coordinator.setUsesDegrees(calculatorDegreesSetting.get()); this.coordinator.onChanged = () => this.handleCoordinatorChanged(); - this.unsubscribeTranscript = voiceControlBridge.onTranscript((event) => this.onTranscript(event)); + if (!this.textInput) this.unsubscribeTranscript = voiceControlBridge.onTranscript((event) => this.onTranscript(event)); } private get mode(): CalculatorMode { @@ -125,6 +126,7 @@ export class CalculatorLayer implements Layer { } private refreshListening(): void { + if (this.textInput) return; if (!this.foreground) return; if (this.listening === "continuous") { if (!this.continuousActive) { @@ -244,6 +246,7 @@ export class CalculatorLayer implements Layer { * that did not. */ beginDictation(): void { + if (this.textInput) { void this.textInput(); return; } if (this.dictating) return; this.dictating = true; void this.actions.startVoiceCapture(true); @@ -513,7 +516,8 @@ export class CalculatorLayer implements Layer { bodyBottom: number, ): void { const prompt = - this.listening === "continuous" + this.textInput ? "Tap to type a problem on your phone" + : this.listening === "continuous" ? `Say a problem, then "${modeLabel(this.mode).toLowerCase()} it"` : "Tap to say a problem — or use Voice input to type one"; const lines = wrapText(font, prompt, width - 96); @@ -527,7 +531,7 @@ export class CalculatorLayer implements Layer { private paintHeardLine(image: GrayImage, font: UiFont, width: number, y: number): void { if (!this.lastInput) return; - const label = "Heard"; + const label = this.textInput ? "Entered" : "Heard"; image.drawText(font, 24, y, label, 110); const x = 24 + font.measureText(label) + 10; image.drawText(font, x, y, truncateText(font, this.lastInput, width - x - 24), 160); @@ -579,7 +583,7 @@ export class CalculatorLayer implements Layer { this.mode === "explain" && this.coordinator.stepPosition !== null ? "steps" : "mode"; return gestureHints([ [GESTURE_SCROLL, scrollTarget], - [GESTURE_CLICK, "mic"], + [GESTURE_CLICK, this.textInput ? "type" : "mic"], [GESTURE_DOUBLE_CLICK, "back"], ]); } diff --git a/app/bootstrap.ios.ts b/app/bootstrap.ios.ts index c2a43d2c..977ab199 100644 --- a/app/bootstrap.ios.ts +++ b/app/bootstrap.ios.ts @@ -1,47 +1,4 @@ -import { Application, Button, Device, Label, Page, ScrollView, StackLayout } from '@nativescript/core' -import { bytesToHex, hexToBytes } from './util/hex-util' +import { Application } from '@nativescript/core' +import { createMainPage } from './phone-ui/main-page.ios' -// Milestone 1: exercise native UI, TypeScript, and an existing shared utility -// without loading the Android services used by the full glasses application. -Application.run({ - create: () => { - const page = new Page() - page.actionBarHidden = true - const scroll = new ScrollView() - const content = new StackLayout() - content.padding = 28 - content.verticalAlignment = 'middle' - - const label = (text: string, fontSize = 17) => { - const view = new Label() - view.text = text - view.fontSize = fontSize - view.textWrap = true - view.marginBottom = 20 - content.addChild(view) - return view - } - - label('Faceclaw', 36) - label('iOS port · First launch', 24) - label(`NativeScript is running on ${Device.model} (iOS ${Device.osVersion}).`) - label('Glasses pairing and the Android features are still to be ported.') - const status = label('Tap below to test native input and shared TypeScript code.') - const button = new Button() - button.text = 'Run shared-code check' - button.accessibilityIdentifier = 'shared-code-check' - let checks = 0 - button.on('tap', () => { - const result = bytesToHex(hexToBytes('46 61 63 65 63 6c 61 77')) - const passed = result === '46616365636C6177' - checks += 1 - status.text = `${passed ? 'Passed' : 'Failed'} · Check ${checks}\nShared hex utilities returned ${result}.` - console.log(`[ios-bootstrap] Shared-code check ${checks}: ${passed ? 'PASS' : 'FAIL'} (${result})`) - }) - content.addChild(button) - scroll.content = content - page.content = scroll - page.on('loaded', () => console.log('[ios-bootstrap] Faceclaw launch screen loaded')) - return page - }, -}) +Application.run({ create: createMainPage }) diff --git a/app/g2/ios-preview-controller.ts b/app/g2/ios-preview-controller.ts new file mode 100644 index 00000000..c2ff1807 --- /dev/null +++ b/app/g2/ios-preview-controller.ts @@ -0,0 +1,220 @@ +import { Dialogs, type ImageSource } from '@nativescript/core' +import { createLauncherWindow, LAUNCHER_SURFACE_ID } from '../apps/launcher/launcher-app' +import { CalculatorLayer } from '../apps/calculator/calculator' +import { MathCoordinator } from '../apps/calculator/math/coordinator' +import { SurfaceCompositor } from '../graphics/surface-compositor' +import { flattenPlanes, type Plane } from '../graphics/plane' +import { G2_LENS_WIDTH, G2_LENS_HEIGHT } from '../graphics/image' +import { previewPixels } from '../native/ios-graphics' +import { makeInputEvent, type InputEventPayload } from '../ui/gestures' +import { noopLayerActions, type LayerActions } from '../ui/layers' +import { MenuLayer } from '../ui/menu' +import { createInProcessWindow } from '../ui/shell/in-process-window' +import { shell, type ShellWindow } from '../ui/shell/shell' +import { appViewportRect, SIDEBAR_WIDTH, sidebarStripVisible } from '../ui/shell/geometry' +import { DISPLAY_MODE_VALUES, displayModeLabel, displayModeSetting, onAnySettingChanged, + previewColorSetting, timeFormatSetting, verticalPositionSetting } from '../ui/dashboard-settings' +import type { PhoneGesture } from '../phone-ui/phone-gestures' + +/** Local display host: shared shell/windows, no device-service initialization. */ +export class IosPreviewController { + private readonly compositor = new SurfaceCompositor(G2_LENS_WIDTH, G2_LENS_HEIGHT) + private renderTimer: ReturnType | null = null + private clockTimer: ReturnType | null = null + private offSettings: (() => void) | null = null + private active = false + private shellDirty = true + private inputQueue: Promise = Promise.resolve() + private lastLayout = '' + private prompting = false + private readonly actions: LayerActions = { + ...noopLayerActions, + requestRender: () => this.requestShellRender(), + startTextSettingEdit: setting => this.editSetting(setting), + startTextSettingsEdit: async (settings, _title, finished) => { + for (const setting of settings) await this.editSetting(setting) + finished?.() + }, + } + + constructor(private readonly onFrame: (image: ImageSource, focus: string) => void, + private readonly onError: (message: string) => void) { + this.compositor.configureSurface('shell', { x: 0, y: 0, width: 640, height: 480, zOrder: 1, transparency: 'color-key' }) + shell.configure({ + actions: this.actions, + voiceInputEnabled: false, + getScreenTimeoutMs: () => null, + requestShellRender: () => this.requestShellRender(), + onWindowsChanged: () => this.requestShellRender(), + onScreenStateChanged: on => { this.compositor.setScreenBlanked(!on); this.requestShellRender() }, + }) + const launcher = createLauncherWindow({ + actions: this.actions, + apps: () => [ + { appId: 'calculator', label: 'Calculator', icon: 'calculator' }, + { appId: 'display', label: 'Display', icon: 'settings' }, + ], + launchApp: id => this.launchApp(id), + uninstallApp: () => {}, + submitFrame: planes => this.submit(LAUNCHER_SURFACE_ID, planes), + setSurfaceVisible: visible => { this.compositor.setSurfaceVisible(LAUNCHER_SURFACE_ID, visible); this.scheduleFrame() }, + }) + this.configureWindow(launcher) + shell.registerWindow(launcher) + shell.wake('window') + shell.focusWindow(launcher.windowId) + } + + resume(): void { + if (this.active) return + this.active = true + this.offSettings = onAnySettingChanged(() => { + this.relayout() + shell.foregroundWindow()?.requestRender() + this.requestShellRender() + }) + this.clockTimer = setInterval(() => this.requestShellRender(), 60_000) + this.relayout() + shell.foregroundWindow()?.requestRender() + this.requestShellRender() + console.log('[ios-preview] Main screen active') + } + pause(): void { + this.active = false + this.offSettings?.(); this.offSettings = null + if (this.clockTimer) clearInterval(this.clockTimer) + if (this.renderTimer) clearTimeout(this.renderTimer) + this.clockTimer = this.renderTimer = null + } + private configureWindow(window: ShellWindow): void { + this.compositor.configureSurface(window.surfaceId, { + ...appViewportRect(window.heightMode, window.appId), zOrder: 0, transparency: 'opaque', + }) + this.compositor.setSurfaceVisible(window.surfaceId, shell.foregroundWindow()?.windowId === window.windowId) + } + private relayout(): void { + const layout = `${displayModeSetting.get()}:${verticalPositionSetting.get()}` + if (layout === this.lastLayout) return + this.lastLayout = layout + for (const window of shell.getWindows()) { + this.configureWindow(window) + window.relayout?.() + } + } + private async submit(id: string, planes: Plane[]): Promise { + const image = flattenPlanes(planes) + this.compositor.submitSurfaceFrame(id, image.pixels, { x: 0, y: 0, width: image.width, height: image.height }) + this.scheduleFrame() + } + private requestShellRender(): void { this.shellDirty = true; this.scheduleFrame() } + private scheduleFrame(): void { + if (!this.active || this.renderTimer !== null) return + // Coalesce window/chrome updates into one preview, capped at 30 fps. + this.renderTimer = setTimeout(() => { + this.renderTimer = null + try { + if (this.shellDirty) { + this.shellDirty = false + const image = flattenPlanes(shell.paintSurface(), { width: 640, height: 480 }) + this.compositor.submitSurfaceFrame('shell', image.pixels, { x: 0, y: 0, width: 640, height: 480 }) + this.compositor.setUnderlayDim(1, shell.underlayDim()) + } + const image = previewPixels(this.compositor.composite(), 640, 480, previewColorSetting.get() === 'green') + this.onFrame(image, `${shell.foregroundWindow()?.title ?? 'Apps'} · ${shell.getFocus() === 'sidebar' ? 'App switcher' : 'App'}`) + } catch (error) { this.fail(error) } + }, 33) + } + private fail(error: unknown): void { + const message = error instanceof Error ? error.stack ?? error.message : String(error) + console.error(`[ios-preview] ${message}`) + this.onError(error instanceof Error ? error.message : String(error)) + } + gesture(gesture: PhoneGesture, origin: 'watch' | 'ring' | 'mirror', nx = 0, ny = 0): void { + this.inputQueue = this.inputQueue.then(async () => { + if (!this.active) return + if (gesture === 'tap' && origin === 'mirror' && shell.isScreenOn()) { + await this.mirrorTap(nx, ny) + } else { + let type: string = ({ tap: 'click', 'double-tap': 'double-click' } as Record)[gesture] ?? gesture + if (origin === 'ring' && type.startsWith('swipe-')) { + if (type === 'swipe-left' || type === 'swipe-right') return + type = type === 'swipe-up' ? 'scroll-up' : 'scroll-down' + } + const event = makeInputEvent({ type, source: origin === 'ring' ? 'ring' : 'watch' } as InputEventPayload) + await shell.receiveInput(event) + this.requestShellRender() + } + console.log(`[ios-preview] ${origin} ${gesture}: ${shell.describeInputTarget()}`) + }).catch(error => this.fail(error)) + } + private async mirrorTap(nx: number, ny: number): Promise { + const x = Math.max(0, Math.min(639, Math.floor(nx * 640))) + const y = Math.max(0, Math.min(479, Math.floor(ny * 480))) + const window = shell.foregroundWindow() + if (!shell.hasOverlay() && sidebarStripVisible(shell.getFocus(), window?.appId) && x < SIDEBAR_WIDTH) { + const target = shell.windowAtSidebarPoint(x, y) + if (target) { shell.focusWindow(target.windowId); target.requestRender(); this.requestShellRender() } + return + } + if (window && !shell.hasOverlay()) { + const rect = appViewportRect(window.heightMode, window.appId) + if (x < rect.x || x >= rect.x + rect.width || y < rect.y || y >= rect.y + rect.height) return + shell.focusWindow(window.windowId) + if (await window.hitTest?.(x - rect.x, y - rect.y)) { this.requestShellRender(); return } + } + await shell.receiveInput(makeInputEvent({ type: 'click', source: 'watch' })) + this.requestShellRender() + } + launchApp(id: string): void { + const existing = shell.getWindows().find(window => window.appId === id) + if (existing) { shell.focusWindow(existing.windowId); existing.requestRender(); this.requestShellRender(); return } + const surfaceId = `window:${id}` + let render = () => {} + const actions = { ...this.actions, requestRender: () => render() } + const layer = id === 'calculator' + ? new CalculatorLayer(new MathCoordinator(), actions, () => this.typeIntoApp()) + : new MenuLayer('Display', [ + { label: 'Change screen size', onSelect: () => this.cycleDisplayMode() }, + { label: 'Toggle green / grayscale preview', onSelect: () => { previewColorSetting.set(previewColorSetting.get() === 'green' ? 'white' : 'green') } }, + { label: 'Toggle 12 / 24 hour clock', onSelect: () => { timeFormatSetting.set(timeFormatSetting.get() === '24h' ? '12h' : '24h') } }, + ], { x: 8, y: 8, width: 320, minHeight: 160, opaque: true }) + const app = createInProcessWindow({ + appId: id, windowId: id, title: id === 'calculator' ? 'Calculator' : 'Display', + iconLetter: id === 'calculator' ? '=' : 'D', icon: id === 'calculator' ? 'calculator' : 'settings', + closeable: true, actions, baseLayer: layer, + receiveTextInput: id === 'calculator' ? text => { app.stack.receiveTextInput(text); app.requestRender() } : undefined, + submitFrame: planes => this.submit(surfaceId, planes), + setSurfaceVisible: visible => { + if (layer instanceof CalculatorLayer) layer.setForeground(visible) + this.compositor.setSurfaceVisible(surfaceId, visible); this.scheduleFrame() + }, + removeSurface: () => { this.compositor.removeSurface(surfaceId); this.scheduleFrame() }, + onClosed: () => { if (layer instanceof CalculatorLayer) layer.onRemoved() }, + }) + render = app.requestRender + if (layer instanceof CalculatorLayer) layer.requestRender = render + this.configureWindow(app.window) + shell.registerWindow(app.window) + shell.focusWindow(app.window.windowId) + app.requestRender(); this.requestShellRender() + } + cycleDisplayMode(): void { + const values = DISPLAY_MODE_VALUES + displayModeSetting.set(values[(values.indexOf(displayModeSetting.get()) + 1) % values.length]) + } + get displayModeLabel(): string { return displayModeLabel(displayModeSetting.get()) } + async typeIntoApp(): Promise { + if (this.prompting || !shell.foregroundWindow()?.receiveTextInput) return + this.prompting = true + try { + const result = await Dialogs.prompt({ title: 'Type into ' + shell.foregroundWindow()?.title, + message: 'Enter an expression or follow-up.', okButtonText: 'Send', cancelButtonText: 'Cancel' }) + if (result.result) shell.sendTextToForegroundWindow(result.text) + } catch (error) { this.fail(error) } + finally { this.prompting = false } + } + private async editSetting(setting: { editorTitle: string; get(): string; set(value: string): void }): Promise { + const result = await Dialogs.prompt({ title: setting.editorTitle, defaultText: setting.get(), okButtonText: 'Save', cancelButtonText: 'Cancel' }) + if (result.result) setting.set(result.text) + } +} diff --git a/app/graphics/icons.ts b/app/graphics/icons.ts index 7c59d667..fc6f23d1 100644 --- a/app/graphics/icons.ts +++ b/app/graphics/icons.ts @@ -1,12 +1,10 @@ import { GrayImage } from "./image"; - -declare const com: any; -declare const global: any; +import { rasterizeSvg } from "../native/svg-rasterizer"; /** * Vector icons for window indicators (and anywhere else). SVGs are rendered - * once to a correctly sized grayscale bitmap by the Java IconRenderer (a - * small SVG subset: path/circle/rect/line/polyline) and cached here. To add + * once to a correctly sized grayscale bitmap by the platform rasterizer + * (Android IconRenderer or iOS SVGKit) and cached here. To add * an icon, drop its SVG source into ICON_SVGS — Lucide icons * (https://lucide.dev, stroked, 24px viewBox) work as-is; simple single-color * Noun Project glyphs also work. @@ -171,18 +169,10 @@ function renderSvgCached(cacheName: string, svg: string, size: number): GrayImag if (cached !== undefined) return cached; let icon: GrayImage | null = null; - if (global.isAndroid) { - try { - const bytes = com.faceclaw.app.IconRenderer.renderSvgGray(svg, Math.round(size), ICON_STROKE_WIDTH); - if (bytes && bytes.length >= size * size) { - icon = new GrayImage(size, size, 0); - for (let i = 0; i < size * size; i++) { - icon.pixels[i] = bytes[i] & 0xff; - } - } - } catch (error) { - console.warn(`renderIcon(${cacheName}) failed: ${error}`); - } + try { + icon = rasterizeSvg(svg, Math.round(size), ICON_STROKE_WIDTH); + } catch (error) { + console.warn(`renderIcon(${cacheName}) failed: ${error}`); } cache.set(key, icon); return icon; diff --git a/app/graphics/surface-compositor.ts b/app/graphics/surface-compositor.ts new file mode 100644 index 00000000..1d8f80e7 --- /dev/null +++ b/app/graphics/surface-compositor.ts @@ -0,0 +1,75 @@ +/** Platform-independent 8bpp surface composition for the local display. */ +export type SurfaceRect = { x: number; y: number; width: number; height: number } +export type SurfaceConfiguration = SurfaceRect & { + zOrder: number + transparency: 'opaque' | 'color-key' +} +type Surface = SurfaceConfiguration & { pixels: Uint8Array; visible: boolean } + +export class SurfaceCompositor { + private readonly surfaces = new Map() + private dimBelow = 0 + private dimFactor = 1 + private blanked = false + constructor(readonly width: number, readonly height: number) { + if (!Number.isInteger(width) || !Number.isInteger(height) || width <= 0 || height <= 0) { + throw new Error('Invalid compositor size') + } + } + configureSurface(id: string, options: SurfaceConfiguration): void { + if (![options.x, options.y, options.width, options.height, options.zOrder].every(Number.isInteger) + || options.width <= 0 || options.height <= 0) throw new Error('Invalid surface geometry') + const previous = this.surfaces.get(id) + const pixels = previous?.width === options.width && previous.height === options.height + ? previous.pixels : new Uint8Array(options.width * options.height) + this.surfaces.set(id, { ...options, pixels, visible: previous?.visible ?? true }) + } + removeSurface(id: string): void { this.surfaces.delete(id) } + setSurfaceVisible(id: string, visible: boolean): void { + const surface = this.surfaces.get(id) + if (surface) surface.visible = visible + } + setUnderlayDim(belowZOrder: number, factor: number): void { + if (!Number.isFinite(factor)) throw new Error('Invalid dim factor') + this.dimBelow = belowZOrder + this.dimFactor = Math.max(0, Math.min(1, factor)) + } + setScreenBlanked(blanked: boolean): void { this.blanked = blanked } + submitSurfaceFrame(id: string, pixels: Uint8Array, rect: SurfaceRect): void { + const surface = this.surfaces.get(id) + if (!surface) throw new Error(`Unknown surface: ${id}`) + if (![rect.x, rect.y, rect.width, rect.height].every(Number.isInteger) + || rect.width <= 0 || rect.height <= 0 || pixels.length !== rect.width * rect.height) { + throw new Error('Invalid frame buffer or rectangle') + } + const left = Math.max(0, rect.x), right = Math.min(surface.width, rect.x + rect.width) + const top = Math.max(0, rect.y), bottom = Math.min(surface.height, rect.y + rect.height) + for (let y = top; y < bottom; y++) { + if (right <= left) break + const source = (y - rect.y) * rect.width + left - rect.x + surface.pixels.set(pixels.subarray(source, source + right - left), y * surface.width + left) + } + } + composite(): Uint8Array { + const output = new Uint8Array(this.width * this.height) + if (this.blanked) return output + const surfaces = [...this.surfaces.values()].filter(s => s.visible).sort((a, b) => a.zOrder - b.zOrder) + for (const surface of surfaces) { + const left = Math.max(0, surface.x), right = Math.min(this.width, surface.x + surface.width) + const top = Math.max(0, surface.y), bottom = Math.min(this.height, surface.y + surface.height) + const dim = surface.zOrder < this.dimBelow ? this.dimFactor : 1 + for (let y = top; y < bottom; y++) { + let source = (y - surface.y) * surface.width + left - surface.x + let target = y * this.width + left + for (let x = left; x < right; x++, source++, target++) { + const value = surface.pixels[source] + // Test the original value: opaque near-black must still cover the + // window beneath, even when dimming rounds it down to black. + if (surface.transparency === 'color-key' && value === 0) continue + output[target] = Math.round(value * dim) + } + } + } + return output + } +} diff --git a/app/native/ios-graphics.ts b/app/native/ios-graphics.ts new file mode 100644 index 00000000..6052d625 --- /dev/null +++ b/app/native/ios-graphics.ts @@ -0,0 +1,21 @@ +import { ImageSource } from '@nativescript/core' +import { GrayImage } from '../graphics/image' + +declare const FaceclawGraphics: any + +export function previewPixels(pixels: Uint8Array, width: number, height: number, green = false): ImageSource { + // NSData copies the buffer; the UIImage owns its pixels after this call. + const copy = new Uint8Array(pixels) + const data = NSData.dataWithBytesLength(interop.handleof(copy.buffer), copy.byteLength) + const native = FaceclawGraphics.previewWidthHeightGreen(data, width, height, green) + if (!native) throw new Error('Could not create preview image') + return new ImageSource(native) +} + +export function rasterizeSvg(svg: string, size: number): GrayImage | null { + const data = FaceclawGraphics.renderSVGSize(svg, size) + if (!data) return null + const image = new GrayImage(size, size, 0) + image.pixels.set(new Uint8Array(interop.bufferFromData(data))) + return image +} diff --git a/app/native/settings-store.ios.ts b/app/native/settings-store.ios.ts new file mode 100644 index 00000000..2d4c3dd5 --- /dev/null +++ b/app/native/settings-store.ios.ts @@ -0,0 +1,28 @@ +import { ApplicationSettings } from '@nativescript/core' + +// Main-isolate settings for the initial iOS port. Worker synchronization will +// be added when worker-hosted apps are enabled on iOS. +const listeners = new Set<(key: string) => void>() +function changed(key: string): void { + setTimeout(() => { for (const listener of [...listeners]) listener(key) }, 0) +} +export function getStringSetting(key: string, fallback: string): string { + return ApplicationSettings.getString(key, fallback) +} +export function setStringSetting(key: string, value: string): void { + if (getStringSetting(key, '') === value && ApplicationSettings.hasKey(key)) return + ApplicationSettings.setString(key, value) + changed(key) +} +export function getBooleanSetting(key: string, fallback: boolean): boolean { + return ApplicationSettings.getBoolean(key, fallback) +} +export function setBooleanSetting(key: string, value: boolean): void { + if (getBooleanSetting(key, false) === value && ApplicationSettings.hasKey(key)) return + ApplicationSettings.setBoolean(key, value) + changed(key) +} +export function onSettingsStoreChanged(listener: (key: string) => void): () => void { + listeners.add(listener) + return () => { listeners.delete(listener) } +} diff --git a/app/native/svg-rasterizer.ios.ts b/app/native/svg-rasterizer.ios.ts new file mode 100644 index 00000000..283045dd --- /dev/null +++ b/app/native/svg-rasterizer.ios.ts @@ -0,0 +1,14 @@ +import { rasterizeSvg as render } from './ios-graphics' +export function rasterizeSvg(svg: string, size: number, strokeWidth: number) { + // Shared icon sources rely on the Android renderer's white, rounded + // stroke defaults. Supply those explicitly for a standards SVG renderer. + const source = svg.replace(/]*)>/, (_tag, attributes: string) => { + const defaults = { xmlns: 'http://www.w3.org/2000/svg', width: '24', height: '24', + stroke: svg.includes('fill="none"') ? '#ffffff' : 'none', fill: '#ffffff', 'stroke-width': String(strokeWidth), + 'stroke-linecap': 'round', 'stroke-linejoin': 'round' } + const missing = Object.entries(defaults).filter(([key]) => !new RegExp(`\\b${key}=`).test(attributes)) + .map(([key, value]) => ` ${key}="${value}"`).join('') + return `` + }) + return render(source, size) +} diff --git a/app/native/svg-rasterizer.ts b/app/native/svg-rasterizer.ts new file mode 100644 index 00000000..d93ce43f --- /dev/null +++ b/app/native/svg-rasterizer.ts @@ -0,0 +1,9 @@ +import { GrayImage } from '../graphics/image' +declare const com: any +export function rasterizeSvg(svg: string, size: number, strokeWidth: number): GrayImage | null { + const bytes = com.faceclaw.app.IconRenderer.renderSvgGray(svg, size, strokeWidth) + if (!bytes || bytes.length < size * size) return null + const image = new GrayImage(size, size, 0) + for (let i = 0; i < size * size; i++) image.pixels[i] = bytes[i] & 0xff + return image +} diff --git a/app/phone-ui/main-page.ios.ts b/app/phone-ui/main-page.ios.ts new file mode 100644 index 00000000..1ade0eab --- /dev/null +++ b/app/phone-ui/main-page.ios.ts @@ -0,0 +1,141 @@ +import { Application, Button, Color, GridLayout, Image, Label, Page, StackLayout, type TouchGestureEventData } from '@nativescript/core' +import { IosPreviewController } from '../g2/ios-preview-controller' +import { PhoneGestureRecognizer } from './phone-gestures' +import { onAnySettingChanged, previewColorSetting } from '../ui/dashboard-settings' + +export function createMainPage(): Page { + const page = new Page() + page.actionBarHidden = true + const root = new GridLayout() + root.rows = 'auto,*' + page.content = root + const header = new GridLayout() + header.columns = '*,auto'; header.padding = '12 20' + const title = new Label() + title.text = 'Faceclaw'; title.fontSize = 25; title.fontWeight = 'bold' + header.addChild(title) + const state = new Label() + state.text = 'Preview only'; state.fontSize = 14; state.verticalAlignment = 'middle' + GridLayout.setColumn(state, 1); header.addChild(state); root.addChild(header) + const body = new GridLayout() + GridLayout.setRow(body, 1); root.addChild(body) + const mirror = new Image() + mirror.stretch = 'fill'; mirror.backgroundColor = new Color('black') + mirror.accessibilityIdentifier = 'glasses-preview' + mirror.accessibilityLabel = 'Interactive glasses screen preview' + mirror.verticalAlignment = 'middle'; body.addChild(mirror) + const controls = new GridLayout() + controls.rows = 'auto,*,auto'; controls.padding = 16; body.addChild(controls) + const tabs = new GridLayout() + tabs.columns = '*,*,*'; controls.addChild(tabs) + const pad = new GridLayout() + pad.borderRadius = 18; pad.backgroundColor = new Color('#202522') + pad.verticalAlignment = 'middle'; pad.horizontalAlignment = 'center' + pad.accessibilityIdentifier = 'gesture-pad' + GridLayout.setRow(pad, 1); controls.addChild(pad) + const focus = new Label() + focus.color = new Color('#ffffff'); focus.fontSize = 22; focus.textWrap = true + focus.textAlignment = 'center'; focus.margin = 18; focus.verticalAlignment = 'middle' + focus.isUserInteractionEnabled = false; pad.addChild(focus) + const legend = new Label() + legend.color = new Color('#b8c1bb'); legend.fontSize = 12; legend.textAlignment = 'center' + legend.textWrap = true; legend.margin = 12; legend.verticalAlignment = 'bottom' + legend.isUserInteractionEnabled = false; pad.addChild(legend) + const settings = new StackLayout() + settings.verticalAlignment = 'middle' + GridLayout.setRow(settings, 1); controls.addChild(settings) + const errorLabel = new Label() + errorLabel.textWrap = true; errorLabel.color = new Color('#a02d2d'); errorLabel.visibility = 'collapse' + settings.addChild(errorLabel) + let selectedTab: 'watch' | 'ring' | 'settings' = 'watch' + const controller = new IosPreviewController((image, label) => { + mirror.imageSource = image; focus.text = selectedTab === 'ring' ? 'Ring' : label + }, message => { + errorLabel.text = message; errorLabel.visibility = 'visible'; selectTab('settings') + }) + const padInput = new PhoneGestureRecognizer(gesture => controller.gesture(gesture, selectedTab === 'ring' ? 'ring' : 'watch')) + const mirrorInput = new PhoneGestureRecognizer((gesture, x, y) => { + const size = mirror.getActualSize() + if (size.width > 0 && size.height > 0) controller.gesture(gesture, 'mirror', x / size.width, y / size.height) + }) + const touch = (recognizer: PhoneGestureRecognizer) => (event: TouchGestureEventData) => { + if (!['down', 'move', 'up', 'cancel'].includes(event.action)) return + recognizer.touch({ action: event.action as 'down' | 'move' | 'up' | 'cancel', x: event.getX(), y: event.getY(), pointers: event.getPointerCount() }) + } + pad.on('touch', touch(padInput)); mirror.on('touch', touch(mirrorInput)) + function button(text: string, action: () => void): Button { + const view = new Button() + view.text = text; view.fontSize = 15; view.margin = 3; view.on('tap', action) + return view + } + const tabButtons: Button[] = [] + function selectTab(tab: typeof selectedTab): void { + padInput.cancel(); selectedTab = tab + pad.visibility = tab === 'settings' ? 'collapse' : 'visible' + settings.visibility = tab === 'settings' ? 'visible' : 'collapse' + for (let i = 0; i < tabButtons.length; i++) tabButtons[i].opacity = ['settings', 'watch', 'ring'][i] === tab ? 1 : 0.5 + focus.text = tab === 'ring' ? 'Ring' : 'Watch controls' + legend.text = tab === 'ring' ? 'Swipe up/down · Tap to select\nDouble-tap: back · Hold: menu' : 'Swipe to navigate · Tap to select\nDouble-tap / two fingers: back · Hold: menu' + layout() + } + for (const [index, tab] of (['settings', 'watch', 'ring'] as const).entries()) { + const view = button(tab[0].toUpperCase() + tab.slice(1), () => selectTab(tab)) + GridLayout.setColumn(view, index); tabs.addChild(view); tabButtons.push(view) + } + const sizeButton = button(controller.displayModeLabel, () => controller.cycleDisplayMode()) + settings.addChild(sizeButton) + settings.addChild(button('Toggle green / grayscale', () => previewColorSetting.set(previewColorSetting.get() === 'green' ? 'white' : 'green'))) + const help = new Label() + help.text = 'Tap preview icons to open apps.\nHold: system menu\nTap then hold: app menu' + help.fontSize = 13; help.textWrap = true; help.margin = 6; settings.addChild(help) + const footer = new GridLayout() + footer.columns = '*,*,*'; GridLayout.setRow(footer, 2); controls.addChild(footer) + const back = button('Back', () => controller.gesture('double-tap', 'watch')) + const menu = button('Menu', () => { + controller.gesture('long-press', 'watch'); controller.gesture('long-press-release', 'watch') + }) + const keyboard = button('Keyboard', () => { void controller.typeIntoApp() }) + for (const [index, view] of [back, menu, keyboard].entries()) { + view.padding = '16 8'; view.fontSize = 14 + GridLayout.setColumn(view, index); footer.addChild(view) + } + let lastLayout = '' + function layout(): void { + const size = root.getActualSize() + if (size.width <= 0 || size.height <= 0) return + const key = `${size.width}:${size.height}:${selectedTab}` + if (key === lastLayout) return + lastLayout = key; padInput.cancel(); mirrorInput.cancel() + const landscape = size.width > size.height + body.rows = landscape ? '*' : 'auto,*'; body.columns = landscape ? '*,320' : '*' + GridLayout.setRow(controls, landscape ? 0 : 1); GridLayout.setColumn(controls, landscape ? 1 : 0) + const width = landscape ? Math.min(size.width - 320, (size.height - 64) * 4 / 3) : size.width + mirror.width = width; mirror.height = width * 3 / 4 + pad.width = selectedTab === 'ring' ? 150 : Math.min(360, (landscape ? 320 : size.width) - 32) + pad.height = Math.max(120, Math.min(250, size.height - (landscape ? 180 : width * 3 / 4 + 200))) + } + // iOS emits layoutChanged inside its layout pass. Defer mutations so + // NativeScript does not clear our new layout request at the end of that pass. + let layoutTimer: ReturnType | null = null + root.on('layoutChanged', () => { + if (layoutTimer !== null) return + layoutTimer = setTimeout(() => { layoutTimer = null; layout() }, 0) + }) + const pause = () => { + if (layoutTimer !== null) clearTimeout(layoutTimer) + layoutTimer = null + padInput.cancel(); mirrorInput.cancel(); controller.pause() + } + const resume = () => controller.resume() + let offSettings: (() => void) | null = null + page.on('loaded', () => { + Application.on(Application.suspendEvent, pause); Application.on(Application.resumeEvent, resume) + offSettings?.(); offSettings = onAnySettingChanged(() => { sizeButton.text = controller.displayModeLabel }) + selectTab(selectedTab); controller.resume() + }) + page.on('unloaded', () => { + pause(); offSettings?.(); offSettings = null + Application.off(Application.suspendEvent, pause); Application.off(Application.resumeEvent, resume) + }) + return page +} diff --git a/app/phone-ui/phone-gestures.ts b/app/phone-ui/phone-gestures.ts new file mode 100644 index 00000000..bdc74ae9 --- /dev/null +++ b/app/phone-ui/phone-gestures.ts @@ -0,0 +1,70 @@ +/** One touch recognizer for a phone pad or mirror. Coordinates are in DIP. */ +declare function setTimeout(callback: () => void, ms: number): number +declare function clearTimeout(id: number): void +export type PhoneGesture = 'tap' | 'double-tap' | 'long-press' | 'long-press-release' + | 'short-then-long-press' | 'swipe-up' | 'swipe-down' | 'swipe-left' | 'swipe-right' +export type PhoneTouch = { action: 'down' | 'move' | 'up' | 'cancel'; x: number; y: number; pointers: number } +export type GestureClock = { set: (callback: () => void, ms: number) => unknown; clear: (id: unknown) => void } +const clock: GestureClock = { set: (callback, ms) => setTimeout(callback, ms), clear: id => clearTimeout(id as ReturnType) } + +export class PhoneGestureRecognizer { + private start: PhoneTouch | null = null + private hold: unknown = null + private tap: unknown = null + private lastTap: { x: number; y: number } | null = null + private holding = false + private moved = false + private multi = false + private secondTap = false + constructor(private readonly emit: (gesture: PhoneGesture, x: number, y: number) => void, + private readonly timer: GestureClock = clock) {} + + touch(event: PhoneTouch): void { + if (event.action === 'cancel') { this.cancel(); return } + if (event.action === 'down' && !this.start) { + this.start = event + this.holding = this.moved = this.multi = false + this.secondTap = !!this.lastTap && Math.hypot(event.x - this.lastTap.x, event.y - this.lastTap.y) < 36 + if (this.secondTap) { this.clearTap() } + else if (this.lastTap) { const tap = this.lastTap; this.clearTap(); this.emit('tap', tap.x, tap.y) } + this.hold = this.timer.set(() => { + this.hold = null + if (!this.start || this.moved || this.multi) return + this.holding = true + this.emit(this.secondTap ? 'short-then-long-press' : 'long-press', this.start.x, this.start.y) + }, 500) + } + if (!this.start) return + if (event.pointers > 1) { this.multi = true; this.clearHold(); this.clearTap() } + const dx = event.x - this.start.x, dy = event.y - this.start.y + if (Math.hypot(dx, dy) > 14) { this.moved = true; this.clearHold() } + if (event.action !== 'up') return + // Some platforms emit an up for each finger. Complete the multi-touch + // gesture only once, and suppress the trailing one-finger up events. + this.clearHold() + const start = this.start + this.start = null + if (this.holding) { this.emit('long-press-release', start.x, start.y); this.holding = false; return } + if (this.multi) { this.emit('double-tap', start.x, start.y); return } + if (Math.max(Math.abs(dx), Math.abs(dy)) >= 30) { + this.emit(Math.abs(dx) > Math.abs(dy) ? (dx > 0 ? 'swipe-right' : 'swipe-left') : (dy > 0 ? 'swipe-down' : 'swipe-up'), start.x, start.y) + } else if (!this.moved) { + if (this.secondTap) this.emit('double-tap', start.x, start.y) + else { + this.lastTap = { x: start.x, y: start.y } + this.tap = this.timer.set(() => { + const tap = this.lastTap + this.tap = null; this.lastTap = null + if (tap) this.emit('tap', tap.x, tap.y) + }, 280) + } + } + } + cancel(): void { + this.clearHold(); this.clearTap() + if (this.holding && this.start) this.emit('long-press-release', this.start.x, this.start.y) + this.start = null; this.holding = false + } + private clearHold(): void { if (this.hold !== null) this.timer.clear(this.hold); this.hold = null } + private clearTap(): void { if (this.tap !== null) this.timer.clear(this.tap); this.tap = null; this.lastTap = null } +} diff --git a/app/ui/shell/shell.ts b/app/ui/shell/shell.ts index 332ff275..9495f57b 100644 --- a/app/ui/shell/shell.ts +++ b/app/ui/shell/shell.ts @@ -144,6 +144,8 @@ export type ShellWindow = { }; export type ShellConfig = { + /** Hosts without microphone support hide and reject voice entry points. */ + voiceInputEnabled?: boolean; /** Actions handed to shell overlay layers; requestRender must re-render the shell surface. */ actions: LayerActions; getScreenTimeoutMs: () => number | null; @@ -901,7 +903,7 @@ class Shell { handsFree?: boolean; defaultTarget: "assistant" | "app"; }): void { - if (this.voiceDialogPending) return; + if (this.config.voiceInputEnabled === false || this.voiceDialogPending) return; this.voiceDialogPending = true; void (async () => { let ready = true; @@ -1005,6 +1007,7 @@ class Shell { * the dialog finishes on click instead of long-press-release. */ startVoiceInput(): void { + if (this.config.voiceInputEnabled === false) return; if (!this.screenOn || this.activeVoiceLayer || !this.stack.isAtBase()) return; // The transcript is aimed at the window whose menu requested it; the menu // entry point defaults the highlight to Type Into App. @@ -1334,7 +1337,7 @@ class Shell { ctx.stack.pop(); }, }, - { + ...(this.config.voiceInputEnabled === false ? [] : [{ label: "Voice input", onSelect: (ctx) => { // The transcript is aimed at the foreground window, so keep focus @@ -1343,7 +1346,7 @@ class Shell { ctx.stack.pop(); this.startVoiceInput(); }, - }, + }]), ); items.push({ label: "Debug", diff --git a/scripts/ios.sh b/scripts/ios.sh new file mode 100755 index 00000000..3ebb3f65 --- /dev/null +++ b/scripts/ios.sh @@ -0,0 +1,17 @@ +#!/usr/bin/env bash +set -euo pipefail +cd "$(dirname "$0")/.." + +# Prefer Homebrew Ruby over the older macOS system Ruby when available. +for ruby_bin in /opt/homebrew/opt/ruby/bin /usr/local/opt/ruby/bin; do + if [[ -x "$ruby_bin/ruby" ]]; then + export PATH="$ruby_bin:$PATH" + break + fi +done +if command -v ruby >/dev/null 2>&1; then + gem_bin="$(ruby -e 'puts Gem.bindir')" + export PATH="$gem_bin:$PATH" +fi + +exec ns "$@" diff --git a/tests/cloud-stt.test.cjs b/tests/cloud-stt.test.cjs new file mode 100644 index 00000000..c6f0e78e --- /dev/null +++ b/tests/cloud-stt.test.cjs @@ -0,0 +1,195 @@ +const test = require('node:test'); +const assert = require('node:assert/strict'); +const { loader } = require('./helpers/load-typescript.cjs'); + +function harness(provider = 'elevenlabs', continuous = true) { + const timers = new Map(); + let timerId = 0; + const sockets = []; + const events = [], statuses = [], errors = []; + const load = loader({ + setTimeout(fn, delay) { const id = ++timerId; timers.set(id, { fn, delay }); return id; }, + clearTimeout(id) { timers.delete(id); }, + console: { log() {}, warn() {} }, + com: { faceclaw: { app: { + FaceclawWebSocketListener: function(callbacks) { return callbacks; }, + FaceclawWebSocket: class { + constructor(url, listener) { Object.assign(this, { url, listener, sent: [], closed: false, reject: false }); sockets.push(this); } + sendText(text) { if (this.reject) return false; this.sent.push(text); return true; } + sendBinary(bytes) { if (this.reject) return false; this.sent.push(bytes); return true; } + close() { this.closed = true; } + }, } }, }, + }, { + './cloud-stt': { + CLOUD_STT_SAMPLE_RATE: 16000, + encodeBase64: bytes => Buffer.from(bytes).toString('base64'), + toJavaBytes: bytes => bytes, + }, + }); + const names = { elevenlabs: 'ElevenLabsSttClient', openai: 'OpenAiRealtimeSttClient', soniox: 'SonioxSttClient' }; + const Provider = load(`app/native/${provider}-stt.ts`)[names[provider]]; + const { ReconnectingSttClient } = load('app/native/reconnecting-stt.ts'); + const client = new ReconnectingSttClient(options => new Provider(options), { + apiKey: 'test', onTranscript: event => events.push(event), + onStatus: status => statuses.push(status), onError: error => errors.push(error), + }, () => continuous); + client.start(); + return { client, sockets, events, statuses, errors, timers, + open() { sockets.at(-1).listener.onOpen(); }, + message(message, socket = sockets.at(-1)) { socket.listener.onTextMessage(JSON.stringify(message)); }, + tick() { const [id, timer] = timers.entries().next().value; timers.delete(id); timer.fn(); return timer.delay; }, + }; +} + +function pcm(amplitude, ms = 50) { + const bytes = new Uint8Array(ms * 32); + for (let i = 0; i < bytes.length; i += 2) { bytes[i] = amplitude & 255; bytes[i + 1] = amplitude >> 8; } + return bytes; +} + +for (const provider of ['elevenlabs', 'openai', 'soniox']) { + test(`${provider}: failure and close reconnect, stale callbacks are ignored, stop cancels retry`, () => { + const h = harness(provider); + h.open(); + const old = h.sockets[0]; + old.listener.onFailure('network unavailable'); + old.listener.onClosed(); // Both callbacks must schedule only one retry. + assert.equal(h.timers.size, 1); + assert.equal(old.closed, true); + h.client.acceptPcm(pcm(2000)); + assert.equal(h.tick(), 1000); + assert.equal(h.sockets.length, 2); + h.open(); + assert.ok(h.sockets[1].sent.length > 0); + const eventCount = h.events.length; + old.listener.onTextMessage(JSON.stringify({ message_type: 'partial_transcript', text: 'stale' })); + old.listener.onOpen(); + assert.equal(h.events.length, eventCount); + h.sockets[1].listener.onClosed(); + assert.equal(h.timers.size, 1); + h.client.stop(); + assert.equal(h.timers.size, 0); + }); + + test(`${provider}: rejected audio send triggers recovery and requeues the packet`, () => { + const h = harness(provider); + h.open(); + h.sockets[0].reject = true; + h.client.acceptPcm(pcm(2000)); + assert.equal(h.timers.size, 1); + h.tick(); h.open(); + assert.ok(h.sockets[1].sent.length > (provider === 'elevenlabs' ? 0 : 1)); + h.client.stop(); + }); + + test(`${provider}: auth failure stops instead of retrying indefinitely`, () => { + const h = harness(provider); + h.sockets[0].listener.onFailure("Expected HTTP 101 response but was '401 Unauthorized'"); + assert.equal(h.timers.size, 0); + assert.equal(h.errors.length, 1); + }); +} + +test('reconnect preserves visible partials once and does not replay already-sent audio', () => { + const h = harness(); h.open(); + h.client.acceptPcm(pcm(2000)); + h.message({ message_type: 'partial_transcript', text: 'Before outage' }); + h.sockets[0].listener.onFailure('offline'); + assert.equal(h.events.at(-1).text, 'Before outage'); + assert.equal(h.events.at(-1).isFinal, true); + h.tick(); h.open(); + assert.equal(h.sockets[1].sent.length, 0); + h.message({ message_type: 'partial_transcript', text: 'After outage' }); + assert.equal(h.events.at(-1).text, 'After outage'); + h.client.stop(); +}); + +test('pending audio is bounded to ten seconds and backoff is capped', () => { + const h = harness(); + for (let i = 0; i < 20; i++) h.client.acceptPcm(pcm(i, 1000)); + h.open(); + const sentBytes = h.sockets[0].sent.reduce((sum, text) => sum + Buffer.from(JSON.parse(text).audio_base_64, 'base64').length, 0); + assert.equal(sentBytes, 320000); + for (const delay of [1000, 2000, 4000, 8000, 16000, 30000, 30000]) { + h.sockets.at(-1).listener.onFailure('offline'); + assert.equal(h.tick(), delay); + } + h.client.stop(); +}); + +test('finishing while disconnected cancels retries; finishing on an open socket times out cleanly', () => { + const h = harness(); h.open(); + h.sockets[0].listener.onClosed(); + h.client.finish(); + assert.equal(h.timers.size, 0); + const live = harness(); live.open(); + live.client.finish(); + assert.equal(live.tick(), 5000); + assert.equal(live.sockets[0].closed, true); + live.sockets[0].listener.onFailure('late'); + assert.equal(live.timers.size, 0); +}); + +test('only continuous capture commits at pauses, keeping ElevenLabs connected', () => { + for (const continuous of [false, true]) { + const h = harness('elevenlabs', continuous); h.open(); + h.client.acceptPcm(pcm(3000)); + h.client.acceptPcm(pcm(0, 1500)); + const commits = h.sockets[0].sent.map(JSON.parse).filter(m => m.commit); + assert.equal(commits.length, continuous ? 1 : 0); + if (continuous) { + h.message({ message_type: 'committed_transcript', text: 'First.' }); + h.message({ message_type: 'committed_transcript_with_timestamps', text: 'First.' }); + assert.equal(h.events.length, 1); + assert.equal(h.events[0].paragraphBreakAfter, true); + assert.equal(h.sockets[0].closed, false); + } + h.client.stop(); + } +}); + +test('OpenAI keeps successive items separate and drains out-of-order completions in audio order', () => { + const h = harness('openai'); h.open(); + h.client.acceptPcm(pcm(3000)); h.client.acceptPcm(pcm(0, 1500)); + h.message({ type: 'input_audio_buffer.committed', item_id: 'a' }); + h.message({ type: 'conversation.item.input_audio_transcription.delta', item_id: 'a', delta: 'Fir' }); + h.client.acceptPcm(pcm(3000)); h.client.acceptPcm(pcm(0, 1500)); + h.message({ type: 'input_audio_buffer.committed', item_id: 'b' }); + h.message({ type: 'conversation.item.input_audio_transcription.completed', item_id: 'b', transcript: 'Second.' }); + assert.equal(h.events.some(e => e.isFinal), false); + h.message({ type: 'conversation.item.input_audio_transcription.completed', item_id: 'a', transcript: 'First.' }); + assert.deepEqual(h.events.filter(e => e.isFinal).map(e => e.text), ['First.', 'Second.']); + assert.equal(h.sockets[0].closed, false); + h.message({ type: 'conversation.item.input_audio_transcription.delta', item_id: 'c', delta: 'Third.' }); + assert.equal(h.events.at(-1).text, 'Third.'); + h.client.stop(); +}); + +test('Soniox speaker and pause formatting remains separate from dictation text and resets on finalize', () => { + const h = harness('soniox'); h.open(); + h.message({ tokens: [ + { text: 'Hello.', start_ms: 0, end_ms: 500, speaker: '1', is_final: true }, + { text: ' Hi.', start_ms: 550, end_ms: 800, speaker: '2', is_final: false }, + ] }); + assert.equal(h.events.at(-1).text, 'Hello. Hi.'); + assert.equal(h.events.at(-1).transcribeText, 'Hello.\nHi.'); + h.message({ tokens: [ + { text: ' Yes.', start_ms: 550, end_ms: 800, speaker: '2', is_final: true }, + { text: '', is_final: true }, + ] }); + assert.equal(h.events.find(e => e.isFinal).transcribeText, 'Hello.\nYes.'); + h.message({ tokens: [{ text: 'New.', start_ms: 3000, end_ms: 3400, speaker: '2', is_final: false }] }); + assert.equal(h.events.at(-1).text, 'New.'); + h.client.stop(); +}); + +test('an unsolicited Soniox session end finalizes visible text and reconnects', () => { + const h = harness('soniox'); h.open(); + h.message({ tokens: [{ text: 'Before expiry.', is_final: true }], finished: true }); + assert.equal(h.events.at(-1).isFinal, true); + assert.equal(h.events.at(-1).text, 'Before expiry.'); + assert.equal(h.timers.size, 1); + h.tick(); h.open(); + assert.equal(h.sockets.length, 2); + h.client.stop(); +}); diff --git a/tests/helpers/load-typescript.cjs b/tests/helpers/load-typescript.cjs new file mode 100644 index 00000000..69702bf2 --- /dev/null +++ b/tests/helpers/load-typescript.cjs @@ -0,0 +1,28 @@ +const fs = require('node:fs'); +const path = require('node:path'); +const vm = require('node:vm'); +const ts = require('typescript'); + +// Execute production TypeScript with only the native boundary and clock stubbed. +exports.loader = (globals = {}, mocks = {}) => { + const cache = new Map(); + function load(file) { + file = path.resolve(__dirname, '../..', file); + if (cache.has(file)) return cache.get(file); + const output = {}; + cache.set(file, output); + const source = ts.transpileModule(fs.readFileSync(file, 'utf8'), { + compilerOptions: { module: ts.ModuleKind.CommonJS, target: ts.ScriptTarget.ES2020 }, + }).outputText; + vm.runInNewContext(source, { + exports: output, console, Uint8Array, ...globals, + require(name) { + if (name in mocks) return mocks[name]; + if (!name.startsWith('.')) throw new Error(`Unmocked module: ${name}`); + return load(path.resolve(path.dirname(file), name + '.ts')); + }, + }, { filename: file }); + return output; + } + return load; +}; diff --git a/tests/phone-gestures.test.cjs b/tests/phone-gestures.test.cjs new file mode 100644 index 00000000..cc90129f --- /dev/null +++ b/tests/phone-gestures.test.cjs @@ -0,0 +1,56 @@ +const test = require('node:test'); +const assert = require('node:assert/strict'); +const { PhoneGestureRecognizer } = require('../.test-build/app/phone-ui/phone-gestures.js'); +function setup() { + let now = 0, id = 0; + const timers = new Map(), events = []; + const r = new PhoneGestureRecognizer((type, x, y) => events.push({ type, x, y }), { + set(fn, ms) { timers.set(++id, { fn, at: now + ms }); return id; }, + clear(id) { timers.delete(id); }, + }); + return { + r, events, + touch: (action, x = 20, y = 30, pointers = 1) => r.touch({ action, x, y, pointers }), + advance(ms) { + now += ms; + for (const [id, timer] of [...timers]) if (timer.at <= now && timers.delete(id)) timer.fn(); + }, + types: () => events.map(e => e.type), + }; +} +test('single tap retains mirror coordinates and waits to disambiguate double tap', () => { + const s = setup(); s.touch('down'); s.touch('up'); + assert.deepEqual(s.types(), []); s.advance(280); + assert.deepEqual(s.events, [{ type: 'tap', x: 20, y: 30 }]); +}); +test('double tap emits back without accidental selection', () => { + const s = setup(); s.touch('down'); s.touch('up'); s.advance(150); + s.touch('down'); s.touch('up'); s.advance(1000); + assert.deepEqual(s.types(), ['double-tap']); +}); +test('a hold emits a press and release, never a tap', () => { + const s = setup(); s.touch('down'); s.advance(500); s.touch('up'); s.advance(1000); + assert.deepEqual(s.types(), ['long-press', 'long-press-release']); +}); +test('tap then hold emits the app-menu gesture without an earlier selection', () => { + const s = setup(); s.touch('down'); s.touch('up'); s.advance(100); + s.touch('down'); s.advance(500); s.touch('up'); s.advance(1000); + assert.deepEqual(s.types(), ['short-then-long-press', 'long-press-release']); +}); +test('four directional swipes cancel pending holds and taps', () => { + for (const [x, y, expected] of [[80, 30, 'swipe-right'], [-40, 30, 'swipe-left'], [20, 90, 'swipe-down'], [20, -30, 'swipe-up']]) { + const s = setup(); s.touch('down'); s.touch('move', x, y); s.advance(500); s.touch('up', x, y); s.advance(500); + assert.deepEqual(s.types(), [expected]); + } +}); +test('two fingers send back exactly once and cancel the long-press timer', () => { + const s = setup(); s.touch('down'); s.touch('down', 21, 30, 2); s.advance(500); + s.touch('up', 21, 30, 2); s.touch('up'); s.advance(1000); + assert.deepEqual(s.types(), ['double-tap']); +}); +test('cancellation prevents delayed selections and releases active holds', () => { + const s = setup(); s.touch('down'); s.touch('up'); s.r.cancel(); s.advance(1000); + assert.deepEqual(s.types(), []); + s.touch('down'); s.advance(500); s.touch('cancel'); s.advance(1000); + assert.deepEqual(s.types(), ['long-press', 'long-press-release']); +}); diff --git a/tests/surface-compositor.test.cjs b/tests/surface-compositor.test.cjs new file mode 100644 index 00000000..de5e497b --- /dev/null +++ b/tests/surface-compositor.test.cjs @@ -0,0 +1,49 @@ +const test = require('node:test'); +const assert = require('node:assert/strict'); +const { SurfaceCompositor } = require('../.test-build/app/graphics/surface-compositor.js'); +const rect = (x, y, width, height) => ({ x, y, width, height }); +function surface(c, id, box, values, zOrder = 0, transparency = 'opaque') { + c.configureSurface(id, { ...box, zOrder, transparency }); + c.submitSurfaceFrame(id, Uint8Array.from(values), rect(0, 0, box.width, box.height)); +} +test('shell color key preserves underlying text while opaque black covers it', () => { + const c = new SurfaceCompositor(3, 2); + surface(c, 'app', rect(0, 0, 3, 2), [200, 200, 200, 200, 200, 200]); + surface(c, 'shell', rect(0, 0, 3, 2), [0, 1, 255, 0, 0, 0], 1, 'color-key'); + c.setUnderlayDim(1, 0.5); + assert.deepEqual([...c.composite()], [100, 1, 255, 100, 100, 100]); + c.setSurfaceVisible('shell', false); + assert.deepEqual([...c.composite()], [100, 100, 100, 100, 100, 100]); + surface(c, 'opaque', rect(1, 0, 1, 2), [0, 0], 2); + assert.deepEqual([...c.composite()], [100, 0, 100, 100, 0, 100]); +}); +test('partial frames clip in surface coordinates, then surfaces clip to the screen', () => { + const c = new SurfaceCompositor(3, 2); + surface(c, 'app', rect(-1, 0, 3, 2), [1, 2, 3, 4, 5, 6]); + const source = Uint8Array.from([99, 10, 20, 99, 30, 40, 99]); + c.submitSurfaceFrame('app', source.subarray(1, 5), rect(1, 1, 2, 2)); + source.fill(0); + assert.deepEqual([...c.composite()], [2, 3, 0, 10, 20, 0]); + c.submitSurfaceFrame('app', Uint8Array.from([50, 60, 70, 80]), rect(-1, -1, 2, 2)); + // The clipped update changed the offscreen column, leaving visible pixels intact. + assert.deepEqual([...c.composite()], [2, 3, 0, 10, 20, 0]); +}); +test('moving a surface retains its frame; resizing clears it; blanking is reversible', () => { + const c = new SurfaceCompositor(3, 1); + surface(c, 'app', rect(0, 0, 2, 1), [7, 9]); + c.configureSurface('app', { ...rect(1, 0, 2, 1), zOrder: 0, transparency: 'opaque' }); + assert.deepEqual([...c.composite()], [0, 7, 9]); + c.setScreenBlanked(true); assert.deepEqual([...c.composite()], [0, 0, 0]); + c.setScreenBlanked(false); assert.deepEqual([...c.composite()], [0, 7, 9]); + c.configureSurface('app', { ...rect(0, 0, 3, 1), zOrder: 0, transparency: 'opaque' }); + assert.deepEqual([...c.composite()], [0, 0, 0]); +}); +test('layer order is independent of creation order; removal reveals lower surfaces', () => { + const c = new SurfaceCompositor(1, 1); + surface(c, 'top', rect(0, 0, 1, 1), [20], 10); + surface(c, 'bottom', rect(0, 0, 1, 1), [80], -1); + assert.equal(c.composite()[0], 20); + c.removeSurface('top'); assert.equal(c.composite()[0], 80); + assert.throws(() => c.submitSurfaceFrame('missing', new Uint8Array(1), rect(0, 0, 1, 1))); + assert.throws(() => c.submitSurfaceFrame('bottom', new Uint8Array(2), rect(0, 0, 1, 1))); +}); diff --git a/tests/transcribe.test.cjs b/tests/transcribe.test.cjs new file mode 100644 index 00000000..6ef9b8b8 --- /dev/null +++ b/tests/transcribe.test.cjs @@ -0,0 +1,94 @@ +const test = require('node:test'); +const assert = require('node:assert/strict'); +const { loader } = require('./helpers/load-typescript.cjs'); +const load = loader(); +const { TranscriptModel, TranscriptScroll, wrapTranscribeText } = load('app/apps/transcribe/transcript-model.ts'); +const { SpeechPauseDetector } = load('app/native/speech-pause.ts'); +const { TimedTranscript } = load('app/native/transcript-format.ts'); + +function pcm(amplitude, ms = 50) { + const bytes = new Uint8Array(ms * 16 * 2); + for (let i = 0; i < bytes.length; i += 2) { + bytes[i] = amplitude & 255; + bytes[i + 1] = (amplitude >> 8) & 255; + } + return bytes; +} + +test('partials replace, finals correct, and pause breaks survive display and saving', () => { + const m = new TranscriptModel(); + m.accept({ text: 'Hello wor', isFinal: false }); + m.accept({ text: 'Hello world.', isFinal: true, paragraphBreakAfter: true }); + m.accept({ text: 'Next', isFinal: false }); + m.accept({ text: 'Next paragraph.', isFinal: false }); + assert.equal(m.text, 'Hello world.\nNext paragraph.'); + m.accept({ text: 'Next paragraph!', isFinal: true }); + assert.equal(m.text, 'Hello world.\nNext paragraph!'); + m.accept({ text: '', isFinal: true }); + assert.equal(m.text, 'Hello world.\nNext paragraph!'); +}); + +test('onboard pauses can precede or follow finalization', () => { + for (const before of [true, false]) { + const m = new TranscriptModel(); + m.accept({ text: 'first', isFinal: false }); + if (before) m.pause(); + m.accept({ text: 'First.', isFinal: true }); + if (!before) m.pause(); + m.accept({ text: 'Second.', isFinal: false }); + assert.equal(m.text, 'First.\nSecond.'); + } +}); + +test('formatting metadata is used only by Transcribe, with revisable live speaker tokens', () => { + const final = new TimedTranscript(); + final.append({ text: 'Hello.', start_ms: 0, end_ms: 500, speaker: '1' }); + const preview = final.copy(); + preview.append({ text: ' Wrong', start_ms: 600, end_ms: 900, speaker: '2' }); + assert.equal(preview.text, 'Hello.\nWrong'); + assert.equal(final.text, 'Hello.'); + final.append({ text: ' Right.', start_ms: 600, end_ms: 900, speaker: '1' }); + final.append({ text: ' Later.', start_ms: 2400, end_ms: 2800, speaker: '1' }); + assert.equal(final.text, 'Hello. Right.\nLater.'); + const event = { text: 'Hello. Right. Later.', transcribeText: final.text, isFinal: false }; + const m = new TranscriptModel(); + m.accept(event); + assert.equal(m.text, final.text); + assert.equal(event.text.includes('\n'), false); +}); + +test('wrapping preserves explicit newlines, blank paragraphs, and long unspaced words', () => { + assert.deepEqual([...wrapTranscribeText(s => s.length, 'one two\nthree\n\nabcdefghij', 5)], + ['one', 'two', 'three', '', 'abcde', 'fghij']); +}); + +test('scroll follows the tail until scrolled back, then resumes only at the bottom', () => { + const s = new TranscriptScroll(); + assert.equal(s.layout(30, 10), 20); + assert.equal(s.layout(33, 10), 23); + s.scroll(-3); + assert.equal(s.layout(50, 10), 20); + assert.equal(s.layout(51, 10), 20); + s.scroll(100); + assert.equal(s.layout(55, 10), 45); + s.scroll(-100); + assert.equal(s.layout(60, 10), 0); +}); + +test('short transcripts become scrollable without disabling automatic following', () => { + const s = new TranscriptScroll(); + assert.equal(s.layout(3, 10), 0); + s.scroll(-3); + assert.equal(s.layout(12, 10), 2); +}); + +test('pause detector uses 1.5 seconds of PCM, fires once per pause, and ignores leading silence', () => { + const d = new SpeechPauseDetector(); + for (let i = 0; i < 60; i++) assert.equal(d.accept(pcm(0)), false); + d.accept(pcm(3000)); + for (let i = 0; i < 29; i++) assert.equal(d.accept(pcm(0)), false); + assert.equal(d.accept(pcm(0)), true); + for (let i = 0; i < 60; i++) assert.equal(d.accept(pcm(0)), false); + d.accept(pcm(3000)); + assert.equal(d.accept(pcm(0, 1500)), true); +}); diff --git a/tests/tsconfig.json b/tests/tsconfig.json index cba8aa69..0bf5d080 100644 --- a/tests/tsconfig.json +++ b/tests/tsconfig.json @@ -11,6 +11,8 @@ "outDir": "../.test-build" }, "include": [ + "../app/graphics/surface-compositor.ts", + "../app/phone-ui/phone-gestures.ts", "../app/g2/glasses-hardware-identity.ts", "../app/g2/ble-proximity.ts", "../app/g2/even-advertisement.ts", From 46c93c94217b8c941af26882319366646921cea1 Mon Sep 17 00:00:00 2001 From: James Babcock Date: Sat, 5 Sep 2026 23:53:13 -0700 Subject: [PATCH 03/99] iOS porting: core bluetooth communication with the glasses --- App_Resources/iOS/Info.plist | 2 + App_Resources/iOS/build.xcconfig | 1 + App_Resources/iOS/src/FaceclawBluetooth.h | 13 + App_Resources/iOS/src/FaceclawBluetooth.m | 190 ++++++++++++++ App_Resources/iOS/src/module.modulemap | 1 + app/g2/ble-protocol.ts | 178 +++++++++++++ app/g2/glasses-session.ts | 298 ++++++++++++++++++++++ app/g2/ios-peripheral-identity.ts | 25 ++ app/g2/ios-preview-controller.ts | 62 ++++- app/native/ios-bluetooth.ts | 144 +++++++++++ app/phone-ui/config-page.ios.ts | 68 +++++ app/phone-ui/main-page.ios.ts | 34 ++- tests/ios-ble.test.cjs | 171 +++++++++++++ tests/tsconfig.json | 3 + 14 files changed, 1182 insertions(+), 8 deletions(-) create mode 100644 App_Resources/iOS/src/FaceclawBluetooth.h create mode 100644 App_Resources/iOS/src/FaceclawBluetooth.m create mode 100644 app/g2/ble-protocol.ts create mode 100644 app/g2/glasses-session.ts create mode 100644 app/g2/ios-peripheral-identity.ts create mode 100644 app/native/ios-bluetooth.ts create mode 100644 app/phone-ui/config-page.ios.ts create mode 100644 tests/ios-ble.test.cjs diff --git a/App_Resources/iOS/Info.plist b/App_Resources/iOS/Info.plist index 4be2ce2c..d8615900 100644 --- a/App_Resources/iOS/Info.plist +++ b/App_Resources/iOS/Info.plist @@ -18,6 +18,8 @@ 1 LSRequiresIPhoneOS + NSBluetoothAlwaysUsageDescription + Faceclaw uses Bluetooth to connect to your glasses and ring, display your apps, and receive gestures. UILaunchScreen UISupportedInterfaceOrientations diff --git a/App_Resources/iOS/build.xcconfig b/App_Resources/iOS/build.xcconfig index e11b5908..05b2c3b1 100644 --- a/App_Resources/iOS/build.xcconfig +++ b/App_Resources/iOS/build.xcconfig @@ -3,3 +3,4 @@ TARGETED_DEVICE_FAMILY = 1; CODE_SIGN_STYLE = Automatic; // Select the local signing team in Xcode or pass --teamId to the iOS scripts. +OTHER_LDFLAGS = $(inherited) -framework CoreBluetooth diff --git a/App_Resources/iOS/src/FaceclawBluetooth.h b/App_Resources/iOS/src/FaceclawBluetooth.h new file mode 100644 index 00000000..ecad409a --- /dev/null +++ b/App_Resources/iOS/src/FaceclawBluetooth.h @@ -0,0 +1,13 @@ +#import +#import + +/** Main-queue CoreBluetooth adapter. Protocol and MAC matching live in TS. */ +@interface FaceclawBluetooth : NSObject +@property (nonatomic, copy) void (^eventHandler)(NSString *json); +- (void)initializeBluetooth; +- (void)scan:(BOOL)enabled; +- (void)connect:(NSString *)identifier requestId:(NSInteger)requestId; +- (void)subscribe:(NSString *)identifier characteristic:(NSString *)uuid requestId:(NSInteger)requestId; +- (void)write:(NSString *)identifier characteristic:(NSString *)uuid data:(NSData *)data requestId:(NSInteger)requestId; +- (void)disconnect:(NSString *)identifier; +@end diff --git a/App_Resources/iOS/src/FaceclawBluetooth.m b/App_Resources/iOS/src/FaceclawBluetooth.m new file mode 100644 index 00000000..c0b93719 --- /dev/null +++ b/App_Resources/iOS/src/FaceclawBluetooth.m @@ -0,0 +1,190 @@ +#import "FaceclawBluetooth.h" + +@interface FCBPeripheral : NSObject +@property (nonatomic, strong) CBPeripheral *peripheral; +@property (nonatomic, strong) NSMutableDictionary *characteristics; +@property (nonatomic, strong) NSMutableDictionary *subscriptions; +@property (nonatomic, strong) NSMutableArray *writes; +@property (nonatomic, strong) NSNumber *connectRequest; +@property (nonatomic) NSInteger pendingServices; +@property (nonatomic) BOOL awaitingWriteResponse; +@end +@implementation FCBPeripheral +- (instancetype)init { + if ((self = [super init])) { + _characteristics = [NSMutableDictionary new]; _subscriptions = [NSMutableDictionary new]; + _writes = [NSMutableArray new]; + } + return self; +} +@end + +@interface FaceclawBluetooth () +@property (nonatomic, strong) CBCentralManager *central; +@property (nonatomic, strong) NSMutableDictionary *peers; +@property (nonatomic) BOOL scanRequested; +@end + +@implementation FaceclawBluetooth +- (instancetype)init { if ((self = [super init])) _peers = [NSMutableDictionary new]; return self; } +- (void)emit:(NSDictionary *)event { + if (!self.eventHandler) return; + NSData *data = [NSJSONSerialization dataWithJSONObject:event options:0 error:nil]; + if (data) self.eventHandler([[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding]); +} +- (void)complete:(NSNumber *)request error:(NSString *)error details:(NSDictionary *)details { + if (!request) return; + NSMutableDictionary *event = [@{ @"kind": @"completion", @"id": request } mutableCopy]; + if (error) event[@"error"] = error; + if (details) event[@"details"] = details; + [self emit:event]; +} +- (void)initializeBluetooth { + if (!self.central) self.central = [[CBCentralManager alloc] initWithDelegate:self queue:dispatch_get_main_queue()]; + else [self centralManagerDidUpdateState:self.central]; +} +- (void)scan:(BOOL)enabled { + self.scanRequested = enabled; + if (!enabled) { [self.central stopScan]; return; } + [self initializeBluetooth]; + if (self.central.state == CBManagerStatePoweredOn) + [self.central scanForPeripheralsWithServices:nil options:@{CBCentralManagerScanOptionAllowDuplicatesKey: @YES}]; +} +- (void)centralManagerDidUpdateState:(CBCentralManager *)central { + [self emit:@{@"kind": @"state", @"state": @(central.state), @"authorization": @(CBManager.authorization)}]; + if (central.state != CBManagerStatePoweredOn) { + for (FCBPeripheral *peer in self.peers.allValues) [self failPeer:peer reason:@"Bluetooth is unavailable"]; + } else if (self.scanRequested) { + [central scanForPeripheralsWithServices:nil options:@{CBCentralManagerScanOptionAllowDuplicatesKey: @YES}]; + } +} +- (FCBPeripheral *)remember:(CBPeripheral *)peripheral { + NSString *identifier = peripheral.identifier.UUIDString; + FCBPeripheral *peer = self.peers[identifier]; + if (!peer) { peer = [FCBPeripheral new]; peer.peripheral = peripheral; self.peers[identifier] = peer; } + peripheral.delegate = self; + return peer; +} +- (void)centralManager:(CBCentralManager *)central didDiscoverPeripheral:(CBPeripheral *)peripheral advertisementData:(NSDictionary *)advertisement RSSI:(NSNumber *)RSSI { + [self remember:peripheral]; + NSData *data = advertisement[CBAdvertisementDataManufacturerDataKey]; + NSMutableString *hex = [NSMutableString new]; + const uint8_t *bytes = data.bytes; + for (NSUInteger i = 0; i < data.length; i++) [hex appendFormat:@"%02x", bytes[i]]; + [self emit:@{@"kind": @"advertisement", @"identifier": peripheral.identifier.UUIDString, + @"name": advertisement[CBAdvertisementDataLocalNameKey] ?: peripheral.name ?: @"", + @"manufacturerData": hex, @"rssi": RSSI, + @"connectable": advertisement[CBAdvertisementDataIsConnectable] ?: @YES}]; +} +- (void)connect:(NSString *)identifier requestId:(NSInteger)requestId { + if (self.central.state != CBManagerStatePoweredOn) { [self complete:@(requestId) error:@"Bluetooth is not ready" details:nil]; return; } + FCBPeripheral *peer = self.peers[identifier.uppercaseString]; + if (!peer) { + NSUUID *uuid = [[NSUUID alloc] initWithUUIDString:identifier]; + CBPeripheral *peripheral = uuid ? [self.central retrievePeripheralsWithIdentifiers:@[uuid]].firstObject : nil; + if (peripheral) peer = [self remember:peripheral]; + } + if (!peer) { [self complete:@(requestId) error:@"Peripheral is unknown; scan for the device first" details:nil]; return; } + if (peer.connectRequest || peer.peripheral.state != CBPeripheralStateDisconnected) { + [self complete:@(requestId) error:@"Peripheral is already connecting or connected" details:nil]; return; + } + [peer.characteristics removeAllObjects]; peer.connectRequest = @(requestId); + [self.central connectPeripheral:peer.peripheral options:nil]; +} +- (void)centralManager:(CBCentralManager *)central didConnectPeripheral:(CBPeripheral *)peripheral { + [peripheral discoverServices:nil]; +} +- (void)centralManager:(CBCentralManager *)central didFailToConnectPeripheral:(CBPeripheral *)peripheral error:(NSError *)error { + [self failPeer:[self remember:peripheral] reason:error.localizedDescription ?: @"Connection failed"]; +} +- (void)centralManager:(CBCentralManager *)central didDisconnectPeripheral:(CBPeripheral *)peripheral error:(NSError *)error { + [self failPeer:[self remember:peripheral] reason:error.localizedDescription ?: @"Disconnected"]; +} +- (void)peripheral:(CBPeripheral *)peripheral didDiscoverServices:(NSError *)error { + FCBPeripheral *peer = [self remember:peripheral]; + if (error || !peripheral.services.count) { [self failPeer:peer reason:error.localizedDescription ?: @"No services found"]; return; } + peer.pendingServices = peripheral.services.count; + for (CBService *service in peripheral.services) [peripheral discoverCharacteristics:nil forService:service]; +} +- (void)peripheral:(CBPeripheral *)peripheral didDiscoverCharacteristicsForService:(CBService *)service error:(NSError *)error { + FCBPeripheral *peer = [self remember:peripheral]; + if (!peer.connectRequest) return; + if (error) { [self failPeer:peer reason:error.localizedDescription]; return; } + for (CBCharacteristic *characteristic in service.characteristics) peer.characteristics[characteristic.UUID.UUIDString.lowercaseString] = characteristic; + if (--peer.pendingServices == 0) { + NSNumber *request = peer.connectRequest; peer.connectRequest = nil; + [self complete:request error:nil details:@{@"characteristics": peer.characteristics.allKeys, + @"maxWrite": @([peripheral maximumWriteValueLengthForType:CBCharacteristicWriteWithoutResponse])}]; + } +} +- (void)subscribe:(NSString *)identifier characteristic:(NSString *)uuid requestId:(NSInteger)requestId { + FCBPeripheral *peer = self.peers[identifier.uppercaseString]; + CBCharacteristic *characteristic = peer.characteristics[uuid.lowercaseString]; + if (!characteristic || !(characteristic.properties & (CBCharacteristicPropertyNotify | CBCharacteristicPropertyIndicate))) { + [self complete:@(requestId) error:@"Notification characteristic is unavailable" details:nil]; return; + } + if (characteristic.isNotifying) { [self complete:@(requestId) error:nil details:nil]; return; } + if (peer.subscriptions[uuid.lowercaseString]) { [self complete:@(requestId) error:@"Subscription already pending" details:nil]; return; } + peer.subscriptions[uuid.lowercaseString] = @(requestId); + [peer.peripheral setNotifyValue:YES forCharacteristic:characteristic]; +} +- (void)peripheral:(CBPeripheral *)peripheral didUpdateNotificationStateForCharacteristic:(CBCharacteristic *)characteristic error:(NSError *)error { + FCBPeripheral *peer = [self remember:peripheral]; NSString *key = characteristic.UUID.UUIDString.lowercaseString; + NSNumber *request = peer.subscriptions[key]; [peer.subscriptions removeObjectForKey:key]; + [self complete:request error:error.localizedDescription ?: (characteristic.isNotifying ? nil : @"Notifications not enabled") details:nil]; +} +- (void)peripheral:(CBPeripheral *)peripheral didUpdateValueForCharacteristic:(CBCharacteristic *)characteristic error:(NSError *)error { + if (error) { [self emit:@{@"kind": @"error", @"message": error.localizedDescription}]; return; } + NSMutableString *hex = [NSMutableString new]; NSData *data = characteristic.value; const uint8_t *bytes = data.bytes; + for (NSUInteger i = 0; i < data.length; i++) [hex appendFormat:@"%02x", bytes[i]]; + [self emit:@{@"kind": @"notification", @"identifier": peripheral.identifier.UUIDString, + @"characteristic": characteristic.UUID.UUIDString.lowercaseString, @"data": hex}]; +} +- (void)write:(NSString *)identifier characteristic:(NSString *)uuid data:(NSData *)data requestId:(NSInteger)requestId { + FCBPeripheral *peer = self.peers[identifier.uppercaseString]; + CBCharacteristic *characteristic = peer.characteristics[uuid.lowercaseString]; + if (!characteristic || peer.peripheral.state != CBPeripheralStateConnected) { + [self complete:@(requestId) error:@"Write characteristic is disconnected or unavailable" details:nil]; return; + } + CBCharacteristicWriteType type = (characteristic.properties & CBCharacteristicPropertyWriteWithoutResponse) + ? CBCharacteristicWriteWithoutResponse : CBCharacteristicWriteWithResponse; + if (!(characteristic.properties & (CBCharacteristicPropertyWriteWithoutResponse | CBCharacteristicPropertyWrite)) || + data.length > [peer.peripheral maximumWriteValueLengthForType:type]) { + [self complete:@(requestId) error:@"Write exceeds the negotiated BLE payload size or is unsupported" details:nil]; return; + } + if (peer.writes.count >= 256) { [self complete:@(requestId) error:@"Bluetooth write queue is full" details:nil]; return; } + [peer.writes addObject:@{@"id": @(requestId), @"characteristic": characteristic, @"data": [data copy], @"type": @(type)}]; + [self drain:peer]; +} +- (void)drain:(FCBPeripheral *)peer { + while (peer.writes.count && !peer.awaitingWriteResponse && peer.peripheral.state == CBPeripheralStateConnected) { + NSDictionary *write = peer.writes.firstObject; + CBCharacteristicWriteType type = [write[@"type"] integerValue]; + if (type == CBCharacteristicWriteWithoutResponse && !peer.peripheral.canSendWriteWithoutResponse) return; + if (type == CBCharacteristicWriteWithResponse) peer.awaitingWriteResponse = YES; + [peer.peripheral writeValue:write[@"data"] forCharacteristic:write[@"characteristic"] type:type]; + if (peer.awaitingWriteResponse) return; + [peer.writes removeObjectAtIndex:0]; [self complete:write[@"id"] error:nil details:nil]; + } +} +- (void)peripheralIsReadyToSendWriteWithoutResponse:(CBPeripheral *)peripheral { [self drain:[self remember:peripheral]]; } +- (void)peripheral:(CBPeripheral *)peripheral didWriteValueForCharacteristic:(CBCharacteristic *)characteristic error:(NSError *)error { + FCBPeripheral *peer = [self remember:peripheral]; + if (!peer.awaitingWriteResponse || !peer.writes.count) return; + NSDictionary *write = peer.writes.firstObject; [peer.writes removeObjectAtIndex:0]; peer.awaitingWriteResponse = NO; + [self complete:write[@"id"] error:error.localizedDescription details:nil]; [self drain:peer]; +} +- (void)failPeer:(FCBPeripheral *)peer reason:(NSString *)reason { + if (!peer) return; + NSNumber *connect = peer.connectRequest; peer.connectRequest = nil; + [self complete:connect error:reason details:nil]; + NSArray *subscriptions = peer.subscriptions.allValues; [peer.subscriptions removeAllObjects]; + NSArray *writes = [peer.writes copy]; [peer.writes removeAllObjects]; peer.awaitingWriteResponse = NO; + for (NSNumber *request in subscriptions) [self complete:request error:reason details:nil]; + for (NSDictionary *write in writes) [self complete:write[@"id"] error:reason details:nil]; + [peer.characteristics removeAllObjects]; + if (peer.peripheral.state != CBPeripheralStateDisconnected) [self.central cancelPeripheralConnection:peer.peripheral]; + [self emit:@{@"kind": @"disconnected", @"identifier": peer.peripheral.identifier.UUIDString, @"message": reason}]; +} +- (void)disconnect:(NSString *)identifier { [self failPeer:self.peers[identifier.uppercaseString] reason:@"Disconnected"]; } +@end diff --git a/App_Resources/iOS/src/module.modulemap b/App_Resources/iOS/src/module.modulemap index 560d5493..03ec29ec 100644 --- a/App_Resources/iOS/src/module.modulemap +++ b/App_Resources/iOS/src/module.modulemap @@ -1,4 +1,5 @@ module FaceclawGraphics { header "FaceclawGraphics.h" + header "FaceclawBluetooth.h" export * } diff --git a/app/g2/ble-protocol.ts b/app/g2/ble-protocol.ts new file mode 100644 index 00000000..a85c2219 --- /dev/null +++ b/app/g2/ble-protocol.ts @@ -0,0 +1,178 @@ +/** G2 wire protocol, ported from g2protocol/BleProtocol.java. No platform APIs. */ +export const G2_WRITE = '00002760-08c2-11e1-9073-0e8ac72e5401' +export const G2_NOTIFY = '00002760-08c2-11e1-9073-0e8ac72e5402' +export const G2_RENDER_NOTIFY = '00002760-08c2-11e1-9073-0e8ac72e6402' +export const RING_NOTIFY = ['bae80011-4f05-4503-8e65-3af1f7329d1f', 'bae80013-4f05-4503-8e65-3af1f7329d1f'] +export const SID = { auth: 0x80, launch: 1, hub: 0xe0, settings: 9 } as const +export function concat(...parts: Uint8Array[]): Uint8Array { + const output = new Uint8Array(parts.reduce((n, p) => n + p.length, 0)) + let offset = 0; for (const part of parts) { output.set(part, offset); offset += part.length }; return output +} +function varint(value: number): Uint8Array { + const bytes: number[] = [] + do { const next = value & 127; value >>>= 7; bytes.push(next | (value ? 128 : 0)) } while (value) + return new Uint8Array(bytes) +} +export const integer = (field: number, value: number): Uint8Array => concat(varint(field * 8), varint(value)) +export const bytes = (field: number, value: Uint8Array): Uint8Array => concat(varint(field * 8 + 2), varint(value.length), value) +// Outbound names/text here are fixed ASCII protocol identifiers. +const string = (field: number, value: string): Uint8Array => bytes(field, new Uint8Array(Array.from(value, c => c.charCodeAt(0)))) +const wrap = (command: number, magic: number, field: number, body: Uint8Array) => concat(integer(1, command), integer(2, magic), bytes(field, body)) +export const authentication = (magic: number) => wrap(4, magic, 3, concat(integer(1, 1), integer(2, 4))) +export const prelude = () => wrap(2, 156, 4, bytes(3, bytes(2, bytes(2, concat(integer(1, 0), integer(2, 0)))))) +export const heartbeat = (magic: number) => wrap(12, magic, 14, integer(1, 0)) +export const settingsQuery = (magic: number) => wrap(2, magic, 4, integer(1, 1)) +export const shutdown = (magic: number) => wrap(9, magic, 11, integer(1, 1)) +export const framebufferLease = (acquire: boolean) => concat(integer(1, 1), integer(2, 0), bytes(101, new Uint8Array([70, 67, 1, acquire ? 5 : 6, 0, 0]))) +export function createLayout(magic: number): Uint8Array { + const geometry = concat(integer(1, 0), integer(2, 0), integer(3, 576), integer(4, 288)) + const text = concat(geometry, integer(9, 1), string(10, 'dashboard'), integer(11, 1), string(12, ' ')) + const image = concat(geometry, integer(5, 10), string(6, 'img00')) + return wrap(0, magic, 3, concat(integer(1, 2), bytes(3, text), bytes(4, image), integer(5, 10000))) +} +export function imageFragment(magic: number, payload: Uint8Array, offset: number, size = 3800): Uint8Array { + const fragment = payload.subarray(offset, offset + size) + return wrap(3, magic, 5, concat(integer(1, 10), string(2, 'img00'), integer(3, 10), integer(4, payload.length), + integer(5, 0), integer(6, Math.floor(offset / size)), integer(7, fragment.length), bytes(8, fragment))) +} +export function crc16(data: Uint8Array): number { + let crc = 0xffff + for (const byte of data) { + crc ^= byte << 8 + for (let i = 0; i < 8; i++) crc = ((crc << 1) ^ ((crc & 0x8000) ? 0x1021 : 0)) & 0xffff + } + return crc +} +export function frameMessage(payload: Uint8Array, sid: number, flag: number, sequence: number, maxWrite = 240): Uint8Array[] { + const chunkSize = Math.min(232, Math.floor(maxWrite) - 8) + if (chunkSize < 12) throw new Error('Negotiated BLE write size is too small') + const crc = crc16(payload), withCrc = concat(payload, new Uint8Array([crc & 255, crc >>> 8])) + const count = Math.ceil(withCrc.length / chunkSize) + if (count > 255) throw new Error('Protocol message exceeds the fragment limit') + return Array.from({ length: count }, (_, i) => { + const chunk = withCrc.subarray(i * chunkSize, (i + 1) * chunkSize) + return concat(new Uint8Array([0xaa, 0x21, sequence & 255, chunk.length, count, i + 1, sid, flag]), chunk) + }) +} +export type ProtocolMessage = { sid: number; flag: number; payload: Uint8Array; command: number; magic: number } +/** Handles split/coalesced envelopes and reassembles each link/sequence separately. */ +export class MessageReceiver { + private streams = new Map() + private messages = new Map() + clear(): void { this.streams.clear(); this.messages.clear() } + receive(link: string, data: Uint8Array, now = Date.now()): ProtocolMessage[] { + for (const [key, message] of this.messages) if (now - message.seen > 5000) this.messages.delete(key) + let stream = concat(this.streams.get(link) ?? new Uint8Array(), data) + const output: ProtocolMessage[] = [] + while (stream.length >= 8) { + if (stream[0] !== 0xaa || ![0x21, 0x12].includes(stream[1])) { stream = stream.subarray(1); continue } + const length = stream[3], count = stream[4], index = stream[5] + if (stream.length < length + 8) break + const sid = stream[6], flag = stream[7], key = `${link}:${stream[2]}:${sid}:${flag}` + const chunk = stream.slice(8, 8 + length); stream = stream.subarray(length + 8) + if (!count || !index || index > count) { this.messages.delete(key); continue } + if (index === 1) this.messages.set(key, { chunks: [], total: count, seen: now, size: 0 }) + const message = this.messages.get(key) + if (!message || message.total !== count || message.chunks.length + 1 !== index) { this.messages.delete(key); continue } + message.chunks.push(chunk); message.size += chunk.length; message.seen = now + if (message.size > 65536) { this.messages.delete(key); continue } + if (index !== count) continue + this.messages.delete(key) + const complete = concat(...message.chunks) + if (complete.length < 2) continue + const payload = complete.subarray(0, -2), crc = complete[complete.length - 2] | (complete[complete.length - 1] << 8) + if (crc16(payload) !== crc) continue + try { output.push({ sid, flag, payload, command: readInteger(payload, 1, -1), magic: readInteger(payload, 2, -1) }) } + catch { /* Malformed notifications cannot satisfy an acknowledgement. */ } + } + this.streams.set(link, stream.slice()) + return output + } +} +function readVarint(data: Uint8Array, offset: number): [number, number] { + let value = 0 + for (let i = 0; i < 5 && offset < data.length; i++) { + const byte = data[offset++]; value += (byte & 127) * 2 ** (i * 7) + if (!(byte & 128)) return [value, offset] + } + throw new Error('Truncated or oversized protobuf varint') +} +function field(data: Uint8Array, number: number): number | Uint8Array | undefined { + let offset = 0 + while (offset < data.length) { + let key: number; [key, offset] = readVarint(data, offset) + const tag = key >>> 3, wire = key & 7 + if (!tag) throw new Error('Invalid protobuf field') + if (wire === 0) { + let value: number; [value, offset] = readVarint(data, offset) + if (tag === number) return value + } else { + let length: number + if (wire === 2) [length, offset] = readVarint(data, offset) + else if (wire === 1) length = 8 + else if (wire === 5) length = 4 + else throw new Error('Unsupported protobuf wire type') + if (offset + length > data.length) throw new Error('Truncated protobuf field') + if (tag === number && wire === 2) return data.subarray(offset, offset + length) + offset += length + } + } + return undefined +} +export function readInteger(data: Uint8Array, number: number, fallback = 0): number { const value = field(data, number); return typeof value === 'number' ? value : fallback } +export function readBytes(data: Uint8Array, number: number): Uint8Array | undefined { const value = field(data, number); return value instanceof Uint8Array ? value : undefined } +export function readString(data: Uint8Array, number: number): string { return Array.from(readBytes(data, number) ?? [], value => String.fromCharCode(value)).join('') } +export function authenticationSucceeded(message: ProtocolMessage, magic: number): boolean { + return message.sid === SID.auth && message.command === 4 && message.magic === magic && readBytes(message.payload, 3)?.length === 0 +} +export type GlassesInput = { kind: 'sys-event' | 'list-click' | 'text-click'; eventType: number; eventSource: number; systemExitReasonCode: number; containerName: string; frameId: number } +export function decodeGlassesInput(message: ProtocolMessage): GlassesInput | null { + if (message.sid !== SID.hub || ![1, 6].includes(message.flag)) return null + const events = readBytes(message.payload, 13); if (!events) return null + for (const [field, kind, typeField] of [[1, 'list-click', 5], [2, 'text-click', 3], [3, 'sys-event', 1]] as const) { + const event = readBytes(events, field) + if (event) return { kind, eventType: readInteger(event, typeField), eventSource: field === 3 ? readInteger(event, 2) : 0, + systemExitReasonCode: field === 3 ? readInteger(event, 4) : 0, containerName: field === 3 ? '' : readString(event, 2), frameId: 0 } + } + return null +} +export function decodeRingInput(data: Uint8Array): GlassesInput | null { + let eventType: number | undefined + if (data.length === 11 && data[0] === 0 && data[1] === 9 && data[2] === 0x61 && data[3] === 0) + eventType = ({ 0: 9, 1: 0, 2: 3, 4: 1, 5: 2, 8: 10 } as Record)[data[4]] + if (data.length === 3 && data[0] === 255) { + if (data[1] === 3 && data[2] === 32) eventType = 9 + if (data[1] === 4 && data[2] === 1) eventType = 0 + if (data[1] === 4 && data[2] === 2) eventType = 3 + if (data[1] === 5) eventType = data[2] <= 1 ? 2 : 1 + } + return eventType === undefined ? null : { kind: 'sys-event', eventType, eventSource: 2, systemExitReasonCode: 0, containerName: '', frameId: 0 } +} +export function packGray4(gray: Uint8Array, width: number, height: number): Uint8Array { + if (!Number.isInteger(width) || !Number.isInteger(height) || width < 1 || height < 1 || gray.length !== width * height) throw new Error('Invalid display frame') + const stride = Math.ceil(width / 2), packed = new Uint8Array(stride * height) + for (let y = 0; y < height; y++) for (let x = 0; x < width; x++) { + const nibble = Math.min(15, (gray[y * width + x] + 8) >> 4) + packed[y * stride + (x >> 1)] |= nibble << (x % 2 ? 0 : 4) + } + return packed +} +export function rle4(packed: Uint8Array): Uint8Array { + const output = new Uint8Array(packed.length * 2) + const nibble = (i: number) => (packed[i >> 1] >> (i % 2 ? 0 : 4)) & 15 + let used = 0, i = 0 + while (i < packed.length * 2) { + const color = nibble(i); let end = i + 1 + while (end < packed.length * 2 && nibble(end) === color) end++ + let remaining = end - i + while (remaining) { + const count = Math.min(65535, remaining) + if (count <= 15) output[used++] = (count << 4) | color + else { output[used++] = color; if (count <= 255) output[used++] = count + else { output[used++] = 0; output[used++] = count & 255; output[used++] = count >>> 8 } } + remaining -= count + } + i = end + } + return output.slice(0, used) +} diff --git a/app/g2/glasses-session.ts b/app/g2/glasses-session.ts new file mode 100644 index 00000000..8f7a67ae --- /dev/null +++ b/app/g2/glasses-session.ts @@ -0,0 +1,298 @@ +import * as protocol from './ble-protocol' +import { hexToBytes } from '../util/hex-util' +import { deviceAddressError } from './ios-peripheral-identity' + +declare function setTimeout(callback: () => void, ms: number): number +declare function clearTimeout(id: number): void +export type SessionAddresses = { left: string; right: string; ring: string } +export type TransportEvent = { kind: string; identifier?: string; characteristic?: string; data?: string; message?: string; state?: number } +export interface SessionTransport { + onEvent(listener: (event: TransportEvent) => void): () => void + resolveDevices(addresses: SessionAddresses): Promise> + connect(identifier: string): Promise<{ characteristics: string[]; maxWrite: number }> + subscribe(identifier: string, characteristic: string): Promise + write(identifier: string, characteristic: string, bytes: Uint8Array): Promise + disconnect(identifier: string): void + stopScan(): void +} +export type SessionState = { phase: 'disconnected' | 'connecting' | 'connected' | 'retrying' | 'disconnecting' | 'error'; + status: string; battery: number | null; ring: boolean; frames: number; capabilities: string; leftVersion: string; rightVersion: string } +type PendingAck = { resolve: (message: protocol.ProtocolMessage) => void; reject: (error: Error) => void; + timer: number | null; command: number; label: string } +class AckTimeout extends Error {} + +/** G2 session independent of the phone OS. Images go to L, control to R, as on Android. */ +export class GlassesSession { + state: SessionState = { phase: 'disconnected', status: 'Preview only', battery: null, ring: false, + frames: 0, capabilities: '', leftVersion: '', rightVersion: '' } + private generation = 0 + private ids: Record = {} + private limits: Record = {} + private pending = new Map() + private receiver = new protocol.MessageReceiver() + private writes = new Map>() + private magic = 100 + private sequence = 0x40 + private timer: number | null = null + private retryTimer: number | null = null + private retryCount = 0 + private wanted = false + private addresses: SessionAddresses | null = null + private latest: Uint8Array | null = null + private displayed: Uint8Array | null = null + private pumping = false + private lastHeartbeat = 0 + private lastLease = 0 + private lastSettings = 0 + private charging = false + private layoutCreated = false + private off: () => void + constructor(private readonly transport: SessionTransport, + private readonly deflate: (data: Uint8Array) => Uint8Array, + private readonly onState: (state: SessionState) => void, + private readonly onInput: (input: protocol.GlassesInput) => void, + private readonly log: (message: string) => void = () => {}) { + this.off = transport.onEvent(event => this.receive(event)) + } + private update(phase: SessionState['phase'], status: string): void { + this.state = { ...this.state, phase, status }; this.log(status); this.onState({ ...this.state }) + } + async start(addresses: SessionAddresses, retry = false): Promise { + if (['connecting', 'connected', 'disconnecting'].includes(this.state.phase)) return + const invalid = deviceAddressError(addresses) + if (invalid) { this.update('error', invalid); return } + this.addresses = { ...addresses }; this.wanted = true + if (!retry) this.retryCount = 0 + const generation = ++this.generation + this.state = { ...this.state, capabilities: '', leftVersion: '', rightVersion: '', battery: null, ring: false } + this.charging = false + this.update('connecting', 'Finding configured devices…') + try { + const ids = await this.transport.resolveDevices(addresses); this.check(generation) + this.ids = ids + for (const role of ['right', 'left']) { + this.update('connecting', `Connecting ${role} arm…`) + const details = await this.transport.connect(ids[role]); this.check(generation) + this.limits[role] = details.maxWrite + if (!details.characteristics.includes(protocol.G2_WRITE) || !details.characteristics.includes(protocol.G2_NOTIFY)) throw new Error(`${role} arm is missing G2 communication characteristics.`) + await this.transport.subscribe(ids[role], protocol.G2_NOTIFY); this.check(generation) + } + this.update('connecting', 'Authenticating… Accept pairing if iOS asks.') + await Promise.all(['right', 'left'].map(async role => { + try { + const answer = await this.request(role, protocol.SID.auth, protocol.authentication, 'Security authentication', 30_000, 0) + if (!protocol.authenticationSucceeded(answer, answer.magic)) throw new Error(`${role} arm rejected authentication.`) + } catch (error) { + if (!(error instanceof AckTimeout)) throw error + // Older CFW may not implement the reply. A settings response below + // still has to prove we have a working, compatible session. + this.log(`${role} authentication unconfirmed; checking firmware response`) + } + })) + this.check(generation) + this.update('connecting', 'Checking glasses firmware…') + const settings = await this.request('right', protocol.SID.settings, protocol.settingsQuery, 'Settings query') + this.applySettings(settings) + const caps = this.state.capabilities.split(/\s+/) + if (!['img640', 'fbguard', 'wearnotify'].every(cap => caps.includes(cap))) + throw new Error('The glasses do not report compatible Faceclaw firmware (img640, fbguard, wearnotify). Bluetooth is working, but this display requires the modified firmware. Flashing remains available on Android.') + this.update('connecting', 'Starting glasses display…') + await this.request('right', protocol.SID.launch, () => protocol.prelude(), 'App launch', 3500, 0x20, 156) + await this.lease(true) + await this.request('right', protocol.SID.hub, protocol.createLayout, 'Create display layout') + this.check(generation); this.layoutCreated = true + this.lastHeartbeat = this.lastLease = this.lastSettings = Date.now() + this.displayed = null; this.retryCount = 0 + this.update('connected', 'Glasses connected') + this.schedule() + if (addresses.ring && ids.ring) { + try { + const ring = await this.transport.connect(ids.ring); this.check(generation) + const notifications = protocol.RING_NOTIFY.filter(uuid => ring.characteristics.includes(uuid)) + if (!notifications.length) throw new Error('No R1 gesture notifications found') + for (const uuid of notifications) await this.transport.subscribe(ids.ring, uuid) + this.check(generation); this.state.ring = true; this.update('connected', 'Glasses and ring connected') + } catch (error) { + if (generation !== this.generation) return + this.transport.disconnect(ids.ring) + this.update('connected', `Glasses connected; ring unavailable: ${this.message(error)}`) + } + } else if (addresses.ring) this.update('connected', 'Glasses connected; configured ring was not found') + } catch (error) { + if (generation !== this.generation) return + this.fail(error, retry) + } + } + private check(generation: number): void { if (generation !== this.generation) throw new Error('Connection cancelled') } + private nextMagic(): number { + for (let i = 0; i < 156; i++) { + const magic = this.magic; this.magic = this.magic === 255 ? 100 : this.magic + 1 + if (magic !== 156 && ![...this.pending.keys()].some(key => key.endsWith(`:${magic}`))) return magic + } + throw new Error('All message identifiers are in use') + } + private request(role: string, sid: number, build: (magic: number) => Uint8Array, label: string, + timeout = 3500, flag = 0x20, fixedMagic?: number): Promise { + const magic = fixedMagic ?? this.nextMagic(), payload = build(magic), key = `${sid}:${magic}` + const generation = this.generation + return new Promise((resolve, reject) => { + const pending: PendingAck = { resolve, reject, timer: null, command: protocol.readInteger(payload, 1, -1), label } + this.pending.set(key, pending) + this.send(role, sid, flag, payload).then(() => { + if (this.pending.get(key) !== pending || generation !== this.generation) return + pending.timer = setTimeout(() => { + this.pending.delete(key); reject(new AckTimeout(`${label} was not acknowledged by the glasses.`)) + }, timeout) + }).catch(error => { + if (this.pending.get(key) !== pending) return + this.pending.delete(key); if (pending.timer) clearTimeout(pending.timer); reject(error) + }) + }) + } + private send(role: string, sid: number, flag: number, payload: Uint8Array): Promise { + const identifier = this.ids[role], generation = this.generation + if (!identifier) return Promise.reject(new Error(`No ${role} device connected`)) + const frames = protocol.frameMessage(payload, sid, flag, this.sequence++, this.limits[role]) + const previous = this.writes.get(identifier) ?? Promise.resolve() + const work = previous.catch(() => {}).then(async () => { + for (const frame of frames) { this.check(generation); await this.transport.write(identifier, protocol.G2_WRITE, frame) } + }) + // A whole message owns the write queue; heartbeat packets cannot split an image message. + this.writes.set(identifier, work) + return work + } + private lease(acquire: boolean): Promise { + return Promise.all(['right', 'left'].map(role => this.send(role, protocol.SID.settings, 0x20, protocol.framebufferLease(acquire)))) + } + private receive(event: TransportEvent): void { + if (!Object.values(this.ids).includes(event.identifier ?? '')) return + if (event.kind === 'disconnected') { + if (event.identifier === this.ids.ring) { + this.state.ring = false + if (this.state.phase === 'connected') this.update('connected', 'Glasses connected; ring disconnected') + } else if (['connected', 'connecting'].includes(this.state.phase)) this.fail(new Error(event.message || 'Glasses disconnected'), true) + return + } + if (event.kind !== 'notification' || !event.data) return + try { + const data = hexToBytes(event.data) + if (event.identifier === this.ids.ring) { + if (!protocol.RING_NOTIFY.includes(event.characteristic ?? '')) return + const input = protocol.decodeRingInput(data); if (input) this.onInput(input); return + } + if (event.characteristic !== protocol.G2_NOTIFY) return + for (const message of this.receiver.receive(event.identifier!, data)) { + if (![1, 6].includes(message.flag)) { + // A master arm can relay the other arm's ACK; magic is allocated + // across BOTH links, matching Android's communicator. + const key = `${message.sid}:${message.magic}`, pending = this.pending.get(key) + if (pending) { + this.pending.delete(key); if (pending.timer) clearTimeout(pending.timer) + pending.resolve(message) + } + } + if (message.sid === protocol.SID.settings) this.applySettings(message) + if (event.identifier === this.ids.right) { + const input = protocol.decodeGlassesInput(message) + if (input) { + if (input.kind === 'sys-event' && [5, 6, 7].includes(input.eventType) && this.state.phase === 'connected') { + // Respect an explicit glasses-side exit; the user can reconnect. + void this.stop(); continue + } + this.onInput(input) + } + } + } + } catch (error) { this.log(`Ignored malformed BLE notification: ${this.message(error)}`) } + } + private applySettings(message: protocol.ProtocolMessage): void { + const values = protocol.readBytes(message.payload, 4) + const capabilities = protocol.readString(message.payload, 100) + if (capabilities) this.state.capabilities = capabilities + if (values) { + const left = protocol.readString(values, 5), right = protocol.readString(values, 6) + if (left) this.state.leftVersion = left + if (right) this.state.rightVersion = right + const battery = protocol.readInteger(values, 12, -1), charging = protocol.readInteger(values, 13, -1) + if (battery >= 0 && battery <= 100) this.state.battery = battery + if (charging >= 0) this.charging = charging > 0 + } + this.onState({ ...this.state }) + } + setFrame(gray: Uint8Array): void { + if (this.state.phase !== 'connected') return + this.latest = protocol.packGray4(gray, 640, 480); this.schedule(0) + } + private schedule(delay = 1000): void { + if (delay === 0 && this.timer !== null) { clearTimeout(this.timer); this.timer = null } + if (this.timer !== null || this.pumping || this.state.phase !== 'connected') return + this.timer = setTimeout(() => { this.timer = null; void this.pump() }, delay) + } + private async pump(): Promise { + if (this.pumping || this.state.phase !== 'connected') return + this.pumping = true; const generation = this.generation + try { + const now = Date.now() + if (now - this.lastHeartbeat >= 4000) { + await this.request('right', protocol.SID.hub, protocol.heartbeat, 'Heartbeat', 1500); this.lastHeartbeat = Date.now() + } + if (now - this.lastLease >= 45_000) { await this.lease(true); this.lastLease = Date.now() } + if (now - this.lastSettings >= (this.charging ? 30_000 : 300_000)) { + const settings = await this.request('right', protocol.SID.settings, protocol.settingsQuery, 'Battery query') + this.applySettings(settings); this.lastSettings = Date.now() + } + const frame = this.latest; this.latest = null + if (frame && !this.charging && (!this.displayed || !frame.every((value, i) => value === this.displayed![i]))) { + const payload = protocol.concat(new Uint8Array([6]), this.deflate(protocol.rle4(frame))) + if (payload.length > 165888) throw new Error('Compressed frame exceeds the glasses image buffer') + for (let offset = 0; offset < payload.length; offset += 3800) { + await this.request('left', protocol.SID.hub, magic => protocol.imageFragment(magic, payload, offset), 'Display frame') + this.check(generation); this.lastHeartbeat = Date.now() + } + this.displayed = frame; this.state.frames++; this.onState({ ...this.state }) + this.log(`Display frame ${this.state.frames} acknowledged (${payload.length} bytes)`) + } else if (frame && this.charging) this.latest = frame + } catch (error) { if (generation === this.generation) this.fail(error, true) } + finally { if (generation === this.generation) { this.pumping = false; this.schedule(this.latest && !this.charging ? 0 : 1000) } } + } + private reset(): void { + ++this.generation + if (this.timer !== null) clearTimeout(this.timer) + if (this.retryTimer !== null) clearTimeout(this.retryTimer) + this.timer = this.retryTimer = null; this.pumping = false + const pending = [...this.pending.values()]; this.pending.clear() + for (const request of pending) { if (request.timer) clearTimeout(request.timer); request.reject(new Error('Connection ended')) } + this.receiver.clear(); this.writes.clear(); this.latest = this.displayed = null + } + private closeLinks(): void { + const ids = this.ids; this.ids = {}; this.limits = {} + for (const identifier of Object.values(ids)) this.transport.disconnect(identifier) + this.transport.stopScan(); this.layoutCreated = false; this.state.ring = false + } + private fail(error: unknown, retry: boolean): void { + const message = this.message(error); this.reset(); this.closeLinks() + if (retry && this.wanted && this.addresses && this.retryCount < 5) { + const delay = Math.min(30_000, 2000 * 2 ** this.retryCount++) + this.update('retrying', `${message} Retrying in ${delay / 1000}s…`) + this.retryTimer = setTimeout(() => { this.retryTimer = null; if (this.wanted && this.addresses) void this.start(this.addresses, true) }, delay) + } else { this.wanted = false; this.update('error', message) } + } + async stop(): Promise { + this.wanted = false + const cleanup = this.layoutCreated && this.state.phase === 'connected' + this.update('disconnecting', 'Disconnecting…'); this.reset() + try { + if (cleanup) { + if (this.state.capabilities.split(/\s+/).includes('cleanup11')) + await this.request('left', protocol.SID.hub, magic => protocol.imageFragment(magic, new Uint8Array([11]), 0), 'Display cleanup', 1200) + else { + await this.request('right', protocol.SID.hub, protocol.shutdown, 'Close display', 1200) + await this.lease(false) + } + } + } catch (error) { this.log(`Disconnect cleanup: ${this.message(error)}`) } + finally { this.reset(); this.closeLinks(); this.update('disconnected', 'Preview only') } + } + dispose(): void { void this.stop().finally(() => this.off()) } + private message(error: unknown): string { return error instanceof Error ? error.message : String(error) } +} diff --git a/app/g2/ios-peripheral-identity.ts b/app/g2/ios-peripheral-identity.ts new file mode 100644 index 00000000..4dd32f12 --- /dev/null +++ b/app/g2/ios-peripheral-identity.ts @@ -0,0 +1,25 @@ +import { classifyAdvertisement, hasEvenManufacturerSignature, type EvenAdvertisement } from './even-advertisement' +import { hexToBytes } from '../util/hex-util' + +export type IosAdvertisement = { identifier: string; name: string; manufacturerData: string; rssi: number; connectable: boolean } +export type IosDevice = EvenAdvertisement & { identifier: string } + +/** Only a full vendor-advertised MAC may bind a manually entered address. */ +export function identifyIosPeripheral(raw: IosAdvertisement): IosDevice | null { + if (!/^[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}$/i.test(raw.identifier)) return null + if (!hasEvenManufacturerSignature(hexToBytes(raw.manufacturerData))) return null + const candidate = classifyAdvertisement({ ...raw, address: '', source: 'scan', bonded: false, + txPower: null, seenAtMs: Date.now() }) + if (!candidate?.embeddedMac) return null + return { ...candidate, address: candidate.embeddedMac, embeddedMacMismatch: false, identifier: raw.identifier.toUpperCase() } +} + +export function deviceAddressError(addresses: { left: string; right: string; ring: string }): string | null { + for (const role of ['right', 'left', 'ring'] as const) { + const address = addresses[role] + if (role === 'ring' && !address) continue + if (!/^[0-9A-F]{2}(?::[0-9A-F]{2}){5}$/.test(address)) return `${role === 'ring' ? 'Ring' : role === 'left' ? 'Left arm' : 'Right arm'} MAC address is invalid.` + } + const values = Object.values(addresses).filter(Boolean) + return new Set(values).size === values.length ? null : 'Each device must have a different MAC address.' +} diff --git a/app/g2/ios-preview-controller.ts b/app/g2/ios-preview-controller.ts index c2ff1807..f1da35f9 100644 --- a/app/g2/ios-preview-controller.ts +++ b/app/g2/ios-preview-controller.ts @@ -1,4 +1,8 @@ -import { Dialogs, type ImageSource } from '@nativescript/core' +import { Dialogs, File, knownFolders, path, type ImageSource } from '@nativescript/core' +import { iosBluetooth } from '../native/ios-bluetooth' +import { GlassesSession, type SessionState } from './glasses-session' +import { loadDeviceAddresses } from './device-addresses' +import { deviceAddressError } from './ios-peripheral-identity' import { createLauncherWindow, LAUNCHER_SURFACE_ID } from '../apps/launcher/launcher-app' import { CalculatorLayer } from '../apps/calculator/calculator' import { MathCoordinator } from '../apps/calculator/math/coordinator' @@ -10,7 +14,7 @@ import { makeInputEvent, type InputEventPayload } from '../ui/gestures' import { noopLayerActions, type LayerActions } from '../ui/layers' import { MenuLayer } from '../ui/menu' import { createInProcessWindow } from '../ui/shell/in-process-window' -import { shell, type ShellWindow } from '../ui/shell/shell' +import { shell, rawInputEventToInputEvent, type ShellWindow } from '../ui/shell/shell' import { appViewportRect, SIDEBAR_WIDTH, sidebarStripVisible } from '../ui/shell/geometry' import { DISPLAY_MODE_VALUES, displayModeLabel, displayModeSetting, onAnySettingChanged, previewColorSetting, timeFormatSetting, verticalPositionSetting } from '../ui/dashboard-settings' @@ -27,6 +31,11 @@ export class IosPreviewController { private inputQueue: Promise = Promise.resolve() private lastLayout = '' private prompting = false + private session: GlassesSession | null = null + private resumeConnection = false + private suspendedDisconnect: Promise = Promise.resolve() + private logLines: string[] = [] + private logTimer: ReturnType | null = null private readonly actions: LayerActions = { ...noopLayerActions, requestRender: () => this.requestShellRender(), @@ -38,7 +47,8 @@ export class IosPreviewController { } constructor(private readonly onFrame: (image: ImageSource, focus: string) => void, - private readonly onError: (message: string) => void) { + private readonly onError: (message: string) => void, + private readonly onConnectionState: (state: SessionState) => void = () => {}) { this.compositor.configureSurface('shell', { x: 0, y: 0, width: 640, height: 480, zOrder: 1, transparency: 'color-key' }) shell.configure({ actions: this.actions, @@ -78,8 +88,14 @@ export class IosPreviewController { shell.foregroundWindow()?.requestRender() this.requestShellRender() console.log('[ios-preview] Main screen active') + if (this.resumeConnection) { + this.resumeConnection = false + void this.suspendedDisconnect.then(() => { if (this.active) void this.connect() }) + } } pause(): void { + this.resumeConnection = !!this.session && ['connected', 'connecting', 'retrying'].includes(this.session.state.phase) + if (this.session) this.suspendedDisconnect = this.session.stop() this.active = false this.offSettings?.(); this.offSettings = null if (this.clockTimer) clearInterval(this.clockTimer) @@ -119,7 +135,9 @@ export class IosPreviewController { this.compositor.submitSurfaceFrame('shell', image.pixels, { x: 0, y: 0, width: 640, height: 480 }) this.compositor.setUnderlayDim(1, shell.underlayDim()) } - const image = previewPixels(this.compositor.composite(), 640, 480, previewColorSetting.get() === 'green') + const pixels = this.compositor.composite() + this.session?.setFrame(pixels) + const image = previewPixels(pixels, 640, 480, previewColorSetting.get() === 'green') this.onFrame(image, `${shell.foregroundWindow()?.title ?? 'Apps'} · ${shell.getFocus() === 'sidebar' ? 'App switcher' : 'App'}`) } catch (error) { this.fail(error) } }, 33) @@ -203,6 +221,42 @@ export class IosPreviewController { displayModeSetting.set(values[(values.indexOf(displayModeSetting.get()) + 1) % values.length]) } get displayModeLabel(): string { return displayModeLabel(displayModeSetting.get()) } + get connectionState(): SessionState | null { return this.session?.state ?? null } + get connectionDetails(): string { + const state = this.connectionState + return state ? `${state.status}\nL: ${state.leftVersion || 'unknown'}\nR: ${state.rightVersion || 'unknown'}\nBattery: ${state.battery ?? '?'}%\nRing: ${state.ring ? 'connected' : 'disconnected'}\nFrames acknowledged: ${state.frames}\n${state.capabilities}\n\n${this.logLines.slice(-12).join('\n')}` : 'Preview only. Configure devices, then connect.' + } + async connect(): Promise { + if (!this.active) return + const addresses = loadDeviceAddresses(), error = deviceAddressError(addresses) + if (error) { this.onError(error); return } + if (!this.session) { + const { deflate } = require('pako') as { deflate: (data: Uint8Array) => Uint8Array } + this.session = new GlassesSession(iosBluetooth(), deflate, state => { + this.onConnectionState(state) + if (state.phase === 'connected') this.requestShellRender() + }, input => { + this.inputQueue = this.inputQueue.then(async () => { + if (!this.active) return + await shell.receiveInput(rawInputEventToInputEvent(input)); this.requestShellRender() + this.logBluetooth(`Input ${input.eventType} source ${input.eventSource}`) + }).catch(error => this.fail(error)) + }, message => this.logBluetooth(message)) + } + await this.session.start(addresses) + } + async disconnect(): Promise { this.resumeConnection = false; await this.session?.stop() } + private logBluetooth(message: string): void { + const line = `${new Date().toISOString()} ${message}` + console.log(`[ios-ble] ${line}`); this.logLines.push(line) + if (this.logLines.length > 200) this.logLines.shift() + if (this.logTimer !== null) return + this.logTimer = setTimeout(() => { + this.logTimer = null + try { File.fromPath(path.join(knownFolders.documents().path, 'bluetooth.log')).writeTextSync(this.logLines.join('\n')) } + catch (error) { console.warn(`Bluetooth log: ${error}`) } + }, 500) + } async typeIntoApp(): Promise { if (this.prompting || !shell.foregroundWindow()?.receiveTextInput) return this.prompting = true diff --git a/app/native/ios-bluetooth.ts b/app/native/ios-bluetooth.ts new file mode 100644 index 00000000..fab13d6b --- /dev/null +++ b/app/native/ios-bluetooth.ts @@ -0,0 +1,144 @@ +import { ApplicationSettings } from '@nativescript/core' +import { identifyIosPeripheral, type IosAdvertisement, type IosDevice } from '../g2/ios-peripheral-identity' +import { hexToBytes } from '../util/hex-util' + +declare const FaceclawBluetooth: any +type NativeEvent = { kind: string; id?: number; error?: string; details?: ConnectionDetails; state?: number; + identifier?: string; characteristic?: string; data?: string; message?: string } & Partial +export type ConnectionDetails = { characteristics: string[]; maxWrite: number } +export type BluetoothEvent = NativeEvent | { kind: 'device'; device: IosDevice } +type Pending = { resolve: (details: ConnectionDetails) => void; reject: (error: Error) => void; timer: ReturnType } + +/** One central manager per app, with asynchronous main-queue GATT operations. */ +export class IosBluetooth { + private readonly native = FaceclawBluetooth.new() + private readonly listeners = new Set<(event: BluetoothEvent) => void>() + private readonly pending = new Map() + private readonly advertisements = new Map() + readonly devices = new Map() + private requestId = 0 + private scanTimer: ReturnType | null = null + state = 0 + scanning = false + constructor() { + this.native.eventHandler = (json: string) => { + try { this.receive(JSON.parse(json)) } catch (error) { console.error(`[ios-ble] ${error}`) } + } + } + onEvent(listener: (event: BluetoothEvent) => void): () => void { + this.listeners.add(listener); return () => { this.listeners.delete(listener) } + } + private emit(event: BluetoothEvent): void { for (const listener of [...this.listeners]) listener(event) } + private receive(event: NativeEvent): void { + if (event.kind === 'completion') { + const pending = this.pending.get(event.id!) + if (pending) { + this.pending.delete(event.id!); clearTimeout(pending.timer) + if (event.error) pending.reject(new Error(event.error)); else pending.resolve(event.details!) + } + return + } + if (event.kind === 'state') this.state = event.state! + if (event.kind === 'advertisement') { + const previous = this.advertisements.get(event.identifier!) + const raw: IosAdvertisement = { identifier: event.identifier!, name: event.name || previous?.name || '', + manufacturerData: event.manufacturerData || previous?.manufacturerData || '', rssi: event.rssi!, connectable: event.connectable !== false } + // Bound the cache even in a crowded radio environment. + if (this.advertisements.size >= 512 && !this.advertisements.has(raw.identifier)) this.advertisements.delete(this.advertisements.keys().next().value!) + this.advertisements.set(raw.identifier, raw) + const device = identifyIosPeripheral(raw) + if (device) { + this.devices.set(device.address, device) + ApplicationSettings.setString(`ios.ble.peripheral.${device.address}`, JSON.stringify({ identifier: device.identifier, role: device.role })) + this.emit({ kind: 'device', device }) + } + return + } + this.emit(event) + } + ensureReady(): Promise { + return new Promise((resolve, reject) => { + const finish = (error?: Error) => { clearTimeout(timer); off(); error ? reject(error) : resolve() } + const off = this.onEvent(event => { + if (event.kind !== 'state') return + const state = (event as NativeEvent).state + if (state === 5) finish() + else if (state === 2) finish(new Error('Bluetooth is unavailable on this device. Use the physical iPhone.')) + else if (state === 3) finish(new Error('Allow Faceclaw to use Bluetooth in iPhone Settings.')) + else if (state === 4) finish(new Error('Turn on Bluetooth, then try again.')) + }) + const timer = setTimeout(() => finish(new Error('Waiting for Bluetooth permission timed out. Try again after allowing Bluetooth.')), 30_000) + this.native.initializeBluetooth() + }) + } + async startScan(durationMs = 12_000): Promise { + await this.ensureReady() + this.stopScan(); this.scanning = true; this.native.scan(true) + this.scanTimer = setTimeout(() => this.stopScan(), durationMs) + this.emit({ kind: 'scan-started' }) + } + stopScan(): void { + if (this.scanTimer) clearTimeout(this.scanTimer) + this.scanTimer = null; this.native.scan(false) + const wasScanning = this.scanning; this.scanning = false + if (wasScanning) this.emit({ kind: 'scan-stopped' }) + } + async resolveDevices(addresses: { left: string; right: string; ring: string }): Promise> { + await this.ensureReady() + const result: Record = {} + for (const role of ['left', 'right', 'ring'] as const) { + const address = addresses[role] + if (!address) continue + const live = this.devices.get(address) + if (live && live.role !== role) throw new Error(`${address} advertises as ${live.role}, not ${role}. Check Configure devices.`) + try { + const saved = JSON.parse(ApplicationSettings.getString(`ios.ble.peripheral.${address}`, '{}')) + if (saved.role === role && typeof saved.identifier === 'string') result[role] = saved.identifier + } catch { /* A fresh scan can recover malformed settings. */ } + } + const missing = () => (['left', 'right'] as const).filter(role => !result[role]) + if (!missing().length && (!addresses.ring || result.ring)) return result + await this.startScan(15_000) + await new Promise((resolve, reject) => { + const off = this.onEvent(event => { + if (event.kind === 'device') { + const device = (event as { device: IosDevice }).device + for (const role of ['left', 'right', 'ring'] as const) { + if (addresses[role] === device.address && device.role === role) result[role] = device.identifier + } + if (!missing().length && (!addresses.ring || result.ring)) { off(); this.stopScan(); resolve() } + } else if (event.kind === 'scan-stopped') { + off() + if (missing().length) reject(new Error(`Could not find the ${missing().join(' and ')} arm. Wake the glasses, disconnect other apps, and scan again.`)) + else resolve() // An optional missing ring must not block the glasses. + } + }) + }) + return result + } + private operation(identifier: string, call: (id: number) => void, timeoutMs = 10_000): Promise { + const id = ++this.requestId + return new Promise((resolve, reject) => { + const timer = setTimeout(() => { + this.pending.delete(id); this.native.disconnect(identifier) + reject(new Error('Bluetooth operation timed out. Wake the device and try connecting again.')) + }, timeoutMs) + this.pending.set(id, { resolve, reject, timer }) + try { call(id) } catch (error) { clearTimeout(timer); this.pending.delete(id); reject(error) } + }) + } + connect(identifier: string): Promise { return this.operation(identifier, id => this.native.connectRequestId(identifier, id), 20_000) } + async subscribe(identifier: string, characteristic: string): Promise { + await this.operation(identifier, id => this.native.subscribeCharacteristicRequestId(identifier, characteristic, id)) + } + async write(identifier: string, characteristic: string, bytes: Uint8Array): Promise { + const copy = new Uint8Array(bytes) + const data = NSData.dataWithBytesLength(interop.handleof(copy.buffer), copy.byteLength) + await this.operation(identifier, id => this.native.writeCharacteristicDataRequestId(identifier, characteristic, data, id)) + } + disconnect(identifier: string): void { this.native.disconnect(identifier) } + forget(address: string): void { ApplicationSettings.remove(`ios.ble.peripheral.${address}`); this.devices.delete(address) } +} +let instance: IosBluetooth | null = null +export function iosBluetooth(): IosBluetooth { return instance ??= new IosBluetooth() } +export { hexToBytes } diff --git a/app/phone-ui/config-page.ios.ts b/app/phone-ui/config-page.ios.ts new file mode 100644 index 00000000..7099ccbf --- /dev/null +++ b/app/phone-ui/config-page.ios.ts @@ -0,0 +1,68 @@ +import { Button, Color, GridLayout, Label, Page, ScrollView, StackLayout, TextField } from '@nativescript/core' +import { loadDeviceAddresses, normalizeMacAddress, saveDeviceAddresses } from '../g2/device-addresses' +import { deviceAddressError, type IosDevice } from '../g2/ios-peripheral-identity' +import { iosBluetooth } from '../native/ios-bluetooth' + +export function createConfigureDevicesPage(): Page { + const page = new Page(); page.actionBarHidden = true + const root = new GridLayout(); root.rows = 'auto,*,auto'; root.padding = 16; page.content = root + const title = new Label(); title.text = 'Configure devices'; title.fontSize = 24; title.fontWeight = 'bold'; root.addChild(title) + const scroll = new ScrollView(); GridLayout.setRow(scroll, 1); root.addChild(scroll) + const form = new StackLayout(); scroll.content = form + const text = (value: string, size = 15) => { + const label = new Label(); label.text = value; label.fontSize = size; label.textWrap = true; label.marginTop = 12; form.addChild(label); return label + } + text('Enter the G2 arm MAC addresses and optional R1 ring address. Scan once so this iPhone can find the matching devices. Saving does not connect.') + const stored = loadDeviceAddresses() + const fields = {} as Record<'left' | 'right' | 'ring', TextField> + for (const role of ['right', 'left', 'ring'] as const) { + text(role === 'ring' ? 'R1 ring MAC (optional)' : `${role === 'left' ? 'Left' : 'Right'} arm MAC`) + const field = new TextField(); field.text = stored[role]; field.hint = 'AA:BB:CC:DD:EE:FF' + field.autocorrect = false; field.autocapitalizationType = 'allcharacters'; field.fontSize = 18 + field.padding = 10; field.backgroundColor = new Color('#ffffff'); field.accessibilityLabel = `${role} MAC address` + field.accessibilityIdentifier = `device-address-${role}`; form.addChild(field); fields[role] = field + } + const status = text('Addresses are saved only when you tap Save.'); status.color = new Color('#285c45') + const button = (label: string, action: () => void) => { + const view = new Button(); view.text = label; view.fontSize = 15; view.marginTop = 12; view.on('tap', action); return view + } + let off: (() => void) | null = null + let closed = false + const found = new StackLayout() + const rows = new Map() + const showDevice = (device: IosDevice) => { + if (device.connectable === false) return + let row = rows.get(device.address) + if (!row) { + row = button('', () => { fields[device.role].text = device.address; status.text = `${device.role} address selected. Tap Save to keep it.` }) + row.textWrap = true; row.fontSize = 13; rows.set(device.address, row); found.addChild(row) + } + row.text = `${device.role === 'ring' ? 'Ring' : device.role === 'left' ? 'Left arm' : 'Right arm'} · ${device.address}\n${device.serial || device.name} · ${device.rssi ?? '?'} dBm` + } + const scan = button('Scan for devices', () => { + for (const field of Object.values(fields)) field.dismissSoftInput() + const ble = iosBluetooth() + off?.(); off = ble.onEvent(event => { + if (closed) return + if (event.kind === 'device' && 'device' in event) showDevice(event.device) + if (event.kind === 'scan-stopped') { scan.isEnabled = true; status.text = rows.size ? 'Tap a device to fill its address, then Save.' : 'No matching devices found. Wake the glasses and disconnect other apps, then scan again.' } + }) + rows.clear(); found.removeChildren(); scan.isEnabled = false; status.text = 'Scanning… Allow Bluetooth if iOS asks.' + void ble.startScan().catch(error => { if (!closed) { status.text = String(error.message ?? error); scan.isEnabled = true } }) + }) + form.addChild(scan); form.addChild(found) + const footer = new GridLayout(); footer.columns = '*,*'; GridLayout.setRow(footer, 2); root.addChild(footer) + const close = () => { closed = true; off?.(); off = null; iosBluetooth().stopScan(); page.closeModal() } + const back = button('Back', close); footer.addChild(back) + const save = button('Save', () => { + const addresses = { right: normalizeMacAddress(fields.right.text), left: normalizeMacAddress(fields.left.text), ring: normalizeMacAddress(fields.ring.text) } + const error = deviceAddressError(addresses) + if (error) { status.text = error; return } + saveDeviceAddresses(addresses) + for (const role of ['left', 'right', 'ring'] as const) { fields[role].text = addresses[role]; fields[role].dismissSoftInput() } + status.text = 'Saved device addresses. Return to the main screen and choose Connect.' + }) + GridLayout.setColumn(save, 1); footer.addChild(save) + page.on('unloaded', () => { closed = true; off?.(); off = null; iosBluetooth().stopScan() }) + return page +} diff --git a/app/phone-ui/main-page.ios.ts b/app/phone-ui/main-page.ios.ts index 1ade0eab..ba014754 100644 --- a/app/phone-ui/main-page.ios.ts +++ b/app/phone-ui/main-page.ios.ts @@ -1,7 +1,10 @@ -import { Application, Button, Color, GridLayout, Image, Label, Page, StackLayout, type TouchGestureEventData } from '@nativescript/core' +import { Application, Button, Color, Dialogs, GridLayout, Image, Label, Page, StackLayout, type TouchGestureEventData } from '@nativescript/core' +import { createConfigureDevicesPage } from './config-page.ios' import { IosPreviewController } from '../g2/ios-preview-controller' import { PhoneGestureRecognizer } from './phone-gestures' import { onAnySettingChanged, previewColorSetting } from '../ui/dashboard-settings' +import { loadDeviceAddresses } from '../g2/device-addresses' +import { deviceAddressError } from '../g2/ios-peripheral-identity' export function createMainPage(): Page { const page = new Page() @@ -13,10 +16,13 @@ export function createMainPage(): Page { header.columns = '*,auto'; header.padding = '12 20' const title = new Label() title.text = 'Faceclaw'; title.fontSize = 25; title.fontWeight = 'bold' - header.addChild(title) + const heading = new StackLayout(); heading.addChild(title); header.addChild(heading) const state = new Label() - state.text = 'Preview only'; state.fontSize = 14; state.verticalAlignment = 'middle' - GridLayout.setColumn(state, 1); header.addChild(state); root.addChild(header) + state.text = 'Preview only'; state.fontSize = 12; heading.addChild(state) + const devices = new Button() + devices.text = 'Devices'; devices.accessibilityLabel = 'Configure devices'; devices.fontSize = 14; devices.padding = '10 12' + devices.on('tap', () => { void openDevices() }) + GridLayout.setColumn(devices, 1); header.addChild(devices); root.addChild(header) const body = new GridLayout() GridLayout.setRow(body, 1); root.addChild(body) const mirror = new Image() @@ -52,7 +58,21 @@ export function createMainPage(): Page { mirror.imageSource = image; focus.text = selectedTab === 'ring' ? 'Ring' : label }, message => { errorLabel.text = message; errorLabel.visibility = 'visible'; selectTab('settings') + }, connection => { + state.text = connection.phase === 'connected' ? `Connected${connection.battery !== null ? ` · ${connection.battery}%` : ''}${connection.ring ? ' · R1' : ''}` + : ({ disconnected: 'Preview only', connecting: 'Connecting…', retrying: 'Reconnecting…', disconnecting: 'Disconnecting…', error: 'Connection failed · Devices for details' })[connection.phase] || connection.phase }) + async function openDevices(): Promise { + const connected = ['connected', 'connecting', 'retrying'].includes(controller.connectionState?.phase ?? '') + const choice = await Dialogs.action({ title: 'Devices', message: controller.connectionState?.status ?? 'Preview only', cancelButtonText: 'Cancel', + actions: ['Configure devices', connected ? 'Disconnect' : 'Connect', 'Connection details'] }) + if (choice === 'Configure devices') { + await controller.disconnect() + page.showModal(createConfigureDevicesPage(), { fullscreen: true, closeCallback: () => {} }) + } else if (choice === 'Connect') await controller.connect() + else if (choice === 'Disconnect') await controller.disconnect() + else if (choice === 'Connection details') await Dialogs.alert({ title: 'Connection details', message: controller.connectionDetails, okButtonText: 'OK' }) + } const padInput = new PhoneGestureRecognizer(gesture => controller.gesture(gesture, selectedTab === 'ring' ? 'ring' : 'watch')) const mirrorInput = new PhoneGestureRecognizer((gesture, x, y) => { const size = mirror.getActualSize() @@ -128,10 +148,16 @@ export function createMainPage(): Page { } const resume = () => controller.resume() let offSettings: (() => void) | null = null + let firstLoad = true page.on('loaded', () => { Application.on(Application.suspendEvent, pause); Application.on(Application.resumeEvent, resume) offSettings?.(); offSettings = onAnySettingChanged(() => { sizeButton.text = controller.displayModeLabel }) selectTab(selectedTab); controller.resume() + if (firstLoad) { + firstLoad = false + // Match Android's reconnect-on-launch behavior once addresses are saved. + if (!deviceAddressError(loadDeviceAddresses())) void controller.connect() + } }) page.on('unloaded', () => { pause(); offSettings?.(); offSettings = null diff --git a/tests/ios-ble.test.cjs b/tests/ios-ble.test.cjs new file mode 100644 index 00000000..07c186d6 --- /dev/null +++ b/tests/ios-ble.test.cjs @@ -0,0 +1,171 @@ +const test = require('node:test'); +const assert = require('node:assert/strict'); +const p = require('../.test-build/app/g2/ble-protocol.js'); +const { identifyIosPeripheral, deviceAddressError } = require('../.test-build/app/g2/ios-peripheral-identity.js'); +const { GlassesSession } = require('../.test-build/app/g2/glasses-session.js'); +const { deflate, inflate } = require('pako'); +const hex = bytes => Buffer.from(bytes).toString('hex'); +const string = (field, text) => p.bytes(field, new Uint8Array(Buffer.from(text))); + +// Generated by compiling the existing Android BleProtocol.java/BmpUtil.java, +// plus BleImageOptimizer's unchanged RLE method, with javac 25.0.2. +test('iOS/shared protocol matches Android-generated wire vectors byte for byte', () => { + const vectors = [ + [p.authentication(101), '080410651a0408011004'], + [p.prelude(), '0802109c01220a1a081206120408001000'], + [p.createLayout(102), '080010661a3808021a1c0800100018c00420a0024801520964617368626f617264580162012022130800100018c00420a002280a3205696d67303028904e'], + [p.heartbeat(103), '080c106772020800'], + [p.settingsQuery(104), '0802106822020801'], + [p.shutdown(105), '080910695a020801'], + [p.framebufferLease(true), '08011000aa0606464301050000'], + [p.framebufferLease(false), '08011000aa0606464301060000'], + [p.imageFragment(106, new Uint8Array([6, 1, 2, 3, 4]), 0), '0803106a2a1a080a1205696d673030180a200528003000380542050601020304'], + [p.frameMessage(p.authentication(101), 128, 0, 64)[0], 'aa21400c01018000080410651a04080110041024'], + ]; + for (const [actual, expected] of vectors) assert.equal(hex(actual), expected); + const packed = p.packGray4(new Uint8Array([0, 1, 7, 8, 15, 16, 23, 24, 127, 128, 247, 255]), 3, 4); + assert.equal(hex(packed), '0000111012808ff0'); + assert.equal(hex(p.rle4(packed)), '40311011121810182f10'); +}); + +test('negotiated-MTU framing reassembles split and coalesced notifications and rejects bad CRC', () => { + const payload = p.concat(p.integer(1, 3), p.integer(2, 110), p.bytes(8, new Uint8Array(3900).fill(55))); + const frames = p.frameMessage(payload, 0xe0, 0x20, 17, 185); + assert.ok(frames.every(f => f.length <= 185)); + const receiver = new p.MessageReceiver(), stream = p.concat(...frames); + assert.deepEqual(receiver.receive('L', stream.slice(0, 7)), []); + const messages = receiver.receive('L', stream.slice(7)); + assert.equal(messages.length, 1); assert.deepEqual(messages[0].payload, payload); + stream[stream.length - 1] ^= 1; + assert.deepEqual(receiver.receive('L', stream), []); + assert.throws(() => p.frameMessage(payload, 1, 0, 1, 10), /too small/); + assert.throws(() => p.readBytes(new Uint8Array([0x1a, 0x7f]), 3), /Truncated/); +}); + +test('interleaved links and missing/expired fragments cannot produce false ACKs', () => { + const payload = p.concat(p.integer(1, 3), p.integer(2, 110), p.bytes(8, new Uint8Array(300))); + const frames = p.frameMessage(payload, 224, 0, 17), receiver = new p.MessageReceiver(); + assert.deepEqual(receiver.receive('L', frames[0], 0), []); + assert.deepEqual(receiver.receive('R', frames[1], 1), []); + assert.deepEqual(receiver.receive('L', frames[1], 6000), []); + assert.equal(receiver.receive('L', p.concat(...frames), 6001).length, 1); +}); + +test('full-frame RLE splits 65535-pixel runs and preserves opaque near-black', () => { + const packed = p.packGray4(new Uint8Array(640 * 480).fill(1), 640, 480); + assert.ok(packed.every(v => v === 0)); + const encoded = p.rle4(packed); + let count = 0, offset = 0; + while (offset < encoded.length) { + const token = encoded[offset++]; let run = token >>> 4; + if (!run) { run = encoded[offset++]; if (!run) { run = encoded[offset] | (encoded[offset + 1] << 8); offset += 2; } } + assert.equal(token & 15, 0); count += run; + } + assert.equal(count, 640 * 480); + assert.deepEqual(inflate(deflate(encoded)), encoded); +}); + +test('iOS mapping requires the full advertised MAC, never just a name suffix', () => { + const raw = { identifier: '8A2DD845-B208-F292-EB77-F4645C5AC42F', name: 'Even G2_32_L_B6ECE0', + manufacturerData: '4552' + Buffer.from('S211GBBC180304').toString('hex') + 'e0ecb61412e001', rssi: -45, connectable: true }; + const device = identifyIosPeripheral(raw); + assert.equal(device.address, 'E0:12:14:B6:EC:E0'); assert.equal(device.role, 'left'); + assert.equal(device.identifier, raw.identifier); assert.equal(device.serial, 'S211GBBC180304'); + assert.equal(identifyIosPeripheral({ ...raw, manufacturerData: '' }), null); + assert.equal(identifyIosPeripheral({ ...raw, identifier: 'not-a-uuid' }), null); + assert.match(deviceAddressError({ left: device.address, right: device.address, ring: '' }), /different/); + assert.equal(deviceAddressError({ left: device.address, right: 'AA:BB:CC:DD:EE:FF', ring: '' }), null); +}); + +test('ring and arm input decoders preserve gesture and source', () => { + assert.equal(p.decodeRingInput(new Uint8Array([255, 4, 2])).eventType, 3); + assert.equal(p.decodeRingInput(new Uint8Array([255, 5, 0])).eventType, 2); + assert.equal(p.decodeRingInput(new Uint8Array([255, 5, 2])).eventType, 1); + assert.equal(p.decodeRingInput(new Uint8Array([0, 9, 97, 0, 8, 0, 0, 0, 0, 0, 0])).eventType, 10); + assert.equal(p.decodeRingInput(new Uint8Array([255, 4, 99])), null); + const payload = p.bytes(13, p.bytes(3, p.concat(p.integer(1, 9), p.integer(2, 3)))); + assert.equal(p.decodeGlassesInput({ sid: 224, flag: 1, payload }).eventSource, 3); + assert.equal(p.decodeGlassesInput({ sid: 224, flag: 32, payload }), null); +}); + +class FakeTransport { + events = new Set(); receiver = new p.MessageReceiver(); sent = []; subscriptions = []; closed = []; + hold = false; held = []; stock = false; + onEvent(fn) { this.events.add(fn); return () => this.events.delete(fn); } + emit(event) { for (const fn of [...this.events]) fn(event); } + async resolveDevices() { return { left: 'L', right: 'R', ring: 'ring' }; } + async connect(id) { return { characteristics: id === 'ring' ? p.RING_NOTIFY : [p.G2_WRITE, p.G2_NOTIFY], maxWrite: 185 }; } + async subscribe(id, characteristic) { this.subscriptions.push([id, characteristic]); } + disconnect(id) { this.closed.push(id); this.emit({ kind: 'disconnected', identifier: id }); } + stopScan() {} + ack(id, message, overrides = {}) { + let body = new Uint8Array(); + if (message.sid === p.SID.auth) body = p.bytes(3, new Uint8Array()); + if (message.sid === p.SID.settings) body = p.concat(p.bytes(4, p.concat(string(5, '2.2.9.22'), string(6, '2.2.9.22'), p.integer(12, 90), p.integer(13, 0))), string(100, this.stock ? '' : 'EVENCFW/18 img640 fbguard wearnotify cleanup11')); + const payload = p.concat(p.integer(1, message.command), p.integer(2, overrides.magic ?? message.magic), body); + const data = hex(p.concat(...p.frameMessage(payload, overrides.sid ?? message.sid, 0, 12))); + // The right/master link also carries ACKs for image writes to L. + this.emit({ kind: 'notification', identifier: overrides.identifier ?? 'R', characteristic: p.G2_NOTIFY, data }); + } + async write(id, characteristic, frame) { + assert.equal(characteristic, p.G2_WRITE); assert.ok(frame.length <= 185); + for (const message of this.receiver.receive(id, frame)) { + this.sent.push({ id, message }); + if (!message.magic) continue; + if (this.hold) this.held.push({ id, message }); + else queueMicrotask(() => this.ack(id, message)); + } + } +} +const addresses = { right: 'AA:BB:CC:DD:EE:01', left: 'AA:BB:CC:DD:EE:02', ring: '' }; +async function until(predicate) { + for (let i = 0; i < 100; i++) { if (predicate()) return; await new Promise(resolve => setTimeout(resolve, 5)); } + assert.fail('Timed out waiting for test state'); +} +function harness(t, transport = new FakeTransport()) { + const states = [], input = []; + const session = new GlassesSession(transport, deflate, state => states.push(state), event => input.push(event)); + t.after(async () => { transport.hold = false; await session.stop(); }); + return { transport, session, states, input }; +} +test('session authenticates both arms, checks firmware and sends acknowledged display data to L', async t => { + const h = harness(t); await h.session.start({ ...addresses, ring: 'AA:BB:CC:DD:EE:03' }); + assert.equal(h.session.state.phase, 'connected'); assert.equal(h.session.state.ring, true); + assert.equal(h.session.state.battery, 90); + assert.deepEqual(h.transport.sent.filter(s => s.message.sid === 128).map(s => s.id).sort(), ['L', 'R']); + h.session.setFrame(new Uint8Array(640 * 480)); await until(() => h.session.state.frames === 1); + const image = h.transport.sent.find(s => s.message.sid === 224 && s.message.command === 3); + assert.equal(image.id, 'L'); + const fragment = p.readBytes(image.message.payload, 5), payload = p.readBytes(fragment, 8); + assert.equal(payload[0], 6); assert.ok(inflate(payload.slice(1)).length > 0); + await h.session.stop(); + assert.equal(h.session.state.phase, 'disconnected'); + assert.ok(h.transport.sent.some(s => s.message.command === 3 && p.readBytes(p.readBytes(s.message.payload, 5), 8)[0] === 11)); +}); +test('stock firmware is rejected before framebuffer/layout/image commands', async t => { + const transport = new FakeTransport(); transport.stock = true; + const h = harness(t, transport); await h.session.start(addresses); + assert.equal(h.session.state.phase, 'error'); assert.match(h.session.state.status, /modified firmware/); + assert.ok(!transport.sent.some(s => s.message.sid === p.SID.hub)); +}); +test('disconnect cancels in-flight authentication and ignores late acknowledgements', async t => { + const h = harness(t); h.transport.hold = true; + const start = h.session.start(addresses); await until(() => h.transport.held.length === 2); + await h.session.stop(); + for (const held of h.transport.held) h.transport.ack(held.id, held.message); + await start; + assert.equal(h.session.state.phase, 'disconnected'); + assert.ok(!h.states.some(s => s.phase === 'connected')); + assert.equal(h.transport.sent.length, 2); +}); +test('wrong peer, service or magic cannot satisfy a pending request; timeout rejects it', async t => { + const h = harness(t); await h.session.start(addresses); h.transport.hold = true; + const request = h.session.request('right', p.SID.hub, p.heartbeat, 'test heartbeat', 30); + const rejected = assert.rejects(request, /not acknowledged/); + await until(() => h.transport.held.length > 0); + const held = h.transport.held[0]; + h.transport.ack(held.id, held.message, { identifier: 'stranger' }); + h.transport.ack(held.id, held.message, { sid: 9 }); + h.transport.ack(held.id, held.message, { magic: held.message.magic + 1 }); + await rejected; +}); diff --git a/tests/tsconfig.json b/tests/tsconfig.json index 0bf5d080..8d1b49d9 100644 --- a/tests/tsconfig.json +++ b/tests/tsconfig.json @@ -11,6 +11,9 @@ "outDir": "../.test-build" }, "include": [ + "../app/g2/ble-protocol.ts", + "../app/g2/ios-peripheral-identity.ts", + "../app/g2/glasses-session.ts", "../app/graphics/surface-compositor.ts", "../app/phone-ui/phone-gestures.ts", "../app/g2/glasses-hardware-identity.ts", From 00a5e38f7594e5b77d65e7463f1a70e5f9157227 Mon Sep 17 00:00:00 2001 From: James Babcock Date: Sun, 6 Sep 2026 00:21:28 -0700 Subject: [PATCH 04/99] iOS connection fixes --- app/g2/glasses-session.ts | 80 +++++++++++++++++++++++++++++-------- app/native/ios-bluetooth.ts | 17 ++++++-- tests/ios-ble.test.cjs | 30 +++++++++++++- 3 files changed, 105 insertions(+), 22 deletions(-) diff --git a/app/g2/glasses-session.ts b/app/g2/glasses-session.ts index 8f7a67ae..26c9418d 100644 --- a/app/g2/glasses-session.ts +++ b/app/g2/glasses-session.ts @@ -35,6 +35,9 @@ export class GlassesSession { private sequence = 0x40 private timer: number | null = null private retryTimer: number | null = null + private ringRetryTimer: number | null = null + private ringRetryCount = 0 + private ringConnecting = false private retryCount = 0 private wanted = false private addresses: SessionAddresses | null = null @@ -47,6 +50,7 @@ export class GlassesSession { private charging = false private layoutCreated = false private off: () => void + private stopping: Promise | null = null constructor(private readonly transport: SessionTransport, private readonly deflate: (data: Uint8Array) => Uint8Array, private readonly onState: (state: SessionState) => void, @@ -105,24 +109,52 @@ export class GlassesSession { this.displayed = null; this.retryCount = 0 this.update('connected', 'Glasses connected') this.schedule() - if (addresses.ring && ids.ring) { - try { - const ring = await this.transport.connect(ids.ring); this.check(generation) - const notifications = protocol.RING_NOTIFY.filter(uuid => ring.characteristics.includes(uuid)) - if (!notifications.length) throw new Error('No R1 gesture notifications found') - for (const uuid of notifications) await this.transport.subscribe(ids.ring, uuid) - this.check(generation); this.state.ring = true; this.update('connected', 'Glasses and ring connected') - } catch (error) { - if (generation !== this.generation) return - this.transport.disconnect(ids.ring) - this.update('connected', `Glasses connected; ring unavailable: ${this.message(error)}`) - } - } else if (addresses.ring) this.update('connected', 'Glasses connected; configured ring was not found') + if (addresses.ring && ids.ring) await this.connectRing(generation) + else if (addresses.ring) this.update('connected', 'Glasses connected; configured ring was not found') } catch (error) { if (generation !== this.generation) return - this.fail(error, retry) + this.fail(error, retry || error instanceof AckTimeout) } } + private async connectRing(generation: number): Promise { + if (this.ringConnecting || generation !== this.generation || this.state.phase !== 'connected' || !this.ids.ring) return + this.ringConnecting = true + const identifier = this.ids.ring + try { + const ring = await this.transport.connect(identifier); this.check(generation) + this.log(`R1 services discovered: ${ring.characteristics.join(', ')}`) + const notifications = protocol.RING_NOTIFY.filter(uuid => ring.characteristics.includes(uuid)) + if (!notifications.length) throw new Error('No R1 gesture notifications found') + let subscribed = 0 + for (const uuid of notifications) { + this.log(`Subscribing R1 ${uuid}`) + try { await this.transport.subscribe(identifier, uuid); this.check(generation); subscribed++; this.log(`R1 subscribed ${uuid}`) } + catch (error) { this.check(generation); this.log(`R1 channel unavailable ${uuid}: ${this.message(error)}`) } + } + if (!subscribed) throw new Error('Neither R1 notification channel could be subscribed') + this.check(generation); this.state.ring = true; this.ringRetryCount = 0 + this.update('connected', 'Glasses and ring connected') + } catch (error) { + if (generation !== this.generation) return + this.state.ring = false + this.transport.disconnect(identifier) + this.update('connected', `Glasses connected; ring unavailable: ${this.message(error)}`) + } finally { + if (generation === this.generation) { + this.ringConnecting = false + if (!this.state.ring) this.scheduleRingRetry() + } + } + } + private scheduleRingRetry(): void { + if (!this.wanted || this.state.phase !== 'connected' || !this.ids.ring || this.ringConnecting || this.ringRetryTimer !== null || this.ringRetryCount >= 5) return + const generation = this.generation, delay = Math.min(30_000, 2000 * 2 ** this.ringRetryCount++) + this.log(`Retrying ring in ${delay / 1000}s`) + this.ringRetryTimer = setTimeout(() => { + this.ringRetryTimer = null + if (generation === this.generation) void this.connectRing(generation) + }, delay) + } private check(generation: number): void { if (generation !== this.generation) throw new Error('Connection cancelled') } private nextMagic(): number { for (let i = 0; i < 156; i++) { @@ -134,6 +166,7 @@ export class GlassesSession { private request(role: string, sid: number, build: (magic: number) => Uint8Array, label: string, timeout = 3500, flag = 0x20, fixedMagic?: number): Promise { const magic = fixedMagic ?? this.nextMagic(), payload = build(magic), key = `${sid}:${magic}` + this.log(`TX ${label} ${role} sid=${sid.toString(16)} magic=${magic}`) const generation = this.generation return new Promise((resolve, reject) => { const pending: PendingAck = { resolve, reject, timer: null, command: protocol.readInteger(payload, 1, -1), label } @@ -169,7 +202,10 @@ export class GlassesSession { if (event.kind === 'disconnected') { if (event.identifier === this.ids.ring) { this.state.ring = false - if (this.state.phase === 'connected') this.update('connected', 'Glasses connected; ring disconnected') + if (this.state.phase === 'connected') { + this.update('connected', `Glasses connected; ring disconnected${event.message ? ': ' + event.message : ''}`) + this.scheduleRingRetry() + } } else if (['connected', 'connecting'].includes(this.state.phase)) this.fail(new Error(event.message || 'Glasses disconnected'), true) return } @@ -178,10 +214,13 @@ export class GlassesSession { const data = hexToBytes(event.data) if (event.identifier === this.ids.ring) { if (!protocol.RING_NOTIFY.includes(event.characteristic ?? '')) return - const input = protocol.decodeRingInput(data); if (input) this.onInput(input); return + const input = protocol.decodeRingInput(data) + if (input) { this.log(`Direct R1 gesture ${input.eventType}`); this.onInput(input) } + return } if (event.characteristic !== protocol.G2_NOTIFY) return for (const message of this.receiver.receive(event.identifier!, data)) { + this.log(`RX ${event.identifier === this.ids.left ? 'L' : 'R'} sid=${message.sid.toString(16)} flag=${message.flag.toString(16)} cmd=${message.command} magic=${message.magic}`) if (![1, 6].includes(message.flag)) { // A master arm can relay the other arm's ACK; magic is allocated // across BOTH links, matching Android's communicator. @@ -259,6 +298,8 @@ export class GlassesSession { ++this.generation if (this.timer !== null) clearTimeout(this.timer) if (this.retryTimer !== null) clearTimeout(this.retryTimer) + if (this.ringRetryTimer !== null) clearTimeout(this.ringRetryTimer) + this.ringRetryTimer = null; this.ringConnecting = false; this.ringRetryCount = 0 this.timer = this.retryTimer = null; this.pumping = false const pending = [...this.pending.values()]; this.pending.clear() for (const request of pending) { if (request.timer) clearTimeout(request.timer); request.reject(new Error('Connection ended')) } @@ -277,7 +318,12 @@ export class GlassesSession { this.retryTimer = setTimeout(() => { this.retryTimer = null; if (this.wanted && this.addresses) void this.start(this.addresses, true) }, delay) } else { this.wanted = false; this.update('error', message) } } - async stop(): Promise { + stop(): Promise { + if (this.stopping) return this.stopping + this.stopping = this.stopInternal().finally(() => { this.stopping = null }) + return this.stopping + } + private async stopInternal(): Promise { this.wanted = false const cleanup = this.layoutCreated && this.state.phase === 'connected' this.update('disconnecting', 'Disconnecting…'); this.reset() diff --git a/app/native/ios-bluetooth.ts b/app/native/ios-bluetooth.ts index fab13d6b..38d6686f 100644 --- a/app/native/ios-bluetooth.ts +++ b/app/native/ios-bluetooth.ts @@ -18,6 +18,7 @@ export class IosBluetooth { readonly devices = new Map() private requestId = 0 private scanTimer: ReturnType | null = null + private scanGeneration = 0 state = 0 scanning = false constructor() { @@ -72,19 +73,25 @@ export class IosBluetooth { }) } async startScan(durationMs = 12_000): Promise { + this.stopScan() + const generation = this.scanGeneration await this.ensureReady() - this.stopScan(); this.scanning = true; this.native.scan(true) + if (generation !== this.scanGeneration) throw new Error('Bluetooth scan cancelled') + this.scanning = true; this.native.scan(true) this.scanTimer = setTimeout(() => this.stopScan(), durationMs) this.emit({ kind: 'scan-started' }) } stopScan(): void { + ++this.scanGeneration if (this.scanTimer) clearTimeout(this.scanTimer) this.scanTimer = null; this.native.scan(false) const wasScanning = this.scanning; this.scanning = false if (wasScanning) this.emit({ kind: 'scan-stopped' }) } async resolveDevices(addresses: { left: string; right: string; ring: string }): Promise> { + const generation = this.scanGeneration await this.ensureReady() + if (generation !== this.scanGeneration) throw new Error('Bluetooth connection cancelled') const result: Record = {} for (const role of ['left', 'right', 'ring'] as const) { const address = addresses[role] @@ -116,11 +123,11 @@ export class IosBluetooth { }) return result } - private operation(identifier: string, call: (id: number) => void, timeoutMs = 10_000): Promise { + private operation(identifier: string, call: (id: number) => void, timeoutMs = 10_000, disconnectOnTimeout = true): Promise { const id = ++this.requestId return new Promise((resolve, reject) => { const timer = setTimeout(() => { - this.pending.delete(id); this.native.disconnect(identifier) + this.pending.delete(id); if (disconnectOnTimeout) this.native.disconnect(identifier) reject(new Error('Bluetooth operation timed out. Wake the device and try connecting again.')) }, timeoutMs) this.pending.set(id, { resolve, reject, timer }) @@ -129,7 +136,9 @@ export class IosBluetooth { } connect(identifier: string): Promise { return this.operation(identifier, id => this.native.connectRequestId(identifier, id), 20_000) } async subscribe(identifier: string, characteristic: string): Promise { - await this.operation(identifier, id => this.native.subscribeCharacteristicRequestId(identifier, characteristic, id)) + // R1 exposes two notification channels; one may never complete its CCCD + // request. Keep the link alive so the other channel can still be tried. + await this.operation(identifier, id => this.native.subscribeCharacteristicRequestId(identifier, characteristic, id), 30_000, false) } async write(identifier: string, characteristic: string, bytes: Uint8Array): Promise { const copy = new Uint8Array(bytes) diff --git a/tests/ios-ble.test.cjs b/tests/ios-ble.test.cjs index 07c186d6..22645eb0 100644 --- a/tests/ios-ble.test.cjs +++ b/tests/ios-ble.test.cjs @@ -102,7 +102,8 @@ class FakeTransport { let body = new Uint8Array(); if (message.sid === p.SID.auth) body = p.bytes(3, new Uint8Array()); if (message.sid === p.SID.settings) body = p.concat(p.bytes(4, p.concat(string(5, '2.2.9.22'), string(6, '2.2.9.22'), p.integer(12, 90), p.integer(13, 0))), string(100, this.stock ? '' : 'EVENCFW/18 img640 fbguard wearnotify cleanup11')); - const payload = p.concat(p.integer(1, message.command), p.integer(2, overrides.magic ?? message.magic), body); + const responseCommand = message.sid === p.SID.launch ? 1 : message.sid === p.SID.hub && message.command === 0 ? 1 : message.sid === p.SID.hub && message.command === 3 ? 4 : message.command; + const payload = p.concat(p.integer(1, responseCommand), p.integer(2, overrides.magic ?? message.magic), body); const data = hex(p.concat(...p.frameMessage(payload, overrides.sid ?? message.sid, 0, 12))); // The right/master link also carries ACKs for image writes to L. this.emit({ kind: 'notification', identifier: overrides.identifier ?? 'R', characteristic: p.G2_NOTIFY, data }); @@ -148,6 +149,18 @@ test('stock firmware is rejected before framebuffer/layout/image commands', asyn assert.equal(h.session.state.phase, 'error'); assert.match(h.session.state.status, /modified firmware/); assert.ok(!transport.sent.some(s => s.message.sid === p.SID.hub)); }); +test('one unavailable R1 notification channel does not discard the usable channel', async t => { + const transport = new FakeTransport(); + const subscribe = transport.subscribe.bind(transport); + transport.subscribe = async (id, uuid) => { + if (uuid === p.RING_NOTIFY[0]) throw new Error('CCCD timed out'); + return subscribe(id, uuid); + }; + const h = harness(t, transport); await h.session.start({ ...addresses, ring: 'AA:BB:CC:DD:EE:03' }); + assert.equal(h.session.state.ring, true); + assert.ok(transport.subscriptions.some(([id, uuid]) => id === 'ring' && uuid === p.RING_NOTIFY[1])); + assert.ok(!transport.closed.includes('ring')); +}); test('disconnect cancels in-flight authentication and ignores late acknowledgements', async t => { const h = harness(t); h.transport.hold = true; const start = h.session.start(addresses); await until(() => h.transport.held.length === 2); @@ -169,3 +182,18 @@ test('wrong peer, service or magic cannot satisfy a pending request; timeout rej h.transport.ack(held.id, held.message, { magic: held.message.magic + 1 }); await rejected; }); + +test('ring disconnect retries independently and stop cancels further retries', async t => { + const h = harness(t); await h.session.start({ ...addresses, ring: 'AA:BB:CC:DD:EE:03' }); + const armMessages = h.transport.sent.length; + h.transport.emit({ kind: 'disconnected', identifier: 'ring', message: 'Link lost' }); + assert.equal(h.session.state.phase, 'connected'); assert.equal(h.session.state.ring, false); + assert.notEqual(h.session.ringRetryTimer, null); + await new Promise(resolve => setTimeout(resolve, 2100)); + assert.equal(h.session.state.ring, true); + assert.equal(h.transport.sent.length, armMessages); + assert.equal(h.transport.subscriptions.filter(([id]) => id === 'ring').length, 4); + h.transport.emit({ kind: 'disconnected', identifier: 'ring' }); + await h.session.stop(); + assert.equal(h.session.ringRetryTimer, null); +}); From e5ba7abc1876dc5f4fe1de59129e1aff6186c180 Mon Sep 17 00:00:00 2001 From: James Babcock Date: Mon, 7 Sep 2026 10:18:30 -0700 Subject: [PATCH 05/99] iOS porting: Battery indicators, app icon, add the rest of the apps --- .../AppIcon.appiconset/AppIcon.png | Bin 0 -> 1333021 bytes .../AppIcon.appiconset/Contents.json | 1 + .../iOS/Assets.xcassets/Contents.json | 1 + App_Resources/iOS/Info.plist | 4 + App_Resources/iOS/build.xcconfig | 2 + App_Resources/iOS/src/FaceclawSocket.h | 8 ++ App_Resources/iOS/src/FaceclawSocket.m | 75 ++++++++++ App_Resources/iOS/src/module.modulemap | 1 + app/apps/developer/developer-app.ts | 12 ++ app/apps/files/file-browser.ts | 4 +- app/apps/files/files-app.ts | 3 +- app/apps/ios-availability.ts | 15 ++ app/g2/glasses-session.ts | 8 +- app/g2/ios-preview-controller.ts | 136 ++++++++++++------ app/native/active-display.ios.ts | 8 ++ app/native/alarms.ts | 1 + app/native/file-access.ios.ts | 51 +++++++ app/native/g2mirror-client.ts | 16 ++- app/native/phone-battery.ts | 9 ++ app/native/settings-store.ios.ts | 42 +++++- app/native/socket.ios.ts | 16 +++ app/native/socket.ts | 9 ++ app/phone-ui/main-page.ios.ts | 7 + app/ui/dashboard/settings-menus.ts | 14 +- app/ui/font-picker.ts | 5 +- app/ui/shell/worker-window.ts | 20 ++- tests/app-layout.test.cjs | 3 + tests/ios-app-host.test.cjs | 56 ++++++++ tests/ios-ble.test.cjs | 1 + tests/ios-socket-native.cjs | 15 ++ tests/native/ios-socket-test.m | 23 +++ 31 files changed, 501 insertions(+), 65 deletions(-) create mode 100644 App_Resources/iOS/Assets.xcassets/AppIcon.appiconset/AppIcon.png create mode 100644 App_Resources/iOS/Assets.xcassets/AppIcon.appiconset/Contents.json create mode 100644 App_Resources/iOS/Assets.xcassets/Contents.json create mode 100644 App_Resources/iOS/src/FaceclawSocket.h create mode 100644 App_Resources/iOS/src/FaceclawSocket.m create mode 100644 app/apps/ios-availability.ts create mode 100644 app/native/active-display.ios.ts create mode 100644 app/native/file-access.ios.ts create mode 100644 app/native/socket.ios.ts create mode 100644 app/native/socket.ts create mode 100644 tests/ios-app-host.test.cjs create mode 100644 tests/ios-socket-native.cjs create mode 100644 tests/native/ios-socket-test.m diff --git a/App_Resources/iOS/Assets.xcassets/AppIcon.appiconset/AppIcon.png b/App_Resources/iOS/Assets.xcassets/AppIcon.appiconset/AppIcon.png new file mode 100644 index 0000000000000000000000000000000000000000..42d0c7b732d4b56b095acf2ec4f022358d1f198b GIT binary patch literal 1333021 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¬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�b35 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

`=5fHl(0x zna)Kd*FNBSh)IOR(tk;LwZkHY1>|!L-8u>)$;FbJ63lU)pZ&r2J@$<^SHJe+`O%~| zWP0B5f`cGgrX5Nqb%wcMPgq4jglA9Vo6;9dn>a0-y7Y{TuKNWs(@gAcf;SD*Ft94K z%TD_e@no+JP@r%0$sadWjFrn@A*|AB&IhZ~iY1-gcrXUGFW80t7SPTrf-(4x0d^fW zxHedgDiMB5ubgvYdw~&7A`q-Nmzjp(y3S=dElxz+CDd$vBpmHmpkGB~8uJM)00|9_ zNw6K@>FC4_WwO|CQc(c5IGrz*L?j)9Nl;mGgp zYb#aF;xkB}pvQn7QSegCr)O|S4%*7X2v(W$%5ClCMESmK{zBu*=Xd$obs+Zb13DhG zO_T>AqcaYHqLc2V5%mz(@TO;Lo&k2sME zor;(gb^^p9C=Le@!d@bsKGKk|IQ)8+_9Y9m^GjI-gjHCYE3~jBW^ziTR8NE}*c(87$gpw~_7ZId?V}vMTw&ExPzsjA)tDWs0)J|`aet1YunkZ3S1KAP~ zS+D|9hHwm70D!1+bd-{CNFtcz>{avSymUP$qH*q^?sprPtbxPfI|5fTAYQq zvI(oZc*w_Sxk%!3GAkGp0Lakq;D-!3s2S?Ara;-G#Q_S8<(1_u<~yQ z2#PCGegaO?U#4L&Q3TdUgAKF5387$gIhm-S)C}4c6%9@_G&Cuyev|YDg10`S3$(Zf(}$4Dst3%D!=#GINS6|eaUxw&6HY=Zo}oy)8jCdISQyd6 zHJwFdE+OJKg(D!c=`)H962id36dGBUsv%V()wux3U2vwvQc0O6Weo-$VKlP>8O z4tCL*|HSt`@{z&n?D?0GZ+Sf%x^9Qp&N7v_TF&P~?%)$X6K1;^PQ>c?@nj=gaBzL~ zPKnoYM0Li=Kp**;sAI7Z(RqaG5qq%=!PD(_$h&btR4RCLtAJHT?!3q@pKEpv zQ4=0CxSFv!H!-M2;DOyaj{uI4PV4ZvBWtTEBNRTp9PEL^R;2VY87EPKk1-g?j3?s> zuQF)QP9W1EqX<_5U@zj+(P(*cv003~$-rD=&rn8lG5O4#B8Trja}0pUIAm|nVGI_b zGTg~Dk3!-Uta0KV$mVOWeCm@=^JL+_`uq#uKke=NLISteK`2KP#7pXh7iVw*@n*|{ z?<<_IX^$M_R^4lBEl{6o7yzdZuQ(042b(ST1SYF3w*~gM?cS!DFcs}=y1_c)8sgE5 z_}*Ul_)VmVL%5{G;SF+K@+YjQOpGrtKwl9}R^fC~T)5)@ku^WfABZp=Hiya~iIv2Dv6 zt7hBwa^cD!$6&|+9<^j!^D&t8;0CVrrwYH*2vQ6fSR(`?D_|ZTZ-+b$!c*Yf$zl6f zrlr+Ra7M3G2I9@;TjJ>Z`~83S((2*wnEa&=9Uh;YFHbhS27q?NXnEim)j@zgWP&J$ zj0W)DNOYQBHByQK_U|^eR8G%rJsD#${Km00%y4K}PazBW@K`95n?-%xc5_7^zNL)# zypPHx?C%X&)(;%(e8tC9E>;Tr>m1omJ320%Dyd_n+)s`6Bsms^(WP#B#>9f-Pg)T&;z%-DM{*Fvv>OdCIuper%U@Gk zz0(?6n#>nDg_HZYktaF|ZV8a`@C7OdlmHMVbxWQE`GysU1~a8XId-%_B<-rW z-qO@3Q!lK^<;g%^>PMp^|E95MDCzH%1(TyrOA7Z94<|L+iFWg=Oj@d773b!&a}~>! z+HZ;@T_+-ZX!%@})YyMmM;U=Rq$+s}z4TQkg@7^KNnsGRlhAsjzu>~cAIWNb5^>%D z zitiB_p{QdhdJ=TGiisE!@LS5sOO9HIfb}$^2`+yUggatZODq{=Tg>8nSz#+dGc^Sc zD~3AS)yH0PR1(?B-cbmCt?h!rPgil23t@>D+{g*(lGp+fK(x;a9de{==P7%>1j#>N zS+ELgYa~>Z(JP7)k>3#xP7&_-%cjGSozS3QGFN=SnCIV^{@>sJv3EQ+c;jBrX)~_0 z!I1-7<`Mh4R?1G!H5m2;l=He@!v*|=r6*bR01UyviiS%`szdK8d6FM(NxZuB!?a8vg56{JK<41su~@Q^o>&c?65 z_Sb*<$(OF@pZnr#e{k#`hY<8RVq0Lt%qm?wjIpM-PFV15GiZ1t7|I>wB1$I4j-8Mh zU2P{;w%w9mOD+-ToSlLas`A9axZNK1+hZs+&6L&F+%L)Ftp?8|SWe@$Nv14uA{r#N z!sp0z7aX&#U1DY&0}KSlxTNtqu+mRB53MFnV|LOzT%!mj;c2rVyhO(A~)lg_B4YeL|sA5&t1jV>tCgo>6O zv7wvV(Y;}jHbxO4KBgdxh(9e=gRplcRRlUK`_C3FPhy;26T!P5QJDx&XC+VCaiToM zGF0X}OthB6V**!h`!JSRH|$|^JY>TkANc^%KsOba!I?3m#zDdLmY4pnru~2Y`gU+M z`it*BeE8~W{$NG)pR24@X;+0hEK~y?Nwt?%?!=uIV?M8d$tUS4Drq z7G>+xYlh$mtk_f!Qo@r>L3u2g8bmCtjg=9YI~Xf&HsS#q9m_h9z@f1YEd#$NRAetz zMh-SjUe(4Owef0p{qX$FKly=o{@U+6zh1ArlVk(6bLPMo`1K+GFJ>&&KoF11hUxt|dc=*U7<39jH&oUAb$Sb5t{&yyh&T`^U4}%I{ zr6XAZ))8ckboLtfb@CNBDa)Lh@Rt<+rVTlfSLh5r_HgaS2DJ+b&QGt~S^hq2?zDTPu<3G=>UVjMXn zJJ&bONmf@8ULsRD@KNtbLJBEupAwOcLdI$JGS^!~fXl2X4EjXxER zSYj5h(Bmt8gdGs#)!2rxyeq_N;cF#!I{L#Ay-Y?DC>CA))QAD|Zi$cQ?|b{555MK$ z{ zcmPP0vngc1e2}dRbKN+I@q=Ll(FkjQnagGBj^G9&JjE!YEr_aj{*_BM>)Gk?cv|mj zxt&gjPd&6^cJO+}-aZ6hYa)SLM-becUhv2OYYiMlU{Gcj8FCy=))#JoI2b!0xw%*{ zCC-3kP2`1qGe#*kzV(7_OnFxj;uDm)>wlbyI@3*D0)lIJx4=go^6(j%5XUp62jl$I%#bN^RS;&_Te zzV~l9Pb94k5uTulXpZrpl!3P`D1L4Z06-dCsvRs(xxB4y9 z<`biTkPyZxXC)>jHKewJ?e+EspE=u}j)s5dLq`uUE@rQ^UZ53E(yNN-!jkDPzG5FT?>PMM(kr|EH>P^WE<1=fQoOn z&wcHK-~HalA3pl#+4=C+5gn7Zpa;@@<4@(V)-V-o7T-Fc^^J|Z;+x}7d;pyiK=%8N_@y9=T4fLmaTz*oD19Sw>?H!v8u#N&qpKa2=sDxX3k2dXQAjvcI2 ztHQ&@1|}r9!ihqkm}kJqkX{Z-2p zG_63G%sNvsgrf(Flu<~YlFUIOQ2Z)nX(WIku>@BoNh*u-NnbI*?`#uoBcXEK9A*n@ zW-2Ku=p?f|H==|Sg(XoCs2Y&!st}Sz1{he!n%brlphQoM8Qa0r{tD!7AI9kQphT) z0@)+)Ix~uqC2%pbk|~L_6q4_%j+EMikS%!&{M!9kSv#~UP7$&~h9pXHNX2h{O1lt> zk<%2T2o426u<%Ry;RYlWJ3mrTdycLzke;L>F-)LfvML~)mB77av>VWg_)1Hu`QJ4I zp>btUJYWTYQTkC`bQ5hESy3DBEm?k!?Pq6 z;W;1v?QQ~KqI@ah#XXcih1kkDehrjTNk@JaFXBC}jGM#J`j3ClTgMltSFF3Gv9rWx zu^O}cAb}SFDL2|RAA?)Q2EGe`C+Fb7jeA|wz5FyXfuJ`8*eaA5g4ufLaD!e`QdPMy zy8^}scAd<_az>5_f%HV^1`1C5k;fb!oEU)+D>JEhz$PfbSi4w?%eI#XhbFAZ=OUp= zoHR!28Ltp#@IW-%wnuvd)(fF0gBDij&u6ZDh<$y4m_g2L-rx7N00>A##@L0S2oL^3 zg!Rh=su&Ei1X8v~BM3GiG9E%&MgoKBw8v&Aw9VPfEjcw1qBvlo@^MU^YPp^q99+MA z`RL*K-}zJT`pf_Li(h^7{Cje@#7H`^EDu;zRf1%lS@W*^#xg7mA@XKnPeOJ?M^XND z43mCB#Zbd;2c^+BL1%3lw0(WGeSzSTogx_t^x0FgCCa?D*=U!{DD!e-mP65BF7SW<^pOPY88SA!_W$C3WrtzEFcE89`QcD z2ri?Op?tDo>hx+3bNtt|#{DLXkxm5-MS^jh-OEG#9$|t6jBZA|B418Y)_me3AqQz) zEXm*kMs&`C6hNS7kZw02BFjw9*6nNa?Mv6q`5ZTqKAXg{YM)tetc7Z6Tg-RI&rnz{ zkV1;EfD(~jHVLJ1;Jd!=ZM~WH+aovnba@yXN#P*0Vp<8gE5Zi4I6+;Hga`^XJSY?kviuL5Ly9|rBNDAb~Tmh;)}dz%MmRMp@% zvH6ybfCju3dD!b?H98cW)h$7J8rXe%8RKqvpEsg&uYfm#O(%oB(e^N2;=*@$qHV!bHsA zQG^a=aFk;w=@%mbfFt}(UJ^>7xDt!MhoIK5WhFb~_E;yp!b0G}7bf}e2o1mMN|fGR zgCt*h^)pR`G0nyX`QDur?*yC`)E1W_EEUfE*G@TsriO^25r;g@stxoT?(e8xaRf|( zLqU5Ze8tmaKX=&QCK*Lmm_*8d5i!WX$!;4+Ln3oRoN<|$=E}A zYF?lzG2Q}059lnTXkq0Sd{wDjFNAF@n)_Sg1UwiaT9xFvKsWha<&ib8CMXCX?Z0&2 zarG>WN=juY8iL1A(#){MD%DzHLoyi9H6PH_ck=v79>nxFPB{u(_>l8loMfjw)`1lL zQb}PQBaI$&qXJoWr9lYGaERhoTC7PQ0R_8qbrCh4us9U(mr}YGjiPihmY}Jau9(cC z0~x@y8x~ftSb$&XDx!y$LI^YYlZmCJMotV4Vkk{wSSC8u9En0XL>0h_szIUzqXOkv zkweJ~P&Nt$M=f+?;jq=F6j~~PD0&p!BRF&{B+ zPWO7N<>Fm$Ir`}1$EUyh#l_`<3+{5Y-~pH1*5_40 z!zH_fGYH{rrss%)EG%(mu3_n`Kv9mDi4nCB;lP6Te_dR;vk>nvs%qgPZY^2uPAKvI zAuP)RtM++{@rC(L`By@S20uitymd#8W%Pkr}a`QLu)h1KSnKF^P) z?oiv>ByKT6gM8Bbcpm_JF*kg{YW_GM_O%}4NQi)z>7>X@mFJWkEvX}H$CwH`u{@o~ zb+dhWy&WtZPTcJ`-!W((8nj2PcNiF5K@Dw)xOmr?%TBT=sJGg1*M~NMr^1V>Q0DXi z@XO?mW+0JTk}s-I&hUwv)6tk_&4n`!QPVN0j{Imqt?~y`<4l*JqncUK$o2tKZy3ZN zd14G1p```N{v_muQ^`V$rPyX=CY7B~Teoz+n^NWD;axYGBzDEcU?#tGBcY~?LXI@x zP71p^pKW>WFWVOv%}Y%A&)C)znVZA5x!pDggWOcfm`3MyaH@n{KyfMlypj_6x>-MM z(e8$|Gms?-t2xVR*yjg2#QhDs_h@aGZE!OI6G1RzfHZ77C|0a-cj`A+z5j5z{`nt1 z_`zHA#W%0UY#KzZU`A*06$LrKqYe9zy-RVN{&!5Fg=!W*Yw&3NjCH60-zI<&FcbF| zs5ec(_1CWKke7D%Srbn{EM@+vRA>BIdPnqaA83e=qtIOta%0!)b^pLcIK=VNcQqhu zd)%c5qAfSy*q!U4hiG&>Kj1E2lJ0L$&fCef_t1B29=yp8KfUQ*@Ai}@X1HU}pWqC` zjVprKQT2+aBAUZnJfz!PU$ty4$~c_odYQ9dEqe#Nkb9;PscVG99Na*dT{AGiJ_t^C zq!J#E?RjE>N6C;GxmZfXqr+IrU3;%q+(jHbb$fAfHhAsTPki_X{_Vg2(&>CQo$|yF zZ9r3DG8_y-kOf_elGQ@=b(lJNl%~Xv+N%jx(Gi?$3%sawojPHWh|k-|oIOdVexvz> zCrj#L6oN&WK%lIvAlsd}5Miibf*xLK_ykk{q*|%wG!TF#Ky?bP%SAQv(lYo31r19b z1@!<@kxkfylOZ7pE0!HOYEqzHd}R!%1#F8BrO8IcD2^!j3a%01q_5Y@=*B7#QZ{Wu zN(a?59UKat(z+`pQ{369n*bq9lm!m`YzSrS^rlK7eu(gsi;Y%HbdL19?Nb#+0c18AxGL6vnXSk$rAE21amk(MsXLOxNJgvIq`6-pmS>s6(0 zzzPIcD1sdzhOlQy?dw6nlM{-Nfe56{QwB6J?S%kh_QfeGbCXp)gtaJCOd_h10FU=T z!(78fhx5v8h9a0YRR?Hda-edMI@S{Q%HlJG94M2;%1hQn!Pcr2ML`awtC1BqY+*BPYi1!0!O9BDU)Wp)^Am0XH zez7l0QWl~7DNl}9Mo(oi-U0zbl{ztV(u!C9owloH`lHP|B}&`zf(`|xPQGoTAxjB= z#XxyI+1X8<1S)Fy5N6bf0SILndFXY30Z*A2`m_l#b-SD@LBWGz(z-A1&;(3%3es!} z17|bn5c~;Z%7qrp4vYG|p&byv@MAp>tnkVUt0O-2B2?&_!PS3JgcyE0*b0?n-LmJj022WT#A_c zr7SNwqRLb}vnkX4gXOa?{gL-P@zS4o*Wdq_Upnq>9&Oqywno)x)Tf?97zPV`&t5}& zxE>iNV35Ikf*m2)PB2yK*DG}S63q26&iLa5bUJ<_Z~m|uD1?|i3`v7vznc5o_SNO~ zOKcC?Y!7v14h=Y9is(gW$qyL`XYEerd2wjB){wI&9XM(S;3J;q`9+I6-*AWg8?$=3B=j zZi~ZZ79ceFQsKl8pjirQFyJe?CZ*DLHldxv!vM}|Lk{f2SgQhe21^&4_5lm}m(KLR zINQFmY96c=14n1Bd9T;pWm_KB_xqrQv&PCy-9;+ohF}a&tr1M6Y9k)a5l0}xOx1L2 ziVy&g<9%J!1qQ}GYN-(l5kq~eUQy;?(0;u)_?7$XKmUg&f94&V#q-yL4Y$~Q(3Nqa zHx7uWVMj-uCu><02i3OwWxBYX&vw1@Jl6@{QS) zbA5h^^xR3HtucA7v3Rs5Rl}_YTm)^sQgP`XF(p4@?<}7LfDdyCiw(`0$}q5IZ4wU! zJan|YnD4=={+)S$CK?DO9Y3@ zH%|K8VLU!wpPe#U$?b?0yMJD1A1oi9V9>eVX0v~so+r!czT6Ios08Pv74U$QcSJB) zzxU*0%X@FO=Vt?6TgDiPuE=NBd2F#q=)Zb!I(+!yt5;w8>5skd{qKI_7r$_Cx_8T1 z84G*mwHc(YF`;R)JuKFW_GzB%@(m1d7g=`!_pT^%nVY69O;I8455FmrY8b{ND$kaw z1WuRG*;*su>e6y{J|z;8WoZry6ezvLPGrzzW-iPn>0v)#1E`Qj(k)I}xhpxAS<&E+3sl;zWHY73Rsdc~KNY|zz1ckrT;GA-)4 zr{?enrd=ggGPC%SUm_HoJrq23u<#JG>J@zQIssJz=}MPK3Qb7eFar|II!^)T@{ws* z^`yMohkbNX^XOwqBnFz2Z#y`Vi>9OpbfqZ+UotbKk+MAXam|9fbicspPzoe1*#TlD z)i39js^W;89Lc3HzY^dNy&+hB3WDxk6g7tzE?_#5i`7x6nYiSA*ZttNdDc`;SBY2yRRBLRS5q*pB04X#pR1-SvOADZ z@uH{fta@z)X|8O9;4ESw$R;Mq)VMY$s2>f7Q)c59tILI(06I^@8-n^Q+f`;F#3489 zo8|0s{Ls;w9r@3$M{M-LKHy9s5k}`)&_Ck!rR&w3=S<1Fbf@o|1PDjGz{A3b($|Ec zYkxv0yIjp??X5jx3kEE#I@V}R|3ZRQ3h;r2do0tE^}q?|7t!1$+&blE;q9RR-EZrOVBn?%oZ_6}+u?l<4Xoq?ebA5Z%Y z%SyQUgU=xi+(S+8Q6Rk!i%3(er{ORxiX#{nD;qqN5Os12XatVmAe;^f7`Sk;-O=X& z&ADDGW%NaImrn3amJKRxGA)?05(zH;8N};>h{lI|SI+i&IHrRXz?DPmwmG6c@9JX3 z3cK~Mx4ca4&1J(h|C_7rSyub7NCX@LLdIQ(y=K4NvOY@H5`a);46z{P>!)C1q=F8) z*hEdPIyO^Ugma!60q$($gGaMrC{82UKFf!kX=g+v5eVW|bPp=R_*X35kYAp^WslKO z|Nnk-^`WPSfA*d2`qk?J&*u&qu*VUIx-^3RVqc9LQyVm1r}Y`8a-(4|x_i92f3oGV zT4O339k8?rM#a=L?oA%%vsQ8MJjlLcr_K?BY9NOU>|o(gpQS!b?VBb)Z{`-D&w?D+ zRq`k_&kr&6&g4CMLi?dZA8Nrqj1{K`%qj57Eq8f28iV3Kyeu2MbIhCe=sh-9*Dm>k z3-3T%%^LOqb-C4Ib1~bpX76}^a5&kXU$n=^{iCC1cFqfcGu}RLt}gVXIdAY_9UxZZ z4FZfe*uxa#_BU+Es+&+v=~s0Kw$XJs6t~mEbTB$CM*eIB+zdA7Z?=!#-Ckc!9=!Mi z?|kdO`~1t!M6k+{RZ{q^b!&4-ZR>;aR(#$JzvFV!*GWVBk*n zt2%=i{!(932(0~&N70jjt*-kmd4g8KhEqsT03Sf9;TuSrIFC#<2!9EZDnaB7-(bX@ zJd;Jypg8;@2T<0mj8)Sb!lwt6YiycR0FwGwiH zh?vxy7x zq!7T4oBUj0g%0;9CN(8cepL=}GszW_T>Cd;L=8eN;=spwKHzui%ROX)PDsXeQt{1| z{!V|>wy!XmT3$Lx3QSD}YHX159r@@Psibbj zc#Qyq8iod^{Fzd=Acd{OL|Z4 zp>ik*qJ{0wqCr(O4B|yaz6u+{Kq40trSL6WMNuFQO-GU+v*>6;I(k^csbKOD4KObu z3R%WhE>7~Da80L|mnL?MVHYBoX~ts1WdomLWS9emAK=*@#XnF7AFw?x=_It^@K#}S=~a!E|uE{Y%0!< z_(tR^p+9i2XAS`xYX%6pxhi2^R^;=vpB*2a8Zi-5b<^=?vE7_q8gPJG)0r@_r)>v! z4hW`}CzoWjdwa}5IAHy`p|0wxi0EoTs12izME)^qF*ZT=~uQz9Hr@Ic(YE=*B?h{B zRVvqJ$Q-|{a27663LM{vi*^#k(G>w)suxIfBw^UeZm_w0qoyeNv*Rc&6jW2>Odn5h ztGVQv_M}p_Y2^vM(w*TNPGs24IOocDa{1v6%I9r!Z{FOy=H1EvKUHrMYwMcccYUj0 zYwx}G-lxB9U6-%RWyjbqgDFRjVxuUsfQB+7(gq|9KD5tB?a$UKpd7%@SR zAV7fx3@*EDSE|Xqb?ct~oZYRybQ79|Co`+r29{=4wn!5fB$y|)9b}z(eDpN z3^3g#hPz_4>}|^IKBAci{IQe+RaU(i2CSdGrehDVUZTOXYsex&ZrSMs63^xof|KX~ zVN&+#tv4R&!ITua(+QH2(CiHXNO}((@Mu)AG!mW%Gm>E`CnH*cSv?oTHB<$^bY*)U8`H@CO0L21O)dk9RvpbJYpR426= ziJfB4pJUw)?+Qd7;yo~}199~!lO2cK)t)yYPEMC!e*IUz@xebn+rM1iO-@eIQM0J( z4p_wuOC_vDbyEKkGE6lz9=UCC(Qyr8Ujfw1yLw+QrFH$77*0~2+FU3!DyKYKqNwu!mn*PU?_ze?Wa(KKn=&Q z>0&u22u`IGpEA%<#ZV+$ii1K4Y&kK?FM?!BB-C=sLCMY+4?v);`~_C7(ji5yVj!dF z(olBm1OG>@wylk1QV_}lNd|}!1k_Zd;($0IA~j{>OD=7qAth4?bI~kGYLp@tYnWQ4 z8loTzSJJ6t#N$^<%z{$A{6SiBO_Cb4Tw|5+F^fYDss(9u>rEolzcPaeDTt;}pO$0* zTZUp615jcXrBm5hJHCoG5_HpmB7mt(nvWbyIVVP6FGY{Gs6HOBf=ODemK%~`RmqB1 zDa8@!RJnl{N}|$85cbk2NeO7;v_OFHR8}yfM5qp!1u=CrQ5pomn8r-uzmdTEpfrgi z0+WHC_+o8$NA=BF(s(iuCyZW1hCVb~!s$>*IL0AaO^`g<(gI5f`6Q%bl>srjRMJm{ zUeT74`Rz|+QhA^*PFO@?m|Pb{%?c6{3JC~RV~bpJiWxQ_fGQPHLoJMx*yf07 zQKyL6_5`6dL(LM4uYef0BsF}b8;h!ZOwuyb+lnP3m_&RKtU3t?JHqg!KLDg43Mw}v zW6lJ1e6jKeVZaHNmSvMMDI$8(z>;=6M9>&LQivfxlljv#h|0f|K%&Cb zU+@HZ{|ubd}A;-_w&r3-HuM5344g-eLVm(Y3HzPv-Lf}n3-$Mx%kJU z0t4<0K`LrY4-P`%jyvw%vP@d%jO#%V1{<*llwHW{1LF<4S&uHrE5;1IFO(}j)RsNX zc6hwUk^XysIR5CthC9?5HgL3ncb0J}P=L7}l(|f56=bk?MkXj&2EA_c@gE}{CK0z> zm(G6-u_pA{TKhv&#wRccKPjLkFyNY z!Xl||Z~&W7pZI7eSmR7&E%`@Rl0FvkcnjSY#3DwR7E9bJ>fn=ARMpiOVle{15}=nv zm;qX5#I3vRpE>pG6e=Hj!*qpin&v5YBH^ZDHk_5_v@82nPCE@-u2>>q4-Bt^q8EG8 zJB)B(w|-J*A_j##SXSU}yRqy7%-ZWR+!<@UUs+u5w7*nhq0-1H9r@Gtg0>8v;N{^{A- ze$9O~D<|IQvfC)*?Bsg7g6#g`4jd%NNSi%2zP*BuFS2tgfb2j?C1&Wt7)P-g>v~om zQ!{2D)wPJ6;bElhTv=`iU9o@0rM47UcIdJHi1jf~8{?zw{y#i^*!}dg&WmS<7cU?? zxPM93?&jO>{qsJ<`?vGmvsaj>dvT_Lcy$8P|M~%kgELk~sB8xU=J5K)w}`uXrp39O zh$7Qy87cxVUpw--!tw5fs=5<|8~llL0Eoi6`1b@LRpm zMpANV(Wr*xXu47+5s``=KLl_Y<%K!p_(VxTkT9mQ7mo~(De=+(k0O*0kCH~hAd3Sw z`3PM;c6I8vNJ9!4BXk<=vW7HTn^56|mr@~uQrO^!n`JCyj0aE()=lPVaYw3Z=>bbi z0vY&ABytf@!ia^yAzzu0=p;qn76m{X`{=Haa*???XL-d8g7cRYg7sA2)?*oHLq=Y< z3zbEr+q?x=k&bF8KlNLcVeI5&gQ}(akA*cJA5o(Vb_i>r)ES!iiR8^uhlQnZn23@J zDW)%xR7mkc&L6^bj4Rh{%j%Sv17hTC z;gb(XY>BW&D*4vfLK!QQa3WiBs0qDy?B)xSSm7t8iPxuQc`ab7CQFSIgtZMIcO5ITM>d|0v~PEhWJ4R z>Ra_A(j2d%Y(mx#56=pc- zy?93q){2ZY$@`Lorxeyo3?^Ttj+E8393}0Q38fd@kj+QMw4jU3AA<5t*nkj53s_xq z469;C4#(n8423UvtthcZ%fx&Sir>XmDPS#zrIwHuIa*jD0SLWfO!(;V64j*q$q`7c z*D4DMJ12TrF;aec0bin*obXGQ;1Uqfu@yLq<|iU0#+2}pO*mHBs|wM?*oYr_sJ&xV zJ~9mxg@hTiu!H_;yZ`*O_m@7rT)cV4Yj7B?`AR0H*^%6gKwjJcI8vtlVu5O2yfYeZ7hDt0DnGd0{dm;BJf}17)uEgmK({l65zYVr zKmbWZK~yoa!}!P#NdGgl->JNHacu??hb52I-77lczb=@oSgM8?s4_s z;cmhE4jBJnUAk%XY^wXtHXX%g?i72nW5Ejs4+GvC;E_RZCS}T>O%{}Jx{CIkxG9B= zRX4Y&$ZN&yoFNs-8z)Z(r)TRg@4ox3{(t?S{o3FAC;#uX+1~GUS*3s{HjIgESNIUa zKQl2oN-9}M_a31Y|7k;|hB;jcE)G;JgE#ASo1uRWJo^SWhq$ka)3W18D zfH{E4lDcoM!Y+K9TT=H*7)Eg;u0P6Kb@|TFg^{dd0Oq?9$rTBZ?5X3n3?Vqgj@G9!Vo;$5m<*N4cFe_8dv^XH5-_~& zYv`nahRBG{u@fKa;VStmkptXzOb>^XUh|WE=YPLG{Da@0{N;Pi>T8_tgoO(Bn6ZDR zd&VU>u*_yNvV%o6ERH^$zsHL#2=ONO%V#3og@QPw<6mdBp46&S95j*4(^}rd6x)M z%vb%f_qK5@fu|n0Wr#QX4h9@l;z&{s9B)|YW9wk&`VMLh*8osUa03`aarOeSiO7Q> zj;dS|(%u#)E9hJRibY)6U||F6qf{5fezRC~7IW*V!|wNgNLSU_;MxSCWf zTx2;m(pEZo+ra3GL}5riDaY6lU?`xGzm{*o#cb1z;bZ2Ib4AIb3w;4IcsC^N091Lk zHz_Y`FX2d)@_R8sB`O&&CjsT2<}O7NPbhlC(xVH7qEP}PR9s2&cnhtH5lB@;Diz$2 z<||6r)QF%&rlho&Y?00wst4t4B~hxNXaaQes$XL&5;~TZ`o0cQKQ+r9euVK>X1NX|;3>NBHPp^0WY)1s-LD0N}`fT15jut z8%5hG8_^Y3%%J+DV0ln1!=?#qgDS5;Krbo6OCaiK%mBx#5mR$TIQgo9q{Y#01o*;0 zkuLO1lvjXSP@W=(biyZEODplFwt`2OR-{NCc0UK8wG>22s6Sg9@}Oa*L$cpydC+`J z?|>dqm}rzZeJO^V5f5%sPNl|gsRnLTR%-zwsPGC7HAMtA>wQH<0Z7pVf(XE$Rtls~ zfE+ffUw_j5)lqkLJ%c6FZ(Dj59PkCm>cmSG*xpA?DH+t|F8@qsTMM|}%S_ywHv}^h zP(pekxD5A(rj-PTUz3!;J`|g9xbu&#$!^N0h~QfE^#QP!kq3Y7A?6eTyAGC1?(S?R z;{yi@-Gju$KR0zSTZ$mM_kO_K|CzqT>OUPf1jE!D-@sH|<1PF9xh9awMS73Owqj-D zZhJH1jKg*YC{w51-E2(Nn&F>>jYkBL^seu5Vx2z(TIM` zt-8w5_u~JPv;JhTe))Wua)gPX-(!^l`$C#oRi+C$sz5ISSvR~<;bisWtH1WGCx7)f z9{%%x_4Icqlpz~mb10dNewf3c6^dJQB$e!>rgM)HXA#`DLr*4;*qKM(wNC%FVG7)R zCUkOAD;_3IbIQzpzu`Sg?(FY3=flqV&=|%5NIY-`KNwe4BAu6s zQFa6=p#J0pxxHbwv-73|`pWdnz0U`EFbS_O09ROI_(m6Vp8zol7&x#cB>4&26uy1eaAP=BMdldloeNivVUwLpP6nq^}Pb;K8B@ zk~1bjA$-dL8S1ie22&S(@E{8?V7AVzR2&-ay}Vv>PfRo0Hn+>>&296H-RVpyA9xcp z%QC)K0RafGK@rxceTRzNXUl2{T#&?xe}2%>5rX+kuE7!arMTI>AQ^VFBmy>zQSX1b zJ^Z^L4gTQ6&h9xK(^Gci>=z2wIh#=4sFstF5bW+pyyt>pBIo8MgX!>CzI7p|y6p{P z1k|jySrP~*`!HH&a}P4 z-n`*rQi?~9NqUA5tOT8oSp?`XfJaV-4MX4N+u4p7U2~$BU4MwgRzTMf#zV?cv)t_# z3+o5muIaB|-1hHHyO&ewY+hY=77POh?DDrLEx2oF)TLUux#2_+=u`sz>1g+s*I;0J zFAnq6zPj!xeJn(%3*(~dAz4AHs7I32li_SGMe>CTeGc<5baxNm%a@(gGuAYI_nVKo z5^1qs4Y6?CQ3La5*m_m#Sx6}{F`7jEg$Xnh6asg^_3=cL!|WY0}B=}N04C@n~Z9RAC>93^X? z3p;|AhOMlD7D?-pqL|LOOHBz=1E5aSFXI5iN7-6d{zNI@P2fj45z_BOrY%8iK^2|^ zY5L0}y2if2jEcp)g*4jq61>oisK}Nhr2J1bnbQidK7~u|BqPYWNjS-&dW2AZ#UN6k z2qyjaVUN{m=FmHWmXDPxBITd??nm5^3UM_~lt0qR7qK$c9}Iw^DfrO}N>dszM!?!M zwct5`!@=|c!L*%(B~gO&4GnTpqIR2Fh=k>UL+gs9+X8?Z(TWBU<$q?qqLcul6dm~5 zVDKsBu_n*Zs!6L>1c_A1M>q)~3G%{B`YLa3no+4{th7lWwi2wofI5DH;)8`x!@-mv zP$hyO{%Q-qR9?@M7T*X;W1%5p-;mOEgBvge4Ko2C(5ftkO!5V<7@{?a^izGs3WVvR zl@YBi6x6INQIw&wLJ<|r=?uDMN){=Mi<~W(0z@rTs462v6zy1gmqAS|9Tky3rN_!5 zYtQHrsYz{2nN*ahLup55po_1Z0f_*Ck(?D0KN%{f-F z%)+_rz-dNx*m}g!!7067c1+h9V)yjN2yug0hoQx6gZ}hEB<6kpJtryoWz!K|R|XMG zL!t^jJH%(nd%pC&LcF+l%?6v1S+n0@I_Lgb4@X4b*ww6FzTtUzadBXu1m3DY&@Htm z%lm`DL1?-o-Q|jNguLT(FdlkgIUNrBI^7-{o94^yH9Pnf*x%HIGKkgK>80@Jd$h`lPQvaH~C;l@p}~fP|)#)3WuMp*@tzRq_`~=!on#y?6qd zuJg(m1DiicLbU{()lRvf+}(0wuSc>o(YJ`o zBocNoXMps}zAhiSzbIu_9=)iZiPFHC|4wH|dnzD{Kn?e}LfJ7xh5^KIPL&2mOG5%- zg9{BF;DvKToIa!r8hkTw;vKz=phgBplV&(-IEOMm(d@70ybPH4f_0wWG=KD?!xt~O zzVg5z;q_w2x#0_X_imx#GzEpjEI=5xZ)sMnhppUhqih(89w?P8Lh80m`!RqSb-%ZA z8`9tY_0eF)#g&8ph+TUYJW7zRVoODSdBfFyIOsim#2oqI^_xz+mPNI|iFS^fTSdC+ zVaa8UD|_=ET=v*8|MWSNyY!$Y_aG0tNsqqilK8?xz32lkL-&yVozqzx0d9vc9?- zF!Z22Q09@AB7d`KIKs<%ki%xL5@P*=wZ;xd0I<^O3ANXb3xCj?WsyblY;@Y0ut{gt z<$w>XR8&EXqR>$v=ypy9+Zk6BG0WgEkz$6~9hT>Q0xiyJ850rfwXX|^W4lq3}f2*RnO5+`6WM{?uZ|kH(@xlSclRz$tgbe zFNv}-v#^t9yy?0)0U{D_TJ-Z5*nG@sX{Li}D-zy-AvsNEh!X`Jlmg6RMyj;@Ksuy? zScHg_uY^?!GKl4HBTN%nfQrVWe4q}7E_Z}NsZuWpw(swF#sHF44q{t60_eHW2(KcZ z)HrImX(nx`MKp^u8Wan)rBPG>ggFwHd~{I(VIWo+P|9d{4Fyv^0T5YRl+>8T^Kt$EO_1_?zQp`l<^7hZ%&GF2%BDnZB~J=2<;RM`a2>Jn%Z^MFN)Dap3csxJ{F2!zrJn|uJX$QOgMS|kn@A_At|3JD3Y zA_9+yiv47tRMP|xB*_&9MiJmwU*TH342ELK2LP1$2rM*|_;5RdtP>0srQs2&Vw(iW z55Yn9@Aw0lQ1NOK`K@%#rc(O1w&sU#U~O1SJ%7Vg=><}ru#~3aS*Wx*PT+KSu<=Hd z6b1}2l}W(RQG*RcM>RnS^;Iy&Hd$DUT8%9B`A%tXGS?0`)6;l&p?s(_7xP)d~8#AC&x6UOO4 zMVk;K4kMzV<|iascv!3Q3oiO5qMZQ|9ATUdvx)~q6onQl;^!x}tf*MeAb+um)mE|5 zCWx*O;v#0u)FS(1G!2+GiH_kA5scx#YDz`&9APU@MQvb!y8WNqwd(7<54;Hy}--^{yg#o6div0`fWxr)5+{BbK$xu z7UK3mSgdgX_YEg^U_^E}eMkq&d}oe&-C@T(VnPm*Ud(4zu7&8ALrD4eyrt_fJlW1y z^mFL18{-TuGnMWX0^BP;m|WyP`}k;hLVbT%x z0qLDj_H0m5LW{7$4cmKwGR&&)RbA#%a8rb&ms6p&Vl%Pnc9(uLpy{;?3f>e_{Av{@y45 z&42%+j~XYBX@D?;$9yg131bF|3%)?l<KSJO zh8#e6bx0-(96IU3N{6hh{8e6I;^L}coe%&!CwYvWT2iE8GXSa$(L1SUbZcNkD5-)S zNf8DZHPJ=HJXY9ZD#3gQ!0vu})qpuw?R7PvXHCFzW)aF_zC6VR9>=D$p4VRCYfxY- z&4_DvMjg7QgQ1;xZV%ma7Gl(V`|)AKOQKE>9geW_9*ec-j99hA;bu9ySqC80_q4;G|?6dSOVA^9IlNoj<$V{jGmz^qui; zenSahLY+LYHe%qN9l*&m4VFo&yBRa?RALq_EJN9${$m%C-D1?Uvz;w2Fz6j-i><3? z6sZ25lfn$M-D=Jd-Aai$cm@?>j0YRe)nI&Pod%=Bad zH*hofhZm)lbGy7wd%sxk-rlh&(Y<%h+lP5+aKBdk7%(wtx&Ltc^eLxt$S23c(^D3J zU_mh?Td4#n@0-^%i1GUag$3yaz3S#^6 z&GhrlU-<0d_rCu6a5xvv0h%tV-Q%cfo%JT%5o#$YdMy8REX-8ElriT6^-=LDGT7D3 z0)+2MO3QfcK|l_`(Y(5k5(k3M6Sdw~16RS~6V~2vl|{ zBxGYTVZ+(UYH`~ScqA!IgbGcf{K&^|g{9JNV|@rQr6yERKo$VNZ9h>sLHG}ja2o$z zWHIJD1w|DCjhN;^D7PG?EM`2xl=e^Ebcc|SW0+>?D?aL5ABnbM!6OhlsJEqA#$jPz z`w*4Q5d`9m7zv9NRfVJ_+L|xi0V*w|Bz?YwDRPROlGxTAJ|%)csn!xy5?w9E zGbNN16>_$<{3A+orbTX2E%xQdVI-CT0Q`j>5jqHDTT?{?^$KOVgHrio?ZHFENlA?p z5ekwEO@X3hn~m>eAVFHtAw?M?Mp%T5rHS~|pCn0-#JG#7s)fPONWU_yf=myX3!o{q z9E25*e|&pTG!dpdLm*Us!YjZ;6iUQyO<7>XhgO*sk>sjqAu6I=!p%rw(e9YVKv9b& zYl5IkCi2fOA6luUpbXGpa(eyogVE=s&iv{IVos}*c-Y$^b}Y)*mYyIpgBqT0GmWnO zQ8z9l9i3ag&32f?X_&%iYMj?~(M#%|onZ!BQ!4lj*c@3&2M!0O@qA@(`tf9v=g&A> zuvprMX5N+AP3{z;;kQEtl6R0ZN6H;R)Q_HGgo-Jyadm$)o$*8N8>O*< zjrZORm(Q;L(_cCJpT0N!zkhJ`?{SQoSa8_Bk8%u!I_!pM?zqHg>n;(pWO~wk{D}Vj z;qj#T=ELUG^A2~3I=jy-JEI=%x0xL{@#uf{=#!ao6e?);;u}sk!kkYHgzQwyc7Wpz z0Pr8vP&ORv&?#ag5ZP+!6M{Q&=-lDt#78yT27M5NX4b!445gu*mxvhVE8|X`L6cMWZMtELjn&Xq#t6clo0}jm>5&rBm=gEbl=&`LH8Y(#%Wo$ z;jjj{L;{H%kfSexp>Sr0Yz_cC6v0k%e2t79FiIrA3ulM)25}h|2RM}qB%MVXVqTx! ztefs_)92p&lji=UdHhS=-~0~Sr_8ze;_&kB@a$Rh?B(Hm-|zh4A9tRAefaVjcSjxA zDfCgN^Mw0A2V67C_8~n=70?5N54+#H+x^PD!GHV_r%Ee%7aUZPvQp)OtV&3eyGR-*xB2EuIVp=_Gv44lU-1waU1UjO5v zd_ruFIT>#0z5~X}0Hv6FaJgR#N9Rxt8vt>3Zs){z9F`BcW4C*H!nl0+>BD9)*}c7C zY|uIVZ2cBbo%f#H=LpfB_j$QlikEp&sF2zGV5~oQaKRS*?cIL+YSzD)bT23CH!tbF z4<3B5Ka4j2_DeVFvC)XDIfs)zTasSCLWkjlQ>wAu+uQ2tP#!6myjH9~lM@$YzIPlZbRZy(RKH%f0!>%X4l{O=-xkTeqvh?_r-zj z&*_%$y*43q&^7tfyL9!0O|u#GL#9}YP?-84zkd0rX%!5oBsE2i*w9OnNencNAtFT! zyd$jnmo7IDxMxsg7}l;slFINt156{6#8)x*iQJ69V)F?f1Nj837|Z(jXb6QIGf=8H zPC{8Ps|ZAzZlo>LD8(OFEDgdW_%a|4>k1z{)g;zVankrwJGCGfvSvn@6!jLZG(-I& z8rH#(oW&w=CML;@;!l|>s(zE6ua;NTfMZ*;y@#?+ndKLu0- z#q_R?HW-pXplr-$AwenOlV>QR9c*9tCY}#!ldPGr*3o5Ri44GH1V|>`+d*1&V_F{w z6`fRhLQ@{LMe-%cFQIn4T3{qt@R1`5`3pl^iAV>wW8MfYS!GKNVybwFBcS4DR-RSC z9C9!g!$?46Vw6L2F=*6p=i@QEo@I7QEtE7E#Z$1bAd-k=zV-nqBl22dS7Lc06mT>d zmB}F&f{1YZ1-B8F zg)(P+eT5Kn-SkeFL}WiR;|)5~yflDb7#)3p$U@s)Y~w+K!(@Uq^ncmLfLi^F6WZ)O z7mUz~4~O)Gb~j5$4D9rU-PWN3G`+2VJLq3BBw!%I_9JY{c~57f00Z3(4{{CNk{P$kYzJIs^r)2<-P`%D9#bEb^GoRMPy>Sq+inxIp!M96y+BAHhH# zfC86Xg>QXuyr7F)F;!9ITTd3=6qCyvvQsEnUAO(j(VWYt?{0scT=LihJv_Gz)oKk6 zW!0r7j6%89CaGql9sNF?a_)xW7%>M1+{Z=Fm>Ff0s7DDfW{?i?XbK(t41MfLv+mSe zy>^7bMZ1IX?vs=KC!Za<-|qY;f3-W?bzjb#=TG;4{wKXZ`(fwnA8x+-!Qt)OrnfoV zYZ~6ue6Qc(crgNhz4p?l|KjuB2fWgH$%Zw2&)qCAA(O1){D)6jJ=vC#q(xfOC^4G> zC{Pp{R;9Ep23A(;C9cZBscE4o$lmKuHoFvnz3@*}1+F*YDj^oW+>OKWVt4TS76VuJ z>@M3+Wj%#6#H^L{H;Y~W;U#kKp1oE`Ud}z3V4@8-?fSY8T8R<&`ZIDGe0<6-quq;Z zuJY_mFAi&7u)M_cJcE1Zi^lr*E*3xfvNOLu`L$o!TyyfAT}j*F{fEmhpDpJ<9e?&Q z2k%*w;^hP!=x_FuhTVW1UEq4+yA{R50XltpN-jqh7OUQfef@*Y?VL9R#vA$aUBwv9 zsVj%>Yzkrr6?$=e9RtY_^(j|eKfp@?agyG%umAlg(+TfD-)$X0+NSZ*hs^|izFbwe z)*r0+%q8grs{E|NHd3jn!Qn%$R9UpF;LrGyD3zqQ8w;^Ej$AYpD45y7q12kSw!|fv z0x20Z{FMeEJ^^4C072BT70)J4Kt2YN%=3FeR8~F1i*F=^SSpL7=m-U>m51UbY)JW} z3snQSEeL)BpSTDbAX%hHhJH%TND_gyj<$rAIg?s7inX{UdUB*So%BjLFkhGXY!c(X=+clz3r1C$?MigVj&{F1Ckg*ACfXRp&M*?4jLt4a^M=&6pNd(-T zGDN|bk(rqf0_0cOAgtMnTFZ)lj=fFfa$z+e(lwa5ArRycfVAXnffy}WF@zyV$TH)v z0yrZ^Y+_=hD6inEB2>wULlNLRx)*ZNN=$7EfMoMU4+mjFmGaQKS4`O&RkOud{FDfy zCTEaTUd28{QBcZJueH5;$qP6?nH?tr^Vq&=C!hR{;*#MpUXEID2(AI^crBpyim08b zLU?DimAd(9+z940CiFXW?96pgrIY=6jcq|=~60L#>l=25sM?=m~ z5MIJ@so?5W#A*S-NKy|$(h-50sY*-$*^-=e;DVw4z{@uu{QFoPSg4GPagJG%UU{U* zcwX`(rQUNw+Y}@ZFIgUQ9}SaDvLZ21;YU!`N@ivx6VMi(ibSd=j&C3?QBVhHhUki_@?Y;-+Z(jhK2!Jw(2C8y&Ob5W`;?a^|B=zl=V0&vh0JeGcuEyfI_Ld7`* ziw@!&$pqrZ^mXR54gFO60^Q|eaWd-DxNg~N48tfy4|aIQZ5!Rq?TqcdbT{04kTH!t z0dk7{)OJC zb_ey&PPpxe{Xd?Bo{U);=ui60{Zk8i$`CV>!rdkqiiHAAXigGoKC)>+^3 zgoN#8<@*6hK!ua({Kf1yKR^G^|I)*M_&+?ofg?Nkr_HZ_(EQrBnqU29^9vt0A6zu- zBVWxiXS13$w{)fEScM6GZ;oLCnOzbrl%!Y9B`Z$+<7L{t-Nz9(YyHP+3O6GMl7Vp? z2dPd9>l`T;JnA3$t}su96%WGE{BI75qH{V_u#{P{;{Wm^%`(xtwU*EvM{h((To}rT zN+khUNEWz-iw>l%hZYr+PadV2N<|oBlIS;(e795hcKR8A`CYw#_U$AfSvv0EO5YAW zD3IbCvYb;TSA)Wt7N(^=xk^XeqaBPBk&0?8EbJb$pamA0iTpq|M{#*F*gtvF`K@nuca!mab9(!H{j;wRKltIK zuU3b@@mc@7_nPG$hsoKWqs<)c;dtaT0bfjET};_WDXSlpBjD*8L^P31q(Is1F?hft zjM>;Cb9QQXpF&7y7Fe#loU?O}HWw%0VD)IX+V@#(Vpz*rUUt-Q;SWyC%Yb>22SWmn z#j~kz;QMpgP{qOKI}ZNR-5+duw=R{z<^9g|l(ml?FWkTYtCer@!(&`AVCj!bj(7<& z2X&TQx8(Fc+uC+Jb_sH&&t}yO?-SSC-cclZU&n+)IFQ`Fz8gNizk2a{_tn?DRgl;G z9#%V+D|s&%iz(Fa=7@LlQW7PIxhQsQz>^4r@VF4UVGRQ>1}dnJ^h1>8U1J+J3$=A6 zs+v{Ujzc~TXPsFRxO(%^Hy%AW9elM|kESPEhBQolSktAM#`**?HyIx1M^&B?+fssO zrXa@8t&MftcyF5u3aIvsO--H^9UdWVGREWEuv%10mr)%4rU zg`)6a$*BcI62o#3lOG;iWCJ`&gfCsJeN6dOEe1*a6iFEXBk}|A9)bs2U)7pFgg_=2?b<2WPMN)WsAT>g<8Q?q^WS12+7jT5|W(& z{z|-`OA1v)jjVh{a2Nq@j)q@xE_AFHb0~v;M#D2o+$wHoglm;DTC_^bjMlQ{+v^`>pNQc z!KlAp%vbZpxX-(OJf-Q}JGHh7HJtX_a2+19n(u7FWu}w_n^^h;oDY@-?JjeWbUSLx z5RYCluBL!8#Yj%cKg}5~L!mp+1958F&HZ#lI_#}>R+Rw*8-TsJf5*NSc#e9!mxo^X zcDWv&HiPq1ZU@2+?Edwp&NY{R^ZwCI|6s!2Vs8{#?!aZb zvoksCJ$|@n&j90ui+j7#xbxb3gt!A#-=OO;9dB;tO|x{z!n(&%NIQldPQB81=4Huj z80c(o=4_Jo;4^Ri(MQs~*2Lh8^d68NlEL=*X<4IZ6O?Qp)%2 zulANwyfTj|NjhrE4qbm=OOQ)EQ#l|3xE=@1{V3E)DgM0c)J7a%B!DAe6Q~(v?1mH; z0G(16A&yg~pyEB~W=pO^ z)N3&j3IFGy3$c9;;+G+5vss#PD_wRzA%k!jpu3~6ef)`Ze)dd)WU1Sv`u(W`m;Hi{ z{-8U(=slY3uCCb$PaJP8_T0R$<7E;Zr_J;~mkZewp`^JKh}F6S2Htnp36CCfxzO&_ zHNE-XXw;leSnnc!H$Ls$zehngiDALxQw9cyS8v&|)4M#QnDI*Q!+10pv$3ZcJig!{ z&+hqk_d&z!$|EW+vm4zzr^nx&40%m3BUcs`_HS>!1(>WPo1CKW9@yNk*WqNI0U+R2 zp-d}aF0+hldcA+loZ})dR9-VIr+}k|y9c?piBgPJ$#*OA`KmV@?`F5GzkT-T^rv62 z6_S>nxB8je@z6LR4;Cx`nL|m$>UyV@ut}CoWBlSDwMjBGar!@afSDWug2&&juAxek zB&9f3%R=%B$v24>cw(TWzm_Y=HQc0WPDxrU(}9(RPqHpSsFB-YxnRQOQ_?7A%C~~H zl!JgTSTKxK65BT;sy2`i{_AQnRZe>Cl8yudnp0q^puZ7F>B1s30}YfFlPR$fmJlWg zkRh+o+(Zdb7tx5Tn6*OS{7NW*hAKWNu1NxqEQyYOm27rcg(^Eaz_(BZsheq0Ig5C@qqRvujSY3Qpln(lDzYSr zG4yjE6Qi9nYEdKF{0kV>Ci8NXl|r%|2=$07iYiFjUms+z?gUgy^2W9DN8%!7tN=w> z)xeTsFyUf8zB>e5aAnCOj<#yCMK1v$!vkstUEzGLREXn|#3-SP2p4_?B4#<1$&m|O zk=2ABxtSdfCjxD?KzzIlCSS37DXNZp% zLQKMdNdX%}Y`4E0^}c<1y1wPrJalWfOoMTW2#ResUU8#3G=b^ca8_@<9P*>61PX?{lQBJV)UYLR+ANi(UO*7> z09H~Bf-f0|vCtJ?q9b11$_a4_Yai)=n}A(b>EZZ58ep2A5Uxa5{@s6f?4AuZa?2?ym%1p34`-|!IJM3yfLRtbV;5qP ztb%&_f#n+jQx^8~!)CT@UeW2?T}+$r{^jmp{DbE2%mzRCNBi;r$Xh2EyC|sCVq1{9 zeU1!Ja9sP+eDrlFL0FB^d;wD|v8JPSUrzyqhgIm$b4-E0_|+A8;VB1ljax6d&yzc1 z-9$g$-Y#(9;V(R9F%Ng_pPzZL=Egl|o15GI$pkg5r3YO`v;Ff4l32!1hBRypCHwd9 zZReXV@6e@7eZ~%-EYK~vLtxbV~{pxGis*u>FsBQO*?M@y%hv2q5*lhN^TI6tZ zx4W731|vo*9A9cIXR`7|r=9@}*LvZ3n9kEP8@!Me2WlthEW81UV>tSjzEVqk!x8T>Je$ux zIvep8@z8{*MNC&WYltIYiD+}#vIF7jED9?iLTuu!4Mv8Hsl4?a zdZ;=VD2f_41W?A7h!i3Owj7d*kH)vk0!js69*B$-8pT2fGYC+$l`ho=sHw0dB3=Io z%eu;`5zq)t6;Xv_%Vo1w;=ziU0Y4#vTr~}EtB*Lk+eyuM$CkfQYt!e z)Gv7=KsymB3(~Y{;aV!NnZl``ZZ3)FpJ42y(m_-;_XtINp$rQSh1fc_0kNJk(vqK9 zW^vOVsrNwDCv;A8vr-T#U`bL1?Ls791)!WtYRzjkCW4i=`Xs~DpUBeRpM2m99AHQ* z{_zv{kQ|FpP$*{ns!!V`F|193QiMeau$&}JeGqjdUh8?6GRinD@L z!l;4#VVL+(ILgOwo0<$O(PgUhlpcJ$!tSSyP^LV`*h(MEM;XN7L&&Gv2}b0*Ji=>^&@w0% zMUhMkrBDUEOpF{>4*>fCx78J#umZ|h6ig{fG>-w)l?zN`n>#WHMu?do@9d`u6gvO- zEp9%h*cBawY2&q(FuH2d1QHc2#-XCn5gc2;uT{iQs+J1Gt#ay9d>|JfbR|( zH;*Erh!NFZ3p*FMsT29>#5ua?@`@oMX~jupL15IJ(XQ{_+|W+5EZ`~D;eZ`SOk4I& zdQPsh=jZ&C9t<;r!-v!D^_;GJmnNI51J6#z56(9)-!w12>aOS8AKY|Tb9%np+n3FU z-(ZhE8yK)@r?Vo%IQiWD-~sOq*uTD}lZ3%{Z|-_rq)(rU?gNvKt7Z4$!~W&P>PJ6h zfWnbQwDvTC6DG{3dWDHwwz>a@W`H!5K`}O6u<@GX4ea2-b(pZkCfH%KpRRlBubS0; zMqggeGa70qKG@OS5y@k6l#t$l`Lh#SQ!`*m{*%RVD=bWm1whv!Fa4PB{O8FVejGnY zkw<)(tVj-~%%qHxt1=P>RKLkDXjJ=J^^njheL|FX3C)LxDqynYpU)N#JV$qh5Z~Cu zdQ-_24L3-mMVKc$=m3)EqP+X>q7zt_IT%31LQS7u>aDp4R?SoA`u6%6#G2$;Y8L=nm(QkF`l<--`o7}RC4c7FV~zdxYPI}oK6$dg`Evi}f8GDGrw}|C&V5sk>$F~Wsi8f?Z;PK9 z*~d#MP2`9JX(6TTkej@ADcY0!pt2L@Y`o*{9n#J(%sMUKbWV7cGcV0ucOFa!pM1Le z+4IdG{hPtJK5Mu}^QT|!d9Ckyp%BaUmivFs&$zO;S@j3Jf&1iSd*@YJlyMHmaP)uA zSo)T3`mmXDb#KEt74{cx-po1|;|`Y%ynW4*Q-=XI#g<|Z?2j^=yj2NH zF&?_Td&1Tut{S2UxxWj8LX+&Yf=c!Q&o54493Ot*N!FCFlO@DiDoyY|xfFavsp)E- zaANBWDF%@=7~p35Y?__?hOvB-u8%qKj^_#<0`C|ls1?Z@o456S$ngo;ed?~hdsN+qDX>{1&W5g5SNktURY0D64b6UaF0vQCBP>C4X zBS}=iH_QMel9>7!FqVMTE~SSES!mYeI*9>`*FsvCGZW~iAqKgf`bNeY2Rd;NP!u8` z>o@#Xxr!2}Xb__m!h1r&mm?rjq5e{~n9dP%tOHRafkJp7(NeLJBOyRu zo2msOVx*~w6$z6P1B<1#`BGCmY;H z>`XCAx87@x;6_f{TZvi5%q2bvn_P{yWS}?>|iuCC{=D4+mF5ioo_P zn;eF(dMVP`Eh~i7gQc9MxC{b9WF-bQ95+CNqG0={>LintA9cW{3IRb^Cxo@Ek|VOx z;>JjW!8IoZMi08(`zJs8Z|8@9)13bH08dVzo*uDFFix+TK`Bx$Pe`SP2g*buC2-Fk z7z(?3WlJ7T5=HWwupS3pxI~t?IS1m&mR|SXDWd{Tr+264c7QnXOyT+Q4>wO=bZ)L0 z6~k|{*>2Wb76rMrv>8q~6az4Ocy{x7|K6GH4<(Qye>)#=bME=M`Y~V7;mu#2&gDh- ze7ffd3!8!-T<$v~mg)LWE)N_$V4;ljLWs>RSDJ&ZHOZb4l6Cj={weYtO`dIbGdA~F zpKysVwS;d6pEHD@&cW0S4|q#Jhbv0y({EqACdlf6CM7R)WAslB;O=>|p_v07qY=sh zIb%@*!c{tr3mUT>)^!pvlgQ@z{8v7_JQ=)XTtDVG1m}~EIj8gJ6hNBo{L^JBB(`ux zh7>{=i$6tSjV4QrKmhQLhz_9vTer|jOfI6x&10NOm(mkTQDc!ExY$sYOt9poWP?wV zg9JXI2@#=z3~5sc$u*57w8NMvMG0t<5nY#6YDfTNxe2CvL>KIv-^eLN5+neahRp;l z;_;D$oefyvGUQewflNU0GV>a8D3E-TREaKD@=|$_7i7M}!bhMaFA>P$rUkF`#X2&P zTukjrfEN2hIFYKR76`x*a4Sbe!04%=7)40J@d*IJsiYWsK|SOra{6o%DSlb`MLIAr zp?uY_Y$t!oRVEnJ)QK}wor#kZyu&Amc&-;+ggf#nijs*c-}rOoC9OR%up*@uD&edf z#Ma4)=oG;8A{3aYvQo%v$6}52Bw4>gNV07(%rhZjRh|^SWDQ0jqa#%7siN8`Lqt?Y zRfzJyB&vRk8okc~5v(dlaRMioJOrX;iw>L`w1I>`Yvu%ijTkWzcxX_*L@ee;yMhSG zNUM=-R9ZR9ra;TiQpdMEQvQHMykY@-L4`w!C@|hY5(v6Q0%gy(9>Oy+7bQ%K8Hb1u zm=p02MTL|^GzcXQJdI6qL~+PuxH#q~LCdw77|w}ChqN3x+8 zf^qomd+N>&xM;!5J>H8XN~85K9P9i3+8bW;<}Zc|Z1Ul{7CSqf`eiQ={dmsd(M+@D z$P3urtG!$7d*>ti*^4(f!zT}r&TGP_6Rsr3x0&g*h(DNeg-FAy!uYiR=yLPZue!Ha zhr2soW3=V|LoWK%7wEe0n(M3P`lfgDdN;k_fBZ>*e7br0dVhU4{NNG0kDK|f&xM2Q zmA49>3^=mjJv-Ywu-v)CYgtuC?YJ}4R}C=Z$}oam2dL=v|Mapj7Yinwf7CyHIV)EQ zaqkdTpmAI72a~hzSJTBED^@1}06+jqL_t&+w->+Fn{C;U0i3;1GAiABi-QK|hwQQ| z4_D)Oq%f4D=?i`W2^zGWoM>ap9nF9C1bO<52y+47C|JXO z1GtbjM#kYTK#;_O1fH5Pmya%CsRq1d=U;kXiYq%}Or_r(b>K=A!@mGY)GKiWAs+Ca;XsFT!igH( zmbYOrwC4R743*geG}*KH{`PM3<@5gOu-9F3x&Gn$7Cz+sYQYv8?#)RB3y4wvm2(cQ_=Vb!J$$D{McM#ouF9p8j!rJrweCCd${`vZb7w7SY?$PFs zs$)Qb?M=NlpxfgW;D^nRf7U%eHNbjh1})A-WiL2yq{~{ zKjl4NtL^myA-m_SGraBbRz7Y8;0@wV(u2#cDs#b_jeu1ZyZ?EUf-RQ0!e1QM%THM9 zN`wirab`C$0b=-Oj#eJXRN)IA#3DikY(`7Gg;R-;Gdm-2 zQ3FCXfYdTER~$f7fFRF6h-(l9TB9B9q<9MK>`r}fWJ{jn3bM+_S)d|i z$!SD2Ey~#hZx-r)MunKa3S*;4Y%s;3da4wPUFPZ%3Bb|b1u7wP4g{#`W1*#t(zj`| zr=>_$q5xAJsZkpE;n^_*fGH4(PPrASHSJNvma2~#HxjUA7YtJ2lG+SiFjHjH2zsMg zX$_+JNZ}8rad!C1#(d#Jn(|SQNGuyGaO9P(POo?&Zh{d>O}vOihF6O&7P3hmQ1VFz zExHx7)KaJ<)=I8C;z>>He8@P3laL}+95}R^6_+S!MI%Xx3`_f2l2#H40B#zA;DS&* z-U}u{Ks1bUhz9p~MVS#TiA-F$mtnOqkD|#D5KAf_OL1IOYQ}2|LxRR)*0Yi%4q#rA z`wOS+vSS9$nNkZaooI86*M3P|dFW}gg@S-Q)WA7N@|!LA+db!ofwt158uaXMZ^N6j zwp+GdI|;$)nkKTxt|9hdK#vmzu-k9$X57l>OTHk&vBJ%=%WA^(3<~V)b+6Hw8TTPm z{)pr|ypV>rnF)S&FtaIOVK=Bh8S<{KEsOPBLipri_ul2^>9fO(>B*k=VzSHTbj(I% zPIL}GJ>S2%Vk`4t`j}h5_t0m5J(mNnw;U8?CJ&z&ZJB1KkI@;-ZoA7_vtM>+Z_syi z|HH$*`)(2DijX^YIrn?xorjD+`k-m1hc}!*V0SXT6YR$kNtQdfe#D*1hb5vjn@V-q z>tCGV2E0>@FBPG%VlvJyGr(ft!-j%(?zx#vrgz`J-TsB)@Potl?S_>Pr+2B`5JjY_ zQq6AikL)5_^lZ8@qzaKtH?QM1KHKi4JXE$zM?ks?jNDv6Fg^fOaq?h<*yc4^72hKl z^l|@WkrEO&qU`8*g2R{)5YpFGs0oeXqfAccS3neq*eS<5g)yC=4HeSaSCIw*aru|J zjS|dL)tAAAhFnuGieT@+XPIi05DoW~@U~wR5`j}0Gs60SkCHP=pi>oMjNe>4h{n8YawNRFvKCNC||sZ@1naOU3~f9 zy}Fonp8Rs(`FM}pIvgHNM)Ybab5cSYge>7OvH8d!naa$(hR~<8qn+g{4n8|UPXF7x z?~$(4075{$zn!v=O-jt`ckf*=Th6<^_SduR_04F)i*KK=Z`iA|MmGR_Pwx8g`p#Ru zD7B;2w$CAk-MU%Ncq=egU`re2QFB6(8#$-r{$c2yxpR(st$X*T>+9RupM3w~cfQ*_ z8Frt)VZ)D=19y+zXIl^3lXkqpgMBsq({7j70-OxG_s#vB-*~iI+7*Qm6tiYzP7yKLr?fqohix3c!&Z*-yqxj_>rW zlnM@fA!fvd6(7oo^@xNNAYx%2;E3cYNg))`T(TyX(pk{J*j7ZIXavzVMU`YB8UDhm zI(bDuB`3gP6iJT=g%yHOK*1`>B~MA2n3QQ{wDef6)Vh_{U&u!U608?mvk_~#us%~T zrE5iiLd+p-OUeK=v|q}L`lS++r5RZKsso@TFbV2AX_CVsQv#S8en6T-NCM?_PNZd0 zWJ51KEin03@l0UgUAQVm9*`mt6R5kA^If09YPlH&;*mF$DE2OJBLg_Pm(;_t#4FMQ zl4E@PN3Kbsauc6FvM?1a?5e2+!e|VY^%UGi(F9Ql;3$LW7UkO*V@WDZ2Bk+pWX`g_z`F3=pUz<&?_uHoO5M<@(~Gh8Z4-@>5&t6tU$L z1f>#&$nqz@BLW^tz!bSlh%b|b)pAj&6%50C&wuZ~xVXZhaDGJt(h*hc*sgmY?lEsb0 z5-?tzcjS&qM3SI}fiKb`z5`cIfkd^UqptFa06&(EWBV5h0ntH8EB@~=v;RTS(vgY1 zsM`4@F8|;Vx()*530$ftP!wGCXh48ZEsxgLKC~4_y)x2`?()<))(uJ#li5|aWGJsp zi{GL})34ulR(?_#i_7E-*H?r63Aa0%aNq zlg{Cz2{U9|rRm-uHpANo;dVU0JYaBO4v>E||Fq!)rt$56u}0tw3LSb#(dx66L=~w{ zP@Uc^J#6r4NYq&=mEDGeLV*}eV%nDXMnkr~a1|gM2AC%Aou5+^!cx~|hXHr{*gqKX zVo^p2-1OHSdn%KzwgO;P&hRm9*~__Mu5=j=cW>S{x3j?omy2(hHDpPF>%bXs&`XSr~Pw66{BbGo-T81CP) z6~{LTFhPq8(kEluo)f)2=0TZmL~AzpbNm-eu!R_ZkR}PGR~I zTp-AeLyQm{P$>am>&@ih+3Zh7^Y8Dbe{ix}+~{o#el(!@%a0~>zka;IE};S4DJfRt z1bN`sto8>0{ngx|AbIp6PGUubqR_Q}LsaWP=A$2o@BvvuEdw1)Asn|8t)r6;QRo|8 zsW#3$p(nhERD3xATml(Gs)CA}f&(?{U5l|Y=T9;LBT2W1hb&~P3WlUFbQ=;(Gm&JS zK?uwM;QK5Q(7*Q-BJGlq002fv1tI8tn(4CcE#u!fUvj{*oQQK+LZF4&9o}Kw-1fgt18U18y6c_xnw#Mof+ul}( zn|XiQ?<{+p*UvVu-|`+@ypmNayoalLxQqV<+if^>vpNiy+bK5_F&yAUU{i+|sT3IH zdNB@@{yp~7bA_nWi@s2dz5bl$J$dxN-tv0y9iwwzbLWx;^#B)q?cUBiEEmj{6kBcr zrTlWvo}T^Tdb@jm*PA-4Xj93X`K{ z&ME{$hTZOLw>kw*Z)6Uhf?WA+0n(Kqi{t7yX={?HCg}l0qJ@4{%?gjknv~)oO})W* zi-q|cyb4Grk%E}ra7iI)5#kncCsX;Pc)U89p41WF!UrY-=G6(~KBBvm(aF_jjmy7? z0-3NXNmypGloe;weWx;TQ6`!we2B>qWhlon1I={r zwg|II0vTT;KFL*#6*SuX9Iup7IcYq85WxD>l5CGZ!!p>ZW%MMel~sFdf>y)Gj$#@v zc8b|TSQA8y(1`sa2KiWO!8JB2^{v**FLf~fsTdaX2YRxQ9KoT`S+=eO zXD^VZfA5^0hfNFZ_k{UQ`sTge?Q;8U&Jn}j<)nG~Wp{PUq&@u>+=A}ua^F1Tjatp& zwAVS^H&gcZ)0x?^KZ1piWrtIUU;UWvz|GlxTw`!~y5%Opvnlt2Gv2_v+|UT01K`qJpw5=(T@jhKs?;y+L4m@CWs!@_rffPEq z{)PyZB)@E^0;VNjK=F?_Tahc=0t$6`1WB$wCBw}uYwp57 zne>K}9XEGfOuN&2?D9D*R`@*!XDO?=4s-BSkL;}=Fg@GcF0>tMa9rE->ekmM z+`rh*nW%RQ4h%=1e&X9XaOu&o|A-rV5ALSBU9VqVb8vsZv zs}eYd;6e%+&yWBkcqoDa2+cNklyS`$mC42V=IWMBf#&ph$O>dJGQe*W+@brAJK|hORmJ0dq@bOaL`7Ke6X0WPyrC2=vmQL za0MM;gup6gIV&8E*;+0P36qHNl_UbIQ#eVqLXnRLWHG1~vNSz0JldCtVG|K@eDNx{=x7FRrSM%t(?Ul!l+pmLY5-#3AjKlVk`7i+V}?oO6(sPiU3qFn z4xIiJ`4okenC(57VpnGIZEFRLT=>(7J{zt`j0z@?BALPm+A5#u@(H=c)RmG_LzNaX zg1gF2o_f27A0^Pr8q_BgB?h9bQ&JB2&x4-`gY^N;4pXKBAV$qzvWA-WQXboxmP{+9 z^dUl00{n(3iU^l)OlQvdQ8D!dMNNq=IFpRj=>8K^+2P6~YRDp>1OPPRJt#mX7dheb zV6jIj?ISuY$TKNxAQ%1&=yO8&kY0?0#VJHEBT`sO2Pn$3SFmYYg$$^=w8|*H>_{|F zwM==Bg(rz7fu0AIu}-vlDh?pa;({_oyV5}_A_`aF zrugXGzp|OfKj<(ifEg9}Wnz zhsF!MaeSWX7%`Pj2!iGbd~IhS+MUl9%f(YSvNArwf-T2_DRE}3Noo(i|3tIZQP$Q8iL4N)K!q^LDLYuCC}lgp&9rDjMGEoq z0JQ9_rNa?>$c~Sdk^D614kiY{b$^Tel`ZgNT%dN9dW()Rm9wv`t){u2z!$d!PU zp=bi}W z2abdD0)QRcT}B5l{kQY#5>uE{Kj=nCOZMYhoBd$G0To_%-1N>a9Ys5q9`6>s1#ihJ z7DsD5Prsl@cDfI}Y^Ry?f`QH8tk=vs`xh^ptGCRAQ#uue33n#qHwSjoU9Xy#o6gfs z!@=GMecrXTKXB(JbLqSvgU$Y&BjU~ zUlz``LCy^?cP;{SE}FZ$?vR^6`?vq{M<_S_?(Z}Y?)zRpR^=!Wi&dXjZA{PE3rJPv zp5iOOv1^7{Is_6sdZJ7eZeNH@^IYmAs%702_6kQ>PSE z*47)uOOGh2=%y*nVF8o{Lqy3-G~5G9d|E?AjD*T&(*`YKtk_#u4?jgO71MsHowdF? z1f~2{IRJw+j0`An>X3G_iw4TBhNcJ{0Dvg8W(fno4J)|Rq+-7M8}OtHQ`{;}=zvFk zq>ZhBf|L)jTWMCRS?B6GVb`XHzv72dgwUou0i`7BYPvI6g4rwt*JJ|x@c3 z!A|1yXF`nG!c*8oA~}^1U*RIEhO~N-mmI=WHWAUv8Q(&zm?D`hlQ@g)B2DC{M3@&@ zY>(5ak|ROLrtHW|u_HdQW?Z>IV3JLdUK|C=e-(;e;`t|8=q2E{)F~__e?_nnlTR5c zNKiaBK#68Iq%D70PkjRG7mQu!55BpfXHaG>jS<((r%dpuSxU$vt}4lK5+ML7N1_CD zd48ZHqmm!<#+JgF(^@;+)jS?AJ3eOK|3}rE_DGgw>3P@p@Ypjlv#P7RdJ$VQf+&y# zNd5zUBP8(868s{FAP5i`f{=*OfU|IBdb(@rtlVOc@ZB$;=RM|8#p@C7cFoRi$JT3R zS76Xk!kEx#UqwuLD%&Vjnk^4^RDp1)i7fx{0T&|RR1pf?fju`mixkC;)&{KzLZF~+ zB@L-1aDov7KwU*Y+>4h@jj%b5IHXGxFw7V5qgyyBWg|mLR(+*6ivQ>kU8@tHgye}d z1gS)M7nwM)G;&W|3PVdRa4npgE@rk{uL#Wmp;XlJZDH{7Fid^M8D%g}i~wRPWeHa8 ze6VV|s*}tjYpG9;krDxf)!!s<+oKi5L06)w=JW}I+K`(vQYdF~CF+0? zgPKQP!i9b`Bq9K~M-r_UK#OW+95d*rG+2s%Hs-xMY?fQn3VIR+@7-km40dA*e#NV; zn5VPB+w6KCq*HiUPyTWQUPF-w2%Zav9_t;p{lr(a%nug}&jKR6xk9(Yv{5AmJV#6*lr z*xkpOJwNy^(T?6ac?AVlSg=EwWTCwg;qF`4Gy@#Zq91Ar_{Ob*As zMVJcasN-IN`8H9>0xZ0sAnNoMIYxBSA|lkVq+zb0f}80WQ-$PH+)GnTCYA&> z6rXUH6!#^iya{5zB1$4YR!A|mqKBP1qPRTw*B-=L2Bo46h!;`;yh#NUI_3aXMBcm$ z0c^+WxSkU~&)$Cj@BVIbyZ!Q?9IY5Dx;MZDJFdmCWcengxPhD~O7MnFjhqqE4f>p{ zPaLIgu{4jF=HG5vhr_VBJ38w7NlyoMe!`1zhrAVFN=c(nzS@3%KU_Wx*#x^~d%RB+ z7;-b#zFYN=o9=egec1Hh)4A`ur!6b<`&Y-qDemuRwjXX6yZcFZa>5fbHncD*kkN3) zP?={kxcK(n&G_ncaD23TU`r2qyyt+<$vFplJ`B%~R^QzWPR~#O=|9x>~lqeBWhY7=jX2MsJ zwn#}dNgDiVY-$k2=8`@^tO$D}_B2LW^ASrW8S6?CVSj={3>`M~GDTF#smqVjMlZl3 zd5QGGxQxqplOSdYk%*}mN>hm>$(I)97bdD^Y*H}0ordKqNARh7@&e=Vj^S`WOoNPS#rFotI?zhA2L49$Tu5cFCzy zpn)2efzwxk7F|{e#Htbr7c*C{e)DG zw0Tah@3(UX0W8GVShmZYYtMuI7{X=0$ZA<*f{jU2T1~=uf(q)9>PR;8@+{Wj&@~}I z_nApGru=OFpvaH}7!Mj59v=@3P*(ZZCc_S^R#XJ@Cwi(}j7=OynU8lKK+ z%a?!njtRW!t5?3$m)TIJMo&&UCK2g*aKJvC)B#%N0t1w1&hqI7ye^mp4Jb5ObMk=a z6_HP)5$VWIb+PN;bFyGJJo*zPqR}57&%60-uwt3ees{kaoS%%YPWv_IDzZfY)4R|@ z2V(02dmfZ|!Xk&=vjx{4Anf+`#`}%V8|K9BXVLSe3zuNu& zuifbB@B;H9GaeBa(l6tusKKQl9Gpf--ADwkgaZVWE1ygyqydEC(#PW1I89=LC()n? zVkaFG{hE*7$R|ZLoJBkQH=JO{t$}ZZ6f-5SILAp_Du#xl-C|)8pd=wClyM9LNCFLX zt-d>{RxgP()sN*QpaN<);f3=9HOqiS5mGvR(1-w*WN=LgfkehiqN;t0pdtvOb@@Ut zgn=xWUV;T6Qj~0hfg=b(A-qjKNLZ%?k2P?^*XPUo!N>o2_nS+mxY=@wHK_G;LJgNP zH5f4zrv=kMxRLLbNtK0I_jh*?#;m+Os$fC#SQ-<;x@6WrzvhNrYEVmtN z{5gw@&b+$~81hj7C+x;~V1~RqVo}_F^yPf>?(^>b_2}}VKR%-sU|}AsaNHJrGS^Hz zgc=N{7w7wrcY`nA%zpjr{WUKSUX4yBjLY|ri^&(4-P21Ou&)nGo}eOOLVheL}f zGx+55Gw1V~q0}in)wk=<^M?%w2T^VDu3w#r{vTCVU{V434((*8_N1xgmW(Qva^Fv;i=U9q$0(sPzuEEEw0R}QD5=o{e zL>TME@*aIUWy;P7A7F6{aIH51j?aP)ln*N-zhcMN-0$LP@n^J+MQp%t=MiOw11|um&P%g?CYDtl+5=I|M84^nb zf_x77Wd;R|AI+_x$pASZ5(TbJ%olF-2HCrGx-AgOmKX;B@~s~spcajzfZ`YTa-(!# zfTF-qjhUj0szQVfs`;%OU}f%$9%hS$fEC1bi5omk9xswk3sxadt_llj zy%S#6QQ@h>LLnvu(e86JB-URqEv$0@XLb>Geyq=6D1XeaI-+gm6eErIOx15)9{WN;RLgcgU zr`ypJXZtX8!9@NUV0fdUEKq!}cHndqU#n_2LQ68{;HXW&X6!fE4Hkd9zy8o&d@=m` zm%Q9``}umnsvf!mzK?9n3TEC(!~!YKHPjtAO^_Xg$E-dY?;n>#1{vr(rOUKtX$2~< z02-Tl{tv#uGAF0@nPTiZ1}axaGu}4(AD%}4?0+B5zu{qQW|xz%$$kx4jfC}sUV{BK zn3qP@-4Ng0kK+nrp)&OQT4$dNCw1;ZI4sPowhsxCx=BMSD=)5S0*Es0=pBlMOUsb*n#g>oVl zJ$O~z!b?UWW=ioo1h_A1(2}G|DqQ#`VDVMp2yVNmMCM*#k``2A!8Ntu57o4sjpWPu zHM!V4p_4;PNqK5N@5}HVx}W~-yW{VcU;TEzU%3<6p&zDzqK{FrEmmW7j;BUa#C!?b zbjJ2p7*c>Z8&}SV%4|2~a57`K&Z$}Kx!2zCX5Q=SWcB^K>BGbHt1tHV_nW``>*4KZ z_M`A9GH=}OuSG3Mr1r zA}>m8IhO916fh5w00V{$u+VSWogFU)5voQ)L>c6390d4_dnyGemii_X0;k_ua+4jP#3T}82C%WNDUkdn8z6Z?7x2)?cgmRTK}eN^NRTKL`w3Rf$)Yd{E*1+ts%7Bv zi3voDHbU7b+fr7$jx1(`@-=Y@Hml3GSP-QRH9U@oTa<00mGI#T1;CPQjC0vm)#{+G zk`+Worcpjgi$v0q1~*NG1LbHeN_t%qX+9yQxoU97C+sli3Q zW+~!frl~PKc@#qz1!aPH69B-33xU#ZjsVc~7qT=++(8|X9q+S5#=25475mkY0#EYVM>IgU?NEh7fHCjWK0(s+}c@Z=+&H zgj|RzJgHTamI@`6Xi{vbqNG-ppT#J8`eiE~L-|$3#!LZQ#!!Bd>7c8|NNhP?*n?Zi zRr!{8K#z{Bx?p78l22Tk?vi?ug-1!or#Cs+C#U0ZM272dcnA;oJQ}B;jI;Y})SS)y z_k^W5HCagiBsMY22{3b?=LiIqk0nGbIRm<&|Y&A&UVcc z1$y%w8@k;uSl+<-{m8C}V^+)1pE%;Y9qE&&^l><1d^9`e4Mg;@J-M8-$)8tKW(udA z54aq^e#P?Q{&+TKkpPE^JkgVQ96mkJSvOOtQn8QELbal$Ds$p=!#F8$l{F9K_GHOp z63Pg(irX38i!BF-_LKQ;__*3V-qYO}p8Zyf(h>1(M?DKDh716n>B|g;m#pKN?e5rQ zz#QhD(@wkDe9!QMg&8bL-s&@U_gU{j?%7`GV;m^t+g&}K-D8m^UmfrM>!(?`1gR$f7d}ewZXTXRK26(_w z-^y*s3u$?3v}VAJUvukQC4gYYnli`W6F6RB3qN+(%zXm@PBxsKPJTAn{O#Y4?mi*} zn`nLaEoFDL;RU^pWLMj#b$8Fpe7F7m#sxp@m1p=5HO8j|U_u81Kc%ABv51dlG8@+1 z-|ye!!O&+jz-V>1IQq?R*57=`@x7y0SF79Q^m4*$0``xqAxHSHI7(~NPiND&=l%U^ z$BR2W-Kb|&F*u&Oe2yJHyrbi3xA}Naxt^RKb2^Y&a(d$N|Fpqu*3eD( z`uDsPkO9t+I)h1sR9=)&rXjF=?4#Lu{zt1?4Pa#qCl2wzgy9p;VfDqkx?Oe!Rw3pj z5grII?qLrGxcjXSI}w7}0SGyXr~k!o(g84o#66Ur=5=vxJBexv0A&C^xJ${QGeN^+ zE#khS0}7yRL})>jhE|WmX$w<6R`t-}C$!}aF~1>raQ`$qkSn2t(UA_xf|_JKUobC4 zEaFK=%&_oR$pBR1(wJ9&2^|FqZ%Jw;1Pr;@HK=mt zVphwnuk0gEqO#Gc462*?BGbq#r)CPwB(C&LYU$CGTWkJ=^BZnZMVa(7gA9H^n3yEv8- zo9Y)F%|o=lVv35zR0-3jT{ zEMH{uE%(wNGysZ)QYi)(q(bB+1-YnPN;Z-LP+xM9wSPFKmkJb?}5xS7&0Ua0X){y%7CeHj7gB$eLA=>@kDakKKcPU z*q%K01z4lzYuU*~`>Q&K*+vHFUAh$UMEN0)%}%m8eo?t@B)9rOiX%b7F@Y|l^4dH(oBpPB zC9Y@kqYrUGz<7&D5hsmw?yX@&Xi0^HV?~G%6Bix?hPeG!3Yu9r8dJHVoJ8YAtGNqR+$?2@DYGZrYT=SRt*-W zvIB%vENEdOBNT=(Ke$_DOL-`GCDGQ3SxQM+`|Wu@?%CbnKHmTTcfWn(5)+l=mDp)m zpi>zTH0`FEjH`JFM^BghhY@ueqD*IQN@2E}LdP;4h5{UsNlz6QJfBktd2z**qQN?v zZ-1v-QCulC49-35-*;-=v&nYN@tghgwn`y=TnV$8mi)97vJ!@M@@XQGn}_=N?O?kY zEFXvGSG)0qhi|N*VPM3HFAgavtszyk*W2-|XC8cfb}1I7}b_N#{{ zS9R7D7TQ1j!nMS44x!^N;OhiroGqlOe!*79Hcd~Hn&~!(tzy=Pd@gLCmCB%3Zb7RdNtVkz77PLHg&(M+ z4;_?fL1IxY47fx@*hoPqHWQ>O1u7J42QITYc2E#3si9Rs1M%kBYD=}4s5P%h{ijUXET+zsCKw;2EDnct)u~3Eh zV`P@T+yMM2MI~?o~}mBvfTx zynwfdQn2A*?i@yFssp6n9y1eGK;a7U#Wl;ED%G4OwhnwzLfJ{Gv`QsbgArFg<9*PJh^k4sT6f{3Qt;s$7BZ1a#3&S;Ep(*}!6s0}Ra%Kk zvtGpzvuM!BqHf_U-EKeArXGMrJ4&}eS?L^P8BU4I1m6@GI~eWI$ZUgY~AY^jt);y5LKHwt&050v=FS|B@3x0>pdJ8rXVss6}8= zL=b}J4195wmZ-o%o0dQ7326T^U@4J;70&}T#Z{n?BvSBj*D&6MgatAcqH=1(#uhQ? zB*lg?Vo{F;QaT9_@+Zf?^(%lpWX0$`2C-K>OSsH{x{C7)S>iN z41z^)(A54Gx+))n| zGTJp&#RdDx7_%$ zEWfjJh{n`6fpGL~KU|GYDa8GT2NG=IU2Qgh^Y_#L<4<=}9>lFjUtVp0xS75>Muu)P zW*@v$0I0X%Erf3Ep$K~t|NX;wy%^62+mH7no}{5T4$4`iJ{jOGygU=(F&gg9OZ3*e zkDut5^PCM)%ygP{Uaifp05(6k!GOyR`V=eNff)>j^vFk*#nP!QuNL8?e~7#4h!%-c zzot8mGs=S$vN7&AoSNMtd`;oWHGsmuqJTX(#cY1wZyQ1_UQkP4iakQK5@0tj1VUH@c^QXq*vP?B5oCR6 z%maZC#3Ho>i*1nzE)mfM&#(7?Rjh4XJhd>vOD#eznqnKE5NmdTC+J1Lv~F`&GL*Nq zhN^N$NSP~^l9ME(v;_7M!GPalrWz^*yp;%}vUG%i)%=i3S4RtDIuF~hPa>{K%APK= zJfIBK>sS>Qm+?gCe0$QL%?W!I%9 zDHt$=Z;W9n=7Jv+A>m*OafS_+C9U(xH9r1gwii^81VOUa2uevykf^%l+W?;uI)a&Q0`QiD7j$`4hL$*r zB);rrSIsI$oC0@g_-C@rBwDvn8- zg;SGoRc#KTq8HIjB`FXo-TG>rv*P6aqP$`M`ie2QvSef7%HHc6ZyL>ONx2ZFAw^e_+wcMO)s5|B`5lk z-98X^%3p~9X0?v*(R9hOOLbHDnOS4>kT-cL2{Q4#9uw2~qn4rOU$8HMr|^TpG5q== zr+m-@V4MI287|-P`#>MLUx`bENsJF-k`%^E9-i~Ogr|=)qcUdN4M@0KHGMu{eIf90DxT$ z-DrKk`|j^YU;hbPeEa9c_?#a9986wi;M2qVC&Ob{=d^VKJQn-bXB38hOQeym1S%M`U5FJQrDQpA-oe0xyY@)S{ zkw5?fQrc}+gOd?&x48aKx35O@>gl0kl&F^FC;(auSpaD7!}o~wHoUBgXIFR;Wr3yY zEIm7h-F~^@J=vtP6rUaQ{piSj@aRJa`qRy1uo^#I_p1k<5>Q*O7QB3$;RYw~@9x?4 zyB{zY&l)=V+6;+3MxVid7L_vq&=v@gZ&ac2LnVb`q`~UG#j2n8Q{E8v@XYa66HW-d z{xrUP#dc&yBjd{xnQZSF|6z5sbn$U>7fM zJ9ysi*yO{RLOd*BF%O66GEljFX1cfJ?yjPg&T|qSQ*8Dfl9!KmUP6m zBa-uwFnu~ZmwExO3ZbN7OsgF`b#zzFaSV<%lh@K)hlodw;!=-_Pr~p!p{3g3G002M$Nkl4T1tf#iw!QfN){1=teZ*(MI)|G7aSs)7|5Mc21O-6Rt^jTr*M^6BVG!Y zV3wLtiLWe4qNF`It!qtf2C{T+m$+TE;mkJn0*j|X%AY~Z~LGl2f^s1e-gAIM) zrAD1DjjFS3SgQYQx7}oOznBUtQ!|%8kz|EZ+>};?pe%nCHH&~SIUfSy74T3XUbrY4 z8MQ>aYp@5!v`+b>{Ai=N4GpQPRQ(8U7Do9>QX)Vimu09dP}&s{?B{uK2t$oS0~hs> zBlv|~aefo~k}oa+(yPKv3CevGCCEzFE@~wK{6a^&`>}PXa3Y(pUE5=&7x(QsrV3C*H!{gynfT8~Yl0vM6pF9je{H2#3`7C{V=mwrff zpo(w+q>>SkX;U*V_(0lNa_Ej^tb!=0lB3g3_rhTdZ3SoNK*MDT?i}`jA9QCr4e;44 zV|C;*YivQwqd7Aax;)6YJ)xHY9~SdS->#&3P;Fc0Af+N1PUHw6R*S9HyuK7|=najI zs0v0~-n{#U6FWQhF1ys{csjW{<)HEHr^$$-hJRW{^HM)P^eE#Gt z9(w@X?Z>Rmh7TMWgV>eryZNAd%(7;+9`u}$PQRSoM_4x!_O5|uCDejd1`+qn+4Pu| zSC2h@?!Oz2zWn9j>TL6{9iELx=cl{Rw;Z`RVm&wSMY=j;)}Kcfn39(q?HA+S^Am?2 zIc1$g3GL09CsdH=&U8DU9kZwXYBc!eMfdKy|MQ2z|9P1i?pViq;>BH(TUf*6{9`|K zFyrGe<^*Xd!yL1w)ge_mHF4~%!xCfpU|43N6a!sB7uF>r;0P)`t%EyM0zcS|FcHBl zIrJjwNm6qiN;bEtV&fhWhltQ~q@iN`*!NBytu!e{Fm2M6tH@E0)EF6V@+(VSJT({= zutZkb3=w@88cZq)TKzl4Rx<^tj{+D&R=abV%k1%sPy*^3C$}mUkT5(gAh zAuqKkW3f_f1!vxriT%p*&0_rZ?EQaz-u%VlS8q8dpT$U0b>)fVQ=l!1D46VH80<1N zbfmD1*+os~XMB0eQn~%(!{p>>Fh9xk>zG&64UW&5VrS3Ij01l@eb{{S`_YQGb1_>^ ziQjpE7NgwVfH!V)=Ff76tMl%G4j<%ux#ujO>;Z_-Q^t|eBZi?kS)g@3RNk!i%SD{8 z=Omx;mMFD{Acjyb^rN>;=4b8!(*}ThEVK z93nJgpx&Qfa4^8&VM#}Sc*^KyJh-#sb z48Z8N*^j5}R${`RZa{`D9<1a#BI-1rJu-p88Y=fv^L%r#A}`!dO;JQKvdxDx465wK zZrSnh_{=t-v|_Yuq?@tihdD~fFFl7}Ol8*SImzn;Tt8J;nh8}PInDqI-f7KTE@u6s z--H6>`32el;8ohfBu-Vln}bzhO6?jq0Y^p(RmEPqp=KN$4Kp-ijfX6Bdmw12b-0K` zof*BnlaL5D4i?}l6*xfJlu#xTx@t;sgKW$$Yv98%3=juN0g47nm{jQj8^K^iEFbGe zZXBv;Pr0g2Fs!+-9QJArYy=cqhb;OPrGEfchLw^73YC$VMydQ#HQTuGF;ASJOa=su z-VE^4jg`DXy3{O*;oi=S)`JyLFIjGGh^E2w=u-`ZES*aWD+d%NQrw8A_5}tuIvXiv zh>1!P|3(oaibw}svPE6%A%qi5I)L$AM4(pq5ewHOp%G0Wq>BZ#Ddc9XNXa)DAY&{q zR}yTtoah$}LaDF`m~WKSh|qX|OT3CUr&S3)WKh-ml9Q9y%Mu`sV1!+BOL8Hj1NN3# zq6Elgyt*3gm_zNjpz9w3#XazX0*cLGphZFApI}gmToV+13!`iiT=lSZOUB3~4^Gq< z0!6TBMHtnVt~iEbchb?IOo|Y47ab-MMg7lzGtlf52(T`Nw&UzqL%axVNV-3B>{|> zIIhyNg_L!g#PQd6^t zm*#%Ux!2?ovt5qVd1u$yr+04BWme4HcJzy&z^kh`zLQ4?wn#L!OnGUo>W)!DS;qn+ zHWWUsI09%gcatJw+v%rqRoE=`@ns`CeD`!h%QZg6t^%fx*bAE;#niobTh=1jp@BcA zoX`!25qlKO7Pbm3_xE?Kd11cMRYU6q$L+IHh?V!-Th81Z52vTQ>mLRWj}CWOtH30r z?;36P!qoQi=m2CmL?*jAfPAoL;~}Kzit(7YM^gM2tK`HQmIY(o0gDm3+Yg93{OUKu zS6746i{0bx@QCgg?^lq?=59MW<3Yw?dws)@V0iJ$rTo0;l+Fx|gzG@{5Oa`m5YCJ= zjG9q!!8U+n=`0VVL5y{s)t(2Kk(Mv%%M2bhM;rBaj-F>*(LK*@0Y zjJ+RBQ*U^*b^m9#ub%qLUr`Oa_5?2Eo-Y6vn9RqL(ThZ$hLOg5uQ@M^p)&i)DRI7v z%eiu1JZCLCpN~&GF|@z9^u1avPWy1%-F+H7J+Lv~GQHs}9CpCwqR0>EH@oY_^iRLu-9C2L50i^&$Gd@#j?e$aKOanvw)c0FSI2B!7<0Vu z%{`}fvA=nJy&9i#;MZpN{+3#a&CTo*rXN3=QCG2saD%A^?wNLV)ac}xVGZkxcw#VS zs{?}p4*$)eKs33WI6UO}+=9ja>}hb74jUlMSehgc}8D+RCWQ<8^=%bLAhvZ`VXC^`fWEm89w5X}4H zloApjNcF8NrL2`V3)oR^f0 zfvr&zBbBDC0qHBJB5`2@nqnhk4A8*B*CV3<8bFOp=rm_x3n%)5l2Qff&fit;3x&@rxqP$ zQ^-I{O<uxWL;IzrtQtzdFpXLo z&OV5sEWk6%>Pn`1qwwKI7)g?|#G4dOV$=kb8V6E^)y2x*@4~D^?v<}yQa~qaCqj_c zYRPPWp`q{V+JwQ-$2E2;0%?Q}DdJ)3xSi}0As-T&$z;f#KkbXMgm`h#6aY(gI(*Sn zp^JP(DRaU(4kwXj6@%t+wYj-7=MrNMXsE;rRJX?RugGPY`Zm?#s1{}zsSSu9G2tVd z^en?6B&2T|=#^TgfB?~ldMc@~kz$xfmgp;90h6jois2XP{-MKAEpLCKddK`CBH6e-rb;Tz5gG8f9Wxh%xDNMku{!x=TvO*>N?PAAjpWb?eV z9MY{Htnfe z=J-M-z(eSuv!ZCk8Ej`XwxJUT)ZRIY46G zqdc4s#!tSF?Bs}5+uQZRO^VKAqHx|%gw}eW`Huj|!?LJ;xEsEj@4xxj-~Hq6^mTXr zF{ab()sA4gxF0_@Y+#vY{_9Yvd8xG4zrI(1WsFENBsf^$%bpik)9%ltxNfss*5ssRp z9Iqu7izsiZRLa#$4q0jwvJ49scSS8~&{aN2mEGSN>s~v;UZ+;j)T(i8L z!btC*V|eHZKd|3--MIxf0`& z=kTg;-iC4i!1-X^*^H+Obkn=}Nw@xN*5DXcJq#nQRbXK|Oblfo5>uYAu|JrqfU)#& z!vZ08^Z2F_#_p`+=gouclW?NJ?D6bW2VhK0pqgBq_}AzhM8&MA@wdSTU*V;(lF z7=-X1l>LyUNy!y^b%o;O0G>v6TU+R<{D5Am5``o6b$mw$&_{@sbAH0ta8Pt0l1Qw+ za8gCkt@H>&mNK&0ehhKMa-U?78xbVRWklesSQ8h~Fbe3P2``EAXMdqqrC7pp=L+>h zVp7%E_J}m6fCwO7tBKr+B!&^;KmjNY#x{~gGa!J=Lyc9CFYh8n0(>cD+F5=iAaf68VT(x zIZ~`%QsAYDh0E)b0h03HGQ^L%@ymTsAWVzIO)Kf@uSklYUqaHi;WtPkKmN;!-+blX zC?hm4%*mh8xlr(`0WN?8bRp|UHORl1138aN_EgD-G%^i|4RT1=Coo#^( z2DKT|a;5l05}o-`u#=?+F>Urr{$N@ZLqqfUL9qBk)C(^qi~GdWT{a;$Av@$--0u{s>;aWX5tEKa|D+4w%rCs&NYB zCqk2%(UC|o4h0D!bsuCf;Z}r+7DED!T!oAZS5mD=G_|tWK`gbM;*Ot(Rx(bUgGh|0 zX=df>^prZa#4;m*@o%KohM3F2LlueGgjjqbc^E;ojDaYM#hLcXBO9V(8Hjk420O-r)dm*ruA4%c>@6{I{!?JYbP3A z@`GdkeFrDAZ5*`E0t3CzeSW-2Yj|`*5^n|=%#H?c->zxsJB|xs#%{!G0oI@I*&oas z#OVEWbaOJ&;jN-d?gIoXYr>Rk#xnFYDGWTgGmek0r>;!*IaSSCAl?*2R_}XOP-8*< z*i6Xs>2qvAGOs(}h|blg-S7UIWB%FyxaIK)I~6aci~%UEuC!+P^2M22>eZ~)a5pfO zlGBs0Uis<)vkIHToz4m@neS)y)YVD%H+TIv`@uhb)phU7ILfQE%8~*p6U|1HK8DZ< z=?PZL@f`qhFiSyj(I<8n5HJ$-BJ~$6HM-FREHA`bm0QV#0TFs4lrbA?BtnZg5Ns@D zY|#KcApsFFy!bZW3rQJ;WB#^4Q|Mi6%cg>T^4b?F_@k`#+-JPAVa>sqE3QE~^u?lWT z?}npwF)Pd4SbMYO#n@yP9WMH=7xUE*-;W+X4W4hutJ|JcbnfHXty%WNs+LuMyX3gf z0T{8myHQ;KY|mQ&h~@~>XHGaU zb0N)$2@duKtXV>YstX^8eTcw6jmI&P@8&IJW4A;Sq3b$&j$>io_;7rUNDGH%*YDt3 zJ{G4iCgr;MVNu{4uqt5)#)TSKBP5z<5fkUM+I6xi1<%rj=pgcmDea&FURre#7Dxq$`NK!8%XTO&UASRE14IC?d`(zVY}U<8^C)7h9Y6k6h%3ksx^zO zzh$%NV_uU87__QhfdFI_gm06=gxiQBeHimpq{NdYK>1N`F?hP=$k_@9n}>|jMTX|3 zb|;(z<%(Peyh4b$Lv|Y>YjGn8PXM@)CjST4krhzl_;`nmq$UL4fC_9}9?U5x8sI7c z6gQmsabt|6Exg#pZc#p=O}uP$Vyh4|u0p|P3Rwd3Q|%>` zE$N7+<0H3T#I0pAS66>wg*ZB`j1%37VGpumQSgh*5noH+Bo601~;;8jvdy9q&7NIbGZ z#|L)JNyAD&Yer!-i&z0iKgm_CDW_(WXnb%dt%X!7uj|_fBu|?;B&`!dvdjsQ3j1>i zfdwavm~omWd?hJ?;#Apeg4v*Cf+bX9neB-VKLsk51sBy+NO!|@jj{sELfAsqXHsDm z3m8kJWtSI21Vx?J3Xa6EDKs_b4(piLg294v9!ef08&t~S56e<^V_5ngp0b)IE z*~oE%TMw;75sYS?AqeJS%)?|SgFh9akkHJvbpVl_t)F2UyOhLB{ti9{LD-(l@99}c#z54 ziv}lWJk1!KPFb_Py}jp%BL`2%wCl`gyIVV=ms`6;z>gm)F|ziBmj&J zig^Wzzy#5IT?6pC%CS`{6y-}$ni7Dl@cCCl!->)f<6?>?CAdV#s(eVK919;x0d5kj zh!uloEEbAbOhTL65Co25k;R%atumu1Wew0{ol>AUDO$wyHsbLU(bPp;jqbA&{g+I1 z34fYR+nf}*FaVaEu-)Mc2gq1*`#hV?Z~niB{&sirTl&ptn6-AeCP=6QX9v@~a&A5v ztb5*mMUvw#&j}^pD6hjQYu|^go2N+e)N8X?`-%+u)5qf}1JpnKC5z|SOwTeorm@*n zzuN9^>HV+!``v)IdO3ZPZsKY`;N95#u^f;`0rabxwuL#h13G5WpdqRUs%H-Tq}0Qg znuMJ#be0)=jJ`bXrqj)8H+}n>y+P#2=u0N@=`}Bh=V!w|`OW6z$Km>U%#fJ(fpCBj z8|Y7_+jsAJb}#(q*W2NoA<_8jw>G-0z!^`rKYV19{gwjB!;iNY>pyv7EPjD9@Jkn9~*P0C{fjwf}|l8uWGB{@5oN(=y=3TACzoRBAg zD~r8#5qfHw{est+t*HtbD)6e3XSPVwTfhWZCv|@6GChV^zGaF@bx0i`?xBg(c{2f+ zSQHdXTfASV&_V32RLkJ~OOgZyC8BWorjnwAB8MUbyGpackQnf2fk%ZnaS4YD5c!o# zC~%8qs+I^ZtHKJ17by>N=SF!{Q96Vhk?55e>VJ%bF+x<)m7HH}ntm`6CiWnL5)p=& zW-u(gCXlu~^Bbmwh%hdR249RVBMqYJk^tlVTz96kc)#$&FDq0rW*J{K}2A0ueOPeys6o zD@E%!wcwtROsy`tEzK27L6nfyZe~Q2)=Dxm23T6kE4<$addUuzrBzZ&XbC1SMR*Az zmEAn;l*+l10vRq2A3SzaYcaa5RMAFWIU227V8gj0(WH6V88z)>EF31dB3cyKo% zc9JrX0Qg@QI28^I@rny-1K z`_?19#N2d-f$l@Ua20~P0Fj1XHm4$@Dh=#(#wuQR4;F7`9F@=o@?DU2P-qwVhLW^jJi?cc0FeBR&PkH7kIa55VX zo>@i2a{xMP&~tG=FD^bk-7g-I+ig=;^*dfZpv%#{hYJT6A_ymo@<@T>MF0L>zx-3} zV7KzfJWYP--egYspji$QXyg{(z@%SLj)P`SNG5?8D|vBs<$#hAYED5Qe~l$AmkD8E zbkV|uskJnXNkEnh#=H=LvRwXKKHzc+2k{@2;R%OBqmjiZ7$z0n+fSjdQV9tObhR*bgb{2>?QvLotS)>zY8` zMPT2bio+Q+q+weEM{2T}fO7un#O=w z1j;n-Kqf_ICF%cWmd|?NYN?aLAMrNei0Ru8O zk&U3+zXb!ZSZTc6>v{yGgmJ18DUH(okhSW>6hdJGqX_V8K=XuZG>Bh7#@+&~tl;vj z&L&0nK>J;iBQTK;&m3kI>?hN3`*P5qx@iaLryl7#$Wf!ukEKv=?G zjf-DO1iEB^2%&1{kHp{@ClOqb}1J(ct4-h{h5MQa0 zwg@7Ru*CdCTI0%^Aju6EcQ%4ABV;OFlOltL0;6eoC=Uf4{!oL8*_0w6s?vl?P$iS7 z3cw*O3K{RGr70W?sH8ME$rK4oNy3uj-y|3nJ%IQNdy_)rAhuZ1l$6?x7tho0hvfuom(`jnFy!ex za=0gu&9cn3IpauW!L-?kH-Z6;PwdwU3ZGCWzgbo^VPhW>!I3|eRLY#p%|s<<0nxhC zKW4=`3x0T*e|^gtnmvdAEY}lG=3|vG&;KuvJcW?uzr2!+EsxK49Q!k1@^dodg~5y* zpicLS&IY7a)(BSHoe+`nmt~e*eR_-Ocrk^M5AO&E2!6=V%r4lr=vSR$Z{R*iI5NCM>A-$V1QC zr&P1U*#{6v2Jm{fUqNs;cy-+UVbQi2kM1cH>Qe?uy;^3bwB1Xi9HX}A3?xC_ z7L7y*2}8=jUtCx#S-hfV8qP|Mm81YTjEN)^*@{jX6B=P5wc-`hGF2W6ZrJJL1|e55 z_P&UrbTLJ}9*lRJ`{nkV?d7S8I3NUFnq(vWA1B`pV^&7DlpO?vHVQBtUFDG#=U?%L zucsZa)S#ET<`8{P{~YY^Z^!Ff-p{pPaIO?<^R^q#{8{hsSN+YBC2gGO?^YBGIQ77g z&F-%IXQdmf&uaRg-N5|$93V>2!9f&)bh&vT#nL}UtJs(B9T_)Z5f0D3K3%hR5G8g` z+rin9-TLQ#@b-1b3jx0Wq5tFe;}f2ju~lY1I6rn6z`FW}_2}wya5P`PzZrEa_U-l` z?iis@j(N}514jV+LbAm(g}uMK<8)C+$grGp6w+`sr|;prL0IjBJX};FRA8?vzt16tJsx=RM1k+m>-{xv z{vNRaFj-s;mJR}Px=1>M`IQ)5K-T1!xgIbR%ZFOKS*a4h*MJl*e}wcF6c9%}kk=|% zLPT0irD-Fgi0gQk2w9k0x_f;7V8M2y%92hvm1OZ% z3y7(!Wd-OG(cw+`70Eb{%;6~<|G-27>Lg`S2?-Q(BSC_YM%o6LVMuHs;4gAFRFjK_ z@F*5kLCbaFmmNpOG>;~r0gxzaA!10&Ct~``rBV&jc8WV`ry?&l!UR)fFYo09ENM^&<+XX>VlYCp}cX5K49n38)QMjK{B258A{SF`^Rj zRbSy^jstN&9kmKPa76-IQnEm4yGB=5A;cGvF%Z-wA4@51?oB6b4g@>+n#}TvL#myX z8Y+>AmK-UAT7b$*x;KqNBLLOF7juP>-HSA$m@Oe69~3YW2pVeM`(N3Y0W{#DA!byx z7lH(Ul_{ea=#py82$$E!bVgJ3D%17Ch+hhmR5lEDaUeYw0;8EM7?KAdqAAnCpNX(} z`^;(p%*T3JtYC-CjAZ|tg3%2L99M72e z%QjpdjPW>eXCGz5^L;aevwb+~1Pky-zlS9TFlLsX^*{Einq%S9dKhIdD+@FYwph}f zF;G|!hKrsfj_CGK`;rJ!rJwk2xxI zw}K1LEEwT1u*hsED;l8B_Qxak39Ojx9B@p^KWv8o{ks2GSN;9HZcS_Clawlt`kF?D z65m{9YAr6PsdlNk!Bkx4BQ7FFFw<8M(`0kc{EAZ%VOckx%(ifW>0Ga_!gq?BlqG2K zD^_thV=a;q!xYF0CL&42Ntr3G_GnBrS|M{^jCBpt?8-+#I3R}5?N6436DbNO`{;fF zlV5a1g#(IAz%Zd?OEBz{#I5v%iTXaY;tn;UA79jg$^eimS!9$Pdc@n#h^RGWqDIjd z^rkolaP$ivV@^O^ObkaY6TJCRlXXhh^+)!a_jAQGx!OZGIjSJ4Oq*VIESS2uB zwqNkrjni@`v)%Hsn;-eu<(b{9`^nLC`@{Exr%!{`y*p8u`uEr$7yVx^dv^WOF{bn) z4IN;|z>IGPbp3PaCu3v&SfhmJM-TZa14Z5k^OPmd#^vN8;;9y>LpYX{{<25tY?r=M zU_KiE{1q?l-m`(=_@evOuX#E#`1GOw{GtDcZ+7o)d0sd8Uw+wL?e`B4_Dfl0|K;U` zlXjjK9q$M`W>3I&Fyj<2-kiPI{qc`F3LASkyOV`ePsR68> zvnFE`gn6tpcmfGpuxi&VF-~J*IjRGSk!IDTW*BNsYQ zlcY+(*kGFKO`yb&@{xitW=OC&P~T`T>?=YmH_ccQldOh=k5)3GfFw^#WY;;#@&P^; z@GDS-=p7`3i_9>BNDM3G2#^S~&m`a#hHyw1bWtSULT(dpT50=PP7wd)a2?x^6OB~T{?J+ToDyn~>DS5(RPj9MYeNWv3Mrzo>)jj~`$ z!j}?9599$Q6!L?pDK660ElW}mDion1Pzn4%Q@5%5-dH3sHN?b{sdQ3lg^I+&ka#VV zWPc9e;zt>intG-m1ebgW1ef>}zW~cH98D~LRlJ0FT3N4t^a``3)!V47+sVbF+C!@!UXaP7d;I? z+{R715)0KJDoE}CwZ9%-L7)w!dudR$C2fwI86`SDR?OaV$s$@2;!k1-PdrTZ(Lzl5 zG+d@DOo-47=#s+m1q+pFl`k<2Hl=A|glySB*#S&bTMA18@-UH#)KraWD>8zpg0+B; zN|ly-2}8uba#A(1QK6!+n$8%*iA02`Z&g98U*d9yl+ASyS|=BD8Y#Ze1(F1Pr!v&} zf5OmpMs44}Td@>(G@Z}s<7*#{$?W`o&0!a?_Jr(`)-eE7ITG|oO`SrBAc|C$iD`jg z7s1*S1~HUtlg+>+T@&mdYGGR3W?fC9#X_uXO(8p(@(^4z1G+4&Kye1Bl>Xas# zkps&ZeD%+XkN#@uV(VJ5Uu@ai&P?(D)LwFZycX~d&yrLh- z;DwU!8U~$+Z3B#rQk$|rm>wM`IsVnR-Rup63LJoLiZ0|lgtPB-*a@Q;dSf>mQ%L9p z1o$&=w5Lrk8?sp_0uSQpC_+ba4N_Mpl6 z6$LZ9iB$G+d?5YEuc^ILc;(he&c2H)jImmYAWEsVsp1d=g2;AUQsfd%D8>mvO$4;1 zmcKM6KH;R(?}HvUr+O&uj#X+$-Rj*2FJwtP)71dG+KtsFULz;l%|Yd3lsG&+8NIr& zvdGw*DSrnF)5-Alm9LKGVb}TTU^d#mzv*wT$D7B&!V?J@BpdpG1G@3iX~rDE%eO&7(SQ$RhC zlqE^y+EB~kq__9G-+j}6yyh&e-M8O8{`>!X`~1{hoU;mU_K&_CaIZyT?{aGv>sLN`xv;PHOLg0e8MyB51~NG{J_Fg^u~{LrHW1I6i8&F6dV`SP+ny*;Gsu~ z;4MjFXd9vi2|yKNM|NA(Kwx;46^=iZrHqrJ0)WdyCFE47S_K;1fFQdh`%_s8oDHnR zfReL(lAe$;3PTiHNEuT2tMO?ErLUNz6|ba(6|sth@q;K8Eg+FFFiklEP=NrSN@3PTR>BdC(U|bEsu(j^gB1_Lq(NIn{41!k zV`wF^pdDgkp* z&`=5S+!Y&xRvG*>s1k;|Fy@M|wBWhXtq+nAsbGaH zd?YMj37Q65KOqZ%utsp{(LvD*BTOi>K2pp`tAv499jK+$gi9evUJmLL$|Ka%mXI+DGg7A@jIMsNeFrxY#`qVd(h zB9Zn94I-VvGR-O=3Z}*rfvaq-bdn)E{FWvNEi!Zi9^Nffc8FYRoR(jd$`ILkDMp3l z#ZC08-%Kr-Sh4&dU0wEyf%GMy5mUKKQi-TX5feGAEV5o9CJ#$*f3w>>bloe?tbAH9 zK~5(CSFo?Z3VnM2dGJm5UE=hHIo*cExJ=&DE#k0`)sDS{Sy98zTlT85(wDXHq(FnW z{mgg+FueneN)G|fq@y!BL~wh$Ti&fj?FMa@K=T}ivPm5XIy3FF;rN&rdi9)C0!HQ$ zS^oQIbHs!AM_!wn{;u6~p51SFYQfRq6S^Tx!qY1IB4J(wwDvuzK9u0_?^(B9y3+u5 z{%Opb_-72^Fu>+2cELLIl#z#Ch)~*)DN=?z4pjv)o&^&2QTN@$w*T*~M&|##+(&Ws?@JvGo_KmNSWSasrrBG*$5e1T7&J#}u z0HAZX<5biBTi$*;Wdx?a_AE31XU0GkiJ)N~d7;Ij29ckAS<)Zn4#Bza3424&0B1#0ml^~I%K?0{rj5RA6>4g$ht#uYv2@9E<&ANz;r#ee>@>G5>*i?1O^1=G!r zGQCQlxk( z$?=3C!;mKjnuqxXgr&SQ#^P1ToCByQP}OT>W(gc8x-4B#05LlbrnZcC96+GE+L{?Y z^|GVs3P$cm*NcAPiyH7Hb2iy!uHj00b$Xe^nw0Eo4h9E1WmFy+QkIV>EWQLY=r`{R z-<0b{CGJ;YK;j(UX?vL{m9@SUrDx+1e>H_91O<$EKK$^}or$TCtW8v49MsOA@JQuh zZAL4h0F4F#+x9_*5wdnuOa zBsU22iVVsvtg7KJWPpkGpG)gnj}+I&Ub{(`Z|RoxjERj=(FZ`#28mP+qmtaFC*vKc zag@MtLn7vdALSI>aF(zkh=v~_nn`FXHTWtVoXD21FbM|vYOgvqb_{S(H98lt@nT>K zRZ!s4O9Mu!uo5Gp=@LJpE4m4M2Np^Qq@)QzL&}i|Mv5Ab0zx}P`(#t;AYm)L5KtIo zlC~ZxTd9^qDnU_8s?^Fz5lDEL0h&uhP-8&R4tK`Dt*IpsgF?1%e$|c(A*nqL5tm;@ zAs%rXK{=~>u%TMC4uN(D00dEsPK&NveSYn3*(EfSJPz4F9Q9c*~WutWlIpw>F0nVh#kx&rd znq4AN;gSe&2YU*pbR_dl&n7wqHYz)d=FF@y(L&Z*TnBR`;1zi#0xvX*ZGnd<7HFpP zw=NY%Aa27GYA_}VnV9qvYOvVu?w70ijHCN?mC20dI8NqG=QGyF0>~8~1eY5o^*1)B zM%w?T6_)0RMfi*cc67}VrAz=;4&|en4uSG^vI;(_;{l$W&nFxX$Vh{ibLI4j*p<#O zhUj=bDUT^Q`No!(xz}to+)o%*&=cDAEV$>Xg$smu%Ma?ffsa8qul@mY`}vXMLx(?m zJO28s{^FuLIT>VMG8!rt95D=4%g~iStO9!W;D0(DE`Ff>r>nq{0(U_As!@9mZeUCg z(NRn+iQ?!%kBlV~pEuom)>N<_f#)jpEqL^?UyrW8@Bi*^Fw*#ES1cjeKP|fzBM>$= zU|+XNBdSkW9-rAqJUC)?5VM@-m|~$beLfy=qb=(&PAB{CSKZyp*9&m6W4wfK9YA>u zlJ7yq+p!+!Lh=j*I^>918WiDv642LyPOVIQntJ_+ztlC-6T7f-gU{Fjg>u{nhm5y+ zMr^Uj$OJBWa(kE{WdyJ$xB8891Fm+Emb*N-@;E{ryo<~XH6a+0LX$K_J`8@;PE?px zK&%%B1XAhvH!_+N01x@9~l*?gsoU`vF%T-1btxuQj1grFol92 zIpNvXo!n4-Jo$$hn+}eq%@pwMH#@zv3Aal@Li-VO9l+C6XkkE{NA?e1Q@nxe}<8*imU zN_QV`=d>zL{ig`fb7le@x91_ijz?Y$cU|meCm97a;eg|SSpSpqj5ClW9>Ozau^s3C z@G7ouI_Cvr6!ih`1EzO>`!KmYz4({^f|`Z%e1@m9{__Jb@E-l*4Fg@B;_6tl@Vtu` ziqFTpA3pO&KTpxUJnvX3c>91mOKrnW22L9FITjhfNud2=F<3$&#UDSQPtWrQgrrWu z?#YYM=?TwPwwxMd*`fZk?2}j4V=*&d@xgcr%2D@0BrPG8VdXg_DercON8=AGj!)3j zsEI0jLD$1%2xTjCZ(PTPZHU2OW^G&>!F4`hY;Jk1sQXDvm2#10=JN+2NRSW#2x5RH zqGAe+G}(zF7)c5gh{-@AQgtB!iYH1P*|xYt>~KJ-j~o#oXDyiTp~+U zpY*QiqhBk4hMI1OB((@Z*b*Rx=*Bm2>Z^!W^SLD)%@QjM&?^&V3<05G3Os)Xs>sPP zF(gXge3h2ufRbsxk~tAx%@x2Tb0(66BPm?wh`+*k9mETLsq!awB$64pI0ML)HPTlo z6_7}iDzr3)0U?V+h;duy$h13kh<89LTY-t9*s@I&sk%NRTsR~y8b<^H4q5_Jdibq` zkw~e^46+7Y(ki0eLb;S^yi`pLNhkpU)mL_{z;DEFxv%QRLor|C>Te~#!d1p7*g>Ca zX@D=H5z0Fub0dwUsdlo+RFg^wqasTrvewQ;21~>57_;H11_H^q(Gba< z<&1zPPKIJ=0+pS{aoF%91{X<1kPGNO@NXQ6N#Kj#$m=5P@E!)|iAv z+0CC?5Wqa%rKd`icTQvr z659!hYjI0szuVtFt&ZSHSCi!}9^A>~9Ag{i^XO)~O*fSmM{?K+ruXmT0Z!uQ@cV3u z1B+bQuKovA?;2~(lHT=oughL*?fZK<@8w)Po*5rJ_84qSRtO*=k)VVR!H%6oLb8KF z$d(eK5JgFZP(B$1CK8qv5&=TUh!1EaJ_Lb8BH{!DgcuXBH6Gg@qX)pM_>s;jE2s`CX0XoD3`4LrE1GiQuP!b5JD`hyFH& z{iIQ9D;}244|0%GVVSvqGjCW@jHc`hv|KN*mTV6)WGNw^HKhZ<2MR9dgSQTchkFbG z4z?%jDT{pan@^@brPAgkHb#)-5(NK+L+!@4+U1C}deqyy#3 z55bhIXQ!}`1;oyPsJfw!EFz4Q03#a5;n*<&6t^-+OiW5@WqO+~rU3jQFrg z(b>S!UoeNtvcM)Ck_EeU?(8Z$U-%l1c{$e}?DI}*b$q$?{^!~?oq=n=j6n}@YioUe zHrN@^6IkHh?3cAa>W)rVA3hnb=gZ@By6#Mb;_G0H0>A(+4x!WGhdmaju-sg?SLZ`! zCsE?&SF5Wlwh!Y?CAnfTq`8j)8JM7GUtQf^URr+n#IJRqKW+)9enTUOT2@ZVv%?Kp+{f|Kfh}1tMKoqz}8ez(@-N zPZ>)ki5>#$FY%qo`%!oG)rmmVk){w-9xv9d%WF}?AOrZ@ypmPA0yFA$C&0Afl-0KyQ_dont#Ac@s> z3Lm*F_RYpmFjB+B4n++bQZ9I+ZY83n96Wptp%e*hzdRch4M&{8E*eS`jS&$RaOooTxC9 zu|%SJRjc7dTm&bvN72;aLQ5Hv9*zWaTahvi`!G}o$OKw>Mj;|@j@ULzm*@otxriVs z!Af+5msptf$(S8$hJ)jIDu-&878T`2-ob#5iii-G2wlj9UN0V5Y+YX*5~tl||3;9| zL>wZ`qvTQ`gSFu%Un>jh0+}j-CLqUR>Yx)V_vBB^Duieelx&8Bn3kJ5xHqrRuIQU9 zX1pS5nGzj}Jw}qOp2%z?Wxz?E1S}WQH7;_bQ|PTQu{eR0tthJ^Dh^NGYlAL0=soSA zOO*pV3!g*egkfDKq0%J$2|zg^C^F|C39L{85+ZW$;R(k1;h+i{MM#HsM6B%MLXi`d zl0#kJ3kqKnHAggNT?r3HvEwzi4ldBY|nU^?F1b3wYP)dL!RxJo9AeR z;Muap@E!m(%9*ATdq56rG1iWBgkAgVqj|}8|M0TZU{`RW5v_XfEaZ5pWz83$H*_Ny z1@}u}5}`ECrUSlV#5cT{fLl4`)7OVE%q<)|`)OFSqbO?ws9>3LJQ?4-c)5Q5YPP#O zKD^i7-16nG;oXDLgFB07uNL2Y&hvcq`0Z|c)}2h4D9pAcj$N{J5#gD~j2JxPhVA)) zH30s0+Gcm)**(XBCQlfQacMN2)(*q@AFz?#7rGZ5H{om z`f_#rY`uNhGQP??3U)ejmrt4|-ZPxfxM|n0ZRib8vpg{}GRf=%tQi*~t8^xoIMYKo zI_Guv(Apy6@I1K>TbKr2@*5_?TYqUMp;S3FkFJ&nvr-tR_BvqIwIL97R7Q#Om=w@E zF3RMeCBGE6%1VNTJ54%Gs69mUfRf&bBL)zGB*Q<>aq^q zxo-M>NVt~+dnncG1$kMe(vQVS9dKSRFRw?B9egB zv1C2{*$wMex_NfRq?q&QqDxOQWBhamSP$T=kSR& zSA6B8dv?A)K1ueqY*RY8vpabE{`&OP1;L~;c8|KYwDd&5r~_CIgd@5kkxn05@$!vk z`hu||t+!^T&U$rrfr%zNv*FGTZ7x0q;5J_54gvZ=0CPZ$zYg(ORrzf{dsy~j&37X8 zayJL^1;^IdsYJu}YS=vCWy*kI6TtODe-ycLDcvBk2$X|l^AL~Vs<$ARX?o5E(+maO zxFq%7AL0ebnIEqNH*G0o1v||25Zo7(NG(Ii8!Xer^N0&bsv>lv=z=>5 z>zM;1rqWFb@^eYrD9N-;D^D7(x(Q9QIX2!}(=mf!s1&^SZ80N}aGR7#;4+D%HZs2V%LiUYRSDkzC0q!@((E!#sXKoq>=#|qmY z1Y(7aE#L}}G*n0+bJ-hzie@n;V3t|UGFYTb#a_w?nC#0keIT(V95F~E8F_@B0hL9z zFzz`=HEWO%11pYinJY`H)JCSt4@oDFRaU4-0e)#>KpaWhu}Q$V1j^Cnm8ggpc)?@1 zXf0j-#gVLvd!Gw2aZ!75`U>&L3{NW|!SrtpXHY!I0#?Wd`Dy=XBf2$=V11d7oGPdi z=4h25<&cY%%@ExrM+isw5*H8;D2A_kc_00aQgNdQ0!pToQwXP|-uG&h1fi!VC?{yC z?#p*1RdmCSlaxQjncFyhpp+pdvaY&nMqj&T3w>7fvDD9pD+6CVPubd&R2r~6L8;DM zm`Ib>oonzw_uorJX?5yHG4Eu{$XSB+h6~kvg8O~(<8*5k%&{k#?^yyP5jdyqEbKcXBuD|-h>f~tl z;NkMFtXt%nKKEPhnJRG)n=?wTn+Obkl(G7=Ft+`z#QkZMW=BF9uVVG>li*ydsznX5;nN7JH1ZFVA?T!uyT&>yzg4 zOfP0(Ce-7g)GLg{4WIJ)rw2{aEpY*{{<8oO3RvW|V%B##oLiJSGCf8p(>#{BXp)j$*lH&&AuqGl z#UW8Bmq;E36|c-u-Yg8o&`1u*A$+7IlRbErQ5$OoqV>;=0^lE*Bh z88B7nRkOb6wszIPUKR9w+qR}Fu1#3eG8!`kPNA_y%Ensmz#B-YrOnEGxprqY`TTdV zNPhkN_8%libRxMJ%6b$3p$6V$BwrTtsG{V=hInL5|m+?J1gv7_f{+r3yd zFFU6LRguNscsQR8rf$5;8#Rh6{b2;t*`#SzjGzpQ&&JKpHe2zM+DxbR-}iQyjYbzs zFx20ftk3y^2V?A)tTjNPn-`bEhmYE4PrBoi!P}2%at`O0ZVWJ)buV5u=cgK(EW?rn zs%1rqq4+R6i9G_G)H59J@@9;wOIXAH6VPP8Hpf>mmv3E~5nCOgJ=5@L;SD?fZ3Lm8ip)^pr0qVW&>>Oix<~2K?fW<46C!n`YB5lMp(<7q!^fO8bTE-tK(sD zHSH3|GyC;Xvp}&#Qa~~KU{Ml7538~xFlOU~-=u?O8z9d-xP_li{|Pw@9T+l-ND3vG z&owP5uS6M(RU?y-@^oOJi_-6ef0zV6J)PitnA#U*j zRCqln3YS=FS@+7Ku7Uvw6`9baGv0jVjJ5#xF(PpEX`!NYvQPv={EX4#jmf_!C6XHd zs^bOy6Q=<=h)G%m1|x?tqeC`?IA3~|M!PX&uNq?8=V zheSjROfPYmg<6oMRMJLi<1h|A_|i#0qLeR^L@Nk$RFb$Aln&D5KV>?UR7Pt;g%q=d zkhGFJy_k|y2h#HHRAj z=|Kb9{w6T@mpM1=bB{n41E&T>N?O|N;wka+gY*ZqDw;%@@KoHmQWe%R360%5Y~L}o z$3XLUjwRRa>DltbZ?Y1Gc;DF2nxkT2W6;qyn-H#<96a3K z8@=}~{g640{_C6J?v$p#gOmGrn*D>-?R@d^6TjWHy~|Kx?1wybZFt1B`{S1B0>8;> z+hKEe-0W{L*}mbEN_>6mcHA6|+TUuruXNo@`T)#pz`31;(dPkFd;*vy5QdAZ^@m??*!;viV&HUZbwRsuWdCQe;B^PaqJne}cHeeJ!Wf-Q!b`C& z^CidxxUFB(KA~^&CR>59uGVFeHH6JtsF^)xwM42I0m z(y;~yw>%H0%TRP`Cx$#s_b~(zPytf_h2|N=Lnur+8wGdX>4=mPMyfB8dUzC7PN;zk zL9(3~_((Q-g+_&CicL$%@>E4}7#S!hwvZ{XmYL*DWF=m{F&Px3!W{=-4ocC&@wLX73YJR=xetq3MVFaJoYomsBygQr+ z&EBxv9dn^9V2h9bLUA(KW%!?d#)2>MHcSedOnFhL zcB~zKezg4RH{As6;&$|1Zx2UHz8BWa_M7c())lSMADv$TNd#T`D*Yj-DAfh zXsu%SdnSf_n^r!(SkE|Bpo|=qIn6oL;6}66? zE3ASM+5eZ_gxvbfg*Ub@A>hZ(`Hms^WTua{Ca=5cakpi&-cFG7_&IO_oD6q?NblYx znD25olEnB_d4~}?DK2EtTro8mmTv<+h6L*flsr6)){lA?A_USTX-2F-;=SBhI(;&T ztyGX9QdX8Unc3Ksmq8@}h=V%8fU@NbD8Zr-Y?Dj{FPajr3=k^B#3XD1L5PthC>Su6 z6m=ieuo3D;3 z#02tG)4q#b29}^CV;#NK`UEU{l_g{dB|AvdP*9Oxy4s&I90*cUtNs!{@mj>Zf|)96@I z1+qe~rUWr-fN9>e*m*hb3jr~;5)*z@kkA#^fGq4j%!7+*U& z=98rw9Fb`FFyPHfzU3{W{?55!A@A84EXeQyO?{r=H%q>4d!)?Bpf z({*#ehXkNV70;Y@XZxh_hV_T-@w$1r=nmJ-7lzH}n59kI0L_p)6A~~xCPjN%Zv3&B z`1qFX5qVWYtEP1Y^LjZrd)A)cSzq06_IKL5GZtks!Gmqi9WiAbmyQjef}+k~L->!M z4%RnAw)!En=o3|5V{$^g1bD^k1wNM+m(jGC0845@AUKr3QbUaHVCCm(2g1MsZ;lua zXrEJp(e6z?*p5pxMkkWAfMDxaLG(s8-XxJ^+df7RO`slodRWhwBrqtgg7r9YRH=aN z#2fjBY^9SBishs7!e6P^qAf}31L9NKMMQCfS$-aLBsDKN={w$psS#3BX9GQ^q9M6N zLd|Oeh(IL$&Ypq6OMdOiEG1I10#)^{5X;i8&{9wwKM- ziP=d>a{nuiWTdoc(NgMaY7Nsr!Yd7?;b>=zt#g1GFg=EEelhp%V2_8-;#=Qnzx_>L z%yl$k*>S4NH@{rzj%0K;xYB*+ha3C8jwx}Y_Epn-ZPh*H`(JFkKj?TBfo43m&_<@o zVtN9+2s~!y-JqpQK<_4w=^nI{Clu?ZJI!>LlE`-d;1E698?zW@`SjW7;IKX1UcbIv z@e$wsLBsT!!w22oHlOt!o?I`Vd^CEv$9s;&S3g2Vrtq=BkS%p)8X*l0{(}R;ENNi& zPRAtvt6SLL_y5}h>)+lXdmMQjIfT0-PID)1}kv<&EM(#H6FxT9s;BI^Sbpf_@R zW2v?TY>?2LcaO1HTw#fw|M^ERkFM{HcUbYv9;#rI*V;CjlS?uXJ8z!(N+K;#^Oj#y5WxI5CqBMoGLa9HALwYK>;!w!deF+^r^;1 zqy`QmHZVOv&?W*VR2dhJ)-_70eN9I$XOuaNrCi}0b$kqNYH($XKFKC;Qc+emMH?vO z>0z!yv?#$`?UbmOC8G5*xO+UmLGx;yrSxzgEk?d&O(w)Rb0yKg2Vutjsq}4Wd<{kD-L(9tnnuI&#Eo z^7L{Lvy_%A+~pLK1#dV}mQv})dZa}iU6}|$wQ)g~o#aHUnI4AGD;5bDaVZAstvotI z3?+>iM=?mybTNc?hVqM$8_wZgfI_OB_O#_D287IFLS8}^VI`|BB5Y#0k!I46F2;A{ zJ8)(G*rIZ=2ufI@#lqHqFLB@{*B>$#jQAqW8Op^kt$zhkl;jBEcrElJdn}PqR^3)e zijb(B45yx*x?5z$#>bFQ0sNUUc&@aOtuAZ` zC;{yY`v7Gwx#9LIAXxFE(G_^J-vka{7Z8qpEhQ|4W8{$ad6$@hrez$WOvOxT_+7-e^K zupQsKH+l3BOS0V}9~A?YHjxdM5rdvXdKOm%2hFz6{WODdQ0q9gL=5HvOj&6;Yfnb) zFD;v2;u}e$=H9TIqBd$_oMaDVZBgY@O6&@Hx^P1k+>2>E?$pYh?w2PkK1j^qiyPsE1k=INkToc}iOJ)z=?RJoMSg@xRVt#$GPiOP#fOItP37{? zILuK&2r`uos%X4YHWrTWFK(Kfa|XIpFFa1B^!xerfBeq0A6SCbum?PeG$3hystdG)K4Fw;?i{# zQP;I7I9-SGn2d05Vka(Y5?^fs?TQQi3Tr1XsBJX3tzIB`R|&_#>Fw(7cR$|gUaqb# zY~N!^ol9ACwFJv4pk}rs4e@cK1fZ7MIF9qi?aBcyXFdmn=g)e#5Ftw-w^p_a#I62E zHH2S?WLRb?pWMfxlcJlGmSjccCZfto4&~y0QY6JxHmTW?y((h>>^$^~3bMJbOPbnS znEVu@*IMExlR!W{%qaW2gj7f=Ofn=CnJ6iTNbHu}1W0CO6hl#31{El>(gG$_ zG%0ZUM$8m08)+f}gav^>S(RcbR~^HQDzSwyj+3N~7DvUAuls`u(Q$BUTL6Q8gBlHTH2nkbCWD%(%5H}V~B6|S>uEgQVIf7d`OCsLGSe{jb z2Z>?niI}1-y;257auktMB11w{?|HbV1`o7Gz;u-q%s1SXJorRMP-z-f#3_iD(9#50 zY^yB#dLgQEgeT)AL_KBIM^Ff*CO#r1S$S0qvc9`8uPTunDtlD`Mfsy$sgekSGP16c zf*J`G&|Whd!OCl-i1H2+`jmGjk`uTb2E_N!=@W>BBYE$$+97$95c;asv3j)u7c z1qr2-12lE-f;IzE7WLwiJdAq1Km;?ErR-@Wv86{?V@6^l_!nJ%Ff)fdRNPFiTLW*ZNx%z9AY_9iS#B*|5>Nfo3!p4{>?lPCnv>5^nQvfEc;{#m7&<$vpOb40{4(_s6&|HNX^L6(os!|FyzvTOn6;;ni*8G#1ePTTHa!W^REN2B3C zUNm3p_;Lbk1N>Byxdk;dP!D3t1JjRAZrA)6f3=pxGPF4^Puj`t@a|4?ea&7*gZuY@ zmmh{YzraPD@jRTdm3upziboTl*&8{e3m@h^pUnAa0IxXwf~>h~aursH5vHVR6fKC= z0Z}fm@iF5pQmFtzmjtE4Z)T}QGFX@tc`ku)q}Q_Jk-F4!l%&uGCge=buUIOKl1RdY zFcKZ4h=U|4B?zW^np$a#dlFShGPbf5J9vQ;45HF3QNt*(W?giF8XRH`p~)(F5K2Ji z5lJzVQh~5Bs-z~MXq&U>35N_>o9Ci37qyxSf(ft{FP-%<8%C*eF~b39IMZ1q9)BKf4fa?)KVA*H+mF7{ zy*{?*=+vQ(BZ9_;fw{-0q`Xs9ROYm^4SnJ2E9vj-K{r=es&Z$=6wV9-C@-XJBHHLZU_5&YC^V&e9YUIf4XIulQjE}k?+mE;he6;nIC(nQQfB4US{%3#kpm}zAbUxr4 za0GtFMfjN4Tg^B{12}+Y75JG}c)W8(o%#sj! z!r{_=t1r2kU`9!nyVwvZeLh0c_^7O)RtLgwP6mPK8IYRVpJYv-cpS1e=%Xx0?4!7V zP#p*g3(rKrtKhYt$g;B@t5DGtjD++-xq{~mSRDg&4`PtJHN*XyyL6pP=H92c3 zN)nQUzFc!iGyd!#$tSVOBrmx}e3(f&)>0Bu6@arv1-(ovD@j-CvM&=R=xrY;6?!2N zu==dZmOltm0OYSy(nylXAsvatCJSVSBq_pLHwr3o|L~3^g%1L;im^G2AuJjgm28+8 zm8pcf5t5iZdi#U|jKl_uKyXCy5Bi*Y4&jxA6hYvHC04OxS55>=4yy;MCvHnvF2F1B zMr0zCDd;lHJrJx%bL3g@&@!JyO-uEYES6J$Y})0}u$iZmG48y$xw^Bn_{%@@BR}zn zciQ8BHF>;s%tkcB0iOz@u@4XpS+~mJJ%B?!Hb>b%6K8U`38vIm3^6X4itmHJ>>DA` zfxdxljM7z|tYm1`6S3yQVLV@ugxSfCa%Kq~{=n2*69W zoK;+JGHH@9sCT_!x$tm*H=~e);qErLtNG26?-h`wOgK0PqL_aBg8Xp&YD ztwjchF&S?XZ~(<>*c!zt&Oli(<;LG9@SHfM1m zqDSW^ngNkwe6pR42iFLau#S~s{(NL2g2v|GRA~8EBm*xs)8h4!7dQ|(lR?@DXxdT{ zT|j?u=aNQI(Dgv!iF7<#?!h;zr)DumY^U-gllTI1*lXobW%0rf2(S32&R`%*feV$a z@UQd=uIgx5J&F_sj#$w%aFh#N-&DB-ND)vwCgIH6Eq|6Unyw6Q`vw3v=2N*Sr;tEL zD146nb0~nWNmcDsEizPWw!okGKxdUOvtbr3``b(zy?^<#~ZDZTT%$z@&cjrs{ zrSzcjCkDG2ciEi`o{pM-vgp2wg(vO)gfDDW%Q>z5*oabKi=X^pK)^0RIQvZi8~l6h z%5Norz-EeK^AhjHv(ffs{P4l*d`=H%cxML{R;RZe3ylx=hIjYL-{z8%v*>nrr+@JG zO@7b!I`x0PbSfT9SUiALj!)L-mrU`;su+n0PILwam*;%FqutqRS*Uc%m-Vixmav3_ z`ehr`!!Yr2CAENKC$a-GQ2uJIMc?|ze0W?cB}`~>@IEzE5z*A>M-wgIXm9}l_oFeN zCOgNn?bAQ@C%)(B{=$zPPL8fmUNAl)Fa9|)^N27;vl)k*kyTPozJ`UKnmj}BfAT&bBUg(~48dcX)vk#Gb~VX@01fQLz{z>#yDGX4_uJXJ~MS5lFC;3&JkY=ZK5 zQ&GgHrinGhDh5)w{=}cv1t|UqTbCF}gtdExh_uEEE;PIa#%e7=PN9pZSG!Acyh=-| z+}A zVKs=2{g}>hK?9#Bt&@rQj3@&VJZ&wHQ1c1rG+O%r<|oym(-myQb20}|&KV2LR6x*n zyv6GR-lQQWYOs8f{c(_7V-n9xHYPkkTC#3$!j#+*Q5_+ov2?IasyyY*AM^)~Ji zU)M!dIslBQR*T0*WBi@T4>SQ()>~lMbYy?HW?TP{wub+B*?x1_+~ey4w&j=z=|fJP z_^i^pd%a}YWiw}dmmUH(;A^ZG#{;(WzjvP&O!wloJqP*+tbCx|!;V4B9pQBf`KHD3 zG6or3>#R=(l880CwKH#-Pa^rA1W+xj?X{xiy|`NhY8uH->0(rw(Ryu;=$V6@|llE+xYBCuyHC_QEL z=kt$f)q#Q@oPuC;6e<~fk{G5aYI4vR2$f1v?(*ev4@yWQh@$XQd&y@wPT`83?8Tz> zVtOg45USuml)Wjfycm)whr$>k>CjMHAA@36647D+$n<>r)pqD^=YAH9E+|eUnw7Tg zS_=^Y-C(h}yut@@6?)vX?MZd3n`S8FaJ78?V*ZWit8YIao}W+x?STWdUh`!-wyc>m z$%QhEAZ*gpHM3ds%d7P-E}GXYb00%8{J$}j-eae|Yj*eu z0M!F4*|kLG)M>_bclH{Qn!|g8*>rt;)}5U5^$;`MFNZMaW~FeN8PjM z173W*zHqML&4Q|A#5}yK>yEv=*ePhf^d%vkqAeEDEPQe3hZCFu=<6@${by`~Du}wm zha7EmXY3$f@?za>&1N*Csyf22NVP& z=vJ$($@Iy~*LT18aCUD!{O}+A_>aB!xBk~Z`Ec+0>eZ7GqZP^O?sfZ~x zgcPW!V1A??=*=Xnm?+9cHQ+%e-jNb@l=_BQe+|K6k9b%TDhjAo<)r$;NU984Lpg{NL9Hd9PvR(9LN9>ANo*N9<5_4C$CcHS~ajl3&l({ zRjqq@f}?(^0d4Dfv%CD2HB;Nmg5-m>yWcZ5{T$7)%nO#y@A%1vEmc zbt?;G4Uviq?|=uMREP-H^EI}RlnOJGkmqI5j9pU4MJl=21SogUk*kA(H@Wp!uboP%tr&EK69? ztP9I98zRLl5|AQ9u|~eCGDOGtb!e4f8i2WGa1rnEx1Vf2kKuL#^FgU3G;gR)d0Zlye$ z%eUy38mnkDjH9|xm{~h2$YJ?{po1K`y#hMm5|z*aJJQ^z(Xc$fVheC+0qETL^Q#px zjHc68qCw*f8CD~@RVa&t(S3D!xjH`sns5DpFg%!HW4jZxF-;2W!Du2}wJR+NaJAO@ z?J4UFZFEAFwTn!zpwUB^&I;{u8~xY~@vLtdAl3`Ehuxj+?sjMR&zixPX$&zth-#C8 zUDSa(otMVXEuAjbu0){4mPTrKbPRX(jhU0-GcL@(}Zzyf_ty4SD z6lLK!!=kfo-gnvkV*)$=!(#UVpO704A3vPD^VZ_%sJp&QGt#}aX#HQXzmSvIRdTRw z4xvA7e{tUan{_*5Ir_w=KYBQ&h&ey@fw6=hj>Ff?A8bqvKPgy?u_I9T78_tj%p_44 zA|7AxolYJ-qSRA(hY#;s z?t)Kx-Hs-_Cb?yr|Ip2Mmy5G2?1kV=7EES3agNu6W)2lQ<&)Ai=cC}hE~Au`13PIj zd4V?8vY3vZf3gPX2DgFeY(A?q6|lV_)AZ~uGWJvkVy zF3#3Z{+}QI!;io8cmDey{N6if&%ch|qA3%N*1m;zdMrsGk%|I3>15 z&eKp{mUh{Q)@vuPl&aM5kWIk}Nxcn(UVVZ}AG^wd=-dedkR&~DI!ItXNhAd*U}M7w zrU`Ng!cj^99g#qaG1WIz0Wd5T`D;B%*N}hTw=3416+@VSgfw?j@IfC68Wj#!DV`-n zUsuc6=2d);iuWol$@vq-Lo`&9YT~6KAhE;=!=190#6CK)d87}$HwhNfP=vAK@x<^^ ztd4~7L`j8bq4dU&Sk460jT{z)eoskpi(~|dOx~-1B-#idWqFjWF-Q>!PoxDW7B?#q zE@#1uj(RFtKj{=o{-QsWy^*|^{x&8SH;B4c4-qgUm9Mu^KmJxp6|1c|Fbu*N#HxVf zZAl?UGjsNb90ErUbJWz3Hjps(h$yHKYUm;uP-1I-WiiaDf3Vs@GcG`;_v(9Jhq;c4 zdJY9zWJO9&hOV^DpNa~6gw$NZDZS}DH4K}-Msc8YPha(W8yeX|=^+3kXmG^~F(R$> zp*AfrpAU>oV?^lB`dJ;aHvo(f*dFYsFQ~Vh^F_V^^6M_t)Qa3ZO95O$=s*A`5k{9wRT61e=Pvr{k4BjT5mcNy!|gH;W{o88+m&*U3`iHqoY2 z&efI;dl)9f1Xm}oe)ku4|MuVfi9hsxgJ=Kt7a6JIL4SKa-#cvgAJ1MhH6^>=@$kN3 zf-<}QyX_$J)DhGLfsE&~@2AZYdHHRen3wH0h=CK|`{h%zL8RAF`Eqe(My@YQxd>hco6_ax~o z*}g$_7eUe_fDV<2Ie=vutY*T+_HOg5ZTm~qrR;M^G^;Tgug3;VgzlQxi{_mDKo{#9 zKKFzewBdgHE6s2IdUJHr&97_+Fw zI>9I%pqxP$*i>=INX7(-5)+BBWn7_mE0Zn3kT92UL)yMVNG@ch9=DSPBoqZ;((==- zybpiU$Pj5t&7(+|NH_!|QW5dFV2XY(1chW-p@@W z)*PZBo0l}G?RH@$dTb{46|7uQwkm4E-a}tVfjj{pHptqulb2weU|I(hM702`b*YeA zL`xM%1@{OKAt;a5u$D?-()wqF8dq0ii;PQTlJgFDGtAFgm&|!XN$2^@eGfJoJ6)cV z%Z67N=3v&`y}#PIr_L8AO#G)T>eov)%4g$$ySmD=Y7R%u<+T0#m))%~W_Q0V{ zX5Qi9G#&EO$?5vi82~44ALoZV`A0R@9z)pAGkX|gjg?6KcDscN2lwH%kJv3qkGK0 zShUh;*|WHq0!{{zFI=cAP>`AmGcqzyiNGdKo1+E9-lVZ{{6fB1n#>_!Lh4sTHr%Xe zL`>#n+}~Ql*Kd5)#Lobe`H~s%O+tWpOF2G%eRVTi9{k|vnwv|zM8oCn*Z+?{@cpB| z{R{uy@Bg7k7caj~uJC>pAJM^ddh)Qeo2y(NLt4Y1smM$%eKE&PkzzyBH9pG*o>q$H*v7(E8j7s)-P_ z_A;k>c>ydGB{hkE2>Vnn_~^X}OSCe%=qsd6P8s(07o7;f5Kj1#H1a5NGCoW-hD>^y z6Gse3!9mkNFQURpxQ@b;T7F5e^od?x6NBmCMpZ&+t9V(LP~iv4XGNHKN2O(nAI|0+Bs9=$wV8~dcm7hbIFuH;Uh!i|p*-4Xm3`w#LUYNwq z-Y}I~n3=C6apQy5TvU<>;yF^lyyU2cBj)JkCo6ekkQ!oV2WMP#a?uomTdCnFV=bkhAARwAfu*Ws)&EX(sJ^K zr_BP{Cp~GL_yMgrsaJyq1~G~k`id1vdQ-~1Z%~9bHvmY(yxZ8<7-dN!wkVm!6p*@G zKsni$AdgZ+fR<21GRYEXc?aF*O)p3osiG#q^kKhoLUmM}MDnoU4Yr@GVKe>Xr~kVO^S4)ycoHaB_R4JXqr z`U8wXU(+=pyIr2xxd@nP@Px=E?NHNjY@NrnJ~XTyI7qkN;SIYl9TW&PQp3PgV8hyh z$MJZ3#`b(R1LMeR#tT=g(avnVzumEn;EYwXtKnpXsA#&lyk>iEI1YAqNBjG$^ViNl zo{Vo_9@CWBy1TPDzHBb9XU_>RP`-z%y?7NsThMn0wDujA#!zT# z!x*~EQ-=?gt?pUnK@ZW$5K1xOE*=xJ8wni3RfDHo#%d(+w(bb%N99eD@F>qs(A+aU z^yKA>bXzYF(GVn%pL%36(!4AhgA`YO~DIV+?}1!;v`5+RL@625YpE|Py0zZ z7XrY0PK}qy@Qp(Hv_FfKr2xY@v7KnjU3TH*e9Ip8NXsXuxS_&g#tv&$;lVqy97Z#P zhQfSx$$S)in@Mgu4Ac5wokDi&V7B`Jeg7;?ZQ9#5<8J4elftU$(`w0bDu z6e9N5Y7g(baGkQoqUMV;=C|>Vi#mq3$@1IB9b0~pA+xP^HX?=9EUVWS?Qqpy@wKtc zYNBJ$n=?e`r2%W3F~aqN9HEAxMqn+0S)Z+YG&f6#SPz3;uxr-!as?%ImksM27(R8n znPncEzq*_^4r`e;xE5!-Omv*6`>39*y8QA90Iu%ka?1*+t9_0N<-R8&C4*NgOgs{&)JQXps0LryZV5QVa`5aXYz1wxW}SImQ;I;8e| zR5PG`i54;>L){b(W3&qrAVYx=AVJHR8lZ#|EEc2}aRSQOA4+LF`h^Je6vu7@*{6OS zf^RUYga)U`D3$~;9n4WD&o)pt6qH03xMcJSu)d+GP(v~@Fz5lMjx9#KJ_1C{y46S= zf%Q`KQWlidKDt)M&SqLnBoH}UjKX7Mo(-8?`@D--il;(A+x>);nMa^7dV$N7#H*un zM|3$514da_w8R;y6n$QVy0Z0T6-rZV90Ce;7|9{G0C;bd0v8dZlO}FJHz%$DlDo(s zf`OCn?}SLID)WmnF{XU5r$X{?))>rg&%%`y21uvTS*WRM!cnQ@&Lx>E1u4loSzjS{ zeI|3swW z+sTgEz26-Ah+K`4YSO$(oHUIIPhyn>SBuh~s%8<~JF`~sjRMB@$RwNHn?sP~ix@$T z>bXP3+=P^Aie)BXt%Clf)PZ2ph!{O@V4Y25ij_No;1h~0VHZKmF9K!*Ou3axu!NzP z+L!_IA?=C9>t{dp6F>A<|H^;*_WbKFzWn83yVI;j%<;h>Yzfk>Zr^?Xpqo*s;caVa z#MUCCEuVs{ytS3jd}T+bClfyhKm}r566?blhEdvnP1&&?9?$~N=Qme0&cZ>NmbW6ad zJ&yd>*9K@MTwc;_(mLCWL9*@Xx|^~C$)ojupu|$6e1-0d#W`!(D%k%*8ah zYpQTES5WgXD5`abXllVY|p8}FnUaTa*>0HKRch!&rM-j9vOZay@#Ue8{q;C*J zWmOAFMJQAykOn3Ayvy+!j}SOHwT)tfo5;uud$8>-gc2~qd)I5El7WeMHtmaE$*S=M z2gqN-^Z|SxJH?!rX3g!5dhv4-yE6KRK&(B*(Ge$@n2V8c+PLj-HpO_|+39e5JecjQ z*+uH?)qoWyS*uEUp@Yt}GFIEtTO2NF{Wn+J?U&BFv*F;qJrvfaE-;RkV;r8aQ}XnA z&wlh)1HhUr(jT)nMn_yVpBp<12rICn2hr#}h%?=7hRnNbS%JfDwgZ-_zc}Na8e{+K zt2y%r>9kTj<%;3=SavgL*|h8W!f*W1+o0mP<}IcDY#7o%A519N8d(QoY7MmkGk<&^ z;s`ylW(oO1xvG)?7&b*=lc>J``7i(Do0G5c zLUqI^&unE?Q8m-y>ftK)NI(`~H&$h(aH>e!5UQfD#J8fmCa5Qb9m5dPD0)jz6&#Hb zzmbm~R;h$YM8(AM*ay-S0s@AzC;7niT>3C5gyhS` zIIb9_w^YzbQaJ&Hr~<6ia#Vcs-z)!C4J3G*GdN05gvg~QG1$;_5>iK4(etO__yK9L zDMDf@3|FbYl4IrkV=HoCw zLE)B2tUOAfhu6i-RyCQQYKY#-SJWqWhYgGp4Mb8@HfKvyOidzLHa?s-I)$Sf)( zJjjm77LK1ANj5~xNz%l?FzOw7-^y-sRC84C^RuNEP&DK4Pm`_$GfA-J( z2Y>m`|3|YY|N6z3e{E~L!=SzEYXzZY$}WW0_a07WkEYiw#p5XpBQ2(sJQ1l_nGnP` zxo-ThD9ea-8wk*fVcjq?)l_C33V0rwh7cfaWoYrhbuBT2YqW}a+>a;Mqcs43}5iJ3lIBZp(Qi8Hn)Xd3e44gL;XS>6HxoU2hP-F(#C`InZBwweS=~rvSzEq&D^u~HI`VpNd0D~{kx~#$)J6Y zui0U=wDM7essAo~_a%T$e;3YV793~lAxfX`L2T;_Lm}fsAuP4|{G{RRh&*o|+?t2) z6K}Ws2lQjsFJ7=xzZp#z=eI3eir(I^pk=VnH}5!|NLhxZz9u1nam3g}FINWf zv5aYvHIXG=h+A)%K^}rYMk`h=k$}PnONQ3d`ZZuUB3`TODxSoAO69GBh8DJT4HXPR zOdOq9E7%?}7O^ZlWD@`lCTu~#+FMR?h(4dFBO`elBQrFPApj?|xzR!(V<=kyB%jynFuUi;k)k82w#YSd#x#i{(v8SUGeI;3lF8gig^a4=b9k5k zD2ymd7Mz}k=rStcBBIWMsl1dUut{k)#;YX)nc^;wvZtob^UuW1gHZZ`O|_%Z`>I7C zs8OFNfPz@AtedzKMXSIynJq(8!&FRjMM;S=+J1^g*a#iSQp6l`upC0@R{CQtcC_h5d8zA7o zJx?dTam6<}ZPIHB%uI!f8%A5+@mG7W>`ywLK}C@#EZl5vkehgJR5D{}#n=eWlOB?; zOU^i*8;4^dx)IYUEctjRgKEy3hji;V0fsxX?&@ZJeKp?QS+ZsrgO9hC&tKiVe6e-+ z&iFgt?PfEah;EHS*vV*q*LE{FVUMJC3OgG;=9u&lG|x<5ikJu7nx|%l9R`UTK_6nh zW?1ubXZV$?_4lySciGHM>aLrXHvorQ-Ohr2RBdSuZm*hee>8gU{g#f(%j0%_$+r%g z-R!R1D36(nluUQ&<)YZ1(w+A#yteoD8fN;LlENvm0MvU z&VYC-@I2Fdb`nYwW#0-Y4?dVn&@K(>x@*rUl5i`iDkvJZbC6&D#3zNuDKlnla@k3s z0EV1hJ6^h}LCFsb-ocHgG>YvEIBe`Vyt8w(CGQE?uIv8Y+vC&KH=mB*duNRo@g4!c z<9ra;sEwN!4Jim}o-rr3 z+|eu|`>El^O#d0ZdUNd%GHdQA{yIaefkJ@Md@K68rAECeY zGk@vtUZ360_U|oN!;q4oRC+$V4RS;bMe#5Gf<|$c~oVG&>yC^Au7(q-ko|sQjwv!<$|HOt9%tT9(HteB@)*>E` zz^Ib;F$1t>h*$#15dovWXog`S8IhGBwOTlpY7P`86yp?&@DDwk>>P>)I}5nPlv(eE zcA8uGK#HVnLV#lR0hSOkNC3wkyLg0B*b2ho ziCV@e0X2yH(ZQlzr+gzPX}F}&5pN>D%`J&yn1BKX5LqBi;bDx7diulw@1IL1q{J`g-Kd^a z;?N>l4<=Q!HVUpJ6MRG3`ij`x%Ug;$2v>e24%doFWd_$sA+*1U2X4H_VxYjLz$$L# z*a4|h7JOqtwKv!Jg`hqc_9d^D4o+V_1rNAr7TFNCiVCJeDiP#UhK)4uaYJ_@0W3Q9 zeimE_$x32j#7*z6N{+@U`4TGjVI|>+9^t@91;GVYN~eHcB1Oy-QAObgi1nQ`U}=N` za2sSPZ}h38Najgkz_q7242s+kz3gQwVURIj!Re03D1&nDm>RyCswZbDO$8tpN&evF zqaGGeiy9X0$_Uq2E54QuAPJZ`So&sbN0^r)Bo>ZJb%2}ExRK( z4S0w9m+LW4bcD@T8w|U%`8eZ`Hrkmypy&$8k~)?i&KN(}uq7uNXtph6%K)|l`$pIS zPJs}1%nJc?L6hn2F=w?=dtE~-Bj~B_@RBi~6S{r+V(ak(dneb|Tg)w<4%YO(F6M*% zopx`#o6j9P-#-{0-i7|~;b3@mvATFYxHwo1CiEWKj@?E03NbJIyZ5KfU3xlvyomjE zw7HEI1xF+XJCj@7M-}or1}3X$r9}gEM1%EuXF7O6wRzipo^it)iwf2?|kr@3-CF6*BTI2>IRd(%-sceW~a&Gi; zVxXw1#&E?hlCczNDV%^SO(MGlAOLN%p2DDY1osh^G{cA#yhs8OXs66626l~6We{fS zqDCPFn9nEmM=MDap#btIatbJFVtkDCbx{=66q~wMFhxNPuGDNPlA>!b`x~}Vd?91q zB)fP`_XWFzZ=h*^V8D*82LUQNM;2)he zUs<%@^#FM=rk@T&0Xr1QFLT3$RHd-6tSgexzMW7p0SJr+tE=@FC*8Z#ydT^0^Bcgi zMJa1)m@desTg%(k>hz>NI32$A?&9e6fXzKmUU$>+>T<~ogaL2I__FWY?{xb!MhuqE zPFO_HUD0X39ZUv%wF7S%@ZJrsH-0NX%V&gv9kmAY>#^%=H4Q#Rza;$%UkUR$vLW>@ zr2~;MUo>I>-^NgSR;f?PTem2{#mtf(3UFHgjE3;>lX0H%Zm&dkum;4B9q0?zNAuh6 z=4G*}OQ6U)d%uY#Cf~h z;;&sCV@n-d@_>r|qV$rW4(j!+%uVgY1ArL7prh1q(=75eMtF}HKS107XB>&*D;{!$ z3!w;ve@LQ`D{mqP{6$v|E=fn?(CJO2(Ti{hppZl=3V5Kx6B-=cz&`YgaLzIaLSO+0 z-^A6oIf|5A6gPA=wKb z^9KN<36(^BBY|*?T_KtLC7Q_OOYty|f*8T_XbROZ;lu%dZNy*bC8I$pc1jzlI#)2l zD`>#tjsz>mNRy!2d2kj^+u4&vDezQ=LoK`#$|>|rb~s0VDkY@a3Sp?fk$WP&LS36g z8i8USaZrlEMeQs!M^8i%gzGbxJnZQOBv55mf>JS8LRY+kk$mJ1+Y+Fs50g^6uP49= zWR&h@!6I^ys4}Ivmz2hXFHo!NJgaHeWOSdsa=?oX z)h>p!vBGQzX7w;Y=vxTp@zY2F=;nIy>S#2bw9_fyFGD5TZ+y~?B>kJ!`u=qA*(r??CpI|OpE(kl9kIpd zfeE-OV9lCf=SvvFmLrbE14)1hO>}{f(VkG(O=r!Ear4w$EZ{64W)HIxfCa%Um8921 z<-tdo*H1od4|m5u_`AD<{nhaipF`pm2f08)UL%vIOtgZBxo$@2Pkg(84gfO?*!jo@ zZRL3CVbZxr8m+D8@sEk(ipcr#FSAg_JNn^0icBIgIftVx{VW zzaui$OHaALc#_Z%qfsTIqKU3-1P~aHBDySC>4EX>DBK0^MT-K)6a`3FU;(otQh~si zF5x3XHGrPY18%8uG_mh)Vj+{Q0}E0>pI_!>|LoErSQRknC_YVIcpBTS6t0a_6THn#hfg)>c9+pcC`uP=X-Q$7QgY;#W%jirvPZ;t)4$?&tCJApuKx{ zaIo(J9*QewWAe?}#rpJ&qN2%HET6w-Um)M|VO|Hp$pUM8zM(-jjSlyC$*|QaJxve|uA+{v4;&2$1oFSvAaeTl7gkJRj$AjaO%hkd3 z(GR_|;w#Hmebqr_6cc9rsP!fTV^(6=H153#XyrX z3aWsCMlDIGop~xZ;jQ8dH;Tikc8mzDeQV^11!N-$?t+<%_ma<1{Coc}j_gf3O!yBKO&Y0plDJ!Ey+c-XlXy(%nlJH93vAgdmxKo z7&`1gx#ywgz&hjLTcg|aWN@3%QZ>mSM36_lDEPvr$VjRKNc zn!7+ihl6~qtC4kkvH~sg%#833GH74rvChJAu#|D6z?7YIe9kVHH2s%+)0d||qk}Y^ zkfWn1Jep0r`BiswIo{uMt)aaF7Ui*1>4FImgM*#XTlXQfdi8w${Ke|!izR!cEV?b` z9_;L{hFdK3V{Z{x^|k}rJ>S36vh;xgU)x4w&J5KXut~JV*;^L|5EGbc6}d1V^Py=4 zX)SKs^=PMkw$+|x=_Km8AL!B_bF#H`K8@6zy<|ES8ef0)x0~h7=)ocA?0#r1G9EA4 zYn5G4IeZh5b|yCDBh7c%LsXR3iG_kic(D5o)^e6gL`}J}_`_3b01%HZ zR<_o2Sexdv(6I@s*aJ;fOtLO(YAIcchEQSHor_*v0ArAyn3Mz+@|^++Ja{lwU*6f4 z$60OknzGlFFWLsfZNK}wn)79hdAmCs+&^4j-L9TI>z+Svj$g8rmIfJr3^yO&G}o(U zcc*>lQwJPE;OAYAdR>TBs?Dn}6cS;Ub#+%3P^~vEvUMc|{tM^Kh z=+fk6D?J6gU^IC0^7zj0eZ2k7*82QaGn|l3^i(Wnd|QDzT~4gWA(q2#&b-9&@bcn= zzyBlu;hn$n*Z!-|yfwc({*b=B-T?;d&j#(zj4wQ6}t26PnZBg|e2D=o?L zmqChrXmf(AsvGh~1*EWfuAAsjbgg87zeuWujd?>94vGMnK8nU6?I~iIA<-i`0%LEO zB$!IopP)Q2%FV*9qSFu+u>KV>G)q-(Y#KdHS0Gc9P2PueZu_KSE|PFL ze{$-@?juO$rKLnlK#2 zHo_$`a*_tN4cEvO!NV0&;BKlL*$6MGaM5@hW6Fd?YEnwLdXzR5<7ZRjj#04OEUc8( zQYuLdK#k39c}B=d65)77?3RysYYz;9^hFdxRVqki#4CM?_s5NTY>ZiU0WmcuP%8jqEF4B5*)lePF@^}90AWjQ z*}{?$L>Phx^S}#1gpq^52qHWnTT+88wR)`XQdf0V-FxOC=S+UT|F`p2vrnGPwb%OQ z^{sKQwYGEtFI+;zgY2bYqZG{)*s0Rw7vj-a;k^gL=3h%#Jr{}4=T5I84$7P6OVF0H zGRV*0BHR*Tq4{8T{^UK6`v2W8|K#_7ba49X|0`{3Z)@a%Kd4J?xQh@swtc2VnOn-}>t(LHJ%a8jzU}62MtzBB; z>vR`ACMqexoc+fV1p3P7=N#VCKiFGc-7aUd9vv3eSg-nB1}5j+?5_X8h4p)%GtO6}z|SRq!Q*)h%Rm0Z=k`KFi4d^9|$S z}nP2{@^S|)Hke6%C5BASJ#Na`XdTGxnQ(I0(8>sX_b=owpOlbPPNBM z74y=bDn3H_q9U^U2_dFSDYDc8tS00+K*Ng>FK?#j%hezJ7vA5QoHloNUCukwGa`ZB z?jkoG3<_*3?@asK!|rr)_tjtd=RWg;yTAPB{^-B`b8nr#v3vgoo>3^9{tCQC*Aoee ztB+Na4K$JoU+Zrgv9)Ngfz$zyTjQj+rihq1gOyj7z7~-Tb0I$WQ8WzgH zf51YJG&#c?S;z|gnR-B!K+3^?Tttf!?R+x^FG%@=w4o>MP0U7R$rpc8r4kn3VG>iN zEX^ViMxceRjzc^k#VGQYbggJflSJUSqu^T|R19`h1b+Z9%$Lkaj_30WC~iY5hV!+O zY?zir($oOTUWSlT45nVliD&UBuEi$k)T4vND2K_ zKE2SCVX!tuS0tDe>wp*xDY%dugo%mZD%@tt#swl4amjNKHd=_$rfJLstE^kbO6NdJ zPbI;X2VtKIM(wDpFp;kA3cLssO=PfwA)N9C5-W-6o!?1GWdXbz7CC7`fK4((}TS?-j6QnC5^f=+4M|*AtEfWVUr4lV5F0%b1wXF zFVXl$g2qY{E``Wcken#JG82WGm!>#i5l7QXM)#p79llgbg=sCjBrbE$sab3P_{|$ueuKSBQnHS%JL=!`bEO2i`OK zD?k4yf8b-oC%^H(t){H!8FFSO(^LpW*TVG}%tX`8WbVo?2oquSH{1qydp+I0-`#r9 zzqq;UIoU?*Ph-K!d`w%GK+4Lj0ljOU9Uux!@mic1Dtr))2{TkN4Ks<#nSefF=QYD) zCiPk061!+S^oi?2+Gh}>VQ+88Sv#ig;`i!l>rOx1SXM;%LIbw^!Erj9k7r0o!R5I; zPa=A|JM`n3`==r9@A49WC*$AwV(0qW1qO@?Sk}A0%d944Xf>UVUV6Fzp7*V`cqu8z z`q+d&ztwq;Lw;DJ?~#KLu7yA@0b>hS0-h$y>IlHxjZD0D%CYFgXN9%{00tM! z!{&^&OEDWOGOp+AYjy^6l#!dIeREmo_H1i+YjAYzYOJeU=RQX}&F(JBS$x!ZPG(Vz zm|{HpkYWphRxDMousx+-P`u^(jwfrq zy*<~RTwStpRt=v!X?Slgr(>na;93`Bj?ip4l>bYM&g;wO`D6R~nbdFgMx9+g+iW;@ zzMrk~`#X$?iTA^-|IV=4-!_J41q_2JG@N9EZ?kJ9qw(fdULHI$yR4^Nio?4z0NP{j zpvzX>qaBsvY@f;0g*^v5916t2|6L9SJqb0GIfMy;wMmFXpfT&;g^X&%qUo{*btmWi_*a^EdSbi3mbIkUt4i zU(q!4#FD^*$217fdkb&A`hR@plf$3;{7*f9GQGWcvp*O*uLmYL5kO7jXCY}QUagSC zdz&bgfgu;Sgt_Xbz)Dx0jaW42yY(!7%Lf4wiX?s|LlaOGjpc$by^F|&t>qFLp+i_3 zDGlWPmQJt&Cqpsq@d2oY@~a=fh_s=wFc#4eC=jq(8UZjp9HcKqOC}UW0~mymHZ9#J zjT5^NL!4Mn)Rd`=33yA-Ta$`NIfWwFHj3}1P(Tpdf`v#i1}IY4d}+;CLI$lpRi6*& zm@)LU7j*Cp?!{0_5eqdWgfBY?#kHX(iatYGAP!1aK}Pb;oqDK4=&4dzkO#^xSKYP1 z@b0P-Bh4lmn!0^-g#q3JLX-#knGK}|8uUtN#gje!l*HtK)U6KC!UK~_z!pM6iS^!K z-5Vt>4Jno+>WWAOCl?YZ--N2<6OmrC1`L`c0w+1(D>EdO(q_A=H1u*?sqUc@(xWd-o za!Zu2Y)G;>m|`Vaqzw6RPxeTsoCh^94jGC$LKJF6x_H^jh7;C_=@3S{gk%H}(TqT@ zk|aHdluVhJhgPZK$QM@zyKvlSX6IP$Q44)q&dFAtNEE(gsV9e&E*N5wHsqtK>{@LD zhb}SOU^qE@^Lu{Z$=~{0fA(MbzP)$;(XTK&y|p!3GTF>LfOB8$52UY;y%%W1cRU2q z=)4ods+(rk8$Wz?=X`vNW&6WE(`qcm6wAR8>Raj{JF$k@!?x8tQSx2{>HZKgaGmrR$w^)L}34wQa^V^&G z#nqZMGtOc*t0{Z$c&X89b$)7pX^W@xodvspr_27~{`M>Hg~0MFUt50j&DHshV-K=# zYkSGtiH?uEFTAqcKBS{T|C$Maqki|jEPG&`^w8DMER7iTd1nzP^mrmU{8|4)mxvY8 zbd?w+Y`H?(y_-bVav)|8Sr?s2R(plro%P*eb7^a2w%#tAi+Sgcb3*4VMCy_a%d@wb z*qq+5S$M*cgX(j9v}P&A^p4hphZ~exj#+j269Xt;8bybWjuLagBr{Yo)8jK{N?Yk* zuW}i5Wq?PD-5|0D5mFj(uZ>S?+|(vo-5Nss>rv)~1;7l8@F9vGHY|qIxW(t7;9!`j zI4kxx&kR$uS+FTDDKcO~%!fO|C^=c>9+9+d4qlOj^}Zg0TbEo7T~lWwCpx} ztJTN%**O3!+Yu`v%re?b;a}*smd%RR{cYQPF5S`}u9))i8E#8?$nc3?-y5HZ~ zTAiNvwmHk6SCoyrmrt9kQ=V;LycMN_+Q5Cj>;Rtf4AESt2H;(V(-|8BwDf$zyR^+Z z>ssgRC=@I`G+zNGN41=0=Q*VjxHBb1D<|55NM>-6!ow1FC^<1_ja17ju%(YgmMlo6#gGN%0gP@hJN`!K80~9W$lzOyYY=xO5 zY3X*B4k3&+sFO*L51N{D+@W`n5-CV1ArfTuPL&iFD5!)JH%3a;I0+Jg99)vkO-dHL zHEGM$0%Nx5#RB`I)WC-ZbdDk)sVVZ04f08Aq)krYc}G=gF)x$I@FRB#Fz+bq!JsR}}eSLBFnS_mHn zM9;N8F}qbqlW;w|M-MEkEr6GwYNXaM#YjaU!C#UCCKUfdCo0yEs)k_N3@uC|v3Qkr zNKc$Z%-XcEa@tNEGn9qRL+WPl%EP&gCs`M5u*qyj`^+B;h->* zm6dJ-IaDD;$(VRu{|@^Mp5T>?ZlprvITDK=wNt4<-rK1yN7QHiv2Q56NN%95;+ zImi+bJn}|-BDf>T%#QwqCFldPNNqBz21B=##I!P>9Ab!83~|NQ zKLRC}pkn|l20XgrMMF;A77S?=*9gE(3Y7-NUQQ;3DWJ}&l-<$R7PPAM5XcfqE4I+~ zkuGG--w3tg;j($@a!HlwgmeW>)lyFdsh%d&2r++SB@!zD515{SI>Hm}LqH`9t61Zi z>5^WQ)g4^43uL~7h5x0=AUz@!t4)R~n?{hWE}pCrQgO(|@Qp(HtRpi3`S6SA-uDLc zvp2v0dtUhYU-)-Ee*fz13%|zurtB7Q<_~agyQ7amfTG}&=&~vufBlU&+Bh1(ZoSEL zvj4))>AlYN&E#O06GPa5xMZH4gG*?cIOT&zGh$^Ou*DtH+ErhsY1WELM~4U=NC_)8 z?(s-qI;E;U+@ z^Z7Iyhoh6>Y=s;=c-V28tJ*a>J^Cf>i6t2;lOB5~n39T5FxiJN^fc5o8zks6kafhMB4kj$ zf5gHGUR1o^Vf?b}OgNu$zUDj>jy6~F%kwqoxYLE=pjA$79FFV&Upyt53?)C@_{b`7 zU)S8QPHRCqd2ze5yhT2ZNF$2+M2afp6)=B@4ND+P0w}>(X@etSicOhO*$@E6x#Zv#@qu^b3m(?P z`y;R%;ldq*YMrwb&9}md%P;>nGlW#oYJss$*0u-|1`q{g#(S~AK!iMZ&H59@la?>G znp>~(B#r*;%^e-?!SOv72sOJb&Y#Us&zUA)b1W8zO-(4JozAGkp`YFT&Z9#H0}P6N za>aO+5A*u)_x;us*mNauOU#lNSL<^0%(Eb_JHTCIKI}?y7|+%(4?2%WG<+6t-AJSM zSHlB#|8pW3b+L=#naUpy`h)rEjnn4d{@~Hk>ii-P(fW(GZ>WrLdtTPTLYmdh)sl_N zySoyhV@(w^>a*-;d2vnm9noCUgTB_usqT|KlvCXbE4iS-E{cKVbomJYnTsLOmnBd{ z;yq-zUP7TDpL~w4>4TY$I4Z(OIt;{_wBR8C(IYt#BVp^Ee3{MfTa-28;T*7FZ!ybd9x zqgPn^Vi}nu3<>^QTK$eyP|utSYiI;4^^D{o97u_`s1*&Evf-Js<2RZpb7JdT)KWky z0rocblw(;>7DR>-8OjaqwTLo>qCR1O`-*M32@tk1vK64kB(@X6s!zIAwMUXLv5kkM zKP{6sq(ZGoP7Ot-=pk$A22oMqthjvp^9&|og&|4-SiUGwE?Fs61X8KUZqg=i71moK zk|oL_4q98`6(`ZcUO}TRSqYw?%9vEaLrqy)53Kn{m_wq(AdN`0`8Kh#_ z1jJ$6T!lr^&5wHGZ$<*@A6JQ2#?76q^c*g15F;4OC;6ZR5CV*N0I8Vp*$^vu5v5Xq z1|zeqG?pq#SKLrGia5U$kXcYDW+@NA8xRw|mJ@7gr6#&IizS0xVn~5Yw#iu`1xpkt zFoPOIu+w++1zN1I2X@0ftv4irM3P90B;;76R483u56l&2X4^&A zc4kKMPihKRqy$w(nsSvlbO0Sjm zKQ0?U3)dQyv;>$;TrNkmgZB@we)INl?}$~%>nUArR-@3*X9_x#nzo@#$TJ0=-hT4V zdV>BdZ8y?EF=dUu0i;V43tG%b4D;XFMo4D6@Rn@^q;jb$ZMusAoCbppGHZGA$|M|( z?z}BK9c)$v(P?1ifI|!pE@2FFdfMYWa{4>n!3u$~HuL!hM;&H3!DZ5sPSoW!FWaJW zWEW)b{&StnZ#5HkDKb>*yfEy16WK-%DD5RE0V0`GIwe2W)c(@QAU}GodUT%19o57F zsLwD9Y5CYi8LWCI4HKF}M>w3~)46l46^~6~6JB_HciF#pZ~pX>rN;KrPM%CFKM|0!0EIFrM6fb{p(a>vtmVubokY7UlLQHo{Wy{LW+C~5x;b~K%4ZdStB!K8 zs30#eB8I{uK>aX{4V{Hir zHX{^Ol;y>HuMRs0Irzuv7QEjX^1UuE6&cSxJD1VO&d5E;)75&PX9C?09?Mdgee!3D zU%%;L%re6{H@FW@GxElF5Ya>;#;oJO*oE}ux+o4Dp^R$vcB7|{ryjW=!bs! zzxj(l{wMyk-}=()`}g1HZdWE>>}$ngq^4ZZL?*plzk-wu_!G?ET<}Y*#X%TSg;S$6 zh#8RXR>a3HcoLXu$WiZ1O=JJFW@D}h$6dA-7FgKxAz%iqM3M`5d z{tL)AS4_hF1|gA^v0+Wk>%>$?x&Yp zIarcO(s2UmS42ccoizj$QzF`|(ha~rxdEU~uQCRo@rw(AV^ploPcRZ^2rWXI2q_hD zeu5F_ai$3sv>Z0~siyTr80$`&L?5dvKDxHp2wyo7*OjKA#lr-rNTQ%56j7u5o4ZzG zk|IlNSLmVP*i=9+=<3o4hCKsK3OZL}edku&ls5r@D{zP4z-s#xaih775YSU?5`jr> zdsFTby@FY|5vdgj1zKAM9`b4>7ow?__{J-kU2REW!WbAB6wsbQULih>na0}`^FM;&4b)OY#~Ne*QVE055qyarPK(BYdT6eP-gR=OmW zl{b2%k_wKr29W-$qATV~U;~daaGui4$Bqju@5SOxA^A)(rA`8Lt z!_0@?C7nbTL4=iAOU`jN;QI74Fz&h2$dSNw;k6x27x4D!Va#sb^QWKs#B)FYSO2XK z?>@Qw?O$hetOoR`9~zhWsv^&mOW9#m8IoW-wS?$hQ zX753ITYYRn9~+i*Yck*8=d}Q2y!cU@o`h>!>~Xt#q1Hp7i$0j`0oVor(uom8TLQ0( zB9-}!{rfP|%sc~EKp>#xD24t2K7%TDSU4)g_MTxjZ%Lv{!R+OH?#4lmOT<`<*?KbN zl<~nHD;Ty}Z9Kc3&n~7uzt|l$ca!zy<>+vK_~2wdUi3M#aIni#0Eofj-k@{5Uhnt2 ztdrgub#{1r*C^+u@STOxJj1XrHQ-1?RvxWA8#GI$ooB7n5^IwHy9flc&g&iUCe(&K z0EmX+r#=Tj4a~(-?=Huf@(Ko4S}>d2ncl3=IL)2+ExV*UCD^*wdKf#i3G)7+d(>aw zT)SqeTtOeiE_y|bT7{C5LV(N!mqY@<@#7!vL(ocH6fpTX2-WRuR*X)HX;s2DL)ZQQ z06+jqL_t(D9;fd~5`INvR()bwr0n@?{hsA9W-XXFi~gHghaev(xiL-5&+mH z#KW5A()xibU?7mLuo6=VP{EBor59&v>x8IgqN2h#ZJH>07lkRjaIk8MpeUt)@e5Ou z1cs^-682U>qMf=@kP{Wn3~FdH88Hkt8n5W$CMNp!zLDyR{dTUc0aqb>A(aYmQH zVTZRyIf`Z+o__g~@=6yR=Y=eL>~F^_o+wT47H3SW)8XD(o?SKU2+#4dOwv=F#{JII ze&^&t=lSCm%X=Q&Yfg?jCx@M5KF6JV#|wBOwA9$xWgrc3au@F-5hR>}%gTyclG-qX z;3<^oJu~j0V(j(5{>}4;pS<_{_rJJ0eM6_08HE?|xgl4Rd00IQx6DZ5fiW4!pjff+ zlEq8C!PfBZwg2m%dFk{QfAK&3#7B;9PQN)!?SRmFO<{noI_)iW9Vyt2=2= zh^#KWjTnMKEVR%RACDZyQXb4WhXFOAtFH%Ml#q`?K`;rnb`ru)Zi2O>2?_yw`-N$S zxQAO=1&?p30Ad_wj=&|DLTf}-i(-81+kjP6q=JI&isEVn6D{Fo_Ap3pYaAl^k`|EZ z%xJLO7Dnijt|6lr@MfGK1!jOq)eT?ulPIZHFHtwpMk$WM1UhsG;+=|`yb6v;RzNK; z2}#Dv0rl~VjWJ6{2wSi61A;Y4w3eH;5)T8L3K>xOcp0kLfDklU!APnNG_6(}T)0%Q z6~N>+!{kgb2y)<7Isib`ZvgOom272KbmGgd3L01m8uAx&6Y>{+Qj2UMn1N86BC4vi zV49Z;uy6%$P4!4PR5T4zZ8(@^Pz&vZMu`RHAE?hpPjf+yf69 za4*1+g-5hg1t>{bw1m*Te4QlXI4q9BA^s7I_%l|;2v zU~?H$HrDE@M+{%es(j%TU=!(ZgiJJnm&w3N92oM&RX})CYd!P{nT_*WvP;Avi~NJSb$W~Xob;U9R< zU;C?n{KLbyZoc@Bhr^K^SySL56-q7rcE$j-(VQtxOJJMiH$8nk+3q}ixOFm&-0m%T z3Du(6oA17_fBD6mli@x+FghYOAM6R{NG|RgUXIE0?H)^WYL+rmv%_^&D-CH7nbUD< z8qypTQfu(AyQXtSBrUsHK@4&1c%(n$YF^!v-Y>1Du1KLkNXRf@=JP~8u_5N9iRQIq zj8E8#Yj(N3$VUgR6WSg?u)}U(dKjEpa=7h6X6!XxI9ecy*Y2{Qf)h`6cGoA5mv=Y) z9y7Je!~XIeu z^ANyw+E|H~CQW(t63w`6ZZFoiSKYyI`T7$kUQvJz%4=33uyBi)67v9s;S&_;{7o0# zkB+*d$?|m48yxBiSVrR@j^$n3raI7~hC$QS`N|EE28_YsNW;>&22PcgR?b8hqB`Kr zC}$z6fiY-S^`O1W3u5?$r3?~6lfCGRZLG`WWePZ&5#Gg=cs>9CinFlHJ)NF-zg*xR zIYTj}3|k{AvBZarLQCF04wgYeVk8jj%epv3c{2<>=uX*(6e^PNld3bqlb}JQ5Q~JB z^d%&dl*Fo>z{Y}_g3B7ro|1r2h@cV8TNJ~B2m>QX@$Ehb9MUj;%a}F?2XPNHRBt&! zCdZ9ZTp2MASWttQcwQ!RI;*K=ja5OEkjbq7@)0lGot~e%8=qh}9>`;oU7?BucMjU4ueNa4gGw!Cxfm31~&NA6Uk zI2m;U?;=Pg;fyu@89QRGI0u!Rv+PzwbKaxJi%J->(_-tKjLYn^!=7pdvWz%ab$!+yxI3Q=0nmVtOTEl?MWy(Vs2j!q_(`#VBric9 zv6yHu{^tMry&w34fAeqtCqMBM|M@@sjo&?Z?n4%pBB}S_KIAQh%CQFMc0zPMS#JCr z+Ho+;Kf2*er7Y?Yfv=QAROh-4#kb4_IShq_Ap}LJCWG~2%^ITyS#~ODn~cq)O$#Ay zD2SUh!es~HyjrACuy>Rz^20`kk~USkxv5wvs(+{iB6`S2F!BIcK&QWvR03k9?ZyaV za7l-ZKmoLsu0;~t)KxV>h!i+hf)4H_jJzcic{Bq_gj*9wLT)r{xfBevJ$01TT+6~* zLPB_8#DT6#N=I1`S0t&o=-L`h1riKJxVLV>q?sI(TK>YJoEaVoke2*1eM3i9a3Cj& zVr7jCLaC@}nIKiON>JW@#Sjjy!_EY4qO>3ciG(&vv5D3uiW7VY5}iL?jz}Sr239nc z5rhfbh#N`=+gS4vk_DzX0aGK1v{zJ@aPGe&p+z%BvZ0)iToStpz$rwHRMpDe@E5Yu z%z~hWR-{tEx`I)uCcE8?JT>1)kFg3jx)%GEnjHdSDSs)S#wv!|imH`Lxi}FrBuzgf z!Ttt7!a!78L5Z*Wvm9bw@*~NREHUwxln1{Rh^ug%(A9HF0P~?uRVV-TV^P$=yh!%6 z0^|0ZD+JVEl-$VKJ1f|NSF85Y1N5|9NF3^P5dkELTS!v|p25c{^@`w`6XHg2SjZEH zOO2MhIJdnaiScJ2L{`!(MZ!tP3w-@5Y~7Zw$Uv z_dovmzx2mGy!-U(%U>9bcJmaE6F(t<*etNInWL*g6X_Ha^Jy!440?#Em>mFRj`l8v zrP*ahef#fzWb0BLoI7Or24 z_3X!h&Ea~SXm5uePS7Fy?OHDvGhQiR=bzO^OoBTL9`ll{Z$Qn}67<1&_1MuKcp#BR zWiG^c;tRhxegsfX4xv*so-~u|&Un(9jho42eR0Wfr^}T7U_du}eK+UL#vZ)$+zYG0 ze#4A?r@!6nK3FxwizVA7S)0HV>CSeuZ=l(sJHR+Fo|nSI0k#6O zu9`4?tXgB80IyimPv|)ePC658m6=@@0`UyP%*KyU;cmjNhVJoU^ZeuW-ah-ZF^4XL z@f>j2MZs{B>8khgsG*n0@(f4vjjg z;UITm?SM%Ik-dPe0Ctj`HyM%|ttj9tlwwF1(;CnS>G2C}|GEZRB*{H+%7kx^n+7ML zX>n-Ft^l8~rDkU+&kOrJ3^e7QMX`)Hd9THnzucXTAxIm+$-WF5Zou8|K6z$`hn$xG9)9ck4 zoA1d5R`M`_V7vQ-7iKy3L7mQ`x4+A)2kc9;)&2M0=$v0LufQ5VM++BcsIAS+CqW#> zu{bGxxa3RU^-|U!+F65}mt;=*UAfnztJ(5gGOY=QRfpNhD1)Nar7ni3FA{_ZqaCI- zs2KbG*WNgN^qI#Gzk7fA^xMut;$Y-cF0<5}j$eko(L^dm+(3z}1^HHYU)<3d?2PWd z@%KOS==5hl{~vtUt4B9yulGEK3=tKklpvrE#`sY=J*`TBrNa^tHb8l`V8mi40Qpro z&}iGO%p(VPmg^8x?9dH*5K`&OSA0{Ype|w*KOEd!OCMjb;NH4BU<8y|-4iGYOEg6$ z(JK`EiRgZb1v0izwpwxovJUYVvNRd$9P+V4OREZx13#$&4MxeWKg19lmf=o=NMtY(sxdy=gDjRhO(3}tnh-Ly#3Cd2IUbg12lyr}nLY=7ClC8>&V%&*_ z$f5{syBo?NDw7EnL#lkjt!%;YT$g%K{IY+2?8)_O;aAC1^8Tc%^=B5Dofx%2ENz=U_i>zDsZStR78l> ztt3zmIFJaTKtjbh`nx18HgKxZQG^O>S*T4=62on<0WT_XA=4Gz?*tXD_28iE7D@{* zl?V{QVs0T9nDiEe)W%<_z7swL;EC zb8o!PWI#!kQ|)EYMsgbiLN;}YPpGHoZ~yQQyzD%^@2{fks)WmY#rdDz^{CKdyqdXd14Hj`ttyNm(o zozQ#boFA4exVqhvBNzr%Rup04hJJW5+S*TBrZt+;!OyPVQWOAk-?tGjiFP?Yasgs> z#^}W9A8nvDoYGsmdd7zZ$SYOW`lBPumgz3=7-2DHy#c5T-|cgEyL$Q#eUbH(CyWHT zySvM+9hMXi_Bd{kw{9(XYjJP?xcmHzi)QHijn>_Vqh|ZGv)g0iz~emh zV*m#Lbe^_5yz$o;sd6F^Z%x`}Bw)Z3foh-S7UL8I?(CsjIz2LEuLuqwjEj@Sc%cY<#c?Wiia&-WQ+uhNqxw-02$6AO1!@4u; zHBVQa`!Dq#KJ3uxKRD>@@2~d{I@^04`u!tEvuoUSF!Y;cY&;nt%=5Dz=lrl@&3yul z0eo4QC;#x$01mo!c|7O;tY74GEY_oW=oJTr@>FndHQXDX++zg0y1wBM-u3mA13ftb z)1$=phD(nAymvt1?DlyF-tB5O?M&`gPtIqrKfwbSGf+-Fa2Fjf&bz$bY<$f+{2m7% z(faVo1c5H$41u{r_gx>ri-p(|w5=PNqn*#DaO5=G5<%<@ zM0kk{vGzg<8&)MwzA9OwtbmB}-foYCK!1i9$|?%FY9p~_#>#3#TK)KkTk=Se5~XBC zEszF9D&tx822511A}6V2v?6ISe@H9(@}YW@j-;aw{)vLZ{3M68tuV-EO(#G(p3-P)BPA)Y;5LGV;jK_{AyOgjz=H{@>BZZh z`1r{${KB97$jQasSAKnKYg=KNYI4;N2mG`Bm;RNEs==u5*FQ9YT0S#y1a4!pV& z89k_8(rDlftgCOPTQ79)dg+Smu++BYC(z~SPsn&oVe($jnYnUT;T;mt?@wi_KD54` zrKs$>z28pe=D~yfl>?51jKwfw4DxPH!brv!5^L85OZAz`n=dae*dz%xD{PQiAS9+b zsv4T2H_sDhS@OhAXpZyT-Co{Jdk4GA@oaH^tEJf>Nr!`-x-Y-HK6oEoxZLhbPzT9Eb)5%mOK(|?Z#NnZIq1Xf9 zk)Xa)%;P#~c6K|x!)EyYVdrj2Uqmb@IhMmHx)5ekd#y_r5Z16}?dFpnYK@wbNtszSx9~GQ z@z}Hr+_L+T`A#sgudY$V%^*<4fvZ`aaFR`eF&~RUfidL?V*Y4v_$^3Wv;^iBd8I9k z*ec6+TR@~lY+6tx(R1)Mi)R?&ai)fB8g(+A!C|H9G6?}+s(Gu$cmkIEFjexKODKJr z4@&!dx9zwSupUJ#X=WN&li|hgVX)tyfVLv1*?k^mUH-*JZRn7S*<%Z(l}(B_8nyZZ zq561jzj-=qm>B0|Obj_)HLR&)!5BSWgyP66Xe$a1&r_!t9(OsplalTkSrmrmjM9A2 zeg6kN+;jh+yMMs*B-gm{VhQ}#wLs4Lv)qO*zI)^C@iV(Wa*Hqzz*xgifynbK))hJ= z=nr^LMyJ18KbWq0OUA%gfQ`DtUDobR-G4qGfjXTHnP+NLn>82u&^O9f`1zw&8cF3UA+mbkiIl37KfWqO8j(H5)pMFBypk zDj?wug;o)%J-eO-EotFXRHSSHgt;Km(vXseNy(&PB88D?gPsN=m&$4MG;?82a6?Wo z=t(;rN*R^RViB&!$B{;OWKICGI1@2tw@9VEfTydF>Y@}^YV?7HBIJ@htg2BAb;V4+ zgrmA?AoNltR|Rgg(Ouw0!x>7d2rp=JuMp=>qU+9&=MUYynY#9;^0wif78ymSUVI^TqfnRh_f zp9wOEv;hg2M8G#!gph3r5F674h-lTy$5?AtA?5vy-G-I%FoKrbiDX!qir3yGwk2w1 z&1I5O+YjNd)yFKCTyg{kWK0wSB9(=GofuhpN)icS+M)(7?4t|8DuqaIWP~@1fK}CG z6de2`hFpL{;w3G7U6sS$YAy9Qjj$@zhd4fIxQq@lYm#c1i)d6VoM>;XO!cakT0AH; z!F01ChSDIAjz*FwBYCC5kugEP2!_A7_8urI1z$YWl@J`NFtr*-H!BNGQR){H ziSaMa22<4{mQuv&y$6>_yE}X`3WcwXR5HRzBzJTHXP57M^aIcQ#F7ys`O zyGU8!!ctdZ?GbBNTExsDT7|hbhug$sUh@f9yUr@=O`6S|3q(9a3})oJNAu1-ruI0c zUW-x;DFB@F>4`QR^xa{eo@Kx+>GxP0Kk18T8P_D}PiZ)zZ=Hhiqa)n_%ar+>ddO66 zWnsZ$TLO1bwf3aqwI@t>o@vmz6Ed2_UIno<^Ar|ccTSVenxutiBhuZ+4mY>-zIr>u z?*86%(O=P>;rPsNyws(!|o}6_@J&@^JvuT)x5xwUgFZ(;|z1_j~@Zol|`09Fp zu)TB03zgQ)^s{()dt{HFX9AkreyoIPQ|M}G_f!Bt>QZ*U$TY_!WF1L3 z2$&KFJ0IfWnzDtg*$Je@k95J}d1to15tib` z^P=?>v2am|WG@YSa_My80OZu|Ei=<>&tXX&)7Imr!*RARyubV4{&H)$+TD+T?yLuR zZ#|nDS!x~g(zB;qpB_Jtt$g7Z09&3A+T(l3w;y`-jE?c);bi$rcYVkkwAuMS;QiBE zPGWNCmX>G5e2?Way%&z1mY~8uI$WKduXydox89h2;mgh0#o}th9^~%9HonaZ$$I&ckqd90svH~)AH8bb(7$kHKH$0X^#Q&+_mQGL^1l4E(vVEO}WQ(*lbI|Y11AaEQ9 zQzm2U(KXgHpPdphSD_3^ezR&3lcNWn{$gO!>2;^PG`-)v_RigGYxVITd$hWKvc6-k zgVD~WXd$0jN!~)e%7K)1k&+&I-ci|tV!jdZ(J3`>Gxr@~-4$CN#;^VAzx;<^_?e&i zQ-@o()0-z-+q@q<&Xq!p|0p|ORYIZ$lG@!fK^AeWwA)VP7eq{(YK09B4m3M#SnYhoJ{6dOA+aRVFOBB2hkC?KJXs6tuyBy;#FDvE-MG^9+8 zEQOP7B7rDr3KdgiBRb4USB+rs!=HR2Q3%6acuQKKBDyri2NBV&1kEhuCrq?qN0uQ? z4oEje9SAP4)HU)Z01FX95=&d=?M?_GG${mIPchaz(){%@-H$NbfK3dadN5-ZL$YMW z(!xRsZRKMq;!)j5&I&V{v=l{^M4Q=4j%ar5MU3RKRa!38Pb?)v&4>jmZ2STMP`-7R zSX~@1nMu!}q_sfw#-P@wG~pXTQ;Uj01Sou)6vpAH6@YKU0h4NgeGh<%a`T6O#2~=s zBMfaQXN**$2N)<9I}m5?z!@pTOo0OAQjp+&KB zHV-!QPZB{vCLxJe!~)#}?bZ;d*(y!7q@d-(+&lFNCV&csa-mjP&wUk#f->7Amr5>t zL`_zU74ky(CsSRB?{KILGP59}1vRI`m`Ig8C8QlikbrX9_;KGBPbG`|cp<4;Nt+m! zS#XjU+=!l}RuaX*sp`k78I(2`v@kO@pcs?NMycuwj%KHR4ZG?SD3@Y_AT$2`D!K+0 zU#BrBtw0izi_!)It%Wn$FKup-30SBSl98-L@k?BY#T4q`C53EnYIZm+MyVI*&d)kL1Q_0)Pj;8XexGLnc5k$8 z!`hW8OB2i;jj7xm5G9lI~Yz-gXUz~k?KKn}d!S5fQy**}9*W7{y z89_HiBU%5X2jbq}0Xq&@)r0+*H|6~VEQj(bh0C94_W?jta$+f_IhwIZbFtG&l1ek(B6K3aCVTZr(urpeyCSwbGG?1bDgSpH? zjF%FuB@xs_4YUc@Z|tW1Nh*ynU0IV13`TOtNo9q$lL~?yjHykoVSkwZPlJZNSF%Y#Vc{WVqN{zjf1D?>8U)7=8EEkbNvXaoTcTJ7?x9JpBAq zNQV!!eq^tunPaEQ?qy>nHcRowPG{K6?$*!UtUk2M+&{z40Yca|v8Gv9#0!v!BQEqOA4 zt25%|CT5TEC^ZzPoPUM9sVkhMW+hK7$W|O08vjcM?r3!ln5LBa` z8A6NzxD0Vd<2zcxjaI&Q>~gyN;@7Ue|4+Yg^ucEK##O(+-xh>&0w-nlu`m=fLDAbN zNa3qGw{>9&VE{;(b9NGYDCq7tH^1{g|LBi=c4zA^{KQZG7iSlp?ZZcN2LIqGH{j`b z5%dEh`Z4fOv#^v~tEM46KnmutQ2@y61O2mjSyB0B`hh3x$wW8BvSYE3*hmAxPg>NmK za*FI&PVr=u8&oME07}|cSA~T}B25xbGNG!lp+kI83mJSfwH#b2@l1U=DtFF=X#xS# zVuBFaY*kAO!8KaylZ|4Kmmw)~&}7DBq(V$$xsUe*T~LOqs;1WiV3>wAatkl}s9hPM z4i@*~jhLvWq^26y8B43gNSA+WO0S4VdRp(eewKKYH55=|DYD4rb<#~BPnb(adgbgD6%eUIG*B5ahe^pS7$~IS zzG6y(46Pohb)!9?z=ndb`hU1f@tL6s04B940AOUd6_O~1v+dDETfrr3Q09J1Il+W0 z7*KDo?#4(^$r1D23mjd{wXK%1dD(Qw1$WToq zM-&7C2U6Srwqs>NWeY8N@W3s9RYsz8TZ|D2Tjnv4XkjJQbjtxDa>GVE6WW4aa^s?CR_z9~}O|=Rfz!m!=p0 z`s~48^|o8n}FTL%W@q0EKdB>-{mEm1gKv;DF|+vKV=yMJC5xLH5^gM zvZNeA>Z5i#2WgnKRoWtzB%ADA%gK6~fHQog&>iBukE|HRaDZ{)f#|~Eh6z#oMwH>n zl%6;=+&jpTM~hi!cE`$NPBmKdcA?pP|9vm^S*F9r#?fGXal1UbWY&@O6UMywsCobU zS%%ME-ND}A{-}HLYm>dfVCSgYV{@d_s980!?Q-hvoi$4-_;!Z?%PNMxHkfSy&ZP2) zAn#prO$Gflo#X-$4VpGrsw(yx%ie-@@l-{LPi)BA)p(ZewnOID%fQd|@ z(qX|h6>cb#=D(HYV~W`#O~+=WjLIA}H=?<)EG_nOgwlvrd*;eUr! zIv;56zv7^OwA--Ng~@&v_t*J9_MBO=2O~H_%025QLDta(bN@W2V!;oqfH>lo^KA!= z=U1bx?)GH;zRsGizNVmPGq=Fln(6ArlBIOaHuR3SG2HU$UH{<$Pt!WHRrm4Z`Sne6 zbvw9!*ySkC%d6SfUuW%5|KSN4y}r9;Ok4GgPZOyd@Dt)W$(N}DN-o|{PoKe1Y=yaM z7Z8Osofj;fN)(C6h`A#Ntw?@BOy41Q;zhAJtNKBwh9Qng5h!E%OvpE=LM5nDr0NLP zgM;nv7ruV;_*0`-|Hb3^Tko)7#}bNv!lOJ;r%j`7!@;GyB#BU4(I@MXiC^2+eDh3? z%t8WWq-b+8Qg>^xxc$oC{*iz7#n1nxpE~Tm#dClGi=gn1O;PZd4&5 zVuT9++)F)`h(OU{0~bb-Gsw@>2^B%5Xm!CyiyPC5Nxa>v5@$0GN4}62M@A73ptk>2 z_KFPVj#MLqOfywtXeNj9of>6Kq@p=OOQssftVhGGaJ zVuzw2E@q61Q2~Ouz6LgqWJUBhIg%K2ic5E*X@Zxvey9?uA`S#phoJbCCTfeBBqcWu z8w(Q#gf@sZN>lpC9mh3UImB#jOIY1OV(P6tLKVZhw@FU?>PtaLQc5nYHwc z?3Bd(f<#oXgx%oAzM_XxN!yN(ql-LI97X_uSOH?CoD8Y5jl3m;CE0dNl3(c8jw&CEXq(5U#9+& z#$R|Pnka5ae77amED-+x;Us(HE~p=Igaf-g#Be+U7%tfvN*|*B!kt}*KkI2fjF>B84 z;qAZ7P|^>!qYs?`6ffA(L;{bs?S#wS0f3$p+3DJg!iNF^t>(GKbZ>Su9n)!Xf{7Ls zR64fwpJ+?i$(p8=qlFv;fJL`gUxRvf)IiBB&ijT`&CAWf$t}KF^ou-vTo`ZH!1G4o zjU2`zl^%dBOaVsBv{FR5RDebQ>~;{Cnkv{#h@uAiPw5;in)zgTb<^bx&hdD4JMK)! zZ2Vm|!`{h3cWcDEiJAj?H?!s0S#$De`P_^1C3C8sljlZ*Z_X#Lb&elyu^gg5;&4&6 z47k?c?Z3PhAp3x8Q8nu*YELG;f51k(eqhUUfmr#&asr-w_M%d~|qu zZ|fBG24?N_>D$fWJ_iA@ra77I9A*5(or)J%i|z-vhL2aP3*G@dkervc(XxD@ZR>5Z zJE$}$sV7VTR#!}A7-Q;KL?>H};KRRG<%-Yi%QkqTg3OoYG6>w;)rLjE6Nz$&6i=6e z&@=?pPWH{xlNJYglSrDPU=3)rms+$<2Yl3AYO)WL6f(&gp~nW1v}g*b3Pz%^5IKly zt(eN187b-UXB4fsOp{!t0duC52BcLV%GxeQE~c2@lBw`jh9n7;-|*mHofL*nf69Hr zn4;JQCK$Bzj0;^rXOy1fgyl&V->+!ZM1fpZC#a(&V#Z@V*uKUmWRZp|B z3_QK-uyE)-A8(d>>}cr>_jw(!Zv>-@ZyD_~ex_Gly&@IEGZ_!)oYWr<>Un3a<7l2I z^y&SxVy?GhukV00fM<)BcPL9Jg#7FP-ff0^oT%Bu=^4#m-L0-!e6(n0V_pJ)O_}NE z{QjmpoWJ&lM!UFPpPda~c&_{0V-~(Nd+eYe&DjhSao9=9#4Il{0kfQl zY7PsUSw1se_P6_QUaxL@)9?Ao7rWil<=x!nQ?P~phB1M_n}c8`ivyzhkc@a;qsog? z3kWwXh_~VP1gxewlejnJvFh^n%YXY{{p?47_Amc*cl`SF?s`BCqL;&ObG0f-1Cj3sk%EN7Da=R?1ETOZ!R48B>m#|rg>QvXUVjCQczkJr zw$9-W96b!13nfYzw+O{TYL-n&fUmMqEnlTgad1$9Vo*tGl_VegOR0xL4P5$d_6d|- z2k|0yBd69;4o#g5N%b8_9h$iTaYLoV4FQ6-fHI`9v@}N20E#6d-$ha0*g+yZqbQ5Z zlmBQZTltFtkQPa}glxkp@22Npc?9)0-w{3X6g*HxqnxE>p+pWpTGV3K;uoP3AjrfQ z02!uj!mGH`kQDg4{K?~Rjv2-DBMzp4d%%?fC?Lhd8}w$v?Fh?Q%Os{~8MvB2Gi#Gv zu~}GT6d@rq4r)}U1rp*A(A6N0Kgh!DvG1!lbA_vP!`~l?SRp$GX$f%;b8i%vuaczT z68%gxYns48Np&ej;7YB%Bnq$Oa-_zPXpe0G)H+He69J1~z>0mL8EvFjftm^;u`QYm zaz!4bD$*ep^-UDpUVv!e$AFd7EostSilHu=E6s9}!Z{QSk%5v@@(3iUXAxFP`nuJU z?6tn+tO6tqpaNi2H6WtOUCNQsK?(o_lrb#g8R{DnI#WPP|KI>jvW!Tpzt){3Ly|J5 zI65s^o~;0?12Mj;q=raDY~>6w0rXoqbNb%=?&f54`=9=W&wl3PdzWAO!q$K{*7E$F z=7bA%)7N)yaz@9OHYV*hd!ccI6Wo zv~v21D+L10Z7Z=bx7Zjj#IV+(`lA($mv>~b-vZ=c^c2WIfSd^hLC70y8%(`b)S{5$ zBt%QGfTA8TDduFPLxO?L5c2_o1aAJsW_G= z#ZtQX1MQRBZz!tEi_^{>Z^pHE%c%R!>(16m_wfh2tgi15yMt|Z@lsHw&q4hbSQhYk zqGu-8J!g}ZM0EOnr00^NzKpW4NdIF0I*$VOw|o85^@Hox-pFA;4-3|v?e5N@n~Qrq zAQ-Z%zPsID-EjWTElUEGZSSCSd$s=7xBB-_y7!NG1sLliuw8d=dv$xU{Px={fA4dW zF4Go-Sn@x)LqZ;KP$%$wL;W2!GCeTojG%UdFSaxrEfkKI2-6EG*m-DxaM zU$X`k$%q2SGw)c4r<;(e)H4&R7Ag_uO_FOE|w3RvanAwc0U&0swDAK;tH2DVLsxm5A5navwQK z$Kd+3aS5pwH;D;gsi7O|>=0=kTWeV$B(7ePZ`C&vIK`7{fD}Z-2b~09QsHPRIJVl@ z@IZX|p6#}A>hQV;EHVB!eU^$?v#As?%$q;fP5ie4t;zpT+q72>}Ws4$B zf}ktDWDB`~TXxnBJ_r;wwMC%=Qv&m&${}Uv7pPEa0i0=fs9bbX-6e0 zP0grWCbV*rk%k2JhbzXYIxCirI+g+JoDdCoupp?}6_&^nDWRwqcEzi$*h&Cd$W0?* zh1A1RmUw7H4gdmF@gT(^Gf*+xN?#AuPQRH=G4gt=4Rz!4`XCP0P=r2(N4 zcaau!Nj1ufz$z56tB|6))eaKlaP~X^Gc`n!rDC`*7HyhPwqt6#aTw(W%aW&`*$Xd| zDrvPwdH@6^B11D(QT6;|S6 z4(Zz-6CZ_OuC(4$K%k%@WfDMh7w##ffT#|1MN}r>bgME{VyO;{;w#Fko{E*g!kZ#M zY99oWa}Zo@ros^tu2NSW5K13|W>YMo1gKr`C4I69=!hvN8(NDr$@1{WUnr}-V5Dj0 ze7EQk$cU0Hh@uKsOtl*Tp(a_&cO;RM5@Aibg?Lc`3`4+|yeS)kEtSe7sYL2>4+Vu4 zY7>B~<%0eT$I{JjuTDnSKl?L(^k4sxS8o2_UmdWJmh(t#8Yx6qR12Z6BTn>h+UK8jqOu`6_%=lWgB_K=G4yh=?%O2?CjImXREHA zHWZ^oRFsg zSe31h%%69e;xtk#(TU+iIW21jr8sdDvxC22%WURDC%uDx$1W`FVdXy)guc^fL`R8@ zx4oSaM+Uf7_?!EfnIj;#j*y}uc@9OlO-g0vP!**;d-a{uU4{nhD&O$OFhq(NJIYTWdX zpsvRl*2wbH{Vd$tKi(vyktCa|{u^ViXz)Y=faL6B;NE1InS^t0P}8SKBmgGMKwwy7 znq1zQCZg6*A7&^Ww@6L%sDw0gClzifzD{Ho*K$*e4BjhI3$*0gP!;ab2@6PA{wzFE z8!!}dP{F-Af?6s-jlyAAvH3ATDzc~v*pw$bYQi9SEGUmu{2JLpBp_Qf4K=)}?`*pI zFkSG@VTKcn*Iw_P9Cz;>EU(AC`DA@Jp1*b0@RG30b6(ulW7_~7axpZ(`mC;l6O$Df$IPBDIi&wLfA{?G)&3_wyEl9C1`lI+1A644Ovzn0wtU4W z&HC1jtul$mm?Y`88b{@-9^F`jLAP~Db5EK&sy<65`l})QNgT;A@K#%DG^b1TY(nV9N_&nTagbh=Do~ zNkb`1)q$F-NW^V0q=QNxN-nt2ksWv?U33n7nM^RVfxIS`u*BM!87&Bc*6h|z0qn$!q{%y))OHxb~2(|?vhaS#mn0wV)aEmN0iClZNC5?Ov zcFnWx?{0UNXMgd}|4Tpi&%bZ>HP-#pZf?;!(u&bY(n)YW$p!Wviif-5pnPx*Ix7?< zDNE7rs46Nst6nXlT3K1@JN%;&^;{P7DXmYJ*>`umy55~l)??-feJPH!aoI)a1e-4r zb()p=Yj)q-vZ{<55NXNP)JhBX+QOMkj>4pYa|}*6ONOY^CBr0N6$5aHL6`WQZ8`xP z5ly7MR45dPQH{2eTC8~UsPzm-`q43WvX9=stGk(LoJ?3o#iE7f)2Get4W|ZafyHcf zH}BoQH+uYVIbC+{J?cDoyjb)G``x3%{?q^EmJ!1C119$AdojE3i-re7W=}m!(IXT& zSJ5{pu`b9>$SkDh89tM#^sD^10l>K*?j1)<*F<*@fF=?|m;w|Dt6)9- zj_*K_Nw^D+V!R1vbuv%H)+@-DupmYVIh%?TnYRYGO|}Guo5;j3(OHTOgdV;DOn^+n zvzR@%-8K`sg-YlUtw1&)QrY0A9llCsYEg?8bjzMNCMfz+)Kq1XoYa80nX0s^Sk*7BA7#Y3 zcM6CT@HhTs?UU1g-<8Ck@@Gg8JG1T4l=Pm^7p-K{T& z&3iw^@_RcuEVhRVr8l$wJgH-6I=cZ}=)-dXp4vH*X0(Bj7B@tFoN?C^Gdu;U2U@f$KT@sASy{)|^`u+4X8dwzPeJiBgYR79)gH{M!&>Gk#PxOcR> zIz8>&-ncR6a>5~_#Gqt%hbn8q0iey@czHcxR}TiF7RY{mUT5rL9_kC+-;7AF-R!}} zHHyQCjFwYp5G>1*@7Ud1MK`d1F|WAH%w$69DB>7>*J}zH*s%!*ymA4+s3z#^f937F z>*4AL|MAEXH9AOs(Ntsru?jEAz6 z3I(24?CD3^6NO;Povhk_DPc-6002M$Nkl{SM`X_NY|)J2{D4|qFL~F210gR8{sM?cjyII(nQptg5oD}TO-YQQyeDPI0aNu08_m0Kn$(0 zBG%?ZBU%e+6Ld_H{3Clp8k|DmJ~UVwqnmU|*22*7NWvI5ZlCWd0r zH<+cY6s%Xs*;G#4K~1F6C>+!_BADmJSLqU`CR~^!c8GMSnh0rAuv1N{ky1wuM2_S| zP2uzuFR36wsI}hHrl=>Du_oYKVT*NPgt~TxvN6&MmHbN17%r1ZvN}kqeK#+PHvm;y z0W6IA7D+SaFJC$)w9GCg2@3@fjBmT+C5-$1cp$zte(TTvsUP}x|ILptzWNWAcegz{ zo?W&Jf`Kq>vgJrg7L~YXl;Y+LWo=KC3j{GKO&+x>YlMiwhXr#6$c4pZmvdCkN6|HK znSfd%5^W!5^n*8`+HgKSUR(|CctZeVgDqA8xptWR$6;7<#3t7+$L=!>7`UFG$4dNa zWuX8q!x04u%sZG6!P(n91;8dA!fp2;wVC4wU~xX}38quy>=NYR{S4!Pubr?Ih+Md; zN|?2fT};NyTV9vTahXZl;#lvLwejuZ?99{3=}+(;p_d*EAKl}DLyhHD=hw?8mpqMc z4tATD-?!R5X4LT9%cI5D)|Y>GI(&4%^8_a=S=6xA?b+9N48SsLyZ$*+o!&p^sk6?R z)|^E>Zl-i`1^p#l-|CY2M@+>5M9sl^#(Q2@oCVZOISdFB;t!^hPzyh$l z=Y^;UErv9O2i^LujS+^6NE4;0Gvh3A88N}4KU6u&ExB%yF5p%yu*gkW)ank|M0iO< z!^OKTZ3z+w6Bm9ci4G+b0f~Z+S>DzFNplg5z8hj1iDaaJR9&W|J%toupYG!HhU4|7 z8gCQE<22W=sh^iAf{`deE^eYobpf$9Q5an#GR`3tR|W@z&_QRfC$iD|XPp?c;VirN zOnmmvK2Ph@#%7O&>S9iwnsRRLm9?~jPQA1_G-nB`q_Fivpg(UZ(prPFLa;( zr+VX?1$$U=QAXn|_>p<7?#C<)0N{iNGabj_{|MknfYNT|&0v9*LR2+bv9>-qXvS}^ zuYPy_(tUTz1u7iQCt?>(UaRLDhPQ@`S#Pm5>fJv?$Hh7C+twA?RMQ!I zND=lyWAjTkWDm>VdC&M1rR-iaXR%l@k>4L$?@-{&n&y?=g4EmO4&~b!acT_fgj5Jt z7jC4tZm_;U5t}oMf@Y@naCZf3?XZ(`39L@!)PJ7|U>Qad(Ts{~i6yQV%dfq2`{~ae zKmWnm{C=}Nab_ukW=v)i>- zpWpBQ&2^6FUVF|l$N2j3jdqSXri-ZjT#Drus)z<}UELPZOtN5cDZeGJ9fZX71d4M; zC{ip$aS(k;tt!=ejf&bQUOa!D4MtnDqu2LNzxdNX_2Ym1Qy)6I{krdMkY91Qcn(%o z3Qw|tAGq}oQNtL^9-iK)qzGJMrX9~p(cp3-Pk8H_0t2M*(v6hz&|4KVOqv@xK|cvH z@{onw#)Wgo)wcon-55WC2SyhXTm4(3(K*up*V0XU%GqwSXi-B+PC4u>(X% zOcF|kRs)HkvT8&Oou{*_P35@%-@A`mQG<5dwT zNK1$R1~w7sN;RjP0>(>_0Bk^YjAUZNHV{Ry5+z-%Vokxo2pf`uYw6ONY`U9643bMy z;lSZ&Qc*h0>$c)Oi_{$K2N)F~R9Kt|J|-a;vY>Sm6j3_?KsSddvn9y^6cx}^8gc=c znpH>Dx=Jd6*a!-VGD2>EdJcI=)SWaMVXXQ>CNT{SWtIxW9RDdK7D!?d*S0c>P`aa? zGTAlU30uEJuEZ)-2^7kL${}%aF7CmmLQE8LMn>H?aEcNWKm<5_Qv0cQk;NF=Z*8R* zMJ}c)+nRDbJJfZY#&*zz4#?rfU{PgdoSZIURJgz-tMqCcEsVDr2t8ugkpgH3Amds} z5nMp1%?ff&R*$wdppq{^LMQGW9l2G)@&V-}!iEKcatTjJ$|#Ab5Yx#fLE=kD;u|2Z zqF5wBQd@=fC>(X<4-8ErPcjP=nztc?%4tUgL4UUXa5{Yc=+0mK>_`97fANv!8^5(+ zmTGg0&uTK6oJNOtblDw<+Q!}q=rpTfKpayg6Jf&>54WLIGbh62&W}ztZ=9OS<{i2K zvT>0yh|a^YElIoyd_D%m{c?MDHfEX_ZW22=bMIztj0Duz z$$1+~WZUT5bB@oDkm((pRApqDE`b^Seg*)urTqc6$jdv#2x6l_rnt{Jdw^<3>rd%p zIdj}L78DzI$jQ6IcKxocozQXu+~EUAi&dXbfSuFrSn+*;#e+xv8yoX!f6mvwc+P%0 zWmQ6V*j*gYW{*y~BMs8McxmDd;s>IS5lJohedyYm+dZEf2nwG(Cez+31jIJA%Tpl^;Lsa<|V#);=MK>QMJ zmRG=<5fh_?n_rq;Tdejs+w78M$z6^*+XwSiZ^=5ky>4%BclqGaVt7Kpk5@2uvHF>H zXVc}$Im2&?Vf*lirvW}i;RAv1Odzy8pY})W$d#2RJeQl`&F%oeyF%1E^!!qP@R-3R z`&2-P7(c{;G%qSxOKC%%ndwYmS1b~e#IPASYB$WJ1A=ZP;6pWR?z0kdkR^(skvVSv zD;;u>X98b){rIIH=)d<9-IE9Rdfg3YL2y+EWXW91b@I+woywBVMI*-hQV?`QY^%$F zrl`6B5JH73S5hL=A-Sc*}ZRGzqIxs(U4H?t}d*V}D+Km-FO4H?;% zL5i~J%~6EV91P1v5S7iMC0BzDJ+A3Nl%z@$I#x8{maHYwoF~Ros%P3m;}6P2lq6gm zy7D6)&5{~c71fx*j7yp2DhNJfFDp$)SQM}D4pEBglT1`g32C=MHbjzlXaonwyp*V#tZ6 zQj)7Nk|;)H4K=5JAPY2m_w%3ooQeriyc(84DVZs+XP^%q)r$LsaC4 z2WI4_vk8kK6g)Bx0Z!ztXtHt6P4M2lch@gOB)a8YPQ;aA>oIz^pxFaxUCVtAAW z=9GM^tdt1=Pz$k(kAy>;i;+s&4CxU`pokG;gas<3_R}qU#x-SCPQq%92DmcO%7iq)SU0j{5^8$*&Y$_yANZM{`tlBMNvWYG$e(REo_F(O`XQWc{zH%KE*}^I_PRi7lBJgmIk7= z4v+v$>D|yNYU zr)Yb_ezub^&~-?{n-!?JIvn#HpuM-%d+Ks$XR|#%t{qMIH9I>Z6YQ0NQGpqz z`us&4I1-_|5~(}JS{hBjGNpj#mT?WXeVNAAVg@ai7ag-#m>XS2*V6p(1|QF~WI$9{ z0{WXC>4BJqO1dy5xl}ad;{)O4t}^g)B42qjR*`O*+~%RUTkjMB_=pn95HTxA($mPS z&;z+Tb^rp6p|lj8;#%y2qbW%2ASrGXr09mPS#ChHaMnydlrVySAhoxj-%j0>1d_Cv z1;t1^arAO68@?zrW5HL7Neqcc^DQ|x_PTq2_1x9=)}VcIvN}8C>(LZF-tgzo&jX+F zFrc-3IB9?Rr2Tz=c64xcI(yLC+#7Ux^%nO)srU&4n*_8Zs>KM&CX1SynKNhrS1XC- z=BWGn|Ghf;_2mby`PK@1L2b@x9RVhmiIQh-EvuzCLI=9NqRKm3VL{`Rl`#%texXKVi=-j%)#;)){q zv^Ht`@EGu_Rtzo8l35@C6(iiFj=NzU4uRJx+?E_@7#Qta@~a}85Dwrl)<@W&HKed_ z7Gz>#IdFOsN@0|q@sNnz@(i~%{nCj$ys_kIFqBcjy$w-s$?ntzCPprcauXw{3IT4p zkF0C$v6OHDiHK$jrWREg{=`tzs7dHC1u3R(5H$3)JO&B1x{3~WDO9X9rL63Uw9rKn z$L0JQT0p^3w~?W?7fD+|&I*ZZ38oljAVIW<%1YjfsCWf>Z3Vm^x>zi!1zKQ=CWa&> zE?KmR_$5e15T<%6K1$+W;ROv@gRiuj@(Ez93qghRJ0EMvlFzz6k+gK5{^ZA>f9`3z z3Y8a8Nmd@B6SCIz;($ShCat}oVHxNcaBUR`NlW<%tV_%jaAHF$wS(5MQkDXTtytJ# z!Fu@8P)fA*ML-+yAPcTZshdh{@5=>bZ&~!5B0vZV67g(Qst{P30cz?+chL{T79;%| zrDn`$Oq#T?0D)4dNYvf(H8u1VK?hYniK@`6 zM~N$H_$8XVvX_ix97Oq+P@18FN()GG)|mY0Cic%C-ut6JaO0=`>pwnv@U6++d&8}5 zXXde()5Xl*JBO8(KL(f!==gEo%&Y0Yw6yTTES#A^ho4o3&-0y&wCLKjW#HVO?MX$dgIy3Pk5qvj{{Tq%^@Iq>|04g)?pLqwNV|H1 zLfrMmWXyp(@yx->nin6*JmVYyun-0jUFu*!H}$~<)`_1GOFTq~qfz8=R)KoBF+W^c zPdi&M??|31aj!SzE4uUL(IH!=td5VJ7Nv1?^AJ|uFgBnK>vp!8zGu}9HiTNQb8vCR z*k*gDd;PiPeAwOSUwZe}>|Y%(Uu$)*U)J&vp=W^3?yKSll4`jH(}i6Z{kzbbwLsZ6 zbT!HcR+&x1{sQnrU`8Liygh6u@9?a3_oVgC(c;#l`Gcdyo#W-(cNepM>(QwDyGM&> zzq`G;y_lbiqXn_1>RKO~G39U;KSJ7zKaX--jYlZ(_1~4hMHV`oEZ&n47yd+Vd1V~8)!pTGg8Y%TUWYJH^MSJ0-f*&I3L#v(GDfxsb z`h}emC}CR|4xvy~(1sr&YfkCuB(^?PcQyjRkSH8hFHW_C0N7KLK?4`yMVf}L9wrkl z7iP$aUPNMfA|WkbBULIjPt!8FNSz;|Tm05C2rOTQ7UX?Cw9BjLJV8TFo{tT9xucD% zT8wx$5D&k2VRdKP{>?XdYn;77TW9mugVWaCqt&gW7HfX)9xd)4F4=hVRl2MfI!}LB zcYc4--*5pR?kFMK-~4dOu;#@SOEp%)3(IU6jABceVnBcgSsNYJ=G^?%#dEtX^3Qw% zigdO*7q0L$tutb0(BAC+k?>b8wfA>e*1vdoy1aeAGd}ZO1D*?>c*}NMloVD9v7Z-Z z9TDiDV+_C5O%7=y8Z;L%=HP=O^~_OolWp`|G-rN})iDZ7`!c}~5nll1K^#=5JKWBP zCz*4W`B>fYH4+B@=CuzVn5rO5X=lm=(&UpB7G#}hU{tUgZuM`Cr{m4ZhyG-*zj;0z zGaeYh4lqceCcx&nKb?c!eD#btf<9s-r?O^2>JWv}0H{eF(h(L28ZS#_`I)NdNLiCP z+8j>a{_-Dux%IPu<1apcrE_xsR*#H}1A(5ZvSCSmXho=xDwIqKd0^b6Ag~RxscMk2 zLo!gLgr>Mvg2jz0(Nz}8t%yK+7=txr0i@5BtaFSMEh2d9ua3GB;cbyHgcN};5hAT7 z^Vbw;%n>2w6pB&LmI9m{MHmnVd1%ZL)du9czO5hex)kfIVPmPbK| z5ba1vSZGtdNLJ_3cp=HXF}&_%s&J^BpW+rw7%99o03#T%WDnF-Fpz4NUYnAM9ysF4 zyAwsMM&;n*)f}~qg>XfNVa%qH01BMtMLa2JAy`JwN{?zGm?RA;w26_;Si~VVB-2=l zV-af<40N!fXyXs6$`N~OnA`)f7C`!s`D$9p!9yC#U`=I6ujL9mF%?Gc=sB=LC0?I)iMKGdEITBV1RfUpL=MrzfLVE;IA~Bf$ z9bJgFi~uehO_JUqLGT)t!xSw`iYTk33auoRy$HvR*`Z*Pld2@SBtr9w;T&#ZG-??Q z1b~KeO8yvEhw4a?d8O!4>Lxv$Q^m#Xjy&oQs|G*?0~9f|3<4-O%7PbdP@46h<45=Y zz>8Zy^Vj~Pr-u*6Z@oU+;5|^pW&RA!>HX87(#xOHsQM{Sdm&_;4GDc2!_ff)5YSbd z@~lP7Eyn}0C39%{fzVR)Fsa$?r^Y|*AlVK=Dc$&-!5Oy3yG!2kTe6frIn5V#&EycJ z3&V$h9g$>(4{WHoc`D&c0uo~FyLwcy&rDC|y{9*~H+z$xzuE5WxA*p$`%G0v?Wyhf zF#vEKk&C(62dO>a6=4D+!hRNjGx6Al1^j&8fEI*u+1qU`c3YiI!6wtz{j>JXqvdz* zwcfn5oRAlndtZ6D=smM~*9Tb6gbDMZCdO@4*zmS~0Z6}%J0&A=Nbc!>r?N4eoGvh( z4MgK`XpO65+bK$WBVy1A)FDYS9tE9l)x1r-B=iUgVRk7=4q?dMa0L(r<2CwX#3V{y z0DzaaEa|!(DL4q7G+hu!WJnq?0mX7e0bS4)$r4SsH8)9OPBPgq8ztk2c!=c~xFo@B zN(ljd9U>$tMpOetkA$oM@gxET4lP-!2Jl=ELk9VG2yIzYuITPusl+ubvS2!sI1>q9 z>`#xJuXoWq=M9p~G4}_&FESiCUgqU;p7_}$Lkt71S{JXZzWJc_<=0l*Pqi*xv+g|^ zw;r9Y?mt>Rca=r*Krk}bmcLTgHAXSNg=PF zGXZHgDY$S`_R)6t&40bzJ8s=Li0v^k>y$Rw&~v-H)~2Tqg#kd|CUreUH-y9?pIMq}OP5(8&+pmvJaST&Jhq%@iwBDADit-D$QXLlG-7 z>LotC=b{Ie8;-X6k7o1NkH#PTOy}Y=%hN-8|Lpp2JyvGX8LVx|?-T&@T{q)ro+e(8 zEoV;>(xrSTUIXb>I@WX&h+}wBU%N?gz>D~~^l3`fG}!E%ee0indaw!F(@o47^3zOASl8StPAHb z$Q>k;dthkx=u)DXTnunz8Gw{@r<@6x9`PX2+yb8Hu&+$wUMYkKF}1=96S;1PZx!6TBGXT^gQ6@j~Sgchwx zMY%BJUh+w4vPDqyv?j?EH$Ew*==tUo6?9`)>F3aOa{#1Aq+%~a1cH;wNzZ$)5=@yD z8hxdoQ#=)@h;EUHh+tVNl(=jnzL8?bwTLG<)V)tYQvnemsmB_sYNt36Aq$C6GJ}m4 z-a}?y)kH~@k3{pV35GNfnyl!7KsJDvT9>8&z3JJ>bC;Gs``7>UAAF&8{OVVR!)_cBi#}sHIkxtkS~+pCExBS!r30q<&pXnT>ZwlW9T} zRpDsJDj9o@P!PsH3#W#uAqR`fN_|&D*gO%E(Bzja6Y8-Si`o#9Hqhd&8_OUC zd+9DxJC|Btz2EwcH(R3%t>>R_Upi=Q4_n*)*4}1&+He2b>#L`}f9oTEsz19o?GFb% z-axnOkE`gBHJ-re&4VYzLsG^$3Fx{gWYOeAUwXEAx%c2!=k0&Kc;y@2_ z2dn9V50Wj9r^q*a_DXAWn^*1ICx^=ihwSI?D!cJ)cJBnkb`N&C2ixvX%Etkmtn@@(=+B% zsKAo(W?~+aq;xnYvtC9<>R_`tt`5)Ci!iSw9i{ODulzKy7lcwSsytN1VJs0rDu)WR zLF+}k{+0ivKf5`bu=g4@agJP|gC6|qE`>#pG)j3ISojvw zIzk!v1<%qRDb+4NE8En_pwoz$FK7#e)UAjoSWpU=+eE-mQ2^)GKTQD|g~g+C&2);yPxA7 z0J(*u1Wn;49#xUtnjydVkN?Hn@7(M6hazLbs!T1HGDtR!!I zq{ohpu@cKEF<`4_1dfFXLCuc6^f|l-BrxIWy@EiVG$C@py+o2@#Ikh{+T+$&qDn<3 zm;n+JA{;m=t`-U1xE4Mo5f1t(2286M+(71G3Ly*>t|d;9Q2YRew$SB8Qi)e_CE(bp zX6cj!pvsg|PToPRBry_-C;_Qt5z7Km%Uo#GZ-`PeYK)SC0L^OX#t0T|Jr;YU2dLE2 zK_#tHfC`pi(vT~{>(H@<e+T#>o|lxDgoDHCGZp)yYc1XarpVPQEtc}7++tn0N- zCi9I&hn4A;ZD$HteN@g51R{Z=RBBK6Dz$Ll`b9-*8tn!>cK>sZ(&h5m6~xxUx*A?; zO?$+<0ex5~s`Me&^fog&E%BJv6F20J^x^MFhG|85{ikQ(xQ8YNVoGx~T#RXDX_HW; z)8E~gAD%59o%Z)egUc6IEEZ<3kc}ZlR^^2t#IaFJDb!P+AkO@w#hl|qzz zg&r3MnXB&9SW;sqAN3AznzOm7CKO3*ZMH^N3l9mnpZ+Z++Zqy+8sQQx zJc*$wY6Me@ghE6*B`#?6wbx0N7<5S}XNp?Uja(w~Ph+ZmB9q#sf)K$UTi%o_ktZP? zU=Z!5=wA^L6x(RkmL!6pss&AfLrKAuLln7j!CCcX;GG_-evihsXrQr%V}yd&LyAs< zrNx!}j7#}^hHnC}j@`9s3kIsZ9ItwvVf)T$`yPI>(dPTp3?rBQ_T6RsJCoIw4-Y=| z+2Qua86W=M*xKY}cKiJf06?QJ%TEu9a5|^jnQ=}b8$cfB-Y62Rz1h99k>^S?{0%5c2hy>hK{`2gcAj!s#^wBW(SeB2)M%CC>t zmXG+F?oqugKj&-Q$irfs@q`{ZY*AUCMJgW!P&es95lxT4RwOE>T_0;7J48Fe zD8%R?nIJ$@Wr{L_GN({e20V4NS?YGCq@aOhUI`h0RDN;wGKiA({&^l zP?MXaAdYEzs9BS2VHsy{qcuNXjogw0<) z4IA=T)JZlVqrj3JZUTsIblO>w3&nVV07M}1_$gYlNf;RrX>CUqRgsD8p`de#2Aq70 zYqS*;M2IUTX0qAX5>>K4!J1iuEjH80NlpW&(*hRiD zEMH7y1PHWd^-lmbBET8J5gakRYbx{s74-ssJL1|ctCS`?>`iM#dRDmjcNP3-WpoDI~nIBaosL3Zd z;gyrF11ZpzQmYD(4k_udHOB>!h7|nw;F?f04{hUOfg}Y~3z)_qfw*Zv374gd6q(~8 z>rk}~=N1%13M&H?Gl@u!f8ce#pq5l}GTsu7KHim^fg3X5MakSYWH8BEQb`6$G9pLu zih+ZHqFD%%Qche`$(gs(r$9Qr^`HN_@Bb@5@qM#z{2Hs~dxMSEf<0@TQ*@~htN&f( z0}5SrvIeE>OoTS%k$|M?(+2K4gUh|;y~X^u@ANVmZdx(D*P~C*%)3@Ez1-%51jF494=y^xEw*y!5krPb>2~-^B0QX%3`cFFc{pN2?LdUwG?jTB zbD5}+=3tW!1ZIv{Dk2X5CBJ?Ud?HaR8EQ~2{xrCBL@=)emR4w|%_LC?xdgenja7^m zQG0=&8|C2tF`XqiAgH)NAWAvSr(lgpj=(u0I{r&{l_CXkr>ZST zJcIJJ{uQ6Tow6Q`hKoY)paAxiL^63aYE8R-9{9nc{ixS|G;DRA?R?-$4|k_b6D@3oPbyN;}-mSuKzoWT$}J7iYXbx&P( z(r)t!iV5G(+v!|>p}oD2_`TiD_Vz|=cdN6xHNStfdh`&=eok9A>~^;LRzdXs`LM-< zN4z@kn*}gp#XrV|6C-dI-E0l*s`JG_H#gG&Z1|(cX+KOy^=4^y`kv7bb_C3af0~-C zV2CuIvgI-Nnc-*g9?AYQbzp7f#DCtQ_me2C6`v$$R-X@mGvKiIk4bpELf?MKYt75I zPmcRH=C6FX-5%mrozZYG;5nVWf4<=D+YD3$3|%O3dJ8U8y?>;1K!qWR;YfUps-5)( zFB(5CE*McN8RK(BoAgI;FA0=8$EkqCN--S1!Q1}qUG`|Odiaq~{_xko^2S%c^6GH+ zvWBq!k}N;|6VTZF%hM?Tfzg&$kg`H1?y8_Exq@&8)X512wDgEX_0WjZT#7gxO9fd( za%0E~=voZJS&GI%O)Ew1Vq3_KruAIt57lnTyrFmNa-_Bh5!})>ycR%^@ z7oL0CPxNR;Ax#R!wI>J}0jNU^!Yk$pP~GC+F-qZi)~kwCBm9#jv1OxF#R)3}#S%#% zwj@|83B+IYl?W3+kMk#@YUL7Is``0|5Sf5DM$6Hd0){(gGLJ~L0OSv$jY%;w#m)~X zJVDj-)C4j{#c!GjDN`HhOeT86$xH%;5NNhH;EE2m1(I0d<=TiRu-U1@t2`+oAVF&n z#gP(yN+QCINabnVovO7ds8mg6bi+Xiu|q>?AhJH>DMLj!Nf>4F%;|}#Bbw=gk(!+1 zL=_oW6_kj{91`-X3gQ@}f1#O!>`LQKFi3-H+tG}jq@!NJr)j}lafwiEkZox+CzR^f z+@v#LJsZ&#shG)TEeLdzVWdW3ZE0;DF`3b)vF!C1$9MkZpLp-*{_-DLz4>pJr{m#h zxLS-OBslaWfEO7|E|wi7LIslSXTTm$^5r$%)22e8(xlDK&#vzwku%TRHI0Q65g^87 z8EvJ8v&D?*2t%B7t_@}3bqMA$yTj$l?(#eB(__Bs+2WA^(~~TP4-e{6CfmAQCNcG5 z=Hb{6Fw+Z6(eb%0@{b)1c`<uISaLU(RHHarx2azu-e$CN!l0tzEo*#RRUIXz#z980E~s9jLhAqSGc z07V?P*hkNzd}P*h_^ux>the*t2tMdyd%EuOj|nmGU}LqhziJ<}T31@zFSg$Ghn5$g zUW`v?Ow9K;hh3g{cNm7dLzF*W)%R^*33s(kz91)E<<`7^ZTpQcv>tt7 z{=OGcfMSBNhwc4q?fw18&%=RUm(_76QM8}oY) z$P3okcb2@d?iN72WKRs^YTpBxc^3$&%&ytRAJ z4jtasGHL4mvby9X*BVBN?50e;WRWsy{F1lTBvx`hgdH;&v54KvvLcd$?R;e5Qh zvbg$g_C~-P+}sH2R$lh?9W|K;O;u>dr$<2E>0O#G{-Em*E~{F5~)+5ogS$F zSzVU1=+#XDAUd(8m<6s>!gIvX&75&w%)6tV`Qh7p)8F~)KmB7LeDB56`)>|-Rops& zp%RLRD$Jk?Q-#sGoK1P+`i8MtfK0#`rBzU9v6&N*1ln^ZHx#}A703+YAOaGm8u9=P z6~o>r;^VOTEUDEI&|K0MP5_CNeWXw+%C0~hX%fv|ZapR56j_O(8gj2T+Z4+@Bz+;o zCcpzRiHo3NEtmo#5=T_=KC~olCMsBd~zn#wHLcUIxk(BtzLoT*?aJe}UOp))5+ORDHYwt#o^08HPb5(piR}Qo=#H zassl^Ncym}T%w%Wu$^z)_CYq+vJ>8171d8_L!8Hn)ItRd~}N7OIdfXLSNa^Oe8`A}qMD z1F1UPF@pM(B)~{hyEko`MNb|0rNEn7ooPvO1RkhTP_2k6`=E~L4d={Zd84qJNTxz6 zq4(Tz_9ES=Q@62LM0*TW0kmk0py~A17*d)5q)>-~)D%f}SYIWR*$ow0*+eTt;S!8x zf|&RikJ~^gxJRrcFQAKTA|a2*%TI!y45q~)%)KX#9uQEPLdCr?;0i9Fu#`^^xpBi zdl|O+1-WHc29DKYrY=TG%SHN~_W0?L=vFZlk=7M9KTdWThM1{VsfuSNheE1mwf0rI zKFgH1mPfmbZ?WTdXVP!;I`YC#iP3+71oLOk1hSW4cjnhOTRe-WNk(+~@s0tyRtYmy zcR5X_|MWEd9u8=t4(LVm==VeEKIA*OYHK{*gV~g23U14fSd0YJ9mz!04d~0*k(^BC z$81>S8;|qxITML|b%<>gnT41iov}^f{P<*cHesztcZYs9U4(A?e99arJ)16zbSCF4 z3hKT8yXWmK24b7<*%|+DZ_NM2?aqzwQVz1fM-!OL0f64%Vgi2b4&+pF&@a-ep=Hlq?f(bTE)`eDgv)cj3=M22rX|K-lM0~U| zN6#_DVd+km>2t&rZUS70Nn-i1;7w#xo5ep3Tm5sfqUM+CJ|R!Wp((9GLydb`kXfmS ztUA0?0L}_vUAmS8y47Prh$>cV5hD+PMqAg3fy0rLI4oYm>Jxki6{Dl10g#tvN~cve z+)N=k^cS)NF&a}qG(Y6VLxfN@gAD+_YHvz1lIA27Z70H5rs+1SjOvpP8P%B|Y`3L}mZ~6@^tXVubaXHNb$x|;X z88X$k@AFuwyE<8&pN(c)&$U)VZRj#7#|Bnd8VzOLamyMkcE=eA)F29D;u45!4r0IL zGGgg+2!#sTS09Q###?m;psx0za0NV+#5h{8LR9y+22($(LzG~%1D;Zz-}>5no_X|h zKl`7(cx8U};I>wA@#;gymjYXXps7^Vv(KMrk|U?OueQgBYTx>Twbd}1oKsBl97 z%#aNaF&u<6TEY%_#Ix)NFkMK=pk=Xuim9FfPhBI10&@~n$(2@KAmwbT_;G>tfQQ_c zQfeysNrk#afh=(egemv_RDgfeW9BkOgJ@iUp(xQX5n8M#2l)X%g(rc43OGXoglc;d z7$-1b0~!i|0}~Tq;|Ql9a!N&_rZSQt=;4_u9`4QIG7j+&6%csYS-BxmqTna0JINaxlSyr9Y=rPnZj%A&%OEp*98 z7Nf|X$helxDC0eAVTd+IV%MiIQFV@#4&fn7Av8vO6j&d`8sn{Qq;AbYmTSVbV8r5x z7DT;B8dNKi#emTvIiYD&s30SIsUfENN}$}xAi|SKl9}cqOw17}h>(XeXGQ~k%~IJNJE5tk*V+6Wag%#%&r*!{) zj%H+V!y!bZsQCa!Mh^%o3}Wa6fd`8qHUowk!1G5BUb@lysn7k1>pO=h-~Q%sv>QA5 zMP25;=?U??p8084|J(I}ymMidiJA+m$dfbfWPKI#b|Z*2-5FVZ$-a&H5zuDB5eWpe zoVB-$La&-Tlbm~%EV#sbwl_jvyUc?9{f1ks!|mm_7Q7WW<2eAs5_IVg`z)%33hQTR z)9m!q9mv*2*}aIlI&O6@GJ-JxtD0&h1Z^vvP>fWVVsxrA=I2m}mR=WjFHvF@8vq0$ z***$m3AO@UE_&>PZl|0XNA_3uLum|4=I87P#FG2PVthgX(!6}Y_tZMwd3(w?gICLw z@%ZNL`PpP~G-;3e-K%`ov_=1Bc{E-=JZ#6LCMeXs{GIpi@zi zmlYdpCX?w(DNfaS(9q;@7JWgZy3~S`riY9*3eKjd>ma&yVua-|(R_qH{zTFCp-zCw z;C#as5P79uvABe)WDPVA89)&cxZ)rWx*+;{?5^^XC7qaX1=6ytGgwc8le6F!0M#!gJd+3-;^kQvo^BY?S`B`Fpq&1*)I&>@{9CBa+rHJf`HJ_fZcKXZS_G|z1(UtM)+B4n78E~WC z?$!40wI$!X=Dk~ zlZDuKI{o83sTt-IVp)sYYq#5z_uq=J47HfQ!MI(8-R#* zxD=xcQ;E@M#Zgf(jU;H}%&-MM)O@JOJPs8;Up82E2cxsszw`qi+WX6Y_0JAhck)6o zV?2=jNm~blSc;_~=vy$Q9fNA~m=Qk>y!>+H7IyVW6&!NP1c-)mxxF=l2mC6V)Cpj7 zCOqI|D!-;GuwL;_Zqd$S5u6B}yv7{FSs_3pAt8k?A#EQtO7v1g`Ewv-fr%H+N@J9$ zBn!%g69*zDDOMM1O+=e+T$7>%+D9*aw%Z?V7I7c zI)8N$ARrM0Kt(Q$3UojJ`OkYFn|c+-VR!hfAv|?&1M@XrPc@BFuiB_gIZLsvjwZX!;N-K@z zjA%BG$R}!q5;MLoh1kN33JP!~G4#wxIXEDIim3Dv2t@LR2Z$C~z)93#ASj@>o}vWN zQ7x`gI)W!uv=2djAxVm<2Q^0_dZQ|J)^WmL`-GMEiHaJ4siU=2_;U@eRB|Y0oC=DO zS*7D<%;P?OjD_$?t;-tJEO>gD$3Yn{Ez{n0L;AQ-y-r@y(PE0!)y z$Xfhh<0E!3%>`97L%Gq{bS%X&41I2s&KZe_;!lGbN}{6z;D{+=3JPI!wp_<7Q@v1a z*hPhs$5fcB7$~0P9x260q{y*K!&iE#lerfuZVYS&a-#>Aoi*_y zn@q!%fMG~*R1`NTu7m_!?Z6cUwNCNXP%)btgbgv8gchW9&mb78`2$Ze;0_kdq?DeH zZ7@bO-y?m}%QC^NJW7G0dxz0UgM@}QoDFJm6b)5_cml|o9;2H_(KjEq_y*U-%k7;@ z{lU(t!}}qlOirc`Rm+o4kBZRx8zSxW;fsJUf65z@j0-`;+@-z zciwJ2xJx18A%+&y6L^oo&y35=zARZs0l=PSB6rjTsmXO^;yh9Dc3F<+d_6#*G2$WY z0)G&Y85~k#9oGJ&*s#f%GXgVSn5LiT?1+Oe-bAK!(DjEgFYEI~Z4EhSjXSfu?eoQj z<>1n4W2?2bh5g#25gP^fy91W~TL}GOM(Pme_#MyJJNJ$O_*t4TaPkb2WKDcQe=-){ zdThBO0ShEHAT#t*pS_zQ#+Wt94|@>j{xAKr zU+#|fsXerWQ1&ii5egEP#9Fd-6DU z2}6Hv6LCqAzn~sXDlqE;3QRf%7|}?$!-!x^Mv}^< z`%``R#3&=TRGlJmmwOmHHEV0*VK_uO2*|ZFf7%s;n?J4fV$E>S1g7t&{P)2E#pC%2jLND+N6t@>AVl z2%2ik0pICVFrw%Wux5yN20n(=%zY$_N=}d{xwy zNP-h)^*-zG;j);rJF2-!VTa{Pm z7Gu|4u%t;<%zBOFfP}BPS*J7IICS?>tm4s~xxov!n8gys3Wc5z2X^;b2Nzn~d!51d zusdSw+qN(;|JG~#d!yLTxsh=oWE zUExV6u!?J3BTPce?Q$44NEis{DQp68*Wp~(A;FlZP$XiivVr0dQ}&!wT*`VOlWAZj z^q~_}A`p<(St3JJBo!;q&Vp@|DV!21dgy8kd&Z49NwExAXkFRE_h`xG&T!i2%X6$= zr;Gz=rM2QKyY3Q%91O*ZymNaXTuks zS{$9XXVcF0gVoW|{NCN({!aJu!Tj!n)!XmT@250UvRI@uJLe%EoRQc!R(uYp%@B)h zAeUow-mOA)dfVyTBNqJ$O09Opf2ffxuXMt@jLMPLA9x-*20`5gIA;FIJ3jHt(!dmU z9vQ$C>QEt|p1jA~C&m?1XKl9DJ)iF_w+{H;S(`7ayG1Y0Sa<<|3Wc_gf6QRl-$E2W zvfqz1+!C1*L%e-OE=21+x*W(#XqZ0&q*{BLRxk#P7RP)wLkO?qbj2X+FVuoublE)Y zh4_@640v|Ay8XpJ|KlI~;=laOfBMC5Z(n~&gj6ZuMm7LPK)Ao@N?f-`Mk`@?XfvJ3 zu&D~F#9-;}7QIx*IvLSml@{U=47`}os2Z$M!USSP52$(F@Tk60GSVWF_~aq{}GZ zZKD1m4d<}ql#*z*XtU((B5UnnOiEtdcRE07oI#4*hD&AhIwG0CQeJ^lfygqgMN}Y? zLt!N$ER_J)WUG*pEl2@1i~oijagEKNan|vU;*Ed|xi2l$6f1}lmW{w90#z-sfYOf~ zVsK--Kq_@X{4RV;s{&BA+A?|cl0aYOiUFpfZ@&OV`3Y0&aBPC7^Ria0B z;LB;1Jt$>N^eSQw-C!v(4z#R?R;px-EuETEmQ=EcP)*8Do9QD_RY?#KVIY#Tw7`Xe zDLG_9jK#7HR=B949vsH&lyZ_kLO6MhLeA*`L%LvQFqX01s5%>9d4a@A6m92E=~9sc z20=udvY4nDK;K5tEckNpXTrrkF1>~Z^$3$J8oww{XFj< z*k8}?gbobYJ4D_zw2T1g9?`UvH-v#$r9?;1sPZKegGpAR9Vc3 zcNLJU$>;@&*_^~9Vx<%xawg6go{kgMgnHHamuLk zn*R_o%S-^ydeu|{3Shn_Dc}_cVB#gFCC~yGL}?(QuXzB{8g?b+OHi<|O6hQ2nH~;* zM&QU`ht@-d6vPsV45gT2OBbJ$gard6YnU)gDu_gq%=GPyp({-yESR?EG1LZz;~4GE zd)+B+&RgGuZtMJCGVjdPe0{!xZ)m(3)( zGqR@MARjI55SvdYXZ;tRpL~1z*5A7Q?0$FudVhY5w`{kzuXHY7o;{rUS-ahh?#X6r zdfYmjwD)%W=Eu?T^8Q^r$``NB-oDemf0y#JV%DE^IJ`w;kJrZ2TyooD*X9$3BOx`X z95ZMKq}R8z9`kD_{xGVu`jkjSZ%<~v8xTutOMcX=3@ei9zE)rqqnL#+&r&V0)hHDj za~VD?fo?74XX(^{8o_sq&wK4R&L`8I#ok2fB?o#D!kai(m{m91UFVSt2s+k%wVzQ zo>Vh0#0hX{x#8yE{N%O0&HexGzx{K!KKpaO^ZHwxm!4a!W{hso7#u1(F183&*5DP} zm3awjJuRn~BBqkSBQQEC0K_FP2!x3J58{#Cnk5p$19>q>czRN5GZ0D;F-R8bbx!Vy%}YH)}W5AK$-wN9DQD%Z4J zljbk5kO)~bD#TQF%`BO(rfVT%P%vVtwW)NHBBw-9NkW-NJwsQa!b|q%l>KI9Bvo@- zg@70_^dJew?;@u6kuP9ksH1{obE{2+Mh1BZn1F)hmUL`aX%V5+O0opXR)CVl(9AS_ zb!@}|mvgdM(ijICFpSSBIY7zy@)KHTbJ;SizBWWk;Xy-_b_CTR3y_V0N!Aj=B!dk> z(_7A5a?|oV0Nmz?iWMSgaR<(m@U8YQ{u93gFdXo~MJ=h{c!nA2YHO3C*fE@uqN%!E zP4HIM!HgRLlF~wK;FZ4+#70S_6g~N7oV=|26R(s?Xk=Y-mX&;p6hKAjF_iHFC@L3_ zA!(d3ULsA}za$zL8AxvUf|*!Ti1WsuL`vKwRo6rBV#WX* zEr#t3)9{QR-uc*vul}vS@t^LU{O?C#UGwfAphp1uZwtPu59eo#r0 zL`&@AVnT7(8cz=5N#MWoNO5hkQW${?(wY*~iJ{-!P)b%c7PahD-jb{((}lx5dZX4^ zxAky58+KZ|)D~>9!Q`49CyYevrU2AN!Icr27wel~6F?^=tw-e#H3OQt;y*Q!l8_Ur zpefyK+TlG1+2k0IJIlL_VrSTLi>Q_PkfK*%Ma0Tr>H}UFn6kpE)7jbW&;f_kaMWdL zlf}ljAMy(0;QAHb-kl#Fv*?+Dk3?9t%v$a3t=X-6{jKxvY<2#nce>y6?)KAs8Q`WH zhvS^^R!&dWesCpow6|tLMc-H817fW3=F7o68Q{B4TdkeF*3N!=XTLkz?e{iWm%t~2 zS@%EULs5CNlkSLzw!%yl4H;;QaFdxTbB~nO0mTTK+z2lKU>Wd4OV*OE?TcDNFL8k| zk5bKxfvbf!B)FAkQYC81GOh`FO`-(DSD9_xN)B%%0GMv5!2Coq8d*3Xr^QlTBq1pF zML^84rXX7r$wS-+I=XB_zu3p}k~KlxKp{}rffXTxX>%k9IY=zxMKG&+M&L-wBotTc zdW7}QUrr!_7!|lDRsb*jqBx@4g94#$MQ`eI5eOrqafl~&cgY5rcrPD_@YNCD3TSU_ zthRSE{lC{9?hNe44tepH1^TT2VK-aEqwOxPWHb5YFtms&rx{A?j0dvq=W*xC!RqwF zcmA7iT(~=Z>OF(yxZCdUwho?J?p#^+Hh7q}oGv^2d;)B5Fo`yOlk z`>yyuTi&|uR-gS2A1&dNUAQFWqB|P!f-glF7cVn1bXO)TQ3hhxCiJ+$^B$oP)TenS zBQjI|oT(FdxnFbTYat@m(AKXC^1#mCF{2r3M!@}O2iumihmON3XD-l?ZT^}2w{y?8 zzXt8I&g#{Z^OKzgFWK+xwze4nZ1Z^!o}lp7wclaux&DX6KlK*1n}H%Fn>D%i#%7DB zBN-2vJt+v<)hu4y8T|>1rg*8|Bs$8xv`}@P>3lvua7mB3%$c5jrkwv{I)q zL=?NYBCn?B=b!wckH7rVb3ACLgJ3?2Rfm#Cr}aH^8=wElpIoz)rX0Ah;;0hE5`-E6 z+|8TvLa3M=b3rNVVW4G(a#ToS=C{r~)I@jURH;%8iebB9u!+r(+YW}np<$vqA%|qD zY`GV~vvH#5pEzY}A}X)Lndo3sgPW_!smw&#myr`;bIlOpXk-`e%1rnbeI_N5hzeLp zK!ryHPHZsE7}G5Qfer@+#dMTg3MTD~-mwXJ zBCX0DP++m3iw}1o?EOQeOZOVH@_+^2l;A<18G*&=>GI(tIyaq-L3eYL-v4SkX5x5o z^$M?Mg2)KL?N!j6F#}8WhlAyvyWQQ^@~!dgYj^se`EYxQi!9jkrN3f_Q2KIPyX_5zAzAm|9x^}4!fxL4b4y3Mq&jJt2sNDk&t0<3 z9Kyhj({Uqp(#@GPpqf<_?Gh_$*e2)92Pl`Yk-7{mbeg4rLQ#HFR0wXp%D3(-$qd4E zj55c$kd4L59FYPLNv3B974yt=qV%DL9KJ~p&M5suumtVjW3{kPxe(D?xj{cQ0FG?H zSbYwfUWu?uY^H+fI$ENm0+GOoAGLk^vlv87Qq{S{8KLxVi}_KW$s~0 z-C(37);hy9m`0LfX;FT_WExyyaTL1Gn$8c`@({p}N&6zMPO{e-?sNt_12*IL6A~|45FjU>~iL%qmjh6APdrC22vAnvY<&x3+rwFMs>)+FL$4THd*hP2DV?cayTW4=*YAHby+< zTaI~VK|h`8dhFmdC+d>FHn!yAKs?K@sVJ{q$pY;pqE+1MwqL-A;YnsMUXze^IW3YqcW@H=mm9-fQzMym(Q#qS#f zq-6*+=FZYTfLj%&NLvlccudxVfeUe0|Ng|Qb$l(S{o%c(Kf#Z6h!G-lk@Qp|IkO@{qpmC z+oSwS(FE}*dYmJ$5qSbo5wxOB!w_}?7k4h2@qhm(UwHeSJHvrr0+u2dCq4||prweB zDY(%i3}XVF)W6t(3*f&$`wFmBHiy(Cang&?)L9#;uD(}6h=x4A-jY{4t-*(zR-o0H#sP*vUAW_7SWJ^jE#9A zCs{xpPq-!mCRIKm0m7QDsFG|5!z#&%P^ia;PGB0q`nOtw7Wk5`sy3-7caSedv}&9p zgFv$K&~c)5LSjj!l1pMq3*3|gg8%`zE-aC!ik@|=S|G7*Z3AXUM^@6*Y>?*+SA+6b z3N68pG^8-Tt=)w0!d z6%hH()L?pMWhLZwfr2a~%7q5NY(a?F4kAdRT1q2~Bd=H?MS<$oXvJ(OL_#zV8IzRU zLN0`vZJU*waB6nsQbx}vRGnucE`?|7P1dP-^IMQI^fRM+X!A}V7UP^y8{*?JJ&zj zVcAb_u+0a*Hanv&qIm0mo)FU&I=!3AyYR?R!I5*j(>L^E)e0(ZmJ4-IAt%l>z zdyDKkXX77DsWxw776KswxOI^ph#4Zkv`96Dv-XcTN)=rR6t*5_NWJwhpyj0i1QZ9Q zJc3zqO?_@&l;xB--6p-wsG?C9CD8(n0J$dTfgwebMI%WoSlFAeDJGv?YZ+4cI#~quU(oPP8e1! zkH@RC8Ovkb+lM!L>0qB8E^pp!9UpZ@8!Hy=osao$8N+R=EZ&)M*gTn_hen_r^7FkS zH8($a#ktqhoEXscK764I>4efixsoT`5zj&)0%jrW-zltl&dUl#*8b4T=M^8qs5D_` z(N%lyUZ4DYR7SbU!k!j8{bILooz1`Ua53LmUA*4f*>3Y=M6oG5v5h#M@MSYF#LEL4WOgX^v&yTJw?FjpPqY`qU-_56-rK&UOH%Jy^?Jk`WeO=v zSPGyl)(|UM8$lXmg(Na`aJK7zQ{7R(@@)y+bGpaZeM?8PV5ZmHUl&STEq}9r7B> z(SqPaYG27lBu_GcoHQFd5oxzTztfH}Lrkh|UBg$BG*p5mb18(QoNU$}gMpRO>v)t( z0I22hoxkvxKJp`>EYdTZ3sUaZE_ zUhDV*Dw(+>8cXxOsr9%|*ps0Mr43j|&&(akP_cNz78Y)bUGCtQx8Pu-<6Iv5_cL3F z6i;?F;Q!AFLjoOg_l!g?5KE1-t`9OY3e%z6d~%0PPgr zUBN-rc^vVWw)9pTC7IQ^002v$o_F?q8yFz5)R{#Jbl4nRYm03Z7Y`3R`xh7z%x>Oq^L{RGLu~ct zM`ITdTzi)9n=bCX-g{;>|G&Pucz(b8W8cS1(Cz6%re@;-crLXby%itc^Nyq=0Ez?e zT{r;IfvNgfBwGO=Zc2Dj`zi2HY5np%PHT$``fP zF))z5VWD*o0F1J}NKE|GvZt9apY0Pc)|~Mna9n&1j+IM8M-fEazB%$~^DHCLi&5V0T_W+WL03oM5)NtQb?gdrA>Ea2!^^p%jG zB{$5;c5WS9k%MHMOStt|1of44Ud^Sk%ab2oaAAi~KJ$xzLJLutqUM8NxQ9-{;vcq% zWzQ`qq|p$;Qp1^-xl{S%BkJ(-4_wZ8Q@;1~`yT$U-Pn<~>dnjWb2vBkN ztSsOJQD#K2A#9izae0>Absv>6XmQKk&XNUvtA6`;9xcCqvfR7ex_r6CRz^FUEx+tH zbUoE@*kzvuz6avYKYp%+RY`vL*B-x1rwF+62g79nO7c#g<*_Jb_QyS7ANSKca75eI za);%7?YWiXUNX%fe*!-h2m#RA? z2RC2@le_6LqBJd>qN%+(p>Uz2BLYB@ErZdK#p=*Fey$9+90tc!0TdH`N)`!<3Y-sv z2%C^h2VVLq^*rcsi_&3=#(%@rG?E6_>_C0rWdHmWq&EBqIws8Ig+IRLOCe z3W7ZX4yA7V0Mu%Mh0s_q0GA61oqHgOSI@d%U+DPU5v zTvKrXs%l{dw}hasfFWT-anrJPuz-=AlnECD1knOU<{Vr?U<(ysNpgt6zhE-pnp4Gx zeFKI71tuV*$`-0-9RRK-SC^D~C5V+=!Lsai2WR)+`NSW-{MolmVws&}* z9_AQ@)`BU28auoGI-1!?dFCun1=ma^8?1mrWwn7_LHNv?o~ErTplVF~87G3K@!0Ep-K46(GRij;5_Q{Zz?X-X~fdPsrwC(GH7wdO#zh6zLC*-5@rmF z7+A1+IleJJ8}~Lhnfv!Er)MW9(%~gbUf1o;d+ZK$`?#|`>R!G$ed~6Iz5hp@>3G$D z;RW7vUcB+<|4-Gq2HTchb$#u<&pz+_=-Yk!mA>gDonRAU0uiW?0HH_-K?Osl5Gach zLy0CpBqEf7P<~KLC>1|gR;g7|^3f_N1$oFTpgcl?NeF2|(w*+~IUxo4mK zT>gIlG576uoqhJ6YtAvp_>ae&YtFUiT5EW|U;V--hxeZveDgb2kNwuLKj!6LMupKR zIL_u0t63gm@z#I~wI$*}%*}RM#4-cmPvj zcx|2>(iRYM3AZ#MhXqcAw4T?Y;IWzzzl(==%r4e*&V>Q_C9~^_Gi5hO^sLT`Yd2z(B&~dXY}tWe>8S-oiI}_8xC_fT+wrZzR5?TbV zO)FT@o$CgG+B(C@9VirLfwC2EVfhY#Yn#hj3clE)pQnHn2>^1D&PWdm+OrajFW~!2 zg;aM?qJWgj8#$(BVSyNsuBWZxzrc!_9WRk=cSUYwQWoq@9q3|dIdH6&lV;L7QiOYi znk8?Ti>L%C2`anT)Zoww6Lk;`Wa)OA%CeMafcO&{G9;u#=FT#dYLBlkq9;C!V1BF) z6>QqjD;!H(m9}y?6i@fr1gqryS4Oi%@Q|-FEJi)EMj!deN2*@(!k3gZZu|;3$zS>P zk6yfVd5dGJeUL)|vh^jruw#5IrGqq!EGa%wqr9O~VQ3kp^8zvyWC96pQA(gG^G#K=qnoe2fBA2I=DlBj_QvGW#hu+fx^-Hs*V8@2 zd+8>Zdga zZ)q129eqOf;E(|$QmNCmax2_YiRM5SP|BqwLqH9KGR{gNGmLuRg)aewP%}Ti9VZcC!n0a^kum7kIGpcypT*|D8|z=WMR8 z`f9iQdM46`y2O;>fOkb!A%}m^v0TL{jBF_5a4I+!i2)sxU;sD5Az2>B60`V@V56|c zj@Vn1YXg5UO7UQ~%&B?MrNTv?kgYfOtVosorzin$x0?cx&=Q=?6WCFLa3ug>iztpO z)YZM>6fywnFi%NTNLWjfZpNdLF)B`^Bj36n4*4|glLgFtkggOJ4u9dJ5yFMUM$$A> zU3G*gMO9Y-sTe^ru`UV*BYRNCVwGz#RwY|lu?+QLfR7?dS?=>OGptP;C(L$~n=kCXM?D10X<ⅅbCQEw{Vg7zIbGg7z-z9a z+1Z(2xw^V`Wi;o)y$4WrAmKEek%o`vRc4YEt=Psvww@IlG|=MxSV5m@E^CnQbG+#F zpk-dqWWa^~n3hKgWHAwa;t6;Ca+!iY0e%>Y6aQWm@p-x2GQo{G+!y`i(drK`_g6=} z*Q~pX(LeV~Gw$DW{m&lD?RIH)qtO;G>f=_2oc_mdEVpA?NmrO*s2Ic&O_Beq85c<z?n6(4YC!-h%32rtRIw<6nh3c{Toyqr zJkvWxCOb{69K;cEx4DI>G(ny3(n;>(%edc~AxZ7XBSq5`JY{92u(47Uk+djDQ5hu8 zb2U+MmLXf&R|O))I!cqC@3==s?1TVWSUnT~h_FbZ6eP|Ap^c1YdGl-aRE;qPxH63g%$vprcxh<#(R*hh3;8JNY_~l>wolBRv2Y?s- zxk14<$9unvCoyDB>>F##C=QVb?tFn>t29ydW2xm}TidJTH%h3{!XD42uViRtfiFw_ zs;r%wt}$7eu$*K~YY9j(Mu8rNZ=%E^c+m&(r5?@W6)a)bD8!-?a1yi%!6VSKlRyeA znOK_tsHQLyR%4S-f~I!)HYdJp49ie3VKWQNCLLag5oVc6QfQ8n&0~{33bl%&SVK%< zD$7fdipf{Li<@XF*eqe};IPk(I>ew;DvB+f>#O7hy(p?H$-FvTEVhFA8ix(}Ys~UQ zO#@xDp^RdU3@-#_DIywbOX;{Jub`UG&W*1AyMOha@BX@T$B#X-&B||W?e%RAg**mB zx06mHhtsJd5r?g4zl0d}P$jZW7Z431QON}nMUo&tEmU~s#9V4EXtdy4UDr<0d5|W0 zh~Uy#{eEekf;_>qA*5VX%b57P%?76qN zPx+qJ+ogTf1~=AUd>M zuWtA_e2pSfkdw2VF&|)H!xf62YwKJGz?!UtK05N5CE&jM94kgvmtN$-LBj`Mu{vIK z(<25FtB-wg`0$r^ufD%Kdd9Jd>k3N4oM;p=*GG8Y5X+7^X}LYzaIHUAA{_nmX=^{Y zOu?K1bQMaZF+O?#EjdV{iqU{l8NJ2#s>7ZxgHqF!z4%TeE5m897%p_$0%OF3h62MK zJdYjZToo%(;UQgZn$u7Ervw}MN+-8yWvc5W<4Ze8PLAU$38l3L|LSGH5)ujZVw>3r zR2=ZChm%TEq`qnSfSIS@r^E(Zg)OixD7i@Y|;j z7kjVUULCEv{riWn`U)S0f8tA2hIgGFp4y|57wEVY$xE`wD=tsDtbbQ6rq>UaJOlLj zi1z{`mRWVcGiJBpa^hcwa~CfP!^elyIJU;bxeyl*dZu4%a*4>6&Nr*!JnNrjaXQ^c zo;hEk;dB0DwzNZMLP6&^^>x2ovBR8sa3{;95bXc4f=QA@HY6j*+4*Np|D3k)?_ z(Wfg3)H0C_pi(*nuxVUNV7`?cIQ|+h?nJNZ;^-g9K|J3Og9 zvBx9_1XUuP1y&c9d?*cXcEePl0cGbE9>oa|oVH7^i#bx4QjmdDy^FCmY$Wb^S5E4p zLbC9aAMIt;lj-E!-ud>2nE-IXQ1h2)Q3RqiW+5x=Y9WBIWT5MXuRZ7v#2n-v5C6YS zCCL&YLkjDL(6K)?Y2tJ)wb3johZK4}uknl)&57m~DTPf8d?{5X7QsZ;RmHJ+q*4~U z!UJ4ozw}*7w+hHzH;;YX6qSlXVy6yGVT(kuv(6bMN|pjOfCoJIY1bw-D8*=Wrah#D zx*D3a8pTjnPR+_)tYdI#vb4jb120BG6!_@7!J3u~9lwsT z=!(>X0Ls<1COW=dGgJXx5v#`9Q9~@+Q<+*C5(jXVWlU5tLbVVyW=ZTY(hRs}msGmq zXiBc`M)_K#HYp^Tdu}g`B0jK1q7fcFo-d_a%|>c8H+^)6(f^U#UYJsh8HHqW;ALztghMB zRYDvPb76fBtQO@urvqO&&@f$~>RkpJ+Q7?Ovs@wLU?+`%5h=^kg{W|cS+KFH#U`lZ zMMAN}>|}C&E^GG(^M02*2=5p?ci8{l&BYt`m#^MgZ7w!=`1;IvL?tAbwAPCbK z*a_#JVLgI+7tZitMDEu0{5<0%eyIl;^u|D)06Up3m*WlZrS7th-sU0*Mgh zkA8I!Hy-J>xjukJwINRQ0*xcKSTC;9 zvEWt-%*R-SZw?z7HAXp$fCLjvpM<05mU2RwVydfsB3Eyw+yrtpmQKN{5oC+2(9u!C zOR3qI2Kj`5O)TLgTN9D*x8gt)*$yH$Zw5+dN6R%fd%_e;LEoN!Xj?2^KdSem@V+L!`&t|QOPBE9Ztv(2{W%kSIt?t~b zy6%DFfBVZ@&rP=9w6{E@W7!+N=Cy=5Ghaa=2E5s;Fv|)32vp+sJ9L5=(6a1e1Istn}7kX2Dp+sE=U& z$b;=mbrgauAfT*R1(}Ovjw^}>IR=)zQZej;F3m8dksiz;vJ_F_p;YQopP-RJAn3U` zf?~+1padDV_V*GLoAeT`n`D3=;yQC4N@WV=n8YGOkX zMn%k^o1ui3;CKF9Jjg&VzdblYAEuF@g+lMILgj!tJt{lyG*i*mu&VmrK1^tr@J*rG zi-jGk`XfE2lFZQ?tmP9LP2$|1eCY$+Fk|$>N=L{FrT#3<8)$ZMNi70wu;k~a`8)#3 zQ!fSqwdwp)%olK?On{PBI=L!dG=a^Y1||nJEHfR{lHnZhe~!%&6B}6D8m)@r$Pfct z%IX(P_6}AeR~_RIq*`CViYb$1SCepFh?t<;4L7VNkMbsY0?H9IK~XfaT1yTN7BwhT ztCsB8iXydH0}P_<0t3yzJp_s~@0HKN%zTGo=VbxUU2WR#_#?9X9MneZZ5g!ID|5E2-%MLP$nC*(JcN5O8?KyS{4v-M`s=>!wdg5_A#2CSoi?Nn%teSO9l0th0 z2bhS3Ci!t?Q<5AB9145DE_1tZraH@2J*>09*UbSu3*0yJc>YVK*umqbj6q|+Y{TIw zP9GH$dM~k!R-5n_9elb52YJL$xC8l_{>FItCx`RrXUo^`Z=U9w{es7x+EqnIrsTu~ zZvq2jjturZ#&@*xMLiRWSyq(8C~Jmb%b33G0u09bj1}n;9B0fsR{4TeJ939X9tE_R zFE=;23wgn#2Di7o?LkQyZ~>kP21|QVtIq%7#;S;;`!&h zgPWUoo*C`#bI+#FMr0QEm0!E~*dLEZmj}<>SpEF(j^6)GtJ#a)>}EgSZ@x7yz=i>x zSx`gV~ zk{gkjE`oT00--MbcH$@~?hipZzNoF1iD610GgF25#@F6gPEIpp^f6}A0@ZrDx z=<-*dJoTo1*4A``?e0|%VfPg;1Q_qKKjL+|FWl_sb32Kf%x4Jo#q8+VeuxKma#suw z!rJl~K6Bn6>?1ev<7z%-teI&T0h|#H-pAv7SkL3o!+d8zD8xJdrt>8?6rdIp98L%n zTuOn21E>Y-3Em`9!VRRZ0L=6Loi#Gep#^daFOSI`b6>$~bED^dUWfDUFD~|*n7e*?_7~SUxEBaOJjRrsi3V)ofhU(!Fkba@ zSk?RtOR=(^&Bq83VxW)Ur~mq*Ko?} z?D1(RXT>%J56&;M&T-bsAZQ-eCUE+_vkCY#&ga@5Tq*ZrM3GFwQpo9TT4xiB!D$PoE z21Hb+s+IlHUtma0ev=7**~54p+Mz~P~Q%H)!+ zow5!&6(5dn8<7CfOKH>+uk1=ZB=XQ`#td~u3qgV;EGUG)234|39GKkPanmDw(&a&n zKq^sgpI9O#h6481Gf3lj!C8+_2s~B^DO9N$C?&p7YcFhn z_$R*o)%&yA^Dl1l>=!V&PzIiU98`G{lF0HRK+d?LxR^M$YGtsnCD0(#D)^hGn#knG zI6)@zRWf=x-+G7nh%39bO+U4@Ucka%9=}+gs z{kg#_{;I^hPmErk4Selu z4f~2?hKHC@H3VoP+GucgY!m)?W*X3?p*FKaMk+C*XbmD0@{)!>5l1s%DGqj9Ga+iM z#0dp=$F}XxEZO)x%SWR!*B{;g@Z|R%oBYR5oqF|tcY1rd+#bB{;lbVK zm%Qzc7u%iPT;4eDZyXG!yf14$+F+_oN3&S+4BXLRb8pPFc){W~%6M|;oLBDJH7pnN z>GVWv;tJY4mi77lJX+VcYq188TX=oxHnVP;TVCVMEj>Pcmsy7<@GnXr`#%;n#C=Rom?Up{zi{|5LH@? z!;2lvicA4zD|#9)@kUV5?JtNVXVk0t&hFOi*-w4#>xUoy@ZTHHpP!!`^02jpv%P~6 zA%DcsGuW67HRUQ=EkMkEe$5eTsu<*{D1m9dLS+FhQB5tE+(Jr~)iy2Qo-IGk74@J< z_)7;Xd%RLz^|42G!cz&#wB5>9G1gk643av;g@@(}6h+BRBp8Zr*Zi=z*(=!AsqTf> z^3ddq>YlE$R7-Fy^->-iX}RiXO9HC$@lr_aFfA1}8NsXzV+Ie($dRog;sw1=8c=Fu zW;!<1ZSW)~UmFNkaj*-=*dn?5K_b2yr_{<$Qj}AeA)b?RcBnueN?6G>2Ll3z63vJJ zzFQF-tWiQdB@cBp;g`R7mP7!g(3)CG$c0&R=~}WNOd>VR;Gaz)8q^K#DtC>|U&=>6 z{Zl_hDy0&TprowJuDlVafWiOxwcojT>BUX&0T4+sQiiR;C@T!=MJat)d{7M4sc=(R zD*9`(=o?wYDb_!>Sg7b!0oI~fSD{plkV`@-KvFMM@{TKl%XrXAas`X=9KO_%as3&H zl(E?vmyTHifsE8ux5(nl4XzI9TJ@-?oUm>rRY5(Ikz(oHD-!LMUA`k$h*cE208|>~ z;4Mxa^-93#DSqSgih^{mOS*w=`PHGA;1Bn7f8%zVq9?*yDC@L%c5 z2z*%>!J*U($S8LJOHMXpO&A5O?2b%>i$t`sURd}Q0(;z~%+DrmMgWkoN`OHz&2Kn) z;io_RE$@BzgR{pU@i5MDh(3KtKTb!(iMNdYT|dAvoPi^l;jVySPz7@^l{r93j%0Qc z>@{?bW!X|p?Pw!rYLn|$M;m|Lx6#Tb?ghB4kIP9}Ul%CS~=Mjc&REvu!MK0qA zEQP~p;Uvi6j|BG#aPUK1X2$kMnau= zc>3gcaWY|slm3GzAz_pG;_zTF;f-hg>fnfLCG%@HhOd2ic>2up`Xz=i)6ZPoc*pAp zX9nG^Yu;aobPeQBjK#POb+w;HB-80Z92Gmo{^e%rD0dUROx7lfIzXiLSd?-}Wn?5+ zN1s(2OMZZm3XlL^K%u|NNll;>p%DE9jttzPO+YJ4K3>kGzQf#Pq_IR=_52YFxq2a} z!l!Wx8TtNNtW~hJB6O$cmC4jd`roQ`1qzKMcT1_0Q9K4Cp+sLp+LSc>r2ha!L+Rzy zbf%DN5@boK5Tq2f8F7c@d~m%%fc+y*NrVQp4P@#kn!(Tliy4xGj&hEgac*H*P+lTdc~5zr6l+`KP^1%?0H7I37W#WKgCb_pfrcSTdrHFrY}Xe3 zXF8oyQ!`_OmpWyNt08M`s_4${B=R&fgC=If<~@^HSvPz3$3<@QG*pPhRd8 z``vkl{`;;A;*82E9{9tJzdIdwH0W7i?_s^i1FS>lFZQt6&bmb%0C;mD-V6uTR!`_XCC?NqnrD8Wh`k;C5R_HK?};- zEU03lGw7vqb4qR4lP!>Bxs#}J&QC71VoCP;H$voLco(l?D1mZin+P_p#TGD4Fc>Ko*&$Ff6+NDqpkf}=9 z(%+dXkf9|Vlcsm_kWMA~tT3^AjOh@ZL=hV+?iLqm+3_zqN|#GU0Tf_L*ktTviO_XL zjx;8%jruU7I(qY)BV=^6)QuwQg|2ogql$_$h)DWT<=`?wHMQZ#tiouy@C7blK2|cz zJ>kXyGPSRkoqXG7+8JI@HMs1WT`H*|N&ZpI*%Ldd&v%L8o8t0OtYI=$kfD6`Jnq(@ z!n(3A(BT%PU|>5^lR9r<<&Y7>gkbfB%7G>l2rK8=>_Dlq0ixNH4&Az}0IDf}gkz%+ zNgdZ5D@43yVzyHVD-DN1;!Eq%Ax1Crq)5Gn&XHwYZqs6&>(xu&{hrtT!1sK`@|n-^ zaJ@0_d*ZANheZ!_9tYv3e220;`dUt5q&*|spV&m$79uSpo6^xLURF&6Ql9v5FCWKVt>qscPA&|FuiM_Z(-(`1iN|(g z+93}KrO9HL3M0X3dj3I#)d@bD6{~j{F)-{$JBV5Tzsn_r;fV8&EEzEHF#d{B1-9fV zf%a9HWICPOBy--G1w~k6Ipd|K@bP50$KF^EEf~7U!{>zfP`v?zB;U5g9g?&D#goOg zE4)^eTY<@6JoVTHk4PV$89&%v|M->ZfBW>gAANIw?fJY!$tcn8i4i?w8PM+NTmWJ478Vm05skt)aayfo-VJzG~@Q5T$5Q}?PXZuj5KZNc+FbjmKFvMcp2gb z9Kk@9#v-0W5~Aq4A;UWf#{g6XDu;=zRnI|2286KG*iDaU7=OT9CeUJLkcmXK-F1iv zw_F61m+T>gl`6;{d|J=dN7i-W4mB+ifF-ISmndk37!VRR6oE|g{6-g>O!O{E&Uj0* zJaU{dcDT5uCZ&e)ZqrwU#$3;qqAPXOnqG=;8;tq{y4k7WD9YI@gJGNwFYO<7!XLAM z2+H`EWc)={Z437@SkPpUDo{A8SadZiJUtAHjWcJj{o=I=V?5w|HaY672{_+Rvo`X9iT3o3oNM*D2U-@` zVG^Hj4Oqu-kI%{av3L6N=Ik4b;h#Ufdi?rowbP$_#ehozOj>yV*WM2A=jiu$xGSLZ zv+sL%#+b+Zvi6T2hR1C&-1me8gZ{+Nkeiz@UZ#17AsX1#!Fa}wNbBlQQraH7 zn;_|8E$oo#5j1hUzNwV{LOn>+3Uo1rgo^a#DtVcM6%(@38jHz?nvhU}(Vq5SJ6H`1 zSMMuJTr=LDPcHA?{QZCak?(o>i_iS|6VL6Odj-p_go!uoVS*W_ThaEZLZtZ#Yz3v| zlR>$2R_a)-fk}Mg89ITgh2Qu?ef5%_Bt-&+16;6_1mR;pYcW6aQ@@Coy*qXY87PNQ z71?xDueh~(SV~DyC;|HvRD~%tkQGouuw`=HO`-jbk?S9sX;;X#zXB_bQu1P@BhAPz z9$sdL7}`3eL3zN)U+Zw}qD&Ni zkPAUXi8rZ~g=rPQKw1U)7w9HZT@+StkPS^tDp+y4g+Jw$4hph_u$Cb+fvA%D+I!_k zGel;L!&iz3GXf1twqnxwMU}?ap3-Pnu7pXJW-46|SO^M>%!x)}!5%g6p$2h-L=nj} zI&pBqivxMNL(|z`+1xZe=UNe|rOHL_$Oz5~GMjJG@HDpoT59ce)zCxiurGG7h8Ox> z<3UP}4uA2tOtX1)+1zG*B*4yZWq>jwl$Z`zWlR{i^h{7?$V(FJ)F6aV&;&%3^3NtG z(p0hr>4aec&%SifZT2@Q9WbK7(zl)466U!MtRgV<4rh z3u1o4J;i9pQ%h__18&4%F)<^58;_EBJwc8}+yc!C49z;f%Tv7!{r--ClVFfA#R5jQB3g~ftC=kLQPJkvz zgajG%9xi~S_Gs#VSZfkY20cnMpv>4Hp{|txiH~X*#^M9H_o3opjYB_M5meBW%NCDI zfE>OHDJAyMXqtu?ZXU<8W=UbiQcyWiu!3W`7;^Zsl$WVlc1Y%>CmL)qp#)ox>TTlP*OWZHZ1B7M= zJVdAOZ_c<(#%*=W6HLuGm{*c)aFJ_veC(+QuAw=DAF&pWvvjQafv6(M8BN}^0bb&t zaX(h}oIjnHr}`1@t@d_a#!SY!gYMeV{CKv!>lCjzgtxj8N513Gl}yePob%Ck()l~p z&hZfUvN(>nkl6xVJ?C0~mi`}g-DjTfKYw*OS@!4d3c1PoSCQF~3s*gD^Q5AL%Fv`l z4mCnyn{p07HR}$CTl>=&zxaj+U;UvEe)kXm*ne0|&ko0XylEcD2{loQBzx84#rzEYWhEYroW=B{i z%~Yf^0VP{WTdB!7hKiC0d0YYmXwr&ufT&XQ6oJ`O)ym*WjC$@(7u+@u{K8dP9O|j3 zVv#~^10X{#Srp&GD`#;;1LepDocg^`l_AU|!mL^ju*F!FoaiZAt65Jbd?B6+{KVRc zB~R5;F7kwdZ4PuflPGY{J*Wnm;xipTB<(3Ktr|Z>S~{KC7DAsn> zkYNg)h#s6`>*L@5!m z8&>Q>z;|pTi95FG@`a+ytWB1ke=HI{sURd0epM|=`S&2GDP$1|1V=I~0)oUOgDe~% z_M_~41*p|u;+&lbQyU7hp;iP|yMSve%yjk;GgN7cSC`K0+v zJ;~Bv0Rm4&$8|G;K3$KIWM%i|!8nsw?an60XLoM>(+_>yn_k)7`r^}DJ9{*@C7028 z!ViZWk}lI!Wj z7KDkJ4y8Syz{n%6_aHNrkS~WFkA@s%IEPo(a6Lkpa6c_C5HuaX4@Oar(H0fl($kc(@0kUzV$bh-(iH-d_pVgQwK z8P?%;#?A3)3={`(@M7FEn!%XiK|h$y7u*rO!%c+@_<2}5^%>vHG04)H3=5VAQyMSV zOf=Kj;n>!x(XA(sCr>=P{l-y$gRu`oCruIKYjN~~3E~o3aU@?rK`RbV+7H|k*`mpJ z%xie+LH4V!prj6AsR=9X6<$zoY?SP4z$s=qX7ZwbxEMj*RYQJjCQH_AGa+D1mIEtP!F;GEvLQYm7MFIScwQ;Ou zP-sxh&MzVybReBAop4GGVf9L{4xzRj(T?nF;e!X6CphNQJerpe6%p?dT229vthCbz zjU6IfjaoR@W!O{=tBU*_QKCjH8zj*ym=RIFmAw{rPoDhP_+r3}o;YKTfjAMp=WB(#Mnz` z3tNnhh~XpifA5sRhYQ}f?LgVH`ONekl`|D$^BhJ_5a4cvr;BHHtxmlCoALFCxA}@0 z)I2Pdw{}wnby@ery~ZYpio}TC;T?Yt$aUtJ8y`4Fz`FgN!C^o6%PZaIt}bazXU=r5 zxr0aPa%qBB{|dCY&$y8oRW-#x;!|G7h8bC;<*@7!QA;oH+#^5lmntFoxb znA9AcUL+E7r-yf6;B#lo4rTy>652-(R={W{FML{Lr1-Dx`6Ou~|N7E!N@vwpf3ZY885$Cd2DA6WQHm{OkCj>b^k-MzYOLJkBXPa&xKl_PqfA?Sil|5{gm}8vFG0 z733o!&45Z$ST~F_vI)T2T4gqLM^#h$90-LtovGQmqBA z;;Fm_TbX4JG*K8ds6;R3Fx^VG@#715%B<-8QM#RVQ`jnDQ9Pv#4D*$wsggn#DeBcG zTgru(DwY*oGd+&uZlwZD7`DeSNc8{)e)R)dow72D+)N9jn71*GU8UZPU=lD+Bd~5z ziIjvW8WVp+qjxE5!{B5puM!j>P(uNTE|K4eQTwnK3M52h!$XZG@Fj6_%VwE|=~;}Z z0&Imy0iuDqh>{y~7B4E3NV*s)-wH~@VKO5tRUshXGHbw#CYQgeX%!lSM1m2&v>L1s z*=W(n_GKvOsSqg2b0;x~%{BDJI{>Hv0DQ@&Y+a%zs?~}_#C|qP-KmI-VYPG#lXXEV zZqoXnTz*nFHL2pRk}S-h!cmdKAzx9f3V}v{ZyRU;B`dAdFsxh>q7SVZk#<;Q!YHkx zM3jd1^AV*!1p|gDQ*1>_L?B4RP)Ll%U!L`aV%0t}34ig& z|NN*^ssxF>oyZky8U3zuB`*Z2A+v@0+712D}XmTbs?XZ;U4d922Wj2?ub>hR}AUru#m zO`OH`a9{hw$Pa^PP47`=_{YS6X)KGe`5Uu@iTjbkMC6Y+QK<#7(&S|BkZ09%n=+>1 z?aF{*7-WpX8XdvFz{sAOH?Dd`hszd=>3n{0gD1FqGSs6JBZ&kXvI!n2bx3R~7k$IH zCn;PaO}dUC2z@#SGVN?o!jVLUscvz=0utHC*f6#x!DEXtJdH^eS3&}VFKnZ=(o-2I z4tuKxg%Zk6KBO#fWn|SzUI0)zHi8*8g4!k%p+*dKtY?1!DDcHZ>oK>3Z>R%Z7}CQp zBcw34Hq8V3GFQ_i;NV&fvrpMkk#ElKgVK=)oKy`ZJj2SL+?od2A%YDCv$bBB%L5uM zK@cIq;-~=AFmSLcturt!Tw>F5j6q_v^uxo}lpR!9g|W5OM6Q*{!Y!bsDtmH6)ATS^ zfnwC*l(Je1DWMV@v$pB!GfF~4u4KbkHMz3}C6 z8(1`xXv^w*pWmM@OXuT6HeQ%5Ncte=1ggvpy!e#I7^{XJ-WYN*Z8~FK4VAa>vi@Ie zK~BVZ8-OS@8u#4t98ogaqraoUN)U{s3}}?&9prf~Ki498NDr3V8uJ8C8~9;AeEe$v z$hH33Vzs^3UpVJIzC4qFyZm-`20Pol+?NRer~Fqu@sm^joc`yvY1}f+jlbh9hW>nb zc>-_VVDS&r0H6Hhm4%!T$dxg=0B`w?XK`W1R!(o6vWpGi2096^V(1G!PF|u3^V!5K zM}I@iDADOqX}j? zABO5Eri2?2KxG|e1(G_zOxXvU8rVf3IuT5iVIcs=iS9;JJdm&MfR#Scuivh}LD|U4k z7}T09lTNK_?PwcDP_+FLksV_KY$dadMSez*!4%fTgeDZ3(l!7}g(6llGk>2b$^%Kv(4| z#UIJj&kDOWp^#ZhLZLaV)P6FNooZqsTNe;<%77o39l=!9kWuW3#H6J+ZOFmJRCpy% zZtOF1Fl35*tdijNlp!lkkFQ_*mao72$3F1ZjTfJq9nW@7?=R<5Bv2_0kZ@xphuuJl zVM)L>{fnuRPd)$?ox?7uK#Mm+9Fp=RD zD|R{gMyvAyeb!_|+c6kmJUv|S@Ei^1lh`?*ms5dwp5YD$O=bdQa;Z4-Amfxda{z`( z-X1_Lt{8CH2;{!>7!4R^a~h8CMaR>_d9d|-i>HZqkK9`B9QSt(2j@rKsg2ckdngd6 zxdvQnK&bO34#fd^&Iik%`S`<2c0J=#2B-C~b!fqPzPi5rMYtni!Im!Y=uNj}cD7c-j>cwquVnDD?Z z9}t8RneOuR9WEy_N_X7Pqr*0PM)SPBm#cpl54*p-(m#IC&xZZ}nZX06x@{i+&&@bn z+zLG4#6RczeZv=n{%z0wZ|^YZ?^rCvd-iyR8O!mQB`^u_Jzu;*dB_XDIQ_t)BHs9$ z8vvX(1B}dC%@24&fN0MWrRqco?D!Qm-82fSfL?nU7`n{ZfE5W!(h;OY+}c>_tKGEIOrX{sCZ3CJF!9;Gg($A10`eTcpXXVZNN~h zf@FkH$Tf;0V9c~!f|y3Na!E`no-xo|QiPRtZ)@EK0BTRM0%RPfawR7_2~O)7m1Qvb zl}7OnZnL(z)CnaVL4vaOKx;2iIXI(x8I$%QIwe_34TrK(2X3ffaI9PZm}qc>QlOxXkbD{Kc-GjiXc~#_&ruq9VCn&nnl)9 z?eT;SvW7nCL=9grE0c*}%klxEuGG>KwNa*R6eo52N^8{Em8I3RUPVF^Va3?h?uFXg zRn6s;Ba8`ROHpA=;g<5&_MrM^L0KiU%cOPt-E{2MDj^;(6|f-P`5jzSDrG zCf()v>g-~0&uDPRsN1t=^SwO`+|aPJbGcC@8P!e?j0Hydp8NMrqCLxnx#q&IYSIg# zDPx{kV8&q zCj*<4bo9dGTUa_)O*MkCu(Ht(Z1D{dCP0XR0Uty$2IN%=OCQ207&aJYV%ks=pOjcF z3Q`M*)tQs$5=0GFCsX;w)*h`RrPAxj)&`c~BL@8t*cRB=u@&)3hZ`^=P6B&Jn6;xg zW{64|mot0G(l-KxXwo~>rY-3RZAfi0lqy@klZjzNS(z^`+QPPvQG{-&hBoV+qiL!hvasLQ|`89noaEXygh@4 zjRfK!z(g3TGNea+?g8M{!L%bFXR6@Cd|+=wBT{{lNIzj%54sIT`5O_)j z0yHi%RTl}YmGhy%=s@$(DAdFJTr1 z$B+K_FRr%F`fO$`=uYoP3u{1F?5f-yAj&{iRMB+B#J(cL=9p)PS>_0tY{6}F2vb$5 z44q0(hG021NH!zbVa6a!ZAHt4Rvjy?-5wK#nF1x^KkZILu@¥=a3aBZ5&RB&39= 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

Gh;x2 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%0Ay(87WCRGKY~R3NnrBUm!SAZ0e% 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 &{uJL``ruzY`Lb86oWC;0 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¬cvg;3a52Um}e`X7-zj6dAl9K!_uyE}(Fdxtv07sv9BIl%a+E(@viulw1CYd)uZ z&NugOu1__=Hz4&X2anY@rFG$$`9$$yYYBDZslwQA zHki8BX-*n#&`3&kGoz%1jwTpIP6l|w3EcuokPW^EB__icR1vn?^@mVO{L?)q&;kma4MZ@ksZVGNmqU*1w49v`~S+~xM5nLlx z$gw8WEsC%HG*Cr_)v3@#KOqq-t~EAncWNoeHU-ZIY*cEcGUY}z z^*YFp<3*dTF|3lv0D3Q^0I(XKpM2Z)Z+0^5)7KKvkw*vNtXykD5x4ZqQ;%Y5+j)$# zzc8Q&`sT*__g_3bJjj8#4N7Wu2?ZCxt2U_I%pBL4@nLKl@f&j?DyqTZR{LwOzsx%* z2A>uL*mLe&u?P^6df4I9YemszH`A8$vM%UMyfh1t<=nJ3=$Q&EQ?>11D!XQ=p&^?b z^H{g!uG#@%Chy^sDdnau4xwdNg<&&*v^((fNkOULUeLwAVvKAmaXXq55-}hR#R^P- zf+Vj!eDPoeIO?TS2L`-(>eiz9Obvg!uR~sJzK6?-!CNuG?Vu$%W;r%~Z^mxA9~PTY zHayhRmQ==Dea#1rS}yS{i(!YmX$yf=heOSwS^HtRQApYyddn1@;fWrk(n0^OnD0W?$ND3|MO1|_OJhgf8oy6?>*x! z6DLPp@RfDsV^c@Q8&TJj$vn0nc&pmFaB;oqj>Ui8gl;~P5xqxiE-{&O-QtsQ+M~v> zvD{(?KJ+~)L>h1bGdN!Cw5t)%eil-Yn32dmNtg`UW>G*%Ge4KtW4V z)xhwO3}Og%-O@oM6ou0ik&ab0W;*s8bdKm5f`Ul6*afGFcoW9S1YKK2kD!gK8q4SI z)x)8|YnT}^xXLOv8jG+&xv4`^Je}G`+p$f>beWBIY|m(Y6fgGm?$!CFALy4W|M-?k zj+OVr%{lK8qQL*AqDu}pdneaB+zIeM!;bj}*PFeA-TeoAJrMZjY2l!6O+oHiuUY-G z7Uy3Hh}S=GoP?swsA9%J3~6w7_6|_k-5mMsznDawdkSBh<||Ekga0|iu6gGYfUf=_ z$^QfZXWq)6algUSZ-#P>j{msH4%0MJnfo%awowFO+^22&T`}U1gweJqdd5pk=wyR`ND=`yO z+RjgSq^?73(AE@BT@K3vO~w*K!^u7iIlJr_5|*s8^X71TAvSW68#)FhBj$*>g4D`M ziBJ#~Iqc3z)B`TozDLW4Jjj_QTSEe>B1p#yl!l0% zhruxc1p=hI0H_Byj!5K{enC~bt>g7sR4_Oo+P45nqD427WRMeWP-KD$<+Fb)orkXY zzrV}^d|;HaQNWb9IaF&caKkZT+HSXJ&(sXZ$VTA}xz8 z;~bvrDva%5bZlf(N$(8+1>Lcz9Oq7tDApOu+p1hWY7c?tPLDlURT@!Lrp?v{E~2Kt zXr!(-MN>``4*WIKIP%u?7zSOa0?fxYszbyA$)vO>HOICYE6;4P0QcCt6V!y6!eUOP z6rdE8(DbKiWvIPskJ);UydYVvGJ2_?ZmQX(*Z>}=2rD;!m1~o_63Bh6ij1bz)FE2b zIbN(QuAUPjnkl&1WHJBQx3Yo&(co;roLTZ4MVtVxaS%_%kW$i6WGg0Pb*v0lG{zXx zk+uQf#!oehfYXC6_6hG|3m+Rzk<4k$Q|ggCIXU{|C*R}-;Ntv(Z=TCNL6>V|YdKvM zVrzhF;-caPG~|j5!IIgHKCLXg=saX>y579<%7f#h13qC>-}rPV4Vw#eaioe0ld9j+ zcPx?H)@e=!RN7NglD+xDMp~apbgInrfo%7~K}}TyxdW*WY*EthE-%{Eh=M~XgEglyzGFs} z$y*MoaF`&}n+7I#7ShB){D}h)iewPMGQ_HzRzRg7NPHA6JldVoG@&znxK8z8fN=!e zVUiaA8Gv^_T`JitBRHaW-K7u)QK$-!$ITJaB#Ctz3dwGq?J*ZlNz98 z6mH;D$dG6y4yR!i$R;!ChtOe*%n83k#P|>ZIciH`W<+74$T@Fx!S48OBVz2cTy!K0 zh{oL*H3T-e>J7s5EaBYRlrSjTh;-Kl8qFFlcsT-&_-l$@v0&HHI5cB8c+`MwJHNzi zI@D}f8uT(|!p7uGnkcaj${kete^N^E#XX=6QC>9Q{t+BLEJA^L?hRNo9&nSO1Bmg} z4*qihzIW(A7rdPHT{PwuTJpz`TCT1A@76uMCjtBAZ9|(2ZYHGUw{!Np-h08fKKN+g zyyU40Phg3O5BPZ$%dZTVw+4ln(}hKWyrj*+;ju~GSh@V7f}XWIj8Zo(3JC@~+Z7>- zhEfTGjcomBR8>=P=5*xnqM%i8wlkcVJTagE06+jqL_t(RFxF;+%5HWi`rvxWAN#h{ znFudQJ`7#Aniiu%i*yvVGFoLAmQl8K+#Mvt-uWoxs)W(An(lD6Ue0Tj4WJ0gMs1Oz zi(yomQlipWcHIXM8;j`TO`D29(o!}dAmQATJ10?Rf+F~wG@IoNc99f9OU_{aBMxoAjpvF*|QoVH(3ULcWntFrUbY(b2$K11jjg^?j&S;f&RAero zEZb_RMRqFEe^IHdV3iQa;9yn4sbVF!JuRcXuCV1s)JMR%K^l%zQRmMNGl}_8j7TY$ zZ|g>u`A3TFoq+5rErP|ijY9(I0Z2Pi7HZZi(DX9$8lw;VrSTMmAtdeh~y^ zcqncDhwF?dkz_27a2aPF=o#U`F9UA7VgEqKQUTCvJTfEZa+Im8IV2u3$*#?8MIhuI z?oA6FAggzb(uC7cQ0Y8IDd6cOiJ{=mCi2%`FGaX_`}WDlKmL&>Qr*yEv6@}>?F)$x z9T5gsSuP&dt2sh|YMQ$0(-{RtjN}z>0eazu=fCzgU)~HSZtm$b3B^q;G&%9x;zTR( zvYn=|3nLB68vY?|CL~>l)su!qy%3Qj0BU7}x~e0*W!rTURDsyEmSx)ughvZiY^4Ua z=;9J0{5fS#cb7`UKOQocld0P;yCyHYWa!8ILv~?+=*_0L#H~!r6JvlTuFi|i^3eVV z8|{S2=P^$3=8Mc~M=@Wvehmkja+8ChaFAKEn4q9CheCl!D1&3MW)#v(O8w;5P%r`$ zPwf~p1vH1Vz=1M6$9MPCqr&vc;4q3vyTnsLvYDMxG_j>3TFwROBP%S*sSS5E#|9kKV;4UkbGIbm!_}m&+X9GFzkSZOG2g}1u;Zyv zz?!;YpzO7P1_71WG7Z*601v#Cb{6S6D!qi!B227t3%OOwX`n=6#-(W@JVDYtDs!KJ z`C&Pvwr1B+kQxFd4h72TpI^>8P^$B+p}PPa_9HX;)NqP~^bilBG_iUryJeIc5cTc6 zalutP+XSw+FnbED*{`gb+tQGD(mpR42h+QQ1TWhwV9Nv@?l?k$P#n0p)}7!6RJ*9q zO6Nd@Mbj{ucLX8phje|36>9VCoc0bNK9lyTFwg!WCm}9$0I~k!-T!P(nJx~%z}CzU zKp7TyMxeQ?YrhKiEun>X?b3E=7H{)Fk*y0xC082b7VQ`g{CHWt`4le>YtfafP{huE z&4x3^!~hFiUwg5|=0Xt>>xx+`KmQ{EzQQhE zIzZ!TEDglEee$k}eoeuc6&eb&z~GHfG8%HWI>RgoTJ+9$->tytZ5JUi#PteW^n6-K~kNgW5-e*li zT^*LG*7sTR+JQ_D1(0$g)}>bbOe1KMZe&wocV=?b@wGp%Y@QsR{QG}x^P6wqK0euJ zw&&kzlc%KvGWNBPR8)lCbgWBc_%?Gz+qu#Ffu@n5jA>m*&o1YXvp`fKLFE;;ZOT)y z#%@#3S;csI`#DhRXV=rv45%_=r&7|QXj&R0bObgqhnZX!2yTKY2`O3sMzS zr?hp6@`PO4rM+MjWZ)1|mKFn&CEDOQMuE~ne>~=ercz)Rv?uZ$q#+JG)zpX(ZoP>u zFof5wbi`igRSXoo2zDshXk^NAk)W?>9C~ZicB)CgN8%m5i8Y6kOdox%JVH zyh52@OpFuILwxaCYB?#2V!He3#@(%2* z1#_kc<(;7nSvDvNO=fzX7!#p1%!jLX9RXP#W}YZfT((>k6Jq{^MYEA_AX20f6)#oO zDsby2MX7QU$#XSy2SDIOmM3S9jnVFu^ztcKRrADSiKRQrE6@&zA{k)JImHWS=doLy zwr+{5jU|Sm zPu}{i&ph^9sCIZ*Bj^-q#YLZ>75?!QUKD2PS&rf)|4pogsXS>* z(OFAH{1VE`3qQs;LS=d}X|+PD_k6hf+w5^Go<31IJe1*T4UlS5=r>X)gZ>$74rn|uCftKVC- z=$e^G?aAz4mFAlc^b-o*>m^9j#jF zX?kHgOeH}K&D_Ms-(~lZL_=sPjkU!DT2ivJwYze)xd{1^XOK|kM~LAkGvTa?a68UO z0wS*wZ53_vhODSoVKo6~W6f6taU{z23-?52eEL0MA=t%yo^+dBB*$a7>1Rcy5b3Nm`FQZ5)S>g&20Jh7RX z19@!0iyIZHYjO9XD-qg}Aqo`i9gP&AEW*w1uL6-+&D#TIwe3koAzB$oiN)OyYI!GDli8Ym;6ISj2tS3I87XI@y>`=|=q8XdcfW~zh- zJk*>FP{wUbc7Zh2v(?;L-B9$D1 zs2QF3Lc?4eI(9K|Y+Lt@FQW1+PG*9%ChGW2X#u4YsVd-Ln?6d%KyjOj~}rNNFx!g~{o?7V5N+0z=;_s?Awur+N-vC`SJ zSWRPWf^O!If^ht-jUKJ<$3OQrdCc`>IWvK$jd&Pi&Z^QHc88}mMe)X1usPF6kIR;a zctv;dnR1cLhpj#O*q-II4dacIY^XZI>?tb8f@Aq-rdsEwl(J4koGpogl6B8ml1?xU zPg8f7_6=MWS__}*X#r^jssDiSB6K6uGW7!ss`AI605BJ5v&O@4)lR%PklfqTB~_CN zMx>cd;;c8e*59hCqI68dd9`YFNyQNCLx>$UV*&8!>uY7*q~8a=48o1#aT0hd^J>SVnm9u z&*-+AP=Y-2icI?FwJJrFV=EI$OQBYVF~DM5X;VuACXaE`G_#g1Lly$(Sl_DTpT2t_ z{3*zMem`i;oo(&ph>f%P@J~bi%8zY0xUZb08ffeNEl8|$WDJLI84m*-h`>NqB7mPg zP_X#}Jo)-whkDrge|}UNu?k?pihl4206yBTZtm)F=ZZzi_AWXjy2j!f3~(013!!`a z9C1cB$KgPUT%ook&mTqj%U{d~v9-JC%BESlnZ`;DX01LeATDn(KLn{Mji}@O_huvz z_VoH+T6{A2ysz5iUHhke8_)H{v+HwypKi{du)pRjdMLQ(*KgX!6HlH?Y(QuJkY#Q*^6G z*pqG9WYloKdZ3=I7S8d`>9$o;|s`fA`|vM~;8=zuWoizqo&J`&5W=u{sSV`%;SDW^*wtU<+TB54({j+-j@TkE!QY;a~A3Lp}~aKejPt|-P( zVcni+L_p3HU|BOuMWwVd#|X$nJ|nNCL8P=c4Oj^=`SHP|@Np-jqUrBQ!%8tXqw2QB z!7`~2jMK$PXvzo+D>guBtaBn|gAjwSk+@SR#$9hK;UU7^1IU)25B=J^X0mV`YzIKt zO2wlSA7fjUgdrakRaIe=pD^3=Z7nS>$PKu5g5a>UJYrh4NQ{8+tqz9nwsjD;2D%R! z`(sxGGy$_#zuEiGA9vq)L^RT^4XKuCfoVGBC2kBX4mNRk8fS=B5B0@@oz zlxd)u59ts*S727pWP!PekZ4|6_?<3{5cBT3#RVU+snoG$*`AQM>}ag8^sQkk)H$p9 z^OtiqRFH8o>*(T@CRJjGtXYqcPWx~uQnR-;zwK~&sP?|)3 zG((qpla^3y_75|+kr)Cf5Z}dbEN4@XE!d^#(Q`3|5W3y5rPe~ z8$3mG)0qBcTjq8mV%(9GONE2_KC-41$*cyr{97ciLOS8AEN1f6g_l6PPRRx5r7lzX zYia0p7hNnR0ZQLUum(h8$`x($%FOZ<;Dw_B{oz2BlCm-raBWf%6dhx8%*Cl}R-S?* z3`Igyd_wV^E0{C;mXM>EEsO5-T!nNWor6^#-^!=T#5 z1p(5hi7d}iB1CJCb<6-!6jp^F$HuzH%9gk_QNJ!m3POyqrKBtTDP(}8G){}o(9laL zd16=Tx53J)LtZoPIK-0>Hzn@y#{J1sF7sdj3_*K@6LoH^L&ruVU;+Wk#|2yk`hI;b zv=Aa(zD0+{dY{(iEjs)!fb*TJbDr)^*)^rN3cSq4QXWOVW|a5#K$DNC@&R93`)DsU zlxb=zfe>ME!eM6=IgKHjM#+%M9BLHQg@f#UWx&W7%L199@>@-+l?O`ILhRus_CU1&{SHIYu58D`AvDpoITW0u*FOV8nO2&7w_Kf)me@!`Zgf z$CVhuMnVo5y488o0kOImmQCT40)+r8&dy*Oo5q-$o)`)-Avdwpbi)F~x!5UKB-E9P z*3Iup6^Rrk3cY}15Cq9w(@8_J;Y`mOMVs(hxdt6fFac;UIU2|UX3RvRe`m-_?FL!a zJXS{b=8o0$gl=7zC9TcGPQfQH3fMWkvkc2E9iLDBKz{GiP`pWnBYsf2R6X`CW zoCk-~b4UOFb>?sG~2zFUQ)09+XQH+}$1SqNG!xuz0hu6jjcYob2lL~*fZULR73xXt8OR(|OH}tYk5%VwN;Zr?j`{+ecw!pR z0x?v`AbI_Caxow@u(K545U|SHIAy_#9#u=58a*;?LHU+Xf5UTkZrg7X(+0x!q6jP2 zlp|wfgj+)>QPSrCCse3>6A{nNi8&hPB;39F>dX5s_02P&(=}|l%hAyDds9f4Q`3pu zCwyWPt~T<3YJ4j6?8`Y@$DomzVybp3tUzJ2z}^{copX?hn_6BAD~|w0T1O>8l`ZfW znS~=XHOqO*l$I{W+6Fdah+<6tx5!9Lh0r?W=03zKDcPp(&3H?Y+FTyZY)QG`3Ls%N zO|i>ahtjqR3|)!lv}(fU7-vtl31N}S_4pK=;hDqY7O#o9>6i4s$Bq7G>Mu(;o$q4 zNHUQ1yi8wzbt6$`8Y>*dZz(s?m5l)Vb+3)2uGn?ZkdPxy>_@ofp!rYj! z1w})dy-_tj<^bq2p+ZBn=1ynUO|N@uX!AXIjE2vNh1^x!N>fOhoT8?ZQu)WSysUE{6WR@* zoR)+Yor-KIXdNs>WNUM!dQdH`YbYOef~ZOfRU&7ubp6iPoDUiGJk~8g08=v{lgLsz+>4!Y;WCtb&TR)CPzW ze{9mRc@8T9s8s~wg#C=xo7)Fx-}sUJ|Lmu(f9!uhxH|58owGafW-tHv&;@$EK#6GWE+QPRR@x{t;@mjM3eXe&mg#<0If~iDHNfwN)wkRb!y?Wt!)LsYCu2 zDl8FBnq#Hm{)R0wD!%#A*KhN(THg+2>j+I>=?84M*Kv^K*&MOecS|^FnPIu(T!?K3 z8Apqm4l(EaJS&b2{Uwvbkk-tT&E4?2J2co1TJbqUbZ!@ zEhV-l*a=1@4H ze?vs4sMzepg&n3VXH3f5O`s7UP;9eG6|{bZRhM8eX^5(jtqT z+lMhiG!M)IL&Qy9#suUps>Eoz05MwK)y>xDw| zfAE42g@#}>z{#8-XZ(}kqocq1E4x4P~aq<(@sFzgn0J+kEf=Qbt3TF zIHW=*TC`P9i^xhLYmnr*>mW*T#b{k_(_QY1yIus>k}gcrHUB!b7?&_a$z7YWt}bBG zu)<~5I!$morb>2HMX1_rX-+`Uyc@wuswJOKAX*$9%D!F408ruYbf!@lwGgdr%E=A1 z*=%nFQa3!&b}rVc%?in*UbAI38{PDX=adRioLr(Bu_k5ddo`Q}LL+VLL=?<;T9;?A zH}ED0eP*q{3)~p_v5EraunGl1mL7_T#$ipdOrcvZRe@VQfPh{F%-(3A8RT~IfRgMI zb97K5%@cFKnm}{RqD%XP#Q-cV>;2Oo52#g`s`dfuK8?y|krq2cudOTQ+yhfR8*Q{Y zzU{R7O%in$eCz?Wb%{;nVp644^V z*_+VWf*qooH`_&<)BqwaMqY!8>cj$>^{M0$RaU1uk)n~zm^yS-5hNgX2d*Wkjzsm8 zBBxySxSOa{c1sGCP%|{iMsW~yMKhgM2ve7uCai*+R<_%$Sad@Vjd7duN(~aE+!jc4 zui|#7IB4L90-Xw0R8q3iYU8hw%BzO%p;G@$np&J}`{7wH8iU*`F{1YND$F4at~K7O z>ys9oN+|e@pVhy8Z%tfK;q@x8xliz4Tq~*Q_5Rs8|BU+dTR*+~V}E<|XMgJ8*}<*# zx=0UkmT!3|f9+To0lOFzjWmXF-jUAZkNX(pL+^4xyku_vnz?Ls^Iz535QU8iL|OXpjTWu zRm}Qo21H%AFgWO;F=mZ4)T%t8H9LK=o5Cfs2{)~+7; z;jO{(KTj%Bv*5*59RqsnuVPJM64ZudC}2iO;Xc@?+MZNkH^0!>KiGTe!3$YP(Or%R zqLpOF*)7N%Go{J$+OAZ(6sAT>`sqd``-ZnQ= zI}P0&OG2Xq?E}^!Z6$Ta2Olg=e0ps^ihit5vrfMx1hcNCf6 zjUg5@URODct?}2exI9_n)@wp}RymqZad`=Ple3h=^lFTC?dk~|XsFS;Hd{nYh8TC2 zi4MTcg`=F0{HHTMI(NlO@6aLhm6ZiDa0Hoeod;rkgmMxftKtH3K?SWaH}#Q&<`VL z55hz!AEB|Mpey(Zt zY{5|}+|^kKsf&hN_`wEc_OE^*)-tf$s~Ji5^_lv#6LKI-5y>ejH#5agWvRkF7*-UZ zwVrA~Wgh8CFk6+r^4;*VawnR`=Db2CbarA%TSBF(g3kH2hGvY&iVuP)Q|%1_#dUxE z$XP#8*Mp2C(A|h2F%g-GgINY$Cp76%2`buBr2#%739=ldo=R@EZAacqh8_vq<%2_O z0{bQ&!XnKbD;^n~wuvw*l3A26BM@W^?+`L8WMt3ABrqDWstIU$wWf(Z_NYm0aT<59 zs2LF?Fk%*zQUfoIn$~q4A4PW4E)9xNu93&Tw30I0x69e4RpmH}*J-vyz4GobMzqOR zNcc%cFbppO`Bkf8o?bDb&_pbYnYF0e-SQN~jIeSVBs1r8 zY)1*$5pWR^k_ZceB5`ye*l`>aoH!Wdc9eFkv=8l0cURR~du^WQ`OR-t`CZ?7-}#O? z#&7(_m}AcO{SNC}o}vl2%EIe#PWb*xyLgLWe-glpX4lw~5F0@G`JYEGuHX9XQi`}P3ei>BKFlL7iUQj3QdN4-PHE>7JBs4N2XPKZXLzB9wFXpbdlbsi#` zv<|$7;pk(ce_hEE6I-=SztoW+mz%o6GAhzcTy1HhBKrI(4<4Y01dBivq zk>%Vd@OS&-`O_yK`mR@FV1U`U6B%ie_9ePg7@&6-P0w;5sK71n`0T=>XO}MUWZ`#{ z(BQwpTz~W9vRIvG@}4*F5s`%MLl(h&5g-NGqB zIUiW*3{Y-ts=K78Z}^Eex%8)EF#KF8OAOP4_f-8%e=AYrqVhtxVZ2 z_-rLzXo?Kh)h5TxM#|i)xpf$|%Z{@PeF=MtE;u`OE=GJw9)9_mhCDar5onFmyRCDQ zeO7|*A;g!8!JQ4}xMB2u1v@uX{jh&0~P!xoGOu zP5x`^q!fy1rs_Y!Op`gln9Y0fs;B9>k7qPo5r*ZeB9W0%kuJ(i1R=HtuX0s$OOE31 zaMYcwAs6Y4$)(5z9a^iRZaU`8VXUED~GAu2DG8O$5FU*|eR`RE-R)%OtI`;K4{BKHRg#&&iXp z^{#P9xr{6)#fY`OY_pBi;4b4JQNkZ(b&B4^I`(=XlL2@Ok}YQ*nROg&nIQTKty2Zl zHnTqRKlR}rN|ArR#7v_+i?f%XsVuM=VsboGsGPbfLXWqGN#y|wZS%OH`S$(i|KWf8 ztv~laeEZX%eDeJ1y|;a~o4NZ9Oo?*wG@=GZSio7kJdh8gvO1W3PQYE*958>Dk*yP| zYuI4=Za#mmi6f&xR(dR7mACvGLV?()6h&Jww86TC{|FJ+9-xoPR7KM7&tw`%ip2GaQNMq z*rzLg%AMiyZj?7_PLljWFZ1*SF#*;jO*!yzs~e8au9FMMchn*&yArz3UmRR;P7=tlPE)z$gI+iwa?lw)%dGLu6n&YZWPtn{lV}1i)hZzIuT7~s z-e`|_ymta#zDiZ-5oY|+T$Ng$E5eQL^dB&e878!=4%<^R#>NWLd`?Ij6-(}`-3+r()z zFmpJ94sc)nR6Y#7_)TXCH1#%=vz53&)2~DM{9JrYkcm#6$vR}2(rUeyT`aUU{UdOO zhm2bgZG^E)4a5-|gyrLrgD_C;#Hwwx8=-1$)=+TDQD;L^pj^oON}q=DkPFJ&M?Oet z$qC}Ex5o3M_GTqr3n+))Xj&^{wZ9Iwu+(ZN@kJ`sjDfNbWbWF-T+wS=9jUYfAaMB(W6g)>UF*j$oJ&L-3Y0EM#h;8 zPxecKBX=POklB=HvtO5L3eSK80tLd>A>6mrXzqf5ty=13g}`|21^`?bv^F8j;Y+NS@*u2Hm+8%QFS2r3so8Ma@94+8y;J$R%ST(BsVz2Ve9Q z4N&XSWQRwWAjcQYTHug4d^w1ikB&=u1f(0cylLZxBl=BHS6Ys9KCpy z9=|kv4cgUqF2u#3UTa7ZZ*wAuqohN=y9GVN6Gs77r>rRDimIt$fD2p{GRDp8^c=_2 zJ0Cc+S9t=%k}dZlxsV76?&=i@3LaVS@+f(=>hr8;`6CKJ-@%!6n9XOoqCJ!JP5!q-36G)rU z6M#j%4C_lZdQF_*=oyIw701g{VMR%jPC=CRGir36K{1IU$aM>af5oIV=DS9U-&!)Z z;Xockq)|W}r9BsVwL8TPKF2u1yYjG*g`-!k59C zaD^t*zUt}}qaFPFuWD$zrC1Z^k(X%hh0~;IszI^lI-0e{;)HHUM2qNdKz-I@)Kkm-6gCl!Y&lqR zHi-^l;4#2kb>zHfT`C0NO)@s^O`?tvE&{Y_I3;x_h)`_YYANKD*Dg8mxgcM}#Dy2) z)2lCYVj8gBwI4Mar03=Z|B?u258mb9{l0Vi`PU!)&97a3<3sN|}p&_H7-k5>v?T&L6}hPxnw82k>>G^ zFsT5+qA@dU=7@p7)7z2~Nt z5wNA^{93IiF+`w`t!OOtEje~@rq5tq8YFQ^C^?b=*m2Vb`sO5%OHMq8fOl?%D)~Ng z@crNSeb1ggxp5Zxr=;vN?2u!DXbiXR5mGM&*B%+(ZRTL1zolkqjwRHPcB zg6cRILTMkIK0HTZ;KU>iMmaAPF-WjHB^3Pkqk_!GY@MeN?C+z9Ew_E2$KH{XnT zUm|7<@iiSXAF0JwkMDo7+!w5rRf=JnNMzBx2P!Y|t`+!dPSZOAYPu0qe*h$)4osRi z4h5}*5biu{z;)DGRZ)Ga22pAr#D|G;dsCoBcdg>=-1msN?cz~w(|gP=o%wQckd?m7 zCZ6@xRw5i|dXG;#p-{b*D4mHsJNbfmFbzdq@pC?S>47mfEH+nHSHE}j>`(srZ~o=~ z{rauXJ?1s}cdp0Pa$o>t));^b68{>*OPedyUNEE^Kp9AMeL5kJXU$z$GIL1@);NvV z&&#&nsqa0yF$iZTXtcpmg!fiGTN>xl#IPB$MJ&iJ-l&{aQUvp$9x`!J)2K{&uDLri zX{c5J&NZ2tLwSZJn)2JY2%61N6}!3A7y$^9Oyx%3;LyRh4`;B@Gg95mlh}>bS{8uMg|m`4rCDL zd18;oIK}UbwQ>V99N5W?6bR}E#YHGYnyyjjR1TeO#A-8qx}{CZ&Q(gEq~3$u+0&1G zd!FoSW5|#&pT29E7%7(xzVQl(JFoq{GMQfHf)Es>yJbvP^>BA+e+e|ZIJiD?2 z(BNutsCndZGG@oACK?VE@Vy~0ElYaadu}0ZsW-LF@ca8cli&L`PFxpcRrJR0GF!+% zNr4NZ7V`2(4tjBzHaJM=s6W2@6!`9Gv{bo%@3M5LHlAh^q@v4mq=xGWxob@;Yfy;o>0b@daHJ%7*7%@3bP=7s<3+pC+mUwr=i zANKf0BSf4?qDXFJLhziJaG z|4%*JILy{`u4SdT-*cn~Z`7f0 z!O;0V=FZkGAyd&bPMu+Z{ONfNp+QOz+EL_6Ldc{ob? zjS`xcU{eTd#GIln2t|XV6f!g;!(XIm!$Y5!NXFEv+*%|nw@aE-EJ2i=jSF89^xn-H zs5C3>0rNln?9*1TV(vOkz?_X0dw8peEeG!kU4b0bIgO^~Q`69eL%71y(#~0!17R|7 zNw8OCHpJZ0d^{TaM3~|Ve4(ZGRM$SJ!i7?|wK$;cs$Ti)pHOnoeGhuE@Y;j& zo<#`7vpHYs@&3to6$aKbJ4ir@8Unvk+Pp%emBvDnihP?GjwY$IA{GJ6Woow)mo^hX zd-Klq%(f8wtcaZ=x|Kk4VuY5iIE!a4!%-ja&IKN-NDni%3N??#ZrZ>tJ33Y4%sXFe z6uczO_R^09JcXhmH?bR*Ubn`7LFKRV!k5q{=Lqw=j6T!mwc$9TceA)Pqy?%u30zCiUF@ zXrVSLP4^7x;pk1Y!0g;4$7Xi+dPS~hirijv9vv%~@bHE;OARi}mk%cm2j4tLqdDY$ ze~Pc$)Y5l#nwqcWZ)E(tUNySKkK>Em>&?ZzN9wx-^!trK?D6h}HK75{au)cVCl`}$60{N_+}ecW z>(XUeU$k6lY!D^C;>&Dt(qJPNZ^GrYKC_gOYGzHTVTAICCJT^yNjn;$#$@o8Z@7K(+IRmUryHV3iONPh55|@meB`_}as6j6{UW(o zsd;G+Oj8~#h++_v7b{+x{_uyt>-E>a_r=YPf9K&ns9jYH*DE|zLJf0^6}E$gcif7k zyis1lmXu`%KT*j4dr8Mm0)*j!q0?Tev9Ea%=;4RE74(N3ae?X7~U_M*_#7bH%0yc~d9m>M1{cvM@knyZ{@v8mWan zH|XjH3H`gwd-9%NVfa1PX-1&3kyw`AJF>0*Co?83vCoz9dTKR-2DjoX6fO2J+C&$L zq1g^2E;fg(e2Ad=xKkcu##9BwXmT;c5Z|bcZL4=Q{PeE~uPxpnVKNH=pN6B9 z&Av+}(a3oc^e=MA87<1bSR065-gL8aShK{ku#o&Sb zflad5FECUWc~ziPxmLc?V+^7T6f5^$=#7Zg30HZsVGe<6Y&^)k8$#LftFD{e0XeHj z+3bZ{H3VR%YS*!xYt&+801~iQlE!%an^r*SZ*&3is$p>qLgdUmMODKbYM+j-^(}F6 zjKC1|ksI_^MMp9S6KQq~FB0sPgcPu75+_Jgtv4jz*`dlT>$U&6vIex(eGOW|g~`sR zXOn4mXfK4XQ?V2D(`b^XxP>?Tb6p37E)N6=rC7`YC#QB6f#i9p!}{__Fh;+DWtvvweyS+Oka5oX}-v0-rD1W*w()K8dt> z%Rg>|qU@MXe9Btmw!U;W6np*<2&i>RWGq)~C8mIJSAk4l2e zAnQ~UFAb>`ft7_iSV3_sw84VF8AuC94uwUR%5loGICyDP6dcI%vE>PGnb6A-b@C#q zHii#QYYR&pjtDXtvDt8&1ge%^ks28t!1Xv4gNMq|*ZB@a&eB911PyS50{C^>RKCQ? zcCOu@&1AS~bP2Za1W;0sb?J3wdP0PMXle)p}?0{$nhZg~# zcNfAP8R13A5Bh6`>)FLGYEHIC5AXkf-+J<+KmDy=__ddBzVZCVPp|SvA#!nUE*`_A z@HF0S1!!LW6sWX3(Q-Ibj%cG76$D@LDXJc#gqyCOJE~rBNV3W&w4*u(atx+I+P%Y8Q9MNkhYqV_1;msETif*q zCuRirDEb*tzYcIoV(;q6%L>_A{H(vRm7u;gLuNU-C^h>WeR$-O?+NdZ)lib9{xZcO z=cZ2qAbepcy;dq}rqg3CXnO0Rv!ywV^~%ENgbO(vrDe5>kn-W2N)@Weo8kVD4mB=0 zenuQe3<5M0l+lpgKq&9Ocgl;oLGC76k7&q3mk66}f z&XluDG9AY~qjLuI#H=^ts=BoC3nk9MvdTLqlfU!MV03^cCp~>Cg}EaD=>TPv&M=U4 zq(HT1pd|bgB9HWrDjJ-x?3L>Q9Fq(vr>5V7d8)-hPwdGs2WKJG>ddCYJ#H*p3C-O1 zw?;v5CL|LKiON2Bw&G1Ze0zq1p&#gPiQ{4~U*<-b-0st6N#JpVjvx2GVJh>ne$#X1 z=bzuX`P}#2`}+0MfA!DY`=5UO>EmaQUf%M(pnRzVGlV4Xw<&Z8dRr(jR0q3y002M$ zNkloq>B1@z(dq$3itN@Gl+S|CzdADJ@*lVb-wrR~|-jR(9)Y;u9&_1|f!{E;~=MHV-@^-( z#+l53PNTRZ4^Iez$JDXYlS9r(4WqniOMIrcpa}kMQ)W?vGG&$l{toyD{)sO>e)7mq z0d4KclVQeU_W1Gwpj7CYTQ)jdP2#jJ-74m{{)Hk51Rgj#vkV5szz8ZzO-x+K&^1U6 zAD#j(Go%{b*{=A|prN8iePAXdL1_01%6y&h2XI(OXK;Zt-ek;rtH37 zb}V>BH70SIP8{o+0(-Z-FId|Jr@KtLo!y^wSrbQX0p>Y(>R=!1{s-zpW8N zMwrtmqXq|w7%^n4(=3JzeZWJh@r0JgiNwc|--nUBG)e#cQ~|UQ;E%1~{$_ z1=WXBOkEQz7skoGQ)o+0-DSNy0Z&b!zlW0c#*3}|?J+;NO%n?@+M5x=9;eEAk}Uvz z3NM>7?~B+9wb|XhxXSrxK=E7LWLW#--?Vo_V4&PApigU^ElS(GK9r#)oiSu2u3m;nUI;IAp| zmTP*P4uwCjN=%zdCc|DV5ZmwtEnlLtHqEI>_RfV`3bdpRh#O7qOJg7dLnTfIH|>0O z0)QUW$h#O^UxsFeGXhK()kOK%V2ingWHv(4DH52t+2;Wz@x5ku7SF*}F$4xCZVMq_ z=rzRV!S)Q<16jUowb=u<0kH|87jl?eVD&u&j}}i(jVh-`J^z?loD$GVyU0*kdg<0b zb2}|gMi4LN-PnDkrm~HTsQ}?^!$(g#LfTu>(3uQ zdtwe5GEC;n4;o38yke~T(qMWgqtgtVGajuu<@quI^qYT;w>X$=_1m<7$ED6~=uQa+ z`1N28F@RM>JVRur2I3i~Xtr4kozzfIw1kzPz?>$_Ku4I@X`7bq1Aly~PSZ2NfKad| zdmDJF#{<9a&&~0B#(1(g(Ff@mG)*++4Je0A=));IYrhPOdGeqGy|}542TfCB;O&u8 z?&Q*zt)q+hAnUD+FCIb8+_4M*1f_a_LWFhOa7l(s08vEJ>1(%-2aObmn#h&5!qt^^I~0Saq8?P-ghYzxTCguROoG z;WN>f=cL^%-g(9t?{apdPZEK91eh^5BZtqPpP}h9Aw~k7MZe$^lsbW{h+x2#&p-Jj!+I#lCq|-9)mZ6#3jR>v3VGq1*z) zyJ%i~z@oW$;%OdE;9_YP!}mIas!zPbczFI7kOPOp89p*CP|u#_8Pn2;j%Rln8)(nz z(>ghfw22{i<>!)qLlCd=u+fHkWJAk^G2=z?l)V-BX)dEY*D&}%*7~a4p9ThUQcOVU*GWUa)0l49)IPh zfA6cmd;im)eEROYd>F^i3WK7~pvWpOO*`;j6(|`?9Aaa@k#n|6A0xVWFf)~Q&BKs# z;ao*}cLCP$C{vm0GY`7X;aZG~7o%y*p_s)NzAh|73`(;#&gr4VVcgO|*Azrn^ksWf zz$q9T0sZ9^Wy_=S^(sA(OK(2G@MV5I8jKzyD??%?3v)y|J+)VLS(0E3GO+=MQIcP8 zn*vEt7BW)73=q-os_PPf4rir#SaPC7M#R@sVc2DvZQ`oyrb;2Wm;uyP$Du}u&K~*0 zQ_etCEEna~TQjtFq4A=0^D8Nv~|BKXhxgTJwo%; z04l6-MmtaV5V>|yFubiHN$~aZW$)k3vk5CAtQg8Z#3X&PA)zVdn^=&ziC)$!6`P)$ z@$Ta~;S|vlmld6w@(XC2)df|~3rAEpyo+R_!1E@H({q19HwZo69KK#N6QRp zo&vY~wtZ&;u?yoa1(O5Fp9JvUCZ~QNsFi@H6+N?1(&Y4276114J2#(u{rd!tN{k|Np>@N7Bg?OkCCXHn6OJX% z;#IOZIVj!fIvN}i{BhlB*dpUlNr@i(=5lkyB!e?tkDfWEJ+QK8?dFvFKILV~_=2`j z_8tKBaZq?UXBSI>{h{Pik%5NW!^>vSc|LuX08Jh=oa5@-=ax{qj4+|52B#QxDNOY! zhnhRgO+4x*0z@n&76DVSs9Oe8^3xdR-XAsk2_p z+RpGvz_2{dG!CL4d=-=_fl0x}D1W7imYw)aMb`P(wS-z07DZ^{T;8;qm67H+PF6>F&V73Zfji5R^&+SS?_sOlN%tjo#JXmlix)ScFEL0h} zO63^c<6kX|P-}UizY|LfRomH&0m7-WH!2V29Aqm`5FVYcA;vt6mF;7RBPL`Jh)|1$ zb#VtRRS?-TdTP>_q(}rx!qlY?Hj-DX3Q~d!pLlxZR*Wo{!j43r9%-oik=($u(EG$|&hFuiO_^dJ_exdQFT zG8D~oeW4YBS^Da4z6@gRi=jRbE1?Cy<1n0@rM0d?4Q-aOL&-YG9RzIoX*~ZP;8%b5 z`49d0H-7aW+`iuu5+70Hc)KD}7XER3hPeM8kj7|$7P25WBeDYUIs@%*;&K#Dh zTIWtqnLZ@X-V8S4rUesj_#A%Bh=jlQjosQwxP4JMO~DMUv)FTC zIu#*~Xfi)G2{cABKSr8T)C1028jh?Dl4gB7bZ$n3oxch3ivlOeEeQCQI+|j)75)K{ zc!Y_2kR#t6Qs$r`Iw_Zw`0R|xUCSPOI351z9z{iFxI>F9b_=HKBN6Kr2j#PPPuYE_+qpt_E!bdlE&r@^#|SkNR-X z6$r64g-9BC9Z5t-xialGGErE8J6t?`y3x@2k)iV`f8S5wadVT7-|6X#{nQ@%JPlxf z?T3H-!XL7X8h-$AbMN6h-@5tiC+~m##j}6qKYr)0{OyO2UwLR;s`(GU95mNg<8Fu` zWoFnm8fM=(A-GAE9)shgNb4j%6H;Gh94748!d?rpQ@oj3EE`x+ z%!y3Apq3m4DrUKlhg4U&umInTtz&ntax>4N2{IRkg#M*o=uqO`3mr;E@4&J4l$=>k z6n%Eq67%Gyeo<=# z<75mb2ZM!e9;yHj$ANZ@j8`Q_)BHG;X25)*&p~8kYx=D=1X7J(Ye0X#EVkCp49jJwu1ZD>c->o6Cm2h{zu zCs%*x>yN(jpMCT1{ey>J`V#+u(!U2VM%PC(ZOtvkpyg4yXl}G=;FAX)vtqBtgrt{C zpj|fLB9@ory{}zS8*D?9N%x9E!4M-jc%rE|+u#?ihH8%Nl?Iv>=4D+{GI~UvP|yXa zQ_PknGs@P!;Pi+B)Y8+c$O)N#V?=>?6zWx$)1|Gh790~sH-R5R8BVz)5^OCtb1(z< zC~+QpCzV6rtNIcq>@aXnBVUfSH0Xs#GFit2iszm7wV3gwj)WW5E|2Ox0L) z2U|I|qPP>pXJ7h4M78DJfrq!Mu$D}K&IR0Yij4i){VZ>64-37J?NL3QGKSzBmljh9u4~842s;)b!`MInjqt?WN(^mUBO9 zLbJ=N3eu23$`J|;98U5^RI3wpOqNz|!n>qe9$?lRng{{X$X#CsKu)uVVtK*diN$moJ!TZTz}XA(6Y zct^-W0jl`HC!tr~;v8h}`@KX@!bjRd@Q%OF{9N;iKmTE{PYn1EU$_R=PYT`V8ti7=?Wyk5M3%jGAS`iFKFI z=GwC6{4)*JKL%zOxWZ(lb+EjE=~ToQ>x5}7ojPa??dBSFnXM|fL5@uq#0H*=Oglkr z&(pj*`sLpbhu7PPVjU#`*9g8ldu4}%#b;Ya#!S7@#@J2dOQLM3;&`DC*oE$SnIoII zlAoLo-GRjifU@s3!|Yl{WvH|-MLI=jbaFAd<3%Pa(N-zTCA5^oIfTt~um@A9ZLy+R z2n`9Vtt6fN3G2j*5olIAx&|y>U7}-#+sMeV6b2J1so*qQ6!2`go#JOEtgF2>QGljJ z2r@J5OA>^ebCJ2)<6CZ=Kp{WgHft2Ep1d)MZol{AJO%j34J!b(qq?lL%JeWCM}z=f z{0e*-8m#uD!f>^3J6MU3u8ZDnshByw2*hz;?`Q3P&_T`*z0YEQ)do^HejL=>K*FMAbuB~Wct_8hR z6*^uU^$4?c0x=gvj$&b6ccV3c%eIKK}y;ENB=7)ZdUL{iu_gabm( z@Q>WCsTqcjM=~Kz8SZb6UD^h7;tE!)VDb;NUR}N{MouoYoTX|mL=ITz54FZ3x5$iU zq3H(ynE@or1y6?|nmP%pz}B9&s8X_}{K7%egdPAe*Y;}3kKhgRsn-TxrznZY)?Ld$ zwV@0eu=(R;Aev~@e1J1|h_dW1K#j020Cqr$zq@dxYNH^c#rIFYc=Gh&ul)9tANf=N z_?P~l2cQ4U6aF~v`bHcy8wrO7Y%<&XdLr1t3L6&ZK((ZJZY89ktC8<-08Fa&+zQ4L z6NfCdZ4~`e0ZYd0z}^isB}JS(&ARHYi=9g}q-<2Zkv|@HCD;s7hw(huixRFCLN=cv zaOSdWR%v-+m%u06lg1@U=^O_8E^#6)`x+i=!4@7lvT*fCKkfDxhtrQGl)ZSAYj)+t z#n}Wi)OwbBdtF+h(!A8q=}u=_G&4>ak1#0M3lz{og3&$0fk>B+iwoI(QOii8M z4_i2lC+aJ0ta}ABE2%T-1c+rVZ9Qd+&Pa%~;zdfktAkxBVOZucp(#&M9Io~2esBgc z_(W(XDfUunfWy>i+*%2605s8^r(aB|(a?q5X09#1oJ<=V9XnjI;s{Lo5#9BE&Z!VA zj&qIDo6p9#w2Hm1lQZ1`%;;KT#|W8h8Sz~mN={M8L_It)RJ;X5ICox`VYvzrXERVB zJ{{8~UB=?kmc~1BaF7%rIwfGXy@gRoZ+AF!YE*7XC=`^;5lwB$5-;bgRomcvs*s&N z%P4cQPy2AnA2IfCeYvCXTce2E=N>*+cE)>8^x}%|8hrWgyKjB!_P4+N_=kV$<^TNE zR~|oqgr4SJv5BaMbWW6xXjd}M$GPft0Q_-dL2yR+&~RHFUglQDyW*P)^-yO}9z5)- z;g!yCTZ6&8Y+!iEjkj)ZY~ zL9}Q+?T4MpSut$II6;GU{EH~({`92K(vd{zkj}wGWK#UF06)1>WW3qX)~BYP7e{Sm zp&aU}-23bspL+I`KYXYD&X&1m?s&Db-0QXJ(wVtxG${;xDPkp9lmdDlRgMCe3{+eZ zRrP9xUI$3Gey%Be zK9#kdYc>C<*QlVhMDiDgT?i8r2N)WXMTf<>`itK3>i56+h5%pb8N&G*P;HQeVhAk=i&J(|G2ODAS2cG=si?fOq-v;hSGz`nU)2E$VzMV4ZmlFExRRoJ(a>jK}rdkKQGSunK z{RvPg=dC%>2WKwKQtnPZ4&`;>W66p_iK~y&A<{vL$_Rq1Bxne>gj;HMT64Di19mfG zuL~414Fc5c#5IxJU~WlxX*(A(8Q4=b77T#Zo)TVfHaSZ^Goup19D|Y6*3Hu(V6dpC zYSs%9zBcr5P+;#upezxhrD>Fd?i5pd^k+rMJ6zRVIpl4Os0~e9iea^fj+)FCc#=h41MzzFH8471Q34HR)`y7=-RsfJ)eMD?3_bdqzT z0E9Q{q{d+O>BPET@>)Kt6B0hz=SP5Ey!0E1{YD^Tx6K~m^?km}6t$acpFh~(eE{p? z!8KnB^zO}DuV4M%?W2F~CvW+y-zTp;yvKL`fXRA`iVjS%$%S#FSV`cc>^kg>3&A*= zKHXE5UTGvskuEF85h+TAsj4d~PO{ahQ%NB*wb(MF!_+HOYokIJGsI8{Od=&;doj7! z(uNVi)--#^BCZFuX=qwE2mNU0BQJ>1w2T`EvtZtVrk4yh zW@yStC2z?v2kb5!3GSZ$z56xO8Rv?miBRhBCSvwQA*ZMiv(7P!rk%F%CK3G`DdQPE zXQLJfsv_E;L`@@Jt_7`8QY$7ylU9K2WU**!4({Jb(K6&%e>FvMMsNLfkwN zS_)d$NT`(LAVG5q?5}?8$9{~%Hf?4-NZM8Foe;GlZS z&@tQCGzqJkaOjI0cwKWEJy8%yjEFQ`2vISQq<-8bRiE@z_LPUHVm6OV#w83nn#yzD z!P7=Ao3j=y>tKK=+8I4sh1uNNFiKVTBqCM&DISIG1lZFaFx0fep`BsWM?e#)-O$o1)9lR-_w^5e~8lX9}Hcw{?oWMlP@sm19Ueqe;I!Do=WICUMeV+4cZsovi zzvNRt+Up0zdF9NqR0k_v=UkMOccfn)YB=KBZ^j_;L|>ELK6-NXkG_5H=YHw;Kl{B; z|LHG1{hi;te)s0VW3Elk{ycNADz`?=ku%6hfIVAs`6u*XSV)h7P_Z>P(l^nCTvm-w zP5Lsh&uk+=Dq0eP(mp{BhDj3z)+v-FU?x59cNB1MN;Fp>IPkl+O4}u&2}79mhPho# zypgqPvB$BY-Nf;)SC-Pzk;>8XCCKJyexdTfE)eN2s_ zuCQze5^M&Y3s(N6=LK<-Uj=9wl~1=gT{hh-6j|an(M(dqq&dCyrKUOIG;1^6C6*lc z)IxWlxK66*j1HcdJ{05%J%>;O-Liz9W7qSMQ7yG$aHv&#=@C1<8 zPH+6oPfwg^_!NS6T*%uM-?H%N=K4!-Uj6cKJ^G>l^!68i^VLVsp2*K7+AsZd`0x*6 zv!=W>eMr#*-bsKo-TZy9KSZVe(S!*UH{@GBOe)&jIG&LZw5_#VJSEm1JhVtMKKG(0gRfEw#1|1wiAv) zd5W;Im=>o6v*h50vES?iO5*M_S)e#uICPb8jzWy9e)5%{fU)Ibh(ew(1Y{veGkG>F zMY05o!tNv<))d`n83TLWoDyVkBvoeEeY*$sVxayyy?mle6rc0V?wGt zY}ka-jOK!?1rZ4r-*aS>6 z__{Cas$^AeLh_FUQ{Q;MfHGO~u}0Q?LKe z5W?a`Mh%{8LYzu?Y6c#5mxc>0#-Vb-SXxYsop_}0@IObH`teX_@}W{~O4a{0r*LDU z0ly5F%nje2YP6I($<&RNs7hL-gbCl#9%V(_w2=T0kO$FIZcg-|M5D@>Q%d5=? z7ky&u>+3~956)3C&ShXT%iIL7tudVN^5;j8q|)Xeph!bH8MQnJcv z>A-N8cHhTZIdbmkZP7AL+*8h?2uI_fT#gQyA_js(>s1AZLLi8f{;Ntw-bok_Yr#nc#oW?1P^KrkY=TI7S+^Vj z-amTR)UBI)_FHW8>pM4l`;iy;oh2m{5T63GD(|+QE?)RAO;jzf?)%{%_V`lGWq|ic zSq#^UA)j!5_~PcvUwHD1zxm`x{`Ae?`pxH$pHs$oO+RsKyvsyYj5Ov)eV;9l zvMAE&;4n*=F4ti;BhyxL+vqfVcfOA8idhu9HMOaG^|=B%D2TLmL+yP_*9_>#lO)m* zh7+oTmNi=HB6t$G0x%yYfFe?dmPeIwW<^Sdt&&Dp1;$2R=^2befINN-+g39LX2O(7 z3OiM36r-^v)!F(wFRpnpj+pdMuJn;^b&^xmmJp6os!lk#{)$?!;1KSz^TuaB^O28! z*Mc%7Q?g{!R$nVE3b5v+UhzQnrz3AP%EpAqjE1e9)24vb3rH*kmy$w@E8mkx4?p+j zXQrWDzj>uqay7Org{B*Kj___)ljz+I6`$kSt3Nf_%M+Zo2+-FMIkJVJc?>x=%t!kK zL^tDaqLoWT_rpeFuj7e|p6HIDpt$w6Niz_fz?h<~S7)snZh)HrEf20|QbC}y`iSi2 z+$X`lpb|=a(A3``3IVnErzLm+a<8_pb?IHoMICu7*rn-s7DDXhZ61V*)p4Op1~kO* zJzAbeUOg=G?!-7hFeiMS8W0dz@v$Ew0z^KF6k-w@6EF1j%8g!UV;LE)Km(XqqUj^m zBM4qm&_ZxRo=OXpfH{)@ZV!llJvU`KTjBQh1(!pVs;acv4ZK0imw9w#vDG6-{IeSk zt$AmU(76G7`t;FneDmp#{><cgR=l69$QMpBe-xW zFrQAdp^9+pl{Y3Tdxs+ZZk5qgt@{$xd{He2koB}O_X~m|j^!c~cG0l!VJ^2YGDIlX zt8yG5frL0&QKu$v$!JdVP%j48M-fH}rSgPJFnnvbQu1s>8~=@L!o+99^=?v#n;7*7 zhVG1ah|D0l+qdMQ-&NLODqJ&I9mqqYEkIBw`yO3uDZI!04`fR98M_}7Jf4z)#f9fKGUD3YJT=s6*K6Ar??J_fcA1} zj|g36*!vmTzPII}l%j{@dC64^)&`D5%D?plPc)Ou#JPUp&E?Oi~)9lmWeyRl4eW=DNSG#C7aLnO|iW+C9q7%p(eYY{22HN zL`8?h!$>I^!dN=79pGc&pTajOj9yritTS`siD4V~kR>M`7P4tbH?Wv7xzXY} zZXQqxgYd&aAAmhKXyx~_KoqqXA2e0NZ&PEojuN4GXAc+eXrM!2@!~XGzf;ih)9F1odK1L0~W4+VrRJVOqCmRu=9DLVsQzzoUF;%7hU&=SuV_Gca=@bB)=A zYB?<u2@fDRhAC>JiQqasO@Lj^`7j=To%)3@ zeD>MXC#5AgF;aG?{YppIagtYZp{tP5p!1;=rVQdj@1*fSo z31ul8U13UI8iT~zINd@P&6mRzwnKf@l?Aupdd*z!wa=NU&rq;ZhNEoS?OG zk(!R?G31gQlH?ac2W>#%Wvbi9kFUP=_Oq}2xo>>u_n-XHfA+zze(mP%n}<)hDRPPF zM#(&|blth#tKQ4j$$_gTge)8K!_jzrv8$mY4&PT;kj2Dhm~<=Pxd;|q%cv&Ic;mc8 z0)Z{>8<=kMpnHR$Ng+EaXoD*%Tg4Sdfx z=L~mpec)chg)Y9P^Nue6^%iD&jlUrwArEtqxZu%QxYi8!SbiABJ4XXR;*~WMeCa%8 z$@_XeR8Yi?B-ApSLUY=X)$2=9fH;H)!MHe4m1b9_maENammIRhNx6dH-f;yq01qVz zG<|WVcN%B*v3gN|UA$QyWo)5iB84&ZsLqCCv}M$9s6Z+%GMSr_`gJ45x;wM z`5@6Pxs(o_8L{UKJxG>l8sPfy$pFg!qCve`Gkk@uRq3}3X-FrI+~=`G@>jq29^JqB z^5^)jg{vR_$#;M48_yp<<@IB}5XkRbHn;ebLp8jxalolKrqNjBj#?egA5TVA_A*+p zif+_jV;eH6<`Ye8KLb>-53s$xbfLBKGJ64=HydqO)U?ZCm52h1npXEqz)hJR(?}n^ z=ife(yA0e%301=|AUl+CP~^b^O_UM3q_lnz$H6hL6ZIL+UOxsHo@JoH(q_-%m?e>@ z=p_&pS5o$oMxQRO7hb7lbwLY)SR9{_)l|N$m(lcFXGr>7=si)HyBc4}S2Kx8C~fqlXXp zqneP!0ZhE}E86HZ^c$J-jNHNUhGA)IkV+*+Je<06t{cBWg;u(W!;Rslj%nO~_xk3| zH$L@!{6}KHxXWs$SHde#LCH+E_xwj4_9}3io2)jH!`t(mxGX4f?|`!D%RJ5oG2N~o zknINzEY-ASLvuX_BpGc4GAIKaowT*(;X+hK(86zuE^9PJwGLXt#!Pq&=9j$~s&yfh zRSHN6(>Uo<9VLTN6C;I69DQY;DZtEU1UMEs_v7G*pvGW&u;i;Jcp)@GAN`<*p%43t zR?~ezw6#fciQn1pg~p-v|k;;LDBqfj*BH?mFx zHb5j2ISyh;Db`Z!M?IWcnv=*4m2*F|Sd`!*TY^vMiDA=+hmCMdlqeKfCMOja{&fk4 zk-~8nLrw?9SU$ZE*5&;4POB;T?-~mjH zjgSE$HC3Rn;%icP@k(fg5K5)19J+zW5qWA?JCH&H@^Y{-l%ZwY{d zEqm?<<6IvK^y$Lz!I{`u zqf@qv=#p?IT{JbQ*LebTp5!uT8*w62zTDvec)U4M5Ye-QMIm-=C1*QmUjao~O$0p3 zf&uHA+|HNYu`UG(=_{nDOU-Umq@9*EFtg7YjdqdNwbw686va`9aJHW_@M~r3Ij8G2 z61wGq64ZQCs{tS!N{mqrg)s8QjB`kwhA{|MO>YS$wyYvKxmr$4ots%IP?E>l7nAkfvw92qULiIhnY-pdRVUiQ6X{#@|I|EZEW0AK+ zd#$?>ROq<4x7$_3tyu9?$4taT?Rc-$3+9-5Ifq!fEDdfDYfngRFg3Jv@I}A~ta`cm zPGdRoELQ9ZHcQ_nVCxAhYre}u=~=^9?(?Ov=zW&}Fc4^Hn?AXr%@dz@`>+rxDyH|; zl=xS_xVn1#T`KD`bm(&&aEF>j10OM?DW68( zL9~k>mjJs@fZYA#KaL*e*4#JFLL;>wM>^2Z-eMJmQ;|a$J=Me_UA;u>S?ZKQt1h}4 zurxy8Q#mr$Ky6Y3zC*j-FXYJ0C@yCKagHbPPUJd!--O2Cy?mzU2 zkH5yZ@GJ3=WzK7k5pL`n0?09GFKg$W%06`&1ZNqzI|ylWemIgt^P;q&E~@){5$T6N z{DB|%!9V=s#k(w~mQO(L`vp(--e9xQw7hMOQ<>`eCam!KP*WX4V3aD1wHLHQub!K{ z$VL9{guw)W8Om}|msS)jjKPECz-mfY+JZ6a85Dg>JI2deIHOBIE2)bw97Ar%=m8-& zplKg=px`qVNY&g4{g>ykPSNFQH=xp^=!zkBh7)JWG$vvwVV+Bd(|!hxEhHqMRxp@d z!V$QMqLpYm>!`&d9cT9HBm{^WC})o1l4DN*MmVQ<37iX1dNHU=D%%_*PCN%(mSx5n zX|`l^y6pEhhec<;GMZJUR+_ik&B^%Z#V`yWAfH$sRUl;EHTzIf+uSc(wWHA5Wb}F$ zXmQHi2iLoY4&}6+Q;O_GcfPC6StA;rySeLU9

X2jB}gLc(s*6aiAT-X*nhA0p!(YPiZ^JwVoeV{>>E_;KI8!gVc`IR(K!LQ; zjp)bJ-A-|84=mLxh>MOA_=<{1I=}UGss5>+xx`RMs1tCG(B2h(20UH_TrVFgY zi-QXTmn4<@CGC?_7yci4HPMS3{f)h zh}fWODn)*}?lgaCBhqIw9LvzQ$FwZ^Xq3|blB9F2c3E+CSJnLM3cRd#Y%P% zb>{TQyFRL%o&t+S?*${Hh9^vOs2g=^E;#l`z4d3K&0a?L?!EPeH$U=`4_)(r@*KCu zLI=5QN5&Qa{ByH2%0#(o1BO<4a24!4cNa~MD)ne!()JXqdIw~iH!1$fANJ`!bG1~vKx}=;dcQ# zPR9!e2vR)9K#D!l(cMhL3G0$#*NGJ)cFnirNdkp%&fz7$hE&mFC???zV4G?_F6V*F zr{-D~>{j_Cp&2F7SNoeP?o9(5Bnd~9>c%X|M8FW^A&j#~GIF}(qq0a+Iwp=r{j=w! zG4$@iR%M-ylW`X+FxX7XlF1>P&|R_4WQect=Z=Djk&kSVRGE0kbRpQNEl&Iw0P$X%uTr$zz zGnP#gX%^UbK^Mg3)T=p`{=EU#4nt}j_#hK<5zb;}8wJddj(A9Rde%C#q_gHgAyRed zXHuv7oGk=%faT?ehLc0UK)e-0m791*)3$GAw=L{b37W{#>1;-A$9x$S6Kgwd6rOOh zz%P5Bf4E2Hoy*pyIWoZlmVT40mJ;jQQ*Piuxpe0#v?@?1{AQzH4fs9KQod^^qt9T} zB0Z}EJF-R9exvK|5LiS6?Q5ix(HEVZ^1oo*X6SUCApk2;-Oy=V&YC6-0@a$uN^Iw0 zl<3Bws=`wbMV9aQ>cpwm0eHuPjl3QlWJaZD0fvuAN~WmkWca$>XF8OoZ=_-F%ytjm zo%LRFR9>qgVwtECHZMbw<7Q@js(v!7KJ)lPwI!#B^jp$AhJ2omaP1D0>hBFM! zB+HVAwA<{zAj{4*#B-rU0~~b$O-V8(P{fFC>h;&n5U0PdxRlK6JVG zsN*;Pw3=C2DpSAE@U>fS&tLMXhT9K4yZ-VUPyWlFyZYmQ{@!oC^Xk>(E0faKC-{1) zskUGoo=cQ{bi$FCh<+)0;piF`)DH*4Vq^*GCQng3pNvzfd-GLXe>T> z2CglFVm@8Y+s>1#+L+D;&L+ksJro?tr`(H+E!!H%57#1%Y1MPMR3N>ZF?TYtUZezT z;XFvuwjtS-KV9yoC|;Mere`)(Wbh7%Cv7la7Lm9*xtg(=6I5qrj}S&;*Zr5TKIIEQ zKl8Z%03eLoe*jqsrFosB&67rA(xX#!eGO<{jSwi&{7uR6qp`hWPeQe6!yLW5|H><` z{vSX8H~-;3{6`P?mZDySv+In=8KNz_j5Nt|{?A^u)puBPeX-5+nLuV=irS4|5$PWh zZ6UdnJM>IUdYdiYA!(>D^bUx+$xk#cZuI&Tc4~Hq$bOE@uGrPae1v<670AOt|JtUm z&>`$Hz(L1`BNdwI+1hpyk=O@VX+XMu5%7P*L#S^e%!WaUPweS{n(z*k}PQuCmpG>lwb0prbV0?d!3V zsmeFk{qsIELjL8+(lfx3pb9PmdO0-G++7- zLv5A(Ee4_VbI>|S|khvjRT6xjP9{Ts2g0}%vO3(0iq&~q1Dw(u2Avnt70G)S@)Q1k%=K>Fy}b+(Wu zW2x6`nkjcfoPa^7Ix|9pVu^ClB6~KGD*ET;OTE`bV>ddNSkT>@KPAwc&D<<<(i;Ro z;CCf8bQ(Mzg$4tzh8bCt zoI|Pa)(eTL(4ABi3holFpsb)@u3Cw6-Lp|Ep9e8yrLDL1{K2BP`(W@f0qvG%OGX_2 z5`bQ!@&5@p_I}^b?Q5^Tc;gd~|C676`S1UCSKoN~%EL!3xx6Q71(F4pwKYs&6v>De zpi=5(qA(p9)Xl%6MEdz{Q{-KtCic51nV{(r>a@&ZB1eUOr1OHlgTY6$4Z{)2q~vK4 zDU@rTzV{qh7ROo6y|XjxaUt0k19>4;S7cn+s0zHktcTOq!G)j}GsJbT?rFEu;a{j& z)yj=yI^d4S&I8@4o6Az?^bwVx;yS^Vx$(?-XpIC4UVenhmym3n0BFT~D$S78Lrz@2 zf_CRL_3YI~#YNNuG{(^;Xh(5|^k`!q%=S)4s;jvWbQKMg$-rE7jtj&RwVT{>%Yue^ zlAu1>bRG}a7i(aM>LeDv0JSk#OV5FpW;k%mrwkD%=bqEafF5|s{3AO5>VQwq@7t~b zxPAHB$3FTm{tJKP;~)Ph-?lf0Mk8UFEZhX5MtO&P&lSx}1Eq&ER)jhz;gz=VR3%{T z?=(@Aq6x7wZf;(D>|-DLfgkwtFa52*`}p2t15VcgMPn)T`OO8Stg!%jt~-CsuL{GB zbo$&k7{-}wCd_M;JTy+OE*zzt6^a zloX42(Hx1pDx2K0=r;WTfFgzPFgKjVXpxyxQD-_noyDSa9UDu^lk@}ydYp}y=G|@I zWxyCCfHi8T?O{bYbM7Y7LDB%v(SYuDqOPoUc@vRddnA z#qaUpq=uJ&d7cKawfvOf7NYq_BR3?sYS3ENFzE#$V@iP?&b=2n0=yXs zH3PF$a((jPc-;9OBgSN2jsO5a07*naR2^5LCVup_+dTzcZmPJEP*)`;*7KkEU*3NC z;9LLJKmY2p2iITw`pZX;`6f`l_2S;cUWEPsxq8=FZMW+z?>m2cf7^~7+XS{ai9g)PC^{V-nPGEuj{(!v-VD(^{(fcbIdXBagQ+%&wLN-UET-dOgNTA z)~>M#x`2}8sjCCZo>g?|YEe44p)%ZztxofL*=0__yD&ulur z^So~4@9bo9xSWnHElXEz3{h9|c<2OR3=H1CV7Zp0P4k951Y$)bUypBZpJ?xY)ZcirDsXpmvU#m}1A1e%2rg_4pA8MPuc`TDl;H z$-uZw%(FOJ8G6Q+OsLTsi~4xbQ5yMB)rHT7>o?z6;8&^If|y3GiFT21`BaxSZ9EW1 z1+6ysg0#k4s5Mnt(e0h>Iyduv=_k@Y(|@s|e=tI-z(I@Q+~J4MF5bEQ_~}=?^Z7g9 z{qVo|OSk{XU%C7I!OQoYLO$toWIIelwG-iAM^+#3FE*$%{~DuNE>yB%tygUd%af@`u0@_!EJW)V+GHCiT%~zrm?Ab+aXL5=LBNq- zof{$TgQBAfN~fE)Uj5%;Xly>-_&t$e!q6b7HxtxB1GE`t_fwY?zuZv|Ete^mSrR%z zC^*)ku$~e!s3oDZR2EXj)^N|mJH*ZYveC5tv zzeAxvXSng@ze4T(t#RgNak(fPx!FF`1wwb=veY@VDdKJ-@S9@tJvUhyq0A$~7S485 z8(Y1IrwOIjpPmA+(9&PW6v+~U0hsDHuFKd)l^cK zY(u7(A=Cg-r@GWN>Q2a9XKrm!K%e`+&V*`yYI30MCmE9A29*6jf$;th7p?5{(t}}g z{3FLFw-d(#C`mM(tJEm_Ls^v5vsx5v9B89~!)v!F)%i6PUy~QNEF@AjCpxuktLz+y zAk1x9l5vXw1BVo$OvhuzTGE}6#bd}b$#X^glE@@<4LI-6!0=cULZ`=k(k@xeL zF3UPI5B%K%2F73tJ4&lb(z~yv;#}w)rDpK{&`Jx2LfsIy-^{9gt-3(DQ0AXq`Y#>a z1vQ5n8;%njj%%Ri=k%s2GQftLma&Vk;WZKT@1Hc=2lE?9xCX+ELvF9R zZkM*Xm4a4!GagEXAxTi`;p2=(!!!c43XIf9#-7{V1soCP-}qbwXp+tuS`@6iB9RfX z^IUUkh;Xi&N7+g#E(szc%^ICKScFT8o$3J;3*ZNy8=RTZsH4G=5qU#m%bCKayXk=G zG$f!J%fb-J&S6eduUDxO%@I~O5qy&P#VLMv~v|^oTNY6SC8*2>2D5+xf(t}t32!3!CEo~X@>2FFI1=p_zmo#O(h}TJ2X~e%Z4nvUa_rzbFU3jC zZr7m9N$MsxbC|J`1z|uY=mLl-Wrp3O5O22PdQf{6i1Y~ffQZ0Z}Htkvi=H#!>iA{VOe0oE; z6wqM6&_YRWUR2w9k=#L1`u$9!a2=>F#Uw1+4!^Q&v(5`u1f8%?QJjndC`xq|AZQjh zel!uyLp?Pc*fO7ionWKu+9-!GeGMofu}~Ts*vDxkfx!tFsHi9MA>88MMzN^H5(foF z#z7u^`FqpqK*vV;`J|7mL;$;f3faiUSFh^x>nmP{<)HVczaK*GI?C5ZaW^ysr;XZV zLX)iNrWO`OMS*(;FWx7gK|HR!wF5+3=H@`C0`IIUF#=awTlMUf?tOf>+o9}TQIE_@ zL?>8FPBnJRG%|tO_S1-q;O^e}$cI1l&Ue23^Pl_d?j@$xSmc0bDB-x1`^vt1=*<4veTZvlnjydD@{Qmd<>M#D{xA9#-?%i^5sbHZM&QJaq zj4WzN8633oBz6NOZi~mJi>M_`Z7}^FG;MuD(g-u}>Z@Td(Vh(js%7eY^+y1g5>T{B zWXItb(}QPcdm!u7#MXoDfW=FNt8lQ=2O6t`0Au|vz)G40WWti9kA?R+jyF-O8En^~ z`LcV|ajmQi)^!Dojt1gN+uHHPT+OL#xz0s6P1UEI)DUWw6+r5mTx7Gd3WOo)>o_u< zKqd0L9;cb4MNuajDAkv)Tab`yZX1(HJ=z)g;4dS730lGeT~Sob@-MdA4;93{MjUJ{s&Se$;Wzuwt2IbTJV8 zBhpoARhR-A3R!(xZ!9a33Pb7G3eUV|;nL5+yfouMgSYS~hK%4m5>mFuCyctS_$pFR z?R$Q8z9Rw_70XRlK2jlTjdT!Dm_;Kha)DxYB}tTi!LsLz5jHxt!@QV0v89nf*fS9- zkRUN=+i;#mA`t8wqNw*lLaWeJS`(J8xQ7TA9XmJmy3`#Sl6fOjKv9E?n!B5k4eW)r zB&3!e(aQ&3QOI9D5OPpdxJHxicg-CH%^YgNni9?7sF{vR|fV zQc#Pz<^rte1zQO7YU|>fe#Fe~1t;Qh2e5F^qw@?J&}+TImu}s(=P@d3bHoP*MpsB; zx`f)cMrTPTRW*SEF5IzROv;Et+FF5+IhU+mYT4DAoXwmvL2J-nJ!o7Hp0I$&1&FHY z%XW*L-6I>0_!(X~L&AIhZM4->L%7PF!*KsC-F*sI*SSz#B`xeyg`SOCFE)8L$7I^7 z{p>tg;-?0R`xTn`OJ)?Vg+d+vgctqum%h*XlYn;rGwH7doX)OGE_Qk+8nXJ7mu8+k zd;gcd_`9Sx<8)RSj#K+jskT;nb%|KuVGBo@Mkj^Log4XV zFx@zxzTp9@At5%3C@eOgj&|6t_xPb|4&#}XUbS%7?>2aF4yUlyv8aAm zY(()OOl|6!N>Cw3aP`f?fLpz^i!wVAKISmOUKs*9;ZU1Xq^N>8>BV?5r3R~RMx!2t z1{P+Sx#fj1z>d>PHA1RIwR^m3PtBQTwr(XxF#Sm-f7;!UFmq2R&>zc$F| zc=DN7St7|pD!JDL3{4rcG<$HvSQkr*azaWh0B?EaEnofN5A}_{B^G=P!8n8!qCPu8 zBd6D#R4WzQomSkbHaAkgoKj+&#QN=z2B#3Mxk)!S&z?Sc&wJke-uHevvpx)W`!1Tq z;|t~iQ-SO}aWON3L4_n!;n|7lh#a1!C`d{I6p?kQxH51B+TdKhPD6I>fKk=#9J=PY zoBfN+dPjt#;p$;gB2ik~A=JIZhWM22lx5Cn9!s%KrX317F0Yo3D-%L-t(?tGyb~=I zYu2dNL=$&Zdn)&J1 zjANoZei;=fK|P(|-syAjIk4ZTI#y$57JBIj6MY14j>&*Yh-t8+OkFL{YDsZPu#E9u zxxkiNCC>rA{~x{lZ~a%F|LZ@-bAY?|{X4fY90r}dFA0?d4Bc=`J@S><`Wa-qqa zv@4HE_LCPLlIiZOoJW6_Cp)Vg%#XtG+j4DG)Q^I+s~}ou0~a$=P^v@|nNMWA z?O`b`d2p2_jV@$-W|t+!c84e&7K5#nGDLNM$tZ{r-C}9?5ht##_`9Dek4v3|Nq4)< z0AO4OZOWw313rA4Nq2P9p?4ch8qW%2eWpoG8XEBiwo$7bSxY(S=9&vmQ?ctn^zA5_ zyCCNN5H1!3XF_P3V%X${4YgrW#o!>DR9=R6%cjHyfw-F8I<42W;3vX!3pY$UOr2ZC zdc=1T(FEQpB9x;;70Zi4{PiH@Hx1tu2liQeZsCWXQAC9{Q?aNfjIco%D@vztr~`_K zdVHKrSSViNDeA*B3ZttA!Ro@9-<`)$3oyF6`paQpFBzwh~{ zpWgeu|IMwx`qQu6fAr94*nJv1cM)2XXxG>}j;xqdAI3~t86GJiLd7KNstIC~iI=@i zmE4m=0f7#jBd9Yfq>5&$s#DO|VC@-|Oe}|M3GelH*AT(1k5-*&9xz64LUA0&94vx7 z0?9(iwInl=8G))Xx&;8FJftH5N%g5eXCZ3kBBnAE6!aVdYc-MRwos)Q6V``1&@`B? zJNz9dEc5F$P!;{-GCLVebeigUIXT|+r&@l^*_+pV?P5pk(wVkh*0EMJ+>Ys07!Rfb zSQcjBRWG@zm2e5bscviq$q33Jb<;I8$+b9I*Z{{umo5W3=DG-Dx*{T?Tc=vaJC1sl z9jQ#H8?C<~+mG~%=8j&U5>PB?gP9U%3~hECOM@UN7)d{w8`;xm&)@UvyFc)OujHHe zX-Do`LS+MlOsP;%)R3r@My-Zu0@r*>Ex_Y0X@goI*F|-OVjD~6(#42((1*#36K{R% zEAM~peYQJ>l#)+F!fa__{qP;SFt!fqxSy2Fulf!J#9-vGo^LhP7fTw_9yoH`z(E?e z+0;OinVd>7t zW#DO~(6EyfKRLNkn}PjeiNl}VsLTK(;M6sMX!abRIar>_T!x~fwQ>;MNV&*g{>LTVDwNHw^XxE6)QyU2t! zZV6Dd*D9aj=(i>n#}Z`$5=*&as{t@0;8>*v=~$z)dN4zy0B62i1A%c zWU8-Z6bQmCQCm64`^<#Ht~7nLE@tBz8sUf#3a$*$VJz`>yMO_SFAXgL6Hn0qTR^10 z)D)JIEcFy2RaIQVC>%BRXoZlXVn)ZM=Vu6`ofUkb;4`nNGKk!xI~ITjJ`a*rM620m zU_PbQN2>(hRrYm#T1CL2fzd@~LifR<<}3XU#@X^0y$*8{fWG6+6(cXaKX99mF4Oe* z>5C`+|HKz>x%c#IzVgoB{rLTV^H1OU{*OPp=Xaa<--Lj&_bM2wWDSNZ(shXGs^Wk^ zzk?q^_PC;FK$8ns^K@;qgRy7F<>^Ex_W4 zTsOMpOifkc^jj8VGfFk6<-thcU{GK!0B3!x!$ah2;BZ}j5{j#qed9J(0-DPIL{JG~ zI=Vp9(N}j)FID{^^9PMS+JszM0R>Zx3MQsnoGv9R=-mVh!w^|0YR`qS@DoCSjyBP% zU~zr?#)MrBB08odEUxM#!IbF~3jENxsL?3_=DuQmNw;`}*~NrNPdM~iSj#`H zsz2Dn^Ftqc?UhF_fBy4NdILl^G>Px@rC@NHt?U@}$n}c$fr5)l7NWdaIzA~mx@ZL2 z6;SQ!s%J51!!ilgs z;(BgOo-9=?QUqplb@T*4meUl_weGKI2YnrQ!^FZYL2xo>#Zt|211`Z$b!xNuE ze&U<+xTbBEbYmM9=DPjD@#>(QJcV##XHeHG$a<42sA)ND@~gFr#IVK5Q<$pQL*wb3 zY zaDur08p78YRZ=r0JP;zbIaO?LO?4&^x zL(*tgRbM9q*R~p!d~k8TXs&l799Y@YOj>j2Jlq=w65I}>!g8JH zpdY!|$r+6*=T52=nfFtcTWm{WSjJjx_8Sx2W^Ps8X6BP~KHe(ZG?K) zaci1f)nH4@w_lhzr?7r>iVC0N$Q%<#+j>0)U60C;3_vPCdWIefl>M}@_7Qu^MwP1e&SzuJ&$8K#++o01#msT?mbC6 z@D2m_$>SIAe#_JMed+zb{9||igYUZau}|OUAN}^6-IoYuptbLy1|oZiTDDtgH&Ip{ zR>iw~QdX61leaCWLMcMA_-qtAaw>vET|HZ@okcuPr9wG1v}n(33$lh|YNI+f9u-~~ zCV^)az^MUsLZ`uyA1Xzs2UhQWx z>_(iVDqSNMzatb%#~CKP6=0t)vALZk#n>G~7UW)Xh*I_kv{8m*x!cIqV~)zkSz8ll z)Ifu5j?4gWn_6MTcjEBlJe}<@e;H^R0uh=Kr;^VSkPD@PTzPO1MNy_|G>L|!(ol3t z+supsXbz=%;)%-v(VNHAvBu05D4Z%;4qsCteLq1km68$h9E1Ae*-H=aedNPm#s3=m z+~->P5jGov_8kNvWZ6l$l@f|}LwoSGD(!1PF~;vA$@|6}#>Z6r>C{`v1tN({o8?=N z9zFWOANY|^{@g#gfA3x|@|e1~NTV!yrsC3R!5Y{(2bp7uneqt(FE)5fp2o?0H8mN0 zsGM#%T~I3R7Ymv@b5N-aSespUT85mCY?})$M?Q@SIV%+O z&4(sDxF0;{jn&tm-T$8d>&a(+>DF)g=u7u*J^l3SKIziS1@3J$|Affhw4I?Tnj?Vm zfB``wY(SeATUicw&o0R5q3-w~QH;_tgUd#25vagC=)S7}kEXSZFBI$+e@^wJO?O|B zt$5mjCiqx)_nil0<8k&*>Y0vqPRAG7u5WBBxZ>Bb0^?Y0e9rI0C7dA57+p+M*U$GxS~Ui*nv_q7@lj2lxIsDKd^sxHP_a z3EFixp$+-)iTs$Wuka8)+?KJWS}${AJch*i+$=IRF2k`mcPv0)p02wqG8CAKcA`R@*-L4)bqiAO_I|eNVS%e| zgwj$jcbeRp#MUvSSo*F5L`Ipp>Heze?+~lQ)PVxYV^2?!rvbbnFn7K7kEVa)>kI!q z8Av#fz&77q!F*|gCkZcjz27MXIPZb+X4sd#{rQ)?`tVQwK zaJIvGqlho@`SD@e82}u_DkU3rs(?bC7h*jkH#(Pt*1c#^AkJF-Mg$mI<>CyW?3{q9 z&#MQ1A}SS{j82h9O(F=FS>YT2h9;?!5wMAH;0*D|P%l6kr)8Opqbb zN0>on<5F8A)AM6l(sV%SMf z2t*!%QyDI*(=F1tqO+ZH+C$SQcUQu-lP|ie$wW#_@>_TA{oqeM`NyAl{@Z@TgSS3> z_Nia;+5C1NB4~1`I8zj~Mqo^i8V@-VRu`>JyDv+*JQku6@+)1n z-ejUoi4Bd$#i$jU+tEvnV>vb67|~354MPxUI3tCD?d}eYK<|374=K?$_@TAJ*y_Ns zm0g0zH1jPQ&fPW%7U_KexYSZSD6~Q(pHvrrpXwa3u7ym{CF~o(o#p*h$Lt8 zc=h9=fTaa=z&ZPX)Ir9ZrnH)Larw<`r=#b^)X=Uk6_r@$=XgGxFF6|QC-RrUku&`d zUqOy}0o3s_(#Sn!0R-Z~iXBY|~dU}o<5HjeD zzIA=*StrPQ`*Hsby`5+{xtKizp(Q`(LO7)CyMR#)5G(JAv>KHz@K9Y6Dyb9a5U;^%LB=e_^%FTD7Z-*@lvore$a z^)JkQF_GzJicN31UKeWVS1>h7$sRiV*82)eg|}?m4a#s#<5VoWu*}9mln#x&EMrty zwglBDoSeC0YG{|+&z|*c!So9qpyjF27BXjq*y;&g)PgWyO+eI<&IN50oa?D|3Q-Vh zfO*uxl3Z1%`qGE4R2ye`CPAiDbe$@+dK_pu50!GSCgKBV`G}#7mYY*=e9XZx8zx1P z8gb0wyr4p%yX&FEB@fAUWr1@=%KGa#fir@xa8ZH0TjM>k9GNm$6gqRE9y4LU2z(L* zuB2A-DV5`0AIEVFfEx8frzxg72DCJ`Fztp7t^9CuPVmFi3Mb2PE-BhjIxM}5;HC4t zV&q8Y35oo;jUZ;bPuV}0Q_^w!*5k*If9*GX^k4X`zu8e#utw>S_n>Tb-cD^TCjryZ zH+1CfDK5)Q?Zq=BpZwoICr3kIU0mIwYDtwZ3(fNv5ANUj#&7)EM~@yp>oXpQdnC~T zhtM#uZ^)r`nF54RN^m->4v0<{&8}G#do4^qmv$kCod^T&?E2H&Mg%OnreNWpFDac* z8!WAZ)Ph@`<90x~sfvaUIqaB=0}ZsE4pm(r+6?CuP_kj;kCI>c1d9FUPoRb)j`(T% z*C3@7y_g)34c;86D+u8Tl(vrTj=`$tA>nR-LdgZ4godXiL4`_}SZem_`fBa4R9};R zjo)}KlFKn&gO@^7+m!jE@i12is@Bj<&R%ASViD1a+8rwcKuj~Hh-)h-sx*kcT}6JR zpv;h6(8D1*Q!QbK3pYbc{2mk4nZc3Oj|JURNXLqXlJ}rh7c{d=v(xNcnpH3185?l4 zy#dpH_u-@O`r%u@?@zq`OV3_>;LD%$EoIyzwZe~Ru6)?@%L9u2i(bndAg~_u-a9(c zbWPm7_J)-$&d2Ce*gYHE8ZhLQyjqbEZ}i+o&}ZJS)WTjiFfb@Yu5j)cIICdrCMbzH zGf_6p3p<2;RC1{+Pg-P76f+c|`wfQ1X2^)J6~;uAe^IUInuE84BOplrwD5F(HdFjj47gi{? z(;~1zp(Y7oJ<#{3PSZ~=v>-C8j`a#8_ZR}9rE=H+)a_ugIT;<47YtVBbC0RxlR%fiS#9q^9P zI+WC%T==%I*~Qq*Q*lhNB5}CPdUc#ILAIASQe@Kf5XOGsKyMa2}Mc!75_ zWWK16`Pr#xB&nS#`0WlEQAW#|X^(Mss5-c{096*|Ehn}*fJ0KlROXs)(f|)UPT$oM zU0mo#ToI*VVwIL*%BQC$Jnl|Vx<1JBApj6QjcfSH5kcF$lLv#4vxlzpTjfLxQDCpw z5MJb^}^ zkqO4S!Jea3Qjs$ZN@Bg8XfBcj8?)#=*>x;xpfyZTQX@hk=L^K9K ze}lJORQCrQ&1xL+s(z1ko7Ci@AvXiUtH0{QIg=nJC7!Z6v6g|}@@)H}bjBD8;!H4g zM9%MYE+5P$3pk2@rwmGsTzN=y+T*S-(Mz3Nq47D zt!=U*q%tn6)Lt@^L5N1@_DRK70b!Gfovm(eaOPD?!s)|_3{E$fY?ZH|xg0y00_r6q zLe}13sG1U7b;)@YW_P$`axFblklG=LT{$VT7x(Vo|2rRl@qhgIlaIXj&ey&7_Ge$e z{n^j){(#-2#>dh=&lEpGlSnC3*LjfNES~L;G=gbmR$2W6c)5x7=E>uw6`x4<4e|y02T*J%O>f zv=I-vV*^)>6RI92fqA49H9nH+0w1+F`J&1(Mw)@mhQgILy+wA#OxfnZz1bRW3R*dp zkevDq2}mkqPARfzxb3oL+k_NNzdE{2aT=$nqM>V}<(t&tdQ5yh)+XvZxK%hfFlaqh zO^O7yQ5k`=2wYCrwK+H&AGAmcC^wFDvPk1WnfRqAHLtngQB=L2GsNaPa z3t{*L+KFK|wYFJ2U?yZ6ahdAPt*&Uk+~JR9t0Y^hGSrCT63;8~e4!^h`%5BIZF##u zcRt%iqB##g(qmK49N@(B2loB$+iuR-9Px9cmB%9 z9zJ;KL9fj4Pb8VMcF%3T7hy~sL(b)LBS*W;^m&%5C9}jptdWzo{e6*nnWC0-LTwF> zX0!99F41Kp&r=h6y0+FXrrs83f9jt9LJX$WI#B| z^RPnBRLC>`3G^C%A%&nD?4?92qnbnkGeAwn<$}=RM*;o4jyBLDM}u)-9~Mm2d>xZv zL{Lt;U{qeW7@1=d&0?X9XgSimq?r2k9VK-+>c!m0WRVM`(_`HjD>Y`(fBlpzG#t8o zbm#2&F(Y`v1lJ`94ZvdG6FVDscT&MusonJRoR8G;V6FI)cfI3x{f>Y69q;&}{(h21 z!1UNvSh|*2A}Gd9<4Oy`l6mMym7r6JPS8hBu7>)ggi6?H*UYSxbVv{K4Y=M@C1+*MN_TGi~7>RG{&#wGpYb-vN! z?BHm)Zho$Y^duRRb&wg0abek-e>EkZR4kbr0N#xzlhD#rW3=aah*)3)6dNgeeP{`5 zxKRSla-Be~oq@Hb%1KN8dyYQ>h0@`gkc-mXBUHX)R&SOZxjH?`!a7He)=>1Pdd6rCQ@*VdCsP2lpr90>4WXLlnQ=YOnP)@ujoRF)SZ>0+(6kPrdAdAn zIn|o#hSu(0)6H?_0y=24Qefz|+Vxrzg90A5!_NVFa(!5aol1tL!Vzm+0;OfWVVpn7 z#!uJFp6OP9EbLQ`0P2Yt+AI#5whAQ~?d*sFF_WiZr$hxaB~@(G1$e%WsZg~Y!^|$_ z8!-j_ZpTCg1kIvHta~G|K{`^L(`}z;>jw2H;QfS#nh7;CtmN+O_kIk~`v!tc=q^0) zy+DMHME%Ybp3ZM*e#GB7fpXyN>3Jsb^w~S#`s{tL-v5rjapw7^7o94qgXSU=xbvp?)gu1I1{G(?&B+#jd&_UP^zaXN;j_ zo;+xs4l*GGv2ekPh)Q8;l2tldbJ#kIjCCrhT9yPM`%P|H7~IrTng^gsR8O^5g+wIz z#@2YKxR%}QGId$CAy=m}wVmqx$>g%U3SQkWv+l3Y7XJ3c0XnEPNpx#90!rx#!6Sj|%X-OU9XvCVtOjL5aKo~`P9f!I+s~q*7!(hU_?#i@gP@n30xvGu zY{|1tR>bk-xT)$`sANPGy8#BPl`AM3HidCiHLy(_X_ige)Dze_@5Se46jAe{_s-dh zEUk#4EGwEXsz@S`^DK{T7ZGhXX;-5?I{Cp8%^{FawRILTy@9}jVnJ@AjU7=OiSJ4q zi%N!;4aF3=AooQwuNR-tl!#`tfsokxdRgbo$SftX9t-Jh=1er!W7J|LOT3{`Sv4c-#H=z32W5 zzb5bQt>-5w3{4Yc9F)Gy#(dzr*61Fg**TaE;}O-D-wp-u&5b)-yMNP4!H-JFE0e`3 zIV8Tew>Iy}Cf6DD#!zhcAOTnfkL6lr@?C-E>jIPuudz3SUnqy!Rm5phay_<|TG&~g`pT(f zM%F=;0OT7WvAht21-XQn+XCcjfEtb7RnCdR>#J9c?))nolxYy6R5B@ZauO>E564$F zdhElN?i^{=d_%{VR{BsH*KDL={@q$SbKDOVT%QZbODf`OunWZ%N-{-VDAAaT@c}p@~Yetn!a9j4xoj_Se_1=qTKqz zdZroZHM`5gkkEtNCZtaNERthSt`1m9#az;kZIJh17E?DUrnVkqkEP3dlg{bF1L_WF z^!pwoKJ(+pofz^Je1ZRYujSKez5}p-^5t^T69Xm88_PTs=$mOtVt!$Ehk5hl3r~O5 zJ6`;XcRcvx|Ld*)^nbqli6@WlJ-Fj%1pR-A{+HGUy;GuGMD&E-s5SwF?#L*$RCl{! z@Vn|@c*0xyObS8MO^ziRF*a;bLQ>7D2~pDRvQ(JvbU9;6?$Inm$#s8_97fK)0jYG@ zDOVhh7nAK2h@>zDqHk=VQBc)#D)1T(f>qSGW%FogiW(2k7T_L?7J0~&97GTahc7V8 ztPpgdU*}z-RI>7<4u=Fg6sfjs41^W&eCa2)b1|i$>=5*mt6z4J4N#T5l#?RJL(k_8 zaa6;zi!c_)Bjj_~QNuZ~J>xrd)&wYS0^X%dMdtdXB z4?cSNLH#uXam(rY<&XtrXt>`oIFUJMP4qrg=m?G-4x(CB_5ovN&WK{YkCDjl?I-U^ZBz*}&$barR60fw#V zbww^?qDhWZP=d$#~KmYo}54`tf#=id@ z(=Wtmy&K)|NfJgZ8knD9)U9`Hk?5-KGE}O%c$3Fto6zSEGEv`qf06bleT2_ix;Of9 z0|s`mzHy3`+XAyL6MC~|b_VnA2Eq)^&@d|51Eb9VQj!W?Mv-4HpsnwSMPvkiy!+Gkjwn^h3ZtU44+n`)s$b0u-3xQV!LD_ z-(fFe3wgTA0)9oaJW8;lfL}zRiMwV5QA|!gB@2`?U7A8`)ZO#ziM^p{=N7FCY;`nz z<3i#<@u^g4%!yVeQWuWddcCN1W=d4gZT%^e0^lVYNgh^2*QcQt%m#o=t-Eh2e2IGi zFZOW?tgRAlsZxiLCTlfd^La!j80$rZ9xw(Y6Gt}zMe*~eFnsP;5z{xOF-!Z_M0c#@kf4oJifpq3&{skzxr~@0kJMF2ODUSJ zPFY}sPFrBnl3`O~Wv?1Sie0?&>@!~$o!|mURY1_13=JBIq2oZ&%ke*7@^Qe39DqbC zS%WzbRTiO@|jIoXy|O`Hq*hF3LLL1DYKdh0sO%;BybH(N!gLmd|g@v zID(sNG^?R#I>c(o*369I+4=rV<(#$Rz|jiFx)kaaX+y9u0c5$4Zw;BC(_qGj9CDeV zb{F*un76O6Lat)xV0Kz)i78YqN*Y!+*oF#Mt<9J|jL8BA5|S?`6vi~R z(Y@$}QMwF*L&_1>c6IEjI8u#;%PO=BtP#h|D5RioY+7t;Hexr{T5Mx@>(CEb$E75KWZ1e$0V#+%z%*1XOg}7ZB z{xSBk7F4XAa$ywXfN6bsG7Ooy!gw44k*d59xSB(e$7Dx4snm$Xq35;$EEsCVe5AgvyNM9n)yi z)WC*ZYYj-5$2oB9`fd}kC2I4Wmcfa|R_q<;SXp=4pl{$3O9v%-yS!3ttVMqISOi;S z%FR2K#Rs%_q)-aHO5XGEv` z8?_}6qOBOc=|q`?c-E=+9W=Fc*|Zc2#+qqpX^Cq%arj3eF5U(n6%PAx1kX|A( z1XUc7sd|wta4akQw3v$F^D>vOLYsE`MFG_JY@g9x?e+0Z6DM48(#}!jO~w}gvho|g z{%c-)?N>i>Paq#*Mn}dmprNMHI7gm$paM&d0yLH(2m=1MecQJgp0yi;1EDj5j7Q2U zCJggUK-r%Y)L(haTmJX&{TsjdsZZa#%b)m|Ozx{Rvp_`I5EYaPE_gT#pIROnrEx55 zI0>JEw;4YZB1RHm?A`MFhLlE=Y7ZSf)&wPbC*T}W$e z2_ssU8R~1)YMnihqkqs2DYetrT)pz4Q@XeF=CWcbbvfmAg^W6+Lnk_8ay@;M$#16K zx>3D;N0Tw>-`sFqNsoi>OeU5Yn*jq-(C?`aI<@d>6Kz)E9xI6T=_Z}kk1+`c0R~!8 z*g;JJMl@*s%KMDB6XKsJrkH7xzFS`3{KYZ`W7oL6kb-psR_5Q|V zz~V9vbRlO-w0l>r(}8x79De-)mR61h)M&*Q)6X&4A;#7~+AP~~mO|Gch4lpMaRYic z2tiR;6u=o>hMe++tvxaqW)PJ`waP7Xn89jYm4SBpRoF`{sYMRUI0l+G>bjsD?_;aq zH~FIMMnF`LQ`(vnZwogrgWT=d<@9=1ajL;p6K*42;P(+^2m5E;E8SR=J|EkF1gd-g*jfw?n91?) zK_;r5!CWwsu+6h0MKwX}2y><|5hV|ua-`&ae?t{P5!pa%CLyEkBLkl*m|7SK0og{d zFOqY}HcgauE%)T?-HVltyJ~dD&IsvMo*P)zTq_E`Tj)6Ae2D-6KmbWZK~xg}?wwS9 zBTcoQ(}5|P&uwvvd;h5S@#AN|@-5Hb_oa8g`)}R)_rLqr&wT2o`;T6ND)?jy1V@G6 z6>f*MVlAnppnm3DOIf1H!#zFHnS!JO;n*@8uGQQ%iW~;b?9Y(T5b;{An~bbeo{0$M z%;qVzZOIuDE%N+^Yw9EscgLyCdOv^}jEvrTSdh@pxL3&*ic`7BPkqXEl?Q9B8?$w0 zYcdVz&y)sf1U~bJuCWOlpIRA8jzay!qgDe`Cy~}J^=c_Us@4=;tg|>SF0d0+1h(tY zzc#rsF{bOFoQP7eU1*yklMcOwr3P-ZOH^7=RZ}1ljZVSH)*`zJS161HXn1@!2wR3f z7tF!X*jrK&pM08$Y*4c?j=jk9CMqUv_G;-ZR(n#a7bMv-_I<-Q&-P+|T{=)ekAg4y z@sB}$(s$?XJ!agqw>*0IuYA*Q|KJDT=VxlP)JP|s&Zv_kUhewz+Hy6BsAM=D%>vaD zHJb?Z#S6a$2oDyWX&hWBz3NUFFPL3N~tfDv-+v{mW_n$kd>Gm7EsCJ!nEc%@w%d$HD8 z+~`mcPcJ$TuBsrjii+K-Bp1tzy`R|Mgcoa<<5?*fMaM&iYeD#(lA~)=f`u@E; zpL%@vdw%5gU;6a(-}u${-to2~aXd!6dW^Y|zob zpxycQ?oG4;Fi`>orIkE=K1pKqwWXnQ%lza(Y3L^2zV(bIH%WCe@j1Yr9`t9v$ZJ&r zf4*(QP2$d-r|3L+_WrN9egDz@|Kz`Y@khVs-e+$;y8nRxCJVj^UvH9!y+XA>400*% z(z6NsfbE3n1c05!M!kna+R~~eM3ML!B)3P}2O~ZjOct9R2x)1~L1H!@2up}FHtg5t zhmKSM#?g_Lz5)|S81ItOMdM};p=r}bM}{_gO)?*LgvrT^iU;4iZgtwCh}zr9)U>4)UqFgnLARrZEw~y*^jk$ssd?an3^pUUB3TDk$Lo z?%k(PpM2y)ANU>r`oHwxo}2p(Fila74HVoO2}swE5H)>7QvOFS0T1Lp%vDTK@1T3u zM_HaAVtu+HeN7}cG|B+Azh4FcMRxoC{reyNx{rJ@TNpHp3Na-N2@VdbRjuIOPCEnP z7;_>-g%eXmTNP|6yJGme^;1KGH@2m5-7u%xa)_a|hxwMdSRVEn2j)8C?9dV{6a5x4 zEtAkh5xeQosDB|eNO)9DX}lWNYgGwfG)TaTE-QO=ZMsoZx8$Ul)5AeK53Ma;aEF=~ z4s$fCv?t2UjN5kl0*r-#f4%QlVfQc$?Yu3pd&0G-ZEw+x#_aTRavP?}v6LSm1OEhLmRM63SFyA(}Y5s#Q_t^29U@O0+fWEFjxt5Xir@G3E@Ja`LfP?U1DNA zq6{+d6onRD6Ww`n6xpn}VOTkxxuk)~;=NLx4OfseL>Kw}yLX=4edSMo->q-?6QBR- zPu~8>KlR|z!&_hY0%pz|orG@Wp#bC!8zEI57F|JArs^$R=Ij`FmMw4ghuon}n*Rfc zH~sBk`p;Xt|LN2JIiMpz&Mb8+Feqn5-Nar2L!sP@*m@}-0aK?kOgY*{j0|tS4Cz(B zer(&-W6#-b<}kU#^b83uk_W)s8^+q|kym>C*pYB`5+}V_pVG~i8cZZdQ#j0GnACcv zVVVzjLqvhl^l6BDsffD-$A=Ypu=(WVKnP0w470SDiy#!Kwiw6=W%WC_j;xWj7dbYe zX_BT_qC!<|;X*t8J}`F_JWL899`q0#oi4Tz@itnMX&;>FHhA*whaqzUu%xx=4sADy zApV-_?6RV6JGawJb={AuL1}`lOL4>#t1FqH7>*;>>6+`Sn^egUy&(G&R8<#q=APWm#mk~ zO{Bfzb46YnYv`Gcl37aYdM8xiO%PG&e4+_ZJmt^$TKyMK_${1G?1HK(X%qak(&_J>BC4UzOQnJu%4UNzLqzN(~1oE>${IPEZ6Xs+$ z5rudM`GZ?ezve@Ce)jbTzxU7F`i}2^<;DHC-oH=&p-PYRXRK<&s@1p-GlizZq#1~m z9SUVfaYE#d+M_Us8VJVjMQ4L&d60s?}E1DnCG8Ntd;4ApI|Q$;w4 z8O1jg`J)fVTy~u5P?wP?Q8T|C13qUo5H8$U4N;pbiVvasZJ$Sy9D&ufZH3!Hq`sbg5G@-~K`H-}<2+`Q*?26W#>iql~jtnL{E2 z-0+Q@@-YY5*{MKXb9da>>2%2!bP8|KF!pH3biY)^;kcOyBHR7ym~>SnQYl~1H(P4x zH74BV7pa<~K82HH{my{JQ5#GT2UcaV6&eF)TRa>GD|yyL5jtuIqS923rQ&1a_39n< zLU3qczQ7Q@aa?AHNGV0ra4x4-<+?Q9n4aF0ws|o&L1ana%}HkiWJ9Z52){1#pQrhuclpSE5kpb*Z{ScKXeg=7RARN1F;=;mWh=GT&dJ6h=x#bFkU zNs-P}OB*Au9VOrlDDgO?4cl&-su#Vqs?hZq+Q-2Jp_$rs zrd3C0^fkC#xA+nsz3O3vDez4@$Ye!WqBdTbJM#1dl+Qf?)C)TLe~QHC_I?(qWqwa8 zfa+U5B{SP#V9ns<-xEH6^{vmo>V0?r^54Gq@BI1OKlG1Y^51;%Cqn$Wa4&H>es>TQ zokbaLlJtPK%q@9tMo>U8V)!_(aax_wJ+LUKHJimmqDe3fMbx==o4_z_M_=m+IBl&DzVrA4!-q9-LfINZuj zt%fgxoK?_?ty!8J7YFS*dFX|~fk|p1mukoJ4po4;o^nXqs$fRJs0th**Jzesy^_xf z8YyZHEVy8_N~nMPR|V&mXxpTMdLmj+qEE{Fl|q1;T`(37A@nt_x)k8p0T;R;Yicb- z2n>&Y+5h{k`tN!5UBBmdfAg>S6>sN@bRERU=@uJ5DHObT=LnGU`p%I@qp8TJt?SJ? z$mHB&SE1SxI<2xMV9#=By-=@U&;}4S`A}qLQYdZOlDTKkUwiLYeBIZ6`0xJY&p2%P za8g4SEjT-vUD5p0tJWhsrX0(4-VjI%Rf$l+Plt7j)_uZXeL~K1ts<>AK%rK;onT>g zIk>neKXX8{&o2ZK&u}&^HT1A*`mkZa=I{!<=KWFNu~Sv8*p679oOs+RbYbxj%G>2) z6g7I1hj1IGYkQG@cA!jYDh?zFJqS{ES{6GYJ{p1@7!B1IHk~S5QW( z=J@&?mgcKQVGIz}`y$%fZya3Iun?vTLYt4Fdpk{}%~^|#HSpIz{F?T7)B`%>;S)}1 z*Is<7iWN!CsigF<3&9FY z6U&=Qv~k~Oirl|{_h%p9{kFgO`j7t1?LYFnU-`gWp8d=};7j&y^G7w_qA{}nTcG1$ zNf+G6CGQ-A(}K#CT11a0ew3&N&Z$VFr4+j+o#qTB(BumspE2A{tBmD>c73fCC>7Ke zpBZP#qFyz^L);wqY%8|RV(eX28?}LxS_Oe+=wI#AX4Ew)zoJWpeF+Bovn4MT!Gw{1 zngNoD5-1^eJBO9NIrLyiMBPn^#Td~VGerlLo0w_TFC1CMNL2lfwUHXn!Vgv(9v2wt zD9!}2(Y-hvaYNZdZl=zXdd5Pzhj30$4_DANP@u%jp*kL?EJP%WmwqxSXRM0fra@!- z$q^f}uXh+=y(hMf*v6oA(7LcDHXV^PBm5Y^={Hd8dYSld+K@*>UzUUMCO14?gv1$3 ztzpCK-e_>dKtc}9C}1W(zgY&s@$X1ey-e0ebgDaSF^7+vwU&Ed121@?l0(ASf)AIf z|DDG~fNY^S(J&6Zi;M@avU~nicREbYMLFQzVaL~XVq9$n8-JyT6Gc~X8Bp=1L9Y0% zj!#j2@&5Ss?%EIl#F2TOQ9uGtXcF+<0EWT3LO_~&v99+Fqj2=e1y$cmM2AQS+QDdN z+ypARkY{scYE#LzFwS`ePUkyb{{s1lz> z=6o7dFI6Qf!ox)J$fD5#BZ5qm8SJjeV|Cq@t7O=+SBWbLtW2Q;r zy#uhE*YC2R>a^0C>8;=yP8=0RG!005b?l=uIP=+<7t9oy;T_6PoWavV+lkRagt5b* zL73V3z`1?Yt;be@Mb%jhyjCEbGi;AQ4BU!}M4jtbfmoSJWRO#`f%YX|o{$$K`?AKc zOfXCdaoBN@szVdHN(iOAl6qG4Jg!#7ECsewhR@jH5f(Wsfob|eQE_zABlH6(&Q)TI z`Av*^;Yd571Wx8~MsVYaf>^1`_EO2VJDfKa6dYryq8S}yvc9SrMNASK884nc{piL3eO(B^3ubXAAR3n|AEhb_Vf4lCV-HIsA)+pax9t;r=opO_-_ay zFQ*Dkj2`5s%kbnRv(%f*OQUM&Gl^uW+4-?_K$6;K$28os(3dQ14kPZ;giAu%imV}@ z29BZ6(UhZ{J5=?gz!-RXVA0*b$OhnfH;_qGXSsaiU_#Zup(Y+$&dqdoni%Yyd&yHF z6tqheI{6gER~MF@xhv)RCB9fWxI#PZYdQ$E**h`S?ZP|;T6XA&SVs=RM1oJ6Acuvg zF*ydO)wb;hQcy=Y(N7uuR(Un`rM+IIszxKnQ zd*83T`aN5@VM#Z|^u!STCFo|T&xXi6I6y~TeT)aGK%MWS} zzhQXM0+t1#no&sWT1Uv^Ac~ozP zUR!@xFm+`sDRa!jY%=I1vh6#usc5SOr(2PURxh#R*H(Q$@&~wY&%+9NLdx#`vBMBW zeZkw=jY%2_2vs-c=5$A-}>lR-T$#q-1`IHdH2u#z{AIPU-AE2fQtS`#p#_g z=cpZdvuK{ki{uP#5;Kn)?XD0R6Q!Xv0kN5)1tFYx`a4rmFzZ~f7u*^Z|1A-Kr*nu* z^HM5Eqr*bhm|zjUuK+smk6V%XA$%3&Y{u~>t}GfJ`6QV-D8BAZb0FuFQ30n`~oC$C}5t-)qI<_rws z(9@OK5>|Q=$z4Sml^JuQ>nvi2+!VA?TJp4P(4m%||6tDaOMM23mp7jhj|H@nD>ipm)9FZNKMRzWKHHei{Gzqro#@85D?Xf&u$+8@UaO z(iB}7bf`fhJ!yd=fvLui-vV^gd^9lgn6~z-&`Jqut)>IGd9x6-XPxp*Vb9+A&UgLD zkN)^i{nS6Wcc1?X%!?hqUZviEDpNG8u1GQq1Sjrk;$6;INW$zCnUyj`gU)ve2mz?+ zItXqI!qV?_>|y%@Do4j_p@}IIHLrm{XCR<=G?1kIbo#fd#xd1FZoNpU_|gfMYKML= z2wh?0zXOJLzKwO!xdM<3QlZRsiaY}iHd@mL@CYK56lpcluLJQ)d!DWjvEGAgG!o`Y9`{` zXOUODALA5RzY~hN(`DVXcr{yBSx~2I zabl4|=z5oI-n-peKF|{e>u5ReWR-^;_%u7BZ;Ya%i@3v7ES>KRD@xsw^v{tav=%Tt zE+%6KwkDmpVC;HTDUJon$>Zdr<=Xg9I*gB(sD2;CUclZIDY zF?&khMP-0A;Z;Z17?f=phy|f1DeXWL!WBdeom*(+)Z5t7zTnLVWF+sQo@yTJOBQRpruf<*}gVkZ|7wUS0k35s5~^BHUY)4iqjG|Ip`WJ5f z=qFyj`|?YUv5_e!_Exe0iI>y<*~D)B2w-tl6SS>j4$@}^0dWaLz; z93G*Htw~--1;KC;hvu6YYnmdK($g=OzG#PrRrMq06f&p64-y`=!)+LxEQUKZ&O1cJzg8M#N%`F4E?-el#ddM+M|!8CmPiaV3}bM`^ffw(M12v& z7ZC2+x*wkQh|GH;oAq<#TpLj>F z(FP=+QXoB<+nBzg;pz+I9&dailg&(_J)9ji~Ye4 zmhS?3<>5c~n|_@Eym-c6G~c`DR~+>uTv%KbY!Fah7-h-z2^GpJ?lx>$LXodk4Cg20 z<9`WHJ(&|zS9U(ZIkc%aAaro->~&W~1ZE()J%MH_mFd$)sL_Qf(1MNU0akkO5r;(` z;2U2;F7nd{yfCq;qNyVmF1T1Hf`FUj`=A&IZ{F^C(VC~@*;stBhH${5Cpv_XSDYwR zJl##mXtA|K;}FK)e+`Ay*!b~#3AF`xTEdlalpNvFK!c~RNKoe3vsw`_B5Rsz6@=*M zAb@YlmjpjYNluFmHFc7UK}{>y=g3h}6=mh(UKesuU&s`=sWnU~>Q0ii1q;u}S`kKi zg5@v=IuRu>Q{5O{Xb8>WNdhV<{^S4t zbKmmEK7ISa{SUtOfF!;Cgzwk#^LzRW8e@~h>c$0YN0J%g4+rDf4XuoGGNmy*!@XEg zWK{7mE9BP?0rN+POl7mkaKi>{76af#uq;qhr&j+!uzwX~<}vB4H_JXuLIpWML1f2| zMbMo1TH&9pxD7&Vj2i$1%Bz|*E^Gf~6FWUkah3 zteFvBM@sf-nNljyT0!WL65drUp-rZxoc5+*VGuTkii*X5E~`I;$~mB~qsSZyFC9DM zpd6Fw3gN-o&qML#2NXq;e51`OLG$OUBY#3DgDUDyBa`Xm2vCwrL_`4%^UQyp@M9>B z>9a(>VXM9mvU*AuZnzk&*`F;et->qMC-Pv6sVGp7hT)+duthRvuj6V%qE?kphgf%1 zGsGx#7>F-aQkRG&b*{%UW3WhSQjNf?=}~o$Bz}sCkLf?(^fa&Gn;5J%b2Z1y<%mG} z{FI;O?|p`i9nRwRcfB^fxXm9KI~=Y}zY02nFIt)F>ds^SPT<+o4}JNqcfI@m@BfbH z|L%9)`G>E+%u3Zf-+OCL$og&}7`N#%CcwtnaFKcemBX;SRP>hNl2|h(3T`tH&I)Fr zl};MB|4`YxJ^)PwS{+435tIb-<~*%{*mZlTbLJnv>!a+E3tem9stSkddKR`@i_@Ni zxcXqARkhII(h-_9liMLBesH`IUJn;~bak0EryDgz&Jg_~cBlkXy_#`Yv)z}L4Xis| zer)4s=FA1!qdI-KEgG&aVENEpd;z;$n_SZ28)s-|*|c{)^xK zmj92cbB)zCJ?r{9yld?}(@tkPyVL1V+G*{Pwj2y1R7C_eK@1oJDj19+V)P5f#CSkW zG%*qNi_s7I$;1PRNsWNSSOq*FEw+WWQ_2*2!j>K=Ep(Xa%$~j1$=~mH-OszW&wAJM z-1l|(U;pd6@8^D=_psi@a)$>&qSyK&%0{JzUBke$$c|E^y;4dh2h}rN3=1bT5ai%T zfHKb|Q(EZ45^mcHSrGJ7n4(wKu&~rohXJ^{b?es8zxRpHe)e-Gr>895WIu0mVbp>q zIRaS~JzU2))CuR__~wRoMo|S>C7Z;}XAM{N&~(Z{OG~0C8BbOEVT91RXYh4Ptt%n~ zLfQ!|IH#7=(@n6kT|nBdpsWRhrip83vl$12ja_?@;wE6;F2gQA6FH-$vMtqiTGPU} zX*FR5&`~Q8+@>*vl`)UPG;J{=uz+Dp6Nh3b9q z3qcZ(zh;UulMh(SN(Hb}xv09Mmc^yO;8V35$^{*kq))!mi4dCMG4OhNvbB0sG}wU7}7~B zmbFzI9+Fu*HFPwaOf$tW@@L|55EVDBzedGDZ1Eg8HgB&3$7+;lxp%jhnQgPuucrYx z%`_je$4m&%h0O2nT$c=CGLSzi}M z&~YI=QFtkcn4@}j^)H?H3F`0>YnWMyf1Fi>E=p>>FS~w9w4#IQRn+MWI1L7|@}T!$f!6 zOE}QkcXm#!Eh-4!Vj^4;4^dc@JSfn{05yk;d(WWBYAHymb1Il|ln=k)_!F*PMJ#Ft zW>&*^w3`=LHKmshnn_%jv2h{q_D^=r+u#?>y_~NrQWn@3AaF=g*I_eS0QS73?4}E` z8ASTc#HH}CRS%n4v9&CMI4hkn_aod0P3c4?AG5&^`ynT&0po7HMC_!*ShKx8WdE+k z34lUdwF^(;y0A@=^Q|vmE1kxPU?)Dhui+Akai6s*eo~U2$%>g@VY@0S0T(bE7%|C; z$;;#V9QkK{7w2a$fBBdFh41^GTMs|Pp8_Kt;(F$|F$o`xsZzABcT@TCbl+@2Eq8ux zA@n0a5fD1(eIwf}5#?e$n#(er*~wtCl`Pfr9bvw@=%I%nynXx5FZ{y$`&96h(>=!b z#$uM$9od9xjI}aZVrsEP)GmppU^&CFH>@)@?br-)H39&K2R{A^fn@b@9EmE>K-5kY z_UYUW@et@}*&?CUKn-vPE`yVp0SmVRYu+~2x>k?EfHWOJuM zs6{p_OEWgMon4DVEViW9aih9CMbMeuDw>MH6H`RCji{Eht%#av5Xem5Az(iFO4(DA zPSaSlx$X+4@A6JvFR*Lu_EMd8=E#2HnTFq_{aKD^$vE7}87~ zMGUZOnS3I}!I>>#5#?HmF=hi0t;QxdcLP%%L^PD@)*)7jLk~AcZP~1`n=JFGYcv(Y zD3ABjO>AT$D7UvsId;k;*LoiR zAIN6B$3P$}f7})z2Qsi*{>d?EnOdjGnoiCPQwL-F&8&vULth+KI}K^Oh}%`x<32!nO8Rhp@zS%WI7Y zU`~5wAXF0?Y{Zs#W{T$$!;4ucd^)h%R^wvB$7g*L0MA%bLebb%3{I=WlBBxFsS)w~ z3{5BJjN@LQAwSGEdZ_xzMA-FfV-hNsL@0y%Oauu$WS!W!zAXP`w9%dkg7;i~6k}dJ zO`FY&lVzec+jZ(jG@35#Bh_J@FNm!whb=fnL6d`6>^j<(zi9+ViE~MBJb%X8A<7b1 zyv*B-C$ILta^FOP^o%c z>f_b&YgdIwwtHIiNFt%Hc^M5eBe_8HQY&|Oyq0&oSeL)GL6Au{|OlA3MRaUI{Gr+Y)R3>)^Tu)zo^Sz z(ReCcZ3GA(d-SF6d;bSN_36)@-Z*7}>FSa>>ke>@W~C8=(j;<%Ffl1A7?Lw?%x27{ zjm!o$GE^lk^o(Od3W2B<=^nbGY1y0@6v8EF>SRiZ3pUfj?AEl z!$${40gL5q(6t%N1dRqEKR=)q#?&fDx)VhYBcmm1VN`W%IcQP###%iXMGVLz@PjZW2#U*(z63 zmPzPix-xQ!)|Xn%sR>1AC-#GbOV-k85NCp0Gv^7gcpFA-6MI^E8`|1xTp1JzZFtS} z1Y@xuWJ;!^o;X%Fe0gYZ;yUQhuE4g9BruvuBMU@q+8H5|vQBu#N9mru-2Ly5p1<>h zcOQG`=2t0L(b9yyd5qnI%fh==& z7O}P$3*m5ai9lF_dJ19yaaWMe;qfhuN(Rrht6)T+fyz+D$0FZW`aG3HPSEgmmH?V? zMre;Mjgr05kkPlSIhMnUtl1hTTua*z&k3_Ulv1VAFH2*T@D{|Pgk4;0=q-CGS=F%@ zHV6&|wjB?efhbx<6mkk>IoI`tMzurNCWw%tF&cx$lGuxX6JiDO#aS+Xo~MT8(Rzj=JnB_Qc|*vYkTHkYrQI4gA~U`cq-$mKuu$Apg<-TFMkRPpUPs{ zZ1TbCg@#C<&WA%tAy(|F<;)J=iW3fhQe z!mi+2I=jt3W`!u?a@P!%v#f_D);DY4F|r9`v}_EuGGZr^=v9{c|M zgaTrwFT#0IpIlj&`1HRRsQi$RpYOQhoBJg|*Dw3`lYTxc^sRfSp9sWzm z&BLoVz4GWww|D%1-+%ryr(e8$;qH`I{_!9}e~IYmaHnO(eOOBenqMGS2kD%1+NmN( zRkVBkyVZ153@d+5gH@-bqv$+mD*`J}cXg^6C^(2WlN?AFC}ZNFdC@R%GaO0_Qtfn{ zPXtwbBXqZ8Bi7Qi>4MpYo6Db+#6wEg@mXQkirvskP8&jcoX+LMrc+r&)7DKy2<%Y;~ECUWDDx%XRVN{%0(UA8P zS!I`^NyS)li_JZQ$Vb90J;mR29c3wboegBTPGhv@fV9*M>JLZlXs!w1Tgvr^a>?eA zFSc79WQ0tBi31T^3gu*`G=fE<3}hZH&)$6Z5ee;;@crGsO}{{JC++~ zi3QQjgLB#0mYa!=3UGa4D+j%L9ibbhy=W$)(TX>xgRE!94TgCcMGzsQXU9u^1QcP@ zS11hk>-nd(?#ktCW!Acq+aRj1R2~-{yj;tOW2`yl@SX5s0kCbD$ZVn~G-7cJEP`y= zQ7V{MrG*v4HHFG=iZ5L@qjT_=&2}6-`r9^#&1n7x3)(u2p9P*Jd&$C}G8hao8^A0i zg*-Ag3qPT8jaO!&tK;G8D9hMe&;glR4h%MyF`EH3E)rsx#iFrXut>{<7?+tYpkiUd62s+2zUFRe){TXK6G~Y{M9$S<>Un~IC%Ptj07uE@pSV?e>U73 ztfkw?4<($ujgW5~*g4gWJ&bACF7%eDl!S32XeG5)@}@-MB~_i_YFOh%Ajc5a8b1`K z<9Lqa%oD;RAQA%vQG3+X*AvF9qsxU%Ccv7g=)D{EyiTHxjN5uK#^k1FBGB{7%#m}C zDKKs2#&Dxj+PSQ9@S{GS@7{=vmUWN%&@G}L*8y{tj;09g2X0(ecn&&gs!cJBW{RM+ z;Z5lgLCpq(m-p~n5(82wa&|z#88a>e!x6X{DMvApY{i$DS-7cduVipIs?n^YbPb~W z68H@=u1g#L@a5piRW!3REi8n!J}ApN7>s+aqRzZiieR^sp>W876zZC@nC8mwRM;>Z zTj3_K5mQv{t|Lw-tEWk`s)S&wzix0WxGk#BH!yUj=u^lk3C8Ndkrm{blSLBTAsn-! zFPl+&!|kJFLG~;pD!1UCo`%RkOd9f>Rgl>(sOLgnXpLysI`qx}Hg>7B9}q(Bhlp%r zphSBE_0b^WD(syBCZaSBk1l!b|LpRy2M%8K*zWDWc=R`Z^x$WI?f%Qto8IGKZ$!#4 z3#OCb5>+$LB3cc3#jMjjBq%0oOTcnz$8?(6<87nmu-MF2G|QLbXhv6Vgr3C+N$%q2 zSYeUT_pzA;s|5lPjT^Gzw>C)RMNeI32GUNpBjI2Oi5Yn_1!gpZLA#UCo4nw}$-cct zRS;24q!|ohdg8K^geQZa+E1k2@PmiElaEr5Ho83Y_P}NicqJ5biIsriE$Q$88lA4O zky9{Yu$d%k3_NerNMYTD=a`K|=;dv5yk}_5rXUk4quCiXF9~2pyXDRg`?%VekLzuL z!?fjw1AB?oDxiz}%9{q0Cxk#ouS-jo2u?Q5CBSjxEV6mqchMPq_LLsdc;%~$SxG>$ z{do1Mp%fkW`lBTjDfyEBA)owlmV{glUZX}fZA?0uW{onA? zM{b>+-Sz2?<@IDBZ4+KD3MQgHlc^Y!!m7UJ%dGG&I2vou@A&2HHJEG_vNaO5Of55m z(U_hVUi9fXdKsy-shf6M(m~xqH#~5Gw^&x4N7EGh5vg@6N!M2!@tJ+dI=bYIiXJc3 zIO-0Qc*S27@E5VU3v6EL$&?XwP-7?+HnU-Xt+~H@HfZ#6uNBAHO(RcK&XvV~r8STU zEmG0VD3F|x`69|lhzVKZ5_x3pm$gAhYVD}}FjVTjWNDN>BqL*>JgPN>r81Oa#j;V{UV4Q%5rD;_YY(U74I z&S@zlH(dt9=3a`%g-VDvM>ZgP!d~r8PoBEC|DXKi!C(3pw?F$^S6})1yp zQ_TztR6bq2!bLzX>^7RFJFGaYh6y{#Erh#_!`2rWI;ERyZp$4Ku5|-7-V8E#|BhA; z@bj&U*j3kTNyuPK#{zWY+TUC=$93bO9Uz=SoDL+&rie@f%gVr$bo)IIO9Bp#>TOoI zt`X>z3rJ>@wun$EV0X-h>Rjj?38bglwj`(C&8Gw$_`N3RS-L*7GdK4+5Q!M>O$S&< zp6KggrMtz47Jq9k;W=S5qszU%_x-$Az&``_Y?Ha=!_2#XdN%r?Kj)~+1)ue&e!Q}I z_w4ZG?EDQcJAClPyMO%lqrdv2#~=LS1H023+_F?4NzDxD#6s45bIuvX6QP8q#m41h zN>?^s`)IJu`f7_!S5483Rsmg&L?8y$>1vbNFd`Aus zia#cqx>95;7OQ=T&WV!VW}iljgL5Jd#I!B}2W!0Gu$)4`)Px1K?RCpNayurlYQ*b+~g4pe4zBe5TO4Rz!kF+$qzPNZ!#`AqCBk_0%xEE?0)RnP1e{BY5v zfCDHl1`Mn7%1o>J_((lP5z8?#s3nnkc4OQ08242l?c1<7yo|RkFc_HPP+RF_u*SbKu?9?6 zZ)~S_B{d09xN#czaD314iq{Q3{+oyY{TI()baM6kzUuJ4-Q`oy@WEo=Smbg77Q5!A z#o)o4Vjj4fi#MCWPC#mURX#(M|(;JX~&icrfr-;_0Gj zB`dM{d+AtZD&ku81!-#Q>?VQMOnk5x0F^v2m^O#`i^^40SG~zvntYYiJ`Pv^}9T2+DhUKd;ZteZIVK+;e~yVg8C2 zGhf~3@AP^f!0!rM4b6b{;&60!d31L7@?|f$eElnqKJnb~U-^;aw>_~tKfZZ-!sMA` zO%3{OrAbj7rxqWBB$OQ;N@xYTG9q{Sxbt-)J`jSSOA_I&wP*SGTOPf9y&&+`1d+Km zp)#4!GB>{Vc-SfcW^GE8rSe9-nC0;FE=Q}qq1JOeA-br`{c0|%uRIz zSZpXuL8&_P_pn5Zm`Xy%+h!gC+0=GYUwKJ)|D zOE6@UidO9r6${s@Bv=aZG(X?bMR!)QVEM9mb#ijkIIgssf85}bk3;8N5*~#zm;YyxaGi%8Zr&0teSgA z)P~kB6$aKw&59NZ{ro;3@F)o^F~!o&@|oc9a_(c$tKoe9=luN6o8I`k@BhBf zGuM-fiDp(SF9nkWaV+7Mss^!&p&`c718t;)=g^dpHXpE?CjgVG7MZS^m92s{9mcLM z^2~{8ZezA*IW)+XCjj@|ym`DkdDna1``qojyll`)%$N!rE%rSnU`;WfP3{HKsUGV^ zzY<7jA8rz}pygF|!fdP!BEwlw_8AUm^HE;{?y?lp0Kj-?lWCdKv*P=#v4E6R(TFBD zEsSY1cXwzI)taz!pex#P%UT4z)ag?}LQR&~Gh}L^r%HDNiHp>p_wu?5YRm|u zZu(}E8|sZWI?L*br&)Xu@H74hH@<+(D|wWRgEue5rI2X^d{8q=68I(8C9-c0th?N1XzIX>fgeSs4&qHbF@J+jXCaJHJRWU zZM)I{5S6ry1~b>hEC$ig#zchLmdFT=(8g3V^fEwKtU_j9k?_?-Z~eTA+wj4zwlxou zeGn2toqT!X6T}1|Lx&g%eaC=Ryn6wI#Ii;m18Gku1YLCXLaD?o7N^pjsQ3ioHNkf8 zib#0jL@>Ovpu0|DV7YoTgZCMh3M}M+m>|SguZgpPorSe4Bbs)zaOb3*vaIUS1HfDG z$;5DFKOmtmM{RLm0V#lJk+Il6J*?qB@W!Qc9^ z-IHIqe|PhA=LdT!2Pc;WoLOfU%|y#(LX*2K+Sb^Y>n%Aa;20am)f`J(Q(zYd?Z;No zLCY*dp|rt*Af@cLec z5KaZ6y{CqyvvBzoad-%|0ZoH?TO5one<8a$o{-v(`)be~$>6tO4&;y-1eIgy*&V2C zyjZq%ytiZc5u(S)*S6;+1EkUO&@2%Id^{R@JNir=R;$xkJSU#pkl|EtBD#Vj>6rm# zDX_%6tcS@!A)FM(G7R(+1?{AQmzHn^)K)h+?G^G3pa)ksPEWq~d%o+fZ~dLmKYxd> z1FAGusd-g(qE|+S+47M-8dGSDqB(3K3Gk?`MRt}$*1U}Pclk$PnuySeI*lBFori&d z(}&H>i&#{|CYWZ?D7|oS1N8Fp(MKPB;uk;ktN-`c_;&z4Wt+Kd6%A`oloix+P8yRp zoX2kCfSm&~x#a7L+dv4Rbv4F5(%W8fnL2X%H4JJeBldK*Wm&Z`%#B%~V?A~qOIu1h z88rvf@b1Samp10+Qv)j$yGk_}NKDq$TLi)!xDchgimfyRMLq3<1zS158NepJGVC0a zfIJGp62&&m(ddlI#ItWo>o5a>v|1JO9xNb)Bi7Io6Ql`I0R}i}8t=IFQ73?*n;C{^ zo8%*6WQQQRp7ORsrH7<1ym^b~8d>}~OHpdY`K-%!n^=Jy3mP*oLu<}iJF6y+!!~hf z7JNpo=3*JJMwFkJN>eMJ==P;#VU>kwa)g1N3N`ZtH7{kuA?3Je0cR!ar_zRvYQm!N z8V_|61yf4^06+jqL_t*2I6C>*=a2cTfb+A1Z~3aDn>P-A^J!D$`F50CYa9l5&NkkF z9H#L^xPs3Sm3M~b=QC-kcPC5yYNR6NK(4kzb15J#(iRSqGhIh(nTL{={EoK`76LRT zj2ud;G^zx!@j0eC@0vnZrN!*j<|u?)VPpZCw^N>C)Fj9XXF6ytR8v9nxq7$6Gyq4{ z5WpB0t3H>uL8SbY?g)!`%dZ~uqGw>@$H(-${(`~wo1@*hYVCR2e|Re?Uv z^Y^+fbe2rj?7d6ETn22M5}VryQ!M2;byLxLu1gbj^z*8%G?3$s%5~k2ajPWnC%8Ev z{?O9gQ*n)S#ing64LsG0F{3tCBC4mVflM!0i?5o3Ij*k1GDwtyKI8+?%}9ajU0BNw zAAQh@meGI+Kd@sg4o?P6Ap@bL9CYrKpelG~VB<3u18N2fe`t%jRy-QTW@jvw;n`>_ zKL}11;*@FAB}=+$7mih$bPP05NF-rUwhE$%ELsw$a#Ih3OVy|)R#JMIhsP=0Bx3D` zF>>n|;|}{92MLD_GLiTNCA;>Xf}IbFkQiu2Gx`?ADLXFiiDJ}>CIaZb6I34n7+U$o zzPU8@4}u{9?U=7DAsybV==FY3iLeU+0skh8|CI8E*Z+<`|L4BvMK8RcRTNikWLQaS zC!w_zYveMTP~h>p(!Xwv&rohh=$%knT2{QlYQlyl5PGfkxXsW|V#h*;=@w_3@Za#;WFy9|zq;1guIrsp8jqF07)ULZZSN>JUMy<3h3# z(h6@MY-3p@JscN=YyOOdaB9+yb0R{FDlVGPoe4_=Ey*114xher{Bs|U`>R=qU@lYBwb8t#tj7Hd%J){MR^QEdR`M8 z^c;m@Gm?f`(uz4ZD<*0x-bk6*QdrEX0~(`Z7obq{k zJkd^KZk$B)G^09Zt{J(sY+E`6I59elw9bgt$WDXV>;PgUfpbM;!?`lZnHp8i_%ZIx z=Ad#P&xvMSL-EJxpgLdd+L&rhfe;{k01T;+Yg`o{0sP# zqvM?uhVz>cfXjGQlT58lpXeaXdD+`VVsGT_72#)V2pntc4xp7`pBk^GL3dD{cK4X!Fj(5<>4Y)XpxA-Y94eD(D4DCDCz%m);Ld!GicFTCB-dDYP@_nS zYTRPnbTapBIx&c#jcSgYH7AEcR2-F4Yq?N!pAY!*ztYP;{vF@?E#Lgs^Yb(MBAA}| z6M6EZ&6ZX`n(S*R-CDSoh}5tRYB8;=UV}aYwE1^Lu9CJfijASnr;QAG#S3I?kxlF| z+M?oS=0ZJk>(;y9^S;k~=GS*8r%>VtL>Nqllc*PqUb`I>*WaNaXBoFcW={MTC*VbVwYnnkJMX#D^9A4EE#E>QAPF3udbp}Z@a_|bH+_hkjGLuRpHcdi`MhiKD zrCJE|d?021)GDvE!s6;<&76F*&cLu0Vi2^%TMx2k7qN(l9Houdx)W4faOJFD+HDLs zmynPGH{N@rVj&Y6FKu|pf}yFtgSCOyGaHIF_ScAwQwG57kAfIh?F^Vvbava0bxd~) zlmJ4**nrJn`dtZoWdk6owBhRjz&Q_PTr|6})@%Wrp+k~WA#BNyJ)Ta(_$muG;<3_1 z6777oMi-;m&Mgnk*4f6jB&QjdEjx!cK%CZbvZ3g_J5Pv@{?_4teIJ+ogRg(f@k?KD z{LFI)chCLr;t~>i1;ZH^d{y+cM@k0EByPmYZL%^R&R(?d-5PH(%*Veu#%oBrhY>$h zqPcZIQVL*Tptj6yPtcWhcP&xIfb^}vqQ*gNaAIrR(7Z60%Sw|2mzZ^7n`ki?C{IBI zb%>h+5@t;BDjwyu0GWB~leWrBA*{)UDE2B~)a>+nPfSHy`mk(EfX_ol)qc(;hGM)F zGCRC0<*8|F%eXsbY)Re<8kdGL0@+)eH#G7_U4~?Xp_tgMk+kcNFMgm7SL?~F2qIqx z+F~2C*v7Otmd)rT+oDWhqYF!>9(9)Hwi7{VMplf52oi)&tGcBUbL_IE=Z4gq2zdZF zSN70H7YK2i9yvIcdH7jwuQ&LavraiqjO$2bhQiB5A6YhF5=7jEQ!#$vCjy4tfr--# z?Lf;Kp$&>XT#4Uxu8OUDU?kqdj}7>~7$2XajH5V2AU=ie?* zAjph;fCh@THDI0_*W}pUxj4EyyLkOeuO55F?!BKp{9FJ2@NFO1-Qj-7964}^Qn!StqDh4{#HhCn`*PlkX@xvX1>K+ z#@UsjC}XzwEF}pDM>_tjs1Xp)8W)zs1Ssa*I@Zk8-QX+-ZO36K1p+tIlECboYhy`l z8b~{jVv$D6MFLGEIoJxJ6c~>IZI-D{s{yEyG-`z%PDCN_IAsCJl5ec@V2CkM$f<}W zj%_H}#x+!7oe3+Fwo(Z^^Oxs(3R3|6LoMJC~^d*1sFMRJ~k3P&R=DGq5R;d|unjMX?`ireR zN78}aWW)kB2nz1;in0#=AApK9N`qkPuL+j?HqlU#)Pk;x>I=MzRS!*LDDlYHI6FIk z_~93EL-o#g{d|mAObeA!i_s8ZOuG$bfuoL5E(Q2_ly@f_$a1M)k+$+o) z!Pu!;EfO>mbOkYMamk6>BZG-6PXsm#TMH;?H4~};u9nWtDaHlWmY#FyerrIMXR*2r ziK}I=dh0_KJ9r!(3P(m1mkf4}kXxbjkfr}j0C^=w;;6-B*-C1Nhc+pexEBo(aY9;n z4s|7*&P$eh8HO~cQk1li_#Ei9A(Egmr6+6&U5}AcZ*QhfqU)PiGJ%j#Y(}-H9FcKT zA*Mp5-p-;Pl#cp1VX~62+``zH=oZnq6;@R;G{lv$lfn$LG|EO%JB>hrPtgrIH0A8i zR(}}_fw7ooU}q!X(Ji=?63Nm%48jAuO=}4@{juaMI=ti~KgUPAFWx==pTBbO?q9n2 zvRk`vc)fog^~I<4KH+7&Y5^x%G7R4KdA9)*#$c2LvjA=${jG>YCHZ7Bs!kc>Ybzzs zn(h?LuWSbbHFJGNI*G>4G>!3Ew;4c%C0A*PKyz6VnOQp1H8Dn%k`%c0p%#|73Pner zfC*R)+o3jqZAT1Wu!p;u8qG0-5zEv(h45A{GGl0nRd<^vPKYXFO#l;S`AmH?UnWij z37Ca7*{35In~^k~)5H(FF*2H2&5+sSsok1&R#u^Dd4g(5lY@h7tVY$u^ejZLT%@zM z)YCCks80&HXpO(~Q2His6db*KlnEn8m5koQU_*_NwdaZ4OvjO! zA)HN%i%9#32~ zH|9)N6Tq|yhMA+80f^pSk0U{CV`(X1>7@+`lo9%wDgH~>+|c{(fw`=L(G-yIzO+vp z8lmY(AbmmU3w+WB>u~r5gdA#ZWB?(4j*k;?@#*CT6C-K>Dr*}^wgBZosa6O<+= zml(MQ5~OR%GR?+;aGjz95aT5ZC+)Ndi}kv|!KYyC3|}3QA*88*TP;y+M%ZqVOrxkh4Q~~zm}ex0`$Cl?%2JJlN6`BU|tOI1Un$?L0C%)bVpO)J2MyRK# zI+FJGe*iWoH3V-4mmbD59#z^x1q;N$WA8{0&%CD@ioPsD8oTs9`sgF?egBi6`qXDm zPx+@{dh+Z1=GUAi5dPZ3PS?oX6N0cl6EBG4Vy^acu~)2VtW=2ayeNWM+bCa&(PAW& z%-wW#0Z_i)Rf@7tdM#%Uflr%Fdje4>S z*jnlmea^_m4V^PdTViRw;`!G_Zh082wrD*N@N{j0A)*D4(F>>Xgk5l1uHaJ>VJxzH zwri|BjN6czqSxC^Uq-N{H$jhQzZ** z@ehvAcuV2@@(o{h@c5S>|L7A(fAej-|MjucbN;{AiSuf>xx6}2^d%_U%Co=2sG6lr zPEH9Aa~@^iH4PFj66o?}rUBIQx-6SHArozectSaF&c=NGY85X@QgiN_f+e+KJ!l)m zvw^njn<5S>{TXf?=M=YgLBoG*`N~}bpP>7~4SE%Ag#>({qhZHrTLtn#W-f*^4ti6O zYC`vO--s&>6sj=NjAGK)E&HPCXpuwJ$T1=QjEGqPv)ONCge+*F_G}2%Hmr@B&?IAt z5`5zsfL6FR<4{AzoVDEVU>>OQ;}(puM~n2Tle~Smf5fh&XmFD zQwOgHPJzNKFY)n{BfxEjcP>KHIx7>GL$lUqOIKk=F|Jw7(!V+C3aqB`;Sd%~NWZ4Q z7A&B(w-(wbbMDqy=Gkii8ksM4l4_C|%_Y+MrXvH-b7;tbA6>k3P!r?IZsDt0QCBeW zt(_W;%#KEFkErsQoff{6Hgl046LB#Ffnb_f8cyK8Y7`r`5Vr_YwDN+h3);cRfFpT1 zT?Eqr(=|wT6%vA3vY0CaDf@+i9t5SX2|{pH7jeV|*Ocn2%+ejUi;~`jN;!5EJR-Ub z>=;20TR5l4GyT!-=u3BZ@A*S`+Pi>Gh~*g=V%$I=efGF)d|d z+ZK$rFb1tJ*^$UIe6V`{gUZ3tSB4rgS2aVXx3g7s?S&RAPf9&9Of3j9io1M0hAjFB zMIfB@H>$Ch#0GJ}1DV`0uqd?$W~+wWb>|XeJt$7$6)}@dJ1A7fu#L#E?pCl`v}P<_ zNsrkc$y2hLIT_h}zAO{ZWd$xi&PmMZ8fln&E>CY(Sj5Y0jHDJ@Nt&JD?L3-|6M}Xq zf`i9(murAJJX|)x;vt(VrmfAjX=fCLs6qnAjI>`w%32#9`hchR=U~iy*4K*!4$`KE6^gx$sBQrHmzZYV{fDS81aK~{ug&w{b?x$=zj28Q zT8$Ng*QR(O-#_Q|+}TuC5@SE7O=SPKMqSSlz~z)C`d; zJI{3l`)MNVkPs;x9dq&8l8{~qF1cuFyW`FbI{;|r;E0(jo6#c?b|USil{$TaHawjs zO3`iC4QBY5B-;=r1dZjQFZ0giN~b=$;nD$atIDfB@-C(z1*2iiaRac$gc{&iIkg@a zSH^tDe9>?)5IBNuB@0gDD+p>ok1#+)fbgi;xit!AhT;b295k^jfp@u6ot3p|<$c2e<*6DSC=&G^_ z5tc5EX>&0Jp0+o?JQL{C|Ll2TSMVH1ah1SiFXOR^HOQP^I;fzgFS!^rD#KMsV3u|fabk&ZNFyd%2HZ|Be;+bvM3KmJJ%myaH zwG4w}bREF&{>T9?qUOaMrO4P}=!_H%iMw?elp(qFW4=TMjWFWeM{O8rh(7T|wTcBV zQ0p=9@1_H@2kpZG1t0)(b z*Edz&M|m%Z)Uhy`eHhxU!Vbgux@Xzc(#W#VXd+(U;O8aDoAw+19|lo8abyL#x*5G{J%Aijs#wi&ChWnC#-4 zgGRAWYe;&c$-_S!LR;GdFoe^=CU!QEbT{YXL)V}hNvSqRO_>aKo&8pIf`pBGr&S^( z>v}vq17S`!3ghIy@Ix(p%;uI|g`B!0wT1Q2vt>5Ll%8{9@er>XZpa3AcCTufG7s46 z!LCG1*1Q5C(m0#u20ST8V@n(l>tlf|_`bR^#3Jv)5Kj;069(vLD z|Jm>U$~V96&K>?+?z}7_w0zAQ^C;M{D_c(-IjdNkx_!G=I}2z%=+yK$W*l}4ZZF#a zid#pJx$F(dM6q%atMrU<*qB-+4-?HMEiL)SB4>AB_UKE$?T`GyPkid%@_*e(l|AO5 zGod&&CShh51K@`W#4f{?=nA^x4lw$HjIL;to=dc&Q*_yhWgOQaLaYq&)4$m(m$5@_ zln!FfhNxKeJeB9Xh!3_{Gr_cowzJI5EGiw&9hLR;F6u>c8nVXmf@`&~$Ch;}Lbx!S z4!-`$NL1-+NlGml>$KD)jjqiSE%+sCW|Wzs=6WueWG#h{Xd+n(M0$;y23?%T*pE$x zAQT&+)w7R~JBx2^aaiD@tC_Ko%rJ=fLyJf4a(xQz+o*#6IXzwD~REAHL2t) zj#Eq9D0W=;mr$x}m;oAh<}22%T^<6|uwv|y7%_xX_EiYuDiN&a6alm58OMn@OR&hI zx~tkL?PO-*8fz@#r5&)oX1U_&hpqa30IU$8NP2m4diF**61(6#F%_CH`XyN4b zFCKBylx@ZUYd4uDnY7k*+k3U)hKa?1T}?7jQfM?GEC6STHyeghIpzTW5D^^CD2F5eW)vx=8LbouDR#~=Od;Xi%*;ZJ{j zcjxH-)0^acUbXqF-yBK9&H2}{>8-%*_F}CpIfB)cNo_^iO1-9C@-k0nl3w|AF}0_NgqOR0w(v~rUzYE`yMC( z__W^d{F<-)+OK)bo#*fPB2@L2;}lw`@FxI_SB$s;M0D>4BkC?c^Q7<p9KZLe+o| zGW9eAhWsCZbdi&oez4p!G~S?yJ#)_@wyhw;)ljBqISf*CEF9H{%>MH6SHJ4XCx7LW zpZL_yR~x*EETlfP**xmsxCyy5@eq~<+O0kqBgoFkg$hdh$cW$y8EqWnWP%gRE;4g& z02Z`aEf;Z#>Uq~zmb4X1R3Qy6434nm@)%?3$xjl&h`$<{>JzdAI1dmyV?>^fqvL6C zqg|uP97}a0tZQZs(b!LXvBKquUMvL~lJsyRs*>mkI@l-)V_uThr?3*Sub|oq3FmQ? zP^&}dp5aW|P*ToAdu8^vt$7zLObkx|f7l8gi2M*(R<_XO)E1s39Z;+>KxbWN6Wewq zbeB{z85M~o*2*t%qkQJ~@Q!30=q^cCZ0V)gL@zVlNv(R?MDWvPU7xJ|1Vy)3e zGDocjfuLp-nr%(DveK-lWSR~-zc?J7eEON)fBWFk`#*8{vKJqIgf}}MWW!(>2Uo@6R zts96n-~ouYN+>hydOj61c?SYmXO>4P4qQ|`?JGIAZ8Kv;3CAP$CK!FgD^j_#FzU6z z=Bb6V#iDA7z3iN_Av!dHh~hOjBVuuM6w`VLkl3Jj^)nMh1Z2p}Y`fPCya}ffy#_}! zV<*CsBe5KBo00M;e|izxQ_+uKCx+KiH$_8WHIymw6lP|Gkj!*^0YR@~HgJZ(!8$Oq zF~KTti%3)b#>FPJ#N;Mk{EoNpMC*U;fjD(_SfHhM=>va#|@GB#h zh7ANVr(hz>W{YfNHFi_h?oIIVmYTL_6xUp)E|?~YibO#pgs;=14Oo>=X`I#E5Lq!J z@_`>3W8a=OI0$8^WPxb2kWEUjbJ=^-z-RZp?TLWbcM$wckrP$|mdc4lxagrj;tBr+ zU-19Jt2e*$@bh2V{j;CE`iF1dz5fgMU!C0G>~RKq_VDVGWt+L}z;Q*If>qcxgN>pM zRnTO{*CREtkThU!gK8npp1n{it#)zxG=ygbzX&0aFWz|#2nFWhko>SP8VK7-ZAR z#Uh&mAm$>Z4s;M2YMPoLb8|#Iq9bo_Y6s7QaeP2PlBs~B9Y123VnauhDwe--aMgbR z%y*m@0T4(6Pv^zPBmxscscOx^SQSuL1T#{cGpzwJCf6JMwvo`Ps%9^ag0_htHf~jH zMz^?;!b#wYPs2juYSj49jyj;~Otwpqb|boWFr;ez(| zt}6{%eiNhHks-YtVM+k2Kt@PlXP7w>xadoM2d(h^pvZUbCEWtgeVYT|;d%`(`P5JJ($D&Um* zE=R(#WLSQyCa&Y7D}E~@Z3hJ-l)87KESm|DaCAA>49E8<%2AUT4T0R*&7_y9jH4Nq z$s}zd;~WOjD^_OX(WOQvgErAMR%U4id)+n_OQ|WdnciloEaS$Is;5CKjt2{aSF@F) zzPNb#ni0fG37cAfZH<}ITISl|2$j%VRb}=TtZnrovbYV@XuYO#{W7BP1GP>4Vps}w z>vxt0hcZ#IXl=fmrCQy&gqSAT61J=jla*bm*yG0=33b}}GhTzUwFS{bC}CzBScr`_ z1-uA4XzDjrL33nDRG5)CQ%)^0U!0@rH3LZ?I5cIHNNt4EjtoMaX<~N8`f``=3H`$H zJ3oB>*)LqZ@ym}Nf8^lyb9^F*VfVs9UUKjThKRz&QzUz9m0N@oVWE!O42v{&0@&5X z@o>#o308nLO+fPrpplvCGD4?;S|sf9H<5u2)R367Gix1fOFhZ*D?)x2vHEl|;p8>^ zid)lQj=A@C{sbxwqkBiC!JH7CB*-M|BOLo1lcGn7dovBpTzV;VLpHyYod|3IU|2`C zQqE5u;vD6HSr7n1cW||k^L2=#=C&ZsxeZpVyJ5ht7s<>5vyGP#rawpB76HVCF)>0% zCat?P0(a|)L?il*3)(5B4eFtFlnb52^v$TzL~pNys{)%rH;HoFVh@5n`C@39w3MNZ z9BB-AkQj}Qpbjr*J@cm~t7N|7OnKFZ=I3gRVUX_c3k?U~B4baWa`z-K@ByEm8W8r* zpI*G@c^~!{=lFT`A*`QmL+LYK_r8AL=mSVZ+dMItfAqVaP9VY3g!~g>X*k&oAz;Bt z*YEk^h5xJjcUNzI{NSM%9{ub8#jXG0Pkrphvsb6P-FylFW7Z%3g_bjLO0>-ndR7B= zXsQy2xig{=s<_mubuhFcx_is%dMg!an79g?0wl`D4n4iidD{z zfYBObkftr+JXkh8qAi7>iR6cX1eKC%W9uSi`S75iobL-oCPUHV0BTw4!$S-JH}@h* zO6|agLX4OnYEZu}0X=7(#8)L|~+h$6Q-Fj10K9<4$y4O(bqO<5R(@4?Pn! z<)xaV0q@;XV)Oq?Eg%}Aar7otH~}X7$fKvt@(s$ebgyL)9p+jV4maA~Kv#zi->gIh zV;*wW)7htF1r<&C+``jqeFoNZ1Fo7GQWxFX+*LAKrrC7E>H* z8Np>iT`8|>_DqOX^756hc*QS$=)<4jO#uHfFe|3-qypv1&>;HK#sYSY+oMLrm^`_f z(Z_1Clp(FffViFTL&-h)i_`ecBrK)jzZ}a(Q;cQq3FcgynpwdNOUF<~S$S^B4uPI~ z04=(Bi=}hSyaFsMCBsI$`1OnhrDugz!8k^`mSbH_BjXC2OHqvEBd{dbyN%6?UXEs_ zy`l612@#zT92KHCuY>g@*2l4iH#t<#j-Fi%g}rP;_-4DXtSUxs@~XqCF?xaWsNQx>Am4mH`twQRM}goi1KT2@$E zecSkseJj^Wd)*u9)el82wgVcVu5(IG1mgmxP!<-iNu<|Cz}qb+S!obd8zmU{vy$)@ z6Q9LYxe2oELyMT4y)8}B&a*pboopx0(hAUK-z~oE=ApnuM_v{Ii!q~~gORMs(isJA zgQ#VhB6LbHvH@a%2em3&?V%T64NG)f?a|_P+3Bb=1B9#a-E#|&Ns%g<%3hT>>3Qx{ zF@0MM0B*avYwtRR0qpo$?`>yHATd$-u_xAi&M1 z7V{~8#!ca&Pagv0kBJElmVXR@$QjPg`OIgCP7g0%bL-&CUvc>EUpe}_KX&vZPu%$R z+c!?Q`tAtr!_CzuCo6AN;)tUEl$4MTazm~<>t?bR)pH#mCs-R`Z9`k|L|xE~qR$$GiDT)Q zaDLxYnvGgu1CZ|uS76TsHyi{ji1vjeANeets4+Ba1a!Ba80l42Jdm^!=>?2QHC>1c zjsuJ|C#gw~p$SQ$F^xo+#YY`Wu9nb$S zU;2^`) zAPUO;9|79~wOujjvA`58^o>eqKJrGr8A;H_Lr%^Py#!j26Ssr{K07;m;DP&hr#Ij6 zj(44%UHB$|Q<}o^E9(3L;>=wqZUdYJ#WTo^ks&bO$8rsx4mgsR&hU_qfXKE~gdZ)f zMGy~t7z=5*31iD{)=if#SM^s&?G%dd>SG?20;3>Ys-psOM+{mlOkgXQAgjBe_B=q5 zz~(C!KVb^!{79E{Ko%wA&*1vOuQqMN8<)s3%LGc&epwpGOwjJ>*%M+?3oCDV|?hGTh1ANwfJe$v6j)WXtU_C_(eBD4fw9r$m-cE?|M_T+zm>$8mVUd9BZV92~!p-rr8Zd8ma4vH`a_TEG2Azqe z+7NiK{)|d4Od0XgP$E>R(gn0}?85D>(hAm_b z$cn!u25HNpBiN(JK%S0BhAL^alwvlwlMY;BGxuuYI>=U4@GC7nMP^r-jI>E8hAL}f z*$vQr+oU!sYL0G;zWFYOLy6jKB+WE5!?^%(Bh1Jp6c4dMF$ZB#Ep-7&R)eAqDLQ%x zIwfyi#YoAbS_Z2M$S9?RlQvx)WkOg?l|>4GOjSXmH<$dYT*EUJvERU*QGEzU@(5=R zM_Ati>9{>r5R)gw{sA=i0rJKSN0@PrkP041W*oVvXMTETe|6*uB@J5EH;b zrVx(6UQ$^s^O$O)QNuK+Vy^nll5QF229HVvIzIT@Gm;H|r!%ZpH-e7X%@2D;JxSC#`7)2&0ubEO8i=c*;Z@&COIAu0-N3 zmT221uL78(A#fS?jJK;=tCNnpvR`J`AtH)b264+$97T(X?*uO21+RfKJ)&DoJGw8M z30gg6#zb%mVWCYC2Yz$~F9~#IGY8xZ4rsyj6|Er_rY&?@A-iie9|9Ugv=zn<^x#7P=tv=4w@xIJQ~m( zHXRAqPnp0@A$zuL4$jWc9{=)}fAr&@`0z(Qx;s9>n2iM;t&OrNu3RSPS?rqWMi5+O8z%&;0F+o)R>Qs7g&JWB$6ycuL4IR#%066GUpwjd8)bd9fw><+$5J}tx z9*=HYiacJjS1|)xbHiV$O${6l-3sR2Q59t|8t`?P;93^qa*S5LOImqPy50v2x3QN( zJT|e^8w3Osc=*jg7)y^yTYCLwYT`}}MH39Q1EIOmG93V7Hb^)oUS?X|vt+x7%?hL| z&=Uf{?1#y$kG9pyYz15+gLEX4tQ^C_EU#vSBJY3-l&`;02Z5YD_7yrtve`t zo>gPTA-C=Uu*XjnpU+EK0^R*sB3%-iHkA~iGzN{Hw5^$#;usfEm@OIFM@Fe}bYbWk z3GZ&yuL)}PS3hfro0s=qg3r@_PJTV4)!cABl9u2NUJ&}z$2~KYAkg<0a?B8|$7+#E zy)APCImsAHYMJLQU%bkpI9vstb&}9n3Un+5O?yRJ;me&gxP6=yOl1l9R*HR5@E>O9ALVRN-8tkd%lF3lSDJ04X(Kw z&+hwq7O5NpEC=!*OK#kGacj)1n=>3UK8w%SU-U#`<~&?*PeM&u($~|28vf6+{%k-# z-ugr2l51#a-Y{)^d?Anuaj$yB8v@VYy}I=fpZPg_>h{4ud;7uP|Iatx@yQ!k$GhE0 zAX;*bAkAKVhq`mbMbTN`DNw~7n&w%f<9X!*0!dqbY|xI6p7S`(6oC!6d+ojA_1UV% zl=iG+L}WWU+UcHk>~&Yd&XUv8%;BzKTVOF!F?{^c$VFq6>>AdR92&Z1<4!LR?ph)0 z38hF4M}m9jR-ZKssiLtAX+2G0MeCZv#0d=xtuoYQU1)%I(kTvRG+tx0ojsm?Mq!#2{RIzzXD)9med7p`YtM9gSx!jDvlSLqzjr!RQjVtvsP+Nlh)(9^5v)_Lhik zIN(CNJZxd0s=XbrDBiv&aG12IFf_@bGzCCTRi~?akp{<(k&R+{wbbKQEnD=<%*fW? z0^GJ@W92|LPC^z^fjAIj@P2K>;bUv<1VbCPz`&I#1n?3D+$1lcr8F(^k=T z)J?rwb{g9sfnsH=B6C7t&8g3v!Aa!rJup|~OmG%GAr}5YkwLeam1&N6z z96yrsXmRLZD7vV)@OLxb!5L+cR_*j~I%(9irjcGMOf`TIby*JmK>c~e0pKDew3hjT4MgeqWS7U#vCRSF?v#kD+v9+ z2@^r@2%0sdJ!7ruC4bo9jj(3(+cpri`TEn>c>bn;wDl1h(>d)o?^`w3~4`#j4 z%q!(G8+(T`z?m!FWKygP)^MQA0BatcPg}=9QHWYTP8G_|j}ySLUibZ2#FwMB6a<0R zIAhry^IA|jL3fIP$;;~;y36pH08#<7!oa4)w3RzMH@f^ZODS^mMGJy8RZNCiqsCvN zb0p*->&m@5`-%}yBtko6Z~}x#yyQPu7fK*;I!b)~URb|uYXH%4TcU-*%mM?gvNzDA z&-()o98;H9{Vy-hukPDjz2Vi|eeC|j&t3kTckMp#>C-dL^Bb2(S7#+lz`2iP&ux}b z8<)yM*LmIOs9|yt7W88nC`N*b%aneqlrbV&s><0ekFl~K)4FctIa5m)x`J-@Li5p> zA+S*lB$7=U2a%ZLv&0cJwAJc_ss6NN3B8#Sur}IemaeI~-HKspbbrhOTH(o)Wb{PO zFd^uf9VR|9re4hg@1_(v>K*Y}nIcra{dK{pMIK84=B*6lTH!^&46;?=Y#Juhl+#jz z92cyN-=l;&>sC4?go>02VKJ>3n+|IWg*Ja<(gJKhv>KX9k8J7Z844DMyv)a&*gzSE zzTZh3?iPS!3;#B$ru<0J)aZLC_k`dB$}@2lm`Q&N=T$ z2vzym=P|x`x~f*u@xqWZ&6(XMRyU{K@bJ+Uc{IR)5tr-Eq75ktbvc1eMucLGC7ho| zmF?y4dF$7``Ax6qKY#f>m?c@QR;UI}LpeH4VQ#yGa5s_KG-s+?2w`U1T6p+n5?&00 zL|&LdI{w=~^h48BiQE)^vH%Q(lO9C@e4pqNUa`a;?<`A}lyR%JVRL1>W zIpmUZQZ<#CImpd<(H5-Jo4)4!02r`)G0K__1KaAkuX_s6@TeF%42+uPjeBRV*)=5C z4;9^dcl+ub1?*zy12Sem4cW$HA`%aDfqd9QPXPARpN}Md z;n{=teEjGgzjAqeaQZcG*gbmd>bYkxZ{Ou?V6D^HTaRd4mo2ZMF^n9&RG^Dp0Tb$t z2fr;=c4Ws{YNPKM^4=k#w;P?n5fyn-^QI?|&~1shNI4&**NGFde$kbHRS}6(i}78d zdp%W~g-fYv`oqSF(z4l|n&*YFG%RRY5NvK=7J?Qs(5?^$)`wj&xmS^7SXy9hd6l$#O_KzP_3dE-6?U6S}rz3#;1TRaDfP;%&|&)2EE zukmYnxJ6Qq*3aZDRy?@^ndc%z2hcYJxTlvA!>1Y9U7i=BkMv-Fao*gU1TDL7BM?Z= z3b!b7w!mUK7x*4}zTN-o=FtV;?*E#{j^6*tpaqnp+yA5L-D9;)ull@qpT6&#gYB8|jOXCfU>k=3HU&Ef64Hhc zD2Q4C5|WlSZPSQU2qjfpH4(T;TPbM>X(BZTDQf?S+N4s{B1BPwi6e-?32|zuhru>8 zHO4VEKH#xEGxm4fr(V~!?&tj`&))la?t9&9{nl@-`|upz!&Xh6tP$xzd(>?7BvK}u zyz0#O2}Lzcgs@*k%2pXJ#+KFr#D!%wb8R^b4hZ}c(3A6!Pts+L^s*hOrMpCN z`~eWlPy=*S1iL60U*y?$f+kiFq@ojc7EGcAxXrb@ONu#7E9qn)qvT%0(i-?+kbj%~ zGaP=lYdJlbXABv!wL8F|=&ZM44ir`fwa~~Yww{d-#6+@H-xP?e(S`C|;TBC}%ybE( zus1RO?jTT00QHl%U02ew^3`a+$I*?U|jb(z?SISG;@<^}>=Ms3Ku4}yI;?1EjP zIWZvP(uOh}XUthp>f|XRaulf^pB$f^-g)(FUiHI2^e12U>c?*1xl>;c6WnHL&25Wr z4HRAIXy2&QCLa>u%iT0$T6RjjKw~?>PTpwpL%`z$(+Vlr-%wsQ#J69nSTu_+RD&~ zB*HHiVNT$g;!mf7B(+ym#YwDZE;gPG2ek$s`l=<-Z3rBto}XohmT3ISYPJ;EX_eE& z`5UJS7ht6=mc37!eJLc^V8EYFm2}8LH{zW1^$^F3bHhWcoR&z+%MQcxZ)PzJr~b8) ze%xf3>vSkOrs;^S(;I)wV4-XwO&&udQlxfEsTlZSDYG`M``H|hRLZ0w9(%9F5zCa( zB$&d78U`+x%*2gB7$^-v6E-D5{i!?RxIhH7F-;B4(u^FaSZ>2Gx6*4vs`eI%`K*GI zT9(=dt8PCO8j!`2>S7}e2d=4GYy>Zp=ck7nCdct90N8634y0y4?o^z8)?$TJ+*eaI`%4Uw%!QD%# za_uMtjVf;nD>vJ+g_tPxOQAN-Sr%ch73mgXb6|s4Z)#>yqsD2YX)KN&17TNkebP4w zv^mr#T(2PX6*=|yZZrf!AIQ-nrFP&1WPj;WeF3LD?nJXxhD)8gW^8R)>PSoexOAQj zqeI4mm5EzX*z^2}pok{OM4bK7^fG;GMTb-N>;k+PuZzr~9Ij4X)ZT5zPzhxg~%Ft=@9@0s=1engo+>0P;Se6*rFT zS<=Vu?DCj*1YO--KKTg$>F

-)EU{^-a5>Cw}lyLQU8fB#-I^1|}zpUIYw&WqKZ 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�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�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 literal 0 HcmV?d00001 diff --git a/App_Resources/iOS/Assets.xcassets/AppIcon.appiconset/Contents.json b/App_Resources/iOS/Assets.xcassets/AppIcon.appiconset/Contents.json new file mode 100644 index 00000000..0a42994e --- /dev/null +++ b/App_Resources/iOS/Assets.xcassets/AppIcon.appiconset/Contents.json @@ -0,0 +1 @@ +{"images":[{"filename":"AppIcon.png","idiom":"universal","platform":"ios","size":"1024x1024"}],"info":{"author":"xcode","version":1}} diff --git a/App_Resources/iOS/Assets.xcassets/Contents.json b/App_Resources/iOS/Assets.xcassets/Contents.json new file mode 100644 index 00000000..f223229d --- /dev/null +++ b/App_Resources/iOS/Assets.xcassets/Contents.json @@ -0,0 +1 @@ +{"info":{"author":"xcode","version":1}} diff --git a/App_Resources/iOS/Info.plist b/App_Resources/iOS/Info.plist index d8615900..3740c24b 100644 --- a/App_Resources/iOS/Info.plist +++ b/App_Resources/iOS/Info.plist @@ -20,6 +20,8 @@ NSBluetoothAlwaysUsageDescription Faceclaw uses Bluetooth to connect to your glasses and ring, display your apps, and receive gestures. + NSLocalNetworkUsageDescription + Faceclaw connects to the terminal servers you configure on your local network. UILaunchScreen UISupportedInterfaceOrientations @@ -30,5 +32,7 @@ UIRequiresFullScreen + UIFileSharingEnabled + LSSupportsOpeningDocumentsInPlace diff --git a/App_Resources/iOS/build.xcconfig b/App_Resources/iOS/build.xcconfig index 05b2c3b1..bfe1e0b6 100644 --- a/App_Resources/iOS/build.xcconfig +++ b/App_Resources/iOS/build.xcconfig @@ -4,3 +4,5 @@ CODE_SIGN_STYLE = Automatic; // Select the local signing team in Xcode or pass --teamId to the iOS scripts. OTHER_LDFLAGS = $(inherited) -framework CoreBluetooth + +ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; diff --git a/App_Resources/iOS/src/FaceclawSocket.h b/App_Resources/iOS/src/FaceclawSocket.h new file mode 100644 index 00000000..84a058c5 --- /dev/null +++ b/App_Resources/iOS/src/FaceclawSocket.h @@ -0,0 +1,8 @@ +#import +/** Thread-safe event queue; each NativeScript worker drains it on its own thread. */ +@interface FaceclawSocket : NSObject +- (instancetype)initWithURL:(NSString *)url; +- (NSString *)takeEvents; +- (void)sendText:(NSString *)text; +- (void)close; +@end diff --git a/App_Resources/iOS/src/FaceclawSocket.m b/App_Resources/iOS/src/FaceclawSocket.m new file mode 100644 index 00000000..a53e6e6b --- /dev/null +++ b/App_Resources/iOS/src/FaceclawSocket.m @@ -0,0 +1,75 @@ +#import "FaceclawSocket.h" +@interface FaceclawSocket () +@property(nonatomic, strong) NSURLSession *session; +@property(nonatomic, strong) NSURLSessionWebSocketTask *task; +@property(nonatomic, strong) NSMutableArray *events; +@property(nonatomic) BOOL ended; +@property(nonatomic) NSUInteger queuedBytes; +@end +@implementation FaceclawSocket +- (instancetype)initWithURL:(NSString *)url { + if ((self = [super init])) { + _events = [NSMutableArray array]; + NSURLSessionConfiguration *config = [NSURLSessionConfiguration ephemeralSessionConfiguration]; + config.timeoutIntervalForRequest = 20; + _session = [NSURLSession sessionWithConfiguration:config delegate:self delegateQueue:nil]; + _task = [_session webSocketTaskWithURL:[NSURL URLWithString:url]]; + _task.maximumMessageSize = 8 * 1024 * 1024; + [_task resume]; + } + return self; +} +- (void)enqueue:(NSDictionary *)event { + @synchronized(self) { + if (_ended) return; + _queuedBytes += [event[@"text"] lengthOfBytesUsingEncoding:NSUTF8StringEncoding]; + if (_events.count >= 256 || _queuedBytes > 16 * 1024 * 1024) { + [_events removeAllObjects]; _queuedBytes = 0; + [_events addObject:@{@"kind": @"error", @"text": @"Terminal input queue overflow"}]; + [self close]; + } else [_events addObject:event]; + } +} +- (NSString *)takeEvents { + @synchronized(self) { + NSData *data = [NSJSONSerialization dataWithJSONObject:_events options:0 error:nil]; + [_events removeAllObjects]; _queuedBytes = 0; + return [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding] ?: @"[]"; + } +} +- (void)receiveNext { + __weak FaceclawSocket *weakSelf = self; + [_task receiveMessageWithCompletionHandler:^(NSURLSessionWebSocketMessage *message, NSError *error) { + FaceclawSocket *owner = weakSelf; if (!owner) return; + @synchronized(owner) { if (owner.ended) return; } + if (error) { [owner enqueue:@{@"kind": @"error", @"text": error.localizedDescription}]; [owner close]; return; } + if (message.type == NSURLSessionWebSocketMessageTypeString) + [owner enqueue:@{@"kind": @"text", @"text": message.string}]; + [owner receiveNext]; + }]; +} +- (void)URLSession:(NSURLSession *)session webSocketTask:(NSURLSessionWebSocketTask *)task didOpenWithProtocol:(NSString *)protocol { + [self enqueue:@{@"kind": @"open"}]; [self receiveNext]; +} +- (void)URLSession:(NSURLSession *)session webSocketTask:(NSURLSessionWebSocketTask *)task didCloseWithCode:(NSURLSessionWebSocketCloseCode)code reason:(NSData *)reason { + [self enqueue:@{@"kind": @"closed", @"code": @(code), @"text": reason ? ([[NSString alloc] initWithData:reason encoding:NSUTF8StringEncoding] ?: @"") : @""}]; + [self close]; +} +- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error { + if (error) [self enqueue:@{@"kind": @"error", @"text": error.localizedDescription}]; + [self close]; +} +- (void)sendText:(NSString *)text { + __weak FaceclawSocket *weakSelf = self; + [_task sendMessage:[[NSURLSessionWebSocketMessage alloc] initWithString:text] completionHandler:^(NSError *error) { + if (error) { [weakSelf enqueue:@{@"kind": @"error", @"text": error.localizedDescription}]; [weakSelf close]; } + }]; +} +- (void)close { + @synchronized(self) { + if (_ended) return; _ended = YES; + [_task cancelWithCloseCode:NSURLSessionWebSocketCloseCodeNormalClosure reason:nil]; + [_session invalidateAndCancel]; _session = nil; + } +} +@end diff --git a/App_Resources/iOS/src/module.modulemap b/App_Resources/iOS/src/module.modulemap index 03ec29ec..e1c2c706 100644 --- a/App_Resources/iOS/src/module.modulemap +++ b/App_Resources/iOS/src/module.modulemap @@ -1,5 +1,6 @@ module FaceclawGraphics { header "FaceclawGraphics.h" header "FaceclawBluetooth.h" + header "FaceclawSocket.h" export * } diff --git a/app/apps/developer/developer-app.ts b/app/apps/developer/developer-app.ts index ab45de75..eead6675 100644 --- a/app/apps/developer/developer-app.ts +++ b/app/apps/developer/developer-app.ts @@ -58,18 +58,24 @@ function debugTestsMenu(): MenuLayer { }, { label: "Buzzer demo", + disabled: global.isIOS, + description: global.isIOS ? "Glasses sound playback is not available on iOS yet." : undefined, onSelect: (ctx) => { ctx.stack.push(new BuzzerDemoLayer()); }, }, { label: "Accelerometer demo", + disabled: global.isIOS, + description: global.isIOS ? "Not available on iOS yet." : undefined, onSelect: (ctx) => { ctx.stack.push(new AccelerometerDemoLayer(DEVELOPER_WINDOW_ID, ctx.actions.requestRender)); }, }, { label: "Light sensor", + disabled: global.isIOS, + description: global.isIOS ? "Not available on iOS yet." : undefined, onSelect: (ctx) => { ctx.stack.push(new LightSensorDemoLayer(DEVELOPER_WINDOW_ID, ctx.actions.requestRender)); }, @@ -91,6 +97,8 @@ export function createDeveloperAppWindow(appContext: AppContext, options: InProc [ { label: "Load app from URL", + disabled: global.isIOS, + description: global.isIOS ? "Not available on iOS yet." : undefined, onSelect: (ctx) => { const layer = new LoadAppFromUrlLayer(appContext); ctx.stack.push(layer); @@ -99,6 +107,8 @@ export function createDeveloperAppWindow(appContext: AppContext, options: InProc }, { label: "Load app from QR code", + disabled: global.isIOS, + description: global.isIOS ? "Not available on iOS yet." : undefined, onSelect: (ctx) => { const layer = new LoadAppFromQrLayer(appContext); ctx.stack.push(layer); @@ -107,6 +117,8 @@ export function createDeveloperAppWindow(appContext: AppContext, options: InProc }, { label: "Show resource usage", + disabled: global.isIOS, + description: global.isIOS ? "Not available on iOS yet." : undefined, onSelect: (ctx) => { ctx.stack.push(new ResourceUsageLayer(DEVELOPER_WINDOW_ID, ctx.actions.requestRender)); }, diff --git a/app/apps/files/file-browser.ts b/app/apps/files/file-browser.ts index 819f53ef..eac9645e 100644 --- a/app/apps/files/file-browser.ts +++ b/app/apps/files/file-browser.ts @@ -585,8 +585,8 @@ export class FileBrowserLayer implements Layer { for (const path of getBookmarkedPaths()) { rows.push(this.bookmarkItem(path)); } - rows.push(this.placeItem("Internal storage", externalStorageRootPath())); - rows.push(this.placeItem("/", "/")); + rows.push(this.placeItem(global.isIOS ? "Faceclaw documents" : "Internal storage", externalStorageRootPath())); + if (!global.isIOS) rows.push(this.placeItem("/", "/")); return rows; } this.loadEntries(); diff --git a/app/apps/files/files-app.ts b/app/apps/files/files-app.ts index 01eaa065..60b53725 100644 --- a/app/apps/files/files-app.ts +++ b/app/apps/files/files-app.ts @@ -45,7 +45,7 @@ export type FilesAppOptions = InProcessAppOptions & { export function createFilesAppWindow(options: FilesAppOptions): InProcessWindow { let created: InProcessWindow | null = null; const browser = new FileBrowserLayer({ - isSupportedFile: (name) => TEXT_FILE.test(name) || isDecodableImageFile(name) || EHPK_FILE.test(name) || isFontFile(name), + isSupportedFile: (name) => TEXT_FILE.test(name) || (!global.isIOS && (isDecodableImageFile(name) || EHPK_FILE.test(name) || isFontFile(name))), // The browser handles double-click itself (up a level), so it is not // wrapped in YieldAtRootLayer; it yields explicitly from the top level. onLeave: () => shell.yieldFocusToSidebar(), @@ -170,6 +170,7 @@ function confirmEhpkPermissions(ctx: LayerContext, entry: DirectoryEntry, procee * window for viewable types, empty for everything else (metadata only). */ function fileOpenActions(entry: DirectoryEntry, options: FilesAppOptions): FileInfoAction[] { + if (global.isIOS && !TEXT_FILE.test(entry.name)) return []; if (TEXT_FILE.test(entry.name)) { return [ { diff --git a/app/apps/ios-availability.ts b/app/apps/ios-availability.ts new file mode 100644 index 00000000..0a157dbe --- /dev/null +++ b/app/apps/ios-availability.ts @@ -0,0 +1,15 @@ +/** Native services still outside the current iOS app-screen milestone. */ +const unavailable: Record = { + music: 'Media-player integration is not available on iOS yet.', + notifications: 'Phone notification integration is not available on iOS yet.', + transcribe: 'Voice capture and transcription are not available on iOS yet.', + microphones: 'Glasses microphone capture is not available on iOS yet.', + compass: 'Glasses compass streaming is not available on iOS yet.', + navigate: 'Navigation location tracking is not available on iOS yet.', + weather: 'Weather location access is not available on iOS yet.', + calendar: 'Calendar access is not available on iOS yet.', + evenhub: 'The EvenHub store and app runtime are not available on iOS yet.', +} +export function iosAppUnavailableReason(appId: string): string | null { + return unavailable[appId] ?? null +} diff --git a/app/g2/glasses-session.ts b/app/g2/glasses-session.ts index 26c9418d..697128eb 100644 --- a/app/g2/glasses-session.ts +++ b/app/g2/glasses-session.ts @@ -16,14 +16,14 @@ export interface SessionTransport { stopScan(): void } export type SessionState = { phase: 'disconnected' | 'connecting' | 'connected' | 'retrying' | 'disconnecting' | 'error'; - status: string; battery: number | null; ring: boolean; frames: number; capabilities: string; leftVersion: string; rightVersion: string } + status: string; battery: number | null; charging: boolean | null; ring: boolean; frames: number; capabilities: string; leftVersion: string; rightVersion: string } type PendingAck = { resolve: (message: protocol.ProtocolMessage) => void; reject: (error: Error) => void; timer: number | null; command: number; label: string } class AckTimeout extends Error {} /** G2 session independent of the phone OS. Images go to L, control to R, as on Android. */ export class GlassesSession { - state: SessionState = { phase: 'disconnected', status: 'Preview only', battery: null, ring: false, + state: SessionState = { phase: 'disconnected', status: 'Preview only', battery: null, charging: null, ring: false, frames: 0, capabilities: '', leftVersion: '', rightVersion: '' } private generation = 0 private ids: Record = {} @@ -68,7 +68,7 @@ export class GlassesSession { this.addresses = { ...addresses }; this.wanted = true if (!retry) this.retryCount = 0 const generation = ++this.generation - this.state = { ...this.state, capabilities: '', leftVersion: '', rightVersion: '', battery: null, ring: false } + this.state = { ...this.state, capabilities: '', leftVersion: '', rightVersion: '', battery: null, charging: null, ring: false } this.charging = false this.update('connecting', 'Finding configured devices…') try { @@ -254,7 +254,7 @@ export class GlassesSession { if (right) this.state.rightVersion = right const battery = protocol.readInteger(values, 12, -1), charging = protocol.readInteger(values, 13, -1) if (battery >= 0 && battery <= 100) this.state.battery = battery - if (charging >= 0) this.charging = charging > 0 + if (charging >= 0) this.state.charging = this.charging = charging > 0 } this.onState({ ...this.state }) } diff --git a/app/g2/ios-preview-controller.ts b/app/g2/ios-preview-controller.ts index f1da35f9..32c48277 100644 --- a/app/g2/ios-preview-controller.ts +++ b/app/g2/ios-preview-controller.ts @@ -4,23 +4,27 @@ import { GlassesSession, type SessionState } from './glasses-session' import { loadDeviceAddresses } from './device-addresses' import { deviceAddressError } from './ios-peripheral-identity' import { createLauncherWindow, LAUNCHER_SURFACE_ID } from '../apps/launcher/launcher-app' -import { CalculatorLayer } from '../apps/calculator/calculator' -import { MathCoordinator } from '../apps/calculator/math/coordinator' +import { ALL_APPS } from '../apps/all-apps' +import type { AppContext, AppDefinition, AppLaunchParams } from '../apps/app-definition' +import { WorkerAppHost } from '../ui/shell/worker-window' +import { createInProcessWindow, YieldAtRootLayer, type InProcessAppOptions, type InProcessWindow } from '../ui/shell/in-process-window' +import { getStringSettingById } from '../ui/dashboard-settings' +import { readPhoneBatteryState } from '../native/phone-battery' +import { iosAppUnavailableReason } from '../apps/ios-availability' import { SurfaceCompositor } from '../graphics/surface-compositor' import { flattenPlanes, type Plane } from '../graphics/plane' import { G2_LENS_WIDTH, G2_LENS_HEIGHT } from '../graphics/image' import { previewPixels } from '../native/ios-graphics' import { makeInputEvent, type InputEventPayload } from '../ui/gestures' import { noopLayerActions, type LayerActions } from '../ui/layers' -import { MenuLayer } from '../ui/menu' -import { createInProcessWindow } from '../ui/shell/in-process-window' +import { TextViewerLayer } from '../apps/files/text-viewer' import { shell, rawInputEventToInputEvent, type ShellWindow } from '../ui/shell/shell' import { appViewportRect, SIDEBAR_WIDTH, sidebarStripVisible } from '../ui/shell/geometry' import { DISPLAY_MODE_VALUES, displayModeLabel, displayModeSetting, onAnySettingChanged, - previewColorSetting, timeFormatSetting, verticalPositionSetting } from '../ui/dashboard-settings' + previewColorSetting } from '../ui/dashboard-settings' import type { PhoneGesture } from '../phone-ui/phone-gestures' -/** Local display host: shared shell/windows, no device-service initialization. */ +/** iOS host for the shared app registry, shell, compositor and BLE session. */ export class IosPreviewController { private readonly compositor = new SurfaceCompositor(G2_LENS_WIDTH, G2_LENS_HEIGHT) private renderTimer: ReturnType | null = null @@ -31,6 +35,9 @@ export class IosPreviewController { private inputQueue: Promise = Promise.resolve() private lastLayout = '' private prompting = false + private readonly appHosts = new Map() + private readonly inProcessApps = new Map() + private readonly batteryObservers: any[] = [] private session: GlassesSession | null = null private resumeConnection = false private suspendedDisconnect: Promise = Promise.resolve() @@ -39,6 +46,9 @@ export class IosPreviewController { private readonly actions: LayerActions = { ...noopLayerActions, requestRender: () => this.requestShellRender(), + disconnect: () => this.disconnect(), + startVoiceCapture: () => this.typeIntoApp(), + startContinuousVoiceCapture: () => this.onError("Voice capture is not available on iOS yet."), startTextSettingEdit: setting => this.editSetting(setting), startTextSettingsEdit: async (settings, _title, finished) => { for (const setting of settings) await this.editSetting(setting) @@ -60,10 +70,9 @@ export class IosPreviewController { }) const launcher = createLauncherWindow({ actions: this.actions, - apps: () => [ - { appId: 'calculator', label: 'Calculator', icon: 'calculator' }, - { appId: 'display', label: 'Display', icon: 'settings' }, - ], + apps: () => ALL_APPS.filter(app => app.showInLauncher !== false).map(app => ({ + appId: app.appId, label: app.title, icon: app.icon, renderIcon: app.renderIcon, + })), launchApp: id => this.launchApp(id), uninstallApp: () => {}, submitFrame: planes => this.submit(LAUNCHER_SURFACE_ID, planes), @@ -73,17 +82,25 @@ export class IosPreviewController { shell.registerWindow(launcher) shell.wake('window') shell.focusWindow(launcher.windowId) + for (const app of ALL_APPS) if (app.appId !== 'launcher' && !iosAppUnavailableReason(app.appId)) app.boot?.(this.buildAppContext(app)) } resume(): void { if (this.active) return this.active = true + UIDevice.currentDevice.batteryMonitoringEnabled = true + for (const name of [UIDeviceBatteryLevelDidChangeNotification, UIDeviceBatteryStateDidChangeNotification]) { + this.batteryObservers.push(NSNotificationCenter.defaultCenter.addObserverForNameObjectQueueUsingBlock(name, null, NSOperationQueue.mainQueue, () => this.requestShellRender())) + } + const phone = readPhoneBatteryState() + this.logBluetooth(`Phone battery ${phone.battery ?? "unknown"}% charging=${phone.charging}`) this.offSettings = onAnySettingChanged(() => { this.relayout() shell.foregroundWindow()?.requestRender() this.requestShellRender() }) this.clockTimer = setInterval(() => this.requestShellRender(), 60_000) + for (const window of shell.getWindows()) window.setScreenOn?.(shell.isScreenOn()) this.relayout() shell.foregroundWindow()?.requestRender() this.requestShellRender() @@ -97,7 +114,10 @@ export class IosPreviewController { this.resumeConnection = !!this.session && ['connected', 'connecting', 'retrying'].includes(this.session.state.phase) if (this.session) this.suspendedDisconnect = this.session.stop() this.active = false + for (const window of shell.getWindows()) window.setScreenOn?.(false) this.offSettings?.(); this.offSettings = null + for (const observer of this.batteryObservers.splice(0)) NSNotificationCenter.defaultCenter.removeObserver(observer) + UIDevice.currentDevice.batteryMonitoringEnabled = false if (this.clockTimer) clearInterval(this.clockTimer) if (this.renderTimer) clearTimeout(this.renderTimer) this.clockTimer = this.renderTimer = null @@ -109,7 +129,7 @@ export class IosPreviewController { this.compositor.setSurfaceVisible(window.surfaceId, shell.foregroundWindow()?.windowId === window.windowId) } private relayout(): void { - const layout = `${displayModeSetting.get()}:${verticalPositionSetting.get()}` + const layout = shell.getWindows().map(window => JSON.stringify(appViewportRect(window.heightMode, window.appId))).join(";") if (layout === this.lastLayout) return this.lastLayout = layout for (const window of shell.getWindows()) { @@ -183,39 +203,72 @@ export class IosPreviewController { await shell.receiveInput(makeInputEvent({ type: 'click', source: 'watch' })) this.requestShellRender() } - launchApp(id: string): void { - const existing = shell.getWindows().find(window => window.appId === id) - if (existing) { shell.focusWindow(existing.windowId); existing.requestRender(); this.requestShellRender(); return } - const surfaceId = `window:${id}` - let render = () => {} - const actions = { ...this.actions, requestRender: () => render() } - const layer = id === 'calculator' - ? new CalculatorLayer(new MathCoordinator(), actions, () => this.typeIntoApp()) - : new MenuLayer('Display', [ - { label: 'Change screen size', onSelect: () => this.cycleDisplayMode() }, - { label: 'Toggle green / grayscale preview', onSelect: () => { previewColorSetting.set(previewColorSetting.get() === 'green' ? 'white' : 'green') } }, - { label: 'Toggle 12 / 24 hour clock', onSelect: () => { timeFormatSetting.set(timeFormatSetting.get() === '24h' ? '12h' : '24h') } }, - ], { x: 8, y: 8, width: 320, minHeight: 160, opaque: true }) - const app = createInProcessWindow({ - appId: id, windowId: id, title: id === 'calculator' ? 'Calculator' : 'Display', - iconLetter: id === 'calculator' ? '=' : 'D', icon: id === 'calculator' ? 'calculator' : 'settings', - closeable: true, actions, baseLayer: layer, - receiveTextInput: id === 'calculator' ? text => { app.stack.receiveTextInput(text); app.requestRender() } : undefined, - submitFrame: planes => this.submit(surfaceId, planes), - setSurfaceVisible: visible => { - if (layer instanceof CalculatorLayer) layer.setForeground(visible) - this.compositor.setSurfaceVisible(surfaceId, visible); this.scheduleFrame() - }, + async launchApp(id: string, params?: AppLaunchParams): Promise { + const app = ALL_APPS.find(app => app.appId === id) + if (!app) return + try { + const reason = iosAppUnavailableReason(id) + if (reason) { + await this.launchInProcessApp(id, `window:${id}`, options => createInProcessWindow({ + ...options, appId: id, windowId: id, title: app.title, icon: app.icon, + iconLetter: app.title[0], closeable: true, + baseLayer: new YieldAtRootLayer(new TextViewerLayer(reason, app.title)), + })) + } else await app.launch(this.buildAppContext(app), params) + console.log(`[ios-preview] Launched ${id}`) + } catch (error) { this.fail(error) } + } + private buildAppContext(app: AppDefinition): AppContext { + return { + appId: app.appId, apps: ALL_APPS, actions: this.actions, + launchApp: (id, params) => this.launchApp(id, params), uninstallApp: async () => {}, + launchInProcessApp: (id, surface, create) => this.launchInProcessApp(id, surface, create), + ensureWorkerHost: create => this.ensureWorkerHost(app.appId, create), + submitWindowFrame: (id, planes) => this.submit(id, planes), + setWindowSurfaceVisible: (id, visible) => { this.compositor.setSurfaceVisible(id, visible); this.scheduleFrame() }, + requestShellRender: () => this.requestShellRender(), appendLog: message => console.log(`[ios-app] ${message}`), + setTextEditorHost: () => {}, + } + } + private async launchInProcessApp(windowId: string, surfaceId: string, + create: (options: InProcessAppOptions) => InProcessWindow): Promise { + const existing = this.inProcessApps.get(windowId) + if (existing) { shell.focusWindow(windowId); existing.requestRender(); this.requestShellRender(); return } + const app = create({ + actions: this.actions, submitFrame: planes => this.submit(surfaceId, planes), + setSurfaceVisible: visible => { this.compositor.setSurfaceVisible(surfaceId, visible); this.scheduleFrame() }, removeSurface: () => { this.compositor.removeSurface(surfaceId); this.scheduleFrame() }, - onClosed: () => { if (layer instanceof CalculatorLayer) layer.onRemoved() }, + reconfigureSurface: () => { const window = shell.getWindows().find(w => w.windowId === windowId); if (window) this.configureWindow(window); this.requestShellRender() }, + onClosed: () => { this.inProcessApps.delete(windowId) }, }) - render = app.requestRender - if (layer instanceof CalculatorLayer) layer.requestRender = render + this.inProcessApps.set(windowId, app) this.configureWindow(app.window) - shell.registerWindow(app.window) - shell.focusWindow(app.window.windowId) + shell.registerWindow(app.window); shell.focusWindow(windowId) app.requestRender(); this.requestShellRender() } + private ensureWorkerHost(appId: string, create: () => Worker): WorkerAppHost { + const existing = this.appHosts.get(appId) + if (existing) return existing + const host = new WorkerAppHost({ + appId, worker: create(), + configureSurface: async (id, visible, heightMode) => { + this.compositor.configureSurface(id, { ...appViewportRect(heightMode, appId), zOrder: 0, transparency: 'opaque' }) + this.compositor.setSurfaceVisible(id, visible) + }, + setSurfaceVisible: (id, visible) => { this.compositor.setSurfaceVisible(id, visible); this.scheduleFrame() }, + removeSurface: id => { this.compositor.removeSurface(id); this.scheduleFrame() }, + submitPixels: (id, pixels, width, height) => { + this.compositor.submitSurfaceFrame(id, pixels, { x: 0, y: 0, width, height }); this.scheduleFrame() + }, + requestShellRender: () => this.requestShellRender(), + openSettings: section => { void this.launchApp('settings', { section }) }, + startTextSettingEdit: id => { const setting = getStringSettingById(id); if (setting) void this.editSetting(setting) }, + endTextSettingEdit: () => {}, + startTextInput: () => { void this.typeIntoApp() }, + }) + this.appHosts.set(appId, host) + return host + } cycleDisplayMode(): void { const values = DISPLAY_MODE_VALUES displayModeSetting.set(values[(values.indexOf(displayModeSetting.get()) + 1) % values.length]) @@ -233,8 +286,9 @@ export class IosPreviewController { if (!this.session) { const { deflate } = require('pako') as { deflate: (data: Uint8Array) => Uint8Array } this.session = new GlassesSession(iosBluetooth(), deflate, state => { + shell.setBatteryLevels({ headset: state.battery, headsetCharging: state.charging }) this.onConnectionState(state) - if (state.phase === 'connected') this.requestShellRender() + this.requestShellRender() }, input => { this.inputQueue = this.inputQueue.then(async () => { if (!this.active) return @@ -262,7 +316,7 @@ export class IosPreviewController { this.prompting = true try { const result = await Dialogs.prompt({ title: 'Type into ' + shell.foregroundWindow()?.title, - message: 'Enter an expression or follow-up.', okButtonText: 'Send', cancelButtonText: 'Cancel' }) + message: 'Enter text to send to this app.', okButtonText: 'Send', cancelButtonText: 'Cancel' }) if (result.result) shell.sendTextToForegroundWindow(result.text) } catch (error) { this.fail(error) } finally { this.prompting = false } diff --git a/app/native/active-display.ios.ts b/app/native/active-display.ios.ts new file mode 100644 index 00000000..c3a3d946 --- /dev/null +++ b/app/native/active-display.ios.ts @@ -0,0 +1,8 @@ +/** Workers send baked grayscale frames to the main-thread iOS compositor. */ +const display = { + submitSurfaceFrame(buffer: ArrayBuffer, surfaceId: string, _x: number, _y: number, width: number, height: number): void { + const data = NSData.dataWithBytesLength(interop.handleof(buffer), buffer.byteLength) + global.postMessage({ type: 'surface-frame', surfaceId, width, height, pixels: data.base64EncodedStringWithOptions(0 as NSDataBase64EncodingOptions) }) + }, +} +export function getActiveDisplay(): typeof display { return display } diff --git a/app/native/alarms.ts b/app/native/alarms.ts index ca44672c..77181bfb 100644 --- a/app/native/alarms.ts +++ b/app/native/alarms.ts @@ -124,6 +124,7 @@ export function drainPhoneAlarmJournal(): PhoneAlarmAction[] { /** Conditions under which the phone may fail to ring, most serious first. */ export function checkPhoneAlarmReliability(): AlarmReliabilityIssue[] { + if (global.isIOS) return [{ code: "ios-foreground-only", message: "Keep Faceclaw open: background timer and alarm alerts are not available on iOS yet.", fixable: false }]; const context = getContext(); if (!context) return []; let parsed: any; diff --git a/app/native/file-access.ios.ts b/app/native/file-access.ios.ts new file mode 100644 index 00000000..214cf2ec --- /dev/null +++ b/app/native/file-access.ios.ts @@ -0,0 +1,51 @@ +import { knownFolders, path as paths } from '@nativescript/core' +export type DirectoryEntry = { name: string; path: string; isDirectory: boolean; sizeBytes: number; modifiedMs: number } +const fm = NSFileManager.defaultManager +// The iOS Files app exposes Documents; access is limited to Faceclaw's container. +export function hasAllFilesAccess(): boolean { return true } +export function requestAllFilesAccess(): void {} +export function externalStorageRootPath(): string { return knownFolders.documents().path } +export function appFilesDirPath(): string { return knownFolders.documents().path } +export function statPath(path: string): DirectoryEntry | null { + try { + const attrs = fm.attributesOfItemAtPathError(path) + if (!attrs) return null + const modified: any = attrs.objectForKey(NSFileModificationDate) + return { name: path.slice(path.lastIndexOf('/') + 1), path, isDirectory: attrs.objectForKey(NSFileType) === NSFileTypeDirectory, + sizeBytes: Number(attrs.objectForKey(NSFileSize)) || 0, + modifiedMs: modified instanceof Date ? modified.getTime() : Number(modified?.timeIntervalSince1970 ?? 0) * 1000 } + } catch { return null } +} +export function listDirectory(path: string): DirectoryEntry[] | null { + try { + const names = fm.contentsOfDirectoryAtPathError(path), entries: DirectoryEntry[] = [] + for (let i = 0; i < names.count; i++) { const entry = statPath(paths.join(path, names.objectAtIndex(i))); if (entry) entries.push(entry) } + return entries.sort((a, b) => Number(b.isDirectory) - Number(a.isDirectory) || a.name.localeCompare(b.name)) + } catch { return null } +} +export function readBinaryFile(path: string): Uint8Array | null { + const data = NSData.dataWithContentsOfFile(path) + return data ? new Uint8Array(interop.bufferFromData(data)).slice() : null +} +export function writeBinaryFile(path: string, bytes: Uint8Array): boolean { + try { + fm.createDirectoryAtPathWithIntermediateDirectoriesAttributesError(path.slice(0, path.lastIndexOf('/')), true, null) + const copy = bytes.slice(), data = NSData.dataWithBytesLength(interop.handleof(copy.buffer), copy.byteLength) + return data.writeToFileAtomically(path, true) + } catch { return false } +} +export function readTextFile(path: string): string | null { + const entry = statPath(path) + if (!entry || entry.isDirectory || entry.sizeBytes > 2_000_000) return null + const data = NSData.dataWithContentsOfFile(path) + const text = data ? NSString.alloc().initWithDataEncoding(data, NSUTF8StringEncoding) : null + return text == null ? null : String(text).slice(0, 500_000) +} +export function writeTextToDownloads(filename: string, text: string): string | null { + const path = paths.join(knownFolders.documents().path, 'Downloads', filename.slice(filename.lastIndexOf('/') + 1)) + const data = NSString.stringWithString(text).dataUsingEncoding(NSUTF8StringEncoding) + return writeBinaryFile(path, new Uint8Array(interop.bufferFromData(data))) ? path : null +} +export function deletePathRecursively(path: string): void { + try { if (fm.fileExistsAtPath(path)) fm.removeItemAtPathError(path) } catch (error) { console.warn(`Delete failed: ${error}`) } +} diff --git a/app/native/g2mirror-client.ts b/app/native/g2mirror-client.ts index 038dfe03..ae58dc40 100644 --- a/app/native/g2mirror-client.ts +++ b/app/native/g2mirror-client.ts @@ -1,3 +1,4 @@ +import { openSocket } from "./socket"; import { toUint8Array } from "../util/array-util"; declare const com: any; @@ -181,7 +182,7 @@ export class G2MirrorClient { const generation = ++this.connectionGeneration; const url = `${this.options.secure ? "wss" : "ws"}://${this.options.host}:${this.options.port}`; this.setState("connecting", `Connecting to ${this.options.host}:${this.options.port}...`); - this.listenerProxy = new com.faceclaw.app.FaceclawWebSocketListener({ + this.listenerProxy = { onOpen: () => { if (this.stopped || generation !== this.connectionGeneration) return; this.setState("connecting", "Authenticating..."); @@ -206,9 +207,9 @@ export class G2MirrorClient { if (this.stopped || generation !== this.connectionGeneration) return; this.handleConnectionLost(`Connection failed: ${shortenError(String(message))}`); }, - }); + }; try { - this.ws = new com.faceclaw.app.FaceclawWebSocket(url, this.listenerProxy, null, null); + this.ws = openSocket(url, this.listenerProxy); } catch (error) { this.ws = null; this.handleConnectionLost(`Connection failed: ${shortenError(String((error as Error)?.message ?? error))}`); @@ -571,11 +572,19 @@ export class G2MirrorClient { function decodeBase64(data: string): Uint8Array { if (!data) return new Uint8Array(0); + if (global.isIOS) { + const decoded = NSData.alloc().initWithBase64EncodedStringOptions(data, 0 as NSDataBase64DecodingOptions); + return decoded ? new Uint8Array(interop.bufferFromData(decoded)).slice() : new Uint8Array(); + } return toUint8Array(android.util.Base64.decode(data, android.util.Base64.DEFAULT)); } function decodeBase64Utf8(data: string): string { if (!data) return ""; + if (global.isIOS) { + const decoded = NSData.alloc().initWithBase64EncodedStringOptions(data, 0 as NSDataBase64DecodingOptions); + return decoded ? String(NSString.alloc().initWithDataEncoding(decoded, NSUTF8StringEncoding) ?? "") : ""; + } const bytes = android.util.Base64.decode(data, android.util.Base64.DEFAULT); return String(new java.lang.String(bytes, "UTF-8")); } @@ -587,6 +596,7 @@ function stripAnsi(text: string): string { } function encodeBase64Utf8(text: string): string { + if (global.isIOS) return NSString.stringWithString(text).dataUsingEncoding(NSUTF8StringEncoding).base64EncodedStringWithOptions(0 as NSDataBase64EncodingOptions); const bytes = new java.lang.String(text).getBytes("UTF-8"); return String(android.util.Base64.encodeToString(bytes, android.util.Base64.NO_WRAP)); } diff --git a/app/native/phone-battery.ts b/app/native/phone-battery.ts index d93be911..b758fcd3 100644 --- a/app/native/phone-battery.ts +++ b/app/native/phone-battery.ts @@ -8,6 +8,15 @@ export type PhoneBatteryState = { }; export function readPhoneBatteryState(): PhoneBatteryState { + if (global.isIOS) { + const device = UIDevice.currentDevice + const level = device.batteryLevel + const state = device.batteryState + return { + battery: level >= 0 ? Math.round(level * 100) : null, + charging: state === UIDeviceBatteryState.Unknown ? null : state === UIDeviceBatteryState.Charging || state === UIDeviceBatteryState.Full, + } + } if (!global.isAndroid) { return { battery: null, charging: null }; } diff --git a/app/native/settings-store.ios.ts b/app/native/settings-store.ios.ts index 2d4c3dd5..7ffd322f 100644 --- a/app/native/settings-store.ios.ts +++ b/app/native/settings-store.ios.ts @@ -1,28 +1,56 @@ import { ApplicationSettings } from '@nativescript/core' -// Main-isolate settings for the initial iOS port. Worker synchronization will -// be added when worker-hosted apps are enabled on iOS. +// NSUserDefaults is shared by all NativeScript isolates. Each isolate polls +// just its observed keys so callbacks always execute on the owning JS thread. +const CHANGE_TOKEN = 'ios.settings.changeToken' +let lastToken = ApplicationSettings.getString(CHANGE_TOKEN, '') +const observed = new Map string; value: string }>() +function observe(key: string, read: () => string): void { + if (!observed.has(key)) observed.set(key, { read, value: read() }) +} +function markChanged(key: string): void { + // A unique token lets other isolates check one key while idle. It does not + // depend on a read/increment/write counter that concurrent writers could lose. + ApplicationSettings.setString(CHANGE_TOKEN, `${Date.now()}:${Math.random()}`) + const item = observed.get(key) + if (item) item.value = item.read() + changed(key) +} +let pollTimer: ReturnType | null = null const listeners = new Set<(key: string) => void>() function changed(key: string): void { setTimeout(() => { for (const listener of [...listeners]) listener(key) }, 0) } export function getStringSetting(key: string, fallback: string): string { - return ApplicationSettings.getString(key, fallback) + const value = ApplicationSettings.getString(key, fallback) + observe(key, () => JSON.stringify(ApplicationSettings.getString(key, fallback))) + return value } export function setStringSetting(key: string, value: string): void { if (getStringSetting(key, '') === value && ApplicationSettings.hasKey(key)) return ApplicationSettings.setString(key, value) - changed(key) + markChanged(key) } export function getBooleanSetting(key: string, fallback: boolean): boolean { - return ApplicationSettings.getBoolean(key, fallback) + const value = ApplicationSettings.getBoolean(key, fallback) + observe(key, () => JSON.stringify(ApplicationSettings.getBoolean(key, fallback))) + return value } export function setBooleanSetting(key: string, value: boolean): void { if (getBooleanSetting(key, false) === value && ApplicationSettings.hasKey(key)) return ApplicationSettings.setBoolean(key, value) - changed(key) + markChanged(key) } export function onSettingsStoreChanged(listener: (key: string) => void): () => void { listeners.add(listener) - return () => { listeners.delete(listener) } + if (!pollTimer) pollTimer = setInterval(() => { + const token = ApplicationSettings.getString(CHANGE_TOKEN, '') + if (token === lastToken) return + lastToken = token + for (const [key, item] of observed) { + const value = item.read() + if (value !== item.value) { item.value = value; changed(key) } + } + }, 250) + return () => { listeners.delete(listener); if (!listeners.size && pollTimer) { clearInterval(pollTimer); pollTimer = null } } } diff --git a/app/native/socket.ios.ts b/app/native/socket.ios.ts new file mode 100644 index 00000000..e0bb5897 --- /dev/null +++ b/app/native/socket.ios.ts @@ -0,0 +1,16 @@ +export type SocketListener = { onOpen(): void; onTextMessage(message: string): void; onClosed(code: number, reason: string): void; onFailure(message: string): void } +declare const FaceclawSocket: any +export function openSocket(url: string, listener: SocketListener): { sendText(text: string): void; close(code: number, reason: string): void } { + const native = FaceclawSocket.alloc().initWithURL(url) + let ended = false + const close = () => { if (ended) return; ended = true; clearInterval(timer); native.close() } + const timer = setInterval(() => { + for (const event of JSON.parse(native.takeEvents())) { + if (ended) break + if (event.kind === 'open') listener.onOpen() + else if (event.kind === 'text') listener.onTextMessage(event.text) + else { close(); if (event.kind === 'closed') listener.onClosed(event.code, event.text); else listener.onFailure(event.text) } + } + }, 25) + return { sendText: text => { if (!ended) native.sendText(text) }, close } +} diff --git a/app/native/socket.ts b/app/native/socket.ts new file mode 100644 index 00000000..7b952acc --- /dev/null +++ b/app/native/socket.ts @@ -0,0 +1,9 @@ +declare const com: any +export type SocketListener = { onOpen(): void; onTextMessage(message: string): void; onClosed(code: number, reason: string): void; onFailure(message: string): void } +export function openSocket(url: string, listener: SocketListener): { sendText(text: string): void; close(code: number, reason: string): void } { + const proxy = new com.faceclaw.app.FaceclawWebSocketListener(listener) + const native = new com.faceclaw.app.FaceclawWebSocket(url, proxy, null, null) + const connection = { listenerProxy: proxy, sendText: (text: string) => native.sendText(text), + close: (code: number, reason: string) => native.close(code, reason) } + return connection +} diff --git a/app/phone-ui/main-page.ios.ts b/app/phone-ui/main-page.ios.ts index ba014754..518e7eb5 100644 --- a/app/phone-ui/main-page.ios.ts +++ b/app/phone-ui/main-page.ios.ts @@ -1,5 +1,6 @@ import { Application, Button, Color, Dialogs, GridLayout, Image, Label, Page, StackLayout, type TouchGestureEventData } from '@nativescript/core' import { createConfigureDevicesPage } from './config-page.ios' +import { ALL_APPS } from '../apps/all-apps' import { IosPreviewController } from '../g2/ios-preview-controller' import { PhoneGestureRecognizer } from './phone-gestures' import { onAnySettingChanged, previewColorSetting } from '../ui/dashboard-settings' @@ -103,6 +104,12 @@ export function createMainPage(): Page { GridLayout.setColumn(view, index); tabs.addChild(view); tabButtons.push(view) } const sizeButton = button(controller.displayModeLabel, () => controller.cycleDisplayMode()) + settings.addChild(button('Open app', () => { void (async () => { + const apps = ALL_APPS.filter(app => app.showInLauncher !== false).slice().sort((a, b) => a.title.localeCompare(b.title)) + const title = await Dialogs.action({ title: 'Open app', cancelButtonText: 'Cancel', actions: apps.map(app => app.title) }) + const app = apps.find(app => app.title === title) + if (app) { await controller.launchApp(app.appId); selectTab('watch') } + })() })) settings.addChild(sizeButton) settings.addChild(button('Toggle green / grayscale', () => previewColorSetting.set(previewColorSetting.get() === 'green' ? 'white' : 'green'))) const help = new Label() diff --git a/app/ui/dashboard/settings-menus.ts b/app/ui/dashboard/settings-menus.ts index b609de6e..2e6c0989 100644 --- a/app/ui/dashboard/settings-menus.ts +++ b/app/ui/dashboard/settings-menus.ts @@ -83,7 +83,7 @@ export function createSettingsPanelLayer(): SettingsPanelLayer { } function settingsSections(): SettingsSection[] { - return [ + const sections: SettingsSection[] = [ { label: "Display", items: [ @@ -232,6 +232,18 @@ function settingsSections(): SettingsSection[] { ], }, ]; + if (!global.isIOS) return sections; + const deferred = new Set(["Voice", "Assistant", "Navigate", "Watch", "Developer"]); + return sections.map(section => { + if (deferred.has(section.label)) return { label: section.label, items: [{ + label: "Not available on iOS yet", disabled: true, onSelect: () => {}, + description: `${section.label} integration has not been ported to iOS.`, + }] }; + if (section.label === "Display") return { ...section, items: section.items.filter(item => + ![brightnessSetting.label, screenTimeoutSetting.label, lockScreenEnabledSetting.label].includes(item.label)) }; + if (section.label === "Phone display") return { ...section, items: section.items.filter(item => item.label !== mirrorTouchSetting.label) }; + return section; + }); } const LOCAL_MODEL_GB = `${(LOCAL_MODEL.sizeBytes / 1e9).toFixed(1)}GB`; diff --git a/app/ui/font-picker.ts b/app/ui/font-picker.ts index 70b113ca..66d05364 100644 --- a/app/ui/font-picker.ts +++ b/app/ui/font-picker.ts @@ -278,6 +278,7 @@ export class FontPickerLayer implements Layer { /** Installed fonts grouped into families (styles sorted by weight). */ function collectFamilies(monospaceOnly: boolean): FontFamily[] { + if (global.isIOS) return []; // Native TTF rendering has not been ported. const byLabel = new Map(); for (const font of listInstalledFonts()) { if (monospaceOnly && !font.monospace) continue; @@ -326,7 +327,7 @@ export function terminalFontPickerMenuItem(): MenuItem { function fontPickerMenuItem(options: FontPickerOptions & { rowLabel: string; description: string }): MenuItem { return { label: options.rowLabel, - description: options.description, + description: global.isIOS ? "Choose a bundled bitmap font. Native TTF rendering is not available on iOS yet." : options.description, onSelect: (ctx) => { ctx.stack.push(new FontPickerLayer(options)); }, @@ -338,7 +339,7 @@ function fontPickerMenuItem(options: FontPickerOptions & { rowLabel: string; des y, width, options.rowLabel, - fontSelectionLabel(options.get()), + global.isIOS && options.get().kind === "ttf" ? "Terminus (iOS)" : fontSelectionLabel(options.get()), ); }, }; diff --git a/app/ui/shell/worker-window.ts b/app/ui/shell/worker-window.ts index c268054c..cc6f92c0 100644 --- a/app/ui/shell/worker-window.ts +++ b/app/ui/shell/worker-window.ts @@ -10,7 +10,7 @@ import { shell, type ShellWindow } from "./shell"; * Messages between the shell (main thread) and an app worker. One worker * hosts one app, which may have several windows; messages are routed by * windowId. Everything crossing this boundary is small JSON; pixels go - * worker→Java directly. + * worker→Java directly on Android; iOS posts baked frames to the main host. */ export type WorkerAppMessage = | { type: "open-window"; windowId: string; surfaceId: string; title: string; viewport: { width: number; height: number } } @@ -25,6 +25,7 @@ export type WorkerAppMessage = | { type: "tool-call"; callId: string; windowId: string; name: string; args: unknown }; export type WorkerAppReply = + | { type: "surface-frame"; surfaceId: string; width: number; height: number; pixels: string } | { /** * The worker's bundle has evaluated and its onmessage handler is @@ -163,6 +164,8 @@ export type WorkerAppHostOptions = { setSurfaceVisible: (surfaceId: string, visible: boolean) => void; removeSurface: (surfaceId: string) => void; requestShellRender: () => void; + submitPixels?: (surfaceId: string, pixels: Uint8Array, width: number, height: number) => void; + startTextInput?: () => void; /** Open or focus the Settings app, optionally selecting a section. */ openSettings: (section?: string) => void; /** Open the phone app's text editor on a string setting (by id). */ @@ -175,8 +178,8 @@ export type WorkerAppHostOptions = { * Owns the Worker for one app and adapts its windows to the shell's window * interface: forwards input and lifecycle over postMessage, relays worker * requests (yield-focus, new windows, attention flags) back to the shell, - * and manages compositor surfaces for the app's windows. The worker submits - * frames straight to the Java compositor, so no pixels cross this boundary. + * and manages compositor surfaces for the app's windows. Android workers send + * frames straight to Java; iOS workers use surface-frame replies. */ /** A tool-call awaiting its worker reply; also its own leak-safety timeout. */ type PendingToolCall = { @@ -212,6 +215,14 @@ export class WorkerAppHost { const message = event.data as WorkerAppReply | undefined; if (!message) return; switch (message.type) { + case "surface-frame": { + if (!global.isIOS || !this.options.submitPixels || !this.openWindows.has(message.surfaceId.replace(/^window:/, ""))) break; + const { width, height } = message; + if (!Number.isInteger(width) || !Number.isInteger(height) || width < 1 || height < 1 || width > 640 || height > 480) break; + const data = NSData.alloc().initWithBase64EncodedStringOptions(message.pixels, 0 as NSDataBase64DecodingOptions); + if (data?.length === width * height) this.options.submitPixels(message.surfaceId, new Uint8Array(interop.bufferFromData(data)), width, height); + break; + } case "worker-ready": this.workerReady = true; for (const queued of this.queuedMessages.splice(0)) { @@ -256,7 +267,8 @@ export class WorkerAppHost { // Menus only open on the focused window, but re-check foreground: // the reply crosses a thread boundary and focus may have moved. if (shell.foregroundWindow()?.windowId === message.windowId) { - shell.startVoiceInput(); + if (this.options.startTextInput) this.options.startTextInput(); + else shell.startVoiceInput(); } break; case "close-window-request": diff --git a/tests/app-layout.test.cjs b/tests/app-layout.test.cjs index 38450863..4dfecb33 100644 --- a/tests/app-layout.test.cjs +++ b/tests/app-layout.test.cjs @@ -148,6 +148,9 @@ test('resizing a terminal reconnects with the new grid and ignores callbacks fro }, } } }, }; + const socketContext = { exports: {}, com: context.com }; + vm.runInNewContext(js(read('app/native/socket.ts')), socketContext); + context.require = name => name === './socket' ? socketContext.exports : {}; vm.runInNewContext(js(read('app/native/g2mirror-client.ts')), context); const client = new context.exports.G2MirrorClient({ host: 'localhost', port: 1234, cols: 72, rows: 28 }); client.start(); diff --git a/tests/ios-app-host.test.cjs b/tests/ios-app-host.test.cjs new file mode 100644 index 00000000..ea75fff1 --- /dev/null +++ b/tests/ios-app-host.test.cjs @@ -0,0 +1,56 @@ +const test = require('node:test'); +const assert = require('node:assert/strict'); +const fs = require('node:fs'); +const vm = require('node:vm'); +const ts = require('typescript'); +const path = require('node:path'); +function load(file, context) { + const sandbox = { exports: {}, ...context }; + const source = fs.readFileSync(path.join(__dirname, '..', file), 'utf8'); + vm.runInNewContext(ts.transpileModule(source, { compilerOptions: { module: ts.ModuleKind.CommonJS, target: ts.ScriptTarget.ES2020 } }).outputText, sandbox); + return sandbox.exports; +} +test('iOS phone battery distinguishes unknown, charging, full and unplugged readings', () => { + const device = { batteryLevel: -1, batteryState: 0 }; + const api = load('app/native/phone-battery.ts', { require: () => ({}), global: { isIOS: true }, + UIDevice: { currentDevice: device }, UIDeviceBatteryState: { Unknown: 0, Unplugged: 1, Charging: 2, Full: 3 } }); + assert.deepEqual({ ...api.readPhoneBatteryState() }, { battery: null, charging: null }); + device.batteryLevel = 0.726; device.batteryState = 2; + assert.deepEqual({ ...api.readPhoneBatteryState() }, { battery: 73, charging: true }); + device.batteryLevel = 1; device.batteryState = 3; + assert.deepEqual({ ...api.readPhoneBatteryState() }, { battery: 100, charging: true }); + device.batteryLevel = 0; device.batteryState = 1; + assert.deepEqual({ ...api.readPhoneBatteryState() }, { battery: 0, charging: false }); +}); +test('settings changes propagate between iOS worker isolates once, including after a getter read', () => { + const store = new Map(), ticks = new Set(), tasks = []; + const ApplicationSettings = { getString: (k, d) => store.get(k) ?? d, getBoolean: (k, d) => store.get(k) ?? d, + setString: (k, v) => store.set(k, v), setBoolean: (k, v) => store.set(k, v), hasKey: k => store.has(k) }; + const context = { require: () => ({ ApplicationSettings }), setTimeout: fn => tasks.push(fn), + setInterval: fn => { ticks.add(fn); return fn; }, clearInterval: fn => ticks.delete(fn) }; + const main = load('app/native/settings-store.ios.ts', context), worker = load('app/native/settings-store.ios.ts', context); + const seenMain = [], seenWorker = []; + const offMain = main.onSettingsStoreChanged(k => seenMain.push(k)); + const offWorker = worker.onSettingsStoreChanged(k => seenWorker.push(k)); + main.getStringSetting('terminal.connections', '[]'); worker.getStringSetting('terminal.connections', '[]'); + main.setStringSetting('terminal.connections', '["test"]'); + assert.equal(worker.getStringSetting('terminal.connections', '[]'), '["test"]'); + const flush = () => { for (const tick of ticks) tick(); while (tasks.length) tasks.shift()(); }; + flush(); flush(); + assert.deepEqual(seenMain, ['terminal.connections']); assert.deepEqual(seenWorker, ['terminal.connections']); + main.getBooleanSetting('sound', true); worker.getBooleanSetting('sound', true); + worker.setBooleanSetting('sound', false); flush(); + assert.equal(main.getBooleanSetting('sound', true), false); + assert.deepEqual(seenMain, ['terminal.connections', 'sound']); + offWorker(); offMain(); assert.equal(ticks.size, 0); +}); +test('iOS worker frames preserve baked grayscale bytes through the message boundary', () => { + const messages = []; + const api = load('app/native/active-display.ios.ts', { global: { postMessage: m => messages.push(m) }, + interop: { handleof: b => b }, NSData: { dataWithBytesLength: (b, n) => ({ base64EncodedStringWithOptions: () => Buffer.from(b, 0, n).toString('base64') }) } }); + const pixels = new Uint8Array([0, 1, 15, 127, 254, 255]); + api.getActiveDisplay().submitSurfaceFrame(pixels.buffer, 'window:blocks:main', 0, 0, 3, 2); + assert.equal(messages[0].surfaceId, 'window:blocks:main'); + assert.equal(messages[0].width, 3); assert.equal(messages[0].height, 2); + assert.deepEqual(Buffer.from(messages[0].pixels, 'base64'), Buffer.from(pixels)); +}); diff --git a/tests/ios-ble.test.cjs b/tests/ios-ble.test.cjs index 22645eb0..295f563a 100644 --- a/tests/ios-ble.test.cjs +++ b/tests/ios-ble.test.cjs @@ -133,6 +133,7 @@ test('session authenticates both arms, checks firmware and sends acknowledged di const h = harness(t); await h.session.start({ ...addresses, ring: 'AA:BB:CC:DD:EE:03' }); assert.equal(h.session.state.phase, 'connected'); assert.equal(h.session.state.ring, true); assert.equal(h.session.state.battery, 90); + assert.equal(h.session.state.charging, false); assert.deepEqual(h.transport.sent.filter(s => s.message.sid === 128).map(s => s.id).sort(), ['L', 'R']); h.session.setFrame(new Uint8Array(640 * 480)); await until(() => h.session.state.frames === 1); const image = h.transport.sent.find(s => s.message.sid === 224 && s.message.command === 3); diff --git a/tests/ios-socket-native.cjs b/tests/ios-socket-native.cjs new file mode 100644 index 00000000..6bfd8d93 --- /dev/null +++ b/tests/ios-socket-native.cjs @@ -0,0 +1,15 @@ +// macOS integration test for the same NSURLSession transport compiled into iOS. +const { Server: WebSocketServer } = require('ws'); +const { spawn, execFileSync } = require('node:child_process'); +const { mkdtempSync, rmSync } = require('node:fs'); +const { tmpdir } = require('node:os'); +const { join, resolve } = require('node:path'); +const root = resolve(__dirname, '..'), dir = mkdtempSync(join(tmpdir(), 'faceclaw-socket-')); +execFileSync('xcrun', ['clang', '-fobjc-arc', '-framework', 'Foundation', '-I', 'App_Resources/iOS/src', + 'tests/native/ios-socket-test.m', 'App_Resources/iOS/src/FaceclawSocket.m', '-o', join(dir, 'socket-test')], { cwd: root, stdio: 'inherit' }); +const server = new WebSocketServer({ host: '127.0.0.1', port: 0 }); +server.on('connection', socket => socket.on('message', data => socket.send(data.toString(), () => socket.close(1000, 'done')))); +server.on('listening', () => { + const child = spawn(join(dir, 'socket-test'), [`ws://127.0.0.1:${server.address().port}`], { stdio: 'inherit' }); + child.on('exit', code => { server.close(); rmSync(dir, { recursive: true, force: true }); process.exitCode = code ?? 1; }); +}); diff --git a/tests/native/ios-socket-test.m b/tests/native/ios-socket-test.m new file mode 100644 index 00000000..19db162b --- /dev/null +++ b/tests/native/ios-socket-test.m @@ -0,0 +1,23 @@ +#import +#import "FaceclawSocket.h" +int main(int argc, const char **argv) { + @autoreleasepool { + FaceclawSocket *socket = [[FaceclawSocket alloc] initWithURL:[NSString stringWithUTF8String:argv[1]]]; + BOOL opened = NO, echoed = NO, closed = NO; + NSDate *deadline = [NSDate dateWithTimeIntervalSinceNow:10]; + while (!closed && deadline.timeIntervalSinceNow > 0) { + NSArray *events = [NSJSONSerialization JSONObjectWithData:[[socket takeEvents] dataUsingEncoding:NSUTF8StringEncoding] options:0 error:nil]; + for (NSDictionary *event in events) { + NSString *kind = event[@"kind"]; + if ([kind isEqual:@"open"]) { opened = YES; [socket sendText:@"Faceclaw echo: π 🔋"]; } + if ([kind isEqual:@"text"]) echoed = [event[@"text"] isEqual:@"Faceclaw echo: π 🔋"]; + if ([kind isEqual:@"closed"] || [kind isEqual:@"error"]) closed = YES; + } + [[NSRunLoop currentRunLoop] runUntilDate:[NSDate dateWithTimeIntervalSinceNow:0.01]]; + } + [socket close]; + if (!opened || !echoed || !closed) { NSLog(@"FAIL open=%d echo=%d close=%d", opened, echoed, closed); return 1; } + puts("PASS: native WebSocket opens, echoes UTF-8 and reports close"); + } + return 0; +} From ae14edcb590121e8e3841817f69487779f360f87 Mon Sep 17 00:00:00 2001 From: James Babcock Date: Mon, 7 Sep 2026 10:46:09 -0700 Subject: [PATCH 06/99] iOS version stays connected to the glasses while in the background --- App_Resources/iOS/Info.plist | 4 ++ app/g2/glasses-session.ts | 20 ++++-- app/g2/ios-preview-controller.ts | 101 ++++++++++++++++++++----------- tests/ios-app-host.test.cjs | 65 ++++++++++++++++++++ tests/ios-ble.test.cjs | 24 ++++++++ 5 files changed, 174 insertions(+), 40 deletions(-) diff --git a/App_Resources/iOS/Info.plist b/App_Resources/iOS/Info.plist index 3740c24b..11d23bb4 100644 --- a/App_Resources/iOS/Info.plist +++ b/App_Resources/iOS/Info.plist @@ -20,6 +20,10 @@ NSBluetoothAlwaysUsageDescription Faceclaw uses Bluetooth to connect to your glasses and ring, display your apps, and receive gestures. + UIBackgroundModes + + bluetooth-central + NSLocalNetworkUsageDescription Faceclaw connects to the terminal servers you configure on your local network. UILaunchScreen diff --git a/app/g2/glasses-session.ts b/app/g2/glasses-session.ts index 697128eb..ec89e2da 100644 --- a/app/g2/glasses-session.ts +++ b/app/g2/glasses-session.ts @@ -55,7 +55,8 @@ export class GlassesSession { private readonly deflate: (data: Uint8Array) => Uint8Array, private readonly onState: (state: SessionState) => void, private readonly onInput: (input: protocol.GlassesInput) => void, - private readonly log: (message: string) => void = () => {}) { + private readonly log: (message: string) => void = () => {}, + private readonly onActivity: () => void = () => {}) { this.off = transport.onEvent(event => this.receive(event)) } private update(phase: SessionState['phase'], status: string): void { @@ -210,15 +211,15 @@ export class GlassesSession { return } if (event.kind !== 'notification' || !event.data) return + const ring = event.identifier === this.ids.ring + if (ring ? !protocol.RING_NOTIFY.includes(event.characteristic ?? '') : event.characteristic !== protocol.G2_NOTIFY) return try { const data = hexToBytes(event.data) - if (event.identifier === this.ids.ring) { - if (!protocol.RING_NOTIFY.includes(event.characteristic ?? '')) return + if (ring) { const input = protocol.decodeRingInput(data) if (input) { this.log(`Direct R1 gesture ${input.eventType}`); this.onInput(input) } return } - if (event.characteristic !== protocol.G2_NOTIFY) return for (const message of this.receiver.receive(event.identifier!, data)) { this.log(`RX ${event.identifier === this.ids.left ? 'L' : 'R'} sid=${message.sid.toString(16)} flag=${message.flag.toString(16)} cmd=${message.command} magic=${message.magic}`) if (![1, 6].includes(message.flag)) { @@ -243,6 +244,11 @@ export class GlassesSession { } } } catch (error) { this.log(`Ignored malformed BLE notification: ${this.message(error)}`) } + finally { + // CoreBluetooth can wake a suspended iOS process for a notification. + // Service wall-clock deadlines now, without waiting for a suspended timer. + if (this.state.phase === 'connected') { this.onActivity(); this.wake() } + } } private applySettings(message: protocol.ProtocolMessage): void { const values = protocol.readBytes(message.payload, 4) @@ -262,6 +268,10 @@ export class GlassesSession { if (this.state.phase !== 'connected') return this.latest = protocol.packGray4(gray, 640, 480); this.schedule(0) } + wake(): void { + if (this.timer !== null) { clearTimeout(this.timer); this.timer = null } + void this.pump() + } private schedule(delay = 1000): void { if (delay === 0 && this.timer !== null) { clearTimeout(this.timer); this.timer = null } if (this.timer !== null || this.pumping || this.state.phase !== 'connected') return @@ -273,7 +283,9 @@ export class GlassesSession { try { const now = Date.now() if (now - this.lastHeartbeat >= 4000) { + const gap = now - this.lastHeartbeat await this.request('right', protocol.SID.hub, protocol.heartbeat, 'Heartbeat', 1500); this.lastHeartbeat = Date.now() + this.log(`Heartbeat acknowledged (gap ${gap}ms)`) } if (now - this.lastLease >= 45_000) { await this.lease(true); this.lastLease = Date.now() } if (now - this.lastSettings >= (this.charging ? 30_000 : 300_000)) { diff --git a/app/g2/ios-preview-controller.ts b/app/g2/ios-preview-controller.ts index 32c48277..6bab4f2f 100644 --- a/app/g2/ios-preview-controller.ts +++ b/app/g2/ios-preview-controller.ts @@ -31,6 +31,8 @@ export class IosPreviewController { private clockTimer: ReturnType | null = null private offSettings: (() => void) | null = null private active = false + private runtimeRunning = false + private clockMinute = -1 private shellDirty = true private inputQueue: Promise = Promise.resolve() private lastLayout = '' @@ -39,8 +41,6 @@ export class IosPreviewController { private readonly inProcessApps = new Map() private readonly batteryObservers: any[] = [] private session: GlassesSession | null = null - private resumeConnection = false - private suspendedDisconnect: Promise = Promise.resolve() private logLines: string[] = [] private logTimer: ReturnType | null = null private readonly actions: LayerActions = { @@ -88,6 +88,40 @@ export class IosPreviewController { resume(): void { if (this.active) return this.active = true + this.syncRuntime() + this.logBluetooth('Phone foreground') + if (this.session) this.onConnectionState({ ...this.session.state }) + this.session?.wake() + this.relayout() + shell.foregroundWindow()?.requestRender() + this.requestShellRender() + } + pause(): void { + if (!this.active) return + this.active = false + // The phone preview is hidden; the glasses still own their screen and input. + this.syncRuntime() + this.logBluetooth(`Phone background; glasses ${this.session?.state.phase ?? 'disconnected'}`) + this.flushBluetoothLog() + this.session?.wake() + } + private get runtimeNeeded(): boolean { + return this.active || !!this.session && ['connected', 'connecting', 'retrying', 'disconnecting'].includes(this.session.state.phase) + } + private syncRuntime(): void { + const running = this.runtimeNeeded + if (running === this.runtimeRunning) return + this.runtimeRunning = running + for (const window of shell.getWindows()) window.setScreenOn?.(running && shell.isScreenOn()) + if (!running) { + this.offSettings?.(); this.offSettings = null + for (const observer of this.batteryObservers.splice(0)) NSNotificationCenter.defaultCenter.removeObserver(observer) + UIDevice.currentDevice.batteryMonitoringEnabled = false + if (this.clockTimer !== null) clearInterval(this.clockTimer) + if (this.renderTimer !== null) clearTimeout(this.renderTimer) + this.clockTimer = this.renderTimer = null + return + } UIDevice.currentDevice.batteryMonitoringEnabled = true for (const name of [UIDeviceBatteryLevelDidChangeNotification, UIDeviceBatteryStateDidChangeNotification]) { this.batteryObservers.push(NSNotificationCenter.defaultCenter.addObserverForNameObjectQueueUsingBlock(name, null, NSOperationQueue.mainQueue, () => this.requestShellRender())) @@ -99,28 +133,11 @@ export class IosPreviewController { shell.foregroundWindow()?.requestRender() this.requestShellRender() }) - this.clockTimer = setInterval(() => this.requestShellRender(), 60_000) - for (const window of shell.getWindows()) window.setScreenOn?.(shell.isScreenOn()) - this.relayout() - shell.foregroundWindow()?.requestRender() - this.requestShellRender() - console.log('[ios-preview] Main screen active') - if (this.resumeConnection) { - this.resumeConnection = false - void this.suspendedDisconnect.then(() => { if (this.active) void this.connect() }) - } + this.clockTimer = setInterval(() => this.refreshClock(), 60_000) } - pause(): void { - this.resumeConnection = !!this.session && ['connected', 'connecting', 'retrying'].includes(this.session.state.phase) - if (this.session) this.suspendedDisconnect = this.session.stop() - this.active = false - for (const window of shell.getWindows()) window.setScreenOn?.(false) - this.offSettings?.(); this.offSettings = null - for (const observer of this.batteryObservers.splice(0)) NSNotificationCenter.defaultCenter.removeObserver(observer) - UIDevice.currentDevice.batteryMonitoringEnabled = false - if (this.clockTimer) clearInterval(this.clockTimer) - if (this.renderTimer) clearTimeout(this.renderTimer) - this.clockTimer = this.renderTimer = null + private refreshClock(): void { + const minute = Math.floor(Date.now() / 60_000) + if (minute !== this.clockMinute) { this.clockMinute = minute; this.requestShellRender() } } private configureWindow(window: ShellWindow): void { this.compositor.configureSurface(window.surfaceId, { @@ -144,10 +161,11 @@ export class IosPreviewController { } private requestShellRender(): void { this.shellDirty = true; this.scheduleFrame() } private scheduleFrame(): void { - if (!this.active || this.renderTimer !== null) return - // Coalesce window/chrome updates into one preview, capped at 30 fps. + if (!this.runtimeNeeded || this.renderTimer !== null) return + // Coalesce window/chrome updates into one glasses frame, capped at 30 fps. this.renderTimer = setTimeout(() => { this.renderTimer = null + if (!this.runtimeNeeded) return try { if (this.shellDirty) { this.shellDirty = false @@ -157,15 +175,18 @@ export class IosPreviewController { } const pixels = this.compositor.composite() this.session?.setFrame(pixels) - const image = previewPixels(pixels, 640, 480, previewColorSetting.get() === 'green') - this.onFrame(image, `${shell.foregroundWindow()?.title ?? 'Apps'} · ${shell.getFocus() === 'sidebar' ? 'App switcher' : 'App'}`) + if (this.active) { + const image = previewPixels(pixels, 640, 480, previewColorSetting.get() === 'green') + this.onFrame(image, `${shell.foregroundWindow()?.title ?? 'Apps'} · ${shell.getFocus() === 'sidebar' ? 'App switcher' : 'App'}`) + } } catch (error) { this.fail(error) } }, 33) } private fail(error: unknown): void { const message = error instanceof Error ? error.stack ?? error.message : String(error) console.error(`[ios-preview] ${message}`) - this.onError(error instanceof Error ? error.message : String(error)) + this.logBluetooth(`App error: ${message}`) + if (this.active) this.onError(error instanceof Error ? error.message : String(error)) } gesture(gesture: PhoneGesture, origin: 'watch' | 'ring' | 'mirror', nx = 0, ny = 0): void { this.inputQueue = this.inputQueue.then(async () => { @@ -287,31 +308,38 @@ export class IosPreviewController { const { deflate } = require('pako') as { deflate: (data: Uint8Array) => Uint8Array } this.session = new GlassesSession(iosBluetooth(), deflate, state => { shell.setBatteryLevels({ headset: state.battery, headsetCharging: state.charging }) - this.onConnectionState(state) + this.syncRuntime() + if (this.active) this.onConnectionState(state) this.requestShellRender() }, input => { this.inputQueue = this.inputQueue.then(async () => { - if (!this.active) return + if (this.session?.state.phase !== 'connected') return await shell.receiveInput(rawInputEventToInputEvent(input)); this.requestShellRender() this.logBluetooth(`Input ${input.eventType} source ${input.eventSource}`) }).catch(error => this.fail(error)) - }, message => this.logBluetooth(message)) + }, message => this.logBluetooth(message), () => this.refreshClock()) } await this.session.start(addresses) } - async disconnect(): Promise { this.resumeConnection = false; await this.session?.stop() } + async disconnect(): Promise { await this.session?.stop() } private logBluetooth(message: string): void { - const line = `${new Date().toISOString()} ${message}` + const line = `${new Date().toISOString()} [${this.active ? 'foreground' : 'background'}${UIApplication.sharedApplication.protectedDataAvailable ? '' : ',protected-data-unavailable'}] ${message}` console.log(`[ios-ble] ${line}`); this.logLines.push(line) - if (this.logLines.length > 200) this.logLines.shift() + if (this.logLines.length > 1000) this.logLines.shift() if (this.logTimer !== null) return this.logTimer = setTimeout(() => { this.logTimer = null - try { File.fromPath(path.join(knownFolders.documents().path, 'bluetooth.log')).writeTextSync(this.logLines.join('\n')) } - catch (error) { console.warn(`Bluetooth log: ${error}`) } + this.flushBluetoothLog() }, 500) } + private flushBluetoothLog(): void { + if (this.logTimer !== null) clearTimeout(this.logTimer) + this.logTimer = null + try { File.fromPath(path.join(knownFolders.documents().path, 'bluetooth.log')).writeTextSync(this.logLines.join('\n')) } + catch (error) { console.warn(`Bluetooth log: ${error}`) } + } async typeIntoApp(): Promise { + if (!this.active) { this.logBluetooth('Text input requires opening Faceclaw on the phone'); return } if (this.prompting || !shell.foregroundWindow()?.receiveTextInput) return this.prompting = true try { @@ -322,6 +350,7 @@ export class IosPreviewController { finally { this.prompting = false } } private async editSetting(setting: { editorTitle: string; get(): string; set(value: string): void }): Promise { + if (!this.active) { this.logBluetooth('Editing text settings requires opening Faceclaw on the phone'); return } const result = await Dialogs.prompt({ title: setting.editorTitle, defaultText: setting.get(), okButtonText: 'Save', cancelButtonText: 'Cancel' }) if (result.result) setting.set(result.text) } diff --git a/tests/ios-app-host.test.cjs b/tests/ios-app-host.test.cjs index ea75fff1..f937330d 100644 --- a/tests/ios-app-host.test.cjs +++ b/tests/ios-app-host.test.cjs @@ -54,3 +54,68 @@ test('iOS worker frames preserve baked grayscale bytes through the message bound assert.equal(messages[0].width, 3); assert.equal(messages[0].height, 2); assert.deepEqual(Buffer.from(messages[0].pixels, 'base64'), Buffer.from(pixels)); }); + +test('background glasses input still composites frames; phone resume preserves the session; explicit stop stays stopped', async () => { + const tasks = new Map(), screenStates = [], inputs = [], frames = [], previews = [], states = []; + let nextTask = 0, starts = 0, stops = 0, session; + const window = { windowId: 'launcher', surfaceId: 'launcher', appId: 'launcher', title: 'Apps', + setScreenOn: on => screenStates.push(on), requestRender() {} }; + const shell = { configure() {}, registerWindow() {}, wake() {}, focusWindow() {}, + getWindows: () => [window], foregroundWindow: () => window, isScreenOn: () => true, + setBatteryLevels() {}, paintSurface() {}, underlayDim: () => 0, getFocus: () => 'app', + receiveInput: async input => { inputs.push(input); } }; + class Session { + state = { phase: 'disconnected' }; + constructor(_transport, _deflate, onState, onInput) { session = this; this.onState = onState; this.onInput = onInput; } + async start() { starts++; this.state = { phase: 'connected' }; this.onState(this.state); } + async stop() { stops++; this.state = { phase: 'disconnected' }; this.onState(this.state); } + setFrame(pixels) { if (this.state.phase === 'connected') frames.push(pixels); } + wake() {} + } + const settings = { onAnySettingChanged: () => () => {}, previewColorSetting: { get: () => 'white' } }; + const modules = { + '@nativescript/core': { File: { fromPath: () => ({ writeTextSync() {} }) }, knownFolders: { documents: () => ({ path: '/tmp' }) }, path }, + '../native/ios-bluetooth': { iosBluetooth: () => ({}) }, './glasses-session': { GlassesSession: Session }, + './device-addresses': { loadDeviceAddresses: () => ({}) }, './ios-peripheral-identity': { deviceAddressError: () => null }, + '../apps/launcher/launcher-app': { createLauncherWindow: () => window, LAUNCHER_SURFACE_ID: 'launcher' }, + '../apps/all-apps': { ALL_APPS: [] }, '../ui/dashboard-settings': settings, + '../native/phone-battery': { readPhoneBatteryState: () => ({ battery: 80, charging: false }) }, + '../graphics/surface-compositor': { SurfaceCompositor: class { + configureSurface() {} setSurfaceVisible() {} submitSurfaceFrame() {} setUnderlayDim() {} + composite() { return new Uint8Array([1, 2]); } + } }, + '../graphics/plane': { flattenPlanes: () => ({ pixels: new Uint8Array([1, 2]), width: 2, height: 1 }) }, + '../native/ios-graphics': { previewPixels: pixels => pixels }, + '../ui/shell/shell': { shell, rawInputEventToInputEvent: input => input }, + '../ui/shell/geometry': { appViewportRect: () => ({ x: 0, y: 0, width: 640, height: 480 }) }, + pako: { deflate: x => x }, + }; + const api = load('app/g2/ios-preview-controller.ts', { + require: id => modules[id] ?? {}, console: { log() {}, warn() {}, error() {} }, + setTimeout: fn => { tasks.set(++nextTask, fn); return nextTask; }, clearTimeout: id => tasks.delete(id), + setInterval: () => ++nextTask, clearInterval() {}, + UIDevice: { currentDevice: {} }, UIApplication: { sharedApplication: { protectedDataAvailable: true } }, + UIDeviceBatteryLevelDidChangeNotification: 'level', UIDeviceBatteryStateDidChangeNotification: 'state', + NSNotificationCenter: { defaultCenter: { addObserverForNameObjectQueueUsingBlock() {}, removeObserver() {} } }, + NSOperationQueue: { mainQueue: {} }, + }); + const flush = () => { for (const [id, fn] of [...tasks]) { if (tasks.delete(id)) fn(); } }; + const controller = new api.IosPreviewController(image => previews.push(image), assert.fail, state => states.push(state)); + controller.resume(); await controller.connect(); flush(); + const previewCount = previews.length, stateCount = states.length; + controller.pause(); controller.pause(); // NativeScript also unloads its root page on background entry. + assert.equal(stops, 0); assert.ok(screenStates.every(Boolean)); + session.onInput({ eventType: 3, eventSource: 1 }); + await controller.inputQueue; flush(); + assert.equal(inputs.length, 1); assert.ok(frames.length >= 2); + assert.equal(previews.length, previewCount); assert.equal(states.length, stateCount); + controller.resume(); flush(); + assert.equal(starts, 1); assert.ok(previews.length > previewCount); + controller.pause(); await controller.disconnect(); flush(); + assert.equal(stops, 1); assert.equal(screenStates.at(-1), false); + const frameCount = frames.length; + session.onInput({ eventType: 3, eventSource: 1 }); await controller.inputQueue; flush(); + assert.equal(inputs.length, 1); assert.equal(frames.length, frameCount); + controller.resume(); flush(); + assert.equal(starts, 1); assert.equal(controller.connectionState.phase, 'disconnected'); +}); diff --git a/tests/ios-ble.test.cjs b/tests/ios-ble.test.cjs index 295f563a..eae347c4 100644 --- a/tests/ios-ble.test.cjs +++ b/tests/ios-ble.test.cjs @@ -198,3 +198,27 @@ test('ring disconnect retries independently and stop cancels further retries', a await h.session.stop(); assert.equal(h.session.ringRetryTimer, null); }); + +test('a BLE wake services overdue heartbeat and lease without waiting for a suspended poll timer', async t => { + const h = harness(t); await h.session.start(addresses); + clearTimeout(h.session.timer); h.session.timer = null; + h.session.lastHeartbeat = Date.now() - 12_000; + h.session.lastLease = Date.now() - 60_000; + const before = h.transport.sent.length; + const data = hex(p.concat(...p.frameMessage(p.integer(1, 6), p.SID.auth, 1, 22))); + h.transport.emit({ kind: 'notification', identifier: 'L', characteristic: p.G2_NOTIFY, data }); + // pump starts in the notification callback, before any timers can fire. + assert.equal(h.session.pumping, true); + await until(() => !h.session.pumping); + const sent = h.transport.sent.slice(before); + assert.equal(sent.filter(s => s.message.sid === p.SID.hub && s.message.command === 12).length, 1); + assert.deepEqual(sent.filter(s => s.message.sid === p.SID.settings).map(s => s.id).sort(), ['L', 'R']); + assert.equal(h.session.state.phase, 'connected'); + assert.deepEqual(h.transport.closed, []); + await h.session.stop(); + const count = h.transport.sent.length; + h.session.wake(); + h.transport.emit({ kind: 'notification', identifier: 'L', characteristic: p.G2_NOTIFY, data }); + assert.equal(h.transport.sent.length, count); + assert.equal(h.session.state.phase, 'disconnected'); +}); From b07ae0b47969910d3d8d9681c7e7fdbfa92520cc Mon Sep 17 00:00:00 2001 From: James Babcock Date: Mon, 7 Sep 2026 16:57:49 -0700 Subject: [PATCH 07/99] iOS TTF support; voice input --- App_Resources/iOS/Info.plist | 2 + App_Resources/iOS/build.xcconfig | 4 +- App_Resources/iOS/src/FaceclawFontRenderer.h | 15 + App_Resources/iOS/src/FaceclawFontRenderer.m | 189 + App_Resources/iOS/src/FaceclawLc3Decoder.h | 11 + App_Resources/iOS/src/FaceclawLc3Decoder.m | 42 + App_Resources/iOS/src/FaceclawSpeech.h | 12 + App_Resources/iOS/src/FaceclawSpeech.m | 136 + App_Resources/iOS/src/lc3/LICENSE | 202 + App_Resources/iOS/src/lc3/README.faceclaw.md | 7 + App_Resources/iOS/src/lc3/attdet.c | 92 + App_Resources/iOS/src/lc3/attdet.h | 37 + App_Resources/iOS/src/lc3/bits.c | 375 ++ App_Resources/iOS/src/lc3/bits.h | 309 + App_Resources/iOS/src/lc3/bwdet.c | 154 + App_Resources/iOS/src/lc3/bwdet.h | 62 + App_Resources/iOS/src/lc3/common.h | 142 + App_Resources/iOS/src/lc3/energy.c | 54 + App_Resources/iOS/src/lc3/energy.h | 36 + App_Resources/iOS/src/lc3/fastmath.h | 219 + App_Resources/iOS/src/lc3/lc3.c | 766 +++ App_Resources/iOS/src/lc3/lc3.h | 423 ++ App_Resources/iOS/src/lc3/lc3_cpp.h | 310 + App_Resources/iOS/src/lc3/lc3_private.h | 187 + App_Resources/iOS/src/lc3/ltpf.c | 964 +++ App_Resources/iOS/src/lc3/ltpf.h | 104 + App_Resources/iOS/src/lc3/ltpf_arm.h | 506 ++ App_Resources/iOS/src/lc3/ltpf_neon.h | 281 + App_Resources/iOS/src/lc3/mdct.c | 475 ++ App_Resources/iOS/src/lc3/mdct.h | 52 + App_Resources/iOS/src/lc3/mdct_neon.h | 296 + App_Resources/iOS/src/lc3/plc.c | 62 + App_Resources/iOS/src/lc3/plc.h | 50 + App_Resources/iOS/src/lc3/sns.c | 929 +++ App_Resources/iOS/src/lc3/sns.h | 98 + App_Resources/iOS/src/lc3/spec.c | 959 +++ App_Resources/iOS/src/lc3/spec.h | 105 + App_Resources/iOS/src/lc3/tables.c | 5762 ++++++++++++++++++ App_Resources/iOS/src/lc3/tables.h | 161 + App_Resources/iOS/src/lc3/tns.c | 510 ++ App_Resources/iOS/src/lc3/tns.h | 93 + App_Resources/iOS/src/module.modulemap | 3 + app/apps/files/files-app.ts | 4 +- app/apps/files/font-previewer.ts | 2 +- app/g2/ble-protocol.ts | 1 + app/g2/glasses-session.ts | 41 + app/g2/ios-preview-controller.ts | 24 +- app/graphics/installed-fonts.ts | 22 +- app/graphics/ttf-font.ts | 21 +- app/native/font-files.ts | 29 +- app/native/font-renderer.ios.ts | 13 + app/native/font-renderer.ts | 12 + app/native/ios-voice-input.ts | 1 + app/native/voice-control.ios.ts | 116 + app/phone-ui/main-page.ios.ts | 5 +- app/ui/dashboard-settings.ts | 11 +- app/ui/dashboard/settings-menus.ts | 6 +- app/ui/font-picker.ts | 5 +- app/ui/shell/shell.ts | 2 +- app/ui/shell/voice-input.ts | 11 +- tests/ios-app-host.test.cjs | 16 + tests/ios-ble.test.cjs | 34 + tests/ios-font-native.cjs | 10 + tests/ios-lc3-native.cjs | 11 + tests/ios-voice.test.cjs | 63 + tests/native/ios-font-test.m | 82 + tests/native/ios-lc3-test.m | 34 + 67 files changed, 15717 insertions(+), 55 deletions(-) create mode 100644 App_Resources/iOS/src/FaceclawFontRenderer.h create mode 100644 App_Resources/iOS/src/FaceclawFontRenderer.m create mode 100644 App_Resources/iOS/src/FaceclawLc3Decoder.h create mode 100644 App_Resources/iOS/src/FaceclawLc3Decoder.m create mode 100644 App_Resources/iOS/src/FaceclawSpeech.h create mode 100644 App_Resources/iOS/src/FaceclawSpeech.m create mode 100644 App_Resources/iOS/src/lc3/LICENSE create mode 100644 App_Resources/iOS/src/lc3/README.faceclaw.md create mode 100644 App_Resources/iOS/src/lc3/attdet.c create mode 100644 App_Resources/iOS/src/lc3/attdet.h create mode 100644 App_Resources/iOS/src/lc3/bits.c create mode 100644 App_Resources/iOS/src/lc3/bits.h create mode 100644 App_Resources/iOS/src/lc3/bwdet.c create mode 100644 App_Resources/iOS/src/lc3/bwdet.h create mode 100644 App_Resources/iOS/src/lc3/common.h create mode 100644 App_Resources/iOS/src/lc3/energy.c create mode 100644 App_Resources/iOS/src/lc3/energy.h create mode 100644 App_Resources/iOS/src/lc3/fastmath.h create mode 100644 App_Resources/iOS/src/lc3/lc3.c create mode 100644 App_Resources/iOS/src/lc3/lc3.h create mode 100644 App_Resources/iOS/src/lc3/lc3_cpp.h create mode 100644 App_Resources/iOS/src/lc3/lc3_private.h create mode 100644 App_Resources/iOS/src/lc3/ltpf.c create mode 100644 App_Resources/iOS/src/lc3/ltpf.h create mode 100644 App_Resources/iOS/src/lc3/ltpf_arm.h create mode 100644 App_Resources/iOS/src/lc3/ltpf_neon.h create mode 100644 App_Resources/iOS/src/lc3/mdct.c create mode 100644 App_Resources/iOS/src/lc3/mdct.h create mode 100644 App_Resources/iOS/src/lc3/mdct_neon.h create mode 100644 App_Resources/iOS/src/lc3/plc.c create mode 100644 App_Resources/iOS/src/lc3/plc.h create mode 100644 App_Resources/iOS/src/lc3/sns.c create mode 100644 App_Resources/iOS/src/lc3/sns.h create mode 100644 App_Resources/iOS/src/lc3/spec.c create mode 100644 App_Resources/iOS/src/lc3/spec.h create mode 100644 App_Resources/iOS/src/lc3/tables.c create mode 100644 App_Resources/iOS/src/lc3/tables.h create mode 100644 App_Resources/iOS/src/lc3/tns.c create mode 100644 App_Resources/iOS/src/lc3/tns.h create mode 100644 app/native/font-renderer.ios.ts create mode 100644 app/native/font-renderer.ts create mode 100644 app/native/ios-voice-input.ts create mode 100644 app/native/voice-control.ios.ts create mode 100644 tests/ios-font-native.cjs create mode 100644 tests/ios-lc3-native.cjs create mode 100644 tests/ios-voice.test.cjs create mode 100644 tests/native/ios-font-test.m create mode 100644 tests/native/ios-lc3-test.m diff --git a/App_Resources/iOS/Info.plist b/App_Resources/iOS/Info.plist index 11d23bb4..f9fc115e 100644 --- a/App_Resources/iOS/Info.plist +++ b/App_Resources/iOS/Info.plist @@ -20,6 +20,8 @@ NSBluetoothAlwaysUsageDescription Faceclaw uses Bluetooth to connect to your glasses and ring, display your apps, and receive gestures. + NSSpeechRecognitionUsageDescription + Faceclaw turns audio from your glasses microphone into text for the app you choose. Dictation uses on-device recognition. UIBackgroundModes bluetooth-central diff --git a/App_Resources/iOS/build.xcconfig b/App_Resources/iOS/build.xcconfig index bfe1e0b6..b8939fa9 100644 --- a/App_Resources/iOS/build.xcconfig +++ b/App_Resources/iOS/build.xcconfig @@ -3,6 +3,8 @@ TARGETED_DEVICE_FAMILY = 1; CODE_SIGN_STYLE = Automatic; // Select the local signing team in Xcode or pass --teamId to the iOS scripts. -OTHER_LDFLAGS = $(inherited) -framework CoreBluetooth +OTHER_LDFLAGS = $(inherited) -framework CoreBluetooth -framework CoreText -framework Speech -framework AVFoundation ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; + +HEADER_SEARCH_PATHS = $(inherited) "$(SRCROOT)/../../App_Resources/iOS/src/lc3" diff --git a/App_Resources/iOS/src/FaceclawFontRenderer.h b/App_Resources/iOS/src/FaceclawFontRenderer.h new file mode 100644 index 00000000..63a3890c --- /dev/null +++ b/App_Resources/iOS/src/FaceclawFontRenderer.h @@ -0,0 +1,15 @@ +#import + +/** Core Text rasterizer. All sizes are glasses pixels, independent of screen scale. + * Each operation owns its layout/context, so main and worker isolates may call it. + * Packets match Android FontFileRenderer: grayscale image or 10-byte glyph header. + */ +@interface FaceclawFontRenderer : NSObject ++ (BOOL)canLoadFont:(NSString *)path; ++ (NSString *)getFontName:(NSString *)path; ++ (NSString *)getFontMetrics:(NSString *)path size:(double)size; ++ (double)measureTextExact:(NSString *)path text:(NSString *)text size:(double)size; ++ (NSData *)renderGlyphCell:(NSString *)path size:(double)size codePoint:(NSInteger)codePoint gamma:(double)gamma; ++ (NSData *)renderText:(NSString *)path text:(NSString *)text size:(double)size gamma:(double)gamma; ++ (NSData *)renderWrapped:(NSString *)path text:(NSString *)text size:(double)size width:(NSInteger)width gamma:(double)gamma maxLines:(NSInteger)maxLines; +@end diff --git a/App_Resources/iOS/src/FaceclawFontRenderer.m b/App_Resources/iOS/src/FaceclawFontRenderer.m new file mode 100644 index 00000000..012f36d4 --- /dev/null +++ b/App_Resources/iOS/src/FaceclawFontRenderer.m @@ -0,0 +1,189 @@ +#import "FaceclawFontRenderer.h" +#import +#import +#import + +// Immutable font descriptors may be shared; layout objects never cross threads. +static CTFontRef CreateFont(NSString *path, double size) CF_RETURNS_RETAINED { + if (!path.length || !isfinite(size) || size <= 0 || size > 512) return NULL; + static NSCache *cache; + static dispatch_once_t once; + dispatch_once(&once, ^{ cache = [NSCache new]; cache.countLimit = 32; }); + NSDictionary *attrs = [[NSFileManager defaultManager] attributesOfItemAtPath:path error:nil]; + if (![attrs[NSFileType] isEqual:NSFileTypeRegular]) return NULL; + NSString *key = [NSString stringWithFormat:@"%@:%@:%@", path, attrs[NSFileSize], attrs[NSFileModificationDate]]; + id descriptor = [cache objectForKey:key]; + if (!descriptor) { + NSArray *descriptors = CFBridgingRelease(CTFontManagerCreateFontDescriptorsFromURL((__bridge CFURLRef)[NSURL fileURLWithPath:path])); + descriptor = descriptors.firstObject; // TTC: first face, matching Android. + if (!descriptor) return NULL; // Never silently substitute a system font for an invalid file. + [cache setObject:descriptor forKey:key]; + } + return CTFontCreateWithFontDescriptor((__bridge CTFontDescriptorRef)descriptor, size, NULL); +} +static NSAttributedString *Attributed(CTFontRef font, NSString *text, BOOL glyphLayout) { + NSMutableDictionary *attrs = [@{(__bridge id)kCTFontAttributeName: (__bridge id)font, + (__bridge id)kCTForegroundColorFromContextAttributeName: @YES} mutableCopy]; + // Shared UI lays out codepoints with pair kerning. Whole preview paragraphs + // can use normal ligatures/shaping; UI measurements must match glyph cells. + if (glyphLayout) attrs[(__bridge id)kCTLigatureAttributeName] = @0; + return [[NSAttributedString alloc] initWithString:text attributes:attrs]; +} +static BOOL ValidText(NSString *text) { return text != nil && text.length <= 100000; } +static BOOL ValidRaster(NSInteger width, NSInteger height) { + return width > 0 && height > 0 && width <= 65535 && height <= 65535 && width * height <= 4000000; +} +static CGContextRef CreateContext(NSMutableData *pixels, NSInteger width, NSInteger height) CF_RETURNS_RETAINED { + CGContextRef ctx = CGBitmapContextCreate(pixels.mutableBytes, width, height, 8, width, NULL, (CGBitmapInfo)kCGImageAlphaOnly); + if (ctx) { + CGContextSetShouldAntialias(ctx, true); + CGContextSetShouldSmoothFonts(ctx, false); // Grayscale coverage, never LCD subpixel color. + CGContextSetShouldSubpixelPositionFonts(ctx, true); + CGContextSetShouldSubpixelQuantizeFonts(ctx, false); + CGContextSetTextMatrix(ctx, CGAffineTransformIdentity); + CGContextSetGrayFillColor(ctx, 1, 1); + } + return ctx; +} +static void U16(uint8_t *out, NSInteger value) { out[0] = value & 255; out[1] = (value >> 8) & 255; } +static void GammaCopy(uint8_t *dst, const uint8_t *src, NSInteger count, double gamma) { + if (!isfinite(gamma) || gamma <= 0) gamma = 1; + uint8_t lut[256]; + for (int i = 0; i < 256; i++) lut[i] = (uint8_t)lround(255 * pow(i / 255.0, gamma)); + for (NSInteger i = 0; i < count; i++) dst[i] = lut[src[i]]; +} +static NSData *ImagePacket(NSData *pixels, NSInteger width, NSInteger height, double gamma) { + NSMutableData *out = [NSMutableData dataWithLength:4 + pixels.length]; + uint8_t *dst = out.mutableBytes; + U16(dst, width); U16(dst + 2, height); + GammaCopy(dst + 4, pixels.bytes, pixels.length, gamma); + return out; +} + +@implementation FaceclawFontRenderer ++ (BOOL)canLoadFont:(NSString *)path { + CTFontRef font = CreateFont(path, 16); + if (!font) return NO; + CFRelease(font); return YES; +} ++ (NSString *)getFontName:(NSString *)path { + CTFontRef font = CreateFont(path, 16); + if (!font) return @""; + NSString *family = CFBridgingRelease(CTFontCopyFamilyName(font)); + NSString *style = CFBridgingRelease(CTFontCopyName(font, kCTFontStyleNameKey)); + CFRelease(font); + return [NSString stringWithFormat:@"%@\n%@", family ?: @"", style ?: @""]; +} ++ (NSString *)getFontMetrics:(NSString *)path size:(double)size { + CTFontRef font = CreateFont(path, size); + if (!font) return @""; + NSString *metrics = [NSString stringWithFormat:@"%ld %ld %ld", (long)ceil(CTFontGetAscent(font)), + (long)ceil(CTFontGetDescent(font)), (long)ceil(MAX(0, CTFontGetLeading(font)))]; + CFRelease(font); return metrics; +} ++ (double)measureTextExact:(NSString *)path text:(NSString *)text size:(double)size { + if (!ValidText(text)) return 0; + CTFontRef font = CreateFont(path, size); + if (!font) return 0; + CTLineRef line = CTLineCreateWithAttributedString((__bridge CFAttributedStringRef)Attributed(font, text, YES)); + double width = CTLineGetTypographicBounds(line, NULL, NULL, NULL); + CFRelease(line); CFRelease(font); return width; +} ++ (NSData *)renderGlyphCell:(NSString *)path size:(double)size codePoint:(NSInteger)cp gamma:(double)gamma { + if (cp < 0 || cp > 0x10ffff || (cp >= 0xd800 && cp <= 0xdfff)) return [NSData data]; + CTFontRef font = CreateFont(path, size); + if (!font) return [NSData data]; + uint32_t scalar = (uint32_t)cp; + NSString *text = [[NSString alloc] initWithBytes:&scalar length:4 encoding:NSUTF32LittleEndianStringEncoding]; + CTLineRef line = CTLineCreateWithAttributedString((__bridge CFAttributedStringRef)Attributed(font, text, YES)); + double advance = CTLineGetTypographicBounds(line, NULL, NULL, NULL); + NSMutableData *out = [NSMutableData dataWithLength:10]; + U16(out.mutableBytes, MAX(0, MIN(65535, lround(advance * 64)))); + CGRect bounds = CTLineGetImageBounds(line, NULL); + if (!CGRectIsEmpty(bounds) && !CGRectIsNull(bounds)) { + NSInteger left = floor(CGRectGetMinX(bounds)) - 2, top = ceil(CGRectGetMaxY(bounds)) + 2; + NSInteger bottom = floor(CGRectGetMinY(bounds)) - 2; + NSInteger width = ceil(CGRectGetMaxX(bounds)) + 2 - left, height = top - bottom; + if (!ValidRaster(width, height)) { CFRelease(line); CFRelease(font); return [NSData data]; } + NSMutableData *pixels = [NSMutableData dataWithLength:width * height]; + CGContextRef ctx = CreateContext(pixels, width, height); + if (!ctx) { CFRelease(line); CFRelease(font); return [NSData data]; } + CGContextSetTextPosition(ctx, -left, -bottom); CTLineDraw(line, ctx); CGContextRelease(ctx); + const uint8_t *src = pixels.bytes; + NSInteger x0 = width, y0 = height, x1 = -1, y1 = -1; + for (NSInteger y = 0; y < height; y++) for (NSInteger x = 0; x < width; x++) if (src[y * width + x]) { + x0 = MIN(x0, x); x1 = MAX(x1, x); y0 = MIN(y0, y); y1 = MAX(y1, y); + } + if (x1 >= x0) { + NSInteger w = x1 - x0 + 1, h = y1 - y0 + 1; + [out setLength:10 + w * h]; uint8_t *dst = out.mutableBytes; + U16(dst + 2, left + x0); U16(dst + 4, ceil(CTFontGetAscent(font)) - top + y0); + U16(dst + 6, w); U16(dst + 8, h); + for (NSInteger y = 0; y < h; y++) GammaCopy(dst + 10 + y * w, src + (y0 + y) * width + x0, w, gamma); + } + } + CFRelease(line); CFRelease(font); return out; +} ++ (NSData *)renderText:(NSString *)path text:(NSString *)text size:(double)size gamma:(double)gamma { + if (!ValidText(text)) return [NSData data]; + CTFontRef font = CreateFont(path, size); + if (!font) return [NSData data]; + CTLineRef line = CTLineCreateWithAttributedString((__bridge CFAttributedStringRef)Attributed(font, text, NO)); + CGRect bounds = CTLineGetImageBounds(line, NULL); + BOOL ink = !CGRectIsNull(bounds) && !CGRectIsEmpty(bounds); + NSInteger left = ink ? MIN(0, floor(CGRectGetMinX(bounds))) : 0; + NSInteger right = MAX(1, ceil(CTLineGetTypographicBounds(line, NULL, NULL, NULL))); + NSInteger top = ceil(CTFontGetAscent(font)), bottom = -ceil(CTFontGetDescent(font)); + if (ink) { right = MAX(right, ceil(CGRectGetMaxX(bounds))); top = MAX(top, ceil(CGRectGetMaxY(bounds))); bottom = MIN(bottom, floor(CGRectGetMinY(bounds))); } + NSInteger width = right - left, height = top - bottom; + NSData *result = [NSData data]; + if (ValidRaster(width, height)) { + NSMutableData *pixels = [NSMutableData dataWithLength:width * height]; + CGContextRef ctx = CreateContext(pixels, width, height); + if (ctx) { + CGContextSetTextPosition(ctx, -left, -bottom); CTLineDraw(line, ctx); CGContextRelease(ctx); + result = ImagePacket(pixels, width, height, gamma); + } + } + CFRelease(line); CFRelease(font); return result; +} ++ (NSData *)renderWrapped:(NSString *)path text:(NSString *)text size:(double)size width:(NSInteger)width gamma:(double)gamma maxLines:(NSInteger)maxLines { + if (!ValidText(text) || width <= 0 || width > 65535 || maxLines <= 0) return [NSData data]; + CTFontRef font = CreateFont(path, size); + if (!font) return [NSData data]; + NSInteger ascent = ceil(CTFontGetAscent(font)), descent = ceil(CTFontGetDescent(font)); + NSInteger step = MAX(1, ascent + descent + (NSInteger)ceil(MAX(0, CTFontGetLeading(font)))); + maxLines = MIN(maxLines, MIN(65535 / step, 4000000 / width / step)); + if (maxLines <= 0) { CFRelease(font); return [NSData data]; } + NSAttributedString *attributed = Attributed(font, text, NO); + CTTypesetterRef typesetter = CTTypesetterCreateWithAttributedString((__bridge CFAttributedStringRef)attributed); + NSMutableArray *lines = [NSMutableArray new]; + CFIndex start = 0; + while (start < (CFIndex)text.length && lines.count < (NSUInteger)maxLines) { + CFIndex count = CTTypesetterSuggestLineBreak(typesetter, start, width); + if (count <= 0) count = [text rangeOfComposedCharacterSequenceAtIndex:start].length; + CTLineRef line; + if (lines.count == (NSUInteger)maxLines - 1 && start + count < (CFIndex)text.length) { + NSString *rest = [[text substringFromIndex:start] stringByReplacingOccurrencesOfString:@"\n" withString:@" "]; + CTLineRef full = CTLineCreateWithAttributedString((__bridge CFAttributedStringRef)Attributed(font, rest, NO)); + CTLineRef token = CTLineCreateWithAttributedString((__bridge CFAttributedStringRef)Attributed(font, @"…", NO)); + line = CTLineCreateTruncatedLine(full, width, kCTLineTruncationEnd, token); + if (!line) line = CFRetain(token); + CFRelease(full); CFRelease(token); + } else line = CTTypesetterCreateLine(typesetter, CFRangeMake(start, count)); + [lines addObject:CFBridgingRelease(line)]; start += count; + } + NSInteger height = MAX(1, lines.count) * step; + NSMutableData *pixels = [NSMutableData dataWithLength:width * height]; + CGContextRef ctx = CreateContext(pixels, width, height); + NSData *result = [NSData data]; + if (ctx) { + for (NSUInteger i = 0; i < lines.count; i++) { + CGContextSetTextPosition(ctx, 0, height - ascent - i * step); + CTLineDraw((__bridge CTLineRef)lines[i], ctx); + } + CGContextRelease(ctx); result = ImagePacket(pixels, width, height, gamma); + } + CFRelease(typesetter); CFRelease(font); return result; +} +@end diff --git a/App_Resources/iOS/src/FaceclawLc3Decoder.h b/App_Resources/iOS/src/FaceclawLc3Decoder.h new file mode 100644 index 00000000..e9af329d --- /dev/null +++ b/App_Resources/iOS/src/FaceclawLc3Decoder.h @@ -0,0 +1,11 @@ +#import +/** One decoder per capture. Stock G2 packets: 5x40 LC3 bytes, DSP trailer, + * counter. Output: 800 mono PCM16LE samples at 16 kHz (50 ms). + */ +@interface FaceclawLc3Decoder : NSObject +- (NSData *)decodePacket:(NSData *)packet; +@property(nonatomic, readonly) NSUInteger packets; +@property(nonatomic, readonly) NSUInteger duplicates; +@property(nonatomic, readonly) NSUInteger missing; +@property(nonatomic, readonly) NSUInteger errors; +@end diff --git a/App_Resources/iOS/src/FaceclawLc3Decoder.m b/App_Resources/iOS/src/FaceclawLc3Decoder.m new file mode 100644 index 00000000..e0ed1bd3 --- /dev/null +++ b/App_Resources/iOS/src/FaceclawLc3Decoder.m @@ -0,0 +1,42 @@ +#import "FaceclawLc3Decoder.h" +#include "lc3/lc3.h" +#include +@interface FaceclawLc3Decoder () { + void *_memory; + lc3_decoder_t _decoder; + int _lastCounter; +} +@property(nonatomic) NSUInteger packets, duplicates, missing, errors; +@end +@implementation FaceclawLc3Decoder +- (instancetype)init { + if ((self = [super init])) { + _lastCounter = -1; + _memory = calloc(1, lc3_decoder_size(10000, 16000)); + if (!_memory) return nil; + _decoder = lc3_setup_decoder(10000, 16000, 0, _memory); + if (!_decoder) return nil; + } + return self; +} +- (void)dealloc { free(_memory); } +- (NSData *)decodePacket:(NSData *)packet { + @synchronized(self) { + if (packet.length != 205) { _errors++; return nil; } + const uint8_t *bytes = packet.bytes; + int counter = bytes[204], gap = _lastCounter < 0 ? 1 : (counter - _lastCounter) & 255; + // Both arms may relay the same packet. Drop duplicates/late copies, + // including across the 255 -> 0 wrap, before touching decoder history. + if (gap == 0 || gap >= 128) { _duplicates++; return nil; } + _missing += gap - 1; + _lastCounter = counter; + NSMutableData *out = [NSMutableData dataWithLength:800 * sizeof(int16_t)]; + int16_t *pcm = out.mutableBytes; + for (int frame = 0; frame < 5; frame++) { + int status = lc3_decode(_decoder, bytes + frame * 40, 40, LC3_PCM_FORMAT_S16, pcm + frame * 160, 1); + if (status < 0) { _errors++; return nil; } + } + _packets++; return out; + } +} +@end diff --git a/App_Resources/iOS/src/FaceclawSpeech.h b/App_Resources/iOS/src/FaceclawSpeech.h new file mode 100644 index 00000000..7474d225 --- /dev/null +++ b/App_Resources/iOS/src/FaceclawSpeech.h @@ -0,0 +1,12 @@ +#import +/** On-device speech recognition fed ONLY by decoded G2 BLE microphone packets. */ +@interface FaceclawSpeech : NSObject +@property(nonatomic, copy) void (^eventHandler)(NSString *json); ++ (NSInteger)authorizationStatus; ++ (void)requestAuthorization:(void (^)(NSInteger status))completion; +/** Returns an actionable error, or an empty string when capture starts. */ +- (NSString *)start; +- (void)acceptPacket:(NSData *)packet; +- (void)finish; +- (void)cancel; +@end diff --git a/App_Resources/iOS/src/FaceclawSpeech.m b/App_Resources/iOS/src/FaceclawSpeech.m new file mode 100644 index 00000000..ba018155 --- /dev/null +++ b/App_Resources/iOS/src/FaceclawSpeech.m @@ -0,0 +1,136 @@ +#import "FaceclawSpeech.h" +#import "FaceclawLc3Decoder.h" +#import +#import +#import + +@interface FaceclawSpeech () +@property(nonatomic, strong) SFSpeechRecognizer *recognizer; +@property(nonatomic, strong) SFSpeechAudioBufferRecognitionRequest *request; +@property(nonatomic, strong) SFSpeechRecognitionTask *task; +@property(nonatomic, strong) FaceclawLc3Decoder *decoder; +@property(nonatomic, strong) dispatch_queue_t audioQueue; +@property(atomic) NSUInteger generation; +@property(nonatomic) NSUInteger pendingPackets; +@property(nonatomic) BOOL accepting; +@property(nonatomic, copy) NSString *bestText; +@end +@implementation FaceclawSpeech +- (instancetype)init { + if ((self = [super init])) _audioQueue = dispatch_queue_create("com.faceclaw.glasses-speech", DISPATCH_QUEUE_SERIAL); + return self; +} ++ (NSInteger)authorizationStatus { return SFSpeechRecognizer.authorizationStatus; } ++ (void)requestAuthorization:(void (^)(NSInteger))completion { + [SFSpeechRecognizer requestAuthorization:^(SFSpeechRecognizerAuthorizationStatus status) { + dispatch_async(dispatch_get_main_queue(), ^{ completion(status); }); + }]; +} +- (void)emit:(NSDictionary *)event { + if (!self.eventHandler) return; + NSData *json = [NSJSONSerialization dataWithJSONObject:event options:0 error:nil]; + if (json) self.eventHandler([[NSString alloc] initWithData:json encoding:NSUTF8StringEncoding]); +} +- (NSString *)start { + [self cancel]; + if (SFSpeechRecognizer.authorizationStatus != SFSpeechRecognizerAuthorizationStatusAuthorized) + return @"Allow Speech Recognition for Faceclaw in iPhone Settings."; + NSString *language = NSLocale.preferredLanguages.firstObject ?: @"en-US"; + self.recognizer = [[SFSpeechRecognizer alloc] initWithLocale:[NSLocale localeWithLocaleIdentifier:language]]; + if (!self.recognizer.supportsOnDeviceRecognition) + return [NSString stringWithFormat:@"On-device speech is unavailable for %@. Enable Dictation for that language in iPhone Settings → General → Keyboard, then retry.", language]; + if (!self.recognizer.available) return @"Speech recognition is temporarily unavailable. Try again shortly."; + self.decoder = [FaceclawLc3Decoder new]; + if (!self.decoder) return @"Could not initialize the glasses audio decoder."; + self.recognizer.queue = NSOperationQueue.mainQueue; + self.request = [SFSpeechAudioBufferRecognitionRequest new]; + self.request.requiresOnDeviceRecognition = YES; + self.request.shouldReportPartialResults = YES; + self.request.taskHint = SFSpeechRecognitionTaskHintDictation; + if (@available(iOS 16.0, *)) self.request.addsPunctuation = YES; + self.bestText = @""; self.accepting = YES; + NSUInteger generation = self.generation; + __weak FaceclawSpeech *weakSelf = self; + self.task = [self.recognizer recognitionTaskWithRequest:self.request resultHandler:^(SFSpeechRecognitionResult *result, NSError *error) { + dispatch_async(dispatch_get_main_queue(), ^{ + FaceclawSpeech *owner = weakSelf; + if (!owner || owner.generation != generation) return; + if (result) { + owner.bestText = result.bestTranscription.formattedString ?: @""; + if (!result.final) [owner emit:@{@"kind":@"transcript", @"text":owner.bestText, @"final":@NO}]; + } + if (result.final || error) { + NSString *message = error ? [NSString stringWithFormat:@"Speech recognition: %@", error.localizedDescription] : @"Ready to send"; + [owner complete:message]; + } + }); + }]; + [self emit:@{@"kind":@"status", @"message":[NSString stringWithFormat:@"Listening on glasses (%@, on-device)…", language]}]; + // Bound a dictation to the recognizer's supported short-session workflow. + dispatch_after(dispatch_time(DISPATCH_TIME_NOW, 55 * NSEC_PER_SEC), dispatch_get_main_queue(), ^{ + FaceclawSpeech *owner = weakSelf; + if (owner && owner.generation == generation && owner.accepting) [owner finish]; + }); + return @""; +} +- (void)acceptPacket:(NSData *)packet { + if (!self.accepting) return; + if (self.pendingPackets >= 40) { [self complete:@"Audio processing fell behind. Please try again."]; return; } + self.pendingPackets++; + NSUInteger generation = self.generation; + FaceclawLc3Decoder *decoder = self.decoder; + SFSpeechAudioBufferRecognitionRequest *request = self.request; + NSData *copy = [packet copy]; + dispatch_async(self.audioQueue, ^{ @autoreleasepool { + if (self.generation != generation) return; + NSData *pcm = [decoder decodePacket:copy]; + double rms = 0; + if (pcm.length) { + AVAudioFormat *format = [[AVAudioFormat alloc] initWithCommonFormat:AVAudioPCMFormatFloat32 sampleRate:16000 channels:1 interleaved:NO]; + AVAudioPCMBuffer *buffer = [[AVAudioPCMBuffer alloc] initWithPCMFormat:format frameCapacity:(AVAudioFrameCount)(pcm.length / 2)]; + buffer.frameLength = buffer.frameCapacity; + const int16_t *samples = pcm.bytes; + for (NSUInteger i = 0; i < buffer.frameLength; i++) { + float value = samples[i] / 32768.0f; + buffer.floatChannelData[0][i] = value; rms += value * value; + } + rms = sqrt(rms / buffer.frameLength); + if (self.generation == generation) [request appendAudioPCMBuffer:buffer]; + } + NSUInteger packets = decoder.packets, errors = decoder.errors, missing = decoder.missing; + dispatch_async(dispatch_get_main_queue(), ^{ + if (self.generation != generation) return; + self.pendingPackets--; + if (pcm.length && packets % 20 == 0) [self emit:@{@"kind":@"audio", @"packets":@(packets), @"seconds":@(packets * 0.05), @"rms":@(rms), @"missing":@(missing), @"errors":@(errors)}]; + if (errors > 10 && !packets) [self complete:@"Could not decode glasses audio. Reconnect the glasses and retry."]; + }); + }}); +} +- (void)finish { + if (!self.accepting) return; + self.accepting = NO; + NSUInteger generation = self.generation; + SFSpeechAudioBufferRecognitionRequest *request = self.request; + [self emit:@{@"kind":@"finishing"}]; + // Drain already received audio before marking the utterance complete. + dispatch_async(self.audioQueue, ^{ if (self.generation == generation) [request endAudio]; }); + __weak FaceclawSpeech *weakSelf = self; + dispatch_after(dispatch_time(DISPATCH_TIME_NOW, 8 * NSEC_PER_SEC), dispatch_get_main_queue(), ^{ + FaceclawSpeech *owner = weakSelf; + if (owner && owner.generation == generation) [owner complete:@"Ready to send"]; + }); +} +- (void)complete:(NSString *)status { + NSString *text = self.bestText ?: @""; + [self cancel]; + NSUInteger generation = self.generation; + if (text.length) [self emit:@{@"kind":@"transcript", @"text":text, @"final":@YES}]; + if (self.generation == generation) [self emit:@{@"kind":@"ended", @"message":status}]; +} +- (void)cancel { + self.generation++; + self.accepting = NO; self.pendingPackets = 0; + [self.task cancel]; self.task = nil; self.request = nil; self.decoder = nil; self.recognizer = nil; + self.bestText = @""; +} +@end diff --git a/App_Resources/iOS/src/lc3/LICENSE b/App_Resources/iOS/src/lc3/LICENSE new file mode 100644 index 00000000..d6456956 --- /dev/null +++ b/App_Resources/iOS/src/lc3/LICENSE @@ -0,0 +1,202 @@ + + 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. diff --git a/App_Resources/iOS/src/lc3/README.faceclaw.md b/App_Resources/iOS/src/lc3/README.faceclaw.md new file mode 100644 index 00000000..a69c34f5 --- /dev/null +++ b/App_Resources/iOS/src/lc3/README.faceclaw.md @@ -0,0 +1,7 @@ +Google liblc3 v1.1.3 (same release as Android app.gradle). +Source: https://github.com/google/liblc3/releases/tag/v1.1.3 +Archive SHA-256: 276752ff54ce6a77d54ec133397b9d7e71f90caf3d9afa32d8b0e891b8ecb8af + +Unmodified include/*.h, src/*.h and the 12 translation units compiled by +Android. Licensed under Apache-2.0; see LICENSE. NativeScript compiles the +C files into the iOS app. No generated binaries are checked in. diff --git a/App_Resources/iOS/src/lc3/attdet.c b/App_Resources/iOS/src/lc3/attdet.c new file mode 100644 index 00000000..b498ef9b --- /dev/null +++ b/App_Resources/iOS/src/lc3/attdet.c @@ -0,0 +1,92 @@ +/****************************************************************************** + * + * Copyright 2022 Google LLC + * + * 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 "attdet.h" + + +/** + * Time domain attack detector + */ +bool lc3_attdet_run(enum lc3_dt dt, enum lc3_srate sr, + int nbytes, struct lc3_attdet_analysis *attdet, const int16_t *x) +{ + /* --- Check enabling --- */ + + const int nbytes_ranges[][LC3_NUM_SRATE - LC3_SRATE_32K][2] = { + [LC3_DT_7M5 - LC3_DT_7M5] = { { 61, 149 }, { 75, 149 } }, + [LC3_DT_10M - LC3_DT_7M5] = { { 81, INT_MAX }, { 100, INT_MAX } }, + }; + + if (dt < LC3_DT_7M5 || sr < LC3_SRATE_32K || lc3_hr(sr) || + nbytes < nbytes_ranges[dt - LC3_DT_7M5][sr - LC3_SRATE_32K][0] || + nbytes > nbytes_ranges[dt - LC3_DT_7M5][sr - LC3_SRATE_32K][1] ) + return 0; + + /* --- Filtering & Energy calculation --- */ + + int nblk = 4 - (dt == LC3_DT_7M5); + int32_t e[4]; + + for (int i = 0; i < nblk; i++) { + e[i] = 0; + + if (sr == LC3_SRATE_32K) { + int16_t xn2 = (x[-4] + x[-3]) >> 1; + int16_t xn1 = (x[-2] + x[-1]) >> 1; + int16_t xn, xf; + + for (int j = 0; j < 40; j++, x += 2, xn2 = xn1, xn1 = xn) { + xn = (x[0] + x[1]) >> 1; + xf = (3 * xn - 4 * xn1 + 1 * xn2) >> 3; + e[i] += (xf * xf) >> 5; + } + } + + else { + int16_t xn2 = (x[-6] + x[-5] + x[-4]) >> 2; + int16_t xn1 = (x[-3] + x[-2] + x[-1]) >> 2; + int16_t xn, xf; + + for (int j = 0; j < 40; j++, x += 3, xn2 = xn1, xn1 = xn) { + xn = (x[0] + x[1] + x[2]) >> 2; + xf = (3 * xn - 4 * xn1 + 1 * xn2) >> 3; + e[i] += (xf * xf) >> 5; + } + } + } + + /* --- Attack detection --- + * The attack block `p_att` is defined as the normative value + 1, + * in such way, it will be initialized to 0 */ + + int p_att = 0; + int32_t a[4]; + + for (int i = 0; i < nblk; i++) { + a[i] = LC3_MAX(attdet->an1 >> 2, attdet->en1); + attdet->en1 = e[i], attdet->an1 = a[i]; + + if ((e[i] >> 3) > a[i] + (a[i] >> 4)) + p_att = i + 1; + } + + int att = attdet->p_att >= 1 + (nblk >> 1) || p_att > 0; + attdet->p_att = p_att; + + return att; +} diff --git a/App_Resources/iOS/src/lc3/attdet.h b/App_Resources/iOS/src/lc3/attdet.h new file mode 100644 index 00000000..4d4ee170 --- /dev/null +++ b/App_Resources/iOS/src/lc3/attdet.h @@ -0,0 +1,37 @@ +/****************************************************************************** + * + * Copyright 2022 Google LLC + * + * 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. + * + ******************************************************************************/ + +#ifndef __LC3_ATTDET_H +#define __LC3_ATTDET_H + +#include "common.h" + + +/** + * Time domain attack detector + * dt, sr Duration and samplerate of the frame + * nbytes Size in bytes of the frame + * attdet Context of the Attack Detector + * x [-6..-1] Previous, [0..ns-1] Current samples + * return 1: Attack detected 0: Otherwise + */ +bool lc3_attdet_run(enum lc3_dt dt, enum lc3_srate sr, + int nbytes, lc3_attdet_analysis_t *attdet, const int16_t *x); + + +#endif /* __LC3_ATTDET_H */ diff --git a/App_Resources/iOS/src/lc3/bits.c b/App_Resources/iOS/src/lc3/bits.c new file mode 100644 index 00000000..881258bf --- /dev/null +++ b/App_Resources/iOS/src/lc3/bits.c @@ -0,0 +1,375 @@ +/****************************************************************************** + * + * Copyright 2022 Google LLC + * + * 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 "bits.h" +#include "common.h" + + +/* ---------------------------------------------------------------------------- + * Common + * -------------------------------------------------------------------------- */ + +static inline int ac_get(struct lc3_bits_buffer *); +static inline void accu_load(struct lc3_bits_accu *, struct lc3_bits_buffer *); + +/** + * Arithmetic coder return range bits + * ac Arithmetic coder + * return 1 + log2(ac->range) + */ +static int ac_get_range_bits(const struct lc3_bits_ac *ac) +{ + int nbits = 0; + + for (unsigned r = ac->range; r; r >>= 1, nbits++); + + return nbits; +} + +/** + * Arithmetic coder return pending bits + * ac Arithmetic coder + * return Pending bits + */ +static int ac_get_pending_bits(const struct lc3_bits_ac *ac) +{ + return 26 - ac_get_range_bits(ac) + + ((ac->cache >= 0) + ac->carry_count) * 8; +} + +/** + * Return number of bits left in the bitstream + * bits Bitstream context + * return >= 0: Number of bits left < 0: Overflow + */ +static int get_bits_left(const struct lc3_bits *bits) +{ + const struct lc3_bits_buffer *buffer = &bits->buffer; + const struct lc3_bits_accu *accu = &bits->accu; + const struct lc3_bits_ac *ac = &bits->ac; + + uintptr_t end = (uintptr_t)buffer->p_bw + + (bits->mode == LC3_BITS_MODE_READ ? LC3_ACCU_BITS/8 : 0); + + uintptr_t start = (uintptr_t)buffer->p_fw - + (bits->mode == LC3_BITS_MODE_READ ? LC3_AC_BITS/8 : 0); + + int n = end > start ? (int)(end - start) : -(int)(start - end); + + return 8 * n - (accu->n + accu->nover + ac_get_pending_bits(ac)); +} + +/** + * Setup bitstream writing + */ +void lc3_setup_bits(struct lc3_bits *bits, + enum lc3_bits_mode mode, void *buffer, int len) +{ + *bits = (struct lc3_bits){ + .mode = mode, + .accu = { + .n = mode == LC3_BITS_MODE_READ ? LC3_ACCU_BITS : 0, + }, + .ac = { + .range = 0xffffff, + .cache = -1 + }, + .buffer = { + .start = (uint8_t *)buffer, .end = (uint8_t *)buffer + len, + .p_fw = (uint8_t *)buffer, .p_bw = (uint8_t *)buffer + len, + } + }; + + if (mode == LC3_BITS_MODE_READ) { + struct lc3_bits_ac *ac = &bits->ac; + struct lc3_bits_accu *accu = &bits->accu; + struct lc3_bits_buffer *buffer = &bits->buffer; + + ac->low = ac_get(buffer) << 16; + ac->low |= ac_get(buffer) << 8; + ac->low |= ac_get(buffer); + + accu_load(accu, buffer); + } +} + +/** + * Return number of bits left in the bitstream + */ +int lc3_get_bits_left(const struct lc3_bits *bits) +{ + return LC3_MAX(get_bits_left(bits), 0); +} + +/** + * Return number of bits left in the bitstream + */ +int lc3_check_bits(const struct lc3_bits *bits) +{ + const struct lc3_bits_ac *ac = &bits->ac; + + return -(get_bits_left(bits) < 0 || ac->error); +} + + +/* ---------------------------------------------------------------------------- + * Writing + * -------------------------------------------------------------------------- */ + +/** + * Flush the bits accumulator + * accu Bitstream accumulator + * buffer Bitstream buffer + */ +static inline void accu_flush( + struct lc3_bits_accu *accu, struct lc3_bits_buffer *buffer) +{ + int nbytes = LC3_MIN(accu->n >> 3, + LC3_MAX(buffer->p_bw - buffer->p_fw, 0)); + + accu->n -= 8 * nbytes; + + for ( ; nbytes; accu->v >>= 8, nbytes--) + *(--buffer->p_bw) = accu->v & 0xff; + + if (accu->n >= 8) + accu->n = 0; +} + +/** + * Arithmetic coder put byte + * buffer Bitstream buffer + * byte Byte to output + */ +static inline void ac_put(struct lc3_bits_buffer *buffer, int byte) +{ + if (buffer->p_fw < buffer->end) + *(buffer->p_fw++) = byte; +} + +/** + * Arithmetic coder range shift + * ac Arithmetic coder + * buffer Bitstream buffer + */ +LC3_HOT static inline void ac_shift( + struct lc3_bits_ac *ac, struct lc3_bits_buffer *buffer) +{ + if (ac->low < 0xff0000 || ac->carry) + { + if (ac->cache >= 0) + ac_put(buffer, ac->cache + ac->carry); + + for ( ; ac->carry_count > 0; ac->carry_count--) + ac_put(buffer, ac->carry ? 0x00 : 0xff); + + ac->cache = ac->low >> 16; + ac->carry = 0; + } + else + ac->carry_count++; + + ac->low = (ac->low << 8) & 0xffffff; +} + +/** + * Arithmetic coder termination + * ac Arithmetic coder + * buffer Bitstream buffer + * end_val/nbits End value and count of bits to terminate (1 to 8) + */ +static void ac_terminate(struct lc3_bits_ac *ac, + struct lc3_bits_buffer *buffer) +{ + int nbits = 25 - ac_get_range_bits(ac); + unsigned mask = 0xffffff >> nbits; + unsigned val = ac->low + mask; + unsigned high = ac->low + ac->range; + + bool over_val = val >> 24; + bool over_high = high >> 24; + + val = (val & 0xffffff) & ~mask; + high = (high & 0xffffff); + + if (over_val == over_high) { + + if (val + mask >= high) { + nbits++; + mask >>= 1; + val = ((ac->low + mask) & 0xffffff) & ~mask; + } + + ac->carry |= val < ac->low; + } + + ac->low = val; + + for (; nbits > 8; nbits -= 8) + ac_shift(ac, buffer); + ac_shift(ac, buffer); + + int end_val = ac->cache >> (8 - nbits); + + if (ac->carry_count) { + ac_put(buffer, ac->cache); + for ( ; ac->carry_count > 1; ac->carry_count--) + ac_put(buffer, 0xff); + + end_val = nbits < 8 ? 0 : 0xff; + } + + if (buffer->p_fw < buffer->end) { + *buffer->p_fw &= 0xff >> nbits; + *buffer->p_fw |= end_val << (8 - nbits); + } +} + +/** + * Flush and terminate bitstream + */ +void lc3_flush_bits(struct lc3_bits *bits) +{ + struct lc3_bits_ac *ac = &bits->ac; + struct lc3_bits_accu *accu = &bits->accu; + struct lc3_bits_buffer *buffer = &bits->buffer; + + int nleft = buffer->p_bw - buffer->p_fw; + for (int n = 8 * nleft - accu->n; n > 0; n -= 32) + lc3_put_bits(bits, 0, LC3_MIN(n, 32)); + + accu_flush(accu, buffer); + + ac_terminate(ac, buffer); +} + +/** + * Write from 1 to 32 bits, + * exceeding the capacity of the accumulator + */ +LC3_HOT void lc3_put_bits_generic(struct lc3_bits *bits, unsigned v, int n) +{ + struct lc3_bits_accu *accu = &bits->accu; + + /* --- Fulfill accumulator and flush -- */ + + int n1 = LC3_MIN(LC3_ACCU_BITS - accu->n, n); + if (n1) { + accu->v |= v << accu->n; + accu->n = LC3_ACCU_BITS; + } + + accu_flush(accu, &bits->buffer); + + /* --- Accumulate remaining bits -- */ + + accu->v = v >> n1; + accu->n = n - n1; +} + +/** + * Arithmetic coder renormalization + */ +LC3_HOT void lc3_ac_write_renorm(struct lc3_bits *bits) +{ + struct lc3_bits_ac *ac = &bits->ac; + + for ( ; ac->range < 0x10000; ac->range <<= 8) + ac_shift(ac, &bits->buffer); +} + + +/* ---------------------------------------------------------------------------- + * Reading + * -------------------------------------------------------------------------- */ + +/** + * Arithmetic coder get byte + * buffer Bitstream buffer + * return Byte read, 0 on overflow + */ +static inline int ac_get(struct lc3_bits_buffer *buffer) +{ + return buffer->p_fw < buffer->end ? *(buffer->p_fw++) : 0; +} + +/** + * Load the accumulator + * accu Bitstream accumulator + * buffer Bitstream buffer + */ +static inline void accu_load(struct lc3_bits_accu *accu, + struct lc3_bits_buffer *buffer) +{ + int nbytes = LC3_MIN(accu->n >> 3, buffer->p_bw - buffer->start); + + accu->n -= 8 * nbytes; + + for ( ; nbytes; nbytes--) { + accu->v >>= 8; + accu->v |= (unsigned)*(--buffer->p_bw) << (LC3_ACCU_BITS - 8); + } + + if (accu->n >= 8) { + accu->nover = LC3_MIN(accu->nover + accu->n, LC3_ACCU_BITS); + accu->v >>= accu->n; + accu->n = 0; + } +} + +/** + * Read from 1 to 32 bits, + * exceeding the capacity of the accumulator + */ +LC3_HOT unsigned lc3_get_bits_generic(struct lc3_bits *bits, int n) +{ + struct lc3_bits_accu *accu = &bits->accu; + struct lc3_bits_buffer *buffer = &bits->buffer; + + /* --- Fulfill accumulator and read -- */ + + accu_load(accu, buffer); + + int n1 = LC3_MIN(LC3_ACCU_BITS - accu->n, n); + unsigned v = (accu->v >> accu->n) & ((1u << n1) - 1); + accu->n += n1; + + /* --- Second round --- */ + + int n2 = n - n1; + + if (n2) { + accu_load(accu, buffer); + + v |= ((accu->v >> accu->n) & ((1u << n2) - 1)) << n1; + accu->n += n2; + } + + return v; +} + +/** + * Arithmetic coder renormalization + */ +LC3_HOT void lc3_ac_read_renorm(struct lc3_bits *bits) +{ + struct lc3_bits_ac *ac = &bits->ac; + + for ( ; ac->range < 0x10000; ac->range <<= 8) + ac->low = ((ac->low << 8) | ac_get(&bits->buffer)) & 0xffffff; +} diff --git a/App_Resources/iOS/src/lc3/bits.h b/App_Resources/iOS/src/lc3/bits.h new file mode 100644 index 00000000..de65c931 --- /dev/null +++ b/App_Resources/iOS/src/lc3/bits.h @@ -0,0 +1,309 @@ +/****************************************************************************** + * + * Copyright 2022 Google LLC + * + * 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. + * + ******************************************************************************/ + +/** + * The bitstream is written by the 2 ends of the buffer : + * + * - Arthmetic coder put bits while increasing memory addresses + * in the buffer (forward) + * + * - Plain bits are puts starting the end of the buffer, with memeory + * addresses decreasing (backward) + * + * .---------------------------------------------------. + * | > > > > > > > > > > : : < < < < < < < < < | + * '---------------------------------------------------' + * |---------------------> - - - - - - - - - - - - - ->| + * |< - - - <-------------------| + * Arithmetic coding Plain bits + * `lc3_put_symbol()` `lc3_put_bits()` + * + * - The forward writing is protected against buffer overflow, it cannot + * write after the buffer, but can overwrite plain bits previously + * written in the buffer. + * + * - The backward writing is protected against overwrite of the arithmetic + * coder bitstream. In such way, the backward bitstream is always limited + * by the aritmetic coder bitstream, and can be overwritten by him. + * + * .---------------------------------------------------. + * | > > > > > > > > > > : : < < < < < < < < < | + * '---------------------------------------------------' + * |---------------------> - - - - - - - - - - - - - ->| + * |< - - - - - - - - - - - - - - <-------------------| + * Arithmetic coding Plain bits + * `lc3_get_symbol()` `lc3_get_bits()` + * + * - Reading is limited to read of the complementary end of the buffer. + * + * - The procedure `lc3_check_bits()` returns indication that read has been + * made crossing the other bit plane. + * + */ + +#ifndef __LC3_BITS_H +#define __LC3_BITS_H + +#include "common.h" + + +/** + * Bitstream mode + */ + +enum lc3_bits_mode { + LC3_BITS_MODE_READ, + LC3_BITS_MODE_WRITE, +}; + +/** + * Arithmetic coder symbol interval + * The model split the interval in 17 symbols + */ + +struct lc3_ac_symbol { + uint16_t low : 16; + uint16_t range : 16; +}; + +struct lc3_ac_model { + struct lc3_ac_symbol s[17]; +}; + +/** + * Bitstream context + */ + +#define LC3_ACCU_BITS (int)(8 * sizeof(unsigned)) + +struct lc3_bits_accu { + unsigned v; + int n, nover; +}; + +#define LC3_AC_BITS (int)(24) + +struct lc3_bits_ac { + unsigned low, range; + int cache, carry, carry_count; + bool error; +}; + +struct lc3_bits_buffer { + const uint8_t *start, *end; + uint8_t *p_fw, *p_bw; +}; + +typedef struct lc3_bits { + enum lc3_bits_mode mode; + struct lc3_bits_ac ac; + struct lc3_bits_accu accu; + struct lc3_bits_buffer buffer; +} lc3_bits_t; + + +/** + * Setup bitstream reading/writing + * bits Bitstream context + * mode Either READ or WRITE mode + * buffer, len Output buffer and length (in bytes) + */ +void lc3_setup_bits(lc3_bits_t *bits, + enum lc3_bits_mode mode, void *buffer, int len); + +/** + * Return number of bits left in the bitstream + * bits Bitstream context + * return Number of bits left + */ +int lc3_get_bits_left(const lc3_bits_t *bits); + +/** + * Check if error occured on bitstream reading/writing + * bits Bitstream context + * return 0: Ok -1: Bitstream overflow or AC reading error + */ +int lc3_check_bits(const lc3_bits_t *bits); + +/** + * Put a bit + * bits Bitstream context + * v Bit value, 0 or 1 + */ +static inline void lc3_put_bit(lc3_bits_t *bits, int v); + +/** + * Put from 1 to 32 bits + * bits Bitstream context + * v, n Value, in range 0 to 2^n - 1, and bits count (1 to 32) + */ +static inline void lc3_put_bits(lc3_bits_t *bits, unsigned v, int n); + +/** + * Put arithmetic coder symbol + * bits Bitstream context + * model, s Model distribution and symbol value + */ +static inline void lc3_put_symbol(lc3_bits_t *bits, + const struct lc3_ac_model *model, unsigned s); + +/** + * Flush and terminate bitstream writing + * bits Bitstream context + */ +void lc3_flush_bits(lc3_bits_t *bits); + +/** + * Get a bit + * bits Bitstream context + */ +static inline int lc3_get_bit(lc3_bits_t *bits); + +/** + * Get from 1 to 32 bits + * bits Bitstream context + * n Number of bits to read (1 to 32) + * return The value read + */ +static inline unsigned lc3_get_bits(lc3_bits_t *bits, int n); + +/** + * Get arithmetic coder symbol + * bits Bitstream context + * model Model distribution + * return The value read + */ +static inline unsigned lc3_get_symbol(lc3_bits_t *bits, + const struct lc3_ac_model *model); + + + +/* ---------------------------------------------------------------------------- + * Inline implementations + * -------------------------------------------------------------------------- */ + +void lc3_put_bits_generic(lc3_bits_t *bits, unsigned v, int n); +unsigned lc3_get_bits_generic(struct lc3_bits *bits, int n); + +void lc3_ac_read_renorm(lc3_bits_t *bits); +void lc3_ac_write_renorm(lc3_bits_t *bits); + + +/** + * Put a bit + */ +LC3_HOT static inline void lc3_put_bit(lc3_bits_t *bits, int v) +{ + lc3_put_bits(bits, v, 1); +} + +/** + * Put from 1 to 32 bits + */ +LC3_HOT static inline void lc3_put_bits( + struct lc3_bits *bits, unsigned v, int n) +{ + struct lc3_bits_accu *accu = &bits->accu; + + if (accu->n + n <= LC3_ACCU_BITS) { + accu->v |= v << accu->n; + accu->n += n; + } else { + lc3_put_bits_generic(bits, v, n); + } +} + +/** + * Get a bit + */ +LC3_HOT static inline int lc3_get_bit(lc3_bits_t *bits) +{ + return lc3_get_bits(bits, 1); +} + +/** + * Get from 1 to 32 bits + */ +LC3_HOT static inline unsigned lc3_get_bits(struct lc3_bits *bits, int n) +{ + struct lc3_bits_accu *accu = &bits->accu; + + if (accu->n + n <= LC3_ACCU_BITS) { + int v = (accu->v >> accu->n) & ((1u << n) - 1); + return (accu->n += n), v; + } + else { + return lc3_get_bits_generic(bits, n); + } +} + +/** + * Put arithmetic coder symbol + */ +LC3_HOT static inline void lc3_put_symbol( + struct lc3_bits *bits, const struct lc3_ac_model *model, unsigned s) +{ + const struct lc3_ac_symbol *symbols = model->s; + struct lc3_bits_ac *ac = &bits->ac; + unsigned range = ac->range >> 10; + + ac->low += range * symbols[s].low; + ac->range = range * symbols[s].range; + + ac->carry |= ac->low >> 24; + ac->low &= 0xffffff; + + if (ac->range < 0x10000) + lc3_ac_write_renorm(bits); +} + +/** + * Get arithmetic coder symbol + */ +LC3_HOT static inline unsigned lc3_get_symbol( + lc3_bits_t *bits, const struct lc3_ac_model *model) +{ + const struct lc3_ac_symbol *symbols = model->s; + struct lc3_bits_ac *ac = &bits->ac; + + unsigned range = (ac->range >> 10) & 0xffff; + + ac->error |= (ac->low >= (range << 10)); + if (ac->error) + ac->low = 0; + + int s = 16; + + if (ac->low < range * symbols[s].low) { + s >>= 1; + s -= ac->low < range * symbols[s].low ? 4 : -4; + s -= ac->low < range * symbols[s].low ? 2 : -2; + s -= ac->low < range * symbols[s].low ? 1 : -1; + s -= ac->low < range * symbols[s].low; + } + + ac->low -= range * symbols[s].low; + ac->range = range * symbols[s].range; + + if (ac->range < 0x10000) + lc3_ac_read_renorm(bits); + + return s; +} + +#endif /* __LC3_BITS_H */ diff --git a/App_Resources/iOS/src/lc3/bwdet.c b/App_Resources/iOS/src/lc3/bwdet.c new file mode 100644 index 00000000..0c489397 --- /dev/null +++ b/App_Resources/iOS/src/lc3/bwdet.c @@ -0,0 +1,154 @@ +/****************************************************************************** + * + * Copyright 2022 Google LLC + * + * 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 "bwdet.h" + + +/** + * Bandwidth detector + */ +enum lc3_bandwidth lc3_bwdet_run( + enum lc3_dt dt, enum lc3_srate sr, const float *e) +{ + /* Bandwidth regions */ + + struct region { int is : 8; int ie : 8; }; + +#if LC3_PLUS + + static const struct region bws_table_2m5[][LC3_BANDWIDTH_SWB+1] = { + { { 24, 34+1 } }, + { { 24, 32+1 }, { 35, 39+1 } }, + { { 24, 31+1 }, { 33, 38+1 }, { 39, 42+1 } }, + { { 22, 29+1 }, { 31, 35+1 }, { 37, 40+1 }, { 41, 43+1 } }, + }; + + static const struct region bws_table_5m[][LC3_BANDWIDTH_SWB+1] = { + { { 39, 49+1 } }, + { { 35, 44+1 }, { 47, 51+1 } }, + { { 34, 42+1 }, { 44, 49+1 }, { 50, 53+1 } }, + { { 32, 40+1 }, { 42, 46+1 }, { 48, 51+1 }, { 52, 54+1 } }, + }; + +#endif /* LC3_PLUS */ + + static const struct region bws_table_7m5[][LC3_BANDWIDTH_SWB+1] = { + { { 51, 63+1 } }, + { { 45, 55+1 }, { 58, 63+1 } }, + { { 42, 51+1 }, { 53, 58+1 }, { 60, 63+1 } }, + { { 40, 48+1 }, { 51, 55+1 }, { 57, 60+1 }, { 61, 63+1 } }, + }; + + static const struct region bws_table_10m[][LC3_BANDWIDTH_SWB+1] = { + { { 53, 63+1 } }, + { { 47, 56+1 }, { 59, 63+1 } }, + { { 44, 52+1 }, { 54, 59+1 }, { 60, 63+1 } }, + { { 41, 49+1 }, { 51, 55+1 }, { 57, 60+1 }, { 61, 63+1 } }, + }; + + static const struct region (*bws_table[])[LC3_BANDWIDTH_SWB+1] = { + [LC3_DT_2M5] = LC3_IF_PLUS(bws_table_2m5, NULL), + [LC3_DT_5M ] = LC3_IF_PLUS(bws_table_5m , NULL), + [LC3_DT_7M5] = bws_table_7m5, + [LC3_DT_10M] = bws_table_10m, + }; + + static const int l_table[LC3_NUM_DT][LC3_BANDWIDTH_SWB+1] = { + [LC3_DT_2M5] = { 4, 4, 3, 1 }, + [LC3_DT_5M ] = { 4, 4, 3, 1 }, + [LC3_DT_7M5] = { 4, 4, 3, 2 }, + [LC3_DT_10M] = { 4, 4, 3, 1 }, + }; + + /* --- Stage 1 --- + * Determine bw0 candidate */ + + enum lc3_bandwidth bw0 = LC3_BANDWIDTH_NB; + enum lc3_bandwidth bwn = (enum lc3_bandwidth)sr; + + if (bwn <= bw0 || lc3_hr(sr)) + return bwn; + + const struct region *bwr = bws_table[dt][bwn-1]; + + for (enum lc3_bandwidth bw = bw0; bw < bwn; bw++) { + int i = bwr[bw].is, ie = bwr[bw].ie; + int n = ie - i; + + float se = e[i]; + for (i++; i < ie; i++) + se += e[i]; + + if (se >= (10 << (bw == LC3_BANDWIDTH_NB)) * n) + bw0 = bw + 1; + } + + /* --- Stage 2 --- + * Detect drop above cut-off frequency. + * The Tc condition (13) is precalculated, as + * Tc[] = 10 ^ (n / 10) , n = { 15, 23, 20, 20 } */ + + int hold = bw0 >= bwn; + + if (!hold) { + int i0 = bwr[bw0].is, l = l_table[dt][bw0]; + float tc = (const float []){ + 31.62277660, 199.52623150, 100, 100 }[bw0]; + + for (int i = i0 - l + 1; !hold && i <= i0 + 1; i++) { + hold = e[i-l] > tc * e[i]; + } + + } + + return hold ? bw0 : bwn; +} + +/** + * Return number of bits coding the bandwidth value + */ +int lc3_bwdet_get_nbits(enum lc3_srate sr) +{ + return lc3_hr(sr) ? 0 : (sr > 0) + (sr > 1) + (sr > 3); +} + +/** + * Put bandwidth indication + */ +void lc3_bwdet_put_bw(lc3_bits_t *bits, + enum lc3_srate sr, enum lc3_bandwidth bw) +{ + int nbits_bw = lc3_bwdet_get_nbits(sr); + if (nbits_bw > 0) + lc3_put_bits(bits, bw, nbits_bw); +} + +/** + * Get bandwidth indication + */ +int lc3_bwdet_get_bw(lc3_bits_t *bits, + enum lc3_srate sr, enum lc3_bandwidth *bw) +{ + enum lc3_bandwidth max_bw = (enum lc3_bandwidth)sr; + int nbits_bw = lc3_bwdet_get_nbits(sr); + + *bw = nbits_bw <= 0 ? max_bw : + (enum lc3_bandwidth)lc3_get_bits(bits, nbits_bw); + + return *bw > max_bw ? (*bw = max_bw), -1 : 0; +} diff --git a/App_Resources/iOS/src/lc3/bwdet.h b/App_Resources/iOS/src/lc3/bwdet.h new file mode 100644 index 00000000..773e6bb6 --- /dev/null +++ b/App_Resources/iOS/src/lc3/bwdet.h @@ -0,0 +1,62 @@ +/****************************************************************************** + * + * Copyright 2022 Google LLC + * + * 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. + * + ******************************************************************************/ + +#ifndef __LC3_BWDET_H +#define __LC3_BWDET_H + +#include "common.h" +#include "bits.h" + + +/** + * Bandwidth detector + * dt, sr Duration and samplerate of the frame + * e Energy estimation per bands + * return Return detected bandwitdth + */ +enum lc3_bandwidth lc3_bwdet_run( + enum lc3_dt dt, enum lc3_srate sr, const float *e); + +/** + * Return number of bits coding the bandwidth value + * sr Samplerate of the frame + * return Number of bits coding the bandwidth value + */ +int lc3_bwdet_get_nbits(enum lc3_srate sr); + +/** + * Put bandwidth indication + * bits Bitstream context + * sr Samplerate of the frame + * bw Bandwidth detected + */ +void lc3_bwdet_put_bw(lc3_bits_t *bits, + enum lc3_srate sr, enum lc3_bandwidth bw); + +/** + * Get bandwidth indication + * bits Bitstream context + * sr Samplerate of the frame + * bw Return bandwidth indication + * return 0: Ok -1: Invalid bandwidth indication + */ +int lc3_bwdet_get_bw(lc3_bits_t *bits, + enum lc3_srate sr, enum lc3_bandwidth *bw); + + +#endif /* __LC3_BWDET_H */ diff --git a/App_Resources/iOS/src/lc3/common.h b/App_Resources/iOS/src/lc3/common.h new file mode 100644 index 00000000..2b23a8d3 --- /dev/null +++ b/App_Resources/iOS/src/lc3/common.h @@ -0,0 +1,142 @@ +/****************************************************************************** + * + * Copyright 2022 Google LLC + * + * 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. + * + ******************************************************************************/ + +#ifndef __LC3_COMMON_H +#define __LC3_COMMON_H + +#include +#include "fastmath.h" + +#include +#include +#include + +#ifdef __ARM_ARCH +#include +#endif + + +/** + * Acivation flags for LC3-Plus and LC3-Plus HR features + */ + +#ifndef LC3_PLUS +#define LC3_PLUS 1 +#endif + +#ifndef LC3_PLUS_HR +#define LC3_PLUS_HR 1 +#endif + +#if LC3_PLUS +#define LC3_IF_PLUS(a, b) (a) +#else +#define LC3_IF_PLUS(a, b) (b) +#endif + +#if LC3_PLUS_HR +#define LC3_IF_PLUS_HR(a, b) (a) +#else +#define LC3_IF_PLUS_HR(a, b) (b) +#endif + + +/** + * Hot Function attribute + * Selectively disable sanitizer + */ + +#ifdef __clang__ + +#define LC3_HOT \ + __attribute__((no_sanitize("bounds"))) \ + __attribute__((no_sanitize("integer"))) + +#else /* __clang__ */ + +#define LC3_HOT + +#endif /* __clang__ */ + + +/** + * Macros + * MIN/MAX Minimum and maximum between 2 values + * CLIP Clip a value between low and high limits + * SATXX Signed saturation on 'xx' bits + * ABS Return absolute value + */ + +#define LC3_MIN(a, b) ( (a) < (b) ? (a) : (b) ) +#define LC3_MAX(a, b) ( (a) > (b) ? (a) : (b) ) + +#define LC3_CLIP(v, min, max) LC3_MIN(LC3_MAX(v, min), max) +#define LC3_SAT16(v) LC3_CLIP(v, -(1 << 15), (1 << 15) - 1) +#define LC3_SAT24(v) LC3_CLIP(v, -(1 << 23), (1 << 23) - 1) + +#define LC3_ABS(v) ( (v) < 0 ? -(v) : (v) ) + + +#if defined(__ARM_FEATURE_SAT) && !(__GNUC__ < 10) + +#undef LC3_SAT16 +#define LC3_SAT16(v) __ssat(v, 16) + +#undef LC3_SAT24 +#define LC3_SAT24(v) __ssat(v, 24) + +#endif /* __ARM_FEATURE_SAT */ + + +/** + * Return `true` when high-resolution mode + */ +static inline bool lc3_hr(enum lc3_srate sr) { + return LC3_PLUS_HR && (sr >= LC3_SRATE_48K_HR); +} + + +/** + * Bandwidth, mapped to Nyquist frequency of samplerates + */ + +enum lc3_bandwidth { + LC3_BANDWIDTH_NB = LC3_SRATE_8K, + LC3_BANDWIDTH_WB = LC3_SRATE_16K, + LC3_BANDWIDTH_SSWB = LC3_SRATE_24K, + LC3_BANDWIDTH_SWB = LC3_SRATE_32K, + LC3_BANDWIDTH_FB = LC3_SRATE_48K, + + LC3_BANDWIDTH_FB_HR = LC3_SRATE_48K_HR, + LC3_BANDWIDTH_UB_HR = LC3_SRATE_96K_HR, + + LC3_NUM_BANDWIDTH, +}; + + +/** + * Complex floating point number + */ + +struct lc3_complex +{ + float re, im; +}; + + +#endif /* __LC3_COMMON_H */ diff --git a/App_Resources/iOS/src/lc3/energy.c b/App_Resources/iOS/src/lc3/energy.c new file mode 100644 index 00000000..ffa3f786 --- /dev/null +++ b/App_Resources/iOS/src/lc3/energy.c @@ -0,0 +1,54 @@ +/****************************************************************************** + * + * Copyright 2022 Google LLC + * + * 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 "energy.h" +#include "tables.h" + + +/** + * Energy estimation per band + */ +bool lc3_energy_compute( + enum lc3_dt dt, enum lc3_srate sr, const float *x, float *e) +{ + int nb = lc3_num_bands[dt][sr]; + const int *lim = lc3_band_lim[dt][sr]; + + /* Mean the square of coefficients within each band */ + + float e_sum[2] = { 0, 0 }; + int iband_h = nb - (const int []){ + [LC3_DT_2M5] = 2, [LC3_DT_5M ] = 3, + [LC3_DT_7M5] = 4, [LC3_DT_10M] = 2 }[dt]; + + for (int iband = 0, i = lim[iband]; iband < nb; iband++) { + int ie = lim[iband+1]; + int n = ie - i; + + float sx2 = x[i] * x[i]; + for (i++; i < ie; i++) + sx2 += x[i] * x[i]; + + *e = sx2 / n; + e_sum[iband >= iband_h] += *(e++); + } + + /* Return the near nyquist flag */ + + return e_sum[1] > 30 * e_sum[0]; +} diff --git a/App_Resources/iOS/src/lc3/energy.h b/App_Resources/iOS/src/lc3/energy.h new file mode 100644 index 00000000..8ebd726b --- /dev/null +++ b/App_Resources/iOS/src/lc3/energy.h @@ -0,0 +1,36 @@ +/****************************************************************************** + * + * Copyright 2022 Google LLC + * + * 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. + * + ******************************************************************************/ + +#ifndef __LC3_ENERGY_H +#define __LC3_ENERGY_H + +#include "common.h" + + +/** + * Energy estimation per band + * dt, sr Duration and samplerate of the frame + * x Input MDCT coefficient + * e Energy estimation per bands + * return True when high energy detected near Nyquist frequency + */ +bool lc3_energy_compute( + enum lc3_dt dt, enum lc3_srate sr, const float *x, float *e); + + +#endif /* __LC3_ENERGY_H */ diff --git a/App_Resources/iOS/src/lc3/fastmath.h b/App_Resources/iOS/src/lc3/fastmath.h new file mode 100644 index 00000000..86cbdfa2 --- /dev/null +++ b/App_Resources/iOS/src/lc3/fastmath.h @@ -0,0 +1,219 @@ +/****************************************************************************** + * + * Copyright 2022 Google LLC + * + * 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. + * + ******************************************************************************/ + +#ifndef __LC3_FASTMATH_H +#define __LC3_FASTMATH_H + +#include +#include +#include + + +/** + * IEEE 754 Floating point representation + */ + +#define LC3_IEEE754_SIGN_SHL (31) +#define LC3_IEEE754_SIGN_MASK (1 << LC3_IEEE754_SIGN_SHL) + +#define LC3_IEEE754_EXP_SHL (23) +#define LC3_IEEE754_EXP_MASK (0xff << LC3_IEEE754_EXP_SHL) +#define LC3_IEEE754_EXP_BIAS (127) + + +/** + * Fast multiply floating-point number by integral power of 2 + * x Operand, finite number + * exp Exponent such that 2^x is finite + * return 2^exp + */ +static inline float lc3_ldexpf(float _x, int exp) { + union { float f; int32_t s; } x = { .f = _x }; + + if (x.s & LC3_IEEE754_EXP_MASK) + x.s += exp << LC3_IEEE754_EXP_SHL; + + return x.f; +} + +/** + * Fast convert floating-point number to fractional and integral components + * x Operand, finite number + * exp Return the exponent part + * return The normalized fraction in [0.5:1[ + */ +static inline float lc3_frexpf(float _x, int *exp) { + union { float f; uint32_t u; } x = { .f = _x }; + + int e = (x.u & LC3_IEEE754_EXP_MASK) >> LC3_IEEE754_EXP_SHL; + *exp = e - (LC3_IEEE754_EXP_BIAS - 1); + + x.u = (x.u & ~LC3_IEEE754_EXP_MASK) | + ((LC3_IEEE754_EXP_BIAS - 1) << LC3_IEEE754_EXP_SHL); + + return x.f; +} + +/** + * Fast 2^n approximation + * x Operand, range -100 to 100 + * return 2^x approximation (max relative error ~ 4e-7) + */ +static inline float lc3_exp2f(float x) +{ + /* --- 2^(i/8) for i from 0 to 7 --- */ + + static const float e[] = { + 1.00000000e+00, 1.09050773e+00, 1.18920712e+00, 1.29683955e+00, + 1.41421356e+00, 1.54221083e+00, 1.68179283e+00, 1.83400809e+00 }; + + /* --- Polynomial approx in range 0 to 1/8 --- */ + + static const float p[] = { + 1.00448128e-02, 5.54563260e-02, 2.40228756e-01, 6.93147140e-01 }; + + /* --- Split the operand --- + * + * Such as x = k/8 + y, with k an integer, and |y| < 0.5/8 + * + * Note that `fast-math` compiler option leads to rounding error, + * disable optimisation with `volatile`. */ + + volatile union { float f; int32_t s; } v; + + v.f = x + 0x1.8p20f; + int k = v.s; + x -= v.f - 0x1.8p20f; + + /* --- Compute 2^x, with |x| < 1 --- + * Perform polynomial approximation in range -0.5/8 to 0.5/8, + * and muplity by precomputed value of 2^(i/8), i in [0:7] */ + + union { float f; int32_t s; } y; + + y.f = ( p[0]) * x; + y.f = (y.f + p[1]) * x; + y.f = (y.f + p[2]) * x; + y.f = (y.f + p[3]) * x; + y.f = (y.f + 1.f) * e[k & 7]; + + /* --- Add the exponent --- */ + + y.s += (k >> 3) << LC3_IEEE754_EXP_SHL; + + return y.f; +} + +/** + * Fast log2(x) approximation + * x Operand, greater than 0 + * return log2(x) approximation (max absolute error ~ 1e-4) + */ +static inline float lc3_log2f(float x) +{ + float y; + int e; + + /* --- Polynomial approx in range 0.5 to 1 --- */ + + static const float c[] = { + -1.29479677, 5.11769018, -8.42295281, 8.10557963, -3.50567360 }; + + x = lc3_frexpf(x, &e); + + y = ( c[0]) * x; + y = (y + c[1]) * x; + y = (y + c[2]) * x; + y = (y + c[3]) * x; + y = (y + c[4]); + + /* --- Add log2f(2^e) and return --- */ + + return e + y; +} + +/** + * Fast log10(x) approximation + * x Operand, greater than 0 + * return log10(x) approximation (max absolute error ~ 1e-4) + */ +static inline float lc3_log10f(float x) +{ + return log10f(2) * lc3_log2f(x); +} + +/** + * Fast `10 * log10(x)` (or dB) approximation in fixed Q16 + * x Operand, in range 2^-63 to 2^63 (1e-19 to 1e19) + * return 10 * log10(x) in fixed Q16 (-190 to 192 dB) + * + * - The 0 value is accepted and return the minimum value ~ -191dB + * - This function assumed that float 32 bits is coded IEEE 754 + */ +static inline int32_t lc3_db_q16(float x) +{ + /* --- Table in Q15 --- */ + + static const uint16_t t[][2] = { + + /* [n][0] = 10 * log10(2) * log2(1 + n/32), with n = [0..15] */ + /* [n][1] = [n+1][0] - [n][0] (while defining [16][0]) */ + + { 0, 4379 }, { 4379, 4248 }, { 8627, 4125 }, { 12753, 4009 }, + { 16762, 3899 }, { 20661, 3795 }, { 24456, 3697 }, { 28153, 3603 }, + { 31755, 3514 }, { 35269, 3429 }, { 38699, 3349 }, { 42047, 3272 }, + { 45319, 3198 }, { 48517, 3128 }, { 51645, 3061 }, { 54705, 2996 }, + + /* [n][0] = 10 * log10(2) * log2(1 + n/32) - 10 * log10(2) / 2, */ + /* with n = [16..31] */ + /* [n][1] = [n+1][0] - [n][0] (while defining [32][0]) */ + + { 8381, 2934 }, { 11315, 2875 }, { 14190, 2818 }, { 17008, 2763 }, + { 19772, 2711 }, { 22482, 2660 }, { 25142, 2611 }, { 27754, 2564 }, + { 30318, 2519 }, { 32837, 2475 }, { 35312, 2433 }, { 37744, 2392 }, + { 40136, 2352 }, { 42489, 2314 }, { 44803, 2277 }, { 47080, 2241 }, + + }; + + /* --- Approximation --- + * + * 10 * log10(x^2) = 10 * log10(2) * log2(x^2) + * + * And log2(x^2) = 2 * log2( (1 + m) * 2^e ) + * = 2 * (e + log2(1 + m)) , with m in range [0..1] + * + * Split the float values in : + * e2 Double value of the exponent (2 * e + k) + * hi High 5 bits of mantissa, for precalculated result `t[hi][0]` + * lo Low 16 bits of mantissa, for linear interpolation `t[hi][1]` + * + * Two cases, from the range of the mantissa : + * 0 to 0.5 `k = 0`, use 1st part of the table + * 0.5 to 1 `k = 1`, use 2nd part of the table */ + + union { float f; uint32_t u; } x2 = { .f = x*x }; + + int e2 = (int)(x2.u >> 22) - 2*127; + int hi = (x2.u >> 18) & 0x1f; + int lo = (x2.u >> 2) & 0xffff; + + return e2 * 49321 + t[hi][0] + ((t[hi][1] * lo) >> 16); +} + + +#endif /* __LC3_FASTMATH_H */ diff --git a/App_Resources/iOS/src/lc3/lc3.c b/App_Resources/iOS/src/lc3/lc3.c new file mode 100644 index 00000000..ac4427a1 --- /dev/null +++ b/App_Resources/iOS/src/lc3/lc3.c @@ -0,0 +1,766 @@ +/****************************************************************************** + * + * Copyright 2022 Google LLC + * + * 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 "common.h" +#include "bits.h" + +#include "attdet.h" +#include "bwdet.h" +#include "ltpf.h" +#include "mdct.h" +#include "energy.h" +#include "sns.h" +#include "tns.h" +#include "spec.h" +#include "plc.h" + + +/** + * Frame side data + */ + +struct side_data { + enum lc3_bandwidth bw; + bool pitch_present; + lc3_ltpf_data_t ltpf; + lc3_sns_data_t sns; + lc3_tns_data_t tns; + lc3_spec_side_t spec; +}; + + +/* ---------------------------------------------------------------------------- + * General + * -------------------------------------------------------------------------- */ + +/** + * Resolve frame duration in us + * us Frame duration in us + * hrmode High-resolution mode indication + * return Frame duration identifier, or LC3_NUM_DT + */ +static enum lc3_dt resolve_dt(int us, bool hrmode) +{ + return LC3_PLUS && us == 2500 ? LC3_DT_2M5 : + LC3_PLUS && us == 5000 ? LC3_DT_5M : + !hrmode && us == 7500 ? LC3_DT_7M5 : + us == 10000 ? LC3_DT_10M : LC3_NUM_DT; +} + +/** + * Resolve samplerate in Hz + * hz Samplerate in Hz + * hrmode High-resolution mode indication + * return Sample rate identifier, or LC3_NUM_SRATE + */ +static enum lc3_srate resolve_srate(int hz, bool hrmode) +{ + hrmode = LC3_PLUS_HR && hrmode; + + return !hrmode && hz == 8000 ? LC3_SRATE_8K : + !hrmode && hz == 16000 ? LC3_SRATE_16K : + !hrmode && hz == 24000 ? LC3_SRATE_24K : + !hrmode && hz == 32000 ? LC3_SRATE_32K : + !hrmode && hz == 48000 ? LC3_SRATE_48K : + hrmode && hz == 48000 ? LC3_SRATE_48K_HR : + hrmode && hz == 96000 ? LC3_SRATE_96K_HR : LC3_NUM_SRATE; +} + +/** + * Return the number of PCM samples in a frame + */ +LC3_EXPORT int lc3_hr_frame_samples(bool hrmode, int dt_us, int sr_hz) +{ + enum lc3_dt dt = resolve_dt(dt_us, hrmode); + enum lc3_srate sr = resolve_srate(sr_hz, hrmode); + + if (dt >= LC3_NUM_DT || sr >= LC3_NUM_SRATE) + return -1; + + return lc3_ns(dt, sr); +} + +LC3_EXPORT int lc3_frame_samples(int dt_us, int sr_hz) +{ + return lc3_hr_frame_samples(false, dt_us, sr_hz); +} + +/** + * Return the size of frames or frame blocks, from bitrate + */ +LC3_EXPORT int lc3_hr_frame_block_bytes( + bool hrmode, int dt_us, int sr_hz, int nchannels, int bitrate) +{ + enum lc3_dt dt = resolve_dt(dt_us, hrmode); + enum lc3_srate sr = resolve_srate(sr_hz, hrmode); + + if (dt >= LC3_NUM_DT || sr >= LC3_NUM_SRATE + || nchannels < 1 || nchannels > 8 || bitrate < 0) + return -1; + + bitrate = LC3_CLIP(bitrate, 0, 8*LC3_HR_MAX_BITRATE); + + return LC3_CLIP((bitrate * (int)(1 + dt)) / 3200, + nchannels * lc3_min_frame_bytes(dt, sr), + nchannels * lc3_max_frame_bytes(dt, sr) ); +} + +LC3_EXPORT int lc3_frame_bock_bytes(int dt_us, int nchannels, int bitrate) +{ + return lc3_hr_frame_block_bytes(false, dt_us, 8000, nchannels, bitrate); +} + +LC3_EXPORT int lc3_hr_frame_bytes( + bool hrmode, int dt_us, int sr_hz, int bitrate) +{ + return lc3_hr_frame_block_bytes(hrmode, dt_us, sr_hz, 1, bitrate); +} + +LC3_EXPORT int lc3_frame_bytes(int dt_us, int bitrate) +{ + return lc3_hr_frame_bytes(false, dt_us, 8000, bitrate); +} + +/** + * Resolve the bitrate, from the size of frames or frame blocks + */ +LC3_EXPORT int lc3_hr_resolve_bitrate( + bool hrmode, int dt_us, int sr_hz, int nbytes) +{ + enum lc3_dt dt = resolve_dt(dt_us, hrmode); + enum lc3_srate sr = resolve_srate(sr_hz, hrmode); + + if (dt >= LC3_NUM_DT || sr >= LC3_NUM_SRATE || nbytes < 0) + return -1; + + return LC3_MIN(((int64_t)nbytes * 3200 + dt) / (1 + dt), INT_MAX); +} + +LC3_EXPORT int lc3_resolve_bitrate(int dt_us, int nbytes) +{ + return lc3_hr_resolve_bitrate(false, dt_us, 8000, nbytes); +} + +/** + * Return algorithmic delay, as a number of samples + */ +LC3_EXPORT int lc3_hr_delay_samples(bool hrmode, int dt_us, int sr_hz) +{ + enum lc3_dt dt = resolve_dt(dt_us, hrmode); + enum lc3_srate sr = resolve_srate(sr_hz, hrmode); + + if (dt >= LC3_NUM_DT || sr >= LC3_NUM_SRATE) + return -1; + + return 2 * lc3_nd(dt, sr) - lc3_ns(dt, sr); +} + +LC3_EXPORT int lc3_delay_samples(int dt_us, int sr_hz) +{ + return lc3_hr_delay_samples(false, dt_us, sr_hz); +} + + +/* ---------------------------------------------------------------------------- + * Encoder + * -------------------------------------------------------------------------- */ + +/** + * Input PCM Samples from signed 16 bits + * encoder Encoder state + * pcm, stride Input PCM samples, and count between two consecutives + */ +static void load_s16( + struct lc3_encoder *encoder, const void *_pcm, int stride) +{ + const int16_t *pcm = _pcm; + + enum lc3_dt dt = encoder->dt; + enum lc3_srate sr = encoder->sr_pcm; + + int16_t *xt = (int16_t *)encoder->x + encoder->xt_off; + float *xs = encoder->x + encoder->xs_off; + int ns = lc3_ns(dt, sr); + + for (int i = 0; i < ns; i++, pcm += stride) + xt[i] = *pcm, xs[i] = *pcm; +} + +/** + * Input PCM Samples from signed 24 bits + * encoder Encoder state + * pcm, stride Input PCM samples, and count between two consecutives + */ +static void load_s24( + struct lc3_encoder *encoder, const void *_pcm, int stride) +{ + const int32_t *pcm = _pcm; + + enum lc3_dt dt = encoder->dt; + enum lc3_srate sr = encoder->sr_pcm; + + int16_t *xt = (int16_t *)encoder->x + encoder->xt_off; + float *xs = encoder->x + encoder->xs_off; + int ns = lc3_ns(dt, sr); + + for (int i = 0; i < ns; i++, pcm += stride) { + xt[i] = *pcm >> 8; + xs[i] = lc3_ldexpf(*pcm, -8); + } +} + +/** + * Input PCM Samples from signed 24 bits packed + * encoder Encoder state + * pcm, stride Input PCM samples, and count between two consecutives + */ +static void load_s24_3le( + struct lc3_encoder *encoder, const void *_pcm, int stride) +{ + const uint8_t *pcm = _pcm; + + enum lc3_dt dt = encoder->dt; + enum lc3_srate sr = encoder->sr_pcm; + + int16_t *xt = (int16_t *)encoder->x + encoder->xt_off; + float *xs = encoder->x + encoder->xs_off; + int ns = lc3_ns(dt, sr); + + for (int i = 0; i < ns; i++, pcm += 3*stride) { + int32_t in = ((uint32_t)pcm[0] << 8) | + ((uint32_t)pcm[1] << 16) | + ((uint32_t)pcm[2] << 24) ; + + xt[i] = in >> 16; + xs[i] = lc3_ldexpf(in, -16); + } +} + +/** + * Input PCM Samples from float 32 bits + * encoder Encoder state + * pcm, stride Input PCM samples, and count between two consecutives + */ +static void load_float( + struct lc3_encoder *encoder, const void *_pcm, int stride) +{ + const float *pcm = _pcm; + + enum lc3_dt dt = encoder->dt; + enum lc3_srate sr = encoder->sr_pcm; + + int16_t *xt = (int16_t *)encoder->x + encoder->xt_off; + float *xs = encoder->x + encoder->xs_off; + int ns = lc3_ns(dt, sr); + + for (int i = 0; i < ns; i++, pcm += stride) { + xs[i] = lc3_ldexpf(*pcm, 15); + xt[i] = LC3_SAT16((int32_t)xs[i]); + } +} + +/** + * Frame Analysis + * encoder Encoder state + * nbytes Size in bytes of the frame + * side Return frame data + */ +static void analyze(struct lc3_encoder *encoder, + int nbytes, struct side_data *side) +{ + enum lc3_dt dt = encoder->dt; + enum lc3_srate sr = encoder->sr; + enum lc3_srate sr_pcm = encoder->sr_pcm; + + int16_t *xt = (int16_t *)encoder->x + encoder->xt_off; + float *xs = encoder->x + encoder->xs_off; + int ns = lc3_ns(dt, sr_pcm); + int nt = lc3_nt(sr_pcm); + + float *xd = encoder->x + encoder->xd_off; + float *xf = xs; + + /* --- Temporal --- */ + + bool att = lc3_attdet_run(dt, sr_pcm, nbytes, &encoder->attdet, xt); + + side->pitch_present = + lc3_ltpf_analyse(dt, sr_pcm, &encoder->ltpf, xt, &side->ltpf); + + memmove(xt - nt, xt + (ns-nt), nt * sizeof(*xt)); + + /* --- Spectral --- */ + + float e[LC3_MAX_BANDS]; + + lc3_mdct_forward(dt, sr_pcm, sr, xs, xd, xf); + + bool nn_flag = lc3_energy_compute(dt, sr, xf, e); + if (nn_flag) + lc3_ltpf_disable(&side->ltpf); + + side->bw = lc3_bwdet_run(dt, sr, e); + + lc3_sns_analyze(dt, sr, nbytes, e, att, &side->sns, xf, xf); + + lc3_tns_analyze(dt, side->bw, nn_flag, nbytes, &side->tns, xf); + + lc3_spec_analyze(dt, sr, + nbytes, side->pitch_present, &side->tns, + &encoder->spec, xf, &side->spec); +} + +/** + * Encode bitstream + * encoder Encoder state + * side The frame data + * nbytes Target size of the frame (20 to 400) + * buffer Output bitstream buffer of `nbytes` size + */ +static void encode(struct lc3_encoder *encoder, + const struct side_data *side, int nbytes, void *buffer) +{ + enum lc3_dt dt = encoder->dt; + enum lc3_srate sr = encoder->sr; + + float *xf = encoder->x + encoder->xs_off; + enum lc3_bandwidth bw = side->bw; + + lc3_bits_t bits; + + lc3_setup_bits(&bits, LC3_BITS_MODE_WRITE, buffer, nbytes); + + lc3_bwdet_put_bw(&bits, sr, bw); + + lc3_spec_put_side(&bits, dt, sr, &side->spec); + + lc3_tns_put_data(&bits, &side->tns); + + lc3_put_bit(&bits, side->pitch_present); + + lc3_sns_put_data(&bits, &side->sns); + + if (side->pitch_present) + lc3_ltpf_put_data(&bits, &side->ltpf); + + lc3_spec_encode(&bits, dt, sr, bw, nbytes, &side->spec, xf); + + lc3_flush_bits(&bits); +} + +/** + * Return size needed for an encoder + */ +LC3_EXPORT unsigned lc3_hr_encoder_size(bool hrmode, int dt_us, int sr_hz) +{ + if (resolve_dt(dt_us, hrmode) >= LC3_NUM_DT || + resolve_srate(sr_hz, hrmode) >= LC3_NUM_SRATE) + return 0; + + return sizeof(struct lc3_encoder) + + (LC3_ENCODER_BUFFER_COUNT(dt_us, sr_hz)-1) * sizeof(float); +} + +LC3_EXPORT unsigned lc3_encoder_size(int dt_us, int sr_hz) +{ + return lc3_hr_encoder_size(false, dt_us, sr_hz); +} + +/** + * Setup encoder + */ +LC3_EXPORT struct lc3_encoder *lc3_hr_setup_encoder( + bool hrmode, int dt_us, int sr_hz, int sr_pcm_hz, void *mem) +{ + if (sr_pcm_hz <= 0) + sr_pcm_hz = sr_hz; + + enum lc3_dt dt = resolve_dt(dt_us, hrmode); + enum lc3_srate sr = resolve_srate(sr_hz, hrmode); + enum lc3_srate sr_pcm = resolve_srate(sr_pcm_hz, hrmode); + + if (dt >= LC3_NUM_DT || sr_pcm >= LC3_NUM_SRATE || sr > sr_pcm || !mem) + return NULL; + + struct lc3_encoder *encoder = mem; + int ns = lc3_ns(dt, sr_pcm); + int nt = lc3_nt(sr_pcm); + + *encoder = (struct lc3_encoder){ + .dt = dt, .sr = sr, + .sr_pcm = sr_pcm, + + .xt_off = nt, + .xs_off = (nt + ns) / 2, + .xd_off = (nt + ns) / 2 + ns, + }; + + memset(encoder->x, 0, + LC3_ENCODER_BUFFER_COUNT(dt_us, sr_pcm_hz) * sizeof(float)); + + return encoder; +} + +LC3_EXPORT struct lc3_encoder *lc3_setup_encoder( + int dt_us, int sr_hz, int sr_pcm_hz, void *mem) +{ + return lc3_hr_setup_encoder(false, dt_us, sr_hz, sr_pcm_hz, mem); +} + +/** + * Encode a frame + */ +LC3_EXPORT int lc3_encode(struct lc3_encoder *encoder, + enum lc3_pcm_format fmt, const void *pcm, int stride, int nbytes, void *out) +{ + static void (* const load[])(struct lc3_encoder *, const void *, int) = { + [LC3_PCM_FORMAT_S16 ] = load_s16, + [LC3_PCM_FORMAT_S24 ] = load_s24, + [LC3_PCM_FORMAT_S24_3LE] = load_s24_3le, + [LC3_PCM_FORMAT_FLOAT ] = load_float, + }; + + /* --- Check parameters --- */ + + if (!encoder || nbytes < lc3_min_frame_bytes(encoder->dt, encoder->sr) + || nbytes > lc3_max_frame_bytes(encoder->dt, encoder->sr)) + return -1; + + /* --- Processing --- */ + + struct side_data side; + + load[fmt](encoder, pcm, stride); + + analyze(encoder, nbytes, &side); + + encode(encoder, &side, nbytes, out); + + return 0; +} + + +/* ---------------------------------------------------------------------------- + * Decoder + * -------------------------------------------------------------------------- */ + +/** + * Output PCM Samples to signed 16 bits + * decoder Decoder state + * pcm, stride Output PCM samples, and count between two consecutives + */ +static void store_s16( + struct lc3_decoder *decoder, void *_pcm, int stride) +{ + int16_t *pcm = _pcm; + + enum lc3_dt dt = decoder->dt; + enum lc3_srate sr = decoder->sr_pcm; + + float *xs = decoder->x + decoder->xs_off; + int ns = lc3_ns(dt, sr); + + for ( ; ns > 0; ns--, xs++, pcm += stride) { + int32_t s = *xs >= 0 ? (int)(*xs + 0.5f) : (int)(*xs - 0.5f); + *pcm = LC3_SAT16(s); + } +} + +/** + * Output PCM Samples to signed 24 bits + * decoder Decoder state + * pcm, stride Output PCM samples, and count between two consecutives + */ +static void store_s24( + struct lc3_decoder *decoder, void *_pcm, int stride) +{ + int32_t *pcm = _pcm; + + enum lc3_dt dt = decoder->dt; + enum lc3_srate sr = decoder->sr_pcm; + + float *xs = decoder->x + decoder->xs_off; + int ns = lc3_ns(dt, sr); + + for ( ; ns > 0; ns--, xs++, pcm += stride) { + int32_t s = *xs >= 0 ? (int32_t)(lc3_ldexpf(*xs, 8) + 0.5f) + : (int32_t)(lc3_ldexpf(*xs, 8) - 0.5f); + *pcm = LC3_SAT24(s); + } +} + +/** + * Output PCM Samples to signed 24 bits packed + * decoder Decoder state + * pcm, stride Output PCM samples, and count between two consecutives + */ +static void store_s24_3le( + struct lc3_decoder *decoder, void *_pcm, int stride) +{ + uint8_t *pcm = _pcm; + + enum lc3_dt dt = decoder->dt; + enum lc3_srate sr = decoder->sr_pcm; + + float *xs = decoder->x + decoder->xs_off; + int ns = lc3_ns(dt, sr); + + for ( ; ns > 0; ns--, xs++, pcm += 3*stride) { + int32_t s = *xs >= 0 ? (int32_t)(lc3_ldexpf(*xs, 8) + 0.5f) + : (int32_t)(lc3_ldexpf(*xs, 8) - 0.5f); + + s = LC3_SAT24(s); + pcm[0] = (s >> 0) & 0xff; + pcm[1] = (s >> 8) & 0xff; + pcm[2] = (s >> 16) & 0xff; + } +} + +/** + * Output PCM Samples to float 32 bits + * decoder Decoder state + * pcm, stride Output PCM samples, and count between two consecutives + */ +static void store_float( + struct lc3_decoder *decoder, void *_pcm, int stride) +{ + float *pcm = _pcm; + + enum lc3_dt dt = decoder->dt; + enum lc3_srate sr = decoder->sr_pcm; + + float *xs = decoder->x + decoder->xs_off; + int ns = lc3_ns(dt, sr); + + for ( ; ns > 0; ns--, xs++, pcm += stride) { + float s = lc3_ldexpf(*xs, -15); + *pcm = fminf(fmaxf(s, -1.f), 1.f); + } +} + +/** + * Decode bitstream + * decoder Decoder state + * data, nbytes Input bitstream buffer + * side Return the side data + * return 0: Ok < 0: Bitsream error detected + */ +static int decode(struct lc3_decoder *decoder, + const void *data, int nbytes, struct side_data *side) +{ + enum lc3_dt dt = decoder->dt; + enum lc3_srate sr = decoder->sr; + + float *xf = decoder->x + decoder->xs_off; + int ns = lc3_ns(dt, sr); + int ne = lc3_ne(dt, sr); + + lc3_bits_t bits; + int ret = 0; + + lc3_setup_bits(&bits, LC3_BITS_MODE_READ, (void *)data, nbytes); + + if ((ret = lc3_bwdet_get_bw(&bits, sr, &side->bw)) < 0) + return ret; + + if ((ret = lc3_spec_get_side(&bits, dt, sr, &side->spec)) < 0) + return ret; + + if ((ret = lc3_tns_get_data(&bits, dt, side->bw, nbytes, &side->tns)) < 0) + return ret; + + side->pitch_present = lc3_get_bit(&bits); + + if ((ret = lc3_sns_get_data(&bits, &side->sns)) < 0) + return ret; + + if (side->pitch_present) + lc3_ltpf_get_data(&bits, &side->ltpf); + + if ((ret = lc3_spec_decode(&bits, dt, sr, + side->bw, nbytes, &side->spec, xf)) < 0) + return ret; + + memset(xf + ne, 0, (ns - ne) * sizeof(float)); + + return lc3_check_bits(&bits); +} + +/** + * Frame synthesis + * decoder Decoder state + * side Frame data, NULL performs PLC + * nbytes Size in bytes of the frame + */ +static void synthesize(struct lc3_decoder *decoder, + const struct side_data *side, int nbytes) +{ + enum lc3_dt dt = decoder->dt; + enum lc3_srate sr = decoder->sr; + enum lc3_srate sr_pcm = decoder->sr_pcm; + + float *xf = decoder->x + decoder->xs_off; + int ns = lc3_ns(dt, sr_pcm); + int ne = lc3_ne(dt, sr); + + float *xg = decoder->x + decoder->xg_off; + float *xs = xf; + + float *xd = decoder->x + decoder->xd_off; + float *xh = decoder->x + decoder->xh_off; + + if (side) { + enum lc3_bandwidth bw = side->bw; + + lc3_plc_suspend(&decoder->plc); + + lc3_tns_synthesize(dt, bw, &side->tns, xf); + + lc3_sns_synthesize(dt, sr, &side->sns, xf, xg); + + lc3_mdct_inverse(dt, sr_pcm, sr, xg, xd, xs); + + } else { + lc3_plc_synthesize(dt, sr, &decoder->plc, xg, xf); + + memset(xf + ne, 0, (ns - ne) * sizeof(float)); + + lc3_mdct_inverse(dt, sr_pcm, sr, xf, xd, xs); + } + + if (!lc3_hr(sr)) + lc3_ltpf_synthesize(dt, sr_pcm, nbytes, &decoder->ltpf, + side && side->pitch_present ? &side->ltpf : NULL, xh, xs); +} + +/** + * Update decoder state on decoding completion + * decoder Decoder state + */ +static void complete(struct lc3_decoder *decoder) +{ + enum lc3_dt dt = decoder->dt; + enum lc3_srate sr_pcm = decoder->sr_pcm; + int nh = lc3_nh(dt, sr_pcm); + int ns = lc3_ns(dt, sr_pcm); + + decoder->xs_off = decoder->xs_off - decoder->xh_off < nh ? + decoder->xs_off + ns : decoder->xh_off; +} + +/** + * Return size needed for a decoder + */ +LC3_EXPORT unsigned lc3_hr_decoder_size(bool hrmode, int dt_us, int sr_hz) +{ + if (resolve_dt(dt_us, hrmode) >= LC3_NUM_DT || + resolve_srate(sr_hz, hrmode) >= LC3_NUM_SRATE) + return 0; + + return sizeof(struct lc3_decoder) + + (LC3_DECODER_BUFFER_COUNT(dt_us, sr_hz)-1) * sizeof(float); +} + +LC3_EXPORT unsigned lc3_decoder_size(int dt_us, int sr_hz) +{ + return lc3_hr_decoder_size(false, dt_us, sr_hz); +} + +/** + * Setup decoder + */ +LC3_EXPORT struct lc3_decoder *lc3_hr_setup_decoder( + bool hrmode, int dt_us, int sr_hz, int sr_pcm_hz, void *mem) +{ + if (sr_pcm_hz <= 0) + sr_pcm_hz = sr_hz; + + enum lc3_dt dt = resolve_dt(dt_us, hrmode); + enum lc3_srate sr = resolve_srate(sr_hz, hrmode); + enum lc3_srate sr_pcm = resolve_srate(sr_pcm_hz, hrmode); + + if (dt >= LC3_NUM_DT || sr_pcm >= LC3_NUM_SRATE || sr > sr_pcm || !mem) + return NULL; + + struct lc3_decoder *decoder = mem; + int nh = lc3_nh(dt, sr_pcm); + int ns = lc3_ns(dt, sr_pcm); + int nd = lc3_nd(dt, sr_pcm); + + *decoder = (struct lc3_decoder){ + .dt = dt, .sr = sr, + .sr_pcm = sr_pcm, + + .xh_off = 0, + .xs_off = nh, + .xd_off = nh + ns, + .xg_off = nh + ns + nd, + }; + + lc3_plc_reset(&decoder->plc); + + memset(decoder->x, 0, + LC3_DECODER_BUFFER_COUNT(dt_us, sr_pcm_hz) * sizeof(float)); + + return decoder; +} + +LC3_EXPORT struct lc3_decoder *lc3_setup_decoder( + int dt_us, int sr_hz, int sr_pcm_hz, void *mem) +{ + return lc3_hr_setup_decoder(false, dt_us, sr_hz, sr_pcm_hz, mem); +} + +/** + * Decode a frame + */ +LC3_EXPORT int lc3_decode(struct lc3_decoder *decoder, + const void *in, int nbytes, enum lc3_pcm_format fmt, void *pcm, int stride) +{ + static void (* const store[])(struct lc3_decoder *, void *, int) = { + [LC3_PCM_FORMAT_S16 ] = store_s16, + [LC3_PCM_FORMAT_S24 ] = store_s24, + [LC3_PCM_FORMAT_S24_3LE] = store_s24_3le, + [LC3_PCM_FORMAT_FLOAT ] = store_float, + }; + + /* --- Check parameters --- */ + + if (!decoder) + return -1; + + if (in && (nbytes < LC3_MIN_FRAME_BYTES || + nbytes > lc3_max_frame_bytes(decoder->dt, decoder->sr) )) + return -1; + + /* --- Processing --- */ + + struct side_data side; + + int ret = !in || (decode(decoder, in, nbytes, &side) < 0); + + synthesize(decoder, ret ? NULL : &side, nbytes); + + store[fmt](decoder, pcm, stride); + + complete(decoder); + + return ret; +} diff --git a/App_Resources/iOS/src/lc3/lc3.h b/App_Resources/iOS/src/lc3/lc3.h new file mode 100644 index 00000000..98022f3e --- /dev/null +++ b/App_Resources/iOS/src/lc3/lc3.h @@ -0,0 +1,423 @@ +/****************************************************************************** + * + * Copyright 2022 Google LLC + * + * 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. + * + ******************************************************************************/ + +/** + * Low Complexity Communication Codec (LC3) + * + * This implementation conforms to : + * + * - Low Complexity Communication Codec (LC3) + * Bluetooth Specification v1.0 + * + * - ETSI TS 103 634 v1.4.1 + * Digital Enhanced Cordless Telecommunications (DECT) + * Low Complexity Communication Codec plus (LC3plus) + * + * LC3 and LC3 Plus are audio codecs designed for low-latency audio transport. + * + * - Unlike most other codecs, the LC3 codec is focused on audio streaming + * in constrained (on packet sizes and interval) tranport layer. + * In this way, the LC3 does not handle : + * VBR (Variable Bitrate), based on input signal complexity + * ABR (Adaptative Bitrate). It does not rely on any bit reservoir, + * a frame will be strictly encoded in the bytes budget given by + * the user (or transport layer). + * + * However, the bitrate (bytes budget for encoding a frame) can be + * freely changed at any time. But will not rely on signal complexity, + * it can follow a temporary bandwidth increase or reduction. + * + * - Unlike classic codecs, the LC3 codecs does not run on fixed amount + * of samples as input. It operates only on fixed frame duration, for + * any supported sample rates (8 to 48 KHz). Two frames duration are + * available 7.5ms and 10ms. + * + * + * --- LC3 Plus features --- + * + * In addition to LC3, following features of LC3 Plus are proposed: + * - Frame duration of 2.5 and 5ms. + * - High-Resolution mode, 48 KHz, and 96 kHz sampling rates. + * + * The distinction between LC3 and LC3 plus is made according to : + * + * Frame Duration | 2.5ms | 5ms | 7.5ms | 10 ms | + * ---------------- | ----- | ----- | ----- | ----- | + * LC3 | | | X | X | + * LC3 Plus | X | X | | X | + * + * The 10 ms frame duration is available in LC3 and LC3 plus standard. + * In this mode, the produced bitstream can be referenced either + * as LC3 or LC3 plus. + * + * The LC3 Plus high-resolution mode should be preferred at high bitrates + * and larger audio bandwidth. In this mode, the audio bandwidth is always + * up to the Nyquist frequency, compared to LC3 at 48 KHz, which limits + * the bandwidth to 20 KHz. + * + * + * --- Bit rate --- + * + * The proposed implementation accepts any frame sizes between 20 and 400 Bytes + * for non-high-resolution mode. Mind that the LC3 Plus standard defines + * smaller sizes for frame durations shorter than 10 ms and/or sampling rates + * less than 48 kHz. + * + * In High-Resolution mode, the frame sizes (and bitrates) are restricted + * as follows: + * + * HR Configuration | Frame sizes | Bitrate (kbps) | + * ------------------ | ------------- | -------------- | + * 10 ms - 48 KHz | 156 to 625 | 124.8 - 500 | + * 10 ms - 96 KHz | 187 to 625 | 149.6 - 500 | + * ------------------ | ------------- | -------------- | + * 5 ms - 48 KHz | 93 to 375 | 148.8 - 600 | + * 5 ms - 96 KHz | 109 to 375 | 174.4 - 600 | + * ------------------ | ------------- | -------------- | + * 2.5 ms - 48 KHz | 54 to 210 | 172.8 - 672 | + * 2.5 ms - 96 KHz | 62 to 210 | 198.4 - 672 | + * + * + * --- About 44.1 KHz sample rate --- + * + * The Bluetooth specification and the ETSI TS 103 634 standard references + * the 44.1 KHz sample rate, although there is no support in the core algorithm + * of the codec. + * We can summarize the 44.1 KHz support by "You can put any sample rate around + * the defined base sample rates." Please mind the following items : + * + * 1. The frame size will not be 2.5ms, 5ms, 7.5 ms or 10 ms, but is scaled + * by 'supported sample rate' / 'input sample rate' + * + * 2. The bandwidth will be hard limited (to 20 KHz) if you select 48 KHz. + * The encoded bandwidth will also be affected by the above inverse + * factor of 20 KHz. + * + * Applied to 44.1 KHz, we get : + * + * 1. About 8.16 ms frame duration, instead of 7.5 ms + * About 10.88 ms frame duration, instead of 10 ms + * + * 2. The bandwidth becomes limited to 18.375 KHz + * + * + * --- How to encode / decode --- + * + * An encoder / decoder context needs to be setup. This context keeps states + * on the current stream to proceed, and samples that overlapped across + * frames. + * + * You have two ways to setup the encoder / decoder : + * + * - Using static memory allocation (this module does not rely on + * any dynamic memory allocation). The types `lc3_xxcoder_mem_16k_t`, + * and `lc3_xxcoder_mem_48k_t` have size of the memory needed for + * encoding up to 16 KHz or 48 KHz. + * + * - Using dynamic memory allocation. The `lc3_xxcoder_size()` procedure + * returns the needed memory size, for a given configuration. The memory + * space must be aligned to a pointer size. As an example, you can setup + * encoder like this : + * + * | enc = lc3_setup_encoder(frame_us, sample rate, + * | malloc(lc3_encoder_size(frame_us, sample rate))); + * | ... + * | free(enc); + * + * Note : + * - A NULL memory adress as input, will return a NULL encoder context. + * - The returned encoder handle is set at the address of the allocated + * memory space, you can directly free the handle. + * + * Next, call the `lc3_encode()` encoding procedure, for each frames. + * To handle multichannel streams (Stereo or more), you can proceed with + * interleaved channels PCM stream like this : + * + * | for(int ich = 0; ich < nch: ich++) + * | lc3_encode(encoder[ich], pcm + ich, nch, ...); + * + * with `nch` as the number of channels in the PCM stream + * + * --- + * + * Antoine SOULIER, Tempow / Google LLC + * + */ + +#ifndef __LC3_H +#define __LC3_H + +#ifdef __cplusplus +extern "C" { +#endif + +#include +#include + +#include "lc3_private.h" + + +/** + * Limitations + * - On the bitrate, in bps + * - On the size of the frames in bytes + * - On the number of samples by frames + */ + +#define LC3_MIN_BITRATE 16000 +#define LC3_MAX_BITRATE 320000 +#define LC3_HR_MAX_BITRATE 672000 + +#define LC3_MIN_FRAME_BYTES 20 +#define LC3_MAX_FRAME_BYTES 400 +#define LC3_HR_MAX_FRAME_BYTES 625 + +#define LC3_MIN_FRAME_SAMPLES LC3_NS( 2500, 8000) +#define LC3_MAX_FRAME_SAMPLES LC3_NS(10000, 48000) +#define LC3_HR_MAX_FRAME_SAMPLES LC3_NS(10000, 96000) + + +/** + * Parameters check + * LC3_CHECK_DT_US(us) True when frame duration in us is suitable + * LC3_CHECK_SR_HZ(sr) True when sample rate in Hz is suitable + * + * LC3_HR_CHECK_SR_HZ(hrmode, sr) + * True when sample rate in Hz is suitable, according to the + * selection of the high-resolution mode `hrmode`. + */ + +#define LC3_CHECK_DT_US(us) \ + ( ((us) == 2500) || ((us) == 5000) || \ + ((us) == 7500) || ((us) == 10000) ) + +#define LC3_CHECK_SR_HZ(sr) \ + ( ((sr) == 8000) || ((sr) == 16000) || ((sr) == 24000) || \ + ((sr) == 32000) || ((sr) == 48000) ) + +#define LC3_HR_CHECK_SR_HZ(hrmode, sr) \ + ( (hrmode) ? ((sr) == 48000) || ((sr) == 96000) : LC3_CHECK_SR_HZ(sr) ) + + +/** + * PCM Sample Format + * S16 Signed 16 bits, in 16 bits words (int16_t) + * S24 Signed 24 bits, using low three bytes of 32 bits words (int32_t). + * The high byte sign extends (bits 31..24 set to b23). + * S24_3LE Signed 24 bits packed in 3 bytes little endian + * FLOAT Floating point 32 bits (float type), in range -1 to 1 + */ + +enum lc3_pcm_format { + LC3_PCM_FORMAT_S16, + LC3_PCM_FORMAT_S24, + LC3_PCM_FORMAT_S24_3LE, + LC3_PCM_FORMAT_FLOAT, +}; + + +/** + * Handle + */ + +typedef struct lc3_encoder *lc3_encoder_t; +typedef struct lc3_decoder *lc3_decoder_t; + + +/** + * Static memory of encoder/decoder contexts + * + * Propose types suitable for static memory allocation, supporting + * any frame duration, and maximum sample rates 16k and 48k respectively + * You can customize your type using the `LC3_ENCODER_MEM_T` or + * `LC3_DECODER_MEM_T` macro. + */ + +typedef LC3_ENCODER_MEM_T(10000, 16000) lc3_encoder_mem_16k_t; +typedef LC3_ENCODER_MEM_T(10000, 48000) lc3_encoder_mem_48k_t; + +typedef LC3_DECODER_MEM_T(10000, 16000) lc3_decoder_mem_16k_t; +typedef LC3_DECODER_MEM_T(10000, 48000) lc3_decoder_mem_48k_t; + + +/** + * Return the number of PCM samples in a frame + * hrmode Enable High-Resolution mode (48000 and 96000 sample rates) + * dt_us Frame duration in us, 2500, 5000, 7500 or 10000 + * sr_hz Sample rate in Hz, 8000, 16000, 24000, 32000, 48000 or 96000 + * return Number of PCM samples, -1 on bad parameters + */ +LC3_EXPORT int lc3_hr_frame_samples(bool hrmode, int dt_us, int sr_hz); + +LC3_EXPORT int lc3_frame_samples(int dt_us, int sr_hz); + +/** + * Return the size of frames, from bitrate + * hrmode Enable High-Resolution mode (48000 and 96000 sample rates) + * dt_us Frame duration in us, 2500, 5000, 7500 or 10000 + * sr_hz Sample rate in Hz, 8000, 16000, 24000, 32000, 48000 or 96000 + * bitrate Target bitrate in bit per second, 0 or `INT_MAX` returns + * respectively the minimum and maximum allowed size. + * return The floor size in bytes of the frames, -1 on bad parameters + */ +LC3_EXPORT int lc3_hr_frame_bytes( + bool hrmode, int dt_us, int sr_hz, int bitrate); + +LC3_EXPORT int lc3_frame_bytes(int dt_us, int bitrate); + +/** + * Return the size of frame blocks, from bitrate + * A frame block contains the frame data from all channels. + * hrmode Enable High-Resolution mode (48000 and 96000 sample rates) + * dt_us Frame duration in us, 2500, 5000, 7500 or 10000 + * sr_hz Sample rate in Hz, 8000, 16000, 24000, 32000, 48000 or 96000 + * nchannels The number of channels (or frames) in the block (<= 8) + * bitrate Target bitrate in bit per second, 0 or `INT_MAX` returns + * respectively the minimum and maximum allowed size. + * return The floor size in bytes of the frames, -1 on bad parameters + */ +LC3_EXPORT int lc3_hr_frame_block_bytes( + bool hrmode, int dt_us, int sr_hz, int nchannels, int bitrate); + +LC3_EXPORT int lc3_frame_block_bytes(int dt_us, int nframes, int bitrate); + +/** + * Resolve the bitrate, from the size of frames + * hrmode Enable High-Resolution mode (48000 and 96000 sample rates) + * dt_us Frame duration in us, 2500, 5000, 7500 or 10000 + * sr_hz Sample rate in Hz, 8000, 16000, 24000, 32000, 48000 or 96000 + * nbytes Size in bytes of the frames or frame blocks + * return The ceiled bitrate in bps, -1 on bad parameters + */ +LC3_EXPORT int lc3_hr_resolve_bitrate( + bool hrmode, int dt_us, int sr_hz, int nbytes); + +LC3_EXPORT int lc3_resolve_bitrate(int dt_us, int nbytes); + +/** + * Return algorithmic delay, as a number of samples + * hrmode Enable High-Resolution mode (48000 and 96000 sample rates) + * dt_us Frame duration in us, 2500, 5000, 7500 or 10000 + * sr_hz Sample rate in Hz, 8000, 16000, 24000, 32000, 48000 or 96000 + * return Number of algorithmic delay samples, -1 on bad parameters + */ +LC3_EXPORT int lc3_hr_delay_samples(bool hrmode, int dt_us, int sr_hz); + +LC3_EXPORT int lc3_delay_samples(int dt_us, int sr_hz); + +/** + * Return size needed for an encoder + * hrmode Enable High-Resolution mode (48000 and 96000 sample rates) + * dt_us Frame duration in us, 2500, 5000, 7500 or 10000 + * sr_hz Sample rate in Hz, 8000, 16000, 24000, 32000, 48000 or 96000 + * return Size of then encoder in bytes, 0 on bad parameters + * + * The `sr_hz` parameter is the sample rate of the PCM input stream, + * and will match `sr_pcm_hz` of `lc3_hr_setup_encoder()`. + */ +LC3_EXPORT unsigned lc3_hr_encoder_size(bool hrmode, int dt_us, int sr_hz); + +LC3_EXPORT unsigned lc3_encoder_size(int dt_us, int sr_hz); + +/** + * Setup encoder + * hrmode Enable High-Resolution mode (48000 and 96000 sample rates) + * dt_us Frame duration in us, 2500, 5000, 7500 or 10000 + * sr_hz Sample rate in Hz, 8000, 16000, 24000, 32000, 48000 or 96000 + * sr_pcm_hz Input sample rate, downsampling option of input, or 0 + * mem Encoder memory space, aligned to pointer type + * return Encoder as an handle, NULL on bad parameters + * + * The `sr_pcm_hz` parameter is a downsampling option of PCM input, + * the value `0` fallback to the sample rate of the encoded stream `sr_hz`. + * When used, `sr_pcm_hz` is intended to be higher or equal to the encoder + * sample rate `sr_hz`. The size of the context needed, given by + * `lc3_hr_encoder_size()` will be set accordingly to `sr_pcm_hz`. + */ +LC3_EXPORT lc3_encoder_t lc3_hr_setup_encoder( + bool hrmode, int dt_us, int sr_hz, int sr_pcm_hz, void *mem); + +LC3_EXPORT lc3_encoder_t lc3_setup_encoder( + int dt_us, int sr_hz, int sr_pcm_hz, void *mem); + +/** + * Encode a frame + * encoder Handle of the encoder + * fmt PCM input format + * pcm, stride Input PCM samples, and count between two consecutives + * nbytes Target size, in bytes, of the frame + * out Output buffer of `nbytes` size + * return 0: On success -1: Wrong parameters + */ +LC3_EXPORT int lc3_encode( + lc3_encoder_t encoder, enum lc3_pcm_format fmt, + const void *pcm, int stride, int nbytes, void *out); + +/** + * Return size needed for an decoder + * hrmode Enable High-Resolution mode (48000 and 96000 sample rates) + * dt_us Frame duration in us, 2500, 5000, 7500 or 10000 + * sr_hz Sample rate in Hz, 8000, 16000, 24000, 32000, 48000 or 96000 + * return Size of then decoder in bytes, 0 on bad parameters + * + * The `sr_hz` parameter is the sample rate of the PCM output stream, + * and will match `sr_pcm_hz` of `lc3_hr_setup_decoder()`. + */ +LC3_EXPORT unsigned lc3_hr_decoder_size(bool hrmode, int dt_us, int sr_hz); + +LC3_EXPORT unsigned lc3_decoder_size(int dt_us, int sr_hz); + +/** + * Setup decoder + * hrmode Enable High-Resolution mode (48000 and 96000 sample rates) + * dt_us Frame duration in us, 2500, 5000, 7500 or 10000 + * sr_hz Sample rate in Hz, 8000, 16000, 24000, 32000, 48000 or 96000 + * sr_pcm_hz Output sample rate, upsampling option of output (or 0) + * mem Decoder memory space, aligned to pointer type + * return Decoder as an handle, NULL on bad parameters + * + * The `sr_pcm_hz` parameter is an upsampling option of PCM output, + * the value `0` fallback to the sample rate of the decoded stream `sr_hz`. + * When used, `sr_pcm_hz` is intended to be higher or equal to the decoder + * sample rate `sr_hz`. The size of the context needed, given by + * `lc3_hr_decoder_size()` will be set accordingly to `sr_pcm_hz`. + */ +LC3_EXPORT lc3_decoder_t lc3_hr_setup_decoder( + bool hrmode, int dt_us, int sr_hz, int sr_pcm_hz, void *mem); + +LC3_EXPORT lc3_decoder_t lc3_setup_decoder( + int dt_us, int sr_hz, int sr_pcm_hz, void *mem); + +/** + * Decode a frame + * decoder Handle of the decoder + * in, nbytes Input bitstream, and size in bytes, NULL performs PLC + * fmt PCM output format + * pcm, stride Output PCM samples, and count between two consecutives + * return 0: On success 1: PLC operated -1: Wrong parameters + */ +LC3_EXPORT int lc3_decode( + lc3_decoder_t decoder, const void *in, int nbytes, + enum lc3_pcm_format fmt, void *pcm, int stride); + + +#ifdef __cplusplus +} +#endif + +#endif /* __LC3_H */ diff --git a/App_Resources/iOS/src/lc3/lc3_cpp.h b/App_Resources/iOS/src/lc3/lc3_cpp.h new file mode 100644 index 00000000..1949eb90 --- /dev/null +++ b/App_Resources/iOS/src/lc3/lc3_cpp.h @@ -0,0 +1,310 @@ +/****************************************************************************** + * + * Copyright 2022 Google LLC + * + * 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. + * + ******************************************************************************/ + +/** + * Low Complexity Communication Codec (LC3) - C++ interface + */ + +#ifndef __LC3_CPP_H +#define __LC3_CPP_H + +#include +#include +#include +#include + +#include "lc3.h" + +namespace lc3 { + +// PCM Sample Format +// - Signed 16 bits, in 16 bits words (int16_t) +// - Signed 24 bits, using low three bytes of 32 bits words (int32_t) +// The high byte sign extends (bits 31..24 set to b23) +// - Signed 24 bits packed in 3 bytes little endian +// - Floating point 32 bits (float type), in range -1 to 1 + +enum class PcmFormat { + kS16 = LC3_PCM_FORMAT_S16, + kS24 = LC3_PCM_FORMAT_S24, + kS24In3Le = LC3_PCM_FORMAT_S24_3LE, + kF32 = LC3_PCM_FORMAT_FLOAT +}; + +// Base Encoder/Decoder Class +template +class Base { + protected: + Base(int dt_us, int sr_hz, int sr_pcm_hz, size_t nchannels, bool hrmode) + : dt_us_(dt_us), + sr_hz_(sr_hz), + sr_pcm_hz_(sr_pcm_hz == 0 ? sr_hz : sr_pcm_hz), + nchannels_(nchannels), + hrmode_(hrmode) { + states.reserve(nchannels_); + } + + virtual ~Base() = default; + + int dt_us_, sr_hz_; + int sr_pcm_hz_; + size_t nchannels_; + bool hrmode_; + + using state_ptr = std::unique_ptr; + std::vector states; + + public: + // Return the number of PCM samples in a frame + int GetFrameSamples() { + return lc3_hr_frame_samples(hrmode_, dt_us_, sr_pcm_hz_); } + + // Return the size of a frame block, from bitrate + int GetFrameBytes(int bitrate) { + return lc3_hr_frame_block_bytes( + hrmode_, dt_us_, sr_hz_, nchannels_, bitrate); } + + // Resolve the bitrate, from the size of frame blocks + int ResolveBitrate(int nbytes) { + return lc3_hr_resolve_bitrate(hrmode_, dt_us_, sr_hz_, nbytes); } + + // Return algorithmic delay, as a number of samples + int GetDelaySamples() { + return lc3_hr_delay_samples(hrmode_, dt_us_, sr_pcm_hz_); } + +}; // class Base + +// Encoder Class +class Encoder : public Base { + template + int EncodeImpl(PcmFormat fmt, const T *pcm, int block_size, uint8_t *out) { + if (states.size() != nchannels_) return -1; + + enum lc3_pcm_format cfmt = static_cast(fmt); + int ret = 0; + + uint8_t *out_ptr = out; + for (size_t ich = 0; ich < nchannels_; ich++) { + int frame_size = block_size / nchannels_ + + (ich < block_size % nchannels_); + + ret |= lc3_encode(states[ich].get(), cfmt, pcm + ich, nchannels_, + frame_size, out_ptr); + + out_ptr += frame_size; + } + + return ret; + } + + public: + // Encoder construction / destruction + // + // The frame duration `dt_us` is 2500, 5000, 7500 or 10000 us. + // The sample rate `sr_hz` is 8000, 16000, 24000, 32000 or 48000 Hz. + // The `hrmode` flag enables the high-resolution mode, in which case + // the sample rate is 48000 or 96000 Hz. + // + // The `sr_pcm_hz` parameter is a downsampling option of PCM input, + // the value 0 fallback to the sample rate of the encoded stream `sr_hz`. + // When used, `sr_pcm_hz` is intended to be higher or equal to the encoder + // sample rate `sr_hz`. + + Encoder(int dt_us, int sr_hz, int sr_pcm_hz = 0, + size_t nchannels = 1, bool hrmode = false) + : Base(dt_us, sr_hz, sr_pcm_hz, nchannels, hrmode) { + for (size_t ich = 0; ich < nchannels_; ich++) { + auto s = state_ptr((lc3_encoder_t) + malloc(lc3_hr_encoder_size(hrmode_, dt_us_, sr_pcm_hz_)), free); + + if (lc3_hr_setup_encoder(hrmode_, dt_us_, sr_hz_, sr_pcm_hz_, s.get())) + states.push_back(std::move(s)); + } + } + + ~Encoder() override = default; + + // Reset encoder state + + void Reset() { + for (auto &s : states) + lc3_hr_setup_encoder(hrmode_, dt_us_, sr_hz_, sr_pcm_hz_, s.get()); + } + + // Encode + // + // The input PCM samples are given in signed 16 bits, 24 bits, float, + // according the type of `pcm` input buffer, or by selecting a format. + // + // The PCM samples are read in interleaved way, and consecutive + // `nchannels` frames, are output in `out` buffer, of size `buffer_size`. + // + // The value returned is 0 on successs, -1 otherwise. + + int Encode(const int16_t *pcm, int block_size, uint8_t *out) { + return EncodeImpl(PcmFormat::kS16, pcm, block_size, out); + } + + int Encode(const int32_t *pcm, int block_size, uint8_t *out) { + return EncodeImpl(PcmFormat::kS24, pcm, block_size, out); + } + + int Encode(const float *pcm, int block_size, uint8_t *out) { + return EncodeImpl(PcmFormat::kF32, pcm, block_size, out); + } + + int Encode(PcmFormat fmt, const void *pcm, int block_size, uint8_t *out) { + uintptr_t pcm_ptr = reinterpret_cast(pcm); + + switch (fmt) { + case PcmFormat::kS16: + assert(pcm_ptr % alignof(int16_t) == 0); + return EncodeImpl(fmt, reinterpret_cast(pcm), + block_size, out); + + case PcmFormat::kS24: + assert(pcm_ptr % alignof(int32_t) == 0); + return EncodeImpl(fmt, reinterpret_cast(pcm), + block_size, out); + + case PcmFormat::kS24In3Le: + return EncodeImpl(fmt, reinterpret_cast(pcm), + block_size, out); + + case PcmFormat::kF32: + assert(pcm_ptr % alignof(float) == 0); + return EncodeImpl(fmt, reinterpret_cast(pcm), block_size, + out); + } + + return -1; + } + +}; // class Encoder + +// Decoder Class +class Decoder : public Base { + template + int DecodeImpl(const uint8_t *in, int block_size, PcmFormat fmt, T *pcm) { + if (states.size() != nchannels_) return -1; + + enum lc3_pcm_format cfmt = static_cast(fmt); + int ret = 0; + + const uint8_t *in_ptr = in; + for (size_t ich = 0; ich < nchannels_; ich++) { + int frame_size = block_size / nchannels_ + + (ich < block_size % nchannels_); + + ret |= lc3_decode(states[ich].get(), in_ptr, frame_size, + cfmt, pcm + ich, nchannels_); + + in_ptr += frame_size; + } + + return ret; + } + + public: + // Decoder construction / destruction + // + // The frame duration `dt_us` is 2500, 5000, 7500 or 10000 us. + // The sample rate `sr_hz` is 8000, 16000, 24000, 32000 or 48000 Hz. + // The `hrmode` flag enables the high-resolution mode, in which case + // the sample rate is 48000 or 96000 Hz. + // + // The `sr_pcm_hz` parameter is an downsampling option of PCM output, + // the value 0 fallback to the sample rate of the decoded stream `sr_hz`. + // When used, `sr_pcm_hz` is intended to be higher or equal to the decoder + // sample rate `sr_hz`. + + Decoder(int dt_us, int sr_hz, int sr_pcm_hz = 0, + size_t nchannels = 1, bool hrmode = false) + : Base(dt_us, sr_hz, sr_pcm_hz, nchannels, hrmode) { + for (size_t i = 0; i < nchannels_; i++) { + auto s = state_ptr((lc3_decoder_t) + malloc(lc3_hr_decoder_size(hrmode_, dt_us_, sr_pcm_hz_)), free); + + if (lc3_hr_setup_decoder(hrmode_, dt_us_, sr_hz_, sr_pcm_hz_, s.get())) + states.push_back(std::move(s)); + } + } + + ~Decoder() override = default; + + // Reset decoder state + + void Reset() { + for (auto &s : states) + lc3_hr_setup_decoder(hrmode_, dt_us_, sr_hz_, sr_pcm_hz_, s.get()); + } + + // Decode + // + // Decode a frame block of size `block_size`, + // in the `pcm` buffer in interleaved way. + // + // The PCM samples are output in signed 16 bits, 24 bits, float, + // according the type of `pcm` output buffer, or by selecting a format. + // + // The value returned is 0 on successs, 1 when PLC has been performed, + // and -1 otherwise. + + int Decode(const uint8_t *in, int block_size, int16_t *pcm) { + return DecodeImpl(in, block_size, PcmFormat::kS16, pcm); + } + + int Decode(const uint8_t *in, int block_size, int32_t *pcm) { + return DecodeImpl(in, block_size, PcmFormat::kS24In3Le, pcm); + } + + int Decode(const uint8_t *in, int block_size, float *pcm) { + return DecodeImpl(in, block_size, PcmFormat::kF32, pcm); + } + + int Decode(const uint8_t *in, int block_size, PcmFormat fmt, void *pcm) { + uintptr_t pcm_ptr = reinterpret_cast(pcm); + + switch (fmt) { + case PcmFormat::kS16: + assert(pcm_ptr % alignof(int16_t) == 0); + return DecodeImpl(in, block_size, fmt, + reinterpret_cast(pcm)); + + case PcmFormat::kS24: + assert(pcm_ptr % alignof(int32_t) == 0); + return DecodeImpl(in, block_size, fmt, + reinterpret_cast(pcm)); + + case PcmFormat::kS24In3Le: + return DecodeImpl(in, block_size, fmt, + reinterpret_cast(pcm)); + + case PcmFormat::kF32: + assert(pcm_ptr % alignof(float) == 0); + return DecodeImpl(in, block_size, fmt, reinterpret_cast(pcm)); + } + + return -1; + } + +}; // class Decoder + +} // namespace lc3 + +#endif /* __LC3_CPP_H */ diff --git a/App_Resources/iOS/src/lc3/lc3_private.h b/App_Resources/iOS/src/lc3/lc3_private.h new file mode 100644 index 00000000..4f5f657b --- /dev/null +++ b/App_Resources/iOS/src/lc3/lc3_private.h @@ -0,0 +1,187 @@ +/****************************************************************************** + * + * Copyright 2022 Google LLC + * + * 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. + * + ******************************************************************************/ + +#ifndef __LC3_PRIVATE_H +#define __LC3_PRIVATE_H + +#include +#include + + +/** + * Characteristics + * + * - The number of samples within a frame + * + * - The number of MDCT delayed samples, sum of half a frame and + * an ovelap of future by 1.25 ms (2.5ms, 5ms and 10ms frame durations) + * or 2 ms (7.5ms frame duration). + * + * - For decoding, keep 18 ms of history, aligned on a frame + * + * - For encoding, keep 1.25 ms of temporal previous samples + */ + +#define LC3_NS(dt_us, sr_hz) \ + ( (dt_us) * (sr_hz) / 1000 / 1000 ) + +#define LC3_ND(dt_us, sr_hz) \ + ( LC3_NS(dt_us, sr_hz) / 2 + \ + LC3_NS((dt_us) == 7500 ? 2000 : 1250, sr_hz) ) + +#define LC3_NH(dt_us, sr_hz) \ + ( (sr_hz) > 48000 ? 0 : ( LC3_NS(18000, sr_hz) + \ + LC3_NS(dt_us, sr_hz) - (LC3_NS(18000, sr_hz) % LC3_NS(dt_us, sr_hz)) ) ) + +#define LC3_NT(sr_hz) \ + ( LC3_NS(1250, sr_hz) ) + + +/** + * Frame duration + */ + +enum lc3_dt { + LC3_DT_2M5 = 0, + LC3_DT_5M = 1, + LC3_DT_7M5 = 2, + LC3_DT_10M = 3, + + LC3_NUM_DT +}; + + +/** + * Sampling frequency and high-resolution mode + */ + +enum lc3_srate { + LC3_SRATE_8K, + LC3_SRATE_16K, + LC3_SRATE_24K, + LC3_SRATE_32K, + LC3_SRATE_48K, + LC3_SRATE_48K_HR, + LC3_SRATE_96K_HR, + + LC3_NUM_SRATE +}; + + +/** + * Encoder state and memory + */ + +typedef struct lc3_attdet_analysis { + int32_t en1, an1; + int p_att; +} lc3_attdet_analysis_t; + +struct lc3_ltpf_hp50_state { + int64_t s1, s2; +}; + +typedef struct lc3_ltpf_analysis { + bool active; + int pitch; + float nc[2]; + + struct lc3_ltpf_hp50_state hp50; + int16_t x_12k8[384]; + int16_t x_6k4[178]; + int tc; +} lc3_ltpf_analysis_t; + +typedef struct lc3_spec_analysis { + float nbits_off; + int nbits_spare; +} lc3_spec_analysis_t; + +struct lc3_encoder { + enum lc3_dt dt; + enum lc3_srate sr, sr_pcm; + + lc3_attdet_analysis_t attdet; + lc3_ltpf_analysis_t ltpf; + lc3_spec_analysis_t spec; + + int xt_off, xs_off, xd_off; + float x[1]; +}; + +#define LC3_ENCODER_BUFFER_COUNT(dt_us, sr_hz) \ + ( ( LC3_NS(dt_us, sr_hz) + LC3_NT(sr_hz) ) / 2 + \ + LC3_NS(dt_us, sr_hz) + LC3_ND(dt_us, sr_hz) ) + +#define LC3_ENCODER_MEM_T(dt_us, sr_hz) \ + struct { \ + struct lc3_encoder __e; \ + float __x[LC3_ENCODER_BUFFER_COUNT(dt_us, sr_hz)-1]; \ + } + + +/** + * Decoder state and memory + */ + +typedef struct lc3_ltpf_synthesis { + bool active; + int pitch; + float c[2*12], x[12]; +} lc3_ltpf_synthesis_t; + +typedef struct lc3_plc_state { + uint16_t seed; + int count; + float alpha; +} lc3_plc_state_t; + +struct lc3_decoder { + enum lc3_dt dt; + enum lc3_srate sr, sr_pcm; + + lc3_ltpf_synthesis_t ltpf; + lc3_plc_state_t plc; + + int xh_off, xs_off, xd_off, xg_off; + float x[1]; +}; + +#define LC3_DECODER_BUFFER_COUNT(dt_us, sr_hz) \ + ( LC3_NH(dt_us, sr_hz) + LC3_NS(dt_us, sr_hz) + \ + LC3_ND(dt_us, sr_hz) + LC3_NS(dt_us, sr_hz) ) + +#define LC3_DECODER_MEM_T(dt_us, sr_hz) \ + struct { \ + struct lc3_decoder __d; \ + float __x[LC3_DECODER_BUFFER_COUNT(dt_us, sr_hz)-1]; \ + } + + +/** + * Change the visibility of interface functions + */ + +#ifdef _WIN32 +#define LC3_EXPORT __declspec(dllexport) +#else +#define LC3_EXPORT __attribute__((visibility ("default"))) +#endif + + +#endif /* __LC3_PRIVATE_H */ diff --git a/App_Resources/iOS/src/lc3/ltpf.c b/App_Resources/iOS/src/lc3/ltpf.c new file mode 100644 index 00000000..08cbae6b --- /dev/null +++ b/App_Resources/iOS/src/lc3/ltpf.c @@ -0,0 +1,964 @@ +/****************************************************************************** + * + * Copyright 2022 Google LLC + * + * 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 "ltpf.h" +#include "tables.h" + +#include "ltpf_neon.h" +#include "ltpf_arm.h" + + +/* ---------------------------------------------------------------------------- + * Resampling + * -------------------------------------------------------------------------- */ + +/** + * Resampling coefficients + * The coefficients, in fixed Q15, are reordered by phase for each source + * samplerate (coefficient matrix transposed) + */ + +#ifndef resample_8k_12k8 +static const int16_t h_8k_12k8_q15[8*10] = { + 214, 417, -1052, -4529, 26233, -4529, -1052, 417, 214, 0, + 180, 0, -1522, -2427, 24506, -5289, 0, 763, 156, -28, + 92, -323, -1361, 0, 19741, -3885, 1317, 861, 0, -61, + 0, -457, -752, 1873, 13068, 0, 2389, 598, -213, -79, + -61, -398, 0, 2686, 5997, 5997, 2686, 0, -398, -61, + -79, -213, 598, 2389, 0, 13068, 1873, -752, -457, 0, + -61, 0, 861, 1317, -3885, 19741, 0, -1361, -323, 92, + -28, 156, 763, 0, -5289, 24506, -2427, -1522, 0, 180, +}; +#endif /* resample_8k_12k8 */ + +#ifndef resample_16k_12k8 +static const int16_t h_16k_12k8_q15[4*20] = { + -61, 214, -398, 417, 0, -1052, 2686, -4529, 5997, 26233, + 5997, -4529, 2686, -1052, 0, 417, -398, 214, -61, 0, + + -79, 180, -213, 0, 598, -1522, 2389, -2427, 0, 24506, + 13068, -5289, 1873, 0, -752, 763, -457, 156, 0, -28, + + -61, 92, 0, -323, 861, -1361, 1317, 0, -3885, 19741, + 19741, -3885, 0, 1317, -1361, 861, -323, 0, 92, -61, + + -28, 0, 156, -457, 763, -752, 0, 1873, -5289, 13068, + 24506, 0, -2427, 2389, -1522, 598, 0, -213, 180, -79, +}; +#endif /* resample_16k_12k8 */ + +#ifndef resample_32k_12k8 +static const int16_t h_32k_12k8_q15[2*40] = { + -30, -31, 46, 107, 0, -199, -162, 209, 430, 0, + -681, -526, 658, 1343, 0, -2264, -1943, 2999, 9871, 13116, + 9871, 2999, -1943, -2264, 0, 1343, 658, -526, -681, 0, + 430, 209, -162, -199, 0, 107, 46, -31, -30, 0, + + -14, -39, 0, 90, 78, -106, -229, 0, 382, 299, + -376, -761, 0, 1194, 937, -1214, -2644, 0, 6534, 12253, + 12253, 6534, 0, -2644, -1214, 937, 1194, 0, -761, -376, + 299, 382, 0, -229, -106, 78, 90, 0, -39, -14, +}; +#endif /* resample_32k_12k8 */ + +#ifndef resample_24k_12k8 +static const int16_t h_24k_12k8_q15[8*30] = { + -50, 19, 143, -93, -290, 278, 485, -658, -701, 1396, + 901, -3019, -1042, 10276, 17488, 10276, -1042, -3019, 901, 1396, + -701, -658, 485, 278, -290, -93, 143, 19, -50, 0, + + -46, 0, 141, -45, -305, 185, 543, -501, -854, 1153, + 1249, -2619, -1908, 8712, 17358, 11772, 0, -3319, 480, 1593, + -504, -796, 399, 367, -261, -142, 138, 40, -52, -5, + + -41, -17, 133, 0, -304, 91, 574, -334, -959, 878, + 1516, -2143, -2590, 7118, 16971, 13161, 1202, -3495, 0, 1731, + -267, -908, 287, 445, -215, -188, 125, 62, -52, -12, + + -34, -30, 120, 41, -291, 0, 577, -164, -1015, 585, + 1697, -1618, -3084, 5534, 16337, 14406, 2544, -3526, -523, 1800, + 0, -985, 152, 509, -156, -230, 104, 83, -48, -19, + + -26, -41, 103, 76, -265, -83, 554, 0, -1023, 288, + 1791, -1070, -3393, 3998, 15474, 15474, 3998, -3393, -1070, 1791, + 288, -1023, 0, 554, -83, -265, 76, 103, -41, -26, + + -19, -48, 83, 104, -230, -156, 509, 152, -985, 0, + 1800, -523, -3526, 2544, 14406, 16337, 5534, -3084, -1618, 1697, + 585, -1015, -164, 577, 0, -291, 41, 120, -30, -34, + + -12, -52, 62, 125, -188, -215, 445, 287, -908, -267, + 1731, 0, -3495, 1202, 13161, 16971, 7118, -2590, -2143, 1516, + 878, -959, -334, 574, 91, -304, 0, 133, -17, -41, + + -5, -52, 40, 138, -142, -261, 367, 399, -796, -504, + 1593, 480, -3319, 0, 11772, 17358, 8712, -1908, -2619, 1249, + 1153, -854, -501, 543, 185, -305, -45, 141, 0, -46, +}; +#endif /* resample_24k_12k8 */ + +#ifndef resample_48k_12k8 +static const int16_t h_48k_12k8_q15[4*60] = { + -13, -25, -20, 10, 51, 71, 38, -47, -133, -145, + -42, 139, 277, 242, 0, -329, -511, -351, 144, 698, + 895, 450, -535, -1510, -1697, -521, 1999, 5138, 7737, 8744, + 7737, 5138, 1999, -521, -1697, -1510, -535, 450, 895, 698, + 144, -351, -511, -329, 0, 242, 277, 139, -42, -145, + -133, -47, 38, 71, 51, 10, -20, -25, -13, 0, + + -9, -23, -24, 0, 41, 71, 52, -23, -115, -152, + -78, 92, 254, 272, 76, -251, -493, -427, 0, 576, + 900, 624, -262, -1309, -1763, -954, 1272, 4356, 7203, 8679, + 8169, 5886, 2767, 0, -1542, -1660, -809, 240, 848, 796, + 292, -252, -507, -398, -82, 199, 288, 183, 0, -130, + -145, -71, 20, 69, 60, 20, -15, -26, -17, -3, + + -6, -20, -26, -8, 31, 67, 62, 0, -94, -152, + -108, 45, 223, 287, 143, -167, -454, -480, -134, 439, + 866, 758, 0, -1071, -1748, -1295, 601, 3559, 6580, 8485, + 8485, 6580, 3559, 601, -1295, -1748, -1071, 0, 758, 866, + 439, -134, -480, -454, -167, 143, 287, 223, 45, -108, + -152, -94, 0, 62, 67, 31, -8, -26, -20, -6, + + -3, -17, -26, -15, 20, 60, 69, 20, -71, -145, + -130, 0, 183, 288, 199, -82, -398, -507, -252, 292, + 796, 848, 240, -809, -1660, -1542, 0, 2767, 5886, 8169, + 8679, 7203, 4356, 1272, -954, -1763, -1309, -262, 624, 900, + 576, 0, -427, -493, -251, 76, 272, 254, 92, -78, + -152, -115, -23, 52, 71, 41, 0, -24, -23, -9, +}; +#endif /* resample_48k_12k8 */ + +#ifndef resample_96k_12k8 +static const int16_t h_96k_12k8_q15[2*120] = { + -3, -7, -10, -13, -13, -10, -4, 5, 15, 26, + 33, 36, 31, 19, 0, -23, -47, -66, -76, -73, + -54, -21, 23, 70, 111, 139, 143, 121, 72, 0, + -84, -165, -227, -256, -240, -175, -67, 72, 219, 349, + 433, 448, 379, 225, 0, -268, -536, -755, -874, -848, + -648, -260, 301, 1000, 1780, 2569, 3290, 3869, 4243, 4372, + 4243, 3869, 3290, 2569, 1780, 1000, 301, -260, -648, -848, + -874, -755, -536, -268, 0, 225, 379, 448, 433, 349, + 219, 72, -67, -175, -240, -256, -227, -165, -84, 0, + 72, 121, 143, 139, 111, 70, 23, -21, -54, -73, + -76, -66, -47, -23, 0, 19, 31, 36, 33, 26, + 15, 5, -4, -10, -13, -13, -10, -7, -3, 0, + + -1, -5, -8, -12, -13, -12, -8, 0, 10, 21, + 30, 35, 34, 26, 10, -11, -35, -58, -73, -76, + -65, -39, 0, 46, 92, 127, 144, 136, 100, 38, + -41, -125, -199, -246, -254, -214, -126, 0, 146, 288, + 398, 450, 424, 312, 120, -131, -405, -655, -830, -881, + -771, -477, 0, 636, 1384, 2178, 2943, 3601, 4084, 4340, + 4340, 4084, 3601, 2943, 2178, 1384, 636, 0, -477, -771, + -881, -830, -655, -405, -131, 120, 312, 424, 450, 398, + 288, 146, 0, -126, -214, -254, -246, -199, -125, -41, + 38, 100, 136, 144, 127, 92, 46, 0, -39, -65, + -76, -73, -58, -35, -11, 10, 26, 34, 35, 30, + 21, 10, 0, -8, -12, -13, -12, -8, -5, -1, +}; +#endif /* resample_96k_12k8 */ + + +/** + * High-pass 50Hz filtering, at 12.8 KHz samplerate + * hp50 Biquad filter state + * xn Input sample, in fixed Q30 + * return Filtered sample, in fixed Q30 + */ +LC3_HOT static inline int32_t filter_hp50( + struct lc3_ltpf_hp50_state *hp50, int32_t xn) +{ + int32_t yn; + + const int32_t a1 = -2110217691, a2 = 1037111617; + const int32_t b1 = -2110535566, b2 = 1055267782; + + yn = (hp50->s1 + (int64_t)xn * b2) >> 30; + hp50->s1 = (hp50->s2 + (int64_t)xn * b1 - (int64_t)yn * a1); + hp50->s2 = ( (int64_t)xn * b2 - (int64_t)yn * a2); + + return yn; +} + +/** + * Resample from 8 / 16 / 32 KHz to 12.8 KHz Template + * p Resampling factor with compared to 192 KHz (8, 4 or 2) + * h Arrange by phase coefficients table + * hp50 High-Pass biquad filter state + * x [-d..-1] Previous, [0..ns-1] Current samples, Q15 + * y, n [0..n-1] Output `n` processed samples, Q14 + * + * The `x` vector is aligned on 32 bits + * The number of previous samples `d` accessed on `x` is : + * d: { 10, 20, 40 } - 1 for resampling factors 8, 4 and 2. + */ +#if !defined(resample_8k_12k8) || !defined(resample_16k_12k8) \ + || !defined(resample_32k_12k8) +LC3_HOT static inline void resample_x64k_12k8(const int p, const int16_t *h, + struct lc3_ltpf_hp50_state *hp50, const int16_t *x, int16_t *y, int n) +{ + const int w = 2*(40 / p); + + x -= w - 1; + + for (int i = 0; i < 5*n; i += 5) { + const int16_t *hn = h + (i % p) * w; + const int16_t *xn = x + (i / p); + int32_t un = 0; + + for (int k = 0; k < w; k += 10) { + un += *(xn++) * *(hn++); + un += *(xn++) * *(hn++); + un += *(xn++) * *(hn++); + un += *(xn++) * *(hn++); + un += *(xn++) * *(hn++); + un += *(xn++) * *(hn++); + un += *(xn++) * *(hn++); + un += *(xn++) * *(hn++); + un += *(xn++) * *(hn++); + un += *(xn++) * *(hn++); + } + + int32_t yn = filter_hp50(hp50, un); + *(y++) = (yn + (1 << 15)) >> 16; + } +} +#endif + +/** + * Resample from 24 / 48 KHz to 12.8 KHz Template + * p Resampling factor with compared to 192 KHz (8 or 4) + * h Arrange by phase coefficients table + * hp50 High-Pass biquad filter state + * x [-d..-1] Previous, [0..ns-1] Current samples, Q15 + * y, n [0..n-1] Output `n` processed samples, Q14 + * + * The `x` vector is aligned on 32 bits + * The number of previous samples `d` accessed on `x` is : + * d: { 30, 60 } - 1 for resampling factors 8 and 4. + */ +#if !defined(resample_24k_12k8) || !defined(resample_48k_12k8) \ + || !defined(resample_96k_12k8) +LC3_HOT static inline void resample_x192k_12k8(const int p, const int16_t *h, + struct lc3_ltpf_hp50_state *hp50, const int16_t *x, int16_t *y, int n) +{ + const int w = 2*(120 / p); + + x -= w - 1; + + for (int i = 0; i < 15*n; i += 15) { + const int16_t *hn = h + (i % p) * w; + const int16_t *xn = x + (i / p); + int32_t un = 0; + + for (int k = 0; k < w; k += 15) { + un += *(xn++) * *(hn++); + un += *(xn++) * *(hn++); + un += *(xn++) * *(hn++); + un += *(xn++) * *(hn++); + un += *(xn++) * *(hn++); + un += *(xn++) * *(hn++); + un += *(xn++) * *(hn++); + un += *(xn++) * *(hn++); + un += *(xn++) * *(hn++); + un += *(xn++) * *(hn++); + un += *(xn++) * *(hn++); + un += *(xn++) * *(hn++); + un += *(xn++) * *(hn++); + un += *(xn++) * *(hn++); + un += *(xn++) * *(hn++); + } + + int32_t yn = filter_hp50(hp50, un); + *(y++) = (yn + (1 << 15)) >> 16; + } +} +#endif + +/** + * Resample from 8 Khz to 12.8 KHz + * hp50 High-Pass biquad filter state + * x [-10..-1] Previous, [0..ns-1] Current samples, Q15 + * y, n [0..n-1] Output `n` processed samples, Q14 + * + * The `x` vector is aligned on 32 bits + */ +#ifndef resample_8k_12k8 +LC3_HOT static void resample_8k_12k8( + struct lc3_ltpf_hp50_state *hp50, const int16_t *x, int16_t *y, int n) +{ + resample_x64k_12k8(8, h_8k_12k8_q15, hp50, x, y, n); +} +#endif /* resample_8k_12k8 */ + +/** + * Resample from 16 Khz to 12.8 KHz + * hp50 High-Pass biquad filter state + * x [-20..-1] Previous, [0..ns-1] Current samples, in fixed Q15 + * y, n [0..n-1] Output `n` processed samples, in fixed Q14 + * + * The `x` vector is aligned on 32 bits + */ +#ifndef resample_16k_12k8 +LC3_HOT static void resample_16k_12k8( + struct lc3_ltpf_hp50_state *hp50, const int16_t *x, int16_t *y, int n) +{ + resample_x64k_12k8(4, h_16k_12k8_q15, hp50, x, y, n); +} +#endif /* resample_16k_12k8 */ + +/** + * Resample from 32 Khz to 12.8 KHz + * hp50 High-Pass biquad filter state + * x [-30..-1] Previous, [0..ns-1] Current samples, in fixed Q15 + * y, n [0..n-1] Output `n` processed samples, in fixed Q14 + * + * The `x` vector is aligned on 32 bits + */ +#ifndef resample_32k_12k8 +LC3_HOT static void resample_32k_12k8( + struct lc3_ltpf_hp50_state *hp50, const int16_t *x, int16_t *y, int n) +{ + resample_x64k_12k8(2, h_32k_12k8_q15, hp50, x, y, n); +} +#endif /* resample_32k_12k8 */ + +/** + * Resample from 24 Khz to 12.8 KHz + * hp50 High-Pass biquad filter state + * x [-30..-1] Previous, [0..ns-1] Current samples, in fixed Q15 + * y, n [0..n-1] Output `n` processed samples, in fixed Q14 + * + * The `x` vector is aligned on 32 bits + */ +#ifndef resample_24k_12k8 +LC3_HOT static void resample_24k_12k8( + struct lc3_ltpf_hp50_state *hp50, const int16_t *x, int16_t *y, int n) +{ + resample_x192k_12k8(8, h_24k_12k8_q15, hp50, x, y, n); +} +#endif /* resample_24k_12k8 */ + +/** + * Resample from 48 Khz to 12.8 KHz + * hp50 High-Pass biquad filter state + * x [-60..-1] Previous, [0..ns-1] Current samples, in fixed Q15 + * y, n [0..n-1] Output `n` processed samples, in fixed Q14 + * +* The `x` vector is aligned on 32 bits +*/ +#ifndef resample_48k_12k8 +LC3_HOT static void resample_48k_12k8( + struct lc3_ltpf_hp50_state *hp50, const int16_t *x, int16_t *y, int n) +{ + resample_x192k_12k8(4, h_48k_12k8_q15, hp50, x, y, n); +} +#endif /* resample_48k_12k8 */ + +/** + * Resample from 96 Khz to 12.8 KHz + * hp50 High-Pass biquad filter state + * x [-120..-1] Previous, [0..ns-1] Current samples, in fixed Q15 + * y, n [0..n-1] Output `n` processed samples, in fixed Q14 + * +* The `x` vector is aligned on 32 bits +*/ +#ifndef resample_96k_12k8 +LC3_HOT static void resample_96k_12k8( + struct lc3_ltpf_hp50_state *hp50, const int16_t *x, int16_t *y, int n) +{ + resample_x192k_12k8(2, h_96k_12k8_q15, hp50, x, y, n); +} +#endif /* resample_96k_12k8 */ + +/** +* Resample to 6.4 KHz +* x [-3..-1] Previous, [0..n-1] Current samples +* y, n [0..n-1] Output `n` processed samples +* +* The `x` vector is aligned on 32 bits + */ +#ifndef resample_6k4 +LC3_HOT static void resample_6k4(const int16_t *x, int16_t *y, int n) +{ + static const int16_t h[] = { 18477, 15424, 8105 }; + const int16_t *ye = y + n; + + for (x--; y < ye; x += 2) + *(y++) = (x[0] * h[0] + (x[-1] + x[1]) * h[1] + + (x[-2] + x[2]) * h[2]) >> 16; +} +#endif /* resample_6k4 */ + +/** + * LTPF Resample to 12.8 KHz implementations for each samplerates + */ + +static void (* const resample_12k8[]) + (struct lc3_ltpf_hp50_state *, const int16_t *, int16_t *, int ) = +{ + [LC3_SRATE_8K ] = resample_8k_12k8, + [LC3_SRATE_16K ] = resample_16k_12k8, + [LC3_SRATE_24K ] = resample_24k_12k8, + [LC3_SRATE_32K ] = resample_32k_12k8, + [LC3_SRATE_48K ] = resample_48k_12k8, + [LC3_SRATE_48K_HR] = resample_48k_12k8, + [LC3_SRATE_96K_HR] = resample_96k_12k8, +}; + + +/* ---------------------------------------------------------------------------- + * Analysis + * -------------------------------------------------------------------------- */ + +/** + * Return dot product of 2 vectors + * a, b, n The 2 vectors of size `n` (> 0 and <= 128) + * return sum( a[i] * b[i] ), i = [0..n-1] + * + * The size `n` of vectors must be multiple of 16, and less or equal to 128 +*/ +#ifndef dot +LC3_HOT static inline float dot(const int16_t *a, const int16_t *b, int n) +{ + int64_t v = 0; + + for (int i = 0; i < (n >> 4); i++) + for (int j = 0; j < 16; j++) + v += *(a++) * *(b++); + + int32_t v32 = (v + (1 << 5)) >> 6; + return (float)v32; +} +#endif /* dot */ + +/** + * Return vector of correlations + * a, b, n The 2 vector of size `n` (> 0 and <= 128) + * y, nc Output the correlation vector of size `nc` + * + * The first vector `a` is aligned of 32 bits + * The size `n` of vectors is multiple of 16, and less or equal to 128 + */ +#ifndef correlate +LC3_HOT static void correlate( + const int16_t *a, const int16_t *b, int n, float *y, int nc) +{ + for (const float *ye = y + nc; y < ye; ) + *(y++) = dot(a, b--, n); +} +#endif /* correlate */ + +/** + * Search the maximum value and returns its argument + * x, n The input vector of size `n` + * x_max Return the maximum value + * return Return the argument of the maximum + */ +LC3_HOT static int argmax(const float *x, int n, float *x_max) +{ + int arg = 0; + + *x_max = x[arg = 0]; + for (int i = 1; i < n; i++) + if (*x_max < x[i]) + *x_max = x[arg = i]; + + return arg; +} + +/** + * Search the maximum weithed value and returns its argument + * x, n The input vector of size `n` + * w_incr Increment of the weight + * x_max, xw_max Return the maximum not weighted value + * return Return the argument of the weigthed maximum + */ +LC3_HOT static int argmax_weighted( + const float *x, int n, float w_incr, float *x_max) +{ + int arg; + + float xw_max = (*x_max = x[arg = 0]); + float w = 1 + w_incr; + + for (int i = 1; i < n; i++, w += w_incr) + if (xw_max < x[i] * w) + xw_max = (*x_max = x[arg = i]) * w; + + return arg; +} + +/** + * Interpolate from pitch detected value + * x, n [-2..-1] Previous, [0..n] Current input + * d The phase of interpolation (0 to 3) + * return The interpolated vector + * + * The size `n` of vectors must be multiple of 4 + */ +LC3_HOT static void interpolate(const int16_t *x, int n, int d, int16_t *y) +{ + static const int16_t h4_q15[][4] = { + { 6877, 19121, 6877, 0 }, { 3506, 18025, 11000, 220 }, + { 1300, 15048, 15048, 1300 }, { 220, 11000, 18025, 3506 } }; + + const int16_t *h = h4_q15[d]; + int16_t x3 = x[-2], x2 = x[-1], x1, x0; + + x1 = (*x++); + for (const int16_t *ye = y + n; y < ye; ) { + int32_t yn; + + yn = (x0 = *(x++)) * h[0] + x1 * h[1] + x2 * h[2] + x3 * h[3]; + *(y++) = yn >> 15; + + yn = (x3 = *(x++)) * h[0] + x0 * h[1] + x1 * h[2] + x2 * h[3]; + *(y++) = yn >> 15; + + yn = (x2 = *(x++)) * h[0] + x3 * h[1] + x0 * h[2] + x1 * h[3]; + *(y++) = yn >> 15; + + yn = (x1 = *(x++)) * h[0] + x2 * h[1] + x3 * h[2] + x0 * h[3]; + *(y++) = yn >> 15; + } +} + +/** + * Interpolate autocorrelation + * x [-4..-1] Previous, [0..4] Current input + * d The phase of interpolation (-3 to 3) + * return The interpolated value + */ +LC3_HOT static float interpolate_corr(const float *x, int d) +{ + static const float h4[][8] = { + { 1.53572770e-02, -4.72963246e-02, 8.35788573e-02, 8.98638285e-01, + 8.35788573e-02, -4.72963246e-02, 1.53572770e-02, }, + { 2.74547165e-03, 4.59833449e-03, -7.54404636e-02, 8.17488686e-01, + 3.30182571e-01, -1.05835916e-01, 2.86823405e-02, -2.87456116e-03 }, + { -3.00125103e-03, 2.95038503e-02, -1.30305021e-01, 6.03297008e-01, + 6.03297008e-01, -1.30305021e-01, 2.95038503e-02, -3.00125103e-03 }, + { -2.87456116e-03, 2.86823405e-02, -1.05835916e-01, 3.30182571e-01, + 8.17488686e-01, -7.54404636e-02, 4.59833449e-03, 2.74547165e-03 }, + }; + + const float *h = h4[(4+d) % 4]; + + float y = d < 0 ? x[-4] * *(h++) : + d > 0 ? x[ 4] * *(h+7) : 0; + + y += x[-3] * h[0] + x[-2] * h[1] + x[-1] * h[2] + x[0] * h[3] + + x[ 1] * h[4] + x[ 2] * h[5] + x[ 3] * h[6]; + + return y; +} + +/** + * Pitch detection algorithm + * ltpf Context of analysis + * x, n [-114..-17] Previous, [0..n-1] Current 6.4KHz samples + * tc Return the pitch-lag estimation + * return True when pitch present + * + * The `x` vector is aligned on 32 bits + */ +static bool detect_pitch(struct lc3_ltpf_analysis *ltpf, + const int16_t *x, int n, int *tc) +{ + float rm1, rm2; + float r[98]; + + const int r0 = 17, nr = 98; + int k0 = LC3_MAX( 0, ltpf->tc-4); + int nk = LC3_MIN(nr-1, ltpf->tc+4) - k0 + 1; + + correlate(x, x - r0, n, r, nr); + + int t1 = argmax_weighted(r, nr, -.5f/(nr-1), &rm1); + int t2 = k0 + argmax(r + k0, nk, &rm2); + + const int16_t *x1 = x - (r0 + t1); + const int16_t *x2 = x - (r0 + t2); + + float nc1 = rm1 <= 0 ? 0 : + rm1 / sqrtf(dot(x, x, n) * dot(x1, x1, n)); + + float nc2 = rm2 <= 0 ? 0 : + rm2 / sqrtf(dot(x, x, n) * dot(x2, x2, n)); + + int t1sel = nc2 <= 0.85f * nc1; + ltpf->tc = (t1sel ? t1 : t2); + + *tc = r0 + ltpf->tc; + return (t1sel ? nc1 : nc2) > 0.6f; +} + +/** + * Pitch-lag parameter + * x, n [-232..-28] Previous, [0..n-1] Current 12.8KHz samples, Q14 + * tc Pitch-lag estimation + * pitch The pitch value, in fixed .4 + * return The bitstream pitch index value + * + * The `x` vector is aligned on 32 bits + */ +static int refine_pitch(const int16_t *x, int n, int tc, int *pitch) +{ + float r[17], rm; + int e, f; + + int r0 = LC3_MAX( 32, 2*tc - 4); + int nr = LC3_MIN(228, 2*tc + 4) - r0 + 1; + + correlate(x, x - (r0 - 4), n, r, nr + 8); + + e = r0 + argmax(r + 4, nr, &rm); + const float *re = r + (e - (r0 - 4)); + + float dm = interpolate_corr(re, f = 0); + for (int i = 1; i <= 3; i++) { + float d; + + if (e >= 127 && ((i & 1) | (e >= 157))) + continue; + + if ((d = interpolate_corr(re, i)) > dm) + dm = d, f = i; + + if (e > 32 && (d = interpolate_corr(re, -i)) > dm) + dm = d, f = -i; + } + + e -= (f < 0); + f += 4*(f < 0); + + *pitch = 4*e + f; + return e < 127 ? 4*e + f - 128 : + e < 157 ? 2*e + (f >> 1) + 126 : e + 283; +} + +/** + * LTPF Analysis + */ +bool lc3_ltpf_analyse( + enum lc3_dt dt, enum lc3_srate sr, struct lc3_ltpf_analysis *ltpf, + const int16_t *x, struct lc3_ltpf_data *data) +{ + /* --- Resampling to 12.8 KHz --- */ + + int z_12k8 = sizeof(ltpf->x_12k8) / sizeof(*ltpf->x_12k8); + int n_12k8 = (1 + dt) * 32; + + memmove(ltpf->x_12k8, ltpf->x_12k8 + n_12k8, + (z_12k8 - n_12k8) * sizeof(*ltpf->x_12k8)); + + int16_t *x_12k8 = ltpf->x_12k8 + (z_12k8 - n_12k8); + + resample_12k8[sr](<pf->hp50, x, x_12k8, n_12k8); + + x_12k8 -= (dt == LC3_DT_7M5 ? 44 : 24); + + /* --- Resampling to 6.4 KHz --- */ + + int z_6k4 = sizeof(ltpf->x_6k4) / sizeof(*ltpf->x_6k4); + int n_6k4 = n_12k8 >> 1; + + memmove(ltpf->x_6k4, ltpf->x_6k4 + n_6k4, + (z_6k4 - n_6k4) * sizeof(*ltpf->x_6k4)); + + int16_t *x_6k4 = ltpf->x_6k4 + (z_6k4 - n_6k4); + + resample_6k4(x_12k8, x_6k4, n_6k4); + + /* --- Enlarge for small frame size --- */ + + if (dt == LC3_DT_2M5) { + x_12k8 -= n_12k8, x_6k4 -= n_6k4; + n_12k8 += n_12k8; n_6k4 += n_6k4; + } + + /* --- Pitch detection --- */ + + int tc, pitch = 0; + float nc = 0; + + bool pitch_present = detect_pitch(ltpf, x_6k4, n_6k4, &tc); + + if (pitch_present) { + int16_t u[128], v[128]; + + data->pitch_index = refine_pitch(x_12k8, n_12k8, tc, &pitch); + + interpolate(x_12k8, n_12k8, 0, u); + interpolate(x_12k8 - (pitch >> 2), n_12k8, pitch & 3, v); + + nc = dot(u, v, n_12k8) / sqrtf(dot(u, u, n_12k8) * dot(v, v, n_12k8)); + } + + /* --- Activation --- */ + + if (ltpf->active) { + int pitch_diff = + LC3_MAX(pitch, ltpf->pitch) - LC3_MIN(pitch, ltpf->pitch); + float nc_diff = nc - ltpf->nc[0]; + + data->active = !lc3_hr(sr) && pitch_present && + ((nc > 0.9f) || (nc > 0.84f && pitch_diff < 8 && nc_diff > -0.1f)); + + } else { + data->active = !lc3_hr(sr) && pitch_present && + ( (dt == LC3_DT_10M || ltpf->nc[1] > 0.94f) && + (ltpf->nc[0] > 0.94f && nc > 0.94f) ); + } + + ltpf->active = data->active; + ltpf->pitch = pitch; + ltpf->nc[1] = ltpf->nc[0]; + ltpf->nc[0] = nc; + + return pitch_present; +} + + +/* ---------------------------------------------------------------------------- + * Synthesis + * -------------------------------------------------------------------------- */ + +/** + * Width of synthesis filter + */ + +#define MAX_FILTER_WIDTH \ + (LC3_MAX_SRATE_HZ / 4000) + + +/** + * Synthesis filter template + * xh, nh History ring buffer of filtered samples + * lag Lag parameter in the ring buffer + * x0 w-1 previous input samples + * x, n Current samples as input, filtered as output + * c, w Coefficients `den` then `num`, and width of filter + * fade Fading mode of filter -1: Out 1: In 0: None + */ +LC3_HOT static inline void synthesize_template( + const float *xh, int nh, int lag, + const float *x0, float *x, int n, + const float *c, const int w, int fade) +{ + float g = (float)(fade <= 0); + float g_incr = (float)((fade > 0) - (fade < 0)) / n; + float u[MAX_FILTER_WIDTH]; + + /* --- Load previous samples --- */ + + lag += (w >> 1); + + const float *y = x - xh < lag ? x + (nh - lag) : x - lag; + const float *y_end = xh + nh - 1; + + for (int j = 0; j < w-1; j++) { + + u[j] = 0; + + float yi = *y, xi = *(x0++); + y = y < y_end ? y + 1 : xh; + + for (int k = 0; k <= j; k++) + u[j-k] -= yi * c[k]; + + for (int k = 0; k <= j; k++) + u[j-k] += xi * c[w+k]; + } + + u[w-1] = 0; + + /* --- Process by filter length --- */ + + for (int i = 0; i < n; i += w) + for (int j = 0; j < w; j++, g += g_incr) { + + float yi = *y, xi = *x; + y = y < y_end ? y + 1 : xh; + + for (int k = 0; k < w; k++) + u[(j+(w-1)-k)%w] -= yi * c[k]; + + for (int k = 0; k < w; k++) + u[(j+(w-1)-k)%w] += xi * c[w+k]; + + *(x++) = xi - g * u[j]; + u[j] = 0; + } +} + +/** + * Synthesis filter for each samplerates (width of filter) + */ + + +LC3_HOT static void synthesize_4(const float *xh, int nh, int lag, + const float *x0, float *x, int n, const float *c, int fade) +{ + synthesize_template(xh, nh, lag, x0, x, n, c, 4, fade); +} + +LC3_HOT static void synthesize_6(const float *xh, int nh, int lag, + const float *x0, float *x, int n, const float *c, int fade) +{ + synthesize_template(xh, nh, lag, x0, x, n, c, 6, fade); +} + +LC3_HOT static void synthesize_8(const float *xh, int nh, int lag, + const float *x0, float *x, int n, const float *c, int fade) +{ + synthesize_template(xh, nh, lag, x0, x, n, c, 8, fade); +} + +LC3_HOT static void synthesize_12(const float *xh, int nh, int lag, + const float *x0, float *x, int n, const float *c, int fade) +{ + synthesize_template(xh, nh, lag, x0, x, n, c, 12, fade); +} + +static void (* const synthesize[])(const float *, int, int, + const float *, float *, int, const float *, int) = +{ + [LC3_SRATE_8K ] = synthesize_4, + [LC3_SRATE_16K] = synthesize_4, + [LC3_SRATE_24K] = synthesize_6, + [LC3_SRATE_32K] = synthesize_8, + [LC3_SRATE_48K] = synthesize_12, +}; + + +/** + * LTPF Synthesis + */ +void lc3_ltpf_synthesize(enum lc3_dt dt, enum lc3_srate sr, int nbytes, + lc3_ltpf_synthesis_t *ltpf, const lc3_ltpf_data_t *data, + const float *xh, float *x) +{ + int nh = lc3_ns(dt, sr) + lc3_nh(dt, sr); + + /* --- Filter parameters --- */ + + int p_idx = data ? data->pitch_index : 0; + int pitch = + p_idx >= 440 ? (((p_idx ) - 283) << 2) : + p_idx >= 380 ? (((p_idx >> 1) - 63) << 2) + (((p_idx & 1)) << 1) : + (((p_idx >> 2) + 32) << 2) + (((p_idx & 3)) << 0) ; + + pitch = (pitch * lc3_ns(LC3_DT_10M, sr) + 64) / 128; + + int nbits = (nbytes*8 * (1 + LC3_DT_10M)) / (1 + dt); + if (dt == LC3_DT_2M5) + nbits = (6 * nbits + 5) / 10; + if (dt == LC3_DT_5M) + nbits -= 160; + + int g_idx = LC3_MAX(nbits / 80, (int)(3 + sr)) - (3 + sr); + bool active = data && data->active && g_idx < 4; + + int w = LC3_MAX(4, lc3_ns_4m[sr] >> 4); + float c[2 * MAX_FILTER_WIDTH]; + + for (int i = 0; i < w; i++) { + float g = active ? 0.4f - 0.05f * g_idx : 0; + c[ i] = g * lc3_ltpf_cden[sr][pitch & 3][(w-1)-i]; + c[w+i] = 0.85f * g * lc3_ltpf_cnum[sr][LC3_MIN(g_idx, 3)][(w-1)-i]; + } + + /* --- Transition handling --- */ + + int ns = lc3_ns(dt, sr); + int nt = ns / (1 + dt); + float x0[2][MAX_FILTER_WIDTH]; + + memcpy(x0[0], ltpf->x, (w-1) * sizeof(float)); + memcpy(ltpf->x, x + ns - (w-1), (w-1) * sizeof(float)); + + if (active) + memcpy(x0[1], x + nt-(w-1), (w-1) * sizeof(float)); + + if (!ltpf->active && active) + synthesize[sr](xh, nh, pitch/4, x0[0], x, nt, c, 1); + else if (ltpf->active && !active) + synthesize[sr](xh, nh, ltpf->pitch/4, x0[0], x, nt, ltpf->c, -1); + else if (ltpf->active && active && ltpf->pitch == pitch) + synthesize[sr](xh, nh, pitch/4, x0[0], x, nt, c, 0); + else if (ltpf->active && active) { + synthesize[sr](xh, nh, ltpf->pitch/4, x0[0], x, nt, ltpf->c, -1); + synthesize[sr](xh, nh, pitch/4, + (x <= xh ? x + nh : x) - (w-1), x, nt, c, 1); + } + + /* --- Remainder --- */ + + if (active && ns > nt) + synthesize[sr](xh, nh, pitch/4, x0[1], x + nt, ns-nt, c, 0); + + /* --- Update state --- */ + + ltpf->active = active; + ltpf->pitch = pitch; + memcpy(ltpf->c, c, 2*w * sizeof(*ltpf->c)); +} + + +/* ---------------------------------------------------------------------------- + * Bitstream data + * -------------------------------------------------------------------------- */ + +/** + * LTPF disable + */ +void lc3_ltpf_disable(struct lc3_ltpf_data *data) +{ + data->active = false; +} + +/** + * Return number of bits coding the bitstream data + */ +int lc3_ltpf_get_nbits(bool pitch) +{ + return 1 + 10 * pitch; +} + +/** + * Put bitstream data + */ +void lc3_ltpf_put_data(lc3_bits_t *bits, + const struct lc3_ltpf_data *data) +{ + lc3_put_bit(bits, data->active); + lc3_put_bits(bits, data->pitch_index, 9); +} + +/** + * Get bitstream data + */ +void lc3_ltpf_get_data(lc3_bits_t *bits, + struct lc3_ltpf_data *data) +{ + data->active = lc3_get_bit(bits); + data->pitch_index = lc3_get_bits(bits, 9); +} diff --git a/App_Resources/iOS/src/lc3/ltpf.h b/App_Resources/iOS/src/lc3/ltpf.h new file mode 100644 index 00000000..42cedc6a --- /dev/null +++ b/App_Resources/iOS/src/lc3/ltpf.h @@ -0,0 +1,104 @@ +/****************************************************************************** + * + * Copyright 2022 Google LLC + * + * 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. + * + ******************************************************************************/ + +#ifndef __LC3_LTPF_H +#define __LC3_LTPF_H + +#include "common.h" +#include "bits.h" + + +/** + * LTPF data + */ + +typedef struct lc3_ltpf_data { + bool active; + int pitch_index; +} lc3_ltpf_data_t; + + +/* ---------------------------------------------------------------------------- + * Encoding + * -------------------------------------------------------------------------- */ + +/** + * LTPF analysis + * dt, sr Duration and samplerate of the frame + * ltpf Context of analysis + * allowed True when activation of LTPF is allowed + * x [-d..-1] Previous, [0..ns-1] Current samples + * data Return bitstream data + * return True when pitch present, False otherwise + * + * The `x` vector is aligned on 32 bits + * The number of previous samples `d` accessed on `x` is : + * d: { 10, 20, 30, 40, 60 } - 1 for samplerates from 8KHz to 48KHz + */ +bool lc3_ltpf_analyse(enum lc3_dt dt, enum lc3_srate sr, + lc3_ltpf_analysis_t *ltpf, const int16_t *x, lc3_ltpf_data_t *data); + +/** + * LTPF disable + * data LTPF data, disabled activation on return + */ +void lc3_ltpf_disable(lc3_ltpf_data_t *data); + +/** + * Return number of bits coding the bitstream data + * pitch True when pitch present, False otherwise + * return Bit consumption, including the pitch present flag + */ +int lc3_ltpf_get_nbits(bool pitch); + +/** + * Put bitstream data + * bits Bitstream context + * data LTPF data + */ +void lc3_ltpf_put_data(lc3_bits_t *bits, const lc3_ltpf_data_t *data); + + +/* ---------------------------------------------------------------------------- + * Decoding + * -------------------------------------------------------------------------- */ +/** + * Get bitstream data + * bits Bitstream context + * data Return bitstream data + */ +void lc3_ltpf_get_data(lc3_bits_t *bits, lc3_ltpf_data_t *data); + +/** + * LTPF synthesis + * dt, sr Duration and samplerate of the frame + * nbytes Size in bytes of the frame + * ltpf Context of synthesis + * data Bitstream data, NULL when pitch not present + * xr Base address of ring buffer of decoded samples + * x Samples to proceed in the ring buffer, filtered as output + * + * The size of the ring buffer is `nh + ns`. + * The filtering needs an history of at least 18 ms. + */ +void lc3_ltpf_synthesize(enum lc3_dt dt, enum lc3_srate sr, int nbytes, + lc3_ltpf_synthesis_t *ltpf, const lc3_ltpf_data_t *data, + const float *xr, float *x); + + +#endif /* __LC3_LTPF_H */ diff --git a/App_Resources/iOS/src/lc3/ltpf_arm.h b/App_Resources/iOS/src/lc3/ltpf_arm.h new file mode 100644 index 00000000..fab35290 --- /dev/null +++ b/App_Resources/iOS/src/lc3/ltpf_arm.h @@ -0,0 +1,506 @@ +/****************************************************************************** + * + * Copyright 2022 Google LLC + * + * 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. + * + ******************************************************************************/ + +#if (__ARM_FEATURE_SIMD32 && !(__GNUC__ < 10) || defined(TEST_ARM)) + +#ifndef TEST_ARM + +#include + +static inline int16x2_t __pkhbt(int16x2_t a, int16x2_t b) +{ + int16x2_t r; + __asm("pkhbt %0, %1, %2" : "=r" (r) : "r" (a), "r" (b)); + return r; +} + +#endif /* TEST_ARM */ + + +/** + * Import + */ + +static inline int32_t filter_hp50(struct lc3_ltpf_hp50_state *, int32_t); +static inline float dot(const int16_t *, const int16_t *, int); + + +/** + * Resample from 8 / 16 / 32 KHz to 12.8 KHz Template + */ +#if !defined(resample_8k_12k8) || !defined(resample_16k_12k8) \ + || !defined(resample_32k_12k8) +static inline void arm_resample_x64k_12k8(const int p, const int16x2_t *h, + struct lc3_ltpf_hp50_state *hp50, const int16x2_t *x, int16_t *y, int n) +{ + const int w = 40 / p; + + x -= w; + + for (int i = 0; i < 5*n; i += 5) { + const int16x2_t *hn = h + (i % (2*p)) * (48 / p); + const int16x2_t *xn = x + (i / (2*p)); + + int32_t un = __smlad(*(xn++), *(hn++), 0); + + for (int k = 0; k < w; k += 5) { + un = __smlad(*(xn++), *(hn++), un); + un = __smlad(*(xn++), *(hn++), un); + un = __smlad(*(xn++), *(hn++), un); + un = __smlad(*(xn++), *(hn++), un); + un = __smlad(*(xn++), *(hn++), un); + } + + int32_t yn = filter_hp50(hp50, un); + *(y++) = (yn + (1 << 15)) >> 16; + } +} +#endif + +/** + * Resample from 24 / 48 KHz to 12.8 KHz Template + */ +#if !defined(resample_24k_12k8) || !defined(resample_48k_12k8) +static inline void arm_resample_x192k_12k8(const int p, const int16x2_t *h, + struct lc3_ltpf_hp50_state *hp50, const int16x2_t *x, int16_t *y, int n) +{ + const int w = 120 / p; + + x -= w; + + for (int i = 0; i < 15*n; i += 15) { + const int16x2_t *hn = h + (i % (2*p)) * (128 / p); + const int16x2_t *xn = x + (i / (2*p)); + + int32_t un = __smlad(*(xn++), *(hn++), 0); + + for (int k = 0; k < w; k += 15) { + un = __smlad(*(xn++), *(hn++), un); + un = __smlad(*(xn++), *(hn++), un); + un = __smlad(*(xn++), *(hn++), un); + un = __smlad(*(xn++), *(hn++), un); + un = __smlad(*(xn++), *(hn++), un); + un = __smlad(*(xn++), *(hn++), un); + un = __smlad(*(xn++), *(hn++), un); + un = __smlad(*(xn++), *(hn++), un); + un = __smlad(*(xn++), *(hn++), un); + un = __smlad(*(xn++), *(hn++), un); + un = __smlad(*(xn++), *(hn++), un); + un = __smlad(*(xn++), *(hn++), un); + un = __smlad(*(xn++), *(hn++), un); + un = __smlad(*(xn++), *(hn++), un); + un = __smlad(*(xn++), *(hn++), un); + } + + int32_t yn = filter_hp50(hp50, un); + *(y++) = (yn + (1 << 15)) >> 16; + } +} +#endif + +/** + * Resample from 8 Khz to 12.8 KHz + */ +#ifndef resample_8k_12k8 + +static void arm_resample_8k_12k8( + struct lc3_ltpf_hp50_state *hp50, const int16_t *x, int16_t *y, int n) +{ + alignas(int32_t) static const int16_t h[2*8*12] = { + 0, 214, 417, -1052, -4529, 26233, -4529, -1052, 417, 214, 0, 0, + 0, 180, 0, -1522, -2427, 24506, -5289, 0, 763, 156, -28, 0, + 0, 92, -323, -1361, 0, 19741, -3885, 1317, 861, 0, -61, 0, + 0, 0, -457, -752, 1873, 13068, 0, 2389, 598, -213, -79, 0, + 0, -61, -398, 0, 2686, 5997, 5997, 2686, 0, -398, -61, 0, + 0, -79, -213, 598, 2389, 0, 13068, 1873, -752, -457, 0, 0, + 0, -61, 0, 861, 1317, -3885, 19741, 0, -1361, -323, 92, 0, + 0, -28, 156, 763, 0, -5289, 24506, -2427, -1522, 0, 180, 0, + 0, 0, 214, 417, -1052, -4529, 26233, -4529, -1052, 417, 214, 0, + 0, 0, 180, 0, -1522, -2427, 24506, -5289, 0, 763, 156, -28, + 0, 0, 92, -323, -1361, 0, 19741, -3885, 1317, 861, 0, -61, + 0, 0, 0, -457, -752, 1873, 13068, 0, 2389, 598, -213, -79, + 0, 0, -61, -398, 0, 2686, 5997, 5997, 2686, 0, -398, -61, + 0, 0, -79, -213, 598, 2389, 0, 13068, 1873, -752, -457, 0, + 0, 0, -61, 0, 861, 1317, -3885, 19741, 0, -1361, -323, 92, + 0, 0, -28, 156, 763, 0, -5289, 24506, -2427, -1522, 0, 180, + }; + + arm_resample_x64k_12k8( + 8, (const int16x2_t *)h, hp50, (int16x2_t *)x, y, n); +} + +#ifndef TEST_ARM +#define resample_8k_12k8 arm_resample_8k_12k8 +#endif + +#endif /* resample_8k_12k8 */ + +/** + * Resample from 16 Khz to 12.8 KHz + */ +#ifndef resample_16k_12k8 + +static void arm_resample_16k_12k8( + struct lc3_ltpf_hp50_state *hp50, const int16_t *x, int16_t *y, int n) +{ + alignas(int32_t) static const int16_t h[2*4*24] = { + + 0, -61, 214, -398, 417, 0, -1052, 2686, + -4529, 5997, 26233, 5997, -4529, 2686, -1052, 0, + 417, -398, 214, -61, 0, 0, 0, 0, + + + 0, -79, 180, -213, 0, 598, -1522, 2389, + -2427, 0, 24506, 13068, -5289, 1873, 0, -752, + 763, -457, 156, 0, -28, 0, 0, 0, + + + 0, -61, 92, 0, -323, 861, -1361, 1317, + 0, -3885, 19741, 19741, -3885, 0, 1317, -1361, + 861, -323, 0, 92, -61, 0, 0, 0, + + 0, -28, 0, 156, -457, 763, -752, 0, + 1873, -5289, 13068, 24506, 0, -2427, 2389, -1522, + 598, 0, -213, 180, -79, 0, 0, 0, + + + 0, 0, -61, 214, -398, 417, 0, -1052, + 2686, -4529, 5997, 26233, 5997, -4529, 2686, -1052, + 0, 417, -398, 214, -61, 0, 0, 0, + + + 0, 0, -79, 180, -213, 0, 598, -1522, + 2389, -2427, 0, 24506, 13068, -5289, 1873, 0, + -752, 763, -457, 156, 0, -28, 0, 0, + + + 0, 0, -61, 92, 0, -323, 861, -1361, + 1317, 0, -3885, 19741, 19741, -3885, 0, 1317, + -1361, 861, -323, 0, 92, -61, 0, 0, + + 0, 0, -28, 0, 156, -457, 763, -752, + 0, 1873, -5289, 13068, 24506, 0, -2427, 2389, + -1522, 598, 0, -213, 180, -79, 0, 0, + }; + + arm_resample_x64k_12k8( + 4, (const int16x2_t *)h, hp50, (int16x2_t *)x, y, n); +} + +#ifndef TEST_ARM +#define resample_16k_12k8 arm_resample_16k_12k8 +#endif + +#endif /* resample_16k_12k8 */ + +/** + * Resample from 32 Khz to 12.8 KHz + */ +#ifndef resample_32k_12k8 + +static void arm_resample_32k_12k8( + struct lc3_ltpf_hp50_state *hp50, const int16_t *x, int16_t *y, int n) +{ + alignas(int32_t) static const int16_t h[2*2*48] = { + + 0, -30, -31, 46, 107, 0, -199, -162, + 209, 430, 0, -681, -526, 658, 1343, 0, + -2264, -1943, 2999, 9871, 13116, 9871, 2999, -1943, + -2264, 0, 1343, 658, -526, -681, 0, 430, + 209, -162, -199, 0, 107, 46, -31, -30, + 0, 0, 0, 0, 0, 0, 0, 0, + + 0, -14, -39, 0, 90, 78, -106, -229, + 0, 382, 299, -376, -761, 0, 1194, 937, + -1214, -2644, 0, 6534, 12253, 12253, 6534, 0, + -2644, -1214, 937, 1194, 0, -761, -376, 299, + 382, 0, -229, -106, 78, 90, 0, -39, + -14, 0, 0, 0, 0, 0, 0, 0, + + 0, 0, -30, -31, 46, 107, 0, -199, + -162, 209, 430, 0, -681, -526, 658, 1343, + 0, -2264, -1943, 2999, 9871, 13116, 9871, 2999, + -1943, -2264, 0, 1343, 658, -526, -681, 0, + 430, 209, -162, -199, 0, 107, 46, -31, + -30, 0, 0, 0, 0, 0, 0, 0, + + 0, 0, -14, -39, 0, 90, 78, -106, + -229, 0, 382, 299, -376, -761, 0, 1194, + 937, -1214, -2644, 0, 6534, 12253, 12253, 6534, + 0, -2644, -1214, 937, 1194, 0, -761, -376, + 299, 382, 0, -229, -106, 78, 90, 0, + -39, -14, 0, 0, 0, 0, 0, 0, + }; + + arm_resample_x64k_12k8( + 2, (const int16x2_t *)h, hp50, (int16x2_t *)x, y, n); +} + +#ifndef TEST_ARM +#define resample_32k_12k8 arm_resample_32k_12k8 +#endif + +#endif /* resample_32k_12k8 */ + +/** + * Resample from 24 Khz to 12.8 KHz + */ +#ifndef resample_24k_12k8 + +static void arm_resample_24k_12k8( + struct lc3_ltpf_hp50_state *hp50, const int16_t *x, int16_t *y, int n) +{ + alignas(int32_t) static const int16_t h[2*8*32] = { + + 0, -50, 19, 143, -93, -290, 278, 485, + -658, -701, 1396, 901, -3019, -1042, 10276, 17488, + 10276, -1042, -3019, 901, 1396, -701, -658, 485, + 278, -290, -93, 143, 19, -50, 0, 0, + + 0, -46, 0, 141, -45, -305, 185, 543, + -501, -854, 1153, 1249, -2619, -1908, 8712, 17358, + 11772, 0, -3319, 480, 1593, -504, -796, 399, + 367, -261, -142, 138, 40, -52, -5, 0, + + 0, -41, -17, 133, 0, -304, 91, 574, + -334, -959, 878, 1516, -2143, -2590, 7118, 16971, + 13161, 1202, -3495, 0, 1731, -267, -908, 287, + 445, -215, -188, 125, 62, -52, -12, 0, + + 0, -34, -30, 120, 41, -291, 0, 577, + -164, -1015, 585, 1697, -1618, -3084, 5534, 16337, + 14406, 2544, -3526, -523, 1800, 0, -985, 152, + 509, -156, -230, 104, 83, -48, -19, 0, + + 0, -26, -41, 103, 76, -265, -83, 554, + 0, -1023, 288, 1791, -1070, -3393, 3998, 15474, + 15474, 3998, -3393, -1070, 1791, 288, -1023, 0, + 554, -83, -265, 76, 103, -41, -26, 0, + + 0, -19, -48, 83, 104, -230, -156, 509, + 152, -985, 0, 1800, -523, -3526, 2544, 14406, + 16337, 5534, -3084, -1618, 1697, 585, -1015, -164, + 577, 0, -291, 41, 120, -30, -34, 0, + + 0, -12, -52, 62, 125, -188, -215, 445, + 287, -908, -267, 1731, 0, -3495, 1202, 13161, + 16971, 7118, -2590, -2143, 1516, 878, -959, -334, + 574, 91, -304, 0, 133, -17, -41, 0, + + 0, -5, -52, 40, 138, -142, -261, 367, + 399, -796, -504, 1593, 480, -3319, 0, 11772, + 17358, 8712, -1908, -2619, 1249, 1153, -854, -501, + 543, 185, -305, -45, 141, 0, -46, 0, + + 0, 0, -50, 19, 143, -93, -290, 278, + 485, -658, -701, 1396, 901, -3019, -1042, 10276, + 17488, 10276, -1042, -3019, 901, 1396, -701, -658, + 485, 278, -290, -93, 143, 19, -50, 0, + + 0, 0, -46, 0, 141, -45, -305, 185, + 543, -501, -854, 1153, 1249, -2619, -1908, 8712, + 17358, 11772, 0, -3319, 480, 1593, -504, -796, + 399, 367, -261, -142, 138, 40, -52, -5, + + 0, 0, -41, -17, 133, 0, -304, 91, + 574, -334, -959, 878, 1516, -2143, -2590, 7118, + 16971, 13161, 1202, -3495, 0, 1731, -267, -908, + 287, 445, -215, -188, 125, 62, -52, -12, + + 0, 0, -34, -30, 120, 41, -291, 0, + 577, -164, -1015, 585, 1697, -1618, -3084, 5534, + 16337, 14406, 2544, -3526, -523, 1800, 0, -985, + 152, 509, -156, -230, 104, 83, -48, -19, + + 0, 0, -26, -41, 103, 76, -265, -83, + 554, 0, -1023, 288, 1791, -1070, -3393, 3998, + 15474, 15474, 3998, -3393, -1070, 1791, 288, -1023, + 0, 554, -83, -265, 76, 103, -41, -26, + + 0, 0, -19, -48, 83, 104, -230, -156, + 509, 152, -985, 0, 1800, -523, -3526, 2544, + 14406, 16337, 5534, -3084, -1618, 1697, 585, -1015, + -164, 577, 0, -291, 41, 120, -30, -34, + + 0, 0, -12, -52, 62, 125, -188, -215, + 445, 287, -908, -267, 1731, 0, -3495, 1202, + 13161, 16971, 7118, -2590, -2143, 1516, 878, -959, + -334, 574, 91, -304, 0, 133, -17, -41, + + 0, 0, -5, -52, 40, 138, -142, -261, + 367, 399, -796, -504, 1593, 480, -3319, 0, + 11772, 17358, 8712, -1908, -2619, 1249, 1153, -854, + -501, 543, 185, -305, -45, 141, 0, -46, + }; + + arm_resample_x192k_12k8( + 8, (const int16x2_t *)h, hp50, (int16x2_t *)x, y, n); +} + +#ifndef TEST_ARM +#define resample_24k_12k8 arm_resample_24k_12k8 +#endif + +#endif /* resample_24k_12k8 */ + +/** + * Resample from 48 Khz to 12.8 KHz + */ +#ifndef resample_48k_12k8 + +static void arm_resample_48k_12k8( + struct lc3_ltpf_hp50_state *hp50, const int16_t *x, int16_t *y, int n) +{ + alignas(int32_t) static const int16_t h[2*4*64] = { + + 0, -13, -25, -20, 10, 51, 71, 38, + -47, -133, -145, -42, 139, 277, 242, 0, + -329, -511, -351, 144, 698, 895, 450, -535, + -1510, -1697, -521, 1999, 5138, 7737, 8744, 7737, + 5138, 1999, -521, -1697, -1510, -535, 450, 895, + 698, 144, -351, -511, -329, 0, 242, 277, + 139, -42, -145, -133, -47, 38, 71, 51, + 10, -20, -25, -13, 0, 0, 0, 0, + + 0, -9, -23, -24, 0, 41, 71, 52, + -23, -115, -152, -78, 92, 254, 272, 76, + -251, -493, -427, 0, 576, 900, 624, -262, + -1309, -1763, -954, 1272, 4356, 7203, 8679, 8169, + 5886, 2767, 0, -1542, -1660, -809, 240, 848, + 796, 292, -252, -507, -398, -82, 199, 288, + 183, 0, -130, -145, -71, 20, 69, 60, + 20, -15, -26, -17, -3, 0, 0, 0, + + 0, -6, -20, -26, -8, 31, 67, 62, + 0, -94, -152, -108, 45, 223, 287, 143, + -167, -454, -480, -134, 439, 866, 758, 0, + -1071, -1748, -1295, 601, 3559, 6580, 8485, 8485, + 6580, 3559, 601, -1295, -1748, -1071, 0, 758, + 866, 439, -134, -480, -454, -167, 143, 287, + 223, 45, -108, -152, -94, 0, 62, 67, + 31, -8, -26, -20, -6, 0, 0, 0, + + 0, -3, -17, -26, -15, 20, 60, 69, + 20, -71, -145, -130, 0, 183, 288, 199, + -82, -398, -507, -252, 292, 796, 848, 240, + -809, -1660, -1542, 0, 2767, 5886, 8169, 8679, + 7203, 4356, 1272, -954, -1763, -1309, -262, 624, + 900, 576, 0, -427, -493, -251, 76, 272, + 254, 92, -78, -152, -115, -23, 52, 71, + 41, 0, -24, -23, -9, 0, 0, 0, + + 0, 0, -13, -25, -20, 10, 51, 71, + 38, -47, -133, -145, -42, 139, 277, 242, + 0, -329, -511, -351, 144, 698, 895, 450, + -535, -1510, -1697, -521, 1999, 5138, 7737, 8744, + 7737, 5138, 1999, -521, -1697, -1510, -535, 450, + 895, 698, 144, -351, -511, -329, 0, 242, + 277, 139, -42, -145, -133, -47, 38, 71, + 51, 10, -20, -25, -13, 0, 0, 0, + + 0, 0, -9, -23, -24, 0, 41, 71, + 52, -23, -115, -152, -78, 92, 254, 272, + 76, -251, -493, -427, 0, 576, 900, 624, + -262, -1309, -1763, -954, 1272, 4356, 7203, 8679, + 8169, 5886, 2767, 0, -1542, -1660, -809, 240, + 848, 796, 292, -252, -507, -398, -82, 199, + 288, 183, 0, -130, -145, -71, 20, 69, + 60, 20, -15, -26, -17, -3, 0, 0, + + 0, 0, -6, -20, -26, -8, 31, 67, + 62, 0, -94, -152, -108, 45, 223, 287, + 143, -167, -454, -480, -134, 439, 866, 758, + 0, -1071, -1748, -1295, 601, 3559, 6580, 8485, + 8485, 6580, 3559, 601, -1295, -1748, -1071, 0, + 758, 866, 439, -134, -480, -454, -167, 143, + 287, 223, 45, -108, -152, -94, 0, 62, + 67, 31, -8, -26, -20, -6, 0, 0, + + 0, 0, -3, -17, -26, -15, 20, 60, + 69, 20, -71, -145, -130, 0, 183, 288, + 199, -82, -398, -507, -252, 292, 796, 848, + 240, -809, -1660, -1542, 0, 2767, 5886, 8169, + 8679, 7203, 4356, 1272, -954, -1763, -1309, -262, + 624, 900, 576, 0, -427, -493, -251, 76, + 272, 254, 92, -78, -152, -115, -23, 52, + 71, 41, 0, -24, -23, -9, 0, 0, + }; + + arm_resample_x192k_12k8( + 4, (const int16x2_t *)h, hp50, (int16x2_t *)x, y, n); +} + +#ifndef TEST_ARM +#define resample_48k_12k8 arm_resample_48k_12k8 +#endif + +#endif /* resample_48k_12k8 */ + +/** + * Return vector of correlations + */ +#ifndef correlate + +static void arm_correlate( + const int16_t *a, const int16_t *b, int n, float *y, int nc) +{ + /* --- Check alignment of `b` --- */ + + if ((uintptr_t)b & 3) + *(y++) = dot(a, b--, n), nc--; + + /* --- Processing by pair --- */ + + for ( ; nc >= 2; nc -= 2) { + const int16x2_t *an = (const int16x2_t *)(a ); + const int16x2_t *bn = (const int16x2_t *)(b--); + + int16x2_t ax, b0, b1; + int64_t v0 = 0, v1 = 0; + + b1 = (int16x2_t)*(b--) << 16; + + for (int i = 0; i < (n >> 4); i++ ) + for (int j = 0; j < 4; j++) { + + ax = *(an++), b0 = *(bn++); + v0 = __smlald (ax, b0, v0); + v1 = __smlaldx(ax, __pkhbt(b0, b1), v1); + + ax = *(an++), b1 = *(bn++); + v0 = __smlald (ax, b1, v0); + v1 = __smlaldx(ax, __pkhbt(b1, b0), v1); + } + + *(y++) = (float)((int32_t)((v0 + (1 << 5)) >> 6)); + *(y++) = (float)((int32_t)((v1 + (1 << 5)) >> 6)); + } + + /* --- Odd element count --- */ + + if (nc > 0) + *(y++) = dot(a, b, n); +} + +#ifndef TEST_ARM +#define correlate arm_correlate +#endif + +#endif /* correlate */ + +#endif /* __ARM_FEATURE_SIMD32 */ diff --git a/App_Resources/iOS/src/lc3/ltpf_neon.h b/App_Resources/iOS/src/lc3/ltpf_neon.h new file mode 100644 index 00000000..27ba5d8e --- /dev/null +++ b/App_Resources/iOS/src/lc3/ltpf_neon.h @@ -0,0 +1,281 @@ +/****************************************************************************** + * + * Copyright 2022 Google LLC + * + * 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. + * + ******************************************************************************/ + +#if __ARM_NEON && __ARM_ARCH_ISA_A64 && \ + !defined(TEST_ARM) || defined(TEST_NEON) + +#ifndef TEST_NEON +#include +#endif /* TEST_NEON */ + + +/** + * Import + */ + +static inline int32_t filter_hp50(struct lc3_ltpf_hp50_state *, int32_t); + + +/** + * Resample from 16 Khz to 12.8 KHz + */ +#ifndef resample_16k_12k8 + +LC3_HOT static void neon_resample_16k_12k8( + struct lc3_ltpf_hp50_state *hp50, const int16_t *x, int16_t *y, int n) +{ + static const int16_t h[4][20] = { + + { -61, 214, -398, 417, 0, -1052, 2686, -4529, 5997, 26233, + 5997, -4529, 2686, -1052, 0, 417, -398, 214, -61, 0 }, + + { -79, 180, -213, 0, 598, -1522, 2389, -2427, 0, 24506, + 13068, -5289, 1873, 0, -752, 763, -457, 156, 0, -28 }, + + { -61, 92, 0, -323, 861, -1361, 1317, 0, -3885, 19741, + 19741, -3885, 0, 1317, -1361, 861, -323, 0, 92, -61 }, + + { -28, 0, 156, -457, 763, -752, 0, 1873, -5289, 13068, + 24506, 0, -2427, 2389, -1522, 598, 0, -213, 180, -79 }, + + }; + + x -= 20 - 1; + + for (int i = 0; i < 5*n; i += 5) { + const int16_t *hn = h[i & 3]; + const int16_t *xn = x + (i >> 2); + int32x4_t un; + + un = vmull_s16( vld1_s16(xn), vld1_s16(hn)), xn += 4, hn += 4; + un = vmlal_s16(un, vld1_s16(xn), vld1_s16(hn)), xn += 4, hn += 4; + un = vmlal_s16(un, vld1_s16(xn), vld1_s16(hn)), xn += 4, hn += 4; + un = vmlal_s16(un, vld1_s16(xn), vld1_s16(hn)), xn += 4, hn += 4; + un = vmlal_s16(un, vld1_s16(xn), vld1_s16(hn)), xn += 4, hn += 4; + + int32_t yn = filter_hp50(hp50, vaddvq_s32(un)); + *(y++) = (yn + (1 << 15)) >> 16; + } +} + +#ifndef TEST_NEON +#define resample_16k_12k8 neon_resample_16k_12k8 +#endif + +#endif /* resample_16k_12k8 */ + +/** + * Resample from 32 Khz to 12.8 KHz + */ +#ifndef resample_32k_12k8 + +LC3_HOT static void neon_resample_32k_12k8( + struct lc3_ltpf_hp50_state *hp50, const int16_t *x, int16_t *y, int n) +{ + x -= 40 - 1; + + static const int16_t h[2][40] = { + + { -30, -31, 46, 107, 0, -199, -162, 209, 430, 0, + -681, -526, 658, 1343, 0, -2264, -1943, 2999, 9871, 13116, + 9871, 2999, -1943, -2264, 0, 1343, 658, -526, -681, 0, + 430, 209, -162, -199, 0, 107, 46, -31, -30, 0 }, + + { -14, -39, 0, 90, 78, -106, -229, 0, 382, 299, + -376, -761, 0, 1194, 937, -1214, -2644, 0, 6534, 12253, + 12253, 6534, 0, -2644, -1214, 937, 1194, 0, -761, -376, + 299, 382, 0, -229, -106, 78, 90, 0, -39, -14 }, + + }; + + for (int i = 0; i < 5*n; i += 5) { + const int16_t *hn = h[i & 1]; + const int16_t *xn = x + (i >> 1); + + int32x4_t un = vmull_s16(vld1_s16(xn), vld1_s16(hn)); + xn += 4, hn += 4; + + for (int i = 1; i < 10; i++) + un = vmlal_s16(un, vld1_s16(xn), vld1_s16(hn)), xn += 4, hn += 4; + + int32_t yn = filter_hp50(hp50, vaddvq_s32(un)); + *(y++) = (yn + (1 << 15)) >> 16; + } +} + +#ifndef TEST_NEON +#define resample_32k_12k8 neon_resample_32k_12k8 +#endif + +#endif /* resample_32k_12k8 */ + +/** + * Resample from 48 Khz to 12.8 KHz + */ +#ifndef resample_48k_12k8 + +LC3_HOT static void neon_resample_48k_12k8( + struct lc3_ltpf_hp50_state *hp50, const int16_t *x, int16_t *y, int n) +{ + alignas(16) static const int16_t h[4][64] = { + + { -13, -25, -20, 10, 51, 71, 38, -47, -133, -145, + -42, 139, 277, 242, 0, -329, -511, -351, 144, 698, + 895, 450, -535, -1510, -1697, -521, 1999, 5138, 7737, 8744, + 7737, 5138, 1999, -521, -1697, -1510, -535, 450, 895, 698, + 144, -351, -511, -329, 0, 242, 277, 139, -42, -145, + -133, -47, 38, 71, 51, 10, -20, -25, -13, 0 }, + + { -9, -23, -24, 0, 41, 71, 52, -23, -115, -152, + -78, 92, 254, 272, 76, -251, -493, -427, 0, 576, + 900, 624, -262, -1309, -1763, -954, 1272, 4356, 7203, 8679, + 8169, 5886, 2767, 0, -1542, -1660, -809, 240, 848, 796, + 292, -252, -507, -398, -82, 199, 288, 183, 0, -130, + -145, -71, 20, 69, 60, 20, -15, -26, -17, -3 }, + + { -6, -20, -26, -8, 31, 67, 62, 0, -94, -152, + -108, 45, 223, 287, 143, -167, -454, -480, -134, 439, + 866, 758, 0, -1071, -1748, -1295, 601, 3559, 6580, 8485, + 8485, 6580, 3559, 601, -1295, -1748, -1071, 0, 758, 866, + 439, -134, -480, -454, -167, 143, 287, 223, 45, -108, + -152, -94, 0, 62, 67, 31, -8, -26, -20, -6 }, + + { -3, -17, -26, -15, 20, 60, 69, 20, -71, -145, + -130, 0, 183, 288, 199, -82, -398, -507, -252, 292, + 796, 848, 240, -809, -1660, -1542, 0, 2767, 5886, 8169, + 8679, 7203, 4356, 1272, -954, -1763, -1309, -262, 624, 900, + 576, 0, -427, -493, -251, 76, 272, 254, 92, -78, + -152, -115, -23, 52, 71, 41, 0, -24, -23, -9 }, + + }; + + x -= 60 - 1; + + for (int i = 0; i < 15*n; i += 15) { + const int16_t *hn = h[i & 3]; + const int16_t *xn = x + (i >> 2); + + int32x4_t un = vmull_s16(vld1_s16(xn), vld1_s16(hn)); + xn += 4, hn += 4; + + for (int i = 1; i < 15; i++) + un = vmlal_s16(un, vld1_s16(xn), vld1_s16(hn)), xn += 4, hn += 4; + + int32_t yn = filter_hp50(hp50, vaddvq_s32(un)); + *(y++) = (yn + (1 << 15)) >> 16; + } +} + +#ifndef TEST_NEON +#define resample_48k_12k8 neon_resample_48k_12k8 +#endif + +#endif /* resample_48k_12k8 */ + +/** + * Return dot product of 2 vectors + */ +#ifndef dot + +LC3_HOT static inline float neon_dot(const int16_t *a, const int16_t *b, int n) +{ + int64x2_t v = vmovq_n_s64(0); + + for (int i = 0; i < (n >> 4); i++) { + int32x4_t u; + + u = vmull_s16( vld1_s16(a), vld1_s16(b)), a += 4, b += 4; + u = vmlal_s16(u, vld1_s16(a), vld1_s16(b)), a += 4, b += 4; + v = vpadalq_s32(v, u); + + u = vmull_s16( vld1_s16(a), vld1_s16(b)), a += 4, b += 4; + u = vmlal_s16(u, vld1_s16(a), vld1_s16(b)), a += 4, b += 4; + v = vpadalq_s32(v, u); + } + + int32_t v32 = (vaddvq_s64(v) + (1 << 5)) >> 6; + return (float)v32; +} + +#ifndef TEST_NEON +#define dot neon_dot +#endif + +#endif /* dot */ + +/** + * Return vector of correlations + */ +#ifndef correlate + +LC3_HOT static void neon_correlate( + const int16_t *a, const int16_t *b, int n, float *y, int nc) +{ + for ( ; nc >= 4; nc -= 4, b -= 4) { + const int16_t *an = (const int16_t *)a; + const int16_t *bn = (const int16_t *)b; + + int64x2_t v0 = vmovq_n_s64(0), v1 = v0, v2 = v0, v3 = v0; + int16x4_t ax, b0, b1; + + b0 = vld1_s16(bn-4); + + for (int i=0; i < (n >> 4); i++ ) + for (int j = 0; j < 2; j++) { + int32x4_t u0, u1, u2, u3; + + b1 = b0; + b0 = vld1_s16(bn), bn += 4; + ax = vld1_s16(an), an += 4; + + u0 = vmull_s16(ax, b0); + u1 = vmull_s16(ax, vext_s16(b1, b0, 3)); + u2 = vmull_s16(ax, vext_s16(b1, b0, 2)); + u3 = vmull_s16(ax, vext_s16(b1, b0, 1)); + + b1 = b0; + b0 = vld1_s16(bn), bn += 4; + ax = vld1_s16(an), an += 4; + + u0 = vmlal_s16(u0, ax, b0); + u1 = vmlal_s16(u1, ax, vext_s16(b1, b0, 3)); + u2 = vmlal_s16(u2, ax, vext_s16(b1, b0, 2)); + u3 = vmlal_s16(u3, ax, vext_s16(b1, b0, 1)); + + v0 = vpadalq_s32(v0, u0); + v1 = vpadalq_s32(v1, u1); + v2 = vpadalq_s32(v2, u2); + v3 = vpadalq_s32(v3, u3); + } + + *(y++) = (float)((int32_t)((vaddvq_s64(v0) + (1 << 5)) >> 6)); + *(y++) = (float)((int32_t)((vaddvq_s64(v1) + (1 << 5)) >> 6)); + *(y++) = (float)((int32_t)((vaddvq_s64(v2) + (1 << 5)) >> 6)); + *(y++) = (float)((int32_t)((vaddvq_s64(v3) + (1 << 5)) >> 6)); + } + + for ( ; nc > 0; nc--) + *(y++) = neon_dot(a, b--, n); +} +#endif /* correlate */ + +#ifndef TEST_NEON +#define correlate neon_correlate +#endif + +#endif /* __ARM_NEON && __ARM_ARCH_ISA_A64 */ diff --git a/App_Resources/iOS/src/lc3/mdct.c b/App_Resources/iOS/src/lc3/mdct.c new file mode 100644 index 00000000..51d9579c --- /dev/null +++ b/App_Resources/iOS/src/lc3/mdct.c @@ -0,0 +1,475 @@ +/****************************************************************************** + * + * Copyright 2022 Google LLC + * + * 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 "mdct.h" +#include "tables.h" + +#include "mdct_neon.h" + + +/* ---------------------------------------------------------------------------- + * FFT processing + * -------------------------------------------------------------------------- */ + +/** + * FFT 5 Points + * x, y Input and output coefficients, of size 5xn + * n Number of interleaved transform to perform (n % 2 = 0) + */ +#ifndef fft_5 +LC3_HOT static inline void fft_5( + const struct lc3_complex *x, struct lc3_complex *y, int n) +{ + static const float cos1 = 0.3090169944; /* cos(-2Pi 1/5) */ + static const float cos2 = -0.8090169944; /* cos(-2Pi 2/5) */ + + static const float sin1 = -0.9510565163; /* sin(-2Pi 1/5) */ + static const float sin2 = -0.5877852523; /* sin(-2Pi 2/5) */ + + for (int i = 0; i < n; i++, x++, y+= 5) { + + struct lc3_complex s14 = + { x[1*n].re + x[4*n].re, x[1*n].im + x[4*n].im }; + struct lc3_complex d14 = + { x[1*n].re - x[4*n].re, x[1*n].im - x[4*n].im }; + + struct lc3_complex s23 = + { x[2*n].re + x[3*n].re, x[2*n].im + x[3*n].im }; + struct lc3_complex d23 = + { x[2*n].re - x[3*n].re, x[2*n].im - x[3*n].im }; + + y[0].re = x[0].re + s14.re + s23.re; + + y[0].im = x[0].im + s14.im + s23.im; + + y[1].re = x[0].re + s14.re * cos1 - d14.im * sin1 + + s23.re * cos2 - d23.im * sin2; + + y[1].im = x[0].im + s14.im * cos1 + d14.re * sin1 + + s23.im * cos2 + d23.re * sin2; + + y[2].re = x[0].re + s14.re * cos2 - d14.im * sin2 + + s23.re * cos1 + d23.im * sin1; + + y[2].im = x[0].im + s14.im * cos2 + d14.re * sin2 + + s23.im * cos1 - d23.re * sin1; + + y[3].re = x[0].re + s14.re * cos2 + d14.im * sin2 + + s23.re * cos1 - d23.im * sin1; + + y[3].im = x[0].im + s14.im * cos2 - d14.re * sin2 + + s23.im * cos1 + d23.re * sin1; + + y[4].re = x[0].re + s14.re * cos1 + d14.im * sin1 + + s23.re * cos2 + d23.im * sin2; + + y[4].im = x[0].im + s14.im * cos1 - d14.re * sin1 + + s23.im * cos2 - d23.re * sin2; + } +} +#endif /* fft_5 */ + +/** + * FFT Butterfly 3 Points + * x, y Input and output coefficients + * twiddles Twiddles factors, determine size of transform + * n Number of interleaved transforms + */ +#ifndef fft_bf3 +LC3_HOT static inline void fft_bf3( + const struct lc3_fft_bf3_twiddles *twiddles, + const struct lc3_complex *x, struct lc3_complex *y, int n) +{ + int n3 = twiddles->n3; + const struct lc3_complex (*w0)[2] = twiddles->t; + const struct lc3_complex (*w1)[2] = w0 + n3, (*w2)[2] = w1 + n3; + + const struct lc3_complex *x0 = x, *x1 = x0 + n*n3, *x2 = x1 + n*n3; + struct lc3_complex *y0 = y, *y1 = y0 + n3, *y2 = y1 + n3; + + for (int i = 0; i < n; i++, y0 += 3*n3, y1 += 3*n3, y2 += 3*n3) + for (int j = 0; j < n3; j++, x0++, x1++, x2++) { + + y0[j].re = x0->re + x1->re * w0[j][0].re - x1->im * w0[j][0].im + + x2->re * w0[j][1].re - x2->im * w0[j][1].im; + + y0[j].im = x0->im + x1->im * w0[j][0].re + x1->re * w0[j][0].im + + x2->im * w0[j][1].re + x2->re * w0[j][1].im; + + y1[j].re = x0->re + x1->re * w1[j][0].re - x1->im * w1[j][0].im + + x2->re * w1[j][1].re - x2->im * w1[j][1].im; + + y1[j].im = x0->im + x1->im * w1[j][0].re + x1->re * w1[j][0].im + + x2->im * w1[j][1].re + x2->re * w1[j][1].im; + + y2[j].re = x0->re + x1->re * w2[j][0].re - x1->im * w2[j][0].im + + x2->re * w2[j][1].re - x2->im * w2[j][1].im; + + y2[j].im = x0->im + x1->im * w2[j][0].re + x1->re * w2[j][0].im + + x2->im * w2[j][1].re + x2->re * w2[j][1].im; + } +} +#endif /* fft_bf3 */ + +/** + * FFT Butterfly 2 Points + * twiddles Twiddles factors, determine size of transform + * x, y Input and output coefficients + * n Number of interleaved transforms + */ +#ifndef fft_bf2 +LC3_HOT static inline void fft_bf2( + const struct lc3_fft_bf2_twiddles *twiddles, + const struct lc3_complex *x, struct lc3_complex *y, int n) +{ + int n2 = twiddles->n2; + const struct lc3_complex *w = twiddles->t; + + const struct lc3_complex *x0 = x, *x1 = x0 + n*n2; + struct lc3_complex *y0 = y, *y1 = y0 + n2; + + for (int i = 0; i < n; i++, y0 += 2*n2, y1 += 2*n2) { + + for (int j = 0; j < n2; j++, x0++, x1++) { + + y0[j].re = x0->re + x1->re * w[j].re - x1->im * w[j].im; + y0[j].im = x0->im + x1->im * w[j].re + x1->re * w[j].im; + + y1[j].re = x0->re - x1->re * w[j].re + x1->im * w[j].im; + y1[j].im = x0->im - x1->im * w[j].re - x1->re * w[j].im; + } + } +} +#endif /* fft_bf2 */ + +/** + * Perform FFT + * x, y0, y1 Input, and 2 scratch buffers of size `n` + * n Number of points 30, 40, 60, 80, 90, 120, 160, 180, 240, 480 + * return The buffer `y0` or `y1` that hold the result + * + * Input `x` can be the same as the `y0` second scratch buffer + */ +static struct lc3_complex *fft(const struct lc3_complex *x, int n, + struct lc3_complex *y0, struct lc3_complex *y1) +{ + struct lc3_complex *y[2] = { y1, y0 }; + int i2, i3, is = 0; + + /* The number of points `n` can be decomposed as : + * + * n = 5^1 * 3^n3 * 2^n2 + * + * for n = 10, 20, 40, 80, 160 n3 = 0, n2 = [1..5] + * n = 30, 60, 120, 240, 480 n3 = 1, n2 = [1..5] + * n = 90, 180 n3 = 2, n2 = [1..2] + * + * Note that the expression `n & (n-1) == 0` is equivalent + * to the check that `n` is a power of 2. */ + + fft_5(x, y[is], n /= 5); + + for (i3 = 0; n & (n-1); i3++, is ^= 1) + fft_bf3(lc3_fft_twiddles_bf3[i3], y[is], y[is ^ 1], n /= 3); + + for (i2 = 0; n > 1; i2++, is ^= 1) + fft_bf2(lc3_fft_twiddles_bf2[i2][i3], y[is], y[is ^ 1], n >>= 1); + + return y[is]; +} + + +/* ---------------------------------------------------------------------------- + * MDCT processing + * -------------------------------------------------------------------------- */ + +/** + * Windowing of samples before MDCT + * dt, sr Duration and samplerate + * x, y Input current and delayed samples + * y, d Output windowed samples, and delayed ones + */ +LC3_HOT static void mdct_window( + enum lc3_dt dt, enum lc3_srate sr, + const float *x, float *d, float *y) +{ + const float *win = lc3_mdct_win[dt][sr]; + int ns = lc3_ns(dt, sr), nd = lc3_nd(dt, sr); + + const float *w0 = win, *w1 = w0 + ns; + const float *w2 = w1, *w3 = w2 + nd; + + const float *x0 = x + ns-nd, *x1 = x0; + float *y0 = y + ns/2, *y1 = y0; + float *d0 = d, *d1 = d + nd; + + while (x1 > x) { + *(--y0) = *d0 * *(w0++) - *(--x1) * *(--w1); + *(y1++) = (*(d0++) = *(x0++)) * *(w2++); + + *(--y0) = *d0 * *(w0++) - *(--x1) * *(--w1); + *(y1++) = (*(d0++) = *(x0++)) * *(w2++); + } + + for (x1 += ns; x0 < x1; ) { + *(--y0) = *d0 * *(w0++) - *(--d1) * *(--w1); + *(y1++) = (*(d0++) = *(x0++)) * *(w2++) + (*d1 = *(--x1)) * *(--w3); + + *(--y0) = *d0 * *(w0++) - *(--d1) * *(--w1); + *(y1++) = (*(d0++) = *(x0++)) * *(w2++) + (*d1 = *(--x1)) * *(--w3); + } +} + +/** + * Pre-rotate MDCT coefficients of N/2 points, before FFT N/4 points FFT + * def Size and twiddles factors + * x, y Input and output coefficients + * + * `x` and y` can be the same buffer + */ +LC3_HOT static void mdct_pre_fft(const struct lc3_mdct_rot_def *def, + const float *x, struct lc3_complex *y) +{ + int n4 = def->n4; + + const float *x0 = x, *x1 = x0 + 2*n4; + const struct lc3_complex *w0 = def->w, *w1 = w0 + n4; + struct lc3_complex *y0 = y, *y1 = y0 + n4; + + while (x0 < x1) { + struct lc3_complex u, uw = *(w0++); + u.re = - *(--x1) * uw.re + *x0 * uw.im; + u.im = *(x0++) * uw.re + *x1 * uw.im; + + struct lc3_complex v, vw = *(--w1); + v.re = - *(--x1) * vw.im + *x0 * vw.re; + v.im = - *(x0++) * vw.im - *x1 * vw.re; + + *(y0++) = u; + *(--y1) = v; + } +} + +/** + * Post-rotate FFT N/4 points coefficients, resulting MDCT N points + * def Size and twiddles factors + * x, y Input and output coefficients + * + * `x` and y` can be the same buffer + */ +LC3_HOT static void mdct_post_fft(const struct lc3_mdct_rot_def *def, + const struct lc3_complex *x, float *y) +{ + int n4 = def->n4, n8 = n4 >> 1; + + const struct lc3_complex *w0 = def->w + n8, *w1 = w0 - 1; + const struct lc3_complex *x0 = x + n8, *x1 = x0 - 1; + + float *y0 = y + n4, *y1 = y0; + + for ( ; y1 > y; x0++, x1--, w0++, w1--) { + + float u0 = x0->im * w0->im + x0->re * w0->re; + float u1 = x1->re * w1->im - x1->im * w1->re; + + float v0 = x0->re * w0->im - x0->im * w0->re; + float v1 = x1->im * w1->im + x1->re * w1->re; + + *(y0++) = u0; *(y0++) = u1; + *(--y1) = v0; *(--y1) = v1; + } +} + +/** + * Pre-rotate IMDCT coefficients of N points, before FFT N/4 points FFT + * def Size and twiddles factors + * x, y Input and output coefficients + * + * `x` and `y` can be the same buffer + * The real and imaginary parts of `y` are swapped, + * to operate on FFT instead of IFFT + */ +LC3_HOT static void imdct_pre_fft(const struct lc3_mdct_rot_def *def, + const float *x, struct lc3_complex *y) +{ + int n4 = def->n4; + + const float *x0 = x, *x1 = x0 + 2*n4; + + const struct lc3_complex *w0 = def->w, *w1 = w0 + n4; + struct lc3_complex *y0 = y, *y1 = y0 + n4; + + while (x0 < x1) { + float u0 = *(x0++), u1 = *(--x1); + float v0 = *(x0++), v1 = *(--x1); + struct lc3_complex uw = *(w0++), vw = *(--w1); + + (y0 )->re = - u0 * uw.re - u1 * uw.im; + (y0++)->im = - u1 * uw.re + u0 * uw.im; + + (--y1)->re = - v1 * vw.re - v0 * vw.im; + ( y1)->im = - v0 * vw.re + v1 * vw.im; + } +} + +/** + * Post-rotate FFT N/4 points coefficients, resulting IMDCT N points + * def Size and twiddles factors + * x, y Input and output coefficients + * + * `x` and y` can be the same buffer + * The real and imaginary parts of `x` are swapped, + * to operate on FFT instead of IFFT + */ +LC3_HOT static void imdct_post_fft(const struct lc3_mdct_rot_def *def, + const struct lc3_complex *x, float *y) +{ + int n4 = def->n4; + + const struct lc3_complex *w0 = def->w, *w1 = w0 + n4; + const struct lc3_complex *x0 = x, *x1 = x0 + n4; + + float *y0 = y, *y1 = y0 + 2*n4; + + while (x0 < x1) { + struct lc3_complex uz = *(x0++), vz = *(--x1); + struct lc3_complex uw = *(w0++), vw = *(--w1); + + *(y0++) = uz.re * uw.im - uz.im * uw.re; + *(--y1) = uz.re * uw.re + uz.im * uw.im; + + *(--y1) = vz.re * vw.im - vz.im * vw.re; + *(y0++) = vz.re * vw.re + vz.im * vw.im; + } +} + +/** + * Apply windowing of samples + * dt, sr Duration and samplerate + * x, d Middle half of IMDCT coefficients and delayed samples + * y, d Output samples and delayed ones + */ +LC3_HOT static void imdct_window( + enum lc3_dt dt, enum lc3_srate sr, + const float *x, float *d, float *y) +{ + /* The full MDCT coefficients is given by symmetry : + * T[ 0 .. n/4-1] = -half[n/4-1 .. 0 ] + * T[ n/4 .. n/2-1] = half[0 .. n/4-1] + * T[ n/2 .. 3n/4-1] = half[n/4 .. n/2-1] + * T[3n/4 .. n-1] = half[n/2-1 .. n/4 ] */ + + const float *win = lc3_mdct_win[dt][sr]; + int n4 = lc3_ns(dt, sr) >> 1, nd = lc3_nd(dt, sr); + const float *w2 = win, *w0 = w2 + 3*n4, *w1 = w0; + + const float *x0 = d + nd-n4, *x1 = x0; + float *y0 = y + nd-n4, *y1 = y0, *y2 = d + nd, *y3 = d; + + while (y0 > y) { + *(--y0) = *(--x0) - *(x ) * *(w1++); + *(y1++) = *(x1++) + *(x++) * *(--w0); + + *(--y0) = *(--x0) - *(x ) * *(w1++); + *(y1++) = *(x1++) + *(x++) * *(--w0); + } + + while (y1 < y + nd) { + *(y1++) = *(x1++) + *(x++) * *(--w0); + *(y1++) = *(x1++) + *(x++) * *(--w0); + } + + while (y1 < y + 2*n4) { + *(y1++) = *(x ) * *(--w0); + *(--y2) = *(x++) * *(w2++); + + *(y1++) = *(x ) * *(--w0); + *(--y2) = *(x++) * *(w2++); + } + + while (y2 > y3) { + *(y3++) = *(x ) * *(--w0); + *(--y2) = *(x++) * *(w2++); + + *(y3++) = *(x ) * *(--w0); + *(--y2) = *(x++) * *(w2++); + } +} + +/** + * Rescale samples + * x, n Input and count of samples, scaled as output + * scale Scale factor + */ +LC3_HOT static void rescale(float *x, int n, float f) +{ + for (int i = 0; i < (n >> 2); i++) { + *(x++) *= f; *(x++) *= f; + *(x++) *= f; *(x++) *= f; + } +} + +/** + * Forward MDCT transformation + */ +void lc3_mdct_forward( + enum lc3_dt dt, enum lc3_srate sr, enum lc3_srate sr_dst, + const float *x, float *d, float *y) +{ + const struct lc3_mdct_rot_def *rot = lc3_mdct_rot[dt][sr]; + int ns_dst = lc3_ns(dt, sr_dst); + int ns = lc3_ns(dt, sr); + + struct lc3_complex buffer[LC3_MAX_NS / 2]; + struct lc3_complex *z = (struct lc3_complex *)y; + union { float *f; struct lc3_complex *z; } u = { .z = buffer }; + + mdct_window(dt, sr, x, d, u.f); + + mdct_pre_fft(rot, u.f, u.z); + u.z = fft(u.z, ns/2, u.z, z); + mdct_post_fft(rot, u.z, y); + + if (ns != ns_dst) + rescale(y, ns_dst, sqrtf((float)ns_dst / ns)); +} + +/** + * Inverse MDCT transformation + */ +void lc3_mdct_inverse( + enum lc3_dt dt, enum lc3_srate sr, enum lc3_srate sr_src, + const float *x, float *d, float *y) +{ + const struct lc3_mdct_rot_def *rot = lc3_mdct_rot[dt][sr]; + int ns_src = lc3_ns(dt, sr_src); + int ns = lc3_ns(dt, sr); + + struct lc3_complex buffer[LC3_MAX_NS / 2]; + struct lc3_complex *z = (struct lc3_complex *)y; + union { float *f; struct lc3_complex *z; } u = { .z = buffer }; + + imdct_pre_fft(rot, x, z); + z = fft(z, ns/2, z, u.z); + imdct_post_fft(rot, z, u.f); + + if (ns != ns_src) + rescale(u.f, ns, sqrtf((float)ns / ns_src)); + + imdct_window(dt, sr, u.f, d, y); +} diff --git a/App_Resources/iOS/src/lc3/mdct.h b/App_Resources/iOS/src/lc3/mdct.h new file mode 100644 index 00000000..18d08b99 --- /dev/null +++ b/App_Resources/iOS/src/lc3/mdct.h @@ -0,0 +1,52 @@ +/****************************************************************************** + * + * Copyright 2022 Google LLC + * + * 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. + * + ******************************************************************************/ + +#ifndef __LC3_MDCT_H +#define __LC3_MDCT_H + +#include "common.h" + + +/** + * Forward MDCT transformation + * dt, sr Duration and samplerate (size of the transform) + * sr_dst Samplerate destination, scale transforam accordingly + * x, d Temporal samples and delayed buffer + * y, d Output `ns` coefficients and `nd` delayed samples + * + * `x` and `y` can be the same buffer + */ +void lc3_mdct_forward( + enum lc3_dt dt, enum lc3_srate sr, enum lc3_srate sr_dst, + const float *x, float *d, float *y); + +/** + * Inverse MDCT transformation + * dt, sr Duration and samplerate (size of the transform) + * sr_src Samplerate source, scale transforam accordingly + * x, d Frequency coefficients and delayed buffer + * y, d Output `ns` samples and `nd` delayed ones + * + * `x` and `y` can be the same buffer + */ +void lc3_mdct_inverse( + enum lc3_dt dt, enum lc3_srate sr, enum lc3_srate sr_src, + const float *x, float *d, float *y); + + +#endif /* __LC3_MDCT_H */ diff --git a/App_Resources/iOS/src/lc3/mdct_neon.h b/App_Resources/iOS/src/lc3/mdct_neon.h new file mode 100644 index 00000000..a970d4ad --- /dev/null +++ b/App_Resources/iOS/src/lc3/mdct_neon.h @@ -0,0 +1,296 @@ +/****************************************************************************** + * + * Copyright 2022 Google LLC + * + * 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. + * + ******************************************************************************/ + +#if __ARM_NEON && __ARM_ARCH_ISA_A64 && \ + !defined(TEST_ARM) || defined(TEST_NEON) + +#ifndef TEST_NEON +#include +#endif /* TEST_NEON */ + + +/** + * FFT 5 Points + * The number of interleaved transform `n` assumed to be even + */ +#ifndef fft_5 + +LC3_HOT static inline void neon_fft_5( + const struct lc3_complex *x, struct lc3_complex *y, int n) +{ + static const union { float f[2]; uint64_t u64; } + __cos1 = { { 0.3090169944, 0.3090169944 } }, + __cos2 = { { -0.8090169944, -0.8090169944 } }, + __sin1 = { { 0.9510565163, -0.9510565163 } }, + __sin2 = { { 0.5877852523, -0.5877852523 } }; + + float32x2_t sin1 = vcreate_f32(__sin1.u64); + float32x2_t sin2 = vcreate_f32(__sin2.u64); + float32x2_t cos1 = vcreate_f32(__cos1.u64); + float32x2_t cos2 = vcreate_f32(__cos2.u64); + + float32x4_t sin1q = vcombine_f32(sin1, sin1); + float32x4_t sin2q = vcombine_f32(sin2, sin2); + float32x4_t cos1q = vcombine_f32(cos1, cos1); + float32x4_t cos2q = vcombine_f32(cos2, cos2); + + for (int i = 0; i < n; i += 2, x += 2, y += 10) { + + float32x4_t y0, y1, y2, y3, y4; + + float32x4_t x0 = vld1q_f32( (float *)(x + 0*n) ); + float32x4_t x1 = vld1q_f32( (float *)(x + 1*n) ); + float32x4_t x2 = vld1q_f32( (float *)(x + 2*n) ); + float32x4_t x3 = vld1q_f32( (float *)(x + 3*n) ); + float32x4_t x4 = vld1q_f32( (float *)(x + 4*n) ); + + float32x4_t s14 = vaddq_f32(x1, x4); + float32x4_t s23 = vaddq_f32(x2, x3); + + float32x4_t d14 = vrev64q_f32( vsubq_f32(x1, x4) ); + float32x4_t d23 = vrev64q_f32( vsubq_f32(x2, x3) ); + + y0 = vaddq_f32( x0, vaddq_f32(s14, s23) ); + + y4 = vfmaq_f32( x0, s14, cos1q ); + y4 = vfmaq_f32( y4, s23, cos2q ); + + y1 = vfmaq_f32( y4, d14, sin1q ); + y1 = vfmaq_f32( y1, d23, sin2q ); + + y4 = vfmsq_f32( y4, d14, sin1q ); + y4 = vfmsq_f32( y4, d23, sin2q ); + + y3 = vfmaq_f32( x0, s14, cos2q ); + y3 = vfmaq_f32( y3, s23, cos1q ); + + y2 = vfmaq_f32( y3, d14, sin2q ); + y2 = vfmsq_f32( y2, d23, sin1q ); + + y3 = vfmsq_f32( y3, d14, sin2q ); + y3 = vfmaq_f32( y3, d23, sin1q ); + + vst1_f32( (float *)(y + 0), vget_low_f32(y0) ); + vst1_f32( (float *)(y + 1), vget_low_f32(y1) ); + vst1_f32( (float *)(y + 2), vget_low_f32(y2) ); + vst1_f32( (float *)(y + 3), vget_low_f32(y3) ); + vst1_f32( (float *)(y + 4), vget_low_f32(y4) ); + + vst1_f32( (float *)(y + 5), vget_high_f32(y0) ); + vst1_f32( (float *)(y + 6), vget_high_f32(y1) ); + vst1_f32( (float *)(y + 7), vget_high_f32(y2) ); + vst1_f32( (float *)(y + 8), vget_high_f32(y3) ); + vst1_f32( (float *)(y + 9), vget_high_f32(y4) ); + } +} + +#ifndef TEST_NEON +#define fft_5 neon_fft_5 +#endif + +#endif /* fft_5 */ + +/** + * FFT Butterfly 3 Points + */ +#ifndef fft_bf3 + +LC3_HOT static inline void neon_fft_bf3( + const struct lc3_fft_bf3_twiddles *twiddles, + const struct lc3_complex *x, struct lc3_complex *y, int n) +{ + int n3 = twiddles->n3; + const struct lc3_complex (*w0_ptr)[2] = twiddles->t; + const struct lc3_complex (*w1_ptr)[2] = w0_ptr + n3; + const struct lc3_complex (*w2_ptr)[2] = w1_ptr + n3; + + const struct lc3_complex *x0_ptr = x; + const struct lc3_complex *x1_ptr = x0_ptr + n*n3; + const struct lc3_complex *x2_ptr = x1_ptr + n*n3; + + struct lc3_complex *y0_ptr = y; + struct lc3_complex *y1_ptr = y0_ptr + n3; + struct lc3_complex *y2_ptr = y1_ptr + n3; + + for (int j, i = 0; i < n; i++, + y0_ptr += 3*n3, y1_ptr += 3*n3, y2_ptr += 3*n3) { + + /* --- Process by pair --- */ + + for (j = 0; j < (n3 >> 1); j++, + x0_ptr += 2, x1_ptr += 2, x2_ptr += 2) { + + float32x4_t x0 = vld1q_f32( (float *)x0_ptr ); + float32x4_t x1 = vld1q_f32( (float *)x1_ptr ); + float32x4_t x2 = vld1q_f32( (float *)x2_ptr ); + + float32x4_t x1r = vtrn1q_f32( vrev64q_f32(vnegq_f32(x1)), x1 ); + float32x4_t x2r = vtrn1q_f32( vrev64q_f32(vnegq_f32(x2)), x2 ); + + float32x4x2_t wn; + float32x4_t yn; + + wn = vld2q_f32( (float *)(w0_ptr + 2*j) ); + + yn = vfmaq_f32( x0, x1 , vtrn1q_f32(wn.val[0], wn.val[0]) ); + yn = vfmaq_f32( yn, x1r, vtrn1q_f32(wn.val[1], wn.val[1]) ); + yn = vfmaq_f32( yn, x2 , vtrn2q_f32(wn.val[0], wn.val[0]) ); + yn = vfmaq_f32( yn, x2r, vtrn2q_f32(wn.val[1], wn.val[1]) ); + vst1q_f32( (float *)(y0_ptr + 2*j), yn ); + + wn = vld2q_f32( (float *)(w1_ptr + 2*j) ); + + yn = vfmaq_f32( x0, x1 , vtrn1q_f32(wn.val[0], wn.val[0]) ); + yn = vfmaq_f32( yn, x1r, vtrn1q_f32(wn.val[1], wn.val[1]) ); + yn = vfmaq_f32( yn, x2 , vtrn2q_f32(wn.val[0], wn.val[0]) ); + yn = vfmaq_f32( yn, x2r, vtrn2q_f32(wn.val[1], wn.val[1]) ); + vst1q_f32( (float *)(y1_ptr + 2*j), yn ); + + wn = vld2q_f32( (float *)(w2_ptr + 2*j) ); + + yn = vfmaq_f32( x0, x1 , vtrn1q_f32(wn.val[0], wn.val[0]) ); + yn = vfmaq_f32( yn, x1r, vtrn1q_f32(wn.val[1], wn.val[1]) ); + yn = vfmaq_f32( yn, x2 , vtrn2q_f32(wn.val[0], wn.val[0]) ); + yn = vfmaq_f32( yn, x2r, vtrn2q_f32(wn.val[1], wn.val[1]) ); + vst1q_f32( (float *)(y2_ptr + 2*j), yn ); + + } + + /* --- Last iteration --- */ + + if (n3 & 1) { + + float32x2x2_t wn; + float32x2_t yn; + + float32x2_t x0 = vld1_f32( (float *)(x0_ptr++) ); + float32x2_t x1 = vld1_f32( (float *)(x1_ptr++) ); + float32x2_t x2 = vld1_f32( (float *)(x2_ptr++) ); + + float32x2_t x1r = vtrn1_f32( vrev64_f32(vneg_f32(x1)), x1 ); + float32x2_t x2r = vtrn1_f32( vrev64_f32(vneg_f32(x2)), x2 ); + + wn = vld2_f32( (float *)(w0_ptr + 2*j) ); + + yn = vfma_f32( x0, x1 , vtrn1_f32(wn.val[0], wn.val[0]) ); + yn = vfma_f32( yn, x1r, vtrn1_f32(wn.val[1], wn.val[1]) ); + yn = vfma_f32( yn, x2 , vtrn2_f32(wn.val[0], wn.val[0]) ); + yn = vfma_f32( yn, x2r, vtrn2_f32(wn.val[1], wn.val[1]) ); + vst1_f32( (float *)(y0_ptr + 2*j), yn ); + + wn = vld2_f32( (float *)(w1_ptr + 2*j) ); + + yn = vfma_f32( x0, x1 , vtrn1_f32(wn.val[0], wn.val[0]) ); + yn = vfma_f32( yn, x1r, vtrn1_f32(wn.val[1], wn.val[1]) ); + yn = vfma_f32( yn, x2 , vtrn2_f32(wn.val[0], wn.val[0]) ); + yn = vfma_f32( yn, x2r, vtrn2_f32(wn.val[1], wn.val[1]) ); + vst1_f32( (float *)(y1_ptr + 2*j), yn ); + + wn = vld2_f32( (float *)(w2_ptr + 2*j) ); + + yn = vfma_f32( x0, x1 , vtrn1_f32(wn.val[0], wn.val[0]) ); + yn = vfma_f32( yn, x1r, vtrn1_f32(wn.val[1], wn.val[1]) ); + yn = vfma_f32( yn, x2 , vtrn2_f32(wn.val[0], wn.val[0]) ); + yn = vfma_f32( yn, x2r, vtrn2_f32(wn.val[1], wn.val[1]) ); + vst1_f32( (float *)(y2_ptr + 2*j), yn ); + } + + } +} + +#ifndef TEST_NEON +#define fft_bf3 neon_fft_bf3 +#endif + +#endif /* fft_bf3 */ + +/** + * FFT Butterfly 2 Points + */ +#ifndef fft_bf2 + +LC3_HOT static inline void neon_fft_bf2( + const struct lc3_fft_bf2_twiddles *twiddles, + const struct lc3_complex *x, struct lc3_complex *y, int n) +{ + int n2 = twiddles->n2; + const struct lc3_complex *w_ptr = twiddles->t; + + const struct lc3_complex *x0_ptr = x; + const struct lc3_complex *x1_ptr = x0_ptr + n*n2; + + struct lc3_complex *y0_ptr = y; + struct lc3_complex *y1_ptr = y0_ptr + n2; + + for (int j, i = 0; i < n; i++, y0_ptr += 2*n2, y1_ptr += 2*n2) { + + /* --- Process by pair --- */ + + for (j = 0; j < (n2 >> 1); j++, x0_ptr += 2, x1_ptr += 2) { + + float32x4_t x0 = vld1q_f32( (float *)x0_ptr ); + float32x4_t x1 = vld1q_f32( (float *)x1_ptr ); + float32x4_t y0, y1; + + float32x4_t x1r = vtrn1q_f32( vrev64q_f32(vnegq_f32(x1)), x1 ); + + float32x4_t w = vld1q_f32( (float *)(w_ptr + 2*j) ); + float32x4_t w_re = vtrn1q_f32(w, w); + float32x4_t w_im = vtrn2q_f32(w, w); + + y0 = vfmaq_f32( x0, x1 , w_re ); + y0 = vfmaq_f32( y0, x1r, w_im ); + vst1q_f32( (float *)(y0_ptr + 2*j), y0 ); + + y1 = vfmsq_f32( x0, x1 , w_re ); + y1 = vfmsq_f32( y1, x1r, w_im ); + vst1q_f32( (float *)(y1_ptr + 2*j), y1 ); + } + + /* --- Last iteration --- */ + + if (n2 & 1) { + + float32x2_t x0 = vld1_f32( (float *)(x0_ptr++) ); + float32x2_t x1 = vld1_f32( (float *)(x1_ptr++) ); + float32x2_t y0, y1; + + float32x2_t x1r = vtrn1_f32( vrev64_f32(vneg_f32(x1)), x1 ); + + float32x2_t w = vld1_f32( (float *)(w_ptr + 2*j) ); + float32x2_t w_re = vtrn1_f32(w, w); + float32x2_t w_im = vtrn2_f32(w, w); + + y0 = vfma_f32( x0, x1 , w_re ); + y0 = vfma_f32( y0, x1r, w_im ); + vst1_f32( (float *)(y0_ptr + 2*j), y0 ); + + y1 = vfms_f32( x0, x1 , w_re ); + y1 = vfms_f32( y1, x1r, w_im ); + vst1_f32( (float *)(y1_ptr + 2*j), y1 ); + } + } +} + +#ifndef TEST_NEON +#define fft_bf2 neon_fft_bf2 +#endif + +#endif /* fft_bf2 */ + +#endif /* __ARM_NEON && __ARM_ARCH_ISA_A64 */ diff --git a/App_Resources/iOS/src/lc3/plc.c b/App_Resources/iOS/src/lc3/plc.c new file mode 100644 index 00000000..f225ca66 --- /dev/null +++ b/App_Resources/iOS/src/lc3/plc.c @@ -0,0 +1,62 @@ +/****************************************************************************** + * + * Copyright 2022 Google LLC + * + * 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 "plc.h" +#include "tables.h" + + +/** + * Reset Packet Loss Concealment state + */ +void lc3_plc_reset(struct lc3_plc_state *plc) +{ + plc->seed = 24607; + lc3_plc_suspend(plc); +} + +/** + * Suspend PLC execution (Good frame received) + */ +void lc3_plc_suspend(struct lc3_plc_state *plc) +{ + plc->count = 1; + plc->alpha = 1.0f; +} + +/** + * Synthesis of a PLC frame + */ +void lc3_plc_synthesize(enum lc3_dt dt, enum lc3_srate sr, + struct lc3_plc_state *plc, const float *x, float *y) +{ + uint16_t seed = plc->seed; + float alpha = plc->alpha; + int ne = lc3_ne(dt, sr); + + alpha *= (plc->count < 4 ? 1.0f : + plc->count < 8 ? 0.9f : 0.85f); + + for (int i = 0; i < ne; i++) { + seed = (16831 + seed * 12821) & 0xffff; + y[i] = alpha * (seed & 0x8000 ? -x[i] : x[i]); + } + + plc->seed = seed; + plc->alpha = alpha; + plc->count++; +} diff --git a/App_Resources/iOS/src/lc3/plc.h b/App_Resources/iOS/src/lc3/plc.h new file mode 100644 index 00000000..a7990bd6 --- /dev/null +++ b/App_Resources/iOS/src/lc3/plc.h @@ -0,0 +1,50 @@ +/****************************************************************************** + * + * Copyright 2022 Google LLC + * + * 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. + * + ******************************************************************************/ + +#ifndef __LC3_PLC_H +#define __LC3_PLC_H + +#include "common.h" + + +/** + * Reset PLC state + * plc PLC State to reset + */ +void lc3_plc_reset(lc3_plc_state_t *plc); + +/** + * Suspend PLC synthesis (Error-free frame decoded) + * plc PLC State + */ +void lc3_plc_suspend(lc3_plc_state_t *plc); + +/** + * Synthesis of a PLC frame + * dt, sr Duration and samplerate of the frame + * plc PLC State + * x Last good spectral coefficients + * y Return emulated ones + * + * `x` and `y` can be the same buffer + */ +void lc3_plc_synthesize(enum lc3_dt dt, enum lc3_srate sr, + lc3_plc_state_t *plc, const float *x, float *y); + + +#endif /* __LC3_PLC_H */ diff --git a/App_Resources/iOS/src/lc3/sns.c b/App_Resources/iOS/src/lc3/sns.c new file mode 100644 index 00000000..85660d00 --- /dev/null +++ b/App_Resources/iOS/src/lc3/sns.c @@ -0,0 +1,929 @@ +/****************************************************************************** + * + * Copyright 2022 Google LLC + * + * 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 "sns.h" +#include "tables.h" + + +/* ---------------------------------------------------------------------------- + * DCT-16 + * -------------------------------------------------------------------------- */ + +/** + * Matrix of DCT-16 coefficients + * + * M[n][k] = 2f cos( Pi k (2n + 1) / 2N ) + * + * k = [0..N-1], n = [0..N-1], N = 16 + * f = sqrt(1/4N) for k=0, sqrt(1/2N) otherwise + */ +static const float dct16_m[16][16] = { + + { 2.50000000e-01, 3.51850934e-01, 3.46759961e-01, 3.38329500e-01, + 3.26640741e-01, 3.11806253e-01, 2.93968901e-01, 2.73300467e-01, + 2.50000000e-01, 2.24291897e-01, 1.96423740e-01, 1.66663915e-01, + 1.35299025e-01, 1.02631132e-01, 6.89748448e-02, 3.46542923e-02 }, + + { 2.50000000e-01, 3.38329500e-01, 2.93968901e-01, 2.24291897e-01, + 1.35299025e-01, 3.46542923e-02, -6.89748448e-02, -1.66663915e-01, + -2.50000000e-01, -3.11806253e-01, -3.46759961e-01, -3.51850934e-01, + -3.26640741e-01, -2.73300467e-01, -1.96423740e-01, -1.02631132e-01 }, + + { 2.50000000e-01, 3.11806253e-01, 1.96423740e-01, 3.46542923e-02, + -1.35299025e-01, -2.73300467e-01, -3.46759961e-01, -3.38329500e-01, + -2.50000000e-01, -1.02631132e-01, 6.89748448e-02, 2.24291897e-01, + 3.26640741e-01, 3.51850934e-01, 2.93968901e-01, 1.66663915e-01 }, + + { 2.50000000e-01, 2.73300467e-01, 6.89748448e-02, -1.66663915e-01, + -3.26640741e-01, -3.38329500e-01, -1.96423740e-01, 3.46542923e-02, + 2.50000000e-01, 3.51850934e-01, 2.93968901e-01, 1.02631132e-01, + -1.35299025e-01, -3.11806253e-01, -3.46759961e-01, -2.24291897e-01 }, + + { 2.50000000e-01, 2.24291897e-01, -6.89748448e-02, -3.11806253e-01, + -3.26640741e-01, -1.02631132e-01, 1.96423740e-01, 3.51850934e-01, + 2.50000000e-01, -3.46542923e-02, -2.93968901e-01, -3.38329500e-01, + -1.35299025e-01, 1.66663915e-01, 3.46759961e-01, 2.73300467e-01 }, + + { 2.50000000e-01, 1.66663915e-01, -1.96423740e-01, -3.51850934e-01, + -1.35299025e-01, 2.24291897e-01, 3.46759961e-01, 1.02631132e-01, + -2.50000000e-01, -3.38329500e-01, -6.89748448e-02, 2.73300467e-01, + 3.26640741e-01, 3.46542923e-02, -2.93968901e-01, -3.11806253e-01 }, + + { 2.50000000e-01, 1.02631132e-01, -2.93968901e-01, -2.73300467e-01, + 1.35299025e-01, 3.51850934e-01, 6.89748448e-02, -3.11806253e-01, + -2.50000000e-01, 1.66663915e-01, 3.46759961e-01, 3.46542923e-02, + -3.26640741e-01, -2.24291897e-01, 1.96423740e-01, 3.38329500e-01 }, + + { 2.50000000e-01, 3.46542923e-02, -3.46759961e-01, -1.02631132e-01, + 3.26640741e-01, 1.66663915e-01, -2.93968901e-01, -2.24291897e-01, + 2.50000000e-01, 2.73300467e-01, -1.96423740e-01, -3.11806253e-01, + 1.35299025e-01, 3.38329500e-01, -6.89748448e-02, -3.51850934e-01 }, + + { 2.50000000e-01, -3.46542923e-02, -3.46759961e-01, 1.02631132e-01, + 3.26640741e-01, -1.66663915e-01, -2.93968901e-01, 2.24291897e-01, + 2.50000000e-01, -2.73300467e-01, -1.96423740e-01, 3.11806253e-01, + 1.35299025e-01, -3.38329500e-01, -6.89748448e-02, 3.51850934e-01 }, + + { 2.50000000e-01, -1.02631132e-01, -2.93968901e-01, 2.73300467e-01, + 1.35299025e-01, -3.51850934e-01, 6.89748448e-02, 3.11806253e-01, + -2.50000000e-01, -1.66663915e-01, 3.46759961e-01, -3.46542923e-02, + -3.26640741e-01, 2.24291897e-01, 1.96423740e-01, -3.38329500e-01 }, + + { 2.50000000e-01, -1.66663915e-01, -1.96423740e-01, 3.51850934e-01, + -1.35299025e-01, -2.24291897e-01, 3.46759961e-01, -1.02631132e-01, + -2.50000000e-01, 3.38329500e-01, -6.89748448e-02, -2.73300467e-01, + 3.26640741e-01, -3.46542923e-02, -2.93968901e-01, 3.11806253e-01 }, + + { 2.50000000e-01, -2.24291897e-01, -6.89748448e-02, 3.11806253e-01, + -3.26640741e-01, 1.02631132e-01, 1.96423740e-01, -3.51850934e-01, + 2.50000000e-01, 3.46542923e-02, -2.93968901e-01, 3.38329500e-01, + -1.35299025e-01, -1.66663915e-01, 3.46759961e-01, -2.73300467e-01 }, + + { 2.50000000e-01, -2.73300467e-01, 6.89748448e-02, 1.66663915e-01, + -3.26640741e-01, 3.38329500e-01, -1.96423740e-01, -3.46542923e-02, + 2.50000000e-01, -3.51850934e-01, 2.93968901e-01, -1.02631132e-01, + -1.35299025e-01, 3.11806253e-01, -3.46759961e-01, 2.24291897e-01 }, + + { 2.50000000e-01, -3.11806253e-01, 1.96423740e-01, -3.46542923e-02, + -1.35299025e-01, 2.73300467e-01, -3.46759961e-01, 3.38329500e-01, + -2.50000000e-01, 1.02631132e-01, 6.89748448e-02, -2.24291897e-01, + 3.26640741e-01, -3.51850934e-01, 2.93968901e-01, -1.66663915e-01 }, + + { 2.50000000e-01, -3.38329500e-01, 2.93968901e-01, -2.24291897e-01, + 1.35299025e-01, -3.46542923e-02, -6.89748448e-02, 1.66663915e-01, + -2.50000000e-01, 3.11806253e-01, -3.46759961e-01, 3.51850934e-01, + -3.26640741e-01, 2.73300467e-01, -1.96423740e-01, 1.02631132e-01 }, + + { 2.50000000e-01, -3.51850934e-01, 3.46759961e-01, -3.38329500e-01, + 3.26640741e-01, -3.11806253e-01, 2.93968901e-01, -2.73300467e-01, + 2.50000000e-01, -2.24291897e-01, 1.96423740e-01, -1.66663915e-01, + 1.35299025e-01, -1.02631132e-01, 6.89748448e-02, -3.46542923e-02 }, + +}; + +/** + * Forward DCT-16 transformation + * x, y Input and output 16 values + */ +LC3_HOT static void dct16_forward(const float *x, float *y) +{ + for (int i = 0, j; i < 16; i++) + for (y[i] = 0, j = 0; j < 16; j++) + y[i] += x[j] * dct16_m[j][i]; +} + +/** + * Inverse DCT-16 transformation + * x, y Input and output 16 values + */ +LC3_HOT static void dct16_inverse(const float *x, float *y) +{ + for (int i = 0, j; i < 16; i++) + for (y[i] = 0, j = 0; j < 16; j++) + y[i] += x[j] * dct16_m[i][j]; +} + + +/* ---------------------------------------------------------------------------- + * Scale factors + * -------------------------------------------------------------------------- */ + +/** + * Scale factors + * dt, sr Duration and samplerate of the frame + * nbytes Size in bytes of the frame + * eb Energy estimation per bands + * att 1: Attack detected 0: Otherwise + * scf Output 16 scale factors + */ +LC3_HOT static void compute_scale_factors( + enum lc3_dt dt, enum lc3_srate sr, int nbytes, + const float *eb, bool att, float *scf) +{ + /* Pre-emphasis gain table : + * Ge[b] = 10 ^ (b * g_tilt) / 630 , b = [0..63] */ + + static const float ge_14[LC3_MAX_BANDS] = { /* g_tilt = 14 */ + 1.00000000e+00, 1.05250029e+00, 1.10775685e+00, 1.16591440e+00, + 1.22712524e+00, 1.29154967e+00, 1.35935639e+00, 1.43072299e+00, + 1.50583635e+00, 1.58489319e+00, 1.66810054e+00, 1.75567629e+00, + 1.84784980e+00, 1.94486244e+00, 2.04696827e+00, 2.15443469e+00, + 2.26754313e+00, 2.38658979e+00, 2.51188643e+00, 2.64376119e+00, + 2.78255940e+00, 2.92864456e+00, 3.08239924e+00, 3.24422608e+00, + 3.41454887e+00, 3.59381366e+00, 3.78248991e+00, 3.98107171e+00, + 4.19007911e+00, 4.41005945e+00, 4.64158883e+00, 4.88527357e+00, + 5.14175183e+00, 5.41169527e+00, 5.69581081e+00, 5.99484250e+00, + 6.30957344e+00, 6.64082785e+00, 6.98947321e+00, 7.35642254e+00, + 7.74263683e+00, 8.14912747e+00, 8.57695899e+00, 9.02725178e+00, + 9.50118507e+00, 1.00000000e+01, 1.05250029e+01, 1.10775685e+01, + 1.16591440e+01, 1.22712524e+01, 1.29154967e+01, 1.35935639e+01, + 1.43072299e+01, 1.50583635e+01, 1.58489319e+01, 1.66810054e+01, + 1.75567629e+01, 1.84784980e+01, 1.94486244e+01, 2.04696827e+01, + 2.15443469e+01, 2.26754313e+01, 2.38658979e+01, 2.51188643e+01 }; + + static const float ge_18[LC3_MAX_BANDS] = { /* g_tilt = 18 */ + 1.00000000e+00, 1.06800043e+00, 1.14062492e+00, 1.21818791e+00, + 1.30102522e+00, 1.38949549e+00, 1.48398179e+00, 1.58489319e+00, + 1.69266662e+00, 1.80776868e+00, 1.93069773e+00, 2.06198601e+00, + 2.20220195e+00, 2.35195264e+00, 2.51188643e+00, 2.68269580e+00, + 2.86512027e+00, 3.05994969e+00, 3.26802759e+00, 3.49025488e+00, + 3.72759372e+00, 3.98107171e+00, 4.25178630e+00, 4.54090961e+00, + 4.84969343e+00, 5.17947468e+00, 5.53168120e+00, 5.90783791e+00, + 6.30957344e+00, 6.73862717e+00, 7.19685673e+00, 7.68624610e+00, + 8.20891416e+00, 8.76712387e+00, 9.36329209e+00, 1.00000000e+01, + 1.06800043e+01, 1.14062492e+01, 1.21818791e+01, 1.30102522e+01, + 1.38949549e+01, 1.48398179e+01, 1.58489319e+01, 1.69266662e+01, + 1.80776868e+01, 1.93069773e+01, 2.06198601e+01, 2.20220195e+01, + 2.35195264e+01, 2.51188643e+01, 2.68269580e+01, 2.86512027e+01, + 3.05994969e+01, 3.26802759e+01, 3.49025488e+01, 3.72759372e+01, + 3.98107171e+01, 4.25178630e+01, 4.54090961e+01, 4.84969343e+01, + 5.17947468e+01, 5.53168120e+01, 5.90783791e+01, 6.30957344e+01 }; + + static const float ge_22[LC3_MAX_BANDS] = { /* g_tilt = 22 */ + 1.00000000e+00, 1.08372885e+00, 1.17446822e+00, 1.27280509e+00, + 1.37937560e+00, 1.49486913e+00, 1.62003281e+00, 1.75567629e+00, + 1.90267705e+00, 2.06198601e+00, 2.23463373e+00, 2.42173704e+00, + 2.62450630e+00, 2.84425319e+00, 3.08239924e+00, 3.34048498e+00, + 3.62017995e+00, 3.92329345e+00, 4.25178630e+00, 4.60778348e+00, + 4.99358789e+00, 5.41169527e+00, 5.86481029e+00, 6.35586411e+00, + 6.88803330e+00, 7.46476041e+00, 8.08977621e+00, 8.76712387e+00, + 9.50118507e+00, 1.02967084e+01, 1.11588399e+01, 1.20931568e+01, + 1.31057029e+01, 1.42030283e+01, 1.53922315e+01, 1.66810054e+01, + 1.80776868e+01, 1.95913107e+01, 2.12316686e+01, 2.30093718e+01, + 2.49359200e+01, 2.70237760e+01, 2.92864456e+01, 3.17385661e+01, + 3.43959997e+01, 3.72759372e+01, 4.03970086e+01, 4.37794036e+01, + 4.74450028e+01, 5.14175183e+01, 5.57226480e+01, 6.03882412e+01, + 6.54444792e+01, 7.09240702e+01, 7.68624610e+01, 8.32980665e+01, + 9.02725178e+01, 9.78309319e+01, 1.06022203e+02, 1.14899320e+02, + 1.24519708e+02, 1.34945600e+02, 1.46244440e+02, 1.58489319e+02 }; + + static const float ge_26[LC3_MAX_BANDS] = { /* g_tilt = 26 */ + 1.00000000e+00, 1.09968890e+00, 1.20931568e+00, 1.32987103e+00, + 1.46244440e+00, 1.60823388e+00, 1.76855694e+00, 1.94486244e+00, + 2.13874364e+00, 2.35195264e+00, 2.58641621e+00, 2.84425319e+00, + 3.12779366e+00, 3.43959997e+00, 3.78248991e+00, 4.15956216e+00, + 4.57422434e+00, 5.03022373e+00, 5.53168120e+00, 6.08312841e+00, + 6.68954879e+00, 7.35642254e+00, 8.08977621e+00, 8.89623710e+00, + 9.78309319e+00, 1.07583590e+01, 1.18308480e+01, 1.30102522e+01, + 1.43072299e+01, 1.57335019e+01, 1.73019574e+01, 1.90267705e+01, + 2.09235283e+01, 2.30093718e+01, 2.53031508e+01, 2.78255940e+01, + 3.05994969e+01, 3.36499270e+01, 3.70044512e+01, 4.06933843e+01, + 4.47500630e+01, 4.92111475e+01, 5.41169527e+01, 5.95118121e+01, + 6.54444792e+01, 7.19685673e+01, 7.91430346e+01, 8.70327166e+01, + 9.57089124e+01, 1.05250029e+02, 1.15742288e+02, 1.27280509e+02, + 1.39968963e+02, 1.53922315e+02, 1.69266662e+02, 1.86140669e+02, + 2.04696827e+02, 2.25102829e+02, 2.47543082e+02, 2.72220379e+02, + 2.99357729e+02, 3.29200372e+02, 3.62017995e+02, 3.98107171e+02 }; + + static const float ge_30[LC3_MAX_BANDS] = { /* g_tilt = 30 */ + 1.00000000e+00, 1.11588399e+00, 1.24519708e+00, 1.38949549e+00, + 1.55051578e+00, 1.73019574e+00, 1.93069773e+00, 2.15443469e+00, + 2.40409918e+00, 2.68269580e+00, 2.99357729e+00, 3.34048498e+00, + 3.72759372e+00, 4.15956216e+00, 4.64158883e+00, 5.17947468e+00, + 5.77969288e+00, 6.44946677e+00, 7.19685673e+00, 8.03085722e+00, + 8.96150502e+00, 1.00000000e+01, 1.11588399e+01, 1.24519708e+01, + 1.38949549e+01, 1.55051578e+01, 1.73019574e+01, 1.93069773e+01, + 2.15443469e+01, 2.40409918e+01, 2.68269580e+01, 2.99357729e+01, + 3.34048498e+01, 3.72759372e+01, 4.15956216e+01, 4.64158883e+01, + 5.17947468e+01, 5.77969288e+01, 6.44946677e+01, 7.19685673e+01, + 8.03085722e+01, 8.96150502e+01, 1.00000000e+02, 1.11588399e+02, + 1.24519708e+02, 1.38949549e+02, 1.55051578e+02, 1.73019574e+02, + 1.93069773e+02, 2.15443469e+02, 2.40409918e+02, 2.68269580e+02, + 2.99357729e+02, 3.34048498e+02, 3.72759372e+02, 4.15956216e+02, + 4.64158883e+02, 5.17947468e+02, 5.77969288e+02, 6.44946677e+02, + 7.19685673e+02, 8.03085722e+02, 8.96150502e+02, 1.00000000e+03 }; + +#if LC3_PLUS_HR + + static const float ge_34[LC3_MAX_BANDS] = { /* g_tilt = 34 */ + 1.00000000e+00, 1.13231759e+00, 1.28214312e+00, 1.45179321e+00, + 1.64389099e+00, 1.86140669e+00, 2.10770353e+00, 2.38658979e+00, + 2.70237760e+00, 3.05994969e+00, 3.46483486e+00, 3.92329345e+00, + 4.44241419e+00, 5.03022373e+00, 5.69581081e+00, 6.44946677e+00, + 7.30284467e+00, 8.26913948e+00, 9.36329209e+00, 1.06022203e+01, + 1.20050806e+01, 1.35935639e+01, 1.53922315e+01, 1.74288945e+01, + 1.97350438e+01, 2.23463373e+01, 2.53031508e+01, 2.86512027e+01, + 3.24422608e+01, 3.67349426e+01, 4.15956216e+01, 4.70994540e+01, + 5.33315403e+01, 6.03882412e+01, 6.83786677e+01, 7.74263683e+01, + 8.76712387e+01, 9.92716858e+01, 1.12407076e+02, 1.27280509e+02, + 1.44121960e+02, 1.63191830e+02, 1.84784980e+02, 2.09235283e+02, + 2.36920791e+02, 2.68269580e+02, 3.03766364e+02, 3.43959997e+02, + 3.89471955e+02, 4.41005945e+02, 4.99358789e+02, 5.65432741e+02, + 6.40249439e+02, 7.24965701e+02, 8.20891416e+02, 9.29509790e+02, + 1.05250029e+03, 1.19176459e+03, 1.34945600e+03, 1.52801277e+03, + 1.73019574e+03, 1.95913107e+03, 2.21835857e+03, 2.51188643e+03 }; + +#endif /* LC3_PLUS_HR */ + + static const float *ge_table[LC3_NUM_SRATE] = { + [LC3_SRATE_8K ] = ge_14, [LC3_SRATE_16K ] = ge_18, + [LC3_SRATE_24K ] = ge_22, [LC3_SRATE_32K ] = ge_26, + [LC3_SRATE_48K ] = ge_30, + +#if LC3_PLUS_HR + [LC3_SRATE_48K_HR] = ge_30, [LC3_SRATE_96K_HR] = ge_34, +#endif /* LC3_PLUS_HR */ + + }; + + float e[LC3_MAX_BANDS]; + + /* --- Copy and padding --- */ + + int nb = lc3_num_bands[dt][sr]; + int n4 = nb < 32 ? 32 % nb : 0; + int n2 = nb < 32 ? nb - n4 : LC3_MAX_BANDS - nb; + + for (int i4 = 0; i4 < n4; i4++) + e[4*i4 + 0] = e[4*i4 + 1] = + e[4*i4 + 2] = e[4*i4 + 3] = eb[i4]; + + for (int i2 = n4; i2 < n4+n2; i2++) + e[2*(n4+i2) + 0] = e[2*(n4+i2) + 1] = eb[i2]; + + memcpy(e + 4*n4 + 2*n2, eb + n4 + n2, (nb - n4 - n2) * sizeof(float)); + + /* --- Smoothing, pre-emphasis and logarithm --- */ + + const float *ge = ge_table[sr]; + + float e0 = e[0], e1 = e[0], e2; + float e_sum = 0; + + for (int i = 0; i < LC3_MAX_BANDS-1; ) { + e[i] = (e0 * 0.25f + e1 * 0.5f + (e2 = e[i+1]) * 0.25f) * ge[i]; + e_sum += e[i++]; + + e[i] = (e1 * 0.25f + e2 * 0.5f + (e0 = e[i+1]) * 0.25f) * ge[i]; + e_sum += e[i++]; + + e[i] = (e2 * 0.25f + e0 * 0.5f + (e1 = e[i+1]) * 0.25f) * ge[i]; + e_sum += e[i++]; + } + + e[LC3_MAX_BANDS-1] = (e0 * 0.25f + e1 * 0.75f) * ge[LC3_MAX_BANDS-1]; + e_sum += e[LC3_MAX_BANDS-1]; + + float noise_floor = fmaxf(e_sum * (1e-4f / 64), 0x1p-32f); + + for (int i = 0; i < LC3_MAX_BANDS; i++) + e[i] = lc3_log2f(fmaxf(e[i], noise_floor)) * 0.5f; + + /* --- Grouping & scaling --- */ + + float scf_sum; + + scf[0] = (e[0] + e[4]) * 1.f/12 + + (e[0] + e[3]) * 2.f/12 + + (e[1] + e[2]) * 3.f/12 ; + scf_sum = scf[0]; + + for (int i = 1; i < 15; i++) { + scf[i] = (e[4*i-1] + e[4*i+4]) * 1.f/12 + + (e[4*i ] + e[4*i+3]) * 2.f/12 + + (e[4*i+1] + e[4*i+2]) * 3.f/12 ; + scf_sum += scf[i]; + } + + scf[15] = (e[59] + e[63]) * 1.f/12 + + (e[60] + e[63]) * 2.f/12 + + (e[61] + e[62]) * 3.f/12 ; + scf_sum += scf[15]; + + float cf = lc3_hr(sr) ? 0.6f : 0.85f; + if (lc3_hr(sr) && 8 * nbytes > + (dt < LC3_DT_10M ? 1150 * (int)(1 + dt) : 4400)) + cf *= dt < LC3_DT_10M ? 0.25f : 0.35f; + + for (int i = 0; i < 16; i++) + scf[i] = cf * (scf[i] - scf_sum * 1.f/16); + + /* --- Attack handling --- */ + + if (!att) + return; + + float s0, s1 = scf[0], s2 = scf[1], s3 = scf[2], s4 = scf[3]; + float sn = s1 + s2; + + scf[0] = (sn += s3) * 1.f/3; + scf[1] = (sn += s4) * 1.f/4; + scf_sum = scf[0] + scf[1]; + + for (int i = 2; i < 14; i++, sn -= s0) { + s0 = s1, s1 = s2, s2 = s3, s3 = s4, s4 = scf[i+2]; + scf[i] = (sn += s4) * 1.f/5; + scf_sum += scf[i]; + } + + scf[14] = (sn ) * 1.f/4; + scf[15] = (sn -= s1) * 1.f/3; + scf_sum += scf[14] + scf[15]; + + for (int i = 0; i < 16; i++) + scf[i] = (dt == LC3_DT_7M5 ? 0.3f : 0.5f) * + (scf[i] - scf_sum * 1.f/16); +} + +/** + * Codebooks + * scf Input 16 scale factors + * lf/hfcb_idx Output the low and high frequency codebooks index + */ +LC3_HOT static void resolve_codebooks( + const float *scf, int *lfcb_idx, int *hfcb_idx) +{ + float dlfcb_max = 0, dhfcb_max = 0; + *lfcb_idx = *hfcb_idx = 0; + + for (int icb = 0; icb < 32; icb++) { + const float *lfcb = lc3_sns_lfcb[icb]; + const float *hfcb = lc3_sns_hfcb[icb]; + float dlfcb = 0, dhfcb = 0; + + for (int i = 0; i < 8; i++) { + dlfcb += (scf[ i] - lfcb[i]) * (scf[ i] - lfcb[i]); + dhfcb += (scf[8+i] - hfcb[i]) * (scf[8+i] - hfcb[i]); + } + + if (icb == 0 || dlfcb < dlfcb_max) + *lfcb_idx = icb, dlfcb_max = dlfcb; + + if (icb == 0 || dhfcb < dhfcb_max) + *hfcb_idx = icb, dhfcb_max = dhfcb; + } +} + +/** + * Unit energy normalize pulse configuration + * c Pulse configuration + * cn Normalized pulse configuration + */ +LC3_HOT static void normalize(const int *c, float *cn) +{ + int c2_sum = 0; + for (int i = 0; i < 16; i++) + c2_sum += c[i] * c[i]; + + float c_norm = 1.f / sqrtf(c2_sum); + + for (int i = 0; i < 16; i++) + cn[i] = c[i] * c_norm; +} + +/** + * Sub-procedure of `quantize()`, add unit pulse + * x, y, n Transformed residual, and vector of pulses with length + * start, end Current number of pulses, limit to reach + * corr, energy Correlation (x,y) and y energy, updated at output + */ +LC3_HOT static void add_pulse(const float *x, int *y, int n, + int start, int end, float *corr, float *energy) +{ + for (int k = start; k < end; k++) { + float best_c2 = (*corr + x[0]) * (*corr + x[0]); + float best_e = *energy + 2*y[0] + 1; + int nbest = 0; + + for (int i = 1; i < n; i++) { + float c2 = (*corr + x[i]) * (*corr + x[i]); + float e = *energy + 2*y[i] + 1; + + if (c2 * best_e > e * best_c2) + best_c2 = c2, best_e = e, nbest = i; + } + + *corr += x[nbest]; + *energy += 2*y[nbest] + 1; + y[nbest]++; + } +} + +/** + * Quantization of codebooks residual + * scf Input 16 scale factors, output quantized version + * lf/hfcb_idx Codebooks index + * c, cn Output 4 pulse configurations candidates, normalized + * shape/gain_idx Output selected shape/gain indexes + */ +LC3_HOT static void quantize(const float *scf, int lfcb_idx, int hfcb_idx, + int (*c)[16], float (*cn)[16], int *shape_idx, int *gain_idx) +{ + /* --- Residual --- */ + + const float *lfcb = lc3_sns_lfcb[lfcb_idx]; + const float *hfcb = lc3_sns_hfcb[hfcb_idx]; + float r[16], x[16]; + + for (int i = 0; i < 8; i++) { + r[ i] = scf[ i] - lfcb[i]; + r[8+i] = scf[8+i] - hfcb[i]; + } + + dct16_forward(r, x); + + /* --- Shape 3 candidate --- + * Project to or below pyramid N = 16, K = 6, + * then add unit pulses until you reach K = 6, over N = 16 */ + + float xm[16]; + float xm_sum = 0; + + for (int i = 0; i < 16; i++) { + xm[i] = fabsf(x[i]); + xm_sum += xm[i]; + } + + float proj_factor = (6 - 1) / fmaxf(xm_sum, 1e-31f); + float corr = 0, energy = 0; + int npulses = 0; + + for (int i = 0; i < 16; i++) { + c[3][i] = floorf(xm[i] * proj_factor); + npulses += c[3][i]; + corr += c[3][i] * xm[i]; + energy += c[3][i] * c[3][i]; + } + + add_pulse(xm, c[3], 16, npulses, 6, &corr, &energy); + npulses = 6; + + /* --- Shape 2 candidate --- + * Add unit pulses until you reach K = 8 on shape 3 */ + + memcpy(c[2], c[3], sizeof(c[2])); + + add_pulse(xm, c[2], 16, npulses, 8, &corr, &energy); + npulses = 8; + + /* --- Shape 1 candidate --- + * Remove any unit pulses from shape 2 that are not part of 0 to 9 + * Update energy and correlation terms accordingly + * Add unit pulses until you reach K = 10, over N = 10 */ + + memcpy(c[1], c[2], sizeof(c[1])); + + for (int i = 10; i < 16; i++) { + c[1][i] = 0; + npulses -= c[2][i]; + corr -= c[2][i] * xm[i]; + energy -= c[2][i] * c[2][i]; + } + + add_pulse(xm, c[1], 10, npulses, 10, &corr, &energy); + npulses = 10; + + /* --- Shape 0 candidate --- + * Add unit pulses until you reach K = 1, on shape 1 */ + + memcpy(c[0], c[1], sizeof(c[0])); + + add_pulse(xm + 10, c[0] + 10, 6, 0, 1, &corr, &energy); + + /* --- Add sign and unit energy normalize --- */ + + for (int j = 0; j < 16; j++) + for (int i = 0; i < 4; i++) + c[i][j] = x[j] < 0 ? -c[i][j] : c[i][j]; + + for (int i = 0; i < 4; i++) + normalize(c[i], cn[i]); + + /* --- Determe shape & gain index --- + * Search the Mean Square Error, within (shape, gain) combinations */ + + float mse_min = FLT_MAX; + *shape_idx = *gain_idx = 0; + + for (int ic = 0; ic < 4; ic++) { + const struct lc3_sns_vq_gains *cgains = lc3_sns_vq_gains + ic; + float cmse_min = FLT_MAX; + int cgain_idx = 0; + + for (int ig = 0; ig < cgains->count; ig++) { + float g = cgains->v[ig]; + + float mse = 0; + for (int i = 0; i < 16; i++) + mse += (x[i] - g * cn[ic][i]) * (x[i] - g * cn[ic][i]); + + if (mse < cmse_min) { + cgain_idx = ig, + cmse_min = mse; + } + } + + if (cmse_min < mse_min) { + *shape_idx = ic, *gain_idx = cgain_idx; + mse_min = cmse_min; + } + } +} + +/** + * Unquantization of codebooks residual + * lf/hfcb_idx Low and high frequency codebooks index + * c Table of normalized pulse configuration + * shape/gain Selected shape/gain indexes + * scf Return unquantized scale factors + */ +LC3_HOT static void unquantize(int lfcb_idx, int hfcb_idx, + const float *c, int shape, int gain, float *scf) +{ + const float *lfcb = lc3_sns_lfcb[lfcb_idx]; + const float *hfcb = lc3_sns_hfcb[hfcb_idx]; + float g = lc3_sns_vq_gains[shape].v[gain]; + + dct16_inverse(c, scf); + + for (int i = 0; i < 8; i++) + scf[i] = lfcb[i] + g * scf[i]; + + for (int i = 8; i < 16; i++) + scf[i] = hfcb[i-8] + g * scf[i]; +} + +/** + * Sub-procedure of `sns_enumerate()`, enumeration of a vector + * c, n Table of pulse configuration, and length + * idx, ls Return enumeration set + */ +static void enum_mvpq(const int *c, int n, int *idx, bool *ls) +{ + int ci, i; + + /* --- Scan for 1st significant coeff --- */ + + for (i = 0, c += n; (ci = *(--c)) == 0 && i < 15; i++); + + *idx = 0; + *ls = ci < 0; + + /* --- Scan remaining coefficients --- */ + + unsigned j = LC3_ABS(ci); + + for (i++; i < n; i++, j += LC3_ABS(ci)) { + + if ((ci = *(--c)) != 0) { + *idx = (*idx << 1) | *ls; + *ls = ci < 0; + } + + *idx += lc3_sns_mpvq_offsets[i][LC3_MIN(j, 10)]; + } +} + +/** + * Sub-procedure of `sns_deenumerate()`, deenumeration of a vector + * idx, ls Enumeration set + * npulses Number of pulses in the set + * c, n Table of pulses configuration, and length + */ +static void deenum_mvpq(int idx, bool ls, int npulses, int *c, int n) +{ + int i; + + /* --- Scan for coefficients --- */ + + for (i = n-1; i >= 0 && idx; i--) { + + int ci = 0; + + for (ci = 0; idx < lc3_sns_mpvq_offsets[i][npulses - ci]; ci++); + idx -= lc3_sns_mpvq_offsets[i][npulses - ci]; + + *(c++) = ls ? -ci : ci; + npulses -= ci; + if (ci > 0) { + ls = idx & 1; + idx >>= 1; + } + } + + /* --- Set last significant --- */ + + int ci = npulses; + + if (i-- >= 0) + *(c++) = ls ? -ci : ci; + + while (i-- >= 0) + *(c++) = 0; +} + +/** + * SNS Enumeration of PVQ configuration + * shape Selected shape index + * c Selected pulse configuration + * idx_a, ls_a Return enumeration set A + * idx_b, ls_b Return enumeration set B (shape = 0) + */ +static void enumerate(int shape, const int *c, + int *idx_a, bool *ls_a, int *idx_b, bool *ls_b) +{ + enum_mvpq(c, shape < 2 ? 10 : 16, idx_a, ls_a); + + if (shape == 0) + enum_mvpq(c + 10, 6, idx_b, ls_b); +} + +/** + * SNS Deenumeration of PVQ configuration + * shape Selected shape index + * idx_a, ls_a enumeration set A + * idx_b, ls_b enumeration set B (shape = 0) + * c Return pulse configuration + */ +static void deenumerate(int shape, + int idx_a, bool ls_a, int idx_b, bool ls_b, int *c) +{ + int npulses_a = (const int []){ 10, 10, 8, 6 }[shape]; + + deenum_mvpq(idx_a, ls_a, npulses_a, c, shape < 2 ? 10 : 16); + + if (shape == 0) + deenum_mvpq(idx_b, ls_b, 1, c + 10, 6); + else if (shape == 1) + memset(c + 10, 0, 6 * sizeof(*c)); +} + + +/* ---------------------------------------------------------------------------- + * Filtering + * -------------------------------------------------------------------------- */ + +/** + * Spectral shaping + * dt, sr Duration and samplerate of the frame + * scf_q Quantized scale factors + * inv True on inverse shaping, False otherwise + * x Spectral coefficients + * y Return shapped coefficients + * + * `x` and `y` can be the same buffer + */ +LC3_HOT static void spectral_shaping(enum lc3_dt dt, enum lc3_srate sr, + const float *scf_q, bool inv, const float *x, float *y) +{ + /* --- Interpolate scale factors --- */ + + float scf[LC3_MAX_BANDS]; + float s0, s1 = inv ? -scf_q[0] : scf_q[0]; + + scf[0] = scf[1] = s1; + for (int i = 0; i < 15; i++) { + s0 = s1, s1 = inv ? -scf_q[i+1] : scf_q[i+1]; + scf[4*i+2] = s0 + 0.125f * (s1 - s0); + scf[4*i+3] = s0 + 0.375f * (s1 - s0); + scf[4*i+4] = s0 + 0.625f * (s1 - s0); + scf[4*i+5] = s0 + 0.875f * (s1 - s0); + } + scf[62] = s1 + 0.125f * (s1 - s0); + scf[63] = s1 + 0.375f * (s1 - s0); + + int nb = lc3_num_bands[dt][sr]; + int n4 = nb < 32 ? 32 % nb : 0; + int n2 = nb < 32 ? nb - n4 : LC3_MAX_BANDS - nb; + + for (int i4 = 0; i4 < n4; i4++) + scf[i4] = 0.25f * (scf[4*i4+0] + scf[4*i4+1] + + scf[4*i4+2] + scf[4*i4+3]); + + for (int i2 = n4; i2 < n4+n2; i2++) + scf[i2] = 0.5f * (scf[2*(n4+i2)] + scf[2*(n4+i2)+1]); + + memmove(scf + n4 + n2, scf + 4*n4 + 2*n2, (nb - n4 - n2) * sizeof(float)); + + /* --- Spectral shaping --- */ + + const int *lim = lc3_band_lim[dt][sr]; + + for (int i = 0, ib = 0; ib < nb; ib++) { + float g_sns = lc3_exp2f(-scf[ib]); + + for ( ; i < lim[ib+1]; i++) + y[i] = x[i] * g_sns; + } +} + + +/* ---------------------------------------------------------------------------- + * Interface + * -------------------------------------------------------------------------- */ + +/** + * SNS analysis + */ +void lc3_sns_analyze( + enum lc3_dt dt, enum lc3_srate sr, int nbytes, + const float *eb, bool att, struct lc3_sns_data *data, + const float *x, float *y) +{ + /* Processing steps : + * - Determine 16 scale factors from bands energy estimation + * - Get codebooks indexes that match thoses scale factors + * - Quantize the residual with the selected codebook + * - The pulse configuration `c[]` is enumerated + * - Finally shape the spectrum coefficients accordingly */ + + float scf[16], cn[4][16]; + int c[4][16]; + + compute_scale_factors(dt, sr, nbytes, eb, att, scf); + + resolve_codebooks(scf, &data->lfcb, &data->hfcb); + + quantize(scf, data->lfcb, data->hfcb, + c, cn, &data->shape, &data->gain); + + unquantize(data->lfcb, data->hfcb, + cn[data->shape], data->shape, data->gain, scf); + + enumerate(data->shape, c[data->shape], + &data->idx_a, &data->ls_a, &data->idx_b, &data->ls_b); + + spectral_shaping(dt, sr, scf, false, x, y); +} + +/** + * SNS synthesis + */ +void lc3_sns_synthesize( + enum lc3_dt dt, enum lc3_srate sr, + const lc3_sns_data_t *data, const float *x, float *y) +{ + float scf[16], cn[16]; + int c[16]; + + deenumerate(data->shape, + data->idx_a, data->ls_a, data->idx_b, data->ls_b, c); + + normalize(c, cn); + + unquantize(data->lfcb, data->hfcb, cn, data->shape, data->gain, scf); + + spectral_shaping(dt, sr, scf, true, x, y); +} + +/** + * Return number of bits coding the bitstream data + */ +int lc3_sns_get_nbits(void) +{ + return 38; +} + +/** + * Put bitstream data + */ +void lc3_sns_put_data(lc3_bits_t *bits, const struct lc3_sns_data *data) +{ + /* --- Codebooks --- */ + + lc3_put_bits(bits, data->lfcb, 5); + lc3_put_bits(bits, data->hfcb, 5); + + /* --- Shape, gain and vectors --- * + * Write MSB bit of shape index, next LSB bits of shape and gain, + * and MVPQ vectors indexes are muxed */ + + int shape_msb = data->shape >> 1; + lc3_put_bit(bits, shape_msb); + + if (shape_msb == 0) { + const int size_a = 2390004; + int submode = data->shape & 1; + + int mux_high = submode == 0 ? + 2 * (data->idx_b + 1) + data->ls_b : data->gain & 1; + int mux_code = mux_high * size_a + data->idx_a; + + lc3_put_bits(bits, data->gain >> submode, 1); + lc3_put_bits(bits, data->ls_a, 1); + lc3_put_bits(bits, mux_code, 25); + + } else { + const int size_a = 15158272; + int submode = data->shape & 1; + + int mux_code = submode == 0 ? + data->idx_a : size_a + 2 * data->idx_a + (data->gain & 1); + + lc3_put_bits(bits, data->gain >> submode, 2); + lc3_put_bits(bits, data->ls_a, 1); + lc3_put_bits(bits, mux_code, 24); + } +} + +/** + * Get bitstream data + */ +int lc3_sns_get_data(lc3_bits_t *bits, struct lc3_sns_data *data) +{ + /* --- Codebooks --- */ + + *data = (struct lc3_sns_data){ + .lfcb = lc3_get_bits(bits, 5), + .hfcb = lc3_get_bits(bits, 5) + }; + + /* --- Shape, gain and vectors --- */ + + int shape_msb = lc3_get_bit(bits); + data->gain = lc3_get_bits(bits, 1 + shape_msb); + data->ls_a = lc3_get_bit(bits); + + int mux_code = lc3_get_bits(bits, 25 - shape_msb); + + if (shape_msb == 0) { + const int size_a = 2390004; + + if (mux_code >= size_a * 14) + return -1; + + data->idx_a = mux_code % size_a; + mux_code = mux_code / size_a; + + data->shape = (mux_code < 2); + + if (data->shape == 0) { + data->idx_b = (mux_code - 2) / 2; + data->ls_b = (mux_code - 2) % 2; + } else { + data->gain = (data->gain << 1) + (mux_code % 2); + } + + } else { + const int size_a = 15158272; + + if (mux_code >= size_a + 1549824) + return -1; + + data->shape = 2 + (mux_code >= size_a); + if (data->shape == 2) { + data->idx_a = mux_code; + } else { + mux_code -= size_a; + data->idx_a = mux_code / 2; + data->gain = (data->gain << 1) + (mux_code % 2); + } + } + + return 0; +} diff --git a/App_Resources/iOS/src/lc3/sns.h b/App_Resources/iOS/src/lc3/sns.h new file mode 100644 index 00000000..ecb80efb --- /dev/null +++ b/App_Resources/iOS/src/lc3/sns.h @@ -0,0 +1,98 @@ +/****************************************************************************** + * + * Copyright 2022 Google LLC + * + * 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. + * + ******************************************************************************/ + +#ifndef __LC3_SNS_H +#define __LC3_SNS_H + +#include "common.h" +#include "bits.h" + + +/** + * Bitstream data + */ + +typedef struct lc3_sns_data { + int lfcb, hfcb; + int shape, gain; + int idx_a, idx_b; + bool ls_a, ls_b; +} lc3_sns_data_t; + + +/* ---------------------------------------------------------------------------- + * Encoding + * -------------------------------------------------------------------------- */ + +/** + * SNS analysis + * dt, sr Duration and samplerate of the frame + * nbytes Size in bytes of the frame + * eb Energy estimation per bands, and count of bands + * att 1: Attack detected 0: Otherwise + * data Return bitstream data + * x Spectral coefficients + * y Return shapped coefficients + * + * `x` and `y` can be the same buffer + */ +void lc3_sns_analyze( + enum lc3_dt dt, enum lc3_srate sr, int nbytes, + const float *eb, bool att, lc3_sns_data_t *data, + const float *x, float *y); + +/** + * Return number of bits coding the bitstream data + * return Bit consumption + */ +int lc3_sns_get_nbits(void); + +/** + * Put bitstream data + * bits Bitstream context + * data Bitstream data + */ +void lc3_sns_put_data(lc3_bits_t *bits, const lc3_sns_data_t *data); + + +/* ---------------------------------------------------------------------------- + * Decoding + * -------------------------------------------------------------------------- */ + +/** + * Get bitstream data + * bits Bitstream context + * data Return SNS data + * return 0: Ok -1: Invalid SNS data + */ +int lc3_sns_get_data(lc3_bits_t *bits, lc3_sns_data_t *data); + +/** + * SNS synthesis + * dt, sr Duration and samplerate of the frame + * data Bitstream data + * x Spectral coefficients + * y Return shapped coefficients + * + * `x` and `y` can be the same buffer + */ +void lc3_sns_synthesize(enum lc3_dt dt, enum lc3_srate sr, + const lc3_sns_data_t *data, const float *x, float *y); + + +#endif /* __LC3_SNS_H */ diff --git a/App_Resources/iOS/src/lc3/spec.c b/App_Resources/iOS/src/lc3/spec.c new file mode 100644 index 00000000..25a28d43 --- /dev/null +++ b/App_Resources/iOS/src/lc3/spec.c @@ -0,0 +1,959 @@ +/****************************************************************************** + * + * Copyright 2022 Google LLC + * + * 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 "spec.h" +#include "bits.h" +#include "tables.h" + + +/* ---------------------------------------------------------------------------- + * Global Gain / Quantization + * -------------------------------------------------------------------------- */ + +/** + * Resolve quantized gain index offset + * sr, nbytes Samplerate and size of the frame + * return Gain index offset + */ +static int resolve_gain_offset(enum lc3_srate sr, int nbytes) +{ + int sr_ind = lc3_hr(sr) ? 4 + (sr - LC3_SRATE_48K_HR) : sr; + + int g_off = (nbytes * 8) / (10 * (1 + sr_ind)); + return LC3_MIN(sr >= LC3_SRATE_96K_HR ? 181 : 255, + 105 + 5*(1 + sr_ind) + LC3_MIN(g_off, 115)); +} + +/** + * Unquantize gain + * g_int Quantization gain value + * return Unquantized gain value + */ +static float unquantize_gain(int g_int) +{ + /* Unquantization gain table : + * G[i] = 10 ^ (i / 28) , i = [0..27] */ + + static const float iq_table[] = { + 1.00000000e+00, 1.08571112e+00, 1.17876863e+00, 1.27980221e+00, + 1.38949549e+00, 1.50859071e+00, 1.63789371e+00, 1.77827941e+00, + 1.93069773e+00, 2.09617999e+00, 2.27584593e+00, 2.47091123e+00, + 2.68269580e+00, 2.91263265e+00, 3.16227766e+00, 3.43332002e+00, + 3.72759372e+00, 4.04708995e+00, 4.39397056e+00, 4.77058270e+00, + 5.17947468e+00, 5.62341325e+00, 6.10540230e+00, 6.62870316e+00, + 7.19685673e+00, 7.81370738e+00, 8.48342898e+00, 9.21055318e+00 + }; + + float g = 1.f; + + for ( ; g_int < 0; g_int += 28, g *= 0.1f); + for ( ; g_int >= 28; g_int -= 28, g *= 10.f); + + return g * iq_table[g_int]; +} + +/** + * Global Gain Estimation + * dt, sr Duration and samplerate of the frame + * x Spectral coefficients + * nbytes Size of the frame + * nbits_budget Number of bits available coding the spectrum + * nbits_off Offset on the available bits, temporarily smoothed + * g_off Gain index offset + * reset_off Return True when the nbits_off must be reset + * g_min Return lower bound of quantized gain value + * return The quantized gain value + */ +LC3_HOT static int estimate_gain( + enum lc3_dt dt, enum lc3_srate sr, const float *x, + int nbytes, int nbits_budget, float nbits_off, int g_off, + bool *reset_off, int *g_min) +{ + int n4 = lc3_ne(dt, sr) / 4; + union { float f; int32_t q16; } e[LC3_MAX_NE / 4]; + + /* --- Signal adaptative noise floor --- */ + + int reg_bits = 0; + float low_bits = 0; + + if (lc3_hr(sr)) { + int reg_c = (const int [LC3_NUM_DT][LC3_NUM_SRATE - LC3_SRATE_48K_HR]){ + [LC3_DT_2M5] = { -6, -6 }, + [LC3_DT_5M ] = { 0, 0 }, + [LC3_DT_10M] = { 2, 5 } + }[dt][sr - LC3_SRATE_48K_HR]; + + reg_bits = (8*nbytes * 4) / (125 * (1 + dt)); + reg_bits = LC3_CLIP(reg_bits + reg_c, 6, 23); + + float m0 = 1e-5f, m1 = 1e-5f, k = 0; + + for (int i = 0; i < n4; i++) { + m0 += fabsf(x[4*i + 0]), m1 += fabsf(x[4*i + 0]) * k++; + m0 += fabsf(x[4*i + 1]), m1 += fabsf(x[4*i + 1]) * k++; + m0 += fabsf(x[4*i + 2]), m1 += fabsf(x[4*i + 2]) * k++; + m0 += fabsf(x[4*i + 3]), m1 += fabsf(x[4*i + 3]) * k++; + } + + int m = roundf((1.6f * m0) / ((1 + dt) * m1)); + low_bits = 8 - LC3_MIN(m, 8); + } + + /* --- Energy (dB) by 4 MDCT blocks --- */ + + float x2_max = 0; + + for (int i = 0; i < n4; i++) { + float x0 = x[4*i + 0] * x[4*i + 0]; + float x1 = x[4*i + 1] * x[4*i + 1]; + float x2 = x[4*i + 2] * x[4*i + 2]; + float x3 = x[4*i + 3] * x[4*i + 3]; + + x2_max = fmaxf(x2_max, x0); + x2_max = fmaxf(x2_max, x1); + x2_max = fmaxf(x2_max, x2); + x2_max = fmaxf(x2_max, x3); + + e[i].f = x0 + x1 + x2 + x3; + } + + float x_max = sqrtf(x2_max); + float nf = lc3_hr(sr) ? + lc3_ldexpf(x_max, -reg_bits) * lc3_exp2f(-low_bits) : 0; + + for (int i = 0; i < n4; i++) + e[i].q16 = lc3_db_q16(fmaxf(e[i].f + nf, 1e-10f)); + + /* --- Determine gain index --- */ + + int nbits = nbits_budget + nbits_off + 0.5f; + int g_int = 255 - g_off; + + const int k_20_28 = 20.f/28 * 0x1p16f + 0.5f; + const int k_2u7 = 2.7f * 0x1p16f + 0.5f; + const int k_1u4 = 1.4f * 0x1p16f + 0.5f; + + for (int i = 128, j, j0 = n4-1, j1 ; i > 0; i >>= 1) { + int gn = (g_int - i) * k_20_28; + int v = 0; + + for (j = j0; j >= 0 && e[j].q16 < gn; j--); + + for (j1 = j; j >= 0; j--) { + int e_diff = e[j].q16 - gn; + + v += e_diff < 0 ? k_2u7 : + e_diff < 43 << 16 ? e_diff + ( 7 << 16) + : 2*e_diff - (36 << 16); + } + + if (v > nbits * k_1u4) + j0 = j1; + else + g_int = g_int - i; + } + + /* --- Limit gain index --- */ + + float x_lim = lc3_hr(sr) ? 0x7fffp8f : 0x7fffp0f; + + *g_min = 255 - g_off; + for (int i = 128 ; i > 0; i >>= 1) + if (x_lim * unquantize_gain(*g_min - i) > x_max) + *g_min -= i; + + *reset_off = g_int < *g_min || x_max == 0; + if (*reset_off) + g_int = *g_min; + + return g_int; +} + +/** + * Global Gain Adjustment + * dt, sr Duration and samplerate of the frame + * g_idx The estimated quantized gain index + * nbits Computed number of bits coding the spectrum + * nbits_budget Number of bits available for coding the spectrum + * g_idx_min Minimum gain index value + * return Gain adjust value (-1 to 2) + */ +LC3_HOT static int adjust_gain( + enum lc3_dt dt, enum lc3_srate sr, + int g_idx, int nbits, int nbits_budget, int g_idx_min) +{ + /* --- Compute delta threshold --- */ + + const int *t = (const int [LC3_NUM_SRATE][3]){ + { 80, 500, 850 }, { 230, 1025, 1700 }, { 380, 1550, 2550 }, + { 530, 2075, 3400 }, { 680, 2600, 4250 }, + { 680, 2600, 4250 }, { 830, 3125, 5100 } + }[sr]; + + int delta, den = 48; + + if (nbits < t[0]) { + delta = 3*(nbits + 48); + + } else if (nbits < t[1]) { + int n0 = 3*(t[0] + 48), range = t[1] - t[0]; + delta = n0 * range + (nbits - t[0]) * (t[1] - n0); + den *= range; + + } else { + delta = LC3_MIN(nbits, t[2]); + } + + delta = (delta + den/2) / den; + + /* --- Adjust gain --- */ + + if (lc3_hr(sr) && nbits > nbits_budget) { + int factor = 1 + (dt <= LC3_DT_5M) + + (dt <= LC3_DT_2M5) * (1 + (nbits >= 520)); + + int g_incr = factor + (factor * (nbits - nbits_budget)) / delta; + return LC3_MIN(g_idx + g_incr, 255) - g_idx; + } + + if (!lc3_hr(sr) && nbits < nbits_budget - (delta + 2)) + return -(g_idx > g_idx_min); + + if (!lc3_hr(sr) && nbits > nbits_budget) + return (g_idx < 255) + (g_idx < 254 && nbits >= nbits_budget + delta); + + return 0; +} + +/** + * Spectrum quantization + * dt, sr Duration and samplerate of the frame + * g_int Quantization gain value + * x Spectral coefficients, scaled as output + * n Return count of significants + */ +LC3_HOT static void quantize( + enum lc3_dt dt, enum lc3_srate sr, int g_int, float *x, int *n) +{ + float g_inv = unquantize_gain(-g_int); + int ne = lc3_ne(dt, sr); + + *n = ne; + + for (int i = 0; i < ne; i += 2) { + float xq_min = lc3_hr(sr) ? 0.5f : 10.f/16; + + x[i+0] *= g_inv; + x[i+1] *= g_inv; + + *n = fabsf(x[i+0]) >= xq_min || + fabsf(x[i+1]) >= xq_min ? ne : *n - 2; + } +} + +/** + * Spectrum quantization inverse + * dt, sr Duration and samplerate of the frame + * g_int Quantization gain value + * x, nq Spectral quantized, and count of significants + * return Unquantized gain value + */ +LC3_HOT static float unquantize( + enum lc3_dt dt, enum lc3_srate sr, + int g_int, float *x, int nq) +{ + float g = unquantize_gain(g_int); + int i, ne = lc3_ne(dt, sr); + + for (i = 0; i < nq; i++) + x[i] = x[i] * g; + + for ( ; i < ne; i++) + x[i] = 0; + + return g; +} + + +/* ---------------------------------------------------------------------------- + * Spectrum coding + * -------------------------------------------------------------------------- */ + +/** + * Resolve High-bitrate and LSB modes according size of the frame + * sr, nbytes Samplerate and size of the frame + * p_lsb_mode True when LSB mode allowed, when not NULL + * return True when High-Rate mode enabled + */ +static bool resolve_modes(enum lc3_srate sr, int nbytes, bool *p_lsb_mode) +{ + int sr_ind = lc3_hr(sr) ? 4 + (sr - LC3_SRATE_48K_HR) : sr; + + if (p_lsb_mode) + *p_lsb_mode = (nbytes >= 20 * (3 + sr_ind)) && (sr < LC3_SRATE_96K_HR); + + return (nbytes > 20 * (1 + sr_ind)) && (sr < LC3_SRATE_96K_HR); +} + +/** + * Bit consumption + * dt, sr, nbytes Duration, samplerate and size of the frame + * x Spectral quantized coefficients + * n Count of significant coefficients, updated on truncation + * nbits_budget Truncate to stay in budget, when not zero + * p_lsb_mode Return True when LSB's are not AC coded, or NULL + * return The number of bits coding the spectrum + */ +LC3_HOT static int compute_nbits( + enum lc3_dt dt, enum lc3_srate sr, int nbytes, + const float *x, int *n, int nbits_budget, bool *p_lsb_mode) +{ + bool lsb_mode, high_rate = resolve_modes(sr, nbytes, &lsb_mode); + int ne = lc3_ne(dt, sr); + + /* --- Loop on quantized coefficients --- */ + + int nbits = 0, nbits_lsb = 0; + uint8_t state = 0; + + int nbits_end = 0; + int n_end = 0; + + nbits_budget = nbits_budget ? nbits_budget * 2048 : INT_MAX; + + for (int i = 0, h = 0; h < 2; h++) { + const uint8_t (*lut_coeff)[4] = lc3_spectrum_lookup[high_rate][h]; + + for ( ; i < LC3_MIN(*n, (ne + 2) >> (1 - h)) + && nbits <= nbits_budget; i += 2) { + + float xq_off = lc3_hr(sr) ? 0.5f : 6.f/16; + uint32_t a = fabsf(x[i+0]) + xq_off; + uint32_t b = fabsf(x[i+1]) + xq_off; + + const uint8_t *lut = lut_coeff[state]; + + /* --- Sign values --- */ + + int s = (a != 0) + (b != 0); + nbits += s * 2048; + + /* --- LSB values Reduce to 2*2 bits MSB values --- + * Reduce to 2x2 bits MSB values. The LSB's pair are arithmetic + * coded with an escape code followed by 1 bit for each values. + * The LSB mode does not arthmetic code the first LSB, + * add the sign of the LSB when one of pair was at value 1 */ + + uint32_t m = (a | b) >> 2; + unsigned k = 0; + + if (m) { + + if (lsb_mode) { + nbits += lc3_spectrum_bits[lut[k++]][16] - 2*2048; + nbits_lsb += 2 + (a == 1) + (b == 1); + } + + for (m >>= lsb_mode; m; m >>= 1, k++) + nbits += lc3_spectrum_bits[lut[LC3_MIN(k, 3)]][16]; + + nbits += k * 2*2048; + a >>= k; + b >>= k; + + k = LC3_MIN(k, 3); + } + + /* --- MSB values --- */ + + nbits += lc3_spectrum_bits[lut[k]][a + 4*b]; + + /* --- Update state --- */ + + if (s && nbits <= nbits_budget) { + n_end = i + 2; + nbits_end = nbits; + } + + state = (state << 4) + (k > 1 ? 12 + k : 1 + (a + b) * (k + 1)); + } + } + + /* --- Return --- */ + + *n = n_end; + + if (p_lsb_mode) + *p_lsb_mode = lsb_mode && + nbits_end + nbits_lsb * 2048 > nbits_budget; + + if (nbits_budget >= INT_MAX) + nbits_end += nbits_lsb * 2048; + + return (nbits_end + 2047) / 2048; +} + +/** + * Put quantized spectrum + * bits Bitstream context + * dt, sr, nbytes Duration, samplerate and size of the frame + * x Spectral quantized coefficients + * nq, lsb_mode Count of significants, and LSB discard indication + */ +LC3_HOT static void put_quantized(lc3_bits_t *bits, + enum lc3_dt dt, enum lc3_srate sr, int nbytes, + const float *x, int nq, bool lsb_mode) +{ + bool high_rate = resolve_modes(sr, nbytes, NULL); + int ne = lc3_ne(dt, sr); + + /* --- Loop on quantized coefficients --- */ + + uint8_t state = 0; + + for (int i = 0, h = 0; h < 2; h++) { + const uint8_t (*lut_coeff)[4] = lc3_spectrum_lookup[high_rate][h]; + + for ( ; i < LC3_MIN(nq, (ne + 2) >> (1 - h)); i += 2) { + + float xq_off = lc3_hr(sr) ? 0.5f : 6.f/16; + uint32_t a = fabsf(x[i+0]) + xq_off; + uint32_t b = fabsf(x[i+1]) + xq_off; + + const uint8_t *lut = lut_coeff[state]; + + /* --- LSB values Reduce to 2*2 bits MSB values --- + * Reduce to 2x2 bits MSB values. The LSB's pair are arithmetic + * coded with an escape code and 1 bits for each values. + * The LSB mode discard the first LSB (at this step) */ + + uint32_t m = (a | b) >> 2; + unsigned k = 0, shr = 0; + + if (m) { + + if (lsb_mode) + lc3_put_symbol(bits, + lc3_spectrum_models + lut[k++], 16); + + for (m >>= lsb_mode; m; m >>= 1, k++) { + lc3_put_bit(bits, (a >> k) & 1); + lc3_put_bit(bits, (b >> k) & 1); + lc3_put_symbol(bits, + lc3_spectrum_models + lut[LC3_MIN(k, 3)], 16); + } + + a >>= lsb_mode; + b >>= lsb_mode; + + shr = k - lsb_mode; + k = LC3_MIN(k, 3); + } + + /* --- Sign values --- */ + + if (a) lc3_put_bit(bits, x[i+0] < 0); + if (b) lc3_put_bit(bits, x[i+1] < 0); + + /* --- MSB values --- */ + + a >>= shr; + b >>= shr; + + lc3_put_symbol(bits, lc3_spectrum_models + lut[k], a + 4*b); + + /* --- Update state --- */ + + state = (state << 4) + (k > 1 ? 12 + k : 1 + (a + b) * (k + 1)); + } + } +} + +/** + * Get quantized spectrum + * bits Bitstream context + * dt, sr, nbytes Duration, samplerate and size of the frame + * nq, lsb_mode Count of significants, and LSB discard indication + * x Return `nq` spectral quantized coefficients + * nf_seed Return the noise factor seed associated + * return 0: Ok -1: Invalid bitstream data + */ +LC3_HOT static int get_quantized(lc3_bits_t *bits, + enum lc3_dt dt, enum lc3_srate sr, int nbytes, + int nq, bool lsb_mode, float *x, uint16_t *nf_seed) +{ + bool high_rate = resolve_modes(sr, nbytes, NULL); + int ne = lc3_ne(dt, sr); + + *nf_seed = 0; + + /* --- Loop on quantized coefficients --- */ + + uint8_t state = 0; + + for (int i = 0, h = 0; h < 2; h++) { + const uint8_t (*lut_coeff)[4] = lc3_spectrum_lookup[high_rate][h]; + + for ( ; i < LC3_MIN(nq, (ne + 2) >> (1 - h)); i += 2) { + + const uint8_t *lut = lut_coeff[state]; + int max_shl = lc3_hr(sr) ? 22 : 14; + + /* --- LSB values --- + * Until the symbol read indicates the escape value 16, + * read an LSB bit for each values. + * The LSB mode discard the first LSB (at this step) */ + + int u = 0, v = 0; + int k = 0, shl = 0; + + unsigned s = lc3_get_symbol(bits, lc3_spectrum_models + lut[k]); + + if (lsb_mode && s >= 16) { + s = lc3_get_symbol(bits, lc3_spectrum_models + lut[++k]); + shl++; + } + + for ( ; s >= 16 && shl < max_shl; shl++) { + u |= lc3_get_bit(bits) << shl; + v |= lc3_get_bit(bits) << shl; + + k += (k < 3); + s = lc3_get_symbol(bits, lc3_spectrum_models + lut[k]); + } + + if (s >= 16) + return -1; + + /* --- MSB & sign values --- */ + + int a = s % 4; + int b = s / 4; + + u |= a << shl; + v |= b << shl; + + x[i+0] = u && lc3_get_bit(bits) ? -u : u; + x[i+1] = v && lc3_get_bit(bits) ? -v : v; + + *nf_seed = (*nf_seed + (u & 0x7fff) * (i ) + + (v & 0x7fff) * (i+1)) & 0xffff; + + /* --- Update state --- */ + + state = (state << 4) + (k > 1 ? 12 + k : 1 + (a + b) * (k + 1)); + } + } + + return 0; +} + +/** + * Put residual bits of quantization + * bits Bitstream context + * nbits Maximum number of bits to output + * hrmode High-Resolution mode + * x, n Spectral quantized, and count of significants + */ +LC3_HOT static void put_residual(lc3_bits_t *bits, + int nbits, bool hrmode, float *x, int n) +{ + float xq_lim = hrmode ? 0.5f : 10.f/16; + float xq_off = xq_lim / 2; + + for (int iter = 0; iter < (hrmode ? 20 : 1) && nbits > 0; iter++) { + for (int i = 0; i < n && nbits > 0; i++) { + + float xr = fabsf(x[i]); + if (xr < xq_lim) + continue; + + bool b = (xr - truncf(xr) < xq_lim) ^ (x[i] < 0); + lc3_put_bit(bits, b); + nbits--; + + x[i] += b ? -xq_off : xq_off; + } + + xq_off *= xq_lim; + } +} + +/** + * Get residual bits of quantization + * bits Bitstream context + * nbits Maximum number of bits to output + * hrmode High-Resolution mode + * x, nq Spectral quantized, and count of significants + */ +LC3_HOT static void get_residual(lc3_bits_t *bits, + int nbits, bool hrmode, float *x, int n) +{ + float xq_off_1 = hrmode ? 0.25f : 5.f/16; + float xq_off_2 = hrmode ? 0.25f : 3.f/16; + + for (int iter = 0; iter < (hrmode ? 20 : 1) && nbits > 0; iter++) { + for (int i = 0; i < n && nbits > 0; i++) { + + if (x[i] == 0) + continue; + + if (lc3_get_bit(bits) == 0) + x[i] -= x[i] < 0 ? xq_off_1 : xq_off_2; + else + x[i] += x[i] > 0 ? xq_off_1 : xq_off_2; + + nbits--; + } + + xq_off_1 *= 0.5f; + xq_off_2 *= 0.5f; + } +} + +/** + * Put LSB values of quantized spectrum values + * bits Bitstream context + * nbits Maximum number of bits to output + * hrmode High-Resolution mode + * x, n Spectral quantized, and count of significants + */ +LC3_HOT static void put_lsb(lc3_bits_t *bits, + int nbits, bool hrmode, const float *x, int n) +{ + for (int i = 0; i < n && nbits > 0; i += 2) { + + float xq_off = hrmode ? 0.5f : 6.f/16; + uint32_t a = fabsf(x[i+0]) + xq_off; + uint32_t b = fabsf(x[i+1]) + xq_off; + + if ((a | b) >> 2 == 0) + continue; + + if (nbits-- > 0) + lc3_put_bit(bits, a & 1); + + if (a == 1 && nbits-- > 0) + lc3_put_bit(bits, x[i+0] < 0); + + if (nbits-- > 0) + lc3_put_bit(bits, b & 1); + + if (b == 1 && nbits-- > 0) + lc3_put_bit(bits, x[i+1] < 0); + } +} + +/** + * Get LSB values of quantized spectrum values + * bits Bitstream context + * nbits Maximum number of bits to output + * x, nq Spectral quantized, and count of significants + * nf_seed Update the noise factor seed according + */ +LC3_HOT static void get_lsb(lc3_bits_t *bits, + int nbits, float *x, int nq, uint16_t *nf_seed) +{ + for (int i = 0; i < nq && nbits > 0; i += 2) { + + float a = fabsf(x[i]), b = fabsf(x[i+1]); + + if (fmaxf(a, b) < 4) + continue; + + if (nbits-- > 0 && lc3_get_bit(bits)) { + if (a) { + x[i] += x[i] < 0 ? -1 : 1; + *nf_seed = (*nf_seed + i) & 0xffff; + } else if (nbits-- > 0) { + x[i] = lc3_get_bit(bits) ? -1 : 1; + *nf_seed = (*nf_seed + i) & 0xffff; + } + } + + if (nbits-- > 0 && lc3_get_bit(bits)) { + if (b) { + x[i+1] += x[i+1] < 0 ? -1 : 1; + *nf_seed = (*nf_seed + i+1) & 0xffff; + } else if (nbits-- > 0) { + x[i+1] = lc3_get_bit(bits) ? -1 : 1; + *nf_seed = (*nf_seed + i+1) & 0xffff; + } + } + } +} + + +/* ---------------------------------------------------------------------------- + * Noise coding + * -------------------------------------------------------------------------- */ + +/** + * Estimate noise level + * dt, bw Duration and bandwidth of the frame + * hrmode High-Resolution mode + * x, n Spectral quantized, and count of significants + * return Noise factor (0 to 7) + */ +LC3_HOT static int estimate_noise( + enum lc3_dt dt, enum lc3_bandwidth bw, bool hrmode, const float *x, int n) +{ + int bw_stop = lc3_ne(dt, (enum lc3_srate)LC3_MIN(bw, LC3_BANDWIDTH_FB)); + int w = 1 + (dt >= LC3_DT_7M5) + (dt>= LC3_DT_10M); + + float xq_lim = hrmode ? 0.5f : 10.f/16; + float sum = 0; + int i, ns = 0, z = 0; + + for (i = 6 * (1 + dt) - w; i < LC3_MIN(n, bw_stop); i++) { + z = fabsf(x[i]) < xq_lim ? z + 1 : 0; + if (z > 2*w) + sum += fabsf(x[i - w]), ns++; + } + + for ( ; i < bw_stop + w; i++) + if (++z > 2*w) + sum += fabsf(x[i - w]), ns++; + + int nf = ns ? 8 - (int)((16 * sum) / ns + 0.5f) : 8; + + return LC3_CLIP(nf, 0, 7); +} + +/** + * Noise filling + * dt, bw Duration and bandwidth of the frame + * nf, nf_seed The noise factor and pseudo-random seed + * g Quantization gain + * x, nq Spectral quantized, and count of significants + */ +LC3_HOT static void fill_noise(enum lc3_dt dt, enum lc3_bandwidth bw, + int nf, uint16_t nf_seed, float g, float *x, int nq) +{ + int bw_stop = lc3_ne(dt, (enum lc3_srate)LC3_MIN(bw, LC3_BANDWIDTH_FB)); + int w = 1 + (dt >= LC3_DT_7M5) + (dt>= LC3_DT_10M); + + float s = g * (float)(8 - nf) / 16; + int i, z = 0; + + for (i = 6 * (1 + dt) - w; i < LC3_MIN(nq, bw_stop); i++) { + z = x[i] ? 0 : z + 1; + if (z > 2*w) { + nf_seed = (13849 + nf_seed*31821) & 0xffff; + x[i - w] = nf_seed & 0x8000 ? -s : s; + } + } + + for ( ; i < bw_stop + w; i++) + if (++z > 2*w) { + nf_seed = (13849 + nf_seed*31821) & 0xffff; + x[i - w] = nf_seed & 0x8000 ? -s : s; + } +} + +/** + * Put noise factor + * bits Bitstream context + * nf Noise factor (0 to 7) + */ +static void put_noise_factor(lc3_bits_t *bits, int nf) +{ + lc3_put_bits(bits, nf, 3); +} + +/** + * Get noise factor + * bits Bitstream context + * return Noise factor (0 to 7) + */ +static int get_noise_factor(lc3_bits_t *bits) +{ + return lc3_get_bits(bits, 3); +} + + +/* ---------------------------------------------------------------------------- + * Encoding + * -------------------------------------------------------------------------- */ + +/** + * Bit consumption of the number of coded coefficients + * dt, sr, nbytes Duration, samplerate and size of the frame + * return Bit consumpution of the number of coded coefficients + */ +static int get_nbits_nq(enum lc3_dt dt, enum lc3_srate sr) +{ + int ne = lc3_ne(dt, sr); + return 4 + (ne > 32) + (ne > 64) + (ne > 128) + (ne > 256) + (ne > 512); +} + +/** + * Bit consumption of the arithmetic coder + * dt, sr, nbytes Duration, samplerate and size of the frame + * return Bit consumption of bitstream data + */ +static int get_nbits_ac(enum lc3_dt dt, enum lc3_srate sr, int nbytes) +{ + return get_nbits_nq(dt, sr) + + 3 + lc3_hr(sr) + LC3_MIN((nbytes-1) / 160, 2); +} + +/** + * Spectrum analysis + */ +void lc3_spec_analyze( + enum lc3_dt dt, enum lc3_srate sr, int nbytes, + bool pitch, const lc3_tns_data_t *tns, + struct lc3_spec_analysis *spec, + float *x, struct lc3_spec_side *side) +{ + bool reset_off; + + /* --- Bit budget --- */ + + const int nbits_gain = 8; + const int nbits_nf = 3; + + int nbits_budget = 8*nbytes - get_nbits_ac(dt, sr, nbytes) - + lc3_bwdet_get_nbits(sr) - lc3_ltpf_get_nbits(pitch) - + lc3_sns_get_nbits() - lc3_tns_get_nbits(tns) - nbits_gain - nbits_nf; + + /* --- Global gain --- */ + + float nbits_off = spec->nbits_off + spec->nbits_spare; + nbits_off = fminf(fmaxf(nbits_off, -40), 40); + nbits_off = 0.8f * spec->nbits_off + 0.2f * nbits_off; + + int g_off = resolve_gain_offset(sr, nbytes); + + int g_min, g_int = estimate_gain(dt, sr, + x, nbytes, nbits_budget, nbits_off, g_off, &reset_off, &g_min); + + /* --- Quantization --- */ + + quantize(dt, sr, g_int, x, &side->nq); + + int nbits = compute_nbits(dt, sr, nbytes, x, &side->nq, 0, NULL); + + spec->nbits_off = reset_off ? 0 : nbits_off; + spec->nbits_spare = reset_off ? 0 : nbits_budget - nbits; + + /* --- Adjust gain and requantize --- */ + + int g_adj = adjust_gain(dt, sr, + g_off + g_int, nbits, nbits_budget, g_off + g_min); + + if (g_adj) + quantize(dt, sr, g_adj, x, &side->nq); + + side->g_idx = g_int + g_adj + g_off; + nbits = compute_nbits(dt, sr, nbytes, + x, &side->nq, nbits_budget, &side->lsb_mode); +} + +/** + * Put spectral quantization side data + */ +void lc3_spec_put_side(lc3_bits_t *bits, + enum lc3_dt dt, enum lc3_srate sr, + const struct lc3_spec_side *side) +{ + int nbits_nq = get_nbits_nq(dt, sr); + + lc3_put_bits(bits, LC3_MAX(side->nq >> 1, 1) - 1, nbits_nq); + lc3_put_bits(bits, side->lsb_mode, 1); + lc3_put_bits(bits, side->g_idx, 8); +} + +/** + * Encode spectral coefficients + */ +void lc3_spec_encode(lc3_bits_t *bits, + enum lc3_dt dt, enum lc3_srate sr, enum lc3_bandwidth bw, + int nbytes, const lc3_spec_side_t *side, float *x) +{ + bool lsb_mode = side->lsb_mode; + int nq = side->nq; + + put_noise_factor(bits, estimate_noise(dt, bw, lc3_hr(sr), x, nq)); + + put_quantized(bits, dt, sr, nbytes, x, nq, lsb_mode); + + int nbits_left = lc3_get_bits_left(bits); + + if (lsb_mode) + put_lsb(bits, nbits_left, lc3_hr(sr), x, nq); + else + put_residual(bits, nbits_left, lc3_hr(sr), x, nq); +} + + +/* ---------------------------------------------------------------------------- + * Decoding + * -------------------------------------------------------------------------- */ + +/** + * Get spectral quantization side data + */ +int lc3_spec_get_side(lc3_bits_t *bits, + enum lc3_dt dt, enum lc3_srate sr, struct lc3_spec_side *side) +{ + int nbits_nq = get_nbits_nq(dt, sr); + int ne = lc3_ne(dt, sr); + + side->nq = (lc3_get_bits(bits, nbits_nq) + 1) << 1; + side->lsb_mode = lc3_get_bit(bits); + side->g_idx = lc3_get_bits(bits, 8); + + return side->nq > ne ? (side->nq = ne), -1 : 0; +} + +/** + * Decode spectral coefficients + */ +int lc3_spec_decode(lc3_bits_t *bits, + enum lc3_dt dt, enum lc3_srate sr, enum lc3_bandwidth bw, + int nbytes, const lc3_spec_side_t *side, float *x) +{ + bool lsb_mode = side->lsb_mode; + int nq = side->nq; + int ret = 0; + + int nf = get_noise_factor(bits); + uint16_t nf_seed; + + if ((ret = get_quantized(bits, dt, sr, nbytes, + nq, lsb_mode, x, &nf_seed)) < 0) + return ret; + + int nbits_left = lc3_get_bits_left(bits); + + if (lsb_mode) + get_lsb(bits, nbits_left, x, nq, &nf_seed); + else + get_residual(bits, nbits_left, lc3_hr(sr), x, nq); + + int g_int = side->g_idx - resolve_gain_offset(sr, nbytes); + float g = unquantize(dt, sr, g_int, x, nq); + + if (nq > 2 || x[0] || x[1] || side->g_idx > 0 || nf < 7) + fill_noise(dt, bw, nf, nf_seed, g, x, nq); + + return 0; +} diff --git a/App_Resources/iOS/src/lc3/spec.h b/App_Resources/iOS/src/lc3/spec.h new file mode 100644 index 00000000..92843638 --- /dev/null +++ b/App_Resources/iOS/src/lc3/spec.h @@ -0,0 +1,105 @@ +/****************************************************************************** + * + * Copyright 2022 Google LLC + * + * 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. + * + ******************************************************************************/ + +#ifndef __LC3_SPEC_H +#define __LC3_SPEC_H + +#include "common.h" +#include "tables.h" +#include "bwdet.h" +#include "ltpf.h" +#include "tns.h" +#include "sns.h" + + +/** + * Spectral quantization side data + */ +typedef struct lc3_spec_side { + int g_idx, nq; + bool lsb_mode; +} lc3_spec_side_t; + + +/* ---------------------------------------------------------------------------- + * Encoding + * -------------------------------------------------------------------------- */ + +/** + * Spectrum analysis + * dt, sr, nbytes Duration, samplerate and size of the frame + * pitch, tns Pitch present indication and TNS bistream data + * spec Context of analysis + * x Spectral coefficients, scaled as output + * side Return quantization data + */ +void lc3_spec_analyze( + enum lc3_dt dt, enum lc3_srate sr, int nbytes, + bool pitch, const lc3_tns_data_t *tns, lc3_spec_analysis_t *spec, + float *x, lc3_spec_side_t *side); + +/** + * Put spectral quantization side data + * bits Bitstream context + * dt, sr Duration and samplerate of the frame + * side Spectral quantization side data + */ +void lc3_spec_put_side(lc3_bits_t *bits, + enum lc3_dt dt, enum lc3_srate sr, const lc3_spec_side_t *side); + +/** + * Encode spectral coefficients + * bits Bitstream context + * dt, sr, bw Duration, samplerate, bandwidth + * nbytes and size of the frame + * side, x Quantization data, and scaled coefficients + */ +void lc3_spec_encode(lc3_bits_t *bits, + enum lc3_dt dt, enum lc3_srate sr, enum lc3_bandwidth bw, + int nbytes, const lc3_spec_side_t *side, float *x); + + +/* ---------------------------------------------------------------------------- + * Decoding + * -------------------------------------------------------------------------- */ + +/** + * Get spectral quantization side data + * bits Bitstream context + * dt, sr Duration and samplerate of the frame + * side Return quantization side data + * return 0: Ok -1: Invalid bandwidth indication + */ +int lc3_spec_get_side(lc3_bits_t *bits, + enum lc3_dt dt, enum lc3_srate sr, lc3_spec_side_t *side); + +/** + * Decode spectral coefficients + * bits Bitstream context + * dt, sr, bw Duration, samplerate, bandwidth + * nbytes and size of the frame + * side Quantization side data + * x Spectral coefficients + * return 0: Ok -1: Invalid bitstream data + */ +int lc3_spec_decode(lc3_bits_t *bits, + enum lc3_dt dt, enum lc3_srate sr, enum lc3_bandwidth bw, + int nbytes, const lc3_spec_side_t *side, float *x); + + +#endif /* __LC3_SPEC_H */ diff --git a/App_Resources/iOS/src/lc3/tables.c b/App_Resources/iOS/src/lc3/tables.c new file mode 100644 index 00000000..947813d5 --- /dev/null +++ b/App_Resources/iOS/src/lc3/tables.c @@ -0,0 +1,5762 @@ +/****************************************************************************** + * + * Copyright 2022 Google LLC + * + * 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 "tables.h" + + +/** + * Characteristics + */ + +const int lc3_ns_2m5[LC3_NUM_SRATE] = { + [LC3_SRATE_8K ] = LC3_NS(2500, 8000), + [LC3_SRATE_16K ] = LC3_NS(2500, 16000), + [LC3_SRATE_24K ] = LC3_NS(2500, 24000), + [LC3_SRATE_32K ] = LC3_NS(2500, 32000), + [LC3_SRATE_48K ] = LC3_NS(2500, 48000), + [LC3_SRATE_48K_HR] = LC3_NS(2500, 48000), + [LC3_SRATE_96K_HR] = LC3_NS(2500, 96000), +}; + +const int lc3_ne_2m5[LC3_NUM_SRATE] = { + [LC3_SRATE_8K ] = LC3_NS(2500, 8000), + [LC3_SRATE_16K ] = LC3_NS(2500, 16000), + [LC3_SRATE_24K ] = LC3_NS(2500, 24000), + [LC3_SRATE_32K ] = LC3_NS(2500, 32000), + [LC3_SRATE_48K ] = LC3_NS(2500, 40000), + [LC3_SRATE_48K_HR] = LC3_NS(2500, 48000), + [LC3_SRATE_96K_HR] = LC3_NS(2500, 96000), +}; + +const int lc3_ns_4m[LC3_NUM_SRATE] = { + [LC3_SRATE_8K ] = LC3_NS(4000, 8000), + [LC3_SRATE_16K ] = LC3_NS(4000, 16000), + [LC3_SRATE_24K ] = LC3_NS(4000, 24000), + [LC3_SRATE_32K ] = LC3_NS(4000, 32000), + [LC3_SRATE_48K ] = LC3_NS(4000, 48000), + [LC3_SRATE_48K_HR] = LC3_NS(4000, 48000), + [LC3_SRATE_96K_HR] = LC3_NS(4000, 96000), +}; + + +/** + * Limits on size of frame + * For fallback operation, half-size should be accepted. + */ + +const int lc3_frame_bytes_hr_lim + [LC3_NUM_DT][LC3_NUM_SRATE - LC3_SRATE_48K_HR][2] = { + + [LC3_DT_2M5][LC3_SRATE_48K_HR - LC3_SRATE_48K_HR] = { 54/2, 210 }, + [LC3_DT_2M5][LC3_SRATE_96K_HR - LC3_SRATE_48K_HR] = { 62/2, 210 }, + + [LC3_DT_5M ][LC3_SRATE_48K_HR - LC3_SRATE_48K_HR] = { 93/2, 375 }, + [LC3_DT_5M ][LC3_SRATE_96K_HR - LC3_SRATE_48K_HR] = { 109/2, 375 }, + + [LC3_DT_10M][LC3_SRATE_48K_HR - LC3_SRATE_48K_HR] = { 156/2, 625 }, + [LC3_DT_10M][LC3_SRATE_96K_HR - LC3_SRATE_48K_HR] = { 187/2, 625 }, + +}; + + +/** + * Twiddles FFT 3 points + * + * T[0..N-1] = + * { cos(-2Pi * i/N) + j sin(-2Pi * i/N), + * cos(-2Pi * 2i/N) + j sin(-2Pi * 2i/N) } , N=15, 45 + */ + +static const struct lc3_fft_bf3_twiddles fft_twiddles_15 = { + .n3 = 15/3, .t = (const struct lc3_complex [][2]){ + { { 1.0000000e+0, -0.0000000e+0 }, { 1.0000000e+0, -0.0000000e+0 } }, + { { 9.1354546e-1, -4.0673664e-1 }, { 6.6913061e-1, -7.4314483e-1 } }, + { { 6.6913061e-1, -7.4314483e-1 }, { -1.0452846e-1, -9.9452190e-1 } }, + { { 3.0901699e-1, -9.5105652e-1 }, { -8.0901699e-1, -5.8778525e-1 } }, + { { -1.0452846e-1, -9.9452190e-1 }, { -9.7814760e-1, 2.0791169e-1 } }, + { { -5.0000000e-1, -8.6602540e-1 }, { -5.0000000e-1, 8.6602540e-1 } }, + { { -8.0901699e-1, -5.8778525e-1 }, { 3.0901699e-1, 9.5105652e-1 } }, + { { -9.7814760e-1, -2.0791169e-1 }, { 9.1354546e-1, 4.0673664e-1 } }, + { { -9.7814760e-1, 2.0791169e-1 }, { 9.1354546e-1, -4.0673664e-1 } }, + { { -8.0901699e-1, 5.8778525e-1 }, { 3.0901699e-1, -9.5105652e-1 } }, + { { -5.0000000e-1, 8.6602540e-1 }, { -5.0000000e-1, -8.6602540e-1 } }, + { { -1.0452846e-1, 9.9452190e-1 }, { -9.7814760e-1, -2.0791169e-1 } }, + { { 3.0901699e-1, 9.5105652e-1 }, { -8.0901699e-1, 5.8778525e-1 } }, + { { 6.6913061e-1, 7.4314483e-1 }, { -1.0452846e-1, 9.9452190e-1 } }, + { { 9.1354546e-1, 4.0673664e-1 }, { 6.6913061e-1, 7.4314483e-1 } }, + } +}; + +static const struct lc3_fft_bf3_twiddles fft_twiddles_45 = { + .n3 = 45/3, .t = (const struct lc3_complex [][2]){ + { { 1.0000000e+0, -0.0000000e+0 }, { 1.0000000e+0, -0.0000000e+0 } }, + { { 9.9026807e-1, -1.3917310e-1 }, { 9.6126170e-1, -2.7563736e-1 } }, + { { 9.6126170e-1, -2.7563736e-1 }, { 8.4804810e-1, -5.2991926e-1 } }, + { { 9.1354546e-1, -4.0673664e-1 }, { 6.6913061e-1, -7.4314483e-1 } }, + { { 8.4804810e-1, -5.2991926e-1 }, { 4.3837115e-1, -8.9879405e-1 } }, + { { 7.6604444e-1, -6.4278761e-1 }, { 1.7364818e-1, -9.8480775e-1 } }, + { { 6.6913061e-1, -7.4314483e-1 }, { -1.0452846e-1, -9.9452190e-1 } }, + { { 5.5919290e-1, -8.2903757e-1 }, { -3.7460659e-1, -9.2718385e-1 } }, + { { 4.3837115e-1, -8.9879405e-1 }, { -6.1566148e-1, -7.8801075e-1 } }, + { { 3.0901699e-1, -9.5105652e-1 }, { -8.0901699e-1, -5.8778525e-1 } }, + { { 1.7364818e-1, -9.8480775e-1 }, { -9.3969262e-1, -3.4202014e-1 } }, + { { 3.4899497e-2, -9.9939083e-1 }, { -9.9756405e-1, -6.9756474e-2 } }, + { { -1.0452846e-1, -9.9452190e-1 }, { -9.7814760e-1, 2.0791169e-1 } }, + { { -2.4192190e-1, -9.7029573e-1 }, { -8.8294759e-1, 4.6947156e-1 } }, + { { -3.7460659e-1, -9.2718385e-1 }, { -7.1933980e-1, 6.9465837e-1 } }, + { { -5.0000000e-1, -8.6602540e-1 }, { -5.0000000e-1, 8.6602540e-1 } }, + { { -6.1566148e-1, -7.8801075e-1 }, { -2.4192190e-1, 9.7029573e-1 } }, + { { -7.1933980e-1, -6.9465837e-1 }, { 3.4899497e-2, 9.9939083e-1 } }, + { { -8.0901699e-1, -5.8778525e-1 }, { 3.0901699e-1, 9.5105652e-1 } }, + { { -8.8294759e-1, -4.6947156e-1 }, { 5.5919290e-1, 8.2903757e-1 } }, + { { -9.3969262e-1, -3.4202014e-1 }, { 7.6604444e-1, 6.4278761e-1 } }, + { { -9.7814760e-1, -2.0791169e-1 }, { 9.1354546e-1, 4.0673664e-1 } }, + { { -9.9756405e-1, -6.9756474e-2 }, { 9.9026807e-1, 1.3917310e-1 } }, + { { -9.9756405e-1, 6.9756474e-2 }, { 9.9026807e-1, -1.3917310e-1 } }, + { { -9.7814760e-1, 2.0791169e-1 }, { 9.1354546e-1, -4.0673664e-1 } }, + { { -9.3969262e-1, 3.4202014e-1 }, { 7.6604444e-1, -6.4278761e-1 } }, + { { -8.8294759e-1, 4.6947156e-1 }, { 5.5919290e-1, -8.2903757e-1 } }, + { { -8.0901699e-1, 5.8778525e-1 }, { 3.0901699e-1, -9.5105652e-1 } }, + { { -7.1933980e-1, 6.9465837e-1 }, { 3.4899497e-2, -9.9939083e-1 } }, + { { -6.1566148e-1, 7.8801075e-1 }, { -2.4192190e-1, -9.7029573e-1 } }, + { { -5.0000000e-1, 8.6602540e-1 }, { -5.0000000e-1, -8.6602540e-1 } }, + { { -3.7460659e-1, 9.2718385e-1 }, { -7.1933980e-1, -6.9465837e-1 } }, + { { -2.4192190e-1, 9.7029573e-1 }, { -8.8294759e-1, -4.6947156e-1 } }, + { { -1.0452846e-1, 9.9452190e-1 }, { -9.7814760e-1, -2.0791169e-1 } }, + { { 3.4899497e-2, 9.9939083e-1 }, { -9.9756405e-1, 6.9756474e-2 } }, + { { 1.7364818e-1, 9.8480775e-1 }, { -9.3969262e-1, 3.4202014e-1 } }, + { { 3.0901699e-1, 9.5105652e-1 }, { -8.0901699e-1, 5.8778525e-1 } }, + { { 4.3837115e-1, 8.9879405e-1 }, { -6.1566148e-1, 7.8801075e-1 } }, + { { 5.5919290e-1, 8.2903757e-1 }, { -3.7460659e-1, 9.2718385e-1 } }, + { { 6.6913061e-1, 7.4314483e-1 }, { -1.0452846e-1, 9.9452190e-1 } }, + { { 7.6604444e-1, 6.4278761e-1 }, { 1.7364818e-1, 9.8480775e-1 } }, + { { 8.4804810e-1, 5.2991926e-1 }, { 4.3837115e-1, 8.9879405e-1 } }, + { { 9.1354546e-1, 4.0673664e-1 }, { 6.6913061e-1, 7.4314483e-1 } }, + { { 9.6126170e-1, 2.7563736e-1 }, { 8.4804810e-1, 5.2991926e-1 } }, + { { 9.9026807e-1, 1.3917310e-1 }, { 9.6126170e-1, 2.7563736e-1 } }, + } +}; + +const struct lc3_fft_bf3_twiddles *lc3_fft_twiddles_bf3[] = + { &fft_twiddles_15, &fft_twiddles_45 }; + + +/** + * Twiddles FFT 2 points + * + * T[0..N/2-1] = + * cos(-2Pi * i/N) + j sin(-2Pi * i/N) , N=10, 20, ... + */ + +static const struct lc3_fft_bf2_twiddles fft_twiddles_10 = { + .n2 = 10/2, .t = (const struct lc3_complex []){ + { 1.0000000e+00, -0.0000000e+00 }, { 8.0901699e-01, -5.8778525e-01 }, + { 3.0901699e-01, -9.5105652e-01 }, { -3.0901699e-01, -9.5105652e-01 }, + { -8.0901699e-01, -5.8778525e-01 }, + } +}; + +static const struct lc3_fft_bf2_twiddles fft_twiddles_20 = { + .n2 = 20/2, .t = (const struct lc3_complex []){ + { 1.0000000e+00, -0.0000000e+00 }, { 9.5105652e-01, -3.0901699e-01 }, + { 8.0901699e-01, -5.8778525e-01 }, { 5.8778525e-01, -8.0901699e-01 }, + { 3.0901699e-01, -9.5105652e-01 }, { 6.1232340e-17, -1.0000000e+00 }, + { -3.0901699e-01, -9.5105652e-01 }, { -5.8778525e-01, -8.0901699e-01 }, + { -8.0901699e-01, -5.8778525e-01 }, { -9.5105652e-01, -3.0901699e-01 }, + } +}; + +static const struct lc3_fft_bf2_twiddles fft_twiddles_30 = { + .n2 = 30/2, .t = (const struct lc3_complex []){ + { 1.0000000e+00, -0.0000000e+00 }, { 9.7814760e-01, -2.0791169e-01 }, + { 9.1354546e-01, -4.0673664e-01 }, { 8.0901699e-01, -5.8778525e-01 }, + { 6.6913061e-01, -7.4314483e-01 }, { 5.0000000e-01, -8.6602540e-01 }, + { 3.0901699e-01, -9.5105652e-01 }, { 1.0452846e-01, -9.9452190e-01 }, + { -1.0452846e-01, -9.9452190e-01 }, { -3.0901699e-01, -9.5105652e-01 }, + { -5.0000000e-01, -8.6602540e-01 }, { -6.6913061e-01, -7.4314483e-01 }, + { -8.0901699e-01, -5.8778525e-01 }, { -9.1354546e-01, -4.0673664e-01 }, + { -9.7814760e-01, -2.0791169e-01 }, + } +}; + +static const struct lc3_fft_bf2_twiddles fft_twiddles_40 = { + .n2 = 40/2, .t = (const struct lc3_complex []){ + { 1.0000000e+00, -0.0000000e+00 }, { 9.8768834e-01, -1.5643447e-01 }, + { 9.5105652e-01, -3.0901699e-01 }, { 8.9100652e-01, -4.5399050e-01 }, + { 8.0901699e-01, -5.8778525e-01 }, { 7.0710678e-01, -7.0710678e-01 }, + { 5.8778525e-01, -8.0901699e-01 }, { 4.5399050e-01, -8.9100652e-01 }, + { 3.0901699e-01, -9.5105652e-01 }, { 1.5643447e-01, -9.8768834e-01 }, + { 6.1232340e-17, -1.0000000e+00 }, { -1.5643447e-01, -9.8768834e-01 }, + { -3.0901699e-01, -9.5105652e-01 }, { -4.5399050e-01, -8.9100652e-01 }, + { -5.8778525e-01, -8.0901699e-01 }, { -7.0710678e-01, -7.0710678e-01 }, + { -8.0901699e-01, -5.8778525e-01 }, { -8.9100652e-01, -4.5399050e-01 }, + { -9.5105652e-01, -3.0901699e-01 }, { -9.8768834e-01, -1.5643447e-01 }, + } +}; + +static const struct lc3_fft_bf2_twiddles fft_twiddles_60 = { + .n2 = 60/2, .t = (const struct lc3_complex []){ + { 1.0000000e+00, -0.0000000e+00 }, { 9.9452190e-01, -1.0452846e-01 }, + { 9.7814760e-01, -2.0791169e-01 }, { 9.5105652e-01, -3.0901699e-01 }, + { 9.1354546e-01, -4.0673664e-01 }, { 8.6602540e-01, -5.0000000e-01 }, + { 8.0901699e-01, -5.8778525e-01 }, { 7.4314483e-01, -6.6913061e-01 }, + { 6.6913061e-01, -7.4314483e-01 }, { 5.8778525e-01, -8.0901699e-01 }, + { 5.0000000e-01, -8.6602540e-01 }, { 4.0673664e-01, -9.1354546e-01 }, + { 3.0901699e-01, -9.5105652e-01 }, { 2.0791169e-01, -9.7814760e-01 }, + { 1.0452846e-01, -9.9452190e-01 }, { 2.8327694e-16, -1.0000000e+00 }, + { -1.0452846e-01, -9.9452190e-01 }, { -2.0791169e-01, -9.7814760e-01 }, + { -3.0901699e-01, -9.5105652e-01 }, { -4.0673664e-01, -9.1354546e-01 }, + { -5.0000000e-01, -8.6602540e-01 }, { -5.8778525e-01, -8.0901699e-01 }, + { -6.6913061e-01, -7.4314483e-01 }, { -7.4314483e-01, -6.6913061e-01 }, + { -8.0901699e-01, -5.8778525e-01 }, { -8.6602540e-01, -5.0000000e-01 }, + { -9.1354546e-01, -4.0673664e-01 }, { -9.5105652e-01, -3.0901699e-01 }, + { -9.7814760e-01, -2.0791169e-01 }, { -9.9452190e-01, -1.0452846e-01 }, + } +}; + +static const struct lc3_fft_bf2_twiddles fft_twiddles_80 = { + .n2 = 80/2, .t = (const struct lc3_complex []){ + { 1.0000000e+00, -0.0000000e+00 }, { 9.9691733e-01, -7.8459096e-02 }, + { 9.8768834e-01, -1.5643447e-01 }, { 9.7236992e-01, -2.3344536e-01 }, + { 9.5105652e-01, -3.0901699e-01 }, { 9.2387953e-01, -3.8268343e-01 }, + { 8.9100652e-01, -4.5399050e-01 }, { 8.5264016e-01, -5.2249856e-01 }, + { 8.0901699e-01, -5.8778525e-01 }, { 7.6040597e-01, -6.4944805e-01 }, + { 7.0710678e-01, -7.0710678e-01 }, { 6.4944805e-01, -7.6040597e-01 }, + { 5.8778525e-01, -8.0901699e-01 }, { 5.2249856e-01, -8.5264016e-01 }, + { 4.5399050e-01, -8.9100652e-01 }, { 3.8268343e-01, -9.2387953e-01 }, + { 3.0901699e-01, -9.5105652e-01 }, { 2.3344536e-01, -9.7236992e-01 }, + { 1.5643447e-01, -9.8768834e-01 }, { 7.8459096e-02, -9.9691733e-01 }, + { 6.1232340e-17, -1.0000000e+00 }, { -7.8459096e-02, -9.9691733e-01 }, + { -1.5643447e-01, -9.8768834e-01 }, { -2.3344536e-01, -9.7236992e-01 }, + { -3.0901699e-01, -9.5105652e-01 }, { -3.8268343e-01, -9.2387953e-01 }, + { -4.5399050e-01, -8.9100652e-01 }, { -5.2249856e-01, -8.5264016e-01 }, + { -5.8778525e-01, -8.0901699e-01 }, { -6.4944805e-01, -7.6040597e-01 }, + { -7.0710678e-01, -7.0710678e-01 }, { -7.6040597e-01, -6.4944805e-01 }, + { -8.0901699e-01, -5.8778525e-01 }, { -8.5264016e-01, -5.2249856e-01 }, + { -8.9100652e-01, -4.5399050e-01 }, { -9.2387953e-01, -3.8268343e-01 }, + { -9.5105652e-01, -3.0901699e-01 }, { -9.7236992e-01, -2.3344536e-01 }, + { -9.8768834e-01, -1.5643447e-01 }, { -9.9691733e-01, -7.8459096e-02 }, + } +}; + +static const struct lc3_fft_bf2_twiddles fft_twiddles_90 = { + .n2 = 90/2, .t = (const struct lc3_complex []){ + { 1.0000000e+00, -0.0000000e+00 }, { 9.9756405e-01, -6.9756474e-02 }, + { 9.9026807e-01, -1.3917310e-01 }, { 9.7814760e-01, -2.0791169e-01 }, + { 9.6126170e-01, -2.7563736e-01 }, { 9.3969262e-01, -3.4202014e-01 }, + { 9.1354546e-01, -4.0673664e-01 }, { 8.8294759e-01, -4.6947156e-01 }, + { 8.4804810e-01, -5.2991926e-01 }, { 8.0901699e-01, -5.8778525e-01 }, + { 7.6604444e-01, -6.4278761e-01 }, { 7.1933980e-01, -6.9465837e-01 }, + { 6.6913061e-01, -7.4314483e-01 }, { 6.1566148e-01, -7.8801075e-01 }, + { 5.5919290e-01, -8.2903757e-01 }, { 5.0000000e-01, -8.6602540e-01 }, + { 4.3837115e-01, -8.9879405e-01 }, { 3.7460659e-01, -9.2718385e-01 }, + { 3.0901699e-01, -9.5105652e-01 }, { 2.4192190e-01, -9.7029573e-01 }, + { 1.7364818e-01, -9.8480775e-01 }, { 1.0452846e-01, -9.9452190e-01 }, + { 3.4899497e-02, -9.9939083e-01 }, { -3.4899497e-02, -9.9939083e-01 }, + { -1.0452846e-01, -9.9452190e-01 }, { -1.7364818e-01, -9.8480775e-01 }, + { -2.4192190e-01, -9.7029573e-01 }, { -3.0901699e-01, -9.5105652e-01 }, + { -3.7460659e-01, -9.2718385e-01 }, { -4.3837115e-01, -8.9879405e-01 }, + { -5.0000000e-01, -8.6602540e-01 }, { -5.5919290e-01, -8.2903757e-01 }, + { -6.1566148e-01, -7.8801075e-01 }, { -6.6913061e-01, -7.4314483e-01 }, + { -7.1933980e-01, -6.9465837e-01 }, { -7.6604444e-01, -6.4278761e-01 }, + { -8.0901699e-01, -5.8778525e-01 }, { -8.4804810e-01, -5.2991926e-01 }, + { -8.8294759e-01, -4.6947156e-01 }, { -9.1354546e-01, -4.0673664e-01 }, + { -9.3969262e-01, -3.4202014e-01 }, { -9.6126170e-01, -2.7563736e-01 }, + { -9.7814760e-01, -2.0791169e-01 }, { -9.9026807e-01, -1.3917310e-01 }, + { -9.9756405e-01, -6.9756474e-02 }, + } +}; + +static const struct lc3_fft_bf2_twiddles fft_twiddles_120 = { + .n2 = 120/2, .t = (const struct lc3_complex []){ + { 1.0000000e+00, -0.0000000e+00 }, { 9.9862953e-01, -5.2335956e-02 }, + { 9.9452190e-01, -1.0452846e-01 }, { 9.8768834e-01, -1.5643447e-01 }, + { 9.7814760e-01, -2.0791169e-01 }, { 9.6592583e-01, -2.5881905e-01 }, + { 9.5105652e-01, -3.0901699e-01 }, { 9.3358043e-01, -3.5836795e-01 }, + { 9.1354546e-01, -4.0673664e-01 }, { 8.9100652e-01, -4.5399050e-01 }, + { 8.6602540e-01, -5.0000000e-01 }, { 8.3867057e-01, -5.4463904e-01 }, + { 8.0901699e-01, -5.8778525e-01 }, { 7.7714596e-01, -6.2932039e-01 }, + { 7.4314483e-01, -6.6913061e-01 }, { 7.0710678e-01, -7.0710678e-01 }, + { 6.6913061e-01, -7.4314483e-01 }, { 6.2932039e-01, -7.7714596e-01 }, + { 5.8778525e-01, -8.0901699e-01 }, { 5.4463904e-01, -8.3867057e-01 }, + { 5.0000000e-01, -8.6602540e-01 }, { 4.5399050e-01, -8.9100652e-01 }, + { 4.0673664e-01, -9.1354546e-01 }, { 3.5836795e-01, -9.3358043e-01 }, + { 3.0901699e-01, -9.5105652e-01 }, { 2.5881905e-01, -9.6592583e-01 }, + { 2.0791169e-01, -9.7814760e-01 }, { 1.5643447e-01, -9.8768834e-01 }, + { 1.0452846e-01, -9.9452190e-01 }, { 5.2335956e-02, -9.9862953e-01 }, + { 2.8327694e-16, -1.0000000e+00 }, { -5.2335956e-02, -9.9862953e-01 }, + { -1.0452846e-01, -9.9452190e-01 }, { -1.5643447e-01, -9.8768834e-01 }, + { -2.0791169e-01, -9.7814760e-01 }, { -2.5881905e-01, -9.6592583e-01 }, + { -3.0901699e-01, -9.5105652e-01 }, { -3.5836795e-01, -9.3358043e-01 }, + { -4.0673664e-01, -9.1354546e-01 }, { -4.5399050e-01, -8.9100652e-01 }, + { -5.0000000e-01, -8.6602540e-01 }, { -5.4463904e-01, -8.3867057e-01 }, + { -5.8778525e-01, -8.0901699e-01 }, { -6.2932039e-01, -7.7714596e-01 }, + { -6.6913061e-01, -7.4314483e-01 }, { -7.0710678e-01, -7.0710678e-01 }, + { -7.4314483e-01, -6.6913061e-01 }, { -7.7714596e-01, -6.2932039e-01 }, + { -8.0901699e-01, -5.8778525e-01 }, { -8.3867057e-01, -5.4463904e-01 }, + { -8.6602540e-01, -5.0000000e-01 }, { -8.9100652e-01, -4.5399050e-01 }, + { -9.1354546e-01, -4.0673664e-01 }, { -9.3358043e-01, -3.5836795e-01 }, + { -9.5105652e-01, -3.0901699e-01 }, { -9.6592583e-01, -2.5881905e-01 }, + { -9.7814760e-01, -2.0791169e-01 }, { -9.8768834e-01, -1.5643447e-01 }, + { -9.9452190e-01, -1.0452846e-01 }, { -9.9862953e-01, -5.2335956e-02 }, + } +}; + +static const struct lc3_fft_bf2_twiddles fft_twiddles_160 = { + .n2 = 160/2, .t = (const struct lc3_complex []){ + { 1.0000000e+00, -0.0000000e+00 }, { 9.9922904e-01, -3.9259816e-02 }, + { 9.9691733e-01, -7.8459096e-02 }, { 9.9306846e-01, -1.1753740e-01 }, + { 9.8768834e-01, -1.5643447e-01 }, { 9.8078528e-01, -1.9509032e-01 }, + { 9.7236992e-01, -2.3344536e-01 }, { 9.6245524e-01, -2.7144045e-01 }, + { 9.5105652e-01, -3.0901699e-01 }, { 9.3819134e-01, -3.4611706e-01 }, + { 9.2387953e-01, -3.8268343e-01 }, { 9.0814317e-01, -4.1865974e-01 }, + { 8.9100652e-01, -4.5399050e-01 }, { 8.7249601e-01, -4.8862124e-01 }, + { 8.5264016e-01, -5.2249856e-01 }, { 8.3146961e-01, -5.5557023e-01 }, + { 8.0901699e-01, -5.8778525e-01 }, { 7.8531693e-01, -6.1909395e-01 }, + { 7.6040597e-01, -6.4944805e-01 }, { 7.3432251e-01, -6.7880075e-01 }, + { 7.0710678e-01, -7.0710678e-01 }, { 6.7880075e-01, -7.3432251e-01 }, + { 6.4944805e-01, -7.6040597e-01 }, { 6.1909395e-01, -7.8531693e-01 }, + { 5.8778525e-01, -8.0901699e-01 }, { 5.5557023e-01, -8.3146961e-01 }, + { 5.2249856e-01, -8.5264016e-01 }, { 4.8862124e-01, -8.7249601e-01 }, + { 4.5399050e-01, -8.9100652e-01 }, { 4.1865974e-01, -9.0814317e-01 }, + { 3.8268343e-01, -9.2387953e-01 }, { 3.4611706e-01, -9.3819134e-01 }, + { 3.0901699e-01, -9.5105652e-01 }, { 2.7144045e-01, -9.6245524e-01 }, + { 2.3344536e-01, -9.7236992e-01 }, { 1.9509032e-01, -9.8078528e-01 }, + { 1.5643447e-01, -9.8768834e-01 }, { 1.1753740e-01, -9.9306846e-01 }, + { 7.8459096e-02, -9.9691733e-01 }, { 3.9259816e-02, -9.9922904e-01 }, + { 6.1232340e-17, -1.0000000e+00 }, { -3.9259816e-02, -9.9922904e-01 }, + { -7.8459096e-02, -9.9691733e-01 }, { -1.1753740e-01, -9.9306846e-01 }, + { -1.5643447e-01, -9.8768834e-01 }, { -1.9509032e-01, -9.8078528e-01 }, + { -2.3344536e-01, -9.7236992e-01 }, { -2.7144045e-01, -9.6245524e-01 }, + { -3.0901699e-01, -9.5105652e-01 }, { -3.4611706e-01, -9.3819134e-01 }, + { -3.8268343e-01, -9.2387953e-01 }, { -4.1865974e-01, -9.0814317e-01 }, + { -4.5399050e-01, -8.9100652e-01 }, { -4.8862124e-01, -8.7249601e-01 }, + { -5.2249856e-01, -8.5264016e-01 }, { -5.5557023e-01, -8.3146961e-01 }, + { -5.8778525e-01, -8.0901699e-01 }, { -6.1909395e-01, -7.8531693e-01 }, + { -6.4944805e-01, -7.6040597e-01 }, { -6.7880075e-01, -7.3432251e-01 }, + { -7.0710678e-01, -7.0710678e-01 }, { -7.3432251e-01, -6.7880075e-01 }, + { -7.6040597e-01, -6.4944805e-01 }, { -7.8531693e-01, -6.1909395e-01 }, + { -8.0901699e-01, -5.8778525e-01 }, { -8.3146961e-01, -5.5557023e-01 }, + { -8.5264016e-01, -5.2249856e-01 }, { -8.7249601e-01, -4.8862124e-01 }, + { -8.9100652e-01, -4.5399050e-01 }, { -9.0814317e-01, -4.1865974e-01 }, + { -9.2387953e-01, -3.8268343e-01 }, { -9.3819134e-01, -3.4611706e-01 }, + { -9.5105652e-01, -3.0901699e-01 }, { -9.6245524e-01, -2.7144045e-01 }, + { -9.7236992e-01, -2.3344536e-01 }, { -9.8078528e-01, -1.9509032e-01 }, + { -9.8768834e-01, -1.5643447e-01 }, { -9.9306846e-01, -1.1753740e-01 }, + { -9.9691733e-01, -7.8459096e-02 }, { -9.9922904e-01, -3.9259816e-02 }, + } +}; + +static const struct lc3_fft_bf2_twiddles fft_twiddles_180 = { + .n2 = 180/2, .t = (const struct lc3_complex []){ + { 1.0000000e+00, -0.0000000e+00 }, { 9.9939083e-01, -3.4899497e-02 }, + { 9.9756405e-01, -6.9756474e-02 }, { 9.9452190e-01, -1.0452846e-01 }, + { 9.9026807e-01, -1.3917310e-01 }, { 9.8480775e-01, -1.7364818e-01 }, + { 9.7814760e-01, -2.0791169e-01 }, { 9.7029573e-01, -2.4192190e-01 }, + { 9.6126170e-01, -2.7563736e-01 }, { 9.5105652e-01, -3.0901699e-01 }, + { 9.3969262e-01, -3.4202014e-01 }, { 9.2718385e-01, -3.7460659e-01 }, + { 9.1354546e-01, -4.0673664e-01 }, { 8.9879405e-01, -4.3837115e-01 }, + { 8.8294759e-01, -4.6947156e-01 }, { 8.6602540e-01, -5.0000000e-01 }, + { 8.4804810e-01, -5.2991926e-01 }, { 8.2903757e-01, -5.5919290e-01 }, + { 8.0901699e-01, -5.8778525e-01 }, { 7.8801075e-01, -6.1566148e-01 }, + { 7.6604444e-01, -6.4278761e-01 }, { 7.4314483e-01, -6.6913061e-01 }, + { 7.1933980e-01, -6.9465837e-01 }, { 6.9465837e-01, -7.1933980e-01 }, + { 6.6913061e-01, -7.4314483e-01 }, { 6.4278761e-01, -7.6604444e-01 }, + { 6.1566148e-01, -7.8801075e-01 }, { 5.8778525e-01, -8.0901699e-01 }, + { 5.5919290e-01, -8.2903757e-01 }, { 5.2991926e-01, -8.4804810e-01 }, + { 5.0000000e-01, -8.6602540e-01 }, { 4.6947156e-01, -8.8294759e-01 }, + { 4.3837115e-01, -8.9879405e-01 }, { 4.0673664e-01, -9.1354546e-01 }, + { 3.7460659e-01, -9.2718385e-01 }, { 3.4202014e-01, -9.3969262e-01 }, + { 3.0901699e-01, -9.5105652e-01 }, { 2.7563736e-01, -9.6126170e-01 }, + { 2.4192190e-01, -9.7029573e-01 }, { 2.0791169e-01, -9.7814760e-01 }, + { 1.7364818e-01, -9.8480775e-01 }, { 1.3917310e-01, -9.9026807e-01 }, + { 1.0452846e-01, -9.9452190e-01 }, { 6.9756474e-02, -9.9756405e-01 }, + { 3.4899497e-02, -9.9939083e-01 }, { 6.1232340e-17, -1.0000000e+00 }, + { -3.4899497e-02, -9.9939083e-01 }, { -6.9756474e-02, -9.9756405e-01 }, + { -1.0452846e-01, -9.9452190e-01 }, { -1.3917310e-01, -9.9026807e-01 }, + { -1.7364818e-01, -9.8480775e-01 }, { -2.0791169e-01, -9.7814760e-01 }, + { -2.4192190e-01, -9.7029573e-01 }, { -2.7563736e-01, -9.6126170e-01 }, + { -3.0901699e-01, -9.5105652e-01 }, { -3.4202014e-01, -9.3969262e-01 }, + { -3.7460659e-01, -9.2718385e-01 }, { -4.0673664e-01, -9.1354546e-01 }, + { -4.3837115e-01, -8.9879405e-01 }, { -4.6947156e-01, -8.8294759e-01 }, + { -5.0000000e-01, -8.6602540e-01 }, { -5.2991926e-01, -8.4804810e-01 }, + { -5.5919290e-01, -8.2903757e-01 }, { -5.8778525e-01, -8.0901699e-01 }, + { -6.1566148e-01, -7.8801075e-01 }, { -6.4278761e-01, -7.6604444e-01 }, + { -6.6913061e-01, -7.4314483e-01 }, { -6.9465837e-01, -7.1933980e-01 }, + { -7.1933980e-01, -6.9465837e-01 }, { -7.4314483e-01, -6.6913061e-01 }, + { -7.6604444e-01, -6.4278761e-01 }, { -7.8801075e-01, -6.1566148e-01 }, + { -8.0901699e-01, -5.8778525e-01 }, { -8.2903757e-01, -5.5919290e-01 }, + { -8.4804810e-01, -5.2991926e-01 }, { -8.6602540e-01, -5.0000000e-01 }, + { -8.8294759e-01, -4.6947156e-01 }, { -8.9879405e-01, -4.3837115e-01 }, + { -9.1354546e-01, -4.0673664e-01 }, { -9.2718385e-01, -3.7460659e-01 }, + { -9.3969262e-01, -3.4202014e-01 }, { -9.5105652e-01, -3.0901699e-01 }, + { -9.6126170e-01, -2.7563736e-01 }, { -9.7029573e-01, -2.4192190e-01 }, + { -9.7814760e-01, -2.0791169e-01 }, { -9.8480775e-01, -1.7364818e-01 }, + { -9.9026807e-01, -1.3917310e-01 }, { -9.9452190e-01, -1.0452846e-01 }, + { -9.9756405e-01, -6.9756474e-02 }, { -9.9939083e-01, -3.4899497e-02 }, + } +}; + +static const struct lc3_fft_bf2_twiddles fft_twiddles_240 = { + .n2 = 240/2, .t = (const struct lc3_complex []){ + { 1.0000000e+00, -0.0000000e+00 }, { 9.9965732e-01, -2.6176948e-02 }, + { 9.9862953e-01, -5.2335956e-02 }, { 9.9691733e-01, -7.8459096e-02 }, + { 9.9452190e-01, -1.0452846e-01 }, { 9.9144486e-01, -1.3052619e-01 }, + { 9.8768834e-01, -1.5643447e-01 }, { 9.8325491e-01, -1.8223553e-01 }, + { 9.7814760e-01, -2.0791169e-01 }, { 9.7236992e-01, -2.3344536e-01 }, + { 9.6592583e-01, -2.5881905e-01 }, { 9.5881973e-01, -2.8401534e-01 }, + { 9.5105652e-01, -3.0901699e-01 }, { 9.4264149e-01, -3.3380686e-01 }, + { 9.3358043e-01, -3.5836795e-01 }, { 9.2387953e-01, -3.8268343e-01 }, + { 9.1354546e-01, -4.0673664e-01 }, { 9.0258528e-01, -4.3051110e-01 }, + { 8.9100652e-01, -4.5399050e-01 }, { 8.7881711e-01, -4.7715876e-01 }, + { 8.6602540e-01, -5.0000000e-01 }, { 8.5264016e-01, -5.2249856e-01 }, + { 8.3867057e-01, -5.4463904e-01 }, { 8.2412619e-01, -5.6640624e-01 }, + { 8.0901699e-01, -5.8778525e-01 }, { 7.9335334e-01, -6.0876143e-01 }, + { 7.7714596e-01, -6.2932039e-01 }, { 7.6040597e-01, -6.4944805e-01 }, + { 7.4314483e-01, -6.6913061e-01 }, { 7.2537437e-01, -6.8835458e-01 }, + { 7.0710678e-01, -7.0710678e-01 }, { 6.8835458e-01, -7.2537437e-01 }, + { 6.6913061e-01, -7.4314483e-01 }, { 6.4944805e-01, -7.6040597e-01 }, + { 6.2932039e-01, -7.7714596e-01 }, { 6.0876143e-01, -7.9335334e-01 }, + { 5.8778525e-01, -8.0901699e-01 }, { 5.6640624e-01, -8.2412619e-01 }, + { 5.4463904e-01, -8.3867057e-01 }, { 5.2249856e-01, -8.5264016e-01 }, + { 5.0000000e-01, -8.6602540e-01 }, { 4.7715876e-01, -8.7881711e-01 }, + { 4.5399050e-01, -8.9100652e-01 }, { 4.3051110e-01, -9.0258528e-01 }, + { 4.0673664e-01, -9.1354546e-01 }, { 3.8268343e-01, -9.2387953e-01 }, + { 3.5836795e-01, -9.3358043e-01 }, { 3.3380686e-01, -9.4264149e-01 }, + { 3.0901699e-01, -9.5105652e-01 }, { 2.8401534e-01, -9.5881973e-01 }, + { 2.5881905e-01, -9.6592583e-01 }, { 2.3344536e-01, -9.7236992e-01 }, + { 2.0791169e-01, -9.7814760e-01 }, { 1.8223553e-01, -9.8325491e-01 }, + { 1.5643447e-01, -9.8768834e-01 }, { 1.3052619e-01, -9.9144486e-01 }, + { 1.0452846e-01, -9.9452190e-01 }, { 7.8459096e-02, -9.9691733e-01 }, + { 5.2335956e-02, -9.9862953e-01 }, { 2.6176948e-02, -9.9965732e-01 }, + { 2.8327694e-16, -1.0000000e+00 }, { -2.6176948e-02, -9.9965732e-01 }, + { -5.2335956e-02, -9.9862953e-01 }, { -7.8459096e-02, -9.9691733e-01 }, + { -1.0452846e-01, -9.9452190e-01 }, { -1.3052619e-01, -9.9144486e-01 }, + { -1.5643447e-01, -9.8768834e-01 }, { -1.8223553e-01, -9.8325491e-01 }, + { -2.0791169e-01, -9.7814760e-01 }, { -2.3344536e-01, -9.7236992e-01 }, + { -2.5881905e-01, -9.6592583e-01 }, { -2.8401534e-01, -9.5881973e-01 }, + { -3.0901699e-01, -9.5105652e-01 }, { -3.3380686e-01, -9.4264149e-01 }, + { -3.5836795e-01, -9.3358043e-01 }, { -3.8268343e-01, -9.2387953e-01 }, + { -4.0673664e-01, -9.1354546e-01 }, { -4.3051110e-01, -9.0258528e-01 }, + { -4.5399050e-01, -8.9100652e-01 }, { -4.7715876e-01, -8.7881711e-01 }, + { -5.0000000e-01, -8.6602540e-01 }, { -5.2249856e-01, -8.5264016e-01 }, + { -5.4463904e-01, -8.3867057e-01 }, { -5.6640624e-01, -8.2412619e-01 }, + { -5.8778525e-01, -8.0901699e-01 }, { -6.0876143e-01, -7.9335334e-01 }, + { -6.2932039e-01, -7.7714596e-01 }, { -6.4944805e-01, -7.6040597e-01 }, + { -6.6913061e-01, -7.4314483e-01 }, { -6.8835458e-01, -7.2537437e-01 }, + { -7.0710678e-01, -7.0710678e-01 }, { -7.2537437e-01, -6.8835458e-01 }, + { -7.4314483e-01, -6.6913061e-01 }, { -7.6040597e-01, -6.4944805e-01 }, + { -7.7714596e-01, -6.2932039e-01 }, { -7.9335334e-01, -6.0876143e-01 }, + { -8.0901699e-01, -5.8778525e-01 }, { -8.2412619e-01, -5.6640624e-01 }, + { -8.3867057e-01, -5.4463904e-01 }, { -8.5264016e-01, -5.2249856e-01 }, + { -8.6602540e-01, -5.0000000e-01 }, { -8.7881711e-01, -4.7715876e-01 }, + { -8.9100652e-01, -4.5399050e-01 }, { -9.0258528e-01, -4.3051110e-01 }, + { -9.1354546e-01, -4.0673664e-01 }, { -9.2387953e-01, -3.8268343e-01 }, + { -9.3358043e-01, -3.5836795e-01 }, { -9.4264149e-01, -3.3380686e-01 }, + { -9.5105652e-01, -3.0901699e-01 }, { -9.5881973e-01, -2.8401534e-01 }, + { -9.6592583e-01, -2.5881905e-01 }, { -9.7236992e-01, -2.3344536e-01 }, + { -9.7814760e-01, -2.0791169e-01 }, { -9.8325491e-01, -1.8223553e-01 }, + { -9.8768834e-01, -1.5643447e-01 }, { -9.9144486e-01, -1.3052619e-01 }, + { -9.9452190e-01, -1.0452846e-01 }, { -9.9691733e-01, -7.8459096e-02 }, + { -9.9862953e-01, -5.2335956e-02 }, { -9.9965732e-01, -2.6176948e-02 }, + } +}; + +#if LC3_PLUS_HR + +static const struct lc3_fft_bf2_twiddles fft_twiddles_480 = { + .n2 = 480/2, .t = (const struct lc3_complex []){ + { 1.0000000e+00, -0.0000000e+00 }, { 9.9991433e-01, -1.3089596e-02 }, + { 9.9965732e-01, -2.6176948e-02 }, { 9.9922904e-01, -3.9259816e-02 }, + { 9.9862953e-01, -5.2335956e-02 }, { 9.9785892e-01, -6.5403129e-02 }, + { 9.9691733e-01, -7.8459096e-02 }, { 9.9580493e-01, -9.1501619e-02 }, + { 9.9452190e-01, -1.0452846e-01 }, { 9.9306846e-01, -1.1753740e-01 }, + { 9.9144486e-01, -1.3052619e-01 }, { 9.8965139e-01, -1.4349262e-01 }, + { 9.8768834e-01, -1.5643447e-01 }, { 9.8555606e-01, -1.6934950e-01 }, + { 9.8325491e-01, -1.8223553e-01 }, { 9.8078528e-01, -1.9509032e-01 }, + { 9.7814760e-01, -2.0791169e-01 }, { 9.7534232e-01, -2.2069744e-01 }, + { 9.7236992e-01, -2.3344536e-01 }, { 9.6923091e-01, -2.4615329e-01 }, + { 9.6592583e-01, -2.5881905e-01 }, { 9.6245524e-01, -2.7144045e-01 }, + { 9.5881973e-01, -2.8401534e-01 }, { 9.5501994e-01, -2.9654157e-01 }, + { 9.5105652e-01, -3.0901699e-01 }, { 9.4693013e-01, -3.2143947e-01 }, + { 9.4264149e-01, -3.3380686e-01 }, { 9.3819134e-01, -3.4611706e-01 }, + { 9.3358043e-01, -3.5836795e-01 }, { 9.2880955e-01, -3.7055744e-01 }, + { 9.2387953e-01, -3.8268343e-01 }, { 9.1879121e-01, -3.9474386e-01 }, + { 9.1354546e-01, -4.0673664e-01 }, { 9.0814317e-01, -4.1865974e-01 }, + { 9.0258528e-01, -4.3051110e-01 }, { 8.9687274e-01, -4.4228869e-01 }, + { 8.9100652e-01, -4.5399050e-01 }, { 8.8498764e-01, -4.6561452e-01 }, + { 8.7881711e-01, -4.7715876e-01 }, { 8.7249601e-01, -4.8862124e-01 }, + { 8.6602540e-01, -5.0000000e-01 }, { 8.5940641e-01, -5.1129309e-01 }, + { 8.5264016e-01, -5.2249856e-01 }, { 8.4572782e-01, -5.3361452e-01 }, + { 8.3867057e-01, -5.4463904e-01 }, { 8.3146961e-01, -5.5557023e-01 }, + { 8.2412619e-01, -5.6640624e-01 }, { 8.1664156e-01, -5.7714519e-01 }, + { 8.0901699e-01, -5.8778525e-01 }, { 8.0125381e-01, -5.9832460e-01 }, + { 7.9335334e-01, -6.0876143e-01 }, { 7.8531693e-01, -6.1909395e-01 }, + { 7.7714596e-01, -6.2932039e-01 }, { 7.6884183e-01, -6.3943900e-01 }, + { 7.6040597e-01, -6.4944805e-01 }, { 7.5183981e-01, -6.5934582e-01 }, + { 7.4314483e-01, -6.6913061e-01 }, { 7.3432251e-01, -6.7880075e-01 }, + { 7.2537437e-01, -6.8835458e-01 }, { 7.1630194e-01, -6.9779046e-01 }, + { 7.0710678e-01, -7.0710678e-01 }, { 6.9779046e-01, -7.1630194e-01 }, + { 6.8835458e-01, -7.2537437e-01 }, { 6.7880075e-01, -7.3432251e-01 }, + { 6.6913061e-01, -7.4314483e-01 }, { 6.5934582e-01, -7.5183981e-01 }, + { 6.4944805e-01, -7.6040597e-01 }, { 6.3943900e-01, -7.6884183e-01 }, + { 6.2932039e-01, -7.7714596e-01 }, { 6.1909395e-01, -7.8531693e-01 }, + { 6.0876143e-01, -7.9335334e-01 }, { 5.9832460e-01, -8.0125381e-01 }, + { 5.8778525e-01, -8.0901699e-01 }, { 5.7714519e-01, -8.1664156e-01 }, + { 5.6640624e-01, -8.2412619e-01 }, { 5.5557023e-01, -8.3146961e-01 }, + { 5.4463904e-01, -8.3867057e-01 }, { 5.3361452e-01, -8.4572782e-01 }, + { 5.2249856e-01, -8.5264016e-01 }, { 5.1129309e-01, -8.5940641e-01 }, + { 5.0000000e-01, -8.6602540e-01 }, { 4.8862124e-01, -8.7249601e-01 }, + { 4.7715876e-01, -8.7881711e-01 }, { 4.6561452e-01, -8.8498764e-01 }, + { 4.5399050e-01, -8.9100652e-01 }, { 4.4228869e-01, -8.9687274e-01 }, + { 4.3051110e-01, -9.0258528e-01 }, { 4.1865974e-01, -9.0814317e-01 }, + { 4.0673664e-01, -9.1354546e-01 }, { 3.9474386e-01, -9.1879121e-01 }, + { 3.8268343e-01, -9.2387953e-01 }, { 3.7055744e-01, -9.2880955e-01 }, + { 3.5836795e-01, -9.3358043e-01 }, { 3.4611706e-01, -9.3819134e-01 }, + { 3.3380686e-01, -9.4264149e-01 }, { 3.2143947e-01, -9.4693013e-01 }, + { 3.0901699e-01, -9.5105652e-01 }, { 2.9654157e-01, -9.5501994e-01 }, + { 2.8401534e-01, -9.5881973e-01 }, { 2.7144045e-01, -9.6245524e-01 }, + { 2.5881905e-01, -9.6592583e-01 }, { 2.4615329e-01, -9.6923091e-01 }, + { 2.3344536e-01, -9.7236992e-01 }, { 2.2069744e-01, -9.7534232e-01 }, + { 2.0791169e-01, -9.7814760e-01 }, { 1.9509032e-01, -9.8078528e-01 }, + { 1.8223553e-01, -9.8325491e-01 }, { 1.6934950e-01, -9.8555606e-01 }, + { 1.5643447e-01, -9.8768834e-01 }, { 1.4349262e-01, -9.8965139e-01 }, + { 1.3052619e-01, -9.9144486e-01 }, { 1.1753740e-01, -9.9306846e-01 }, + { 1.0452846e-01, -9.9452190e-01 }, { 9.1501619e-02, -9.9580493e-01 }, + { 7.8459096e-02, -9.9691733e-01 }, { 6.5403129e-02, -9.9785892e-01 }, + { 5.2335956e-02, -9.9862953e-01 }, { 3.9259816e-02, -9.9922904e-01 }, + { 2.6176948e-02, -9.9965732e-01 }, { 1.3089596e-02, -9.9991433e-01 }, + { 2.8327694e-16, -1.0000000e+00 }, { -1.3089596e-02, -9.9991433e-01 }, + { -2.6176948e-02, -9.9965732e-01 }, { -3.9259816e-02, -9.9922904e-01 }, + { -5.2335956e-02, -9.9862953e-01 }, { -6.5403129e-02, -9.9785892e-01 }, + { -7.8459096e-02, -9.9691733e-01 }, { -9.1501619e-02, -9.9580493e-01 }, + { -1.0452846e-01, -9.9452190e-01 }, { -1.1753740e-01, -9.9306846e-01 }, + { -1.3052619e-01, -9.9144486e-01 }, { -1.4349262e-01, -9.8965139e-01 }, + { -1.5643447e-01, -9.8768834e-01 }, { -1.6934950e-01, -9.8555606e-01 }, + { -1.8223553e-01, -9.8325491e-01 }, { -1.9509032e-01, -9.8078528e-01 }, + { -2.0791169e-01, -9.7814760e-01 }, { -2.2069744e-01, -9.7534232e-01 }, + { -2.3344536e-01, -9.7236992e-01 }, { -2.4615329e-01, -9.6923091e-01 }, + { -2.5881905e-01, -9.6592583e-01 }, { -2.7144045e-01, -9.6245524e-01 }, + { -2.8401534e-01, -9.5881973e-01 }, { -2.9654157e-01, -9.5501994e-01 }, + { -3.0901699e-01, -9.5105652e-01 }, { -3.2143947e-01, -9.4693013e-01 }, + { -3.3380686e-01, -9.4264149e-01 }, { -3.4611706e-01, -9.3819134e-01 }, + { -3.5836795e-01, -9.3358043e-01 }, { -3.7055744e-01, -9.2880955e-01 }, + { -3.8268343e-01, -9.2387953e-01 }, { -3.9474386e-01, -9.1879121e-01 }, + { -4.0673664e-01, -9.1354546e-01 }, { -4.1865974e-01, -9.0814317e-01 }, + { -4.3051110e-01, -9.0258528e-01 }, { -4.4228869e-01, -8.9687274e-01 }, + { -4.5399050e-01, -8.9100652e-01 }, { -4.6561452e-01, -8.8498764e-01 }, + { -4.7715876e-01, -8.7881711e-01 }, { -4.8862124e-01, -8.7249601e-01 }, + { -5.0000000e-01, -8.6602540e-01 }, { -5.1129309e-01, -8.5940641e-01 }, + { -5.2249856e-01, -8.5264016e-01 }, { -5.3361452e-01, -8.4572782e-01 }, + { -5.4463904e-01, -8.3867057e-01 }, { -5.5557023e-01, -8.3146961e-01 }, + { -5.6640624e-01, -8.2412619e-01 }, { -5.7714519e-01, -8.1664156e-01 }, + { -5.8778525e-01, -8.0901699e-01 }, { -5.9832460e-01, -8.0125381e-01 }, + { -6.0876143e-01, -7.9335334e-01 }, { -6.1909395e-01, -7.8531693e-01 }, + { -6.2932039e-01, -7.7714596e-01 }, { -6.3943900e-01, -7.6884183e-01 }, + { -6.4944805e-01, -7.6040597e-01 }, { -6.5934582e-01, -7.5183981e-01 }, + { -6.6913061e-01, -7.4314483e-01 }, { -6.7880075e-01, -7.3432251e-01 }, + { -6.8835458e-01, -7.2537437e-01 }, { -6.9779046e-01, -7.1630194e-01 }, + { -7.0710678e-01, -7.0710678e-01 }, { -7.1630194e-01, -6.9779046e-01 }, + { -7.2537437e-01, -6.8835458e-01 }, { -7.3432251e-01, -6.7880075e-01 }, + { -7.4314483e-01, -6.6913061e-01 }, { -7.5183981e-01, -6.5934582e-01 }, + { -7.6040597e-01, -6.4944805e-01 }, { -7.6884183e-01, -6.3943900e-01 }, + { -7.7714596e-01, -6.2932039e-01 }, { -7.8531693e-01, -6.1909395e-01 }, + { -7.9335334e-01, -6.0876143e-01 }, { -8.0125381e-01, -5.9832460e-01 }, + { -8.0901699e-01, -5.8778525e-01 }, { -8.1664156e-01, -5.7714519e-01 }, + { -8.2412619e-01, -5.6640624e-01 }, { -8.3146961e-01, -5.5557023e-01 }, + { -8.3867057e-01, -5.4463904e-01 }, { -8.4572782e-01, -5.3361452e-01 }, + { -8.5264016e-01, -5.2249856e-01 }, { -8.5940641e-01, -5.1129309e-01 }, + { -8.6602540e-01, -5.0000000e-01 }, { -8.7249601e-01, -4.8862124e-01 }, + { -8.7881711e-01, -4.7715876e-01 }, { -8.8498764e-01, -4.6561452e-01 }, + { -8.9100652e-01, -4.5399050e-01 }, { -8.9687274e-01, -4.4228869e-01 }, + { -9.0258528e-01, -4.3051110e-01 }, { -9.0814317e-01, -4.1865974e-01 }, + { -9.1354546e-01, -4.0673664e-01 }, { -9.1879121e-01, -3.9474386e-01 }, + { -9.2387953e-01, -3.8268343e-01 }, { -9.2880955e-01, -3.7055744e-01 }, + { -9.3358043e-01, -3.5836795e-01 }, { -9.3819134e-01, -3.4611706e-01 }, + { -9.4264149e-01, -3.3380686e-01 }, { -9.4693013e-01, -3.2143947e-01 }, + { -9.5105652e-01, -3.0901699e-01 }, { -9.5501994e-01, -2.9654157e-01 }, + { -9.5881973e-01, -2.8401534e-01 }, { -9.6245524e-01, -2.7144045e-01 }, + { -9.6592583e-01, -2.5881905e-01 }, { -9.6923091e-01, -2.4615329e-01 }, + { -9.7236992e-01, -2.3344536e-01 }, { -9.7534232e-01, -2.2069744e-01 }, + { -9.7814760e-01, -2.0791169e-01 }, { -9.8078528e-01, -1.9509032e-01 }, + { -9.8325491e-01, -1.8223553e-01 }, { -9.8555606e-01, -1.6934950e-01 }, + { -9.8768834e-01, -1.5643447e-01 }, { -9.8965139e-01, -1.4349262e-01 }, + { -9.9144486e-01, -1.3052619e-01 }, { -9.9306846e-01, -1.1753740e-01 }, + { -9.9452190e-01, -1.0452846e-01 }, { -9.9580493e-01, -9.1501619e-02 }, + { -9.9691733e-01, -7.8459096e-02 }, { -9.9785892e-01, -6.5403129e-02 }, + { -9.9862953e-01, -5.2335956e-02 }, { -9.9922904e-01, -3.9259816e-02 }, + { -9.9965732e-01, -2.6176948e-02 }, { -9.9991433e-01, -1.3089596e-02 }, + } +}; + +#endif /* LC3_PLUS_HR */ + +const struct lc3_fft_bf2_twiddles *lc3_fft_twiddles_bf2[][3] = { + { &fft_twiddles_10 , &fft_twiddles_30 , &fft_twiddles_90 }, + { &fft_twiddles_20 , &fft_twiddles_60 , &fft_twiddles_180 }, + { &fft_twiddles_40 , &fft_twiddles_120 }, + { &fft_twiddles_80 , &fft_twiddles_240 }, + { &fft_twiddles_160, LC3_IF_PLUS_HR(&fft_twiddles_480, NULL) } +}; + + +/** + * MDCT Rotation twiddles + * + * 2Pi (n + 1/8) / N + * W[n] = e * sqrt( sqrt( 4/N ) ), n = [0..N/4-1] + */ + +#if LC3_PLUS + +static const struct lc3_mdct_rot_def mdct_rot_40 = { + .n4 = 40/4, .w = (const struct lc3_complex []){ + { 5.6223293e-01, 1.1040837e-02 }, { 5.5358374e-01, 9.8857513e-02 }, + { 5.3130348e-01, 1.8423999e-01 }, { 4.9594077e-01, 2.6508587e-01 }, + { 4.4836635e-01, 3.3940445e-01 }, { 3.8975167e-01, 4.0536577e-01 }, + { 3.2154000e-01, 4.6134563e-01 }, { 2.4541095e-01, 5.0596564e-01 }, + { 1.6323907e-01, 5.3812710e-01 }, { 7.7047702e-02, 5.5703808e-01 }, + } +}; + +static const struct lc3_mdct_rot_def mdct_rot_80 = { + .n4 = 80/4, .w = (const struct lc3_complex []){ + { 4.7284802e-01, 4.6423237e-03 }, { 4.7102615e-01, 4.1727241e-02 }, + { 4.6630025e-01, 7.8554895e-02 }, { 4.5869946e-01, 1.1489823e-01 }, + { 4.4827063e-01, 1.5053319e-01 }, { 4.3507806e-01, 1.8524005e-01 }, + { 4.1920310e-01, 2.1880485e-01 }, { 4.0074360e-01, 2.5102064e-01 }, + { 3.7981339e-01, 2.8168881e-01 }, { 3.5654150e-01, 3.1062027e-01 }, + { 3.3107142e-01, 3.3763666e-01 }, { 3.0356017e-01, 3.6257140e-01 }, + { 2.7417737e-01, 3.8527077e-01 }, { 2.4310418e-01, 4.0559482e-01 }, + { 2.1053217e-01, 4.2341824e-01 }, { 1.7666215e-01, 4.3863114e-01 }, + { 1.4170296e-01, 4.5113974e-01 }, { 1.0587012e-01, 4.6086692e-01 }, + { 6.9384558e-02, 4.6775269e-01 }, { 3.2471215e-02, 4.7175462e-01 }, + } +}; + +#endif /* LC3_PLUS */ + +static const struct lc3_mdct_rot_def mdct_rot_120 = { + .n4 = 120/4, .w = (const struct lc3_complex []){ + { 4.2727785e-01, 2.7965670e-03 }, { 4.2654592e-01, 2.5154729e-02 }, + { 4.2464486e-01, 4.7443945e-02 }, { 4.2157988e-01, 6.9603119e-02 }, + { 4.1735937e-01, 9.1571516e-02 }, { 4.1199491e-01, 1.1328892e-01 }, + { 4.0550120e-01, 1.3469581e-01 }, { 3.9789604e-01, 1.5573351e-01 }, + { 3.8920028e-01, 1.7634435e-01 }, { 3.7943774e-01, 1.9647185e-01 }, + { 3.6863519e-01, 2.1606083e-01 }, { 3.5682224e-01, 2.3505760e-01 }, + { 3.4403126e-01, 2.5341009e-01 }, { 3.3029732e-01, 2.7106801e-01 }, + { 3.1565806e-01, 2.8798294e-01 }, { 3.0015360e-01, 3.0410854e-01 }, + { 2.8382644e-01, 3.1940060e-01 }, { 2.6672133e-01, 3.3381720e-01 }, + { 2.4888515e-01, 3.4731883e-01 }, { 2.3036680e-01, 3.5986848e-01 }, + { 2.1121703e-01, 3.7143176e-01 }, { 1.9148833e-01, 3.8197697e-01 }, + { 1.7123477e-01, 3.9147521e-01 }, { 1.5051187e-01, 3.9990044e-01 }, + { 1.2937643e-01, 4.0722957e-01 }, { 1.0788637e-01, 4.1344252e-01 }, + { 8.6100606e-02, 4.1852225e-01 }, { 6.4078846e-02, 4.2245483e-01 }, + { 4.1881450e-02, 4.2522950e-01 }, { 1.9569261e-02, 4.2683865e-01 }, + } +}; + +static const struct lc3_mdct_rot_def mdct_rot_160 = { + .n4 = 160/4, .w = (const struct lc3_complex []){ + { 3.9763057e-01, 1.9518802e-03 }, { 3.9724738e-01, 1.7561278e-02 }, + { 3.9625167e-01, 3.3143598e-02 }, { 3.9464496e-01, 4.8674813e-02 }, + { 3.9242974e-01, 6.4130975e-02 }, { 3.8960942e-01, 7.9488252e-02 }, + { 3.8618835e-01, 9.4722964e-02 }, { 3.8217181e-01, 1.0981162e-01 }, + { 3.7756598e-01, 1.2473095e-01 }, { 3.7237798e-01, 1.3945796e-01 }, + { 3.6661580e-01, 1.5396993e-01 }, { 3.6028832e-01, 1.6824450e-01 }, + { 3.5340530e-01, 1.8225964e-01 }, { 3.4597736e-01, 1.9599375e-01 }, + { 3.3801594e-01, 2.0942566e-01 }, { 3.2953333e-01, 2.2253464e-01 }, + { 3.2054261e-01, 2.3530049e-01 }, { 3.1105762e-01, 2.4770353e-01 }, + { 3.0109302e-01, 2.5972462e-01 }, { 2.9066414e-01, 2.7134524e-01 }, + { 2.7978709e-01, 2.8254746e-01 }, { 2.6847862e-01, 2.9331402e-01 }, + { 2.5675618e-01, 3.0362831e-01 }, { 2.4463784e-01, 3.1347442e-01 }, + { 2.3214228e-01, 3.2283718e-01 }, { 2.1928878e-01, 3.3170215e-01 }, + { 2.0609715e-01, 3.4005565e-01 }, { 1.9258774e-01, 3.4788482e-01 }, + { 1.7878136e-01, 3.5517757e-01 }, { 1.6469932e-01, 3.6192266e-01 }, + { 1.5036333e-01, 3.6810970e-01 }, { 1.3579549e-01, 3.7372914e-01 }, + { 1.2101826e-01, 3.7877231e-01 }, { 1.0605442e-01, 3.8323145e-01 }, + { 9.0927064e-02, 3.8709967e-01 }, { 7.5659501e-02, 3.9037101e-01 }, + { 6.0275277e-02, 3.9304042e-01 }, { 4.4798112e-02, 3.9510380e-01 }, + { 2.9251872e-02, 3.9655795e-01 }, { 1.3660528e-02, 3.9740065e-01 }, + } +}; + +static const struct lc3_mdct_rot_def mdct_rot_240 = { + .n4 = 240/4, .w = (const struct lc3_complex []){ + { 3.5930219e-01, 1.1758179e-03 }, { 3.5914828e-01, 1.0580850e-02 }, + { 3.5874824e-01, 1.9978630e-02 }, { 3.5810233e-01, 2.9362718e-02 }, + { 3.5721099e-01, 3.8726682e-02 }, { 3.5607483e-01, 4.8064105e-02 }, + { 3.5469464e-01, 5.7368587e-02 }, { 3.5307136e-01, 6.6633752e-02 }, + { 3.5120611e-01, 7.5853249e-02 }, { 3.4910015e-01, 8.5020760e-02 }, + { 3.4675494e-01, 9.4130002e-02 }, { 3.4417208e-01, 1.0317473e-01 }, + { 3.4135334e-01, 1.1214875e-01 }, { 3.3830065e-01, 1.2104591e-01 }, + { 3.3501611e-01, 1.2986011e-01 }, { 3.3150197e-01, 1.3858531e-01 }, + { 3.2776063e-01, 1.4721553e-01 }, { 3.2379466e-01, 1.5574485e-01 }, + { 3.1960678e-01, 1.6416744e-01 }, { 3.1519986e-01, 1.7247752e-01 }, + { 3.1057691e-01, 1.8066938e-01 }, { 3.0574111e-01, 1.8873743e-01 }, + { 3.0069577e-01, 1.9667612e-01 }, { 2.9544435e-01, 2.0448002e-01 }, + { 2.8999045e-01, 2.1214378e-01 }, { 2.8433780e-01, 2.1966215e-01 }, + { 2.7849028e-01, 2.2702998e-01 }, { 2.7245189e-01, 2.3424220e-01 }, + { 2.6622679e-01, 2.4129389e-01 }, { 2.5981922e-01, 2.4818021e-01 }, + { 2.5323358e-01, 2.5489644e-01 }, { 2.4647440e-01, 2.6143798e-01 }, + { 2.3954629e-01, 2.6780034e-01 }, { 2.3245401e-01, 2.7397916e-01 }, + { 2.2520241e-01, 2.7997021e-01 }, { 2.1779647e-01, 2.8576938e-01 }, + { 2.1024127e-01, 2.9137270e-01 }, { 2.0254198e-01, 2.9677633e-01 }, + { 1.9470387e-01, 3.0197657e-01 }, { 1.8673233e-01, 3.0696984e-01 }, + { 1.7863281e-01, 3.1175273e-01 }, { 1.7041086e-01, 3.1632196e-01 }, + { 1.6207212e-01, 3.2067440e-01 }, { 1.5362230e-01, 3.2480707e-01 }, + { 1.4506720e-01, 3.2871713e-01 }, { 1.3641268e-01, 3.3240190e-01 }, + { 1.2766467e-01, 3.3585887e-01 }, { 1.1882916e-01, 3.3908565e-01 }, + { 1.0991221e-01, 3.4208003e-01 }, { 1.0091994e-01, 3.4483998e-01 }, + { 9.1858496e-02, 3.4736359e-01 }, { 8.2734100e-02, 3.4964913e-01 }, + { 7.3553002e-02, 3.5169504e-01 }, { 6.4321494e-02, 3.5349992e-01 }, + { 5.5045904e-02, 3.5506252e-01 }, { 4.5732588e-02, 3.5638178e-01 }, + { 3.6387929e-02, 3.5745680e-01 }, { 2.7018332e-02, 3.5828683e-01 }, + { 1.7630217e-02, 3.5887131e-01 }, { 8.2300199e-03, 3.5920984e-01 }, + } +}; + +static const struct lc3_mdct_rot_def mdct_rot_320 = { + .n4 = 320/4, .w = (const struct lc3_complex []){ + { 3.3436915e-01, 8.2066700e-04 }, { 3.3428858e-01, 7.3854098e-03 }, + { 3.3407914e-01, 1.3947305e-02 }, { 3.3374091e-01, 2.0503824e-02 }, + { 3.3327401e-01, 2.7052438e-02 }, { 3.3267863e-01, 3.3590623e-02 }, + { 3.3195499e-01, 4.0115858e-02 }, { 3.3110338e-01, 4.6625627e-02 }, + { 3.3012413e-01, 5.3117422e-02 }, { 3.2901760e-01, 5.9588738e-02 }, + { 3.2778423e-01, 6.6037082e-02 }, { 3.2642450e-01, 7.2459968e-02 }, + { 3.2493892e-01, 7.8854919e-02 }, { 3.2332807e-01, 8.5219469e-02 }, + { 3.2159257e-01, 9.1551166e-02 }, { 3.1973310e-01, 9.7847569e-02 }, + { 3.1775035e-01, 1.0410625e-01 }, { 3.1564512e-01, 1.1032479e-01 }, + { 3.1341819e-01, 1.1650081e-01 }, { 3.1107043e-01, 1.2263191e-01 }, + { 3.0860275e-01, 1.2871573e-01 }, { 3.0601610e-01, 1.3474993e-01 }, + { 3.0331148e-01, 1.4073218e-01 }, { 3.0048992e-01, 1.4666018e-01 }, + { 2.9755251e-01, 1.5253164e-01 }, { 2.9450040e-01, 1.5834429e-01 }, + { 2.9133475e-01, 1.6409590e-01 }, { 2.8805678e-01, 1.6978424e-01 }, + { 2.8466777e-01, 1.7540713e-01 }, { 2.8116900e-01, 1.8096240e-01 }, + { 2.7756185e-01, 1.8644790e-01 }, { 2.7384768e-01, 1.9186153e-01 }, + { 2.7002795e-01, 1.9720119e-01 }, { 2.6610411e-01, 2.0246482e-01 }, + { 2.6207768e-01, 2.0765040e-01 }, { 2.5795022e-01, 2.1275592e-01 }, + { 2.5372331e-01, 2.1777943e-01 }, { 2.4939859e-01, 2.2271898e-01 }, + { 2.4497772e-01, 2.2757266e-01 }, { 2.4046241e-01, 2.3233861e-01 }, + { 2.3585439e-01, 2.3701499e-01 }, { 2.3115545e-01, 2.4159999e-01 }, + { 2.2636739e-01, 2.4609186e-01 }, { 2.2149206e-01, 2.5048885e-01 }, + { 2.1653135e-01, 2.5478927e-01 }, { 2.1148716e-01, 2.5899147e-01 }, + { 2.0636143e-01, 2.6309382e-01 }, { 2.0115615e-01, 2.6709474e-01 }, + { 1.9587332e-01, 2.7099270e-01 }, { 1.9051498e-01, 2.7478618e-01 }, + { 1.8508318e-01, 2.7847372e-01 }, { 1.7958004e-01, 2.8205391e-01 }, + { 1.7400766e-01, 2.8552536e-01 }, { 1.6836821e-01, 2.8888674e-01 }, + { 1.6266384e-01, 2.9213674e-01 }, { 1.5689676e-01, 2.9527412e-01 }, + { 1.5106920e-01, 2.9829767e-01 }, { 1.4518339e-01, 3.0120621e-01 }, + { 1.3924162e-01, 3.0399864e-01 }, { 1.3324616e-01, 3.0667387e-01 }, + { 1.2719933e-01, 3.0923087e-01 }, { 1.2110347e-01, 3.1166865e-01 }, + { 1.1496092e-01, 3.1398628e-01 }, { 1.0877405e-01, 3.1618287e-01 }, + { 1.0254525e-01, 3.1825755e-01 }, { 9.6276910e-02, 3.2020955e-01 }, + { 8.9971456e-02, 3.2203810e-01 }, { 8.3631316e-02, 3.2374249e-01 }, + { 7.7258935e-02, 3.2532208e-01 }, { 7.0856769e-02, 3.2677625e-01 }, + { 6.4427286e-02, 3.2810444e-01 }, { 5.7972965e-02, 3.2930614e-01 }, + { 5.1496295e-02, 3.3038089e-01 }, { 4.4999772e-02, 3.3132827e-01 }, + { 3.8485901e-02, 3.3214791e-01 }, { 3.1957192e-02, 3.3283951e-01 }, + { 2.5416164e-02, 3.3340279e-01 }, { 1.8865337e-02, 3.3383753e-01 }, + { 1.2307237e-02, 3.3414358e-01 }, { 5.7443922e-03, 3.3432081e-01 }, + } +}; + +static const struct lc3_mdct_rot_def mdct_rot_360 = { + .n4 = 360/4, .w = (const struct lc3_complex []){ + { 3.2466714e-01, 7.0831495e-04 }, { 3.2460533e-01, 6.3744300e-03 }, + { 3.2444464e-01, 1.2038603e-02 }, { 3.2418513e-01, 1.7699110e-02 }, + { 3.2382686e-01, 2.3354225e-02 }, { 3.2336995e-01, 2.9002226e-02 }, + { 3.2281454e-01, 3.4641392e-02 }, { 3.2216080e-01, 4.0270007e-02 }, + { 3.2140893e-01, 4.5886355e-02 }, { 3.2055915e-01, 5.1488725e-02 }, + { 3.1961172e-01, 5.7075412e-02 }, { 3.1856694e-01, 6.2644713e-02 }, + { 3.1742512e-01, 6.8194931e-02 }, { 3.1618661e-01, 7.3724377e-02 }, + { 3.1485178e-01, 7.9231366e-02 }, { 3.1342105e-01, 8.4714220e-02 }, + { 3.1189485e-01, 9.0171269e-02 }, { 3.1027364e-01, 9.5600851e-02 }, + { 3.0855792e-01, 1.0100131e-01 }, { 3.0674821e-01, 1.0637101e-01 }, + { 3.0484506e-01, 1.1170830e-01 }, { 3.0284905e-01, 1.1701157e-01 }, + { 3.0076079e-01, 1.2227919e-01 }, { 2.9858092e-01, 1.2750957e-01 }, + { 2.9631010e-01, 1.3270110e-01 }, { 2.9394901e-01, 1.3785221e-01 }, + { 2.9149839e-01, 1.4296134e-01 }, { 2.8895897e-01, 1.4802691e-01 }, + { 2.8633154e-01, 1.5304740e-01 }, { 2.8361688e-01, 1.5802126e-01 }, + { 2.8081584e-01, 1.6294699e-01 }, { 2.7792925e-01, 1.6782308e-01 }, + { 2.7495800e-01, 1.7264806e-01 }, { 2.7190300e-01, 1.7742044e-01 }, + { 2.6876518e-01, 1.8213878e-01 }, { 2.6554548e-01, 1.8680164e-01 }, + { 2.6224490e-01, 1.9140760e-01 }, { 2.5886443e-01, 1.9595525e-01 }, + { 2.5540512e-01, 2.0044321e-01 }, { 2.5186800e-01, 2.0487012e-01 }, + { 2.4825416e-01, 2.0923462e-01 }, { 2.4456471e-01, 2.1353538e-01 }, + { 2.4080075e-01, 2.1777110e-01 }, { 2.3696345e-01, 2.2194049e-01 }, + { 2.3305396e-01, 2.2604227e-01 }, { 2.2907348e-01, 2.3007519e-01 }, + { 2.2502323e-01, 2.3403803e-01 }, { 2.2090443e-01, 2.3792959e-01 }, + { 2.1671834e-01, 2.4174866e-01 }, { 2.1246624e-01, 2.4549410e-01 }, + { 2.0814942e-01, 2.4916476e-01 }, { 2.0376919e-01, 2.5275952e-01 }, + { 1.9932689e-01, 2.5627728e-01 }, { 1.9482388e-01, 2.5971698e-01 }, + { 1.9026152e-01, 2.6307757e-01 }, { 1.8564121e-01, 2.6635803e-01 }, + { 1.8096434e-01, 2.6955734e-01 }, { 1.7623236e-01, 2.7267455e-01 }, + { 1.7144669e-01, 2.7570870e-01 }, { 1.6660880e-01, 2.7865887e-01 }, + { 1.6172015e-01, 2.8152415e-01 }, { 1.5678225e-01, 2.8430368e-01 }, + { 1.5179659e-01, 2.8699661e-01 }, { 1.4676469e-01, 2.8960211e-01 }, + { 1.4168808e-01, 2.9211940e-01 }, { 1.3656831e-01, 2.9454771e-01 }, + { 1.3140695e-01, 2.9688629e-01 }, { 1.2620555e-01, 2.9913444e-01 }, + { 1.2096571e-01, 3.0129147e-01 }, { 1.1568903e-01, 3.0335673e-01 }, + { 1.1037710e-01, 3.0532958e-01 }, { 1.0503156e-01, 3.0720942e-01 }, + { 9.9654017e-02, 3.0899568e-01 }, { 9.4246121e-02, 3.1068782e-01 }, + { 8.8809517e-02, 3.1228533e-01 }, { 8.3345860e-02, 3.1378770e-01 }, + { 7.7856816e-02, 3.1519450e-01 }, { 7.2344055e-02, 3.1650528e-01 }, + { 6.6809258e-02, 3.1771965e-01 }, { 6.1254110e-02, 3.1883725e-01 }, + { 5.5680304e-02, 3.1985772e-01 }, { 5.0089536e-02, 3.2078076e-01 }, + { 4.4483511e-02, 3.2160608e-01 }, { 3.8863936e-02, 3.2233345e-01 }, + { 3.3232523e-02, 3.2296262e-01 }, { 2.7590986e-02, 3.2349342e-01 }, + { 2.1941045e-02, 3.2392568e-01 }, { 1.6284421e-02, 3.2425927e-01 }, + { 1.0622836e-02, 3.2449408e-01 }, { 4.9580159e-03, 3.2463006e-01 }, + } +}; + +static const struct lc3_mdct_rot_def mdct_rot_480 = { + .n4 = 480/4, .w = (const struct lc3_complex []){ + { 3.0213714e-01, 4.9437117e-04 }, { 3.0210478e-01, 4.4491817e-03 }, + { 3.0202066e-01, 8.4032299e-03 }, { 3.0188479e-01, 1.2355838e-02 }, + { 3.0169719e-01, 1.6306330e-02 }, { 3.0145790e-01, 2.0254027e-02 }, + { 3.0116696e-01, 2.4198254e-02 }, { 3.0082441e-01, 2.8138334e-02 }, + { 3.0043032e-01, 3.2073593e-02 }, { 2.9998475e-01, 3.6003357e-02 }, + { 2.9948778e-01, 3.9926952e-02 }, { 2.9893950e-01, 4.3843705e-02 }, + { 2.9833999e-01, 4.7752946e-02 }, { 2.9768936e-01, 5.1654004e-02 }, + { 2.9698773e-01, 5.5546213e-02 }, { 2.9623521e-01, 5.9428903e-02 }, + { 2.9543193e-01, 6.3301411e-02 }, { 2.9457803e-01, 6.7163072e-02 }, + { 2.9367365e-01, 7.1013225e-02 }, { 2.9271896e-01, 7.4851211e-02 }, + { 2.9171411e-01, 7.8676371e-02 }, { 2.9065928e-01, 8.2488050e-02 }, + { 2.8955464e-01, 8.6285595e-02 }, { 2.8840039e-01, 9.0068356e-02 }, + { 2.8719672e-01, 9.3835684e-02 }, { 2.8594385e-01, 9.7586934e-02 }, + { 2.8464198e-01, 1.0132146e-01 }, { 2.8329133e-01, 1.0503863e-01 }, + { 2.8189215e-01, 1.0873780e-01 }, { 2.8044466e-01, 1.1241834e-01 }, + { 2.7894913e-01, 1.1607962e-01 }, { 2.7740579e-01, 1.1972100e-01 }, + { 2.7581493e-01, 1.2334187e-01 }, { 2.7417680e-01, 1.2694161e-01 }, + { 2.7249170e-01, 1.3051960e-01 }, { 2.7075991e-01, 1.3407523e-01 }, + { 2.6898172e-01, 1.3760788e-01 }, { 2.6715744e-01, 1.4111695e-01 }, + { 2.6528739e-01, 1.4460184e-01 }, { 2.6337188e-01, 1.4806196e-01 }, + { 2.6141125e-01, 1.5149671e-01 }, { 2.5940582e-01, 1.5490549e-01 }, + { 2.5735595e-01, 1.5828774e-01 }, { 2.5526198e-01, 1.6164286e-01 }, + { 2.5312427e-01, 1.6497029e-01 }, { 2.5094319e-01, 1.6826945e-01 }, + { 2.4871911e-01, 1.7153978e-01 }, { 2.4645242e-01, 1.7478072e-01 }, + { 2.4414349e-01, 1.7799171e-01 }, { 2.4179274e-01, 1.8117220e-01 }, + { 2.3940055e-01, 1.8432165e-01 }, { 2.3696735e-01, 1.8743951e-01 }, + { 2.3449354e-01, 1.9052526e-01 }, { 2.3197955e-01, 1.9357836e-01 }, + { 2.2942581e-01, 1.9659830e-01 }, { 2.2683276e-01, 1.9958454e-01 }, + { 2.2420085e-01, 2.0253659e-01 }, { 2.2153052e-01, 2.0545394e-01 }, + { 2.1882223e-01, 2.0833608e-01 }, { 2.1607645e-01, 2.1118253e-01 }, + { 2.1329364e-01, 2.1399279e-01 }, { 2.1047429e-01, 2.1676638e-01 }, + { 2.0761888e-01, 2.1950284e-01 }, { 2.0472788e-01, 2.2220168e-01 }, + { 2.0180182e-01, 2.2486245e-01 }, { 1.9884117e-01, 2.2748469e-01 }, + { 1.9584645e-01, 2.3006795e-01 }, { 1.9281818e-01, 2.3261179e-01 }, + { 1.8975686e-01, 2.3511577e-01 }, { 1.8666303e-01, 2.3757947e-01 }, + { 1.8353722e-01, 2.4000246e-01 }, { 1.8037996e-01, 2.4238433e-01 }, + { 1.7719180e-01, 2.4472466e-01 }, { 1.7397327e-01, 2.4702306e-01 }, + { 1.7072493e-01, 2.4927914e-01 }, { 1.6744734e-01, 2.5149250e-01 }, + { 1.6414106e-01, 2.5366278e-01 }, { 1.6080666e-01, 2.5578958e-01 }, + { 1.5744470e-01, 2.5787256e-01 }, { 1.5405576e-01, 2.5991136e-01 }, + { 1.5064043e-01, 2.6190562e-01 }, { 1.4719929e-01, 2.6385500e-01 }, + { 1.4373292e-01, 2.6575918e-01 }, { 1.4024192e-01, 2.6761782e-01 }, + { 1.3672690e-01, 2.6943060e-01 }, { 1.3318845e-01, 2.7119722e-01 }, + { 1.2962718e-01, 2.7291736e-01 }, { 1.2604369e-01, 2.7459075e-01 }, + { 1.2243861e-01, 2.7621709e-01 }, { 1.1881255e-01, 2.7779609e-01 }, + { 1.1516614e-01, 2.7932750e-01 }, { 1.1149999e-01, 2.8081105e-01 }, + { 1.0781473e-01, 2.8224648e-01 }, { 1.0411100e-01, 2.8363355e-01 }, + { 1.0038943e-01, 2.8497202e-01 }, { 9.6650664e-02, 2.8626167e-01 }, + { 9.2895335e-02, 2.8750226e-01 }, { 8.9124088e-02, 2.8869359e-01 }, + { 8.5337570e-02, 2.8983546e-01 }, { 8.1536430e-02, 2.9092766e-01 }, + { 7.7721319e-02, 2.9197001e-01 }, { 7.3892891e-02, 2.9296234e-01 }, + { 7.0051802e-02, 2.9390447e-01 }, { 6.6198710e-02, 2.9479624e-01 }, + { 6.2334275e-02, 2.9563750e-01 }, { 5.8459159e-02, 2.9642810e-01 }, + { 5.4574027e-02, 2.9716791e-01 }, { 5.0679543e-02, 2.9785681e-01 }, + { 4.6776376e-02, 2.9849466e-01 }, { 4.2865195e-02, 2.9908137e-01 }, + { 3.8946668e-02, 2.9961684e-01 }, { 3.5021468e-02, 3.0010097e-01 }, + { 3.1090267e-02, 3.0053367e-01 }, { 2.7153740e-02, 3.0091488e-01 }, + { 2.3212559e-02, 3.0124454e-01 }, { 1.9267401e-02, 3.0152257e-01 }, + { 1.5318942e-02, 3.0174894e-01 }, { 1.1367858e-02, 3.0192361e-01 }, + { 7.4148264e-03, 3.0204654e-01 }, { 3.4605241e-03, 3.0211772e-01 }, + } +}; + +static const struct lc3_mdct_rot_def mdct_rot_640 = { + .n4 = 640/4, .w = (const struct lc3_complex []){ + { 2.8117045e-01, 3.4504823e-04 }, { 2.8115351e-01, 3.1053717e-03 }, + { 2.8110948e-01, 5.8653959e-03 }, { 2.8103835e-01, 8.6248547e-03 }, + { 2.8094013e-01, 1.1383482e-02 }, { 2.8081484e-01, 1.4141013e-02 }, + { 2.8066248e-01, 1.6897180e-02 }, { 2.8048307e-01, 1.9651719e-02 }, + { 2.8027662e-01, 2.2404364e-02 }, { 2.8004317e-01, 2.5154849e-02 }, + { 2.7978272e-01, 2.7902910e-02 }, { 2.7949530e-01, 3.0648282e-02 }, + { 2.7918095e-01, 3.3390700e-02 }, { 2.7883969e-01, 3.6129899e-02 }, + { 2.7847155e-01, 3.8865616e-02 }, { 2.7807658e-01, 4.1597587e-02 }, + { 2.7765480e-01, 4.4325549e-02 }, { 2.7720626e-01, 4.7049239e-02 }, + { 2.7673100e-01, 4.9768394e-02 }, { 2.7622908e-01, 5.2482752e-02 }, + { 2.7570052e-01, 5.5192052e-02 }, { 2.7514540e-01, 5.7896032e-02 }, + { 2.7456376e-01, 6.0594433e-02 }, { 2.7395565e-01, 6.3286992e-02 }, + { 2.7332114e-01, 6.5973453e-02 }, { 2.7266028e-01, 6.8653554e-02 }, + { 2.7197315e-01, 7.1327039e-02 }, { 2.7125980e-01, 7.3993649e-02 }, + { 2.7052031e-01, 7.6653127e-02 }, { 2.6975475e-01, 7.9305217e-02 }, + { 2.6896318e-01, 8.1949664e-02 }, { 2.6814570e-01, 8.4586212e-02 }, + { 2.6730236e-01, 8.7214608e-02 }, { 2.6643327e-01, 8.9834598e-02 }, + { 2.6553849e-01, 9.2445929e-02 }, { 2.6461813e-01, 9.5048350e-02 }, + { 2.6367225e-01, 9.7641610e-02 }, { 2.6270097e-01, 1.0022546e-01 }, + { 2.6170436e-01, 1.0279965e-01 }, { 2.6068253e-01, 1.0536393e-01 }, + { 2.5963558e-01, 1.0791806e-01 }, { 2.5856360e-01, 1.1046178e-01 }, + { 2.5746670e-01, 1.1299486e-01 }, { 2.5634499e-01, 1.1551705e-01 }, + { 2.5519857e-01, 1.1802810e-01 }, { 2.5402755e-01, 1.2052778e-01 }, + { 2.5283205e-01, 1.2301584e-01 }, { 2.5161218e-01, 1.2549204e-01 }, + { 2.5036806e-01, 1.2795615e-01 }, { 2.4909981e-01, 1.3040793e-01 }, + { 2.4780754e-01, 1.3284714e-01 }, { 2.4649140e-01, 1.3527354e-01 }, + { 2.4515150e-01, 1.3768691e-01 }, { 2.4378797e-01, 1.4008700e-01 }, + { 2.4240094e-01, 1.4247360e-01 }, { 2.4099055e-01, 1.4484646e-01 }, + { 2.3955693e-01, 1.4720536e-01 }, { 2.3810023e-01, 1.4955007e-01 }, + { 2.3662057e-01, 1.5188037e-01 }, { 2.3511811e-01, 1.5419603e-01 }, + { 2.3359299e-01, 1.5649683e-01 }, { 2.3204535e-01, 1.5878255e-01 }, + { 2.3047535e-01, 1.6105296e-01 }, { 2.2888313e-01, 1.6330785e-01 }, + { 2.2726886e-01, 1.6554699e-01 }, { 2.2563268e-01, 1.6777019e-01 }, + { 2.2397475e-01, 1.6997721e-01 }, { 2.2229524e-01, 1.7216785e-01 }, + { 2.2059430e-01, 1.7434190e-01 }, { 2.1887210e-01, 1.7649914e-01 }, + { 2.1712880e-01, 1.7863937e-01 }, { 2.1536458e-01, 1.8076239e-01 }, + { 2.1357960e-01, 1.8286798e-01 }, { 2.1177403e-01, 1.8495594e-01 }, + { 2.0994805e-01, 1.8702608e-01 }, { 2.0810184e-01, 1.8907820e-01 }, + { 2.0623557e-01, 1.9111209e-01 }, { 2.0434942e-01, 1.9312756e-01 }, + { 2.0244358e-01, 1.9512442e-01 }, { 2.0051823e-01, 1.9710247e-01 }, + { 1.9857355e-01, 1.9906152e-01 }, { 1.9660973e-01, 2.0100139e-01 }, + { 1.9462696e-01, 2.0292188e-01 }, { 1.9262543e-01, 2.0482282e-01 }, + { 1.9060533e-01, 2.0670401e-01 }, { 1.8856687e-01, 2.0856528e-01 }, + { 1.8651023e-01, 2.1040645e-01 }, { 1.8443562e-01, 2.1222734e-01 }, + { 1.8234322e-01, 2.1402778e-01 }, { 1.8023326e-01, 2.1580759e-01 }, + { 1.7810592e-01, 2.1756659e-01 }, { 1.7596142e-01, 2.1930463e-01 }, + { 1.7379995e-01, 2.2102153e-01 }, { 1.7162174e-01, 2.2271713e-01 }, + { 1.6942698e-01, 2.2439126e-01 }, { 1.6721590e-01, 2.2604377e-01 }, + { 1.6498869e-01, 2.2767449e-01 }, { 1.6274559e-01, 2.2928326e-01 }, + { 1.6048680e-01, 2.3086994e-01 }, { 1.5821254e-01, 2.3243436e-01 }, + { 1.5592304e-01, 2.3397638e-01 }, { 1.5361850e-01, 2.3549585e-01 }, + { 1.5129916e-01, 2.3699263e-01 }, { 1.4896524e-01, 2.3846656e-01 }, + { 1.4661696e-01, 2.3991751e-01 }, { 1.4425454e-01, 2.4134533e-01 }, + { 1.4187823e-01, 2.4274989e-01 }, { 1.3948824e-01, 2.4413106e-01 }, + { 1.3708480e-01, 2.4548869e-01 }, { 1.3466815e-01, 2.4682267e-01 }, + { 1.3223853e-01, 2.4813285e-01 }, { 1.2979616e-01, 2.4941912e-01 }, + { 1.2734127e-01, 2.5068135e-01 }, { 1.2487412e-01, 2.5191942e-01 }, + { 1.2239493e-01, 2.5313321e-01 }, { 1.1990394e-01, 2.5432260e-01 }, + { 1.1740139e-01, 2.5548748e-01 }, { 1.1488753e-01, 2.5662774e-01 }, + { 1.1236260e-01, 2.5774326e-01 }, { 1.0982684e-01, 2.5883394e-01 }, + { 1.0728049e-01, 2.5989967e-01 }, { 1.0472380e-01, 2.6094035e-01 }, + { 1.0215702e-01, 2.6195588e-01 }, { 9.9580393e-02, 2.6294617e-01 }, + { 9.6994168e-02, 2.6391111e-01 }, { 9.4398594e-02, 2.6485061e-01 }, + { 9.1793922e-02, 2.6576459e-01 }, { 8.9180402e-02, 2.6665295e-01 }, + { 8.6558287e-02, 2.6751562e-01 }, { 8.3927830e-02, 2.6835249e-01 }, + { 8.1289283e-02, 2.6916351e-01 }, { 7.8642901e-02, 2.6994858e-01 }, + { 7.5988940e-02, 2.7070763e-01 }, { 7.3327655e-02, 2.7144059e-01 }, + { 7.0659302e-02, 2.7214739e-01 }, { 6.7984139e-02, 2.7282796e-01 }, + { 6.5302424e-02, 2.7348224e-01 }, { 6.2614414e-02, 2.7411015e-01 }, + { 5.9920370e-02, 2.7471165e-01 }, { 5.7220550e-02, 2.7528667e-01 }, + { 5.4515216e-02, 2.7583516e-01 }, { 5.1804627e-02, 2.7635706e-01 }, + { 4.9089045e-02, 2.7685232e-01 }, { 4.6368731e-02, 2.7732090e-01 }, + { 4.3643949e-02, 2.7776275e-01 }, { 4.0914960e-02, 2.7817783e-01 }, + { 3.8182028e-02, 2.7856610e-01 }, { 3.5445415e-02, 2.7892752e-01 }, + { 3.2705387e-02, 2.7926206e-01 }, { 2.9962206e-02, 2.7956968e-01 }, + { 2.7216137e-02, 2.7985036e-01 }, { 2.4467445e-02, 2.8010406e-01 }, + { 2.1716395e-02, 2.8033077e-01 }, { 1.8963252e-02, 2.8053046e-01 }, + { 1.6208281e-02, 2.8070310e-01 }, { 1.3451748e-02, 2.8084870e-01 }, + { 1.0693918e-02, 2.8096723e-01 }, { 7.9350576e-03, 2.8105867e-01 }, + { 5.1754324e-03, 2.8112303e-01 }, { 2.4153085e-03, 2.8116029e-01 }, + } +}; + +static const struct lc3_mdct_rot_def mdct_rot_720 = { + .n4 = 720/4, .w = (const struct lc3_complex []){ + { 2.7301192e-01, 2.9780993e-04 }, { 2.7299893e-01, 2.6802468e-03 }, + { 2.7296515e-01, 5.0624796e-03 }, { 2.7291057e-01, 7.4443269e-03 }, + { 2.7283522e-01, 9.8256072e-03 }, { 2.7273909e-01, 1.2206139e-02 }, + { 2.7262218e-01, 1.4585742e-02 }, { 2.7248452e-01, 1.6964234e-02 }, + { 2.7232611e-01, 1.9341434e-02 }, { 2.7214695e-01, 2.1717161e-02 }, + { 2.7194708e-01, 2.4091234e-02 }, { 2.7172649e-01, 2.6463472e-02 }, + { 2.7148521e-01, 2.8833695e-02 }, { 2.7122325e-01, 3.1201723e-02 }, + { 2.7094064e-01, 3.3567374e-02 }, { 2.7063740e-01, 3.5930469e-02 }, + { 2.7031354e-01, 3.8290828e-02 }, { 2.6996910e-01, 4.0648270e-02 }, + { 2.6960411e-01, 4.3002618e-02 }, { 2.6921858e-01, 4.5353690e-02 }, + { 2.6881255e-01, 4.7701309e-02 }, { 2.6838604e-01, 5.0045294e-02 }, + { 2.6793910e-01, 5.2385469e-02 }, { 2.6747176e-01, 5.4721655e-02 }, + { 2.6698404e-01, 5.7053673e-02 }, { 2.6647599e-01, 5.9381346e-02 }, + { 2.6594765e-01, 6.1704497e-02 }, { 2.6539906e-01, 6.4022949e-02 }, + { 2.6483026e-01, 6.6336526e-02 }, { 2.6424128e-01, 6.8645051e-02 }, + { 2.6363219e-01, 7.0948348e-02 }, { 2.6300302e-01, 7.3246242e-02 }, + { 2.6235382e-01, 7.5538558e-02 }, { 2.6168464e-01, 7.7825122e-02 }, + { 2.6099553e-01, 8.0105759e-02 }, { 2.6028655e-01, 8.2380295e-02 }, + { 2.5955774e-01, 8.4648558e-02 }, { 2.5880917e-01, 8.6910375e-02 }, + { 2.5804089e-01, 8.9165573e-02 }, { 2.5725296e-01, 9.1413981e-02 }, + { 2.5644543e-01, 9.3655427e-02 }, { 2.5561838e-01, 9.5889741e-02 }, + { 2.5477186e-01, 9.8116753e-02 }, { 2.5390594e-01, 1.0033629e-01 }, + { 2.5302069e-01, 1.0254819e-01 }, { 2.5211616e-01, 1.0475228e-01 }, + { 2.5119244e-01, 1.0694839e-01 }, { 2.5024958e-01, 1.0913636e-01 }, + { 2.4928767e-01, 1.1131602e-01 }, { 2.4830678e-01, 1.1348720e-01 }, + { 2.4730697e-01, 1.1564973e-01 }, { 2.4628833e-01, 1.1780346e-01 }, + { 2.4525094e-01, 1.1994822e-01 }, { 2.4419487e-01, 1.2208384e-01 }, + { 2.4312020e-01, 1.2421017e-01 }, { 2.4202702e-01, 1.2632704e-01 }, + { 2.4091541e-01, 1.2843429e-01 }, { 2.3978545e-01, 1.3053175e-01 }, + { 2.3863723e-01, 1.3261928e-01 }, { 2.3747083e-01, 1.3469670e-01 }, + { 2.3628636e-01, 1.3676387e-01 }, { 2.3508388e-01, 1.3882063e-01 }, + { 2.3386351e-01, 1.4086681e-01 }, { 2.3262533e-01, 1.4290226e-01 }, + { 2.3136943e-01, 1.4492683e-01 }, { 2.3009591e-01, 1.4694037e-01 }, + { 2.2880487e-01, 1.4894272e-01 }, { 2.2749640e-01, 1.5093372e-01 }, + { 2.2617061e-01, 1.5291323e-01 }, { 2.2482759e-01, 1.5488109e-01 }, + { 2.2346746e-01, 1.5683716e-01 }, { 2.2209030e-01, 1.5878128e-01 }, + { 2.2069624e-01, 1.6071332e-01 }, { 2.1928536e-01, 1.6263311e-01 }, + { 2.1785779e-01, 1.6454052e-01 }, { 2.1641363e-01, 1.6643540e-01 }, + { 2.1495298e-01, 1.6831760e-01 }, { 2.1347597e-01, 1.7018699e-01 }, + { 2.1198270e-01, 1.7204341e-01 }, { 2.1047328e-01, 1.7388674e-01 }, + { 2.0894784e-01, 1.7571682e-01 }, { 2.0740648e-01, 1.7753352e-01 }, + { 2.0584933e-01, 1.7933670e-01 }, { 2.0427651e-01, 1.8112622e-01 }, + { 2.0268812e-01, 1.8290195e-01 }, { 2.0108431e-01, 1.8466375e-01 }, + { 1.9946518e-01, 1.8641149e-01 }, { 1.9783085e-01, 1.8814503e-01 }, + { 1.9618147e-01, 1.8986424e-01 }, { 1.9451714e-01, 1.9156900e-01 }, + { 1.9283800e-01, 1.9325917e-01 }, { 1.9114417e-01, 1.9493462e-01 }, + { 1.8943579e-01, 1.9659522e-01 }, { 1.8771298e-01, 1.9824085e-01 }, + { 1.8597588e-01, 1.9987139e-01 }, { 1.8422461e-01, 2.0148670e-01 }, + { 1.8245932e-01, 2.0308667e-01 }, { 1.8068013e-01, 2.0467118e-01 }, + { 1.7888718e-01, 2.0624010e-01 }, { 1.7708060e-01, 2.0779331e-01 }, + { 1.7526055e-01, 2.0933070e-01 }, { 1.7342714e-01, 2.1085214e-01 }, + { 1.7158053e-01, 2.1235753e-01 }, { 1.6972085e-01, 2.1384675e-01 }, + { 1.6784825e-01, 2.1531968e-01 }, { 1.6596286e-01, 2.1677622e-01 }, + { 1.6406484e-01, 2.1821624e-01 }, { 1.6215432e-01, 2.1963965e-01 }, + { 1.6023145e-01, 2.2104633e-01 }, { 1.5829638e-01, 2.2243618e-01 }, + { 1.5634925e-01, 2.2380909e-01 }, { 1.5439022e-01, 2.2516496e-01 }, + { 1.5241943e-01, 2.2650368e-01 }, { 1.5043704e-01, 2.2782514e-01 }, + { 1.4844319e-01, 2.2912926e-01 }, { 1.4643803e-01, 2.3041593e-01 }, + { 1.4442172e-01, 2.3168506e-01 }, { 1.4239441e-01, 2.3293654e-01 }, + { 1.4035626e-01, 2.3417028e-01 }, { 1.3830742e-01, 2.3538618e-01 }, + { 1.3624805e-01, 2.3658417e-01 }, { 1.3417830e-01, 2.3776413e-01 }, + { 1.3209834e-01, 2.3892599e-01 }, { 1.3000831e-01, 2.4006965e-01 }, + { 1.2790838e-01, 2.4119503e-01 }, { 1.2579872e-01, 2.4230205e-01 }, + { 1.2367947e-01, 2.4339061e-01 }, { 1.2155080e-01, 2.4446063e-01 }, + { 1.1941288e-01, 2.4551204e-01 }, { 1.1726586e-01, 2.4654476e-01 }, + { 1.1510992e-01, 2.4755869e-01 }, { 1.1294520e-01, 2.4855378e-01 }, + { 1.1077189e-01, 2.4952993e-01 }, { 1.0859014e-01, 2.5048709e-01 }, + { 1.0640012e-01, 2.5142516e-01 }, { 1.0420200e-01, 2.5234410e-01 }, + { 1.0199594e-01, 2.5324381e-01 }, { 9.9782117e-02, 2.5412424e-01 }, + { 9.7560694e-02, 2.5498531e-01 }, { 9.5331841e-02, 2.5582697e-01 }, + { 9.3095728e-02, 2.5664915e-01 }, { 9.0852525e-02, 2.5745178e-01 }, + { 8.8602403e-02, 2.5823480e-01 }, { 8.6345534e-02, 2.5899816e-01 }, + { 8.4082090e-02, 2.5974180e-01 }, { 8.1812242e-02, 2.6046565e-01 }, + { 7.9536165e-02, 2.6116967e-01 }, { 7.7254030e-02, 2.6185380e-01 }, + { 7.4966012e-02, 2.6251799e-01 }, { 7.2672284e-02, 2.6316219e-01 }, + { 7.0373023e-02, 2.6378635e-01 }, { 6.8068403e-02, 2.6439042e-01 }, + { 6.5758598e-02, 2.6497435e-01 }, { 6.3443786e-02, 2.6553810e-01 }, + { 6.1124143e-02, 2.6608164e-01 }, { 5.8799845e-02, 2.6660491e-01 }, + { 5.6471069e-02, 2.6710788e-01 }, { 5.4137992e-02, 2.6759050e-01 }, + { 5.1800793e-02, 2.6805275e-01 }, { 4.9459648e-02, 2.6849459e-01 }, + { 4.7114738e-02, 2.6891597e-01 }, { 4.4766239e-02, 2.6931688e-01 }, + { 4.2414331e-02, 2.6969728e-01 }, { 4.0059193e-02, 2.7005714e-01 }, + { 3.7701004e-02, 2.7039644e-01 }, { 3.5339945e-02, 2.7071514e-01 }, + { 3.2976194e-02, 2.7101323e-01 }, { 3.0609932e-02, 2.7129068e-01 }, + { 2.8241338e-02, 2.7154747e-01 }, { 2.5870594e-02, 2.7178357e-01 }, + { 2.3497880e-02, 2.7199899e-01 }, { 2.1123377e-02, 2.7219369e-01 }, + { 1.8747265e-02, 2.7236765e-01 }, { 1.6369725e-02, 2.7252088e-01 }, + { 1.3990938e-02, 2.7265336e-01 }, { 1.1611086e-02, 2.7276507e-01 }, + { 9.2303502e-03, 2.7285601e-01 }, { 6.8489111e-03, 2.7292617e-01 }, + { 4.4669505e-03, 2.7297554e-01 }, { 2.0846497e-03, 2.7300413e-01 }, + } +}; + +static const struct lc3_mdct_rot_def mdct_rot_960 = { + .n4 = 960/4, .w = (const struct lc3_complex []){ + { 2.5406629e-01, 2.0785754e-04 }, { 2.5405949e-01, 1.8707012e-03 }, + { 2.5404180e-01, 3.5334647e-03 }, { 2.5401323e-01, 5.1960769e-03 }, + { 2.5397379e-01, 6.8584664e-03 }, { 2.5392346e-01, 8.5205622e-03 }, + { 2.5386225e-01, 1.0182293e-02 }, { 2.5379017e-01, 1.1843588e-02 }, + { 2.5370722e-01, 1.3504375e-02 }, { 2.5361340e-01, 1.5164584e-02 }, + { 2.5350872e-01, 1.6824143e-02 }, { 2.5339318e-01, 1.8482981e-02 }, + { 2.5326678e-01, 2.0141028e-02 }, { 2.5312953e-01, 2.1798212e-02 }, + { 2.5298144e-01, 2.3454462e-02 }, { 2.5282252e-01, 2.5109708e-02 }, + { 2.5265276e-01, 2.6763878e-02 }, { 2.5247218e-01, 2.8416901e-02 }, + { 2.5228079e-01, 3.0068707e-02 }, { 2.5207859e-01, 3.1719225e-02 }, + { 2.5186559e-01, 3.3368385e-02 }, { 2.5164180e-01, 3.5016115e-02 }, + { 2.5140723e-01, 3.6662344e-02 }, { 2.5116189e-01, 3.8307004e-02 }, + { 2.5090580e-01, 3.9950022e-02 }, { 2.5063895e-01, 4.1591330e-02 }, + { 2.5036137e-01, 4.3230855e-02 }, { 2.5007306e-01, 4.4868529e-02 }, + { 2.4977405e-01, 4.6504281e-02 }, { 2.4946433e-01, 4.8138040e-02 }, + { 2.4914393e-01, 4.9769738e-02 }, { 2.4881285e-01, 5.1399303e-02 }, + { 2.4847112e-01, 5.3026667e-02 }, { 2.4811874e-01, 5.4651759e-02 }, + { 2.4775573e-01, 5.6274511e-02 }, { 2.4738211e-01, 5.7894851e-02 }, + { 2.4699789e-01, 5.9512712e-02 }, { 2.4660310e-01, 6.1128023e-02 }, + { 2.4619774e-01, 6.2740716e-02 }, { 2.4578183e-01, 6.4350721e-02 }, + { 2.4535539e-01, 6.5957969e-02 }, { 2.4491845e-01, 6.7562392e-02 }, + { 2.4447101e-01, 6.9163921e-02 }, { 2.4401310e-01, 7.0762488e-02 }, + { 2.4354474e-01, 7.2358023e-02 }, { 2.4306594e-01, 7.3950458e-02 }, + { 2.4257673e-01, 7.5539726e-02 }, { 2.4207714e-01, 7.7125757e-02 }, + { 2.4156717e-01, 7.8708485e-02 }, { 2.4104685e-01, 8.0287842e-02 }, + { 2.4051621e-01, 8.1863759e-02 }, { 2.3997527e-01, 8.3436169e-02 }, + { 2.3942404e-01, 8.5005005e-02 }, { 2.3886256e-01, 8.6570200e-02 }, + { 2.3829085e-01, 8.8131686e-02 }, { 2.3770893e-01, 8.9689398e-02 }, + { 2.3711683e-01, 9.1243267e-02 }, { 2.3651456e-01, 9.2793227e-02 }, + { 2.3590217e-01, 9.4339213e-02 }, { 2.3527968e-01, 9.5881158e-02 }, + { 2.3464710e-01, 9.7418995e-02 }, { 2.3400447e-01, 9.8952659e-02 }, + { 2.3335182e-01, 1.0048208e-01 }, { 2.3268918e-01, 1.0200721e-01 }, + { 2.3201656e-01, 1.0352796e-01 }, { 2.3133401e-01, 1.0504427e-01 }, + { 2.3064154e-01, 1.0655609e-01 }, { 2.2993920e-01, 1.0806334e-01 }, + { 2.2922701e-01, 1.0956597e-01 }, { 2.2850500e-01, 1.1106390e-01 }, + { 2.2777320e-01, 1.1255707e-01 }, { 2.2703164e-01, 1.1404542e-01 }, + { 2.2628036e-01, 1.1552888e-01 }, { 2.2551938e-01, 1.1700740e-01 }, + { 2.2474874e-01, 1.1848090e-01 }, { 2.2396848e-01, 1.1994933e-01 }, + { 2.2317862e-01, 1.2141262e-01 }, { 2.2237920e-01, 1.2287071e-01 }, + { 2.2157026e-01, 1.2432354e-01 }, { 2.2075182e-01, 1.2577104e-01 }, + { 2.1992393e-01, 1.2721315e-01 }, { 2.1908662e-01, 1.2864982e-01 }, + { 2.1823992e-01, 1.3008097e-01 }, { 2.1738388e-01, 1.3150655e-01 }, + { 2.1651852e-01, 1.3292650e-01 }, { 2.1564388e-01, 1.3434075e-01 }, + { 2.1476001e-01, 1.3574925e-01 }, { 2.1386694e-01, 1.3715193e-01 }, + { 2.1296471e-01, 1.3854874e-01 }, { 2.1205336e-01, 1.3993962e-01 }, + { 2.1113292e-01, 1.4132449e-01 }, { 2.1020344e-01, 1.4270332e-01 }, + { 2.0926495e-01, 1.4407603e-01 }, { 2.0831750e-01, 1.4544257e-01 }, + { 2.0736113e-01, 1.4680288e-01 }, { 2.0639587e-01, 1.4815690e-01 }, + { 2.0542177e-01, 1.4950458e-01 }, { 2.0443887e-01, 1.5084585e-01 }, + { 2.0344722e-01, 1.5218066e-01 }, { 2.0244685e-01, 1.5350895e-01 }, + { 2.0143780e-01, 1.5483066e-01 }, { 2.0042013e-01, 1.5614574e-01 }, + { 1.9939388e-01, 1.5745414e-01 }, { 1.9835908e-01, 1.5875578e-01 }, + { 1.9731578e-01, 1.6005063e-01 }, { 1.9626403e-01, 1.6133862e-01 }, + { 1.9520388e-01, 1.6261970e-01 }, { 1.9413536e-01, 1.6389382e-01 }, + { 1.9305853e-01, 1.6516091e-01 }, { 1.9197343e-01, 1.6642093e-01 }, + { 1.9088010e-01, 1.6767382e-01 }, { 1.8977860e-01, 1.6891953e-01 }, + { 1.8866896e-01, 1.7015800e-01 }, { 1.8755125e-01, 1.7138918e-01 }, + { 1.8642550e-01, 1.7261302e-01 }, { 1.8529177e-01, 1.7382947e-01 }, + { 1.8415009e-01, 1.7503847e-01 }, { 1.8300053e-01, 1.7623997e-01 }, + { 1.8184314e-01, 1.7743392e-01 }, { 1.8067795e-01, 1.7862027e-01 }, + { 1.7950502e-01, 1.7979897e-01 }, { 1.7832440e-01, 1.8096997e-01 }, + { 1.7713614e-01, 1.8213322e-01 }, { 1.7594030e-01, 1.8328866e-01 }, + { 1.7473692e-01, 1.8443625e-01 }, { 1.7352605e-01, 1.8557595e-01 }, + { 1.7230775e-01, 1.8670769e-01 }, { 1.7108207e-01, 1.8783143e-01 }, + { 1.6984906e-01, 1.8894713e-01 }, { 1.6860878e-01, 1.9005474e-01 }, + { 1.6736127e-01, 1.9115420e-01 }, { 1.6610659e-01, 1.9224547e-01 }, + { 1.6484480e-01, 1.9332851e-01 }, { 1.6357595e-01, 1.9440327e-01 }, + { 1.6230008e-01, 1.9546970e-01 }, { 1.6101727e-01, 1.9652776e-01 }, + { 1.5972756e-01, 1.9757740e-01 }, { 1.5843101e-01, 1.9861857e-01 }, + { 1.5712767e-01, 1.9965124e-01 }, { 1.5581760e-01, 2.0067536e-01 }, + { 1.5450085e-01, 2.0169087e-01 }, { 1.5317749e-01, 2.0269775e-01 }, + { 1.5184756e-01, 2.0369595e-01 }, { 1.5051113e-01, 2.0468542e-01 }, + { 1.4916826e-01, 2.0566612e-01 }, { 1.4781899e-01, 2.0663801e-01 }, + { 1.4646339e-01, 2.0760105e-01 }, { 1.4510152e-01, 2.0855520e-01 }, + { 1.4373343e-01, 2.0950041e-01 }, { 1.4235918e-01, 2.1043665e-01 }, + { 1.4097884e-01, 2.1136388e-01 }, { 1.3959246e-01, 2.1228205e-01 }, + { 1.3820009e-01, 2.1319113e-01 }, { 1.3680181e-01, 2.1409107e-01 }, + { 1.3539767e-01, 2.1498185e-01 }, { 1.3398773e-01, 2.1586341e-01 }, + { 1.3257204e-01, 2.1673573e-01 }, { 1.3115068e-01, 2.1759876e-01 }, + { 1.2972370e-01, 2.1845247e-01 }, { 1.2829117e-01, 2.1929683e-01 }, + { 1.2685313e-01, 2.2013179e-01 }, { 1.2540967e-01, 2.2095732e-01 }, + { 1.2396083e-01, 2.2177339e-01 }, { 1.2250668e-01, 2.2257995e-01 }, + { 1.2104729e-01, 2.2337698e-01 }, { 1.1958271e-01, 2.2416445e-01 }, + { 1.1811300e-01, 2.2494231e-01 }, { 1.1663824e-01, 2.2571053e-01 }, + { 1.1515848e-01, 2.2646909e-01 }, { 1.1367379e-01, 2.2721794e-01 }, + { 1.1218422e-01, 2.2795706e-01 }, { 1.1068986e-01, 2.2868642e-01 }, + { 1.0919075e-01, 2.2940598e-01 }, { 1.0768696e-01, 2.3011571e-01 }, + { 1.0617856e-01, 2.3081559e-01 }, { 1.0466561e-01, 2.3150558e-01 }, + { 1.0314818e-01, 2.3218565e-01 }, { 1.0162633e-01, 2.3285577e-01 }, + { 1.0010013e-01, 2.3351592e-01 }, { 9.8569638e-02, 2.3416607e-01 }, + { 9.7034924e-02, 2.3480619e-01 }, { 9.5496054e-02, 2.3543625e-01 }, + { 9.3953093e-02, 2.3605622e-01 }, { 9.2406107e-02, 2.3666608e-01 }, + { 9.0855163e-02, 2.3726580e-01 }, { 8.9300327e-02, 2.3785536e-01 }, + { 8.7741666e-02, 2.3843473e-01 }, { 8.6179246e-02, 2.3900389e-01 }, + { 8.4613135e-02, 2.3956281e-01 }, { 8.3043399e-02, 2.4011147e-01 }, + { 8.1470106e-02, 2.4064984e-01 }, { 7.9893322e-02, 2.4117790e-01 }, + { 7.8313117e-02, 2.4169563e-01 }, { 7.6729556e-02, 2.4220301e-01 }, + { 7.5142709e-02, 2.4270001e-01 }, { 7.3552643e-02, 2.4318662e-01 }, + { 7.1959427e-02, 2.4366281e-01 }, { 7.0363128e-02, 2.4412856e-01 }, + { 6.8763814e-02, 2.4458385e-01 }, { 6.7161555e-02, 2.4502867e-01 }, + { 6.5556419e-02, 2.4546299e-01 }, { 6.3948475e-02, 2.4588679e-01 }, + { 6.2337792e-02, 2.4630007e-01 }, { 6.0724438e-02, 2.4670279e-01 }, + { 5.9108483e-02, 2.4709494e-01 }, { 5.7489996e-02, 2.4747651e-01 }, + { 5.5869046e-02, 2.4784748e-01 }, { 5.4245703e-02, 2.4820783e-01 }, + { 5.2620036e-02, 2.4855755e-01 }, { 5.0992116e-02, 2.4889662e-01 }, + { 4.9362011e-02, 2.4922503e-01 }, { 4.7729791e-02, 2.4954276e-01 }, + { 4.6095527e-02, 2.4984980e-01 }, { 4.4459288e-02, 2.5014615e-01 }, + { 4.2821145e-02, 2.5043177e-01 }, { 4.1181167e-02, 2.5070667e-01 }, + { 3.9539426e-02, 2.5097083e-01 }, { 3.7895990e-02, 2.5122424e-01 }, + { 3.6250931e-02, 2.5146688e-01 }, { 3.4604320e-02, 2.5169876e-01 }, + { 3.2956226e-02, 2.5191985e-01 }, { 3.1306720e-02, 2.5213015e-01 }, + { 2.9655874e-02, 2.5232965e-01 }, { 2.8003757e-02, 2.5251834e-01 }, + { 2.6350440e-02, 2.5269621e-01 }, { 2.4695994e-02, 2.5286326e-01 }, + { 2.3040491e-02, 2.5301948e-01 }, { 2.1384001e-02, 2.5316486e-01 }, + { 1.9726595e-02, 2.5329940e-01 }, { 1.8068343e-02, 2.5342308e-01 }, + { 1.6409318e-02, 2.5353591e-01 }, { 1.4749590e-02, 2.5363788e-01 }, + { 1.3089230e-02, 2.5372898e-01 }, { 1.1428309e-02, 2.5380921e-01 }, + { 9.7668984e-03, 2.5387857e-01 }, { 8.1050697e-03, 2.5393706e-01 }, + { 6.4428938e-03, 2.5398467e-01 }, { 4.7804419e-03, 2.5402140e-01 }, + { 3.1177852e-03, 2.5404724e-01 }, { 1.4549950e-03, 2.5406221e-01 }, + } +}; + +#if LC3_PLUS_HR + +static const struct lc3_mdct_rot_def mdct_rot_1920 = { + .n4 = 1920/4, .w = (const struct lc3_complex []){ + { 2.1364349e-01, 8.7393339e-05 }, { 2.1364206e-01, 7.8653829e-04 }, + { 2.1363834e-01, 1.4856748e-03 }, { 2.1363233e-01, 2.1847954e-03 }, + { 2.1362404e-01, 2.8838927e-03 }, { 2.1361346e-01, 3.5829590e-03 }, + { 2.1360059e-01, 4.2819870e-03 }, { 2.1358543e-01, 4.9809691e-03 }, + { 2.1356799e-01, 5.6798979e-03 }, { 2.1354826e-01, 6.3787658e-03 }, + { 2.1352624e-01, 7.0775654e-03 }, { 2.1350193e-01, 7.7762893e-03 }, + { 2.1347534e-01, 8.4749298e-03 }, { 2.1344647e-01, 9.1734796e-03 }, + { 2.1341530e-01, 9.8719312e-03 }, { 2.1338185e-01, 1.0570277e-02 }, + { 2.1334612e-01, 1.1268510e-02 }, { 2.1330810e-01, 1.1966622e-02 }, + { 2.1326780e-01, 1.2664605e-02 }, { 2.1322521e-01, 1.3362454e-02 }, + { 2.1318034e-01, 1.4060159e-02 }, { 2.1313319e-01, 1.4757713e-02 }, + { 2.1308375e-01, 1.5455110e-02 }, { 2.1303204e-01, 1.6152341e-02 }, + { 2.1297804e-01, 1.6849399e-02 }, { 2.1292176e-01, 1.7546276e-02 }, + { 2.1286320e-01, 1.8242966e-02 }, { 2.1280236e-01, 1.8939460e-02 }, + { 2.1273924e-01, 1.9635751e-02 }, { 2.1267384e-01, 2.0331833e-02 }, + { 2.1260617e-01, 2.1027696e-02 }, { 2.1253622e-01, 2.1723334e-02 }, + { 2.1246399e-01, 2.2418740e-02 }, { 2.1238949e-01, 2.3113905e-02 }, + { 2.1231271e-01, 2.3808823e-02 }, { 2.1223366e-01, 2.4503486e-02 }, + { 2.1215233e-01, 2.5197887e-02 }, { 2.1206874e-01, 2.5892018e-02 }, + { 2.1198287e-01, 2.6585871e-02 }, { 2.1189473e-01, 2.7279440e-02 }, + { 2.1180433e-01, 2.7972716e-02 }, { 2.1171165e-01, 2.8665693e-02 }, + { 2.1161671e-01, 2.9358363e-02 }, { 2.1151950e-01, 3.0050719e-02 }, + { 2.1142003e-01, 3.0742753e-02 }, { 2.1131829e-01, 3.1434457e-02 }, + { 2.1121429e-01, 3.2125825e-02 }, { 2.1110803e-01, 3.2816849e-02 }, + { 2.1099951e-01, 3.3507522e-02 }, { 2.1088873e-01, 3.4197835e-02 }, + { 2.1077568e-01, 3.4887783e-02 }, { 2.1066039e-01, 3.5577357e-02 }, + { 2.1054283e-01, 3.6266549e-02 }, { 2.1042302e-01, 3.6955354e-02 }, + { 2.1030096e-01, 3.7643762e-02 }, { 2.1017664e-01, 3.8331768e-02 }, + { 2.1005008e-01, 3.9019363e-02 }, { 2.0992126e-01, 3.9706540e-02 }, + { 2.0979020e-01, 4.0393292e-02 }, { 2.0965689e-01, 4.1079611e-02 }, + { 2.0952134e-01, 4.1765490e-02 }, { 2.0938354e-01, 4.2450923e-02 }, + { 2.0924350e-01, 4.3135900e-02 }, { 2.0910121e-01, 4.3820416e-02 }, + { 2.0895669e-01, 4.4504462e-02 }, { 2.0880993e-01, 4.5188032e-02 }, + { 2.0866094e-01, 4.5871117e-02 }, { 2.0850971e-01, 4.6553712e-02 }, + { 2.0835625e-01, 4.7235808e-02 }, { 2.0820055e-01, 4.7917398e-02 }, + { 2.0804263e-01, 4.8598475e-02 }, { 2.0788248e-01, 4.9279031e-02 }, + { 2.0772010e-01, 4.9959060e-02 }, { 2.0755549e-01, 5.0638554e-02 }, + { 2.0738867e-01, 5.1317505e-02 }, { 2.0721962e-01, 5.1995907e-02 }, + { 2.0704836e-01, 5.2673752e-02 }, { 2.0687487e-01, 5.3351033e-02 }, + { 2.0669918e-01, 5.4027742e-02 }, { 2.0652126e-01, 5.4703873e-02 }, + { 2.0634114e-01, 5.5379418e-02 }, { 2.0615881e-01, 5.6054370e-02 }, + { 2.0597427e-01, 5.6728722e-02 }, { 2.0578752e-01, 5.7402466e-02 }, + { 2.0559857e-01, 5.8075596e-02 }, { 2.0540742e-01, 5.8748104e-02 }, + { 2.0521406e-01, 5.9419982e-02 }, { 2.0501851e-01, 6.0091224e-02 }, + { 2.0482077e-01, 6.0761823e-02 }, { 2.0462083e-01, 6.1431770e-02 }, + { 2.0441870e-01, 6.2101060e-02 }, { 2.0421438e-01, 6.2769685e-02 }, + { 2.0400787e-01, 6.3437638e-02 }, { 2.0379918e-01, 6.4104911e-02 }, + { 2.0358831e-01, 6.4771498e-02 }, { 2.0337525e-01, 6.5437391e-02 }, + { 2.0316002e-01, 6.6102584e-02 }, { 2.0294262e-01, 6.6767068e-02 }, + { 2.0272303e-01, 6.7430838e-02 }, { 2.0250128e-01, 6.8093885e-02 }, + { 2.0227736e-01, 6.8756203e-02 }, { 2.0205127e-01, 6.9417785e-02 }, + { 2.0182302e-01, 7.0078623e-02 }, { 2.0159261e-01, 7.0738711e-02 }, + { 2.0136004e-01, 7.1398041e-02 }, { 2.0112531e-01, 7.2056607e-02 }, + { 2.0088843e-01, 7.2714401e-02 }, { 2.0064940e-01, 7.3371416e-02 }, + { 2.0040822e-01, 7.4027646e-02 }, { 2.0016489e-01, 7.4683083e-02 }, + { 1.9991942e-01, 7.5337720e-02 }, { 1.9967181e-01, 7.5991550e-02 }, + { 1.9942206e-01, 7.6644566e-02 }, { 1.9917017e-01, 7.7296762e-02 }, + { 1.9891615e-01, 7.7948130e-02 }, { 1.9866000e-01, 7.8598663e-02 }, + { 1.9840173e-01, 7.9248354e-02 }, { 1.9814132e-01, 7.9897197e-02 }, + { 1.9787880e-01, 8.0545184e-02 }, { 1.9761416e-01, 8.1192308e-02 }, + { 1.9734740e-01, 8.1838563e-02 }, { 1.9707853e-01, 8.2483942e-02 }, + { 1.9680754e-01, 8.3128437e-02 }, { 1.9653445e-01, 8.3772042e-02 }, + { 1.9625926e-01, 8.4414750e-02 }, { 1.9598196e-01, 8.5056553e-02 }, + { 1.9570257e-01, 8.5697446e-02 }, { 1.9542107e-01, 8.6337421e-02 }, + { 1.9513749e-01, 8.6976472e-02 }, { 1.9485182e-01, 8.7614591e-02 }, + { 1.9456405e-01, 8.8251772e-02 }, { 1.9427421e-01, 8.8888007e-02 }, + { 1.9398228e-01, 8.9523291e-02 }, { 1.9368828e-01, 9.0157616e-02 }, + { 1.9339221e-01, 9.0790976e-02 }, { 1.9309406e-01, 9.1423363e-02 }, + { 1.9279384e-01, 9.2054771e-02 }, { 1.9249156e-01, 9.2685193e-02 }, + { 1.9218722e-01, 9.3314623e-02 }, { 1.9188082e-01, 9.3943054e-02 }, + { 1.9157237e-01, 9.4570478e-02 }, { 1.9126186e-01, 9.5196890e-02 }, + { 1.9094930e-01, 9.5822282e-02 }, { 1.9063470e-01, 9.6446648e-02 }, + { 1.9031806e-01, 9.7069981e-02 }, { 1.8999938e-01, 9.7692274e-02 }, + { 1.8967867e-01, 9.8313522e-02 }, { 1.8935592e-01, 9.8933716e-02 }, + { 1.8903115e-01, 9.9552851e-02 }, { 1.8870435e-01, 1.0017092e-01 }, + { 1.8837554e-01, 1.0078792e-01 }, { 1.8804470e-01, 1.0140383e-01 }, + { 1.8771185e-01, 1.0201866e-01 }, { 1.8737699e-01, 1.0263240e-01 }, + { 1.8704012e-01, 1.0324504e-01 }, { 1.8670125e-01, 1.0385657e-01 }, + { 1.8636039e-01, 1.0446700e-01 }, { 1.8601752e-01, 1.0507630e-01 }, + { 1.8567266e-01, 1.0568448e-01 }, { 1.8532582e-01, 1.0629152e-01 }, + { 1.8497699e-01, 1.0689743e-01 }, { 1.8462618e-01, 1.0750219e-01 }, + { 1.8427339e-01, 1.0810580e-01 }, { 1.8391863e-01, 1.0870825e-01 }, + { 1.8356190e-01, 1.0930954e-01 }, { 1.8320320e-01, 1.0990966e-01 }, + { 1.8284254e-01, 1.1050860e-01 }, { 1.8247992e-01, 1.1110636e-01 }, + { 1.8211535e-01, 1.1170293e-01 }, { 1.8174883e-01, 1.1229830e-01 }, + { 1.8138036e-01, 1.1289247e-01 }, { 1.8100995e-01, 1.1348543e-01 }, + { 1.8063761e-01, 1.1407718e-01 }, { 1.8026332e-01, 1.1466770e-01 }, + { 1.7988711e-01, 1.1525699e-01 }, { 1.7950897e-01, 1.1584506e-01 }, + { 1.7912891e-01, 1.1643188e-01 }, { 1.7874692e-01, 1.1701745e-01 }, + { 1.7836303e-01, 1.1760177e-01 }, { 1.7797722e-01, 1.1818483e-01 }, + { 1.7758951e-01, 1.1876663e-01 }, { 1.7719990e-01, 1.1934715e-01 }, + { 1.7680839e-01, 1.1992639e-01 }, { 1.7641498e-01, 1.2050436e-01 }, + { 1.7601969e-01, 1.2108103e-01 }, { 1.7562251e-01, 1.2165640e-01 }, + { 1.7522345e-01, 1.2223047e-01 }, { 1.7482252e-01, 1.2280323e-01 }, + { 1.7441971e-01, 1.2337468e-01 }, { 1.7401503e-01, 1.2394480e-01 }, + { 1.7360849e-01, 1.2451360e-01 }, { 1.7320010e-01, 1.2508107e-01 }, + { 1.7278984e-01, 1.2564719e-01 }, { 1.7237774e-01, 1.2621197e-01 }, + { 1.7196379e-01, 1.2677540e-01 }, { 1.7154800e-01, 1.2733747e-01 }, + { 1.7113037e-01, 1.2789818e-01 }, { 1.7071091e-01, 1.2845751e-01 }, + { 1.7028962e-01, 1.2901548e-01 }, { 1.6986650e-01, 1.2957206e-01 }, + { 1.6944157e-01, 1.3012725e-01 }, { 1.6901482e-01, 1.3068105e-01 }, + { 1.6858627e-01, 1.3123344e-01 }, { 1.6815590e-01, 1.3178444e-01 }, + { 1.6772374e-01, 1.3233402e-01 }, { 1.6728978e-01, 1.3288219e-01 }, + { 1.6685403e-01, 1.3342893e-01 }, { 1.6641649e-01, 1.3397424e-01 }, + { 1.6597717e-01, 1.3451812e-01 }, { 1.6553608e-01, 1.3506056e-01 }, + { 1.6509321e-01, 1.3560155e-01 }, { 1.6464857e-01, 1.3614109e-01 }, + { 1.6420217e-01, 1.3667917e-01 }, { 1.6375401e-01, 1.3721579e-01 }, + { 1.6330409e-01, 1.3775093e-01 }, { 1.6285243e-01, 1.3828461e-01 }, + { 1.6239902e-01, 1.3881680e-01 }, { 1.6194388e-01, 1.3934750e-01 }, + { 1.6148700e-01, 1.3987672e-01 }, { 1.6102839e-01, 1.4040443e-01 }, + { 1.6056805e-01, 1.4093064e-01 }, { 1.6010600e-01, 1.4145535e-01 }, + { 1.5964223e-01, 1.4197853e-01 }, { 1.5917676e-01, 1.4250020e-01 }, + { 1.5870957e-01, 1.4302034e-01 }, { 1.5824069e-01, 1.4353895e-01 }, + { 1.5777011e-01, 1.4405602e-01 }, { 1.5729785e-01, 1.4457155e-01 }, + { 1.5682390e-01, 1.4508553e-01 }, { 1.5634827e-01, 1.4559796e-01 }, + { 1.5587096e-01, 1.4610883e-01 }, { 1.5539199e-01, 1.4661813e-01 }, + { 1.5491135e-01, 1.4712586e-01 }, { 1.5442905e-01, 1.4763202e-01 }, + { 1.5394510e-01, 1.4813660e-01 }, { 1.5345950e-01, 1.4863959e-01 }, + { 1.5297226e-01, 1.4914099e-01 }, { 1.5248338e-01, 1.4964079e-01 }, + { 1.5199287e-01, 1.5013899e-01 }, { 1.5150072e-01, 1.5063558e-01 }, + { 1.5100696e-01, 1.5113055e-01 }, { 1.5051158e-01, 1.5162391e-01 }, + { 1.5001459e-01, 1.5211565e-01 }, { 1.4951599e-01, 1.5260575e-01 }, + { 1.4901579e-01, 1.5309423e-01 }, { 1.4851399e-01, 1.5358106e-01 }, + { 1.4801060e-01, 1.5406625e-01 }, { 1.4750563e-01, 1.5454978e-01 }, + { 1.4699908e-01, 1.5503167e-01 }, { 1.4649095e-01, 1.5551189e-01 }, + { 1.4598126e-01, 1.5599045e-01 }, { 1.4547000e-01, 1.5646733e-01 }, + { 1.4495718e-01, 1.5694254e-01 }, { 1.4444281e-01, 1.5741607e-01 }, + { 1.4392690e-01, 1.5788792e-01 }, { 1.4340944e-01, 1.5835807e-01 }, + { 1.4289045e-01, 1.5882653e-01 }, { 1.4236993e-01, 1.5929328e-01 }, + { 1.4184788e-01, 1.5975834e-01 }, { 1.4132431e-01, 1.6022168e-01 }, + { 1.4079923e-01, 1.6068330e-01 }, { 1.4027264e-01, 1.6114320e-01 }, + { 1.3974455e-01, 1.6160138e-01 }, { 1.3921497e-01, 1.6205783e-01 }, + { 1.3868389e-01, 1.6251254e-01 }, { 1.3815133e-01, 1.6296551e-01 }, + { 1.3761729e-01, 1.6341673e-01 }, { 1.3708177e-01, 1.6386621e-01 }, + { 1.3654479e-01, 1.6431393e-01 }, { 1.3600634e-01, 1.6475989e-01 }, + { 1.3546644e-01, 1.6520409e-01 }, { 1.3492508e-01, 1.6564652e-01 }, + { 1.3438228e-01, 1.6608717e-01 }, { 1.3383805e-01, 1.6652605e-01 }, + { 1.3329238e-01, 1.6696314e-01 }, { 1.3274528e-01, 1.6739844e-01 }, + { 1.3219676e-01, 1.6783195e-01 }, { 1.3164682e-01, 1.6826366e-01 }, + { 1.3109548e-01, 1.6869358e-01 }, { 1.3054273e-01, 1.6912168e-01 }, + { 1.2998858e-01, 1.6954797e-01 }, { 1.2943304e-01, 1.6997245e-01 }, + { 1.2887611e-01, 1.7039511e-01 }, { 1.2831781e-01, 1.7081594e-01 }, + { 1.2775813e-01, 1.7123495e-01 }, { 1.2719708e-01, 1.7165212e-01 }, + { 1.2663467e-01, 1.7206745e-01 }, { 1.2607090e-01, 1.7248094e-01 }, + { 1.2550579e-01, 1.7289258e-01 }, { 1.2493933e-01, 1.7330237e-01 }, + { 1.2437153e-01, 1.7371030e-01 }, { 1.2380240e-01, 1.7411638e-01 }, + { 1.2323194e-01, 1.7452059e-01 }, { 1.2266016e-01, 1.7492293e-01 }, + { 1.2208708e-01, 1.7532339e-01 }, { 1.2151268e-01, 1.7572198e-01 }, + { 1.2093698e-01, 1.7611869e-01 }, { 1.2035999e-01, 1.7651351e-01 }, + { 1.1978170e-01, 1.7690644e-01 }, { 1.1920214e-01, 1.7729748e-01 }, + { 1.1862130e-01, 1.7768662e-01 }, { 1.1803918e-01, 1.7807385e-01 }, + { 1.1745581e-01, 1.7845918e-01 }, { 1.1687117e-01, 1.7884260e-01 }, + { 1.1628529e-01, 1.7922410e-01 }, { 1.1569816e-01, 1.7960368e-01 }, + { 1.1510979e-01, 1.7998134e-01 }, { 1.1452018e-01, 1.8035707e-01 }, + { 1.1392935e-01, 1.8073087e-01 }, { 1.1333730e-01, 1.8110274e-01 }, + { 1.1274404e-01, 1.8147266e-01 }, { 1.1214957e-01, 1.8184065e-01 }, + { 1.1155390e-01, 1.8220668e-01 }, { 1.1095703e-01, 1.8257076e-01 }, + { 1.1035898e-01, 1.8293289e-01 }, { 1.0975974e-01, 1.8329306e-01 }, + { 1.0915933e-01, 1.8365126e-01 }, { 1.0855775e-01, 1.8400750e-01 }, + { 1.0795501e-01, 1.8436177e-01 }, { 1.0735111e-01, 1.8471407e-01 }, + { 1.0674606e-01, 1.8506438e-01 }, { 1.0613987e-01, 1.8541272e-01 }, + { 1.0553254e-01, 1.8575906e-01 }, { 1.0492408e-01, 1.8610342e-01 }, + { 1.0431449e-01, 1.8644579e-01 }, { 1.0370379e-01, 1.8678616e-01 }, + { 1.0309198e-01, 1.8712453e-01 }, { 1.0247907e-01, 1.8746089e-01 }, + { 1.0186506e-01, 1.8779525e-01 }, { 1.0124995e-01, 1.8812760e-01 }, + { 1.0063377e-01, 1.8845793e-01 }, { 1.0001650e-01, 1.8878624e-01 }, + { 9.9398167e-02, 1.8911253e-01 }, { 9.8778766e-02, 1.8943680e-01 }, + { 9.8158308e-02, 1.8975904e-01 }, { 9.7536799e-02, 1.9007924e-01 }, + { 9.6914245e-02, 1.9039742e-01 }, { 9.6290653e-02, 1.9071355e-01 }, + { 9.5666030e-02, 1.9102763e-01 }, { 9.5040382e-02, 1.9133968e-01 }, + { 9.4413717e-02, 1.9164967e-01 }, { 9.3786040e-02, 1.9195761e-01 }, + { 9.3157359e-02, 1.9226350e-01 }, { 9.2527681e-02, 1.9256733e-01 }, + { 9.1897011e-02, 1.9286909e-01 }, { 9.1265358e-02, 1.9316879e-01 }, + { 9.0632727e-02, 1.9346642e-01 }, { 8.9999125e-02, 1.9376198e-01 }, + { 8.9364560e-02, 1.9405546e-01 }, { 8.8729037e-02, 1.9434687e-01 }, + { 8.8092565e-02, 1.9463619e-01 }, { 8.7455149e-02, 1.9492343e-01 }, + { 8.6816796e-02, 1.9520858e-01 }, { 8.6177514e-02, 1.9549164e-01 }, + { 8.5537309e-02, 1.9577261e-01 }, { 8.4896187e-02, 1.9605148e-01 }, + { 8.4254157e-02, 1.9632825e-01 }, { 8.3611224e-02, 1.9660292e-01 }, + { 8.2967396e-02, 1.9687549e-01 }, { 8.2322680e-02, 1.9714594e-01 }, + { 8.1677081e-02, 1.9741429e-01 }, { 8.1030608e-02, 1.9768052e-01 }, + { 8.0383268e-02, 1.9794463e-01 }, { 7.9735066e-02, 1.9820662e-01 }, + { 7.9086011e-02, 1.9846649e-01 }, { 7.8436108e-02, 1.9872424e-01 }, + { 7.7785366e-02, 1.9897986e-01 }, { 7.7133791e-02, 1.9923334e-01 }, + { 7.6481389e-02, 1.9948470e-01 }, { 7.5828169e-02, 1.9973391e-01 }, + { 7.5174136e-02, 1.9998099e-01 }, { 7.4519298e-02, 2.0022592e-01 }, + { 7.3863663e-02, 2.0046872e-01 }, { 7.3207236e-02, 2.0070936e-01 }, + { 7.2550025e-02, 2.0094785e-01 }, { 7.1892038e-02, 2.0118420e-01 }, + { 7.1233280e-02, 2.0141839e-01 }, { 7.0573760e-02, 2.0165042e-01 }, + { 6.9913484e-02, 2.0188029e-01 }, { 6.9252459e-02, 2.0210800e-01 }, + { 6.8590692e-02, 2.0233354e-01 }, { 6.7928191e-02, 2.0255692e-01 }, + { 6.7264963e-02, 2.0277813e-01 }, { 6.6601014e-02, 2.0299717e-01 }, + { 6.5936352e-02, 2.0321403e-01 }, { 6.5270983e-02, 2.0342872e-01 }, + { 6.4604916e-02, 2.0364123e-01 }, { 6.3938157e-02, 2.0385156e-01 }, + { 6.3270713e-02, 2.0405971e-01 }, { 6.2602592e-02, 2.0426567e-01 }, + { 6.1933800e-02, 2.0446944e-01 }, { 6.1264345e-02, 2.0467102e-01 }, + { 6.0594234e-02, 2.0487041e-01 }, { 5.9923474e-02, 2.0506761e-01 }, + { 5.9252072e-02, 2.0526261e-01 }, { 5.8580035e-02, 2.0545541e-01 }, + { 5.7907372e-02, 2.0564601e-01 }, { 5.7234088e-02, 2.0583441e-01 }, + { 5.6560191e-02, 2.0602061e-01 }, { 5.5885688e-02, 2.0620460e-01 }, + { 5.5210587e-02, 2.0638638e-01 }, { 5.4534895e-02, 2.0656595e-01 }, + { 5.3858619e-02, 2.0674331e-01 }, { 5.3181766e-02, 2.0691845e-01 }, + { 5.2504343e-02, 2.0709138e-01 }, { 5.1826358e-02, 2.0726209e-01 }, + { 5.1147818e-02, 2.0743058e-01 }, { 5.0468731e-02, 2.0759685e-01 }, + { 4.9789103e-02, 2.0776090e-01 }, { 4.9108941e-02, 2.0792272e-01 }, + { 4.8428254e-02, 2.0808232e-01 }, { 4.7747048e-02, 2.0823968e-01 }, + { 4.7065331e-02, 2.0839482e-01 }, { 4.6383110e-02, 2.0854773e-01 }, + { 4.5700392e-02, 2.0869840e-01 }, { 4.5017184e-02, 2.0884683e-01 }, + { 4.4333495e-02, 2.0899303e-01 }, { 4.3649330e-02, 2.0913699e-01 }, + { 4.2964699e-02, 2.0927872e-01 }, { 4.2279607e-02, 2.0941820e-01 }, + { 4.1594062e-02, 2.0955544e-01 }, { 4.0908072e-02, 2.0969043e-01 }, + { 4.0221644e-02, 2.0982318e-01 }, { 3.9534785e-02, 2.0995368e-01 }, + { 3.8847503e-02, 2.1008193e-01 }, { 3.8159805e-02, 2.1020793e-01 }, + { 3.7471698e-02, 2.1033169e-01 }, { 3.6783189e-02, 2.1045319e-01 }, + { 3.6094287e-02, 2.1057243e-01 }, { 3.5404998e-02, 2.1068942e-01 }, + { 3.4715331e-02, 2.1080416e-01 }, { 3.4025291e-02, 2.1091663e-01 }, + { 3.3334887e-02, 2.1102685e-01 }, { 3.2644126e-02, 2.1113481e-01 }, + { 3.1953015e-02, 2.1124051e-01 }, { 3.1261563e-02, 2.1134394e-01 }, + { 3.0569775e-02, 2.1144511e-01 }, { 2.9877660e-02, 2.1154402e-01 }, + { 2.9185225e-02, 2.1164066e-01 }, { 2.8492478e-02, 2.1173504e-01 }, + { 2.7799425e-02, 2.1182714e-01 }, { 2.7106075e-02, 2.1191698e-01 }, + { 2.6412434e-02, 2.1200455e-01 }, { 2.5718511e-02, 2.1208985e-01 }, + { 2.5024312e-02, 2.1217288e-01 }, { 2.4329845e-02, 2.1225363e-01 }, + { 2.3635117e-02, 2.1233212e-01 }, { 2.2940137e-02, 2.1240833e-01 }, + { 2.2244911e-02, 2.1248226e-01 }, { 2.1549446e-02, 2.1255392e-01 }, + { 2.0853751e-02, 2.1262330e-01 }, { 2.0157832e-02, 2.1269040e-01 }, + { 1.9461698e-02, 2.1275523e-01 }, { 1.8765355e-02, 2.1281778e-01 }, + { 1.8068811e-02, 2.1287805e-01 }, { 1.7372074e-02, 2.1293604e-01 }, + { 1.6675151e-02, 2.1299175e-01 }, { 1.5978049e-02, 2.1304518e-01 }, + { 1.5280776e-02, 2.1309633e-01 }, { 1.4583339e-02, 2.1314519e-01 }, + { 1.3885746e-02, 2.1319177e-01 }, { 1.3188005e-02, 2.1323607e-01 }, + { 1.2490122e-02, 2.1327809e-01 }, { 1.1792105e-02, 2.1331782e-01 }, + { 1.1093963e-02, 2.1335527e-01 }, { 1.0395701e-02, 2.1339043e-01 }, + { 9.6973279e-03, 2.1342331e-01 }, { 8.9988511e-03, 2.1345390e-01 }, + { 8.3002779e-03, 2.1348220e-01 }, { 7.6016158e-03, 2.1350822e-01 }, + { 6.9028723e-03, 2.1353196e-01 }, { 6.2040549e-03, 2.1355340e-01 }, + { 5.5051711e-03, 2.1357256e-01 }, { 4.8062283e-03, 2.1358943e-01 }, + { 4.1072340e-03, 2.1360402e-01 }, { 3.4081957e-03, 2.1361632e-01 }, + { 2.7091210e-03, 2.1362633e-01 }, { 2.0100172e-03, 2.1363405e-01 }, + { 1.3108919e-03, 2.1363948e-01 }, { 6.1175255e-04, 2.1364263e-01 }, + } +}; + +#endif /* LC3_PLUS_HR */ + +const struct lc3_mdct_rot_def * lc3_mdct_rot[LC3_NUM_DT][LC3_NUM_SRATE] = { + + [LC3_DT_2M5] = { + LC3_IF_PLUS(&mdct_rot_40, NULL), + LC3_IF_PLUS(&mdct_rot_80, NULL), &mdct_rot_120, + &mdct_rot_160, &mdct_rot_240, &mdct_rot_240, &mdct_rot_480 }, + + [LC3_DT_5M ] = { + LC3_IF_PLUS(&mdct_rot_80, NULL), &mdct_rot_160, &mdct_rot_240, + &mdct_rot_320, &mdct_rot_480, &mdct_rot_480, &mdct_rot_960 }, + + [LC3_DT_7M5] = { + &mdct_rot_120, &mdct_rot_240, &mdct_rot_360, + &mdct_rot_480, &mdct_rot_720 }, + + [LC3_DT_10M] = { + &mdct_rot_160, &mdct_rot_320, &mdct_rot_480, + &mdct_rot_640, &mdct_rot_960, &mdct_rot_960, + LC3_IF_PLUS_HR(&mdct_rot_1920, NULL) }, + +}; + + +/** + * Low delay MDCT windows + */ + +#define __LC3_MDCT_WIN_LEN(_dt_us, _sr_hz) \ + ( LC3_NS(_dt_us, _sr_hz) + LC3_ND(_dt_us, _sr_hz) ) + +#if LC3_PLUS + +static const float mdct_win_2m5_8k[__LC3_MDCT_WIN_LEN(2500, 8000)] = { + 6.73791440e-03, 2.73228958e-02, 6.16356097e-02, 1.11912504e-01, + 1.78705350e-01, 2.60752499e-01, 3.54977638e-01, 4.56769675e-01, + 5.60523927e-01, 6.60366535e-01, 7.50943422e-01, 8.28138232e-01, + 8.89585018e-01, 9.34874773e-01, 9.65405703e-01, 9.83902633e-01, + 9.93718088e-01, 9.98098731e-01, 9.99626637e-01, 9.99977291e-01, + 9.99977291e-01, 9.99626637e-01, 9.98098731e-01, 9.93718088e-01, + 9.83902633e-01, 9.65405703e-01, 9.34874773e-01, 8.89585018e-01, + 8.28138232e-01, 7.50943422e-01, 6.60366535e-01, 5.60523927e-01, + 4.56769675e-01, 3.54977638e-01, 2.60752499e-01, 1.78705350e-01, + 1.11912504e-01, 6.16356097e-02, 2.73228958e-02, 6.73791440e-03, +}; + +static const float mdct_win_2m5_16k[__LC3_MDCT_WIN_LEN(2500, 16000)] = { + 4.76441615e-03, 1.20463628e-02, 2.22639654e-02, 3.58022311e-02, + 5.29905465e-02, 7.40851840e-02, 9.92538592e-02, 1.28563118e-01, + 1.61969244e-01, 1.99313241e-01, 2.40320282e-01, 2.84603818e-01, + 3.31674323e-01, 3.80952458e-01, 4.31786202e-01, 4.83471316e-01, + 5.35274327e-01, 5.86457098e-01, 6.36301916e-01, 6.84136019e-01, + 7.29354445e-01, 7.71440129e-01, 8.09980291e-01, 8.44678279e-01, + 8.75360204e-01, 9.01975984e-01, 9.24594627e-01, 9.43393949e-01, + 9.58645225e-01, 9.70693650e-01, 9.79935831e-01, 9.86795807e-01, + 9.91701328e-01, 9.95062145e-01, 9.97251917e-01, 9.98595014e-01, + 9.99358895e-01, 9.99752127e-01, 9.99927440e-01, 9.99988650e-01, + 9.99988650e-01, 9.99927440e-01, 9.99752127e-01, 9.99358895e-01, + 9.98595014e-01, 9.97251917e-01, 9.95062145e-01, 9.91701328e-01, + 9.86795807e-01, 9.79935831e-01, 9.70693650e-01, 9.58645225e-01, + 9.43393949e-01, 9.24594627e-01, 9.01975984e-01, 8.75360204e-01, + 8.44678279e-01, 8.09980291e-01, 7.71440129e-01, 7.29354445e-01, + 6.84136019e-01, 6.36301916e-01, 5.86457098e-01, 5.35274327e-01, + 4.83471316e-01, 4.31786202e-01, 3.80952458e-01, 3.31674323e-01, + 2.84603818e-01, 2.40320282e-01, 1.99313241e-01, 1.61969244e-01, + 1.28563118e-01, 9.92538592e-02, 7.40851840e-02, 5.29905465e-02, + 3.58022311e-02, 2.22639654e-02, 1.20463628e-02, 4.76441615e-03, +}; + +static const float mdct_win_2m5_24k[__LC3_MDCT_WIN_LEN(2500, 24000)] = { + 3.89013421e-03, 8.20259508e-03, 1.37023556e-02, 2.05296853e-02, + 2.88030773e-02, 3.86278514e-02, 5.00956972e-02, 6.32829654e-02, + 7.82488109e-02, 9.50334651e-02, 1.13656749e-01, 1.34116888e-01, + 1.56389671e-01, 1.80427981e-01, 2.06161727e-01, 2.33498181e-01, + 2.62322720e-01, 2.92499991e-01, 3.23875450e-01, 3.56277288e-01, + 3.89518694e-01, 4.23400416e-01, 4.57713594e-01, 4.92242792e-01, + 5.26769190e-01, 5.61073868e-01, 5.94941120e-01, 6.28161737e-01, + 6.60536189e-01, 6.91877646e-01, 7.22014766e-01, 7.50794208e-01, + 7.78082793e-01, 8.03769285e-01, 8.27765737e-01, 8.50008365e-01, + 8.70457945e-01, 8.89099694e-01, 9.05942652e-01, 9.21018560e-01, + 9.34380273e-01, 9.46099727e-01, 9.56265526e-01, 9.64980202e-01, + 9.72357239e-01, 9.78517931e-01, 9.83588198e-01, 9.87695434e-01, + 9.90965519e-01, 9.93520077e-01, 9.95474078e-01, 9.96933861e-01, + 9.97995624e-01, 9.98744422e-01, 9.99253666e-01, 9.99585105e-01, + 9.99789244e-01, 9.99906118e-01, 9.99966358e-01, 9.99992433e-01, + 9.99992433e-01, 9.99966358e-01, 9.99906118e-01, 9.99789244e-01, + 9.99585105e-01, 9.99253666e-01, 9.98744422e-01, 9.97995624e-01, + 9.96933861e-01, 9.95474078e-01, 9.93520077e-01, 9.90965519e-01, + 9.87695434e-01, 9.83588198e-01, 9.78517931e-01, 9.72357239e-01, + 9.64980202e-01, 9.56265526e-01, 9.46099727e-01, 9.34380273e-01, + 9.21018560e-01, 9.05942652e-01, 8.89099694e-01, 8.70457945e-01, + 8.50008365e-01, 8.27765737e-01, 8.03769285e-01, 7.78082793e-01, + 7.50794208e-01, 7.22014766e-01, 6.91877646e-01, 6.60536189e-01, + 6.28161737e-01, 5.94941120e-01, 5.61073868e-01, 5.26769190e-01, + 4.92242792e-01, 4.57713594e-01, 4.23400416e-01, 3.89518694e-01, + 3.56277288e-01, 3.23875450e-01, 2.92499991e-01, 2.62322720e-01, + 2.33498181e-01, 2.06161727e-01, 1.80427981e-01, 1.56389671e-01, + 1.34116888e-01, 1.13656749e-01, 9.50334651e-02, 7.82488109e-02, + 6.32829654e-02, 5.00956972e-02, 3.86278514e-02, 2.88030773e-02, + 2.05296853e-02, 1.37023556e-02, 8.20259508e-03, 3.89013421e-03, +}; + +static const float mdct_win_2m5_32k[__LC3_MDCT_WIN_LEN(2500, 32000)] = { + 3.36895835e-03, 6.45555741e-03, 1.01430808e-02, 1.45212685e-02, + 1.96507673e-02, 2.55835280e-02, 3.23662853e-02, 4.00411787e-02, + 4.86456418e-02, 5.82120708e-02, 6.87674290e-02, 8.03328498e-02, + 9.29232660e-02, 1.06547081e-01, 1.21205893e-01, 1.36894275e-01, + 1.53599623e-01, 1.71302066e-01, 1.89974455e-01, 2.09582413e-01, + 2.30084468e-01, 2.51432255e-01, 2.73570790e-01, 2.96438816e-01, + 3.19969212e-01, 3.44089476e-01, 3.68722258e-01, 3.93785956e-01, + 4.19195353e-01, 4.44862309e-01, 4.70696475e-01, 4.96606050e-01, + 5.22498546e-01, 5.48281575e-01, 5.73863636e-01, 5.99154896e-01, + 6.24067964e-01, 6.48518633e-01, 6.72426605e-01, 6.95716161e-01, + 7.18316799e-01, 7.40163807e-01, 7.61198780e-01, 7.81370064e-01, + 8.00633131e-01, 8.18950870e-01, 8.36293796e-01, 8.52640176e-01, + 8.67976054e-01, 8.82295205e-01, 8.95598976e-01, 9.07896060e-01, + 9.19202165e-01, 9.29539615e-01, 9.38936863e-01, 9.47427941e-01, + 9.55051846e-01, 9.61851871e-01, 9.67874900e-01, 9.73170662e-01, + 9.77790986e-01, 9.81789034e-01, 9.85218555e-01, 9.88133167e-01, + 9.90585664e-01, 9.92627388e-01, 9.94307658e-01, 9.95673273e-01, + 9.96768094e-01, 9.97632718e-01, 9.98304240e-01, 9.98816100e-01, + 9.99198030e-01, 9.99476075e-01, 9.99672688e-01, 9.99806905e-01, + 9.99894561e-01, 9.99948558e-01, 9.99979163e-01, 9.99994325e-01, + 9.99994325e-01, 9.99979163e-01, 9.99948558e-01, 9.99894561e-01, + 9.99806905e-01, 9.99672688e-01, 9.99476075e-01, 9.99198030e-01, + 9.98816100e-01, 9.98304240e-01, 9.97632718e-01, 9.96768094e-01, + 9.95673273e-01, 9.94307658e-01, 9.92627388e-01, 9.90585664e-01, + 9.88133167e-01, 9.85218555e-01, 9.81789034e-01, 9.77790986e-01, + 9.73170662e-01, 9.67874900e-01, 9.61851871e-01, 9.55051846e-01, + 9.47427941e-01, 9.38936863e-01, 9.29539615e-01, 9.19202165e-01, + 9.07896060e-01, 8.95598976e-01, 8.82295205e-01, 8.67976054e-01, + 8.52640176e-01, 8.36293796e-01, 8.18950870e-01, 8.00633131e-01, + 7.81370064e-01, 7.61198780e-01, 7.40163807e-01, 7.18316799e-01, + 6.95716161e-01, 6.72426605e-01, 6.48518633e-01, 6.24067964e-01, + 5.99154896e-01, 5.73863636e-01, 5.48281575e-01, 5.22498546e-01, + 4.96606050e-01, 4.70696475e-01, 4.44862309e-01, 4.19195353e-01, + 3.93785956e-01, 3.68722258e-01, 3.44089476e-01, 3.19969212e-01, + 2.96438816e-01, 2.73570790e-01, 2.51432255e-01, 2.30084468e-01, + 2.09582413e-01, 1.89974455e-01, 1.71302066e-01, 1.53599623e-01, + 1.36894275e-01, 1.21205893e-01, 1.06547081e-01, 9.29232660e-02, + 8.03328498e-02, 6.87674290e-02, 5.82120708e-02, 4.86456418e-02, + 4.00411787e-02, 3.23662853e-02, 2.55835280e-02, 1.96507673e-02, + 1.45212685e-02, 1.01430808e-02, 6.45555741e-03, 3.36895835e-03, +}; + +static const float mdct_win_2m5_48k[__LC3_MDCT_WIN_LEN(2500, 48000)] = { + 2.75074638e-03, 4.77524515e-03, 6.99126548e-03, 9.47011816e-03, + 1.22441576e-02, 1.53355947e-02, 1.87626677e-02, 2.25415434e-02, + 2.66870142e-02, 3.12127707e-02, 3.61315008e-02, 4.14549100e-02, + 4.71937052e-02, 5.33575588e-02, 5.99550649e-02, 6.69936920e-02, + 7.44797342e-02, 8.24182658e-02, 9.08130967e-02, 9.96667332e-02, + 1.08980342e-01, 1.18753719e-01, 1.28985265e-01, 1.39671964e-01, + 1.50809372e-01, 1.62391604e-01, 1.74411338e-01, 1.86859813e-01, + 1.99726844e-01, 2.13000841e-01, 2.26668825e-01, 2.40716465e-01, + 2.55128110e-01, 2.69886836e-01, 2.84974488e-01, 3.00371741e-01, + 3.16058154e-01, 3.32012241e-01, 3.48211540e-01, 3.64632687e-01, + 3.81251499e-01, 3.98043054e-01, 4.14981787e-01, 4.32041576e-01, + 4.49195839e-01, 4.66417630e-01, 4.83679744e-01, 5.00954812e-01, + 5.18215407e-01, 5.35434150e-01, 5.52583807e-01, 5.69637402e-01, + 5.86568309e-01, 6.03350364e-01, 6.19957957e-01, 6.36366131e-01, + 6.52550680e-01, 6.68488237e-01, 6.84156362e-01, 6.99533624e-01, + 7.14599684e-01, 7.29335364e-01, 7.43722715e-01, 7.57745082e-01, + 7.71387158e-01, 7.84635031e-01, 7.97476230e-01, 8.09899758e-01, + 8.21896119e-01, 8.33457339e-01, 8.44576978e-01, 8.55250134e-01, + 8.65473441e-01, 8.75245054e-01, 8.84564635e-01, 8.93433321e-01, + 9.01853689e-01, 9.09829718e-01, 9.17366735e-01, 9.24471360e-01, + 9.31151439e-01, 9.37415982e-01, 9.43275077e-01, 9.48739819e-01, + 9.53822215e-01, 9.58535102e-01, 9.62892048e-01, 9.66907259e-01, + 9.70595479e-01, 9.73971891e-01, 9.77052016e-01, 9.79851615e-01, + 9.82386589e-01, 9.84672882e-01, 9.86726389e-01, 9.88562863e-01, + 9.90197830e-01, 9.91646510e-01, 9.92923740e-01, 9.94043905e-01, + 9.95020875e-01, 9.95867954e-01, 9.96597827e-01, 9.97222527e-01, + 9.97753399e-01, 9.98201077e-01, 9.98575471e-01, 9.98885756e-01, + 9.99140376e-01, 9.99347044e-01, 9.99512763e-01, 9.99643838e-01, + 9.99745907e-01, 9.99823966e-01, 9.99882403e-01, 9.99925037e-01, + 9.99955157e-01, 9.99975561e-01, 9.99988598e-01, 9.99996217e-01, + 9.99996217e-01, 9.99988598e-01, 9.99975561e-01, 9.99955157e-01, + 9.99925037e-01, 9.99882403e-01, 9.99823966e-01, 9.99745907e-01, + 9.99643838e-01, 9.99512763e-01, 9.99347044e-01, 9.99140376e-01, + 9.98885756e-01, 9.98575471e-01, 9.98201077e-01, 9.97753399e-01, + 9.97222527e-01, 9.96597827e-01, 9.95867954e-01, 9.95020875e-01, + 9.94043905e-01, 9.92923740e-01, 9.91646510e-01, 9.90197830e-01, + 9.88562863e-01, 9.86726389e-01, 9.84672882e-01, 9.82386589e-01, + 9.79851615e-01, 9.77052016e-01, 9.73971891e-01, 9.70595479e-01, + 9.66907259e-01, 9.62892048e-01, 9.58535102e-01, 9.53822215e-01, + 9.48739819e-01, 9.43275077e-01, 9.37415982e-01, 9.31151439e-01, + 9.24471360e-01, 9.17366735e-01, 9.09829718e-01, 9.01853689e-01, + 8.93433321e-01, 8.84564635e-01, 8.75245054e-01, 8.65473441e-01, + 8.55250134e-01, 8.44576978e-01, 8.33457339e-01, 8.21896119e-01, + 8.09899758e-01, 7.97476230e-01, 7.84635031e-01, 7.71387158e-01, + 7.57745082e-01, 7.43722715e-01, 7.29335364e-01, 7.14599684e-01, + 6.99533624e-01, 6.84156362e-01, 6.68488237e-01, 6.52550680e-01, + 6.36366131e-01, 6.19957957e-01, 6.03350364e-01, 5.86568309e-01, + 5.69637402e-01, 5.52583807e-01, 5.35434150e-01, 5.18215407e-01, + 5.00954812e-01, 4.83679744e-01, 4.66417630e-01, 4.49195839e-01, + 4.32041576e-01, 4.14981787e-01, 3.98043054e-01, 3.81251499e-01, + 3.64632687e-01, 3.48211540e-01, 3.32012241e-01, 3.16058154e-01, + 3.00371741e-01, 2.84974488e-01, 2.69886836e-01, 2.55128110e-01, + 2.40716465e-01, 2.26668825e-01, 2.13000841e-01, 1.99726844e-01, + 1.86859813e-01, 1.74411338e-01, 1.62391604e-01, 1.50809372e-01, + 1.39671964e-01, 1.28985265e-01, 1.18753719e-01, 1.08980342e-01, + 9.96667332e-02, 9.08130967e-02, 8.24182658e-02, 7.44797342e-02, + 6.69936920e-02, 5.99550649e-02, 5.33575588e-02, 4.71937052e-02, + 4.14549100e-02, 3.61315008e-02, 3.12127707e-02, 2.66870142e-02, + 2.25415434e-02, 1.87626677e-02, 1.53355947e-02, 1.22441576e-02, + 9.47011816e-03, 6.99126548e-03, 4.77524515e-03, 2.75074638e-03, +}; + +#if LC3_PLUS_HR + +static const float mdct_win_2m5_48k_hr[__LC3_MDCT_WIN_LEN(2500, 48000)] = { + 1.92887526e-07, 1.26862312e-06, 3.73694297e-06, 8.64938647e-06, + 1.75249988e-05, 3.25100409e-05, 5.65499504e-05, 9.35865319e-05, + 1.48780979e-04, 2.28761899e-04, 3.41896375e-04, 4.98580979e-04, + 7.11548259e-04, 9.96182440e-04, 1.37083745e-03, 1.85714674e-03, + 2.48031598e-03, 3.26938415e-03, 4.25744150e-03, 5.48178842e-03, + 6.98402245e-03, 8.81003775e-03, 1.10099232e-02, 1.36377569e-02, + 1.67512707e-02, 2.04114113e-02, 2.46817525e-02, 2.96278261e-02, + 3.53163108e-02, 4.18141559e-02, 4.91876006e-02, 5.75011559e-02, + 6.68165460e-02, 7.71916136e-02, 8.86792317e-02, 1.01326235e-01, + 1.15172401e-01, 1.30249396e-01, 1.46579877e-01, 1.64176553e-01, + 1.83041364e-01, 2.03164726e-01, 2.24524856e-01, 2.47087196e-01, + 2.70803988e-01, 2.95613915e-01, 3.21442008e-01, 3.48199695e-01, + 3.75785023e-01, 4.04083431e-01, 4.32968378e-01, 4.62302625e-01, + 4.91939783e-01, 5.21726012e-01, 5.51502347e-01, 5.81106782e-01, + 6.10377192e-01, 6.39154077e-01, 6.67283058e-01, 6.94617987e-01, + 7.21023440e-01, 7.46377110e-01, 7.70571768e-01, 7.93517113e-01, + 8.15140784e-01, 8.35389018e-01, 8.54227006e-01, 8.71638596e-01, + 8.87625158e-01, 9.02204990e-01, 9.15411413e-01, 9.27291155e-01, + 9.37902570e-01, 9.47313428e-01, 9.55598950e-01, 9.62839723e-01, + 9.69119847e-01, 9.74524975e-01, 9.79140759e-01, 9.83051181e-01, + 9.86337543e-01, 9.89076972e-01, 9.91342008e-01, 9.93199587e-01, + 9.94710743e-01, 9.95930433e-01, 9.96907234e-01, 9.97683644e-01, + 9.98296261e-01, 9.98776138e-01, 9.99149203e-01, 9.99436796e-01, + 9.99656200e-01, 9.99821365e-01, 9.99943137e-01, 1.00003016e+00, + 1.00008917e+00, 1.00012529e+00, 1.00014281e+00, 1.00014508e+00, + 1.00013494e+00, 1.00011492e+00, 1.00008726e+00, 1.00005412e+00, + 1.00001764e+00, 9.99979734e-01, 9.99942362e-01, 9.99907196e-01, + 9.99876022e-01, 9.99850094e-01, 9.99830663e-01, 9.99818563e-01, + 9.99814391e-01, 9.99818325e-01, 9.99830186e-01, 9.99849498e-01, + 9.99875486e-01, 9.99906898e-01, 9.99942422e-01, 9.99980509e-01, + 1.00001943e+00, 1.00005758e+00, 1.00009310e+00, 1.00012457e+00, + 1.00015044e+00, 1.00016987e+00, 1.00018167e+00, 1.00018561e+00, + 1.00018144e+00, 1.00016928e+00, 1.00014985e+00, 1.00012374e+00, + 1.00009227e+00, 1.00005662e+00, 1.00001836e+00, 9.99978960e-01, + 9.99939740e-01, 9.99902129e-01, 9.99867082e-01, 9.99835134e-01, + 9.99806285e-01, 9.99779761e-01, 9.99753773e-01, 9.99725282e-01, + 9.99689877e-01, 9.99641180e-01, 9.99570787e-01, 9.99467850e-01, + 9.99318600e-01, 9.99105930e-01, 9.98809040e-01, 9.98403072e-01, + 9.97858584e-01, 9.97141182e-01, 9.96211350e-01, 9.95023966e-01, + 9.93528485e-01, 9.91668522e-01, 9.89382327e-01, 9.86602664e-01, + 9.83257711e-01, 9.79271173e-01, 9.74563420e-01, 9.69052374e-01, + 9.62654769e-01, 9.55287457e-01, 9.46869195e-01, 9.37322080e-01, + 9.26573634e-01, 9.14558887e-01, 9.01221931e-01, 8.86518419e-01, + 8.70416999e-01, 8.52901220e-01, 8.33971083e-01, 8.13643873e-01, + 7.91955233e-01, 7.68959403e-01, 7.44728804e-01, 7.19353676e-01, + 6.92940772e-01, 6.65611804e-01, 6.37501359e-01, 6.08754635e-01, + 5.79524696e-01, 5.49970031e-01, 5.20251453e-01, 4.90529478e-01, + 4.60961968e-01, 4.31701392e-01, 4.02893007e-01, 3.74672860e-01, + 3.47166419e-01, 3.20487350e-01, 2.94736743e-01, 2.70002425e-01, + 2.46358722e-01, 2.23866433e-01, 2.02572897e-01, 1.82512373e-01, + 1.63706377e-01, 1.46164373e-01, 1.29884347e-01, 1.14853561e-01, + 1.01049446e-01, 8.84404257e-02, 7.69868940e-02, 6.66421950e-02, + 5.73536530e-02, 4.90636751e-02, 4.17107828e-02, 3.52307148e-02, + 2.95574907e-02, 2.46244166e-02, 2.03650557e-02, 1.67141166e-02, + 1.36082442e-02, 1.09867034e-02, 8.79194960e-03, 6.97008055e-03, + 5.47116203e-03, 4.24943818e-03, 3.26343346e-03, 2.47595203e-03, + 1.85399409e-03, 1.36859657e-03, 9.94618051e-04, 7.10477470e-04, + 4.97864152e-04, 3.41428356e-04, 2.28464938e-04, 1.48598730e-04, + 9.34789787e-05, 5.64894217e-05, 3.24779357e-05, 1.75092246e-05, + 8.64240701e-06, 3.73430225e-06, 1.26786131e-06, 1.92776696e-07, +}; + +static const float mdct_win_2m5_96k_hr[__LC3_MDCT_WIN_LEN(2500, 96000)] = { + 1.36335345e-07, 4.57767612e-07, 9.97567554e-07, 1.84077624e-06, + 3.09224833e-06, 4.88094383e-06, 7.36381799e-06, 1.07300075e-05, + 1.52053863e-05, 2.10575054e-05, 2.86009363e-05, 3.82030121e-05, + 5.02899893e-05, 6.53535899e-05, 8.39579952e-05, 1.06747175e-04, + 1.34452668e-04, 1.67901671e-04, 2.08025551e-04, 2.55868625e-04, + 3.12597229e-04, 3.79509147e-04, 4.58043127e-04, 5.49788703e-04, + 6.56496093e-04, 7.80086033e-04, 9.22659819e-04, 1.08650920e-03, + 1.27412600e-03, 1.48821168e-03, 1.73168664e-03, 2.00769864e-03, + 2.31963093e-03, 2.67111068e-03, 3.06601473e-03, 3.50847607e-03, + 4.00288915e-03, 4.55391267e-03, 5.16647473e-03, 5.84577024e-03, + 6.59726607e-03, 7.42669497e-03, 8.34005512e-03, 9.34360363e-03, + 1.04438523e-02, 1.16475578e-02, 1.29617099e-02, 1.43935224e-02, + 1.59504171e-02, 1.76400058e-02, 1.94700807e-02, 2.14485861e-02, + 2.35835947e-02, 2.58832965e-02, 2.83559617e-02, 3.10099237e-02, + 3.38535421e-02, 3.68951820e-02, 4.01431806e-02, 4.36058082e-02, + 4.72912528e-02, 5.12075722e-02, 5.53626679e-02, 5.97642474e-02, + 6.44197986e-02, 6.93365484e-02, 7.45214298e-02, 7.99810365e-02, + 8.57216269e-02, 9.17490497e-02, 9.80687290e-02, 1.04685634e-01, + 1.11604236e-01, 1.18828513e-01, 1.26361862e-01, 1.34207115e-01, + 1.42366499e-01, 1.50841609e-01, 1.59633383e-01, 1.68742076e-01, + 1.78167209e-01, 1.87907621e-01, 1.97961360e-01, 2.08325714e-01, + 2.18997195e-01, 2.29971498e-01, 2.41243511e-01, 2.52807260e-01, + 2.64655977e-01, 2.76782036e-01, 2.89176911e-01, 3.01831275e-01, + 3.14734906e-01, 3.27876776e-01, 3.41245025e-01, 3.54826927e-01, + 3.68608981e-01, 3.82576853e-01, 3.96715522e-01, 4.11009163e-01, + 4.25441355e-01, 4.39994961e-01, 4.54652220e-01, 4.69394863e-01, + 4.84204173e-01, 4.99060899e-01, 5.13945460e-01, 5.28838038e-01, + 5.43718576e-01, 5.58566749e-01, 5.73362410e-01, 5.88085234e-01, + 6.02715075e-01, 6.17232025e-01, 6.31616414e-01, 6.45848989e-01, + 6.59910858e-01, 6.73783839e-01, 6.87450290e-01, 7.00893283e-01, + 7.14096606e-01, 7.27045000e-01, 7.39724100e-01, 7.52120554e-01, + 7.64221907e-01, 7.76016891e-01, 7.87495315e-01, 7.98648119e-01, + 8.09467375e-01, 8.19946468e-01, 8.30079675e-01, 8.39862764e-01, + 8.49292517e-01, 8.58366787e-01, 8.67084682e-01, 8.75446379e-01, + 8.83453131e-01, 8.91107082e-01, 8.98411512e-01, 9.05370474e-01, + 9.11989033e-01, 9.18272913e-01, 9.24228728e-01, 9.29863691e-01, + 9.35185611e-01, 9.40202892e-01, 9.44924474e-01, 9.49359715e-01, + 9.53518271e-01, 9.57410157e-01, 9.61045623e-01, 9.64435160e-01, + 9.67589259e-01, 9.70518589e-01, 9.73233819e-01, 9.75745618e-01, + 9.78064537e-01, 9.80201006e-01, 9.82165277e-01, 9.83967602e-01, + 9.85617757e-01, 9.87125397e-01, 9.88499880e-01, 9.89750206e-01, + 9.90885139e-01, 9.91913080e-01, 9.92841959e-01, 9.93679583e-01, + 9.94433045e-01, 9.95109439e-01, 9.95715141e-01, 9.96256351e-01, + 9.96738791e-01, 9.97167945e-01, 9.97548699e-01, 9.97885823e-01, + 9.98183608e-01, 9.98446047e-01, 9.98676717e-01, 9.98879075e-01, + 9.99056041e-01, 9.99210536e-01, 9.99344945e-01, 9.99461591e-01, + 9.99562562e-01, 9.99649644e-01, 9.99724448e-01, 9.99788404e-01, + 9.99842882e-01, 9.99888957e-01, 9.99927700e-01, 9.99959946e-01, + 9.99986470e-01, 1.00000799e+00, 1.00002515e+00, 1.00003839e+00, + 1.00004816e+00, 1.00005496e+00, 1.00005913e+00, 1.00006092e+00, + 1.00006080e+00, 1.00005877e+00, 1.00005519e+00, 1.00005031e+00, + 1.00004435e+00, 1.00003731e+00, 1.00002968e+00, 1.00002134e+00, + 1.00001252e+00, 1.00000334e+00, 9.99994040e-01, 9.99984682e-01, + 9.99975443e-01, 9.99966383e-01, 9.99957621e-01, 9.99949336e-01, + 9.99941528e-01, 9.99934316e-01, 9.99927878e-01, 9.99922156e-01, + 9.99917269e-01, 9.99913335e-01, 9.99910295e-01, 9.99908268e-01, + 9.99907196e-01, 9.99907196e-01, 9.99908149e-01, 9.99910176e-01, + 9.99913156e-01, 9.99917090e-01, 9.99921918e-01, 9.99927640e-01, + 9.99934137e-01, 9.99941349e-01, 9.99949217e-01, 9.99957681e-01, + 9.99966562e-01, 9.99975860e-01, 9.99985397e-01, 9.99995112e-01, + 1.00000489e+00, 1.00001454e+00, 1.00002408e+00, 1.00003338e+00, + 1.00004232e+00, 1.00005078e+00, 1.00005865e+00, 1.00006592e+00, + 1.00007236e+00, 1.00007808e+00, 1.00008297e+00, 1.00008690e+00, + 1.00008988e+00, 1.00009179e+00, 1.00009286e+00, 1.00009274e+00, + 1.00009179e+00, 1.00008965e+00, 1.00008667e+00, 1.00008261e+00, + 1.00007772e+00, 1.00007200e+00, 1.00006545e+00, 1.00005817e+00, + 1.00005031e+00, 1.00004172e+00, 1.00003278e+00, 1.00002337e+00, + 1.00001371e+00, 1.00000370e+00, 9.99993682e-01, 9.99983490e-01, + 9.99973357e-01, 9.99963224e-01, 9.99953210e-01, 9.99943376e-01, + 9.99933660e-01, 9.99924064e-01, 9.99914587e-01, 9.99905109e-01, + 9.99895573e-01, 9.99885738e-01, 9.99875546e-01, 9.99864578e-01, + 9.99852657e-01, 9.99839306e-01, 9.99824166e-01, 9.99806523e-01, + 9.99785900e-01, 9.99761462e-01, 9.99732316e-01, 9.99697566e-01, + 9.99655962e-01, 9.99606311e-01, 9.99547124e-01, 9.99476731e-01, + 9.99393344e-01, 9.99294996e-01, 9.99179363e-01, 9.99043941e-01, + 9.98886049e-01, 9.98702645e-01, 9.98490512e-01, 9.98246014e-01, + 9.97965276e-01, 9.97644246e-01, 9.97278214e-01, 9.96862471e-01, + 9.96391773e-01, 9.95860577e-01, 9.95262980e-01, 9.94592726e-01, + 9.93843138e-01, 9.93007302e-01, 9.92077827e-01, 9.91046965e-01, + 9.89906728e-01, 9.88648713e-01, 9.87264156e-01, 9.85744119e-01, + 9.84079301e-01, 9.82260108e-01, 9.80276704e-01, 9.78119195e-01, + 9.75777209e-01, 9.73240614e-01, 9.70498860e-01, 9.67541456e-01, + 9.64357972e-01, 9.60937798e-01, 9.57270682e-01, 9.53346252e-01, + 9.49154437e-01, 9.44685459e-01, 9.39929724e-01, 9.34878111e-01, + 9.29521918e-01, 9.23852861e-01, 9.17863250e-01, 9.11546052e-01, + 9.04894829e-01, 8.97903919e-01, 8.90568554e-01, 8.82884681e-01, + 8.74849200e-01, 8.66460025e-01, 8.57716084e-01, 8.48617196e-01, + 8.39164436e-01, 8.29359889e-01, 8.19206893e-01, 8.08709860e-01, + 7.97874272e-01, 7.86707044e-01, 7.75215983e-01, 7.63410211e-01, + 7.51299858e-01, 7.38896310e-01, 7.26211846e-01, 7.13259816e-01, + 7.00054646e-01, 6.86611593e-01, 6.72946632e-01, 6.59076810e-01, + 6.45019531e-01, 6.30793154e-01, 6.16416335e-01, 6.01908267e-01, + 5.87288618e-01, 5.72577178e-01, 5.57793975e-01, 5.42959273e-01, + 5.28093219e-01, 5.13215959e-01, 4.98347521e-01, 4.83507633e-01, + 4.68715757e-01, 4.53991085e-01, 4.39352304e-01, 4.24817562e-01, + 4.10404533e-01, 3.96130294e-01, 3.82011205e-01, 3.68063033e-01, + 3.54300767e-01, 3.40738595e-01, 3.27390045e-01, 3.14267725e-01, + 3.01383466e-01, 2.88748264e-01, 2.76372313e-01, 2.64264882e-01, + 2.52434462e-01, 2.40888610e-01, 2.29634136e-01, 2.18676925e-01, + 2.08022103e-01, 1.97673932e-01, 1.87635899e-01, 1.77910715e-01, + 1.68500274e-01, 1.59405768e-01, 1.50627658e-01, 1.42165691e-01, + 1.34018898e-01, 1.26185730e-01, 1.18663922e-01, 1.11450672e-01, + 1.04542568e-01, 9.79356542e-02, 9.16254595e-02, 8.56070295e-02, + 7.98749477e-02, 7.44233727e-02, 6.92460760e-02, 6.43364564e-02, + 5.96875995e-02, 5.52923009e-02, 5.11430874e-02, 4.72322591e-02, + 4.35519405e-02, 4.00940813e-02, 3.68505120e-02, 3.38129811e-02, + 3.09731625e-02, 2.83227116e-02, 2.58532818e-02, 2.35565584e-02, + 2.14242823e-02, 1.94482822e-02, 1.76204946e-02, 1.59329921e-02, + 1.43779973e-02, 1.29479105e-02, 1.16353221e-02, 1.04330294e-02, + 9.33405478e-03, 8.33165180e-03, 7.41932075e-03, 6.59081247e-03, + 5.84013900e-03, 5.16157458e-03, 4.54966258e-03, 3.99921415e-03, + 3.50530911e-03, 3.06329457e-03, 2.66878284e-03, 2.31764605e-03, + 2.00601248e-03, 1.73026032e-03, 1.48701016e-03, 1.27311819e-03, + 1.08566787e-03, 9.21960978e-04, 7.79508497e-04, 6.56021410e-04, + 5.49400807e-04, 4.57728049e-04, 3.79254925e-04, 3.12393560e-04, + 2.55706662e-04, 2.07897814e-04, 1.67801816e-04, 1.34375354e-04, + 1.06687941e-04, 8.39131390e-05, 6.53200550e-05, 5.02652765e-05, + 3.81850987e-05, 2.85881870e-05, 2.10486251e-05, 1.51993554e-05, + 1.07260339e-05, 7.36129550e-06, 4.87941543e-06, 3.09137795e-06, + 1.84032115e-06, 9.97358256e-07, 4.57689993e-07, 1.36315705e-07, +}; + +#endif /* LC3_PLUS_HR */ + +static const float mdct_win_5m_8k[__LC3_MDCT_WIN_LEN(5000, 8000)] = { + 9.95908659e-04, 3.81905679e-03, 9.54083261e-03, 1.92165980e-02, + 3.38271908e-02, 5.42483167e-02, 8.12077767e-02, 1.15217189e-01, + 1.56494233e-01, 2.04936342e-01, 2.60116658e-01, 3.21281416e-01, + 3.87347300e-01, 4.56949708e-01, 5.28519296e-01, 6.00352249e-01, + 6.70689638e-01, 7.37804446e-01, 8.00092531e-01, 8.56140918e-01, + 9.04827229e-01, 9.45368503e-01, 9.77350743e-01, 1.00080087e+00, + 1.01617159e+00, 1.02431525e+00, 1.02641543e+00, 1.02385837e+00, + 1.01813571e+00, 1.01079482e+00, 1.00340651e+00, 9.96783127e-01, + 9.92099552e-01, 9.89220694e-01, 9.87965832e-01, 9.88127353e-01, + 9.89480554e-01, 9.91784992e-01, 9.94784758e-01, 9.98211967e-01, + 1.00179124e+00, 1.00524258e+00, 1.00828305e+00, 1.01063128e+00, + 1.01201530e+00, 1.01218075e+00, 1.01089677e+00, 1.00796336e+00, + 1.00322726e+00, 9.96605055e-01, 9.86828423e-01, 9.73125029e-01, + 9.54063648e-01, 9.28386428e-01, 8.95091686e-01, 8.53476936e-01, + 8.03209093e-01, 7.44473520e-01, 6.78078703e-01, 6.05397045e-01, + 5.28207751e-01, 4.48655296e-01, 3.69187599e-01, 2.92456641e-01, + 2.21071854e-01, 1.57314858e-01, 1.03052576e-01, 5.98273224e-02, + 2.87183192e-02, 9.68388493e-03, +}; + +static const float mdct_win_5m_16k[__LC3_MDCT_WIN_LEN(5000, 16000)] = { + 6.14338818e-04, 1.48958283e-03, 2.88410496e-03, 4.93429883e-03, + 7.77913046e-03, 1.15491061e-02, 1.63715562e-02, 2.23711616e-02, + 2.96615969e-02, 3.83566333e-02, 4.85561099e-02, 6.03505574e-02, + 7.38228820e-02, 8.90356369e-02, 1.06035623e-01, 1.24853486e-01, + 1.45493189e-01, 1.67943556e-01, 1.92172862e-01, 2.18123826e-01, + 2.45725974e-01, 2.74883943e-01, 3.05482471e-01, 3.37387380e-01, + 3.70441593e-01, 4.04474963e-01, 4.39300436e-01, 4.74722545e-01, + 5.10534149e-01, 5.46520192e-01, 5.82465810e-01, 6.18145266e-01, + 6.53341146e-01, 6.87836730e-01, 7.21417603e-01, 7.53888797e-01, + 7.85054657e-01, 8.14739745e-01, 8.42781936e-01, 8.69037674e-01, + 8.93393548e-01, 9.15748356e-01, 9.36027020e-01, 9.54173114e-01, + 9.70163547e-01, 9.84003644e-01, 9.95719942e-01, 1.00537427e+00, + 1.01304666e+00, 1.01884338e+00, 1.02289695e+00, 1.02535529e+00, + 1.02638288e+00, 1.02615553e+00, 1.02485397e+00, 1.02266460e+00, + 1.01977940e+00, 1.01639169e+00, 1.01269703e+00, 1.00888519e+00, + 1.00537874e+00, 1.00156378e+00, 9.98253156e-01, 9.95434664e-01, + 9.93095027e-01, 9.91217091e-01, 9.89780519e-01, 9.88762494e-01, + 9.88138324e-01, 9.87881941e-01, 9.87966213e-01, 9.88363051e-01, + 9.89043407e-01, 9.89977232e-01, 9.91133456e-01, 9.92480044e-01, + 9.93984121e-01, 9.95612147e-01, 9.97330059e-01, 9.99103363e-01, + 1.00089744e+00, 1.00267709e+00, 1.00440719e+00, 1.00605229e+00, + 1.00757693e+00, 1.00894586e+00, 1.01012424e+00, 1.01107797e+00, + 1.01177396e+00, 1.01218036e+00, 1.01226671e+00, 1.01200406e+00, + 1.01136522e+00, 1.01032500e+00, 1.00886073e+00, 1.00695298e+00, + 1.00458627e+00, 1.00174990e+00, 9.98438663e-01, 9.94650033e-01, + 9.89575685e-01, 9.83830313e-01, 9.76999916e-01, 9.68914116e-01, + 9.59403812e-01, 9.48308632e-01, 9.35486022e-01, 9.20810131e-01, + 9.04173226e-01, 8.85488225e-01, 8.64686495e-01, 8.41723747e-01, + 8.16587571e-01, 7.89298635e-01, 7.59917189e-01, 7.28547452e-01, + 6.95328294e-01, 6.60433402e-01, 6.24066143e-01, 5.86446142e-01, + 5.47816066e-01, 5.08449976e-01, 4.68636143e-01, 4.28678989e-01, + 3.88903272e-01, 3.49643142e-01, 3.11236082e-01, 2.74012847e-01, + 2.38284723e-01, 2.04337983e-01, 1.72430586e-01, 1.42793979e-01, + 1.15638588e-01, 9.11582177e-02, 6.95274904e-02, 5.08897541e-02, + 3.53343019e-02, 2.28668041e-02, 1.33800502e-02, 6.64050653e-03, +}; + +static const float mdct_win_5m_24k[__LC3_MDCT_WIN_LEN(5000, 24000)] = { + 5.08722763e-04, 9.95908659e-04, 1.68220801e-03, 2.60969726e-03, + 3.81905679e-03, 5.34931959e-03, 7.24390638e-03, 9.54083261e-03, + 1.22763764e-02, 1.54895024e-02, 1.92165980e-02, 2.34936962e-02, + 2.83519958e-02, 3.38271908e-02, 3.99493954e-02, 4.67477524e-02, + 5.42483167e-02, 6.24777078e-02, 7.14583592e-02, 8.12077767e-02, + 9.17440041e-02, 1.03076496e-01, 1.15217189e-01, 1.28166571e-01, + 1.41926438e-01, 1.56494233e-01, 1.71859319e-01, 1.88013425e-01, + 2.04936342e-01, 2.22612306e-01, 2.41015124e-01, 2.60116658e-01, + 2.79887101e-01, 3.00288014e-01, 3.21281416e-01, 3.42820846e-01, + 3.64859656e-01, 3.87347300e-01, 4.10229495e-01, 4.33449453e-01, + 4.56949708e-01, 4.80669640e-01, 5.04547382e-01, 5.28519296e-01, + 5.52519610e-01, 5.76487245e-01, 6.00352249e-01, 6.24050987e-01, + 6.47518259e-01, 6.70689638e-01, 6.93502907e-01, 7.15892752e-01, + 7.37804446e-01, 7.59178724e-01, 7.79958661e-01, 8.00092531e-01, + 8.19531865e-01, 8.38228896e-01, 8.56140918e-01, 8.73231695e-01, + 8.89470202e-01, 9.04827229e-01, 9.19273638e-01, 9.32794041e-01, + 9.45368503e-01, 9.56988393e-01, 9.67648642e-01, 9.77350743e-01, + 9.86102783e-01, 9.93912241e-01, 1.00080087e+00, 1.00678781e+00, + 1.01190127e+00, 1.01617159e+00, 1.01963641e+00, 1.02233661e+00, + 1.02431525e+00, 1.02562130e+00, 1.02630344e+00, 1.02641543e+00, + 1.02600793e+00, 1.02513744e+00, 1.02385837e+00, 1.02222694e+00, + 1.02030055e+00, 1.01813571e+00, 1.01579215e+00, 1.01332597e+00, + 1.01079482e+00, 1.00826513e+00, 1.00604687e+00, 1.00340651e+00, + 1.00097740e+00, 9.98770454e-01, 9.96783127e-01, 9.95011891e-01, + 9.93452397e-01, 9.92099552e-01, 9.90947600e-01, 9.89990243e-01, + 9.89220694e-01, 9.88631804e-01, 9.88216090e-01, 9.87965832e-01, + 9.87873077e-01, 9.87929693e-01, 9.88127353e-01, 9.88457554e-01, + 9.88911587e-01, 9.89480554e-01, 9.90155346e-01, 9.90926656e-01, + 9.91784992e-01, 9.92720684e-01, 9.93723921e-01, 9.94784758e-01, + 9.95893149e-01, 9.97038957e-01, 9.98211967e-01, 9.99402034e-01, + 1.00059832e+00, 1.00179124e+00, 1.00296984e+00, 1.00412379e+00, + 1.00524258e+00, 1.00631572e+00, 1.00733269e+00, 1.00828305e+00, + 1.00915642e+00, 1.00994254e+00, 1.01063128e+00, 1.01121274e+00, + 1.01167723e+00, 1.01201530e+00, 1.01221778e+00, 1.01227579e+00, + 1.01218075e+00, 1.01192443e+00, 1.01149892e+00, 1.01089677e+00, + 1.01011097e+00, 1.00913509e+00, 1.00796336e+00, 1.00659076e+00, + 1.00501312e+00, 1.00322726e+00, 1.00123106e+00, 9.99023556e-01, + 9.96605055e-01, 9.93989471e-01, 9.90453920e-01, 9.86828423e-01, + 9.82771674e-01, 9.78220667e-01, 9.73125029e-01, 9.67432353e-01, + 9.61094704e-01, 9.54063648e-01, 9.46295299e-01, 9.37748911e-01, + 9.28386428e-01, 9.18176261e-01, 9.07086156e-01, 8.95091686e-01, + 8.82169624e-01, 8.68302529e-01, 8.53476936e-01, 8.37685201e-01, + 8.20927526e-01, 8.03209093e-01, 7.84545048e-01, 7.64955485e-01, + 7.44473520e-01, 7.23134807e-01, 7.00986056e-01, 6.78078703e-01, + 6.54468651e-01, 6.30221215e-01, 6.05397045e-01, 5.80071577e-01, + 5.54312928e-01, 5.28207751e-01, 5.01836972e-01, 4.75290296e-01, + 4.48655296e-01, 4.22028112e-01, 3.95505797e-01, 3.69187599e-01, + 3.43173285e-01, 3.17563302e-01, 2.92456641e-01, 2.67946378e-01, + 2.44123133e-01, 2.21071854e-01, 1.98871915e-01, 1.77596763e-01, + 1.57314858e-01, 1.38090336e-01, 1.19983750e-01, 1.03052576e-01, + 8.73508501e-02, 7.29281158e-02, 5.98273224e-02, 4.80817884e-02, + 3.77113530e-02, 2.87183192e-02, 2.10835203e-02, 1.47628941e-02, + 9.68388493e-03, 5.64216879e-03, +}; + +static const float mdct_win_5m_32k[__LC3_MDCT_WIN_LEN(5000, 32000)] = { + 4.59588635e-04, 7.91932361e-04, 1.22792717e-03, 1.78365327e-03, + 2.47954941e-03, 3.32979945e-03, 4.35353548e-03, 5.56496516e-03, + 6.98610836e-03, 8.62988232e-03, 1.05134341e-02, 1.26508264e-02, + 1.50609045e-02, 1.77559123e-02, 2.07547598e-02, 2.40681372e-02, + 2.77120786e-02, 3.16993325e-02, 3.60460964e-02, 4.07612864e-02, + 4.58603812e-02, 5.13513668e-02, 5.72478022e-02, 6.35585474e-02, + 7.02945073e-02, 7.74598720e-02, 8.50663537e-02, 9.31164162e-02, + 1.01616296e-01, 1.10569081e-01, 1.19978929e-01, 1.29841729e-01, + 1.40162380e-01, 1.50937156e-01, 1.62163230e-01, 1.73835412e-01, + 1.85952036e-01, 1.98500883e-01, 2.11477855e-01, 2.24873256e-01, + 2.38676395e-01, 2.52872945e-01, 2.67454701e-01, 2.82403147e-01, + 2.97705015e-01, 3.13341912e-01, 3.29297670e-01, 3.45549016e-01, + 3.62079505e-01, 3.78864867e-01, 3.95885158e-01, 4.13114379e-01, + 4.30530830e-01, 4.48107672e-01, 4.65822779e-01, 4.83646639e-01, + 5.01556485e-01, 5.19522807e-01, 5.37519704e-01, 5.55518384e-01, + 5.73495781e-01, 5.91418665e-01, 6.09262289e-01, 6.26998116e-01, + 6.44600201e-01, 6.62038458e-01, 6.79290655e-01, 6.96325643e-01, + 7.13119439e-01, 7.29646991e-01, 7.45886459e-01, 7.61809472e-01, + 7.77395845e-01, 7.92620875e-01, 8.07466639e-01, 8.21910156e-01, + 8.35934316e-01, 8.49518047e-01, 8.62648584e-01, 8.75308323e-01, + 8.87488472e-01, 8.99173772e-01, 9.10352743e-01, 9.21014413e-01, + 9.31155619e-01, 9.40764474e-01, 9.49838224e-01, 9.58373260e-01, + 9.66369041e-01, 9.73823562e-01, 9.80744251e-01, 9.87129797e-01, + 9.92987227e-01, 9.98324140e-01, 1.00315076e+00, 1.00747371e+00, + 1.01130915e+00, 1.01466668e+00, 1.01756334e+00, 1.02001468e+00, + 1.02203987e+00, 1.02365426e+00, 1.02488162e+00, 1.02573929e+00, + 1.02625071e+00, 1.02643667e+00, 1.02632086e+00, 1.02592292e+00, + 1.02526998e+00, 1.02438219e+00, 1.02328494e+00, 1.02200083e+00, + 1.02055597e+00, 1.01897139e+00, 1.01727518e+00, 1.01548913e+00, + 1.01363936e+00, 1.01174775e+00, 1.00984084e+00, 1.00793976e+00, + 1.00640740e+00, 1.00437483e+00, 1.00246981e+00, 1.00068907e+00, + 9.99034600e-01, 9.97502490e-01, 9.96094155e-01, 9.94805124e-01, + 9.93636273e-01, 9.92582654e-01, 9.91644701e-01, 9.90817076e-01, + 9.90099845e-01, 9.89487369e-01, 9.88979432e-01, 9.88570179e-01, + 9.88259191e-01, 9.88040442e-01, 9.87913369e-01, 9.87871810e-01, + 9.87915076e-01, 9.88036894e-01, 9.88236456e-01, 9.88507369e-01, + 9.88848709e-01, 9.89253949e-01, 9.89722041e-01, 9.90246329e-01, + 9.90825634e-01, 9.91453181e-01, 9.92127681e-01, 9.92842250e-01, + 9.93595510e-01, 9.94380481e-01, 9.95195724e-01, 9.96034188e-01, + 9.96894383e-01, 9.97769201e-01, 9.98657113e-01, 9.99550974e-01, + 1.00044923e+00, 1.00134469e+00, 1.00223579e+00, 1.00311529e+00, + 1.00398160e+00, 1.00482747e+00, 1.00565128e+00, 1.00644577e+00, + 1.00720935e+00, 1.00793478e+00, 1.00862050e+00, 1.00925931e+00, + 1.00984974e+00, 1.01038469e+00, 1.01086278e+00, 1.01127704e+00, + 1.01162625e+00, 1.01190357e+00, 1.01210795e+00, 1.01223276e+00, + 1.01227709e+00, 1.01223451e+00, 1.01210432e+00, 1.01188029e+00, + 1.01156197e+00, 1.01114337e+00, 1.01062432e+00, 1.00999915e+00, + 1.00926803e+00, 1.00842570e+00, 1.00747277e+00, 1.00640448e+00, + 1.00522200e+00, 1.00392116e+00, 1.00250376e+00, 1.00096633e+00, + 9.99311401e-01, 9.97536270e-01, 9.95644231e-01, 9.93633392e-01, + 9.90867748e-01, 9.88232633e-01, 9.85362057e-01, 9.82230509e-01, + 9.78818585e-01, 9.75102633e-01, 9.71063185e-01, 9.66675967e-01, + 9.61924219e-01, 9.56784199e-01, 9.51239430e-01, 9.45270024e-01, + 9.38861570e-01, 9.31994644e-01, 9.24659203e-01, 9.16838340e-01, + 9.08521803e-01, 8.99696701e-01, 8.90356205e-01, 8.80487793e-01, + 8.70088421e-01, 8.59149213e-01, 8.47668639e-01, 8.35642897e-01, + 8.23075389e-01, 8.09964930e-01, 7.96320451e-01, 7.82146054e-01, + 7.67454182e-01, 7.52256346e-01, 7.36570205e-01, 7.20409055e-01, + 7.03797511e-01, 6.86754281e-01, 6.69304189e-01, 6.51471096e-01, + 6.33285483e-01, 6.14768539e-01, 5.95955378e-01, 5.76873796e-01, + 5.57553429e-01, 5.38032014e-01, 5.18345403e-01, 4.98525942e-01, + 4.78615607e-01, 4.58647304e-01, 4.38664366e-01, 4.18704689e-01, + 3.98812306e-01, 3.79026292e-01, 3.59391483e-01, 3.39947413e-01, + 3.20739242e-01, 3.01806111e-01, 2.83190595e-01, 2.64928837e-01, + 2.47060855e-01, 2.29620112e-01, 2.12643372e-01, 1.96160182e-01, + 1.80203520e-01, 1.64799688e-01, 1.49978755e-01, 1.35764352e-01, + 1.22184253e-01, 1.09260199e-01, 9.70178845e-02, 8.54768028e-02, + 7.46597638e-02, 6.45825432e-02, 5.52628119e-02, 4.67097698e-02, + 3.89324443e-02, 3.19297601e-02, 2.56981064e-02, 2.02225927e-02, + 1.54831778e-02, 1.14492491e-02, 8.07648266e-03, 5.30004408e-03, +}; + +static const float mdct_win_5m_48k[__LC3_MDCT_WIN_LEN(5000, 48000)] = { + 4.09010650e-04, 6.14338818e-04, 8.57175988e-04, 1.14701506e-03, + 1.48958283e-03, 1.88977038e-03, 2.35300080e-03, 2.88410496e-03, + 3.48821379e-03, 4.17004043e-03, 4.93429883e-03, 5.78707651e-03, + 6.73381174e-03, 7.77913046e-03, 8.92704496e-03, 1.01820289e-02, + 1.15491061e-02, 1.30334922e-02, 1.46395129e-02, 1.63715562e-02, + 1.82345538e-02, 2.02330949e-02, 2.23711616e-02, 2.46523735e-02, + 2.70810194e-02, 2.96615969e-02, 3.23988485e-02, 3.52960177e-02, + 3.83566333e-02, 4.15844793e-02, 4.49832242e-02, 4.85561099e-02, + 5.23059648e-02, 5.62362458e-02, 6.03505574e-02, 6.46518632e-02, + 6.91419575e-02, 7.38228820e-02, 7.86970933e-02, 8.37676164e-02, + 8.90356369e-02, 9.45019924e-02, 1.00168019e-01, 1.06035623e-01, + 1.12106022e-01, 1.18378855e-01, 1.24853486e-01, 1.31530285e-01, + 1.38410308e-01, 1.45493189e-01, 1.52777295e-01, 1.60260884e-01, + 1.67943556e-01, 1.75824562e-01, 1.83902012e-01, 1.92172862e-01, + 2.00634430e-01, 2.09285388e-01, 2.18123826e-01, 2.27146226e-01, + 2.36347921e-01, 2.45725974e-01, 2.55277155e-01, 2.64998109e-01, + 2.74883943e-01, 2.84929644e-01, 2.95130651e-01, 3.05482471e-01, + 3.15979964e-01, 3.26616979e-01, 3.37387380e-01, 3.48285592e-01, + 3.59305769e-01, 3.70441593e-01, 3.81686239e-01, 3.93032978e-01, + 4.04474963e-01, 4.16005110e-01, 4.27615960e-01, 4.39300436e-01, + 4.51051633e-01, 4.62861605e-01, 4.74722545e-01, 4.86626671e-01, + 4.98566451e-01, 5.10534149e-01, 5.22521279e-01, 5.34519051e-01, + 5.46520192e-01, 5.58517277e-01, 5.70502154e-01, 5.82465810e-01, + 5.94399172e-01, 6.06294818e-01, 6.18145266e-01, 6.29942202e-01, + 6.41676874e-01, 6.53341146e-01, 6.64927754e-01, 6.76429270e-01, + 6.87836730e-01, 6.99142147e-01, 7.10337961e-01, 7.21417603e-01, + 7.32374610e-01, 7.43200803e-01, 7.53888797e-01, 7.64431550e-01, + 7.74822315e-01, 7.85054657e-01, 7.95122352e-01, 8.05019386e-01, + 8.14739745e-01, 8.24277441e-01, 8.33626711e-01, 8.42781936e-01, + 8.51738619e-01, 8.60492087e-01, 8.69037674e-01, 8.77372045e-01, + 8.85492794e-01, 8.93393548e-01, 9.01072709e-01, 9.08524940e-01, + 9.15748356e-01, 9.22741384e-01, 9.29501747e-01, 9.36027020e-01, + 9.42314305e-01, 9.48362979e-01, 9.54173114e-01, 9.59743838e-01, + 9.65073839e-01, 9.70163547e-01, 9.75014336e-01, 9.79627719e-01, + 9.84003644e-01, 9.88142677e-01, 9.92047045e-01, 9.95719942e-01, + 9.99164081e-01, 1.00238131e+00, 1.00537427e+00, 1.00814672e+00, + 1.01070312e+00, 1.01304666e+00, 1.01518127e+00, 1.01711164e+00, + 1.01884338e+00, 1.02038171e+00, 1.02173110e+00, 1.02289695e+00, + 1.02388546e+00, 1.02470297e+00, 1.02535529e+00, 1.02584824e+00, + 1.02618837e+00, 1.02638288e+00, 1.02643810e+00, 1.02636013e+00, + 1.02615553e+00, 1.02583146e+00, 1.02539543e+00, 1.02485397e+00, + 1.02421348e+00, 1.02348118e+00, 1.02266460e+00, 1.02177090e+00, + 1.02080692e+00, 1.01977940e+00, 1.01869600e+00, 1.01756442e+00, + 1.01639169e+00, 1.01518492e+00, 1.01395084e+00, 1.01269703e+00, + 1.01143075e+00, 1.01015835e+00, 1.00888519e+00, 1.00759272e+00, + 1.00680560e+00, 1.00537874e+00, 1.00404905e+00, 1.00277836e+00, + 1.00156378e+00, 1.00040492e+00, 9.99301484e-01, 9.98253156e-01, + 9.97259546e-01, 9.96320213e-01, 9.95434664e-01, 9.94602354e-01, + 9.93822688e-01, 9.93095027e-01, 9.92418692e-01, 9.91792966e-01, + 9.91217091e-01, 9.90690276e-01, 9.90211700e-01, 9.89780519e-01, + 9.89395860e-01, 9.89056824e-01, 9.88762494e-01, 9.88511936e-01, + 9.88304203e-01, 9.88138324e-01, 9.88013316e-01, 9.87928190e-01, + 9.87881941e-01, 9.87873551e-01, 9.87901987e-01, 9.87966213e-01, + 9.88065178e-01, 9.88197816e-01, 9.88363051e-01, 9.88559796e-01, + 9.88786953e-01, 9.89043407e-01, 9.89328032e-01, 9.89639690e-01, + 9.89977232e-01, 9.90339493e-01, 9.90725297e-01, 9.91133456e-01, + 9.91562775e-01, 9.92012044e-01, 9.92480044e-01, 9.92965548e-01, + 9.93467321e-01, 9.93984121e-01, 9.94514697e-01, 9.95057793e-01, + 9.95612147e-01, 9.96176492e-01, 9.96749554e-01, 9.97330059e-01, + 9.97916725e-01, 9.98508264e-01, 9.99103363e-01, 9.99700348e-01, + 1.00029974e+00, 1.00089744e+00, 1.00149396e+00, 1.00208762e+00, + 1.00267709e+00, 1.00326105e+00, 1.00383818e+00, 1.00440719e+00, + 1.00496675e+00, 1.00551556e+00, 1.00605229e+00, 1.00657564e+00, + 1.00708429e+00, 1.00757693e+00, 1.00805228e+00, 1.00850902e+00, + 1.00894586e+00, 1.00936153e+00, 1.00975474e+00, 1.01012424e+00, + 1.01046877e+00, 1.01078709e+00, 1.01107797e+00, 1.01134021e+00, + 1.01157260e+00, 1.01177396e+00, 1.01194314e+00, 1.01207898e+00, + 1.01218036e+00, 1.01224617e+00, 1.01227531e+00, 1.01226671e+00, + 1.01221932e+00, 1.01213211e+00, 1.01200406e+00, 1.01183421e+00, + 1.01162157e+00, 1.01136522e+00, 1.01106425e+00, 1.01071779e+00, + 1.01032500e+00, 1.00988506e+00, 1.00939721e+00, 1.00886073e+00, + 1.00827495e+00, 1.00763922e+00, 1.00695298e+00, 1.00621571e+00, + 1.00542694e+00, 1.00458627e+00, 1.00369338e+00, 1.00274798e+00, + 1.00174990e+00, 1.00069900e+00, 9.99595249e-01, 9.98438663e-01, + 9.97229342e-01, 9.95967277e-01, 9.94650033e-01, 9.93240400e-01, + 9.91251152e-01, 9.89575685e-01, 9.87771321e-01, 9.85857748e-01, + 9.83830313e-01, 9.81682263e-01, 9.79407449e-01, 9.76999916e-01, + 9.74452836e-01, 9.71759750e-01, 9.68914116e-01, 9.65910162e-01, + 9.62742183e-01, 9.59403812e-01, 9.55888998e-01, 9.52192243e-01, + 9.48308632e-01, 9.44233254e-01, 9.39960724e-01, 9.35486022e-01, + 9.30805297e-01, 9.25914697e-01, 9.20810131e-01, 9.15487360e-01, + 9.09942607e-01, 9.04173226e-01, 8.98176373e-01, 8.91949024e-01, + 8.85488225e-01, 8.78791944e-01, 8.71858584e-01, 8.64686495e-01, + 8.57273814e-01, 8.49619586e-01, 8.41723747e-01, 8.33586272e-01, + 8.25207443e-01, 8.16587571e-01, 8.07728037e-01, 7.98631159e-01, + 7.89298635e-01, 7.79733095e-01, 7.69937953e-01, 7.59917189e-01, + 7.49675842e-01, 7.39217684e-01, 7.28547452e-01, 7.17671448e-01, + 7.06596231e-01, 6.95328294e-01, 6.83873906e-01, 6.72239531e-01, + 6.60433402e-01, 6.48464360e-01, 6.36339500e-01, 6.24066143e-01, + 6.11653033e-01, 5.99109864e-01, 5.86446142e-01, 5.73669485e-01, + 5.60788103e-01, 5.47816066e-01, 5.34761979e-01, 5.21636515e-01, + 5.08449976e-01, 4.95213509e-01, 4.81938756e-01, 4.68636143e-01, + 4.55317077e-01, 4.41993995e-01, 4.28678989e-01, 4.15383779e-01, + 4.02121106e-01, 3.88903272e-01, 3.75742544e-01, 3.62651518e-01, + 3.49643142e-01, 3.36729082e-01, 3.23922808e-01, 3.11236082e-01, + 2.98680794e-01, 2.86269467e-01, 2.74012847e-01, 2.61922833e-01, + 2.50009844e-01, 2.38284723e-01, 2.26757849e-01, 2.15439100e-01, + 2.04337983e-01, 1.93463677e-01, 1.82825032e-01, 1.72430586e-01, + 1.62288635e-01, 1.52407188e-01, 1.42793979e-01, 1.33456585e-01, + 1.24402392e-01, 1.15638588e-01, 1.07172155e-01, 9.90098587e-02, + 9.11582177e-02, 8.36234486e-02, 7.64114037e-02, 6.95274904e-02, + 6.29765645e-02, 5.67628424e-02, 5.08897541e-02, 4.53598330e-02, + 4.01745731e-02, 3.53343019e-02, 3.08380606e-02, 2.66835542e-02, + 2.28668041e-02, 1.93823634e-02, 1.62231272e-02, 1.33800502e-02, + 1.08421860e-02, 8.59675398e-03, 6.64050653e-03, 5.17270311e-03, +}; + +#if LC3_PLUS_HR + +static const float mdct_win_5m_48k_hr[__LC3_MDCT_WIN_LEN(5000, 48000)] = { + 9.75247545e-08, 6.41356849e-07, 1.88872264e-06, 4.37003746e-06, + 8.85053487e-06, 1.64097619e-05, 2.85265469e-05, 4.71757776e-05, + 7.49369574e-05, 1.15113864e-04, 1.71864056e-04, 2.50336452e-04, + 3.56814737e-04, 4.98863636e-04, 6.85475010e-04, 9.27209505e-04, + 1.23633002e-03, 1.62692170e-03, 2.11499492e-03, 2.71856366e-03, + 3.45769688e-03, 4.35453700e-03, 5.43327769e-03, 6.72010100e-03, + 8.24306626e-03, 1.00319488e-02, 1.21180220e-02, 1.45337880e-02, + 1.73126478e-02, 2.04885192e-02, 2.40953956e-02, 2.81668510e-02, + 3.27355117e-02, 3.78324650e-02, 4.34866548e-02, 4.97242436e-02, + 5.65679595e-02, 6.40364513e-02, 7.21436515e-02, 8.08981732e-02, + 9.03027356e-02, 1.00353681e-01, 1.11040540e-01, 1.22345708e-01, + 1.34244218e-01, 1.46703660e-01, 1.59684196e-01, 1.73138753e-01, + 1.87013358e-01, 2.01247633e-01, 2.15775400e-01, 2.30525494e-01, + 2.45422661e-01, 2.60388613e-01, 2.75343060e-01, 2.90205121e-01, + 3.04894298e-01, 3.19332004e-01, 3.33442599e-01, 3.47154707e-01, + 3.60402405e-01, 3.73126328e-01, 3.85274231e-01, 3.96802038e-01, + 4.07674283e-01, 4.17864561e-01, 4.27355647e-01, 4.36139554e-01, + 4.44217294e-01, 4.51598674e-01, 4.58301634e-01, 4.64351624e-01, + 4.69781011e-01, 4.74628091e-01, 4.78936344e-01, 4.82753456e-01, + 4.86130476e-01, 4.89120960e-01, 4.91780102e-01, 4.94164050e-01, + 4.96329218e-01, 4.98331696e-01, 5.00226736e-01, 5.02068341e-01, + 5.03908992e-01, 5.05799294e-01, 5.07787943e-01, 5.09921193e-01, + 5.12243330e-01, 5.14795899e-01, 5.17618179e-01, 5.20746589e-01, + 5.24214983e-01, 5.28054178e-01, 5.32292068e-01, 5.36953092e-01, + 5.42058468e-01, 5.47625661e-01, 5.53668439e-01, 5.60196400e-01, + 5.67215025e-01, 5.74725628e-01, 5.82724869e-01, 5.91205239e-01, + 6.00154579e-01, 6.09556615e-01, 6.19390607e-01, 6.29631937e-01, + 6.40252173e-01, 6.51219368e-01, 6.62498534e-01, 6.74051821e-01, + 6.85839176e-01, 6.97818637e-01, 7.09946930e-01, 7.22179890e-01, + 7.34472811e-01, 7.46781170e-01, 7.59061038e-01, 7.71269321e-01, + 7.83364296e-01, 7.95306087e-01, 8.07056785e-01, 8.18580806e-01, + 8.29845190e-01, 8.40819776e-01, 8.51477146e-01, 8.61792982e-01, + 8.71745944e-01, 8.81317794e-01, 8.90493214e-01, 8.99259806e-01, + 9.07608211e-01, 9.15531754e-01, 9.23026323e-01, 9.30090547e-01, + 9.36725318e-01, 9.42933977e-01, 9.48721945e-01, 9.54096615e-01, + 9.59067523e-01, 9.63645637e-01, 9.67843831e-01, 9.71676290e-01, + 9.75158513e-01, 9.78307128e-01, 9.81139660e-01, 9.83674467e-01, + 9.85930443e-01, 9.87926722e-01, 9.89682734e-01, 9.91217852e-01, + 9.92551088e-01, 9.93701279e-01, 9.94686544e-01, 9.95524466e-01, + 9.96231675e-01, 9.96824026e-01, 9.97316301e-01, 9.97722328e-01, + 9.98054802e-01, 9.98325348e-01, 9.98544455e-01, 9.98721540e-01, + 9.98864949e-01, 9.98981953e-01, 9.99078929e-01, 9.99161184e-01, + 9.99233246e-01, 9.99298692e-01, 9.99360621e-01, 9.99421120e-01, + 9.99481916e-01, 9.99544203e-01, 9.99608576e-01, 9.99675393e-01, + 9.99744534e-01, 9.99815881e-01, 9.99888837e-01, 9.99962866e-01, + 1.00003707e+00, 1.00011098e+00, 1.00018346e+00, 1.00025380e+00, + 1.00032115e+00, 1.00038469e+00, 1.00044382e+00, 1.00049770e+00, + 1.00054598e+00, 1.00058782e+00, 1.00062299e+00, 1.00065112e+00, + 1.00067186e+00, 1.00068521e+00, 1.00069082e+00, 1.00068903e+00, + 1.00067961e+00, 1.00066280e+00, 1.00063896e+00, 1.00060833e+00, + 1.00057113e+00, 1.00052810e+00, 1.00047958e+00, 1.00042605e+00, + 1.00036812e+00, 1.00030637e+00, 1.00024164e+00, 1.00017428e+00, + 1.00010526e+00, 1.00003517e+00, 9.99964774e-01, 9.99894679e-01, + 9.99825716e-01, 9.99758482e-01, 9.99693692e-01, 9.99632061e-01, + 9.99574184e-01, 9.99520719e-01, 9.99472201e-01, 9.99429166e-01, + 9.99392092e-01, 9.99361455e-01, 9.99337614e-01, 9.99320924e-01, + 9.99311507e-01, 9.99309599e-01, 9.99315262e-01, 9.99328554e-01, + 9.99349296e-01, 9.99377370e-01, 9.99412537e-01, 9.99454379e-01, + 9.99502480e-01, 9.99556363e-01, 9.99615431e-01, 9.99678969e-01, + 9.99746263e-01, 9.99816597e-01, 9.99889076e-01, 9.99962866e-01, + 1.00003707e+00, 1.00011098e+00, 1.00018346e+00, 1.00025380e+00, + 1.00032115e+00, 1.00038469e+00, 1.00044382e+00, 1.00049770e+00, + 1.00054598e+00, 1.00058782e+00, 1.00062299e+00, 1.00065112e+00, + 1.00067186e+00, 1.00068521e+00, 1.00069082e+00, 1.00068903e+00, + 1.00067961e+00, 1.00066280e+00, 1.00063896e+00, 1.00060833e+00, + 1.00057113e+00, 1.00052810e+00, 1.00047958e+00, 1.00042605e+00, + 1.00036812e+00, 1.00030637e+00, 1.00024164e+00, 1.00017428e+00, + 1.00010526e+00, 1.00003517e+00, 9.99964774e-01, 9.99894679e-01, + 9.99825716e-01, 9.99758482e-01, 9.99693692e-01, 9.99632061e-01, + 9.99574184e-01, 9.99520719e-01, 9.99472201e-01, 9.99429166e-01, + 9.99392092e-01, 9.99361455e-01, 9.99337614e-01, 9.99320924e-01, + 9.99311507e-01, 9.99309599e-01, 9.99315262e-01, 9.99328554e-01, + 9.99349296e-01, 9.99377370e-01, 9.99412537e-01, 9.99454379e-01, + 9.99502480e-01, 9.99556363e-01, 9.99615431e-01, 9.99678969e-01, + 9.99746263e-01, 9.99816597e-01, 9.99889076e-01, 9.99962866e-01, + 1.00003707e+00, 1.00011075e+00, 1.00018275e+00, 1.00025201e+00, + 1.00031757e+00, 1.00037789e+00, 1.00043166e+00, 1.00047719e+00, + 1.00051260e+00, 1.00053585e+00, 1.00054419e+00, 1.00053477e+00, + 1.00050414e+00, 1.00044823e+00, 1.00036228e+00, 1.00024092e+00, + 1.00007784e+00, 9.99865890e-01, 9.99597013e-01, 9.99261975e-01, + 9.98850465e-01, 9.98351038e-01, 9.97750819e-01, 9.97035682e-01, + 9.96189833e-01, 9.95196044e-01, 9.94035423e-01, 9.92687285e-01, + 9.91129041e-01, 9.89336133e-01, 9.87281919e-01, 9.84937787e-01, + 9.82272744e-01, 9.79253709e-01, 9.75845337e-01, 9.72010076e-01, + 9.67708528e-01, 9.62899387e-01, 9.57539737e-01, 9.51585472e-01, + 9.44991708e-01, 9.37713265e-01, 9.29705381e-01, 9.20924187e-01, + 9.11327481e-01, 9.00875807e-01, 8.89532745e-01, 8.77266228e-01, + 8.64049077e-01, 8.49859893e-01, 8.34683776e-01, 8.18513036e-01, + 8.01347792e-01, 7.83196509e-01, 7.64076352e-01, 7.44013488e-01, + 7.23043203e-01, 7.01209962e-01, 6.78567350e-01, 6.55177712e-01, + 6.31111801e-01, 6.06448233e-01, 5.81272960e-01, 5.55678487e-01, + 5.29762745e-01, 5.03628492e-01, 4.77382004e-01, 4.51132149e-01, + 4.24988985e-01, 3.99062574e-01, 3.73461813e-01, 3.48293066e-01, + 3.23658854e-01, 2.99656719e-01, 2.76377857e-01, 2.53906131e-01, + 2.32316986e-01, 2.11676583e-01, 1.92040950e-01, 1.73455566e-01, + 1.55954808e-01, 1.39561892e-01, 1.24288827e-01, 1.10136725e-01, + 9.70961973e-02, 8.51479918e-02, 7.42638558e-02, 6.44074306e-02, + 5.55353425e-02, 4.75983508e-02, 4.05424982e-02, 3.43103148e-02, + 2.88419761e-02, 2.40764078e-02, 1.99523065e-02, 1.64090749e-02, + 1.33876354e-02, 1.08311241e-02, 8.68547149e-03, 6.89984858e-03, + 5.42699778e-03, 4.22345474e-03, 3.24966502e-03, 2.47000973e-03, + 1.85274973e-03, 1.36990519e-03, 9.97077208e-04, 7.13227608e-04, + 5.00426511e-04, 3.43578606e-04, 2.30138365e-04, 1.49821601e-04, + 9.43217892e-05, 5.70367956e-05, 3.28110509e-05, 1.76969679e-05, + 8.73827867e-06, 3.77677043e-06, 1.28252009e-06, 1.95021386e-07, +}; + +static const float mdct_win_5m_96k_hr[__LC3_MDCT_WIN_LEN(5000, 96000)] = { + 6.89548827e-08, 2.31516253e-07, 5.04477669e-07, 9.30795125e-07, + 1.56340695e-06, 2.46738750e-06, 3.72189174e-06, 5.42224188e-06, + 7.68219343e-06, 1.06363877e-05, 1.44429905e-05, 1.92865264e-05, + 2.53808976e-05, 3.29725954e-05, 4.23441015e-05, 5.38174427e-05, + 6.77579446e-05, 8.45781324e-05, 1.04741775e-04, 1.28768093e-04, + 1.57236034e-04, 1.90788676e-04, 2.30137754e-04, 2.76068167e-04, + 3.29442613e-04, 3.91206064e-04, 4.62390453e-04, 5.44119219e-04, + 6.37611491e-04, 7.44186866e-04, 8.65269103e-04, 1.00239040e-03, + 1.15719519e-03, 1.33144355e-03, 1.52701419e-03, 1.74590782e-03, + 1.99024938e-03, 2.26228987e-03, 2.56440835e-03, 2.89911311e-03, + 3.26904119e-03, 3.67696048e-03, 4.12576646e-03, 4.61848313e-03, + 5.15825953e-03, 5.74836833e-03, 6.39220094e-03, 7.09326472e-03, + 7.85517693e-03, 8.68165866e-03, 9.57652833e-03, 1.05436966e-02, + 1.15871523e-02, 1.27109587e-02, 1.39192408e-02, 1.52161736e-02, + 1.66059695e-02, 1.80928707e-02, 1.96811259e-02, 2.13749874e-02, + 2.31786855e-02, 2.50964165e-02, 2.71323286e-02, 2.92905010e-02, + 3.15749235e-02, 3.39894816e-02, 3.65379415e-02, 3.92239206e-02, + 4.20508720e-02, 4.50220704e-02, 4.81405817e-02, 5.14092445e-02, + 5.48306555e-02, 5.84071539e-02, 6.21407814e-02, 6.60332814e-02, + 7.00860694e-02, 7.43002295e-02, 7.86764771e-02, 8.32151473e-02, + 8.79162028e-02, 9.27791744e-02, 9.78031904e-02, 1.02986939e-01, + 1.08328678e-01, 1.13826200e-01, 1.19476855e-01, 1.25277504e-01, + 1.31224588e-01, 1.37314022e-01, 1.43541321e-01, 1.49901465e-01, + 1.56389058e-01, 1.62998185e-01, 1.69722542e-01, 1.76555380e-01, + 1.83489516e-01, 1.90517426e-01, 1.97631180e-01, 2.04822496e-01, + 2.12082773e-01, 2.19403118e-01, 2.26774365e-01, 2.34187096e-01, + 2.41631702e-01, 2.49098375e-01, 2.56577194e-01, 2.64058143e-01, + 2.71531105e-01, 2.78985947e-01, 2.86412567e-01, 2.93800950e-01, + 3.01141053e-01, 3.08423132e-01, 3.15637439e-01, 3.22774589e-01, + 3.29825372e-01, 3.36780816e-01, 3.43632400e-01, 3.50371778e-01, + 3.56991231e-01, 3.63483250e-01, 3.69840890e-01, 3.76057625e-01, + 3.82127434e-01, 3.88044775e-01, 3.93804729e-01, 3.99402857e-01, + 4.04835284e-01, 4.10098761e-01, 4.15190488e-01, 4.20108408e-01, + 4.24850911e-01, 4.29417044e-01, 4.33806360e-01, 4.38019037e-01, + 4.42055762e-01, 4.45917755e-01, 4.49606776e-01, 4.53125089e-01, + 4.56475437e-01, 4.59661037e-01, 4.62685496e-01, 4.65552896e-01, + 4.68267679e-01, 4.70834643e-01, 4.73258942e-01, 4.75546002e-01, + 4.77701575e-01, 4.79731590e-01, 4.81642276e-01, 4.83440012e-01, + 4.85131353e-01, 4.86723036e-01, 4.88221824e-01, 4.89634633e-01, + 4.90968436e-01, 4.92230296e-01, 4.93427187e-01, 4.94566232e-01, + 4.95654404e-01, 4.96698737e-01, 4.97706175e-01, 4.98683631e-01, + 4.99637932e-01, 5.00575840e-01, 5.01503944e-01, 5.02428830e-01, + 5.03356874e-01, 5.04294455e-01, 5.05247772e-01, 5.06222844e-01, + 5.07225573e-01, 5.08261740e-01, 5.09337008e-01, 5.10456860e-01, + 5.11626601e-01, 5.12851536e-01, 5.14136553e-01, 5.15486538e-01, + 5.16906321e-01, 5.18400311e-01, 5.19972920e-01, 5.21628320e-01, + 5.23370624e-01, 5.25203526e-01, 5.27130723e-01, 5.29155731e-01, + 5.31281710e-01, 5.33511758e-01, 5.35848677e-01, 5.38295090e-01, + 5.40853441e-01, 5.43525815e-01, 5.46314240e-01, 5.49220264e-01, + 5.52245498e-01, 5.55391014e-01, 5.58657765e-01, 5.62046468e-01, + 5.65557480e-01, 5.69190919e-01, 5.72946727e-01, 5.76824427e-01, + 5.80823362e-01, 5.84942579e-01, 5.89180827e-01, 5.93536615e-01, + 5.98008096e-01, 6.02593303e-01, 6.07289851e-01, 6.12095237e-01, + 6.17006540e-01, 6.22020781e-01, 6.27134562e-01, 6.32344365e-01, + 6.37646437e-01, 6.43036783e-01, 6.48511291e-01, 6.54065490e-01, + 6.59694970e-01, 6.65394902e-01, 6.71160460e-01, 6.76986754e-01, + 6.82868540e-01, 6.88800693e-01, 6.94777906e-01, 7.00794756e-01, + 7.06845820e-01, 7.12925553e-01, 7.19028473e-01, 7.25149035e-01, + 7.31281698e-01, 7.37420917e-01, 7.43561149e-01, 7.49696970e-01, + 7.55823016e-01, 7.61933863e-01, 7.68024206e-01, 7.74088979e-01, + 7.80123055e-01, 7.86121488e-01, 7.92079389e-01, 7.97992110e-01, + 8.03855121e-01, 8.09663892e-01, 8.15414310e-01, 8.21102202e-01, + 8.26723635e-01, 8.32274854e-01, 8.37752342e-01, 8.43152702e-01, + 8.48472714e-01, 8.53709280e-01, 8.58859718e-01, 8.63921225e-01, + 8.68891478e-01, 8.73768151e-01, 8.78549099e-01, 8.83232594e-01, + 8.87816727e-01, 8.92300129e-01, 8.96681368e-01, 9.00959313e-01, + 9.05132890e-01, 9.09201384e-01, 9.13164079e-01, 9.17020440e-01, + 9.20770228e-01, 9.24413145e-01, 9.27949250e-01, 9.31378603e-01, + 9.34701502e-01, 9.37918305e-01, 9.41029668e-01, 9.44036126e-01, + 9.46938515e-01, 9.49737847e-01, 9.52435017e-01, 9.55031335e-01, + 9.57527936e-01, 9.59926248e-01, 9.62227762e-01, 9.64434028e-01, + 9.66546714e-01, 9.68567610e-01, 9.70498502e-01, 9.72341299e-01, + 9.74098027e-01, 9.75770652e-01, 9.77361381e-01, 9.78872299e-01, + 9.80305672e-01, 9.81663704e-01, 9.82948720e-01, 9.84162986e-01, + 9.85308945e-01, 9.86388862e-01, 9.87405181e-01, 9.88360226e-01, + 9.89256442e-01, 9.90096152e-01, 9.90881741e-01, 9.91615593e-01, + 9.92299914e-01, 9.92937148e-01, 9.93529499e-01, 9.94079232e-01, + 9.94588435e-01, 9.95059371e-01, 9.95494127e-01, 9.95894730e-01, + 9.96263146e-01, 9.96601343e-01, 9.96911168e-01, 9.97194529e-01, + 9.97453094e-01, 9.97688591e-01, 9.97902572e-01, 9.98096704e-01, + 9.98272479e-01, 9.98431206e-01, 9.98574317e-01, 9.98703122e-01, + 9.98818815e-01, 9.98922586e-01, 9.99015450e-01, 9.99098480e-01, + 9.99172688e-01, 9.99238908e-01, 9.99298036e-01, 9.99350786e-01, + 9.99397993e-01, 9.99440193e-01, 9.99478102e-01, 9.99512255e-01, + 9.99543130e-01, 9.99571264e-01, 9.99597073e-01, 9.99620855e-01, + 9.99643087e-01, 9.99663949e-01, 9.99683797e-01, 9.99702871e-01, + 9.99721289e-01, 9.99739230e-01, 9.99756932e-01, 9.99774456e-01, + 9.99791920e-01, 9.99809384e-01, 9.99826908e-01, 9.99844551e-01, + 9.99862373e-01, 9.99880314e-01, 9.99898374e-01, 9.99916673e-01, + 9.99935031e-01, 9.99953508e-01, 9.99972105e-01, 9.99990702e-01, + 1.00000930e+00, 1.00002778e+00, 1.00004625e+00, 1.00006461e+00, + 1.00008273e+00, 1.00010061e+00, 1.00011826e+00, 1.00013554e+00, + 1.00015235e+00, 1.00016880e+00, 1.00018466e+00, 1.00020003e+00, + 1.00021482e+00, 1.00022900e+00, 1.00024247e+00, 1.00025523e+00, + 1.00026727e+00, 1.00027859e+00, 1.00028908e+00, 1.00029874e+00, + 1.00030744e+00, 1.00031543e+00, 1.00032246e+00, 1.00032854e+00, + 1.00033379e+00, 1.00033808e+00, 1.00034130e+00, 1.00034368e+00, + 1.00034511e+00, 1.00034559e+00, 1.00034511e+00, 1.00034368e+00, + 1.00034142e+00, 1.00033808e+00, 1.00033391e+00, 1.00032878e+00, + 1.00032282e+00, 1.00031602e+00, 1.00030828e+00, 1.00029981e+00, + 1.00029051e+00, 1.00028050e+00, 1.00026977e+00, 1.00025833e+00, + 1.00024617e+00, 1.00023329e+00, 1.00021994e+00, 1.00020599e+00, + 1.00019157e+00, 1.00017655e+00, 1.00016105e+00, 1.00014532e+00, + 1.00012910e+00, 1.00011253e+00, 1.00009573e+00, 1.00007868e+00, + 1.00006139e+00, 1.00004399e+00, 1.00002646e+00, 1.00000882e+00, + 9.99991179e-01, 9.99973595e-01, 9.99956071e-01, 9.99938667e-01, + 9.99921381e-01, 9.99904335e-01, 9.99887526e-01, 9.99870956e-01, + 9.99854743e-01, 9.99838948e-01, 9.99823511e-01, 9.99808550e-01, + 9.99794066e-01, 9.99780118e-01, 9.99766707e-01, 9.99753952e-01, + 9.99741793e-01, 9.99730289e-01, 9.99719560e-01, 9.99709487e-01, + 9.99700248e-01, 9.99691784e-01, 9.99684095e-01, 9.99677300e-01, + 9.99671280e-01, 9.99666214e-01, 9.99662042e-01, 9.99658763e-01, + 9.99656379e-01, 9.99655008e-01, 9.99654531e-01, 9.99654949e-01, + 9.99656379e-01, 9.99658763e-01, 9.99662101e-01, 9.99666333e-01, + 9.99671519e-01, 9.99677658e-01, 9.99684691e-01, 9.99692619e-01, + 9.99701381e-01, 9.99711037e-01, 9.99721527e-01, 9.99732792e-01, + 9.99744833e-01, 9.99757588e-01, 9.99771118e-01, 9.99785244e-01, + 9.99800026e-01, 9.99815404e-01, 9.99831259e-01, 9.99847651e-01, + 9.99864519e-01, 9.99881744e-01, 9.99899328e-01, 9.99917269e-01, + 9.99935389e-01, 9.99953687e-01, 9.99972165e-01, 9.99990702e-01, + 1.00000930e+00, 1.00002778e+00, 1.00004625e+00, 1.00006461e+00, + 1.00008273e+00, 1.00010061e+00, 1.00011826e+00, 1.00013554e+00, + 1.00015235e+00, 1.00016880e+00, 1.00018466e+00, 1.00020003e+00, + 1.00021482e+00, 1.00022900e+00, 1.00024247e+00, 1.00025523e+00, + 1.00026727e+00, 1.00027859e+00, 1.00028908e+00, 1.00029874e+00, + 1.00030744e+00, 1.00031543e+00, 1.00032246e+00, 1.00032854e+00, + 1.00033379e+00, 1.00033808e+00, 1.00034130e+00, 1.00034368e+00, + 1.00034511e+00, 1.00034559e+00, 1.00034511e+00, 1.00034368e+00, + 1.00034142e+00, 1.00033808e+00, 1.00033391e+00, 1.00032878e+00, + 1.00032282e+00, 1.00031602e+00, 1.00030828e+00, 1.00029981e+00, + 1.00029051e+00, 1.00028050e+00, 1.00026977e+00, 1.00025833e+00, + 1.00024617e+00, 1.00023329e+00, 1.00021994e+00, 1.00020599e+00, + 1.00019157e+00, 1.00017655e+00, 1.00016105e+00, 1.00014532e+00, + 1.00012910e+00, 1.00011253e+00, 1.00009573e+00, 1.00007868e+00, + 1.00006139e+00, 1.00004399e+00, 1.00002646e+00, 1.00000882e+00, + 9.99991179e-01, 9.99973595e-01, 9.99956071e-01, 9.99938667e-01, + 9.99921381e-01, 9.99904335e-01, 9.99887526e-01, 9.99870956e-01, + 9.99854743e-01, 9.99838948e-01, 9.99823511e-01, 9.99808550e-01, + 9.99794066e-01, 9.99780118e-01, 9.99766707e-01, 9.99753952e-01, + 9.99741793e-01, 9.99730289e-01, 9.99719560e-01, 9.99709487e-01, + 9.99700248e-01, 9.99691784e-01, 9.99684095e-01, 9.99677300e-01, + 9.99671280e-01, 9.99666214e-01, 9.99662042e-01, 9.99658763e-01, + 9.99656379e-01, 9.99655008e-01, 9.99654531e-01, 9.99654949e-01, + 9.99656379e-01, 9.99658763e-01, 9.99662101e-01, 9.99666333e-01, + 9.99671519e-01, 9.99677658e-01, 9.99684691e-01, 9.99692619e-01, + 9.99701381e-01, 9.99711037e-01, 9.99721527e-01, 9.99732792e-01, + 9.99744833e-01, 9.99757588e-01, 9.99771118e-01, 9.99785244e-01, + 9.99800026e-01, 9.99815404e-01, 9.99831259e-01, 9.99847651e-01, + 9.99864519e-01, 9.99881744e-01, 9.99899328e-01, 9.99917269e-01, + 9.99935389e-01, 9.99953687e-01, 9.99972165e-01, 9.99990702e-01, + 1.00000930e+00, 1.00002778e+00, 1.00004613e+00, 1.00006425e+00, + 1.00008214e+00, 1.00009966e+00, 1.00011683e+00, 1.00013340e+00, + 1.00014925e+00, 1.00016439e+00, 1.00017869e+00, 1.00019193e+00, + 1.00020397e+00, 1.00021482e+00, 1.00022411e+00, 1.00023162e+00, + 1.00023735e+00, 1.00024080e+00, 1.00024199e+00, 1.00024033e+00, + 1.00023568e+00, 1.00022769e+00, 1.00021589e+00, 1.00020003e+00, + 1.00017941e+00, 1.00015378e+00, 1.00012243e+00, 1.00008476e+00, + 1.00004041e+00, 9.99988317e-01, 9.99928057e-01, 9.99858677e-01, + 9.99779403e-01, 9.99689281e-01, 9.99587417e-01, 9.99472737e-01, + 9.99344110e-01, 9.99200404e-01, 9.99040425e-01, 9.98862803e-01, + 9.98666167e-01, 9.98449087e-01, 9.98209953e-01, 9.97947097e-01, + 9.97658968e-01, 9.97343540e-01, 9.96999085e-01, 9.96623516e-01, + 9.96214747e-01, 9.95770633e-01, 9.95288789e-01, 9.94766831e-01, + 9.94202256e-01, 9.93592501e-01, 9.92934704e-01, 9.92226064e-01, + 9.91463542e-01, 9.90644097e-01, 9.89764392e-01, 9.88821149e-01, + 9.87810850e-01, 9.86729801e-01, 9.85574305e-01, 9.84340370e-01, + 9.83024001e-01, 9.81621027e-01, 9.80127096e-01, 9.78537738e-01, + 9.76848423e-01, 9.75054383e-01, 9.73150730e-01, 9.71132576e-01, + 9.68994796e-01, 9.66732204e-01, 9.64339435e-01, 9.61811244e-01, + 9.59142029e-01, 9.56326306e-01, 9.53358531e-01, 9.50233042e-01, + 9.46944118e-01, 9.43486214e-01, 9.39853668e-01, 9.36040819e-01, + 9.32042122e-01, 9.27852154e-01, 9.23465431e-01, 9.18876767e-01, + 9.14081097e-01, 9.09073353e-01, 9.03848886e-01, 8.98403168e-01, + 8.92731845e-01, 8.86831045e-01, 8.80696952e-01, 8.74326289e-01, + 8.67715955e-01, 8.60863328e-01, 8.53766203e-01, 8.46422672e-01, + 8.38831365e-01, 8.30991328e-01, 8.22902203e-01, 8.14563930e-01, + 8.05977046e-01, 7.97142744e-01, 7.88062632e-01, 7.78738797e-01, + 7.69173980e-01, 7.59371519e-01, 7.49335289e-01, 7.39069760e-01, + 7.28579819e-01, 7.17871130e-01, 7.06949770e-01, 6.95822597e-01, + 6.84496701e-01, 6.72980070e-01, 6.61280870e-01, 6.49408042e-01, + 6.37370944e-01, 6.25179410e-01, 6.12843752e-01, 6.00374699e-01, + 5.87783396e-01, 5.75081468e-01, 5.62280834e-01, 5.49393654e-01, + 5.36432624e-01, 5.23410499e-01, 5.10340393e-01, 4.97235566e-01, + 4.84109521e-01, 4.70975846e-01, 4.57848251e-01, 4.44740474e-01, + 4.31666315e-01, 4.18639511e-01, 4.05673832e-01, 3.92782807e-01, + 3.79979968e-01, 3.67278606e-01, 3.54691803e-01, 3.42232376e-01, + 3.29912812e-01, 3.17745358e-01, 3.05741847e-01, 2.93913603e-01, + 2.82271683e-01, 2.70826548e-01, 2.59588152e-01, 2.48565957e-01, + 2.37768814e-01, 2.27205008e-01, 2.16882199e-01, 2.06807390e-01, + 1.96986943e-01, 1.87426537e-01, 1.78131178e-01, 1.69105172e-01, + 1.60352126e-01, 1.51874945e-01, 1.43675804e-01, 1.35756254e-01, + 1.28117070e-01, 1.20758407e-01, 1.13679729e-01, 1.06879868e-01, + 1.00357018e-01, 9.41087753e-02, 8.81321430e-02, 8.24235976e-02, + 7.69790635e-02, 7.17940032e-02, 6.68634027e-02, 6.21818379e-02, + 5.77434972e-02, 5.35422154e-02, 4.95715141e-02, 4.58246432e-02, + 4.22946103e-02, 3.89742292e-02, 3.58561426e-02, 3.29328589e-02, + 3.01968064e-02, 2.76403390e-02, 2.52557844e-02, 2.30354760e-02, + 2.09717732e-02, 1.90570969e-02, 1.72839500e-02, 1.56449396e-02, + 1.41328052e-02, 1.27404351e-02, 1.14608845e-02, 1.02873892e-02, + 9.21338331e-03, 8.23251065e-03, 7.33863330e-03, 6.52584061e-03, + 5.78845851e-03, 5.12105133e-03, 4.51842742e-03, 3.97564145e-03, + 3.48799396e-03, 3.05103138e-03, 2.66054412e-03, 2.31256452e-03, + 2.00336217e-03, 1.72943878e-03, 1.48752402e-03, 1.27456791e-03, + 1.08773448e-03, 9.24394117e-04, 7.82115792e-04, 6.58658682e-04, + 5.51963516e-04, 4.60143900e-04, 3.81477352e-04, 3.14396282e-04, + 2.57478940e-04, 2.09440448e-04, 1.69123945e-04, 1.35491777e-04, + 1.07617016e-04, 8.46750627e-05, 6.59356156e-05, 5.07548866e-05, + 3.85681342e-05, 2.88825358e-05, 2.12704090e-05, 1.53627971e-05, + 1.08434460e-05, 7.44312956e-06, 4.93438165e-06, 3.12659085e-06, + 1.86147406e-06, 1.00890213e-06, 4.63012810e-07, 1.37904777e-07, +}; + +#endif /* LC3_PLUS_HR */ +#endif /* LC3_PLUS */ + +static const float mdct_win_7m5_8k[__LC3_MDCT_WIN_LEN(7500, 8000)] = { + 2.95060859e-03, 7.17541132e-03, 1.37695374e-02, 2.30953556e-02, + 3.54036230e-02, 5.08289304e-02, 6.94696293e-02, 9.13884278e-02, + 1.16604575e-01, 1.45073546e-01, 1.76711174e-01, 2.11342953e-01, + 2.48768614e-01, 2.88701102e-01, 3.30823871e-01, 3.74814544e-01, + 4.20308013e-01, 4.66904918e-01, 5.14185341e-01, 5.61710041e-01, + 6.09026346e-01, 6.55671016e-01, 7.01218384e-01, 7.45240679e-01, + 7.87369206e-01, 8.27223833e-01, 8.64513675e-01, 8.98977415e-01, + 9.30407518e-01, 9.58599937e-01, 9.83447719e-01, 1.00488283e+00, + 1.02285381e+00, 1.03740495e+00, 1.04859791e+00, 1.05656184e+00, + 1.06149371e+00, 1.06362578e+00, 1.06325973e+00, 1.06074505e+00, + 1.05643590e+00, 1.05069500e+00, 1.04392435e+00, 1.03647725e+00, + 1.02872867e+00, 1.02106486e+00, 1.01400658e+00, 1.00727455e+00, + 1.00172250e+00, 9.97309592e-01, 9.93985158e-01, 9.91683335e-01, + 9.90325325e-01, 9.89822613e-01, 9.90074734e-01, 9.90975314e-01, + 9.92412851e-01, 9.94273149e-01, 9.96439157e-01, 9.98791616e-01, + 1.00120985e+00, 1.00357357e+00, 1.00575984e+00, 1.00764515e+00, + 1.00910687e+00, 1.01002476e+00, 1.01028203e+00, 1.00976919e+00, + 1.00838641e+00, 1.00605124e+00, 1.00269767e+00, 9.98280464e-01, + 9.92777987e-01, 9.86186892e-01, 9.77634164e-01, 9.67447270e-01, + 9.55129725e-01, 9.40389877e-01, 9.22959280e-01, 9.02607350e-01, + 8.79202689e-01, 8.52641750e-01, 8.22881272e-01, 7.89971715e-01, + 7.54030328e-01, 7.15255742e-01, 6.73936911e-01, 6.30414716e-01, + 5.85078858e-01, 5.38398518e-01, 4.90833753e-01, 4.42885823e-01, + 3.95091024e-01, 3.48004343e-01, 3.02196710e-01, 2.58227431e-01, + 2.16641416e-01, 1.77922122e-01, 1.42480547e-01, 1.10652194e-01, + 8.26995967e-02, 5.88334516e-02, 3.92030848e-02, 2.38629107e-02, + 1.26976223e-02, 5.35665361e-03, +}; + +static const float mdct_win_7m5_16k[__LC3_MDCT_WIN_LEN(7500, 16000)] = { + 2.20824874e-03, 3.81014420e-03, 5.91552473e-03, 8.58361457e-03, + 1.18759723e-02, 1.58335301e-02, 2.04918652e-02, 2.58883593e-02, + 3.20415894e-02, 3.89616721e-02, 4.66742169e-02, 5.51849337e-02, + 6.45038384e-02, 7.46411071e-02, 8.56000162e-02, 9.73846703e-02, + 1.09993603e-01, 1.23419277e-01, 1.37655457e-01, 1.52690437e-01, + 1.68513363e-01, 1.85093105e-01, 2.02410419e-01, 2.20450365e-01, + 2.39167941e-01, 2.58526168e-01, 2.78498539e-01, 2.99038432e-01, + 3.20104862e-01, 3.41658622e-01, 3.63660034e-01, 3.86062695e-01, + 4.08815272e-01, 4.31871046e-01, 4.55176988e-01, 4.78676593e-01, + 5.02324813e-01, 5.26060916e-01, 5.49831283e-01, 5.73576883e-01, + 5.97241338e-01, 6.20770242e-01, 6.44099662e-01, 6.67176382e-01, + 6.89958854e-01, 7.12379980e-01, 7.34396372e-01, 7.55966688e-01, + 7.77036981e-01, 7.97558114e-01, 8.17490856e-01, 8.36796950e-01, + 8.55447310e-01, 8.73400798e-01, 8.90635719e-01, 9.07128770e-01, + 9.22848784e-01, 9.37763323e-01, 9.51860206e-01, 9.65130600e-01, + 9.77556541e-01, 9.89126209e-01, 9.99846919e-01, 1.00970073e+00, + 1.01868229e+00, 1.02681455e+00, 1.03408981e+00, 1.04051196e+00, + 1.04610837e+00, 1.05088565e+00, 1.05486289e+00, 1.05807221e+00, + 1.06053414e+00, 1.06227662e+00, 1.06333815e+00, 1.06375557e+00, + 1.06356632e+00, 1.06282156e+00, 1.06155996e+00, 1.05981709e+00, + 1.05765876e+00, 1.05512006e+00, 1.05223985e+00, 1.04908779e+00, + 1.04569860e+00, 1.04210831e+00, 1.03838099e+00, 1.03455276e+00, + 1.03067200e+00, 1.02679167e+00, 1.02295558e+00, 1.01920733e+00, + 1.01587289e+00, 1.01221017e+00, 1.00884559e+00, 1.00577851e+00, + 1.00300262e+00, 1.00051460e+00, 9.98309229e-01, 9.96378601e-01, + 9.94718132e-01, 9.93316216e-01, 9.92166957e-01, 9.91258603e-01, + 9.90581104e-01, 9.90123118e-01, 9.89873712e-01, 9.89818707e-01, + 9.89946800e-01, 9.90243175e-01, 9.90695564e-01, 9.91288540e-01, + 9.92009469e-01, 9.92842693e-01, 9.93775067e-01, 9.94790398e-01, + 9.95875534e-01, 9.97014367e-01, 9.98192871e-01, 9.99394506e-01, + 1.00060586e+00, 1.00181040e+00, 1.00299457e+00, 1.00414155e+00, + 1.00523688e+00, 1.00626393e+00, 1.00720890e+00, 1.00805489e+00, + 1.00878802e+00, 1.00939182e+00, 1.00985296e+00, 1.01015529e+00, + 1.01028602e+00, 1.01022988e+00, 1.00997541e+00, 1.00950846e+00, + 1.00881848e+00, 1.00789488e+00, 1.00672876e+00, 1.00530991e+00, + 1.00363456e+00, 1.00169363e+00, 9.99485663e-01, 9.97006370e-01, + 9.94254687e-01, 9.91231967e-01, 9.87937115e-01, 9.84375125e-01, + 9.79890963e-01, 9.75269879e-01, 9.70180498e-01, 9.64580027e-01, + 9.58425534e-01, 9.51684014e-01, 9.44320232e-01, 9.36290624e-01, + 9.27580507e-01, 9.18153414e-01, 9.07976524e-01, 8.97050058e-01, + 8.85351360e-01, 8.72857927e-01, 8.59579819e-01, 8.45502615e-01, + 8.30619943e-01, 8.14946648e-01, 7.98489378e-01, 7.81262450e-01, + 7.63291769e-01, 7.44590843e-01, 7.25199287e-01, 7.05153668e-01, + 6.84490545e-01, 6.63245210e-01, 6.41477162e-01, 6.19235334e-01, + 5.96559133e-01, 5.73519989e-01, 5.50173851e-01, 5.26568538e-01, + 5.02781159e-01, 4.78860889e-01, 4.54877894e-01, 4.30898123e-01, + 4.06993964e-01, 3.83234031e-01, 3.59680098e-01, 3.36408100e-01, + 3.13496418e-01, 2.91010565e-01, 2.69019585e-01, 2.47584348e-01, + 2.26788433e-01, 2.06677771e-01, 1.87310343e-01, 1.68739644e-01, + 1.51012382e-01, 1.34171842e-01, 1.18254662e-01, 1.03290734e-01, + 8.93117360e-02, 7.63429787e-02, 6.44077291e-02, 5.35243715e-02, + 4.37084453e-02, 3.49667099e-02, 2.72984629e-02, 2.06895808e-02, + 1.51125125e-02, 1.05228754e-02, 6.85547314e-03, 4.02351119e-03, +}; + +static const float mdct_win_7m5_24k[__LC3_MDCT_WIN_LEN(7500, 24000)] = { + 1.97084908e-03, 2.95060859e-03, 4.12447721e-03, 5.52688664e-03, + 7.17541132e-03, 9.08757730e-03, 1.12819105e-02, 1.37695374e-02, + 1.65600266e-02, 1.96650895e-02, 2.30953556e-02, 2.68612894e-02, + 3.09632560e-02, 3.54036230e-02, 4.01915610e-02, 4.53331403e-02, + 5.08289304e-02, 5.66815448e-02, 6.28935304e-02, 6.94696293e-02, + 7.64106314e-02, 8.37160016e-02, 9.13884278e-02, 9.94294008e-02, + 1.07834725e-01, 1.16604575e-01, 1.25736503e-01, 1.35226811e-01, + 1.45073546e-01, 1.55273819e-01, 1.65822194e-01, 1.76711174e-01, + 1.87928776e-01, 1.99473180e-01, 2.11342953e-01, 2.23524554e-01, + 2.36003100e-01, 2.48768614e-01, 2.61813811e-01, 2.75129161e-01, + 2.88701102e-01, 3.02514034e-01, 3.16558805e-01, 3.30823871e-01, + 3.45295567e-01, 3.59963992e-01, 3.74814544e-01, 3.89831817e-01, + 4.05001010e-01, 4.20308013e-01, 4.35739515e-01, 4.51277817e-01, + 4.66904918e-01, 4.82609041e-01, 4.98375466e-01, 5.14185341e-01, + 5.30021478e-01, 5.45869352e-01, 5.61710041e-01, 5.77528151e-01, + 5.93304696e-01, 6.09026346e-01, 6.24674189e-01, 6.40227555e-01, + 6.55671016e-01, 6.70995935e-01, 6.86184559e-01, 7.01218384e-01, + 7.16078449e-01, 7.30756084e-01, 7.45240679e-01, 7.59515122e-01, + 7.73561955e-01, 7.87369206e-01, 8.00923138e-01, 8.14211386e-01, + 8.27223833e-01, 8.39952374e-01, 8.52386102e-01, 8.64513675e-01, + 8.76324079e-01, 8.87814288e-01, 8.98977415e-01, 9.09803319e-01, + 9.20284312e-01, 9.30407518e-01, 9.40169652e-01, 9.49567795e-01, + 9.58599937e-01, 9.67260260e-01, 9.75545166e-01, 9.83447719e-01, + 9.90971957e-01, 9.98119269e-01, 1.00488283e+00, 1.01125773e+00, + 1.01724436e+00, 1.02285381e+00, 1.02808734e+00, 1.03293706e+00, + 1.03740495e+00, 1.04150164e+00, 1.04523236e+00, 1.04859791e+00, + 1.05160340e+00, 1.05425505e+00, 1.05656184e+00, 1.05853400e+00, + 1.06017414e+00, 1.06149371e+00, 1.06249943e+00, 1.06320577e+00, + 1.06362578e+00, 1.06376487e+00, 1.06363778e+00, 1.06325973e+00, + 1.06264695e+00, 1.06180496e+00, 1.06074505e+00, 1.05948492e+00, + 1.05804533e+00, 1.05643590e+00, 1.05466218e+00, 1.05274047e+00, + 1.05069500e+00, 1.04853894e+00, 1.04627898e+00, 1.04392435e+00, + 1.04149540e+00, 1.03901003e+00, 1.03647725e+00, 1.03390793e+00, + 1.03131989e+00, 1.02872867e+00, 1.02614832e+00, 1.02358988e+00, + 1.02106486e+00, 1.01856262e+00, 1.01655770e+00, 1.01400658e+00, + 1.01162953e+00, 1.00938590e+00, 1.00727455e+00, 1.00529616e+00, + 1.00344526e+00, 1.00172250e+00, 1.00012792e+00, 9.98657533e-01, + 9.97309592e-01, 9.96083571e-01, 9.94976569e-01, 9.93985158e-01, + 9.93107530e-01, 9.92341305e-01, 9.91683335e-01, 9.91130070e-01, + 9.90678325e-01, 9.90325325e-01, 9.90067562e-01, 9.89901282e-01, + 9.89822613e-01, 9.89827845e-01, 9.89913241e-01, 9.90074734e-01, + 9.90308256e-01, 9.90609852e-01, 9.90975314e-01, 9.91400330e-01, + 9.91880966e-01, 9.92412851e-01, 9.92991779e-01, 9.93613381e-01, + 9.94273149e-01, 9.94966958e-01, 9.95690370e-01, 9.96439157e-01, + 9.97208572e-01, 9.97994275e-01, 9.98791616e-01, 9.99596062e-01, + 1.00040410e+00, 1.00120985e+00, 1.00200976e+00, 1.00279924e+00, + 1.00357357e+00, 1.00432828e+00, 1.00505850e+00, 1.00575984e+00, + 1.00642767e+00, 1.00705768e+00, 1.00764515e+00, 1.00818549e+00, + 1.00867427e+00, 1.00910687e+00, 1.00947916e+00, 1.00978659e+00, + 1.01002476e+00, 1.01018954e+00, 1.01027669e+00, 1.01028203e+00, + 1.01020174e+00, 1.01003208e+00, 1.00976919e+00, 1.00940939e+00, + 1.00894931e+00, 1.00838641e+00, 1.00771780e+00, 1.00694031e+00, + 1.00605124e+00, 1.00504879e+00, 1.00393183e+00, 1.00269767e+00, + 1.00134427e+00, 9.99872092e-01, 9.98280464e-01, 9.96566569e-01, + 9.94731737e-01, 9.92777987e-01, 9.90701374e-01, 9.88504165e-01, + 9.86186892e-01, 9.83711989e-01, 9.80584643e-01, 9.77634164e-01, + 9.74455033e-01, 9.71062916e-01, 9.67447270e-01, 9.63593926e-01, + 9.59491398e-01, 9.55129725e-01, 9.50501326e-01, 9.45592810e-01, + 9.40389877e-01, 9.34886760e-01, 9.29080559e-01, 9.22959280e-01, + 9.16509579e-01, 9.09724456e-01, 9.02607350e-01, 8.95155084e-01, + 8.87356154e-01, 8.79202689e-01, 8.70699698e-01, 8.61847424e-01, + 8.52641750e-01, 8.43077833e-01, 8.33154905e-01, 8.22881272e-01, + 8.12257597e-01, 8.01285439e-01, 7.89971715e-01, 7.78318177e-01, + 7.66337710e-01, 7.54030328e-01, 7.41407991e-01, 7.28477501e-01, + 7.15255742e-01, 7.01751739e-01, 6.87975632e-01, 6.73936911e-01, + 6.59652573e-01, 6.45139489e-01, 6.30414716e-01, 6.15483622e-01, + 6.00365852e-01, 5.85078858e-01, 5.69649536e-01, 5.54084810e-01, + 5.38398518e-01, 5.22614738e-01, 5.06756805e-01, 4.90833753e-01, + 4.74866033e-01, 4.58876566e-01, 4.42885823e-01, 4.26906539e-01, + 4.10970973e-01, 3.95091024e-01, 3.79291327e-01, 3.63587417e-01, + 3.48004343e-01, 3.32563201e-01, 3.17287485e-01, 3.02196710e-01, + 2.87309403e-01, 2.72643992e-01, 2.58227431e-01, 2.44072856e-01, + 2.30208977e-01, 2.16641416e-01, 2.03398481e-01, 1.90486162e-01, + 1.77922122e-01, 1.65726674e-01, 1.53906397e-01, 1.42480547e-01, + 1.31453980e-01, 1.20841778e-01, 1.10652194e-01, 1.00891734e-01, + 9.15718851e-02, 8.26995967e-02, 7.42815529e-02, 6.63242382e-02, + 5.88334516e-02, 5.18140676e-02, 4.52698346e-02, 3.92030848e-02, + 3.36144159e-02, 2.85023308e-02, 2.38629107e-02, 1.96894227e-02, + 1.59720527e-02, 1.26976223e-02, 9.84937739e-03, 7.40724463e-03, + 5.35665361e-03, 3.83226552e-03, +}; + +static const float mdct_win_7m5_32k[__LC3_MDCT_WIN_LEN(7500, 32000)] = { + 1.84833037e-03, 2.56481839e-03, 3.36762118e-03, 4.28736617e-03, + 5.33830143e-03, 6.52679223e-03, 7.86112587e-03, 9.34628179e-03, + 1.09916868e-02, 1.28011172e-02, 1.47805911e-02, 1.69307043e-02, + 1.92592307e-02, 2.17696937e-02, 2.44685983e-02, 2.73556543e-02, + 3.04319230e-02, 3.36980464e-02, 3.71583577e-02, 4.08148180e-02, + 4.46708068e-02, 4.87262995e-02, 5.29820633e-02, 5.74382470e-02, + 6.20968580e-02, 6.69609767e-02, 7.20298364e-02, 7.73039146e-02, + 8.27825574e-02, 8.84682102e-02, 9.43607566e-02, 1.00460272e-01, + 1.06763824e-01, 1.13273679e-01, 1.19986420e-01, 1.26903521e-01, + 1.34020853e-01, 1.41339557e-01, 1.48857211e-01, 1.56573685e-01, + 1.64484622e-01, 1.72589077e-01, 1.80879090e-01, 1.89354320e-01, + 1.98012244e-01, 2.06854141e-01, 2.15875319e-01, 2.25068672e-01, + 2.34427407e-01, 2.43948314e-01, 2.53627993e-01, 2.63464061e-01, + 2.73450494e-01, 2.83582189e-01, 2.93853469e-01, 3.04257373e-01, + 3.14790914e-01, 3.25449123e-01, 3.36227410e-01, 3.47118760e-01, + 3.58120177e-01, 3.69224663e-01, 3.80427793e-01, 3.91720023e-01, + 4.03097022e-01, 4.14551955e-01, 4.26081719e-01, 4.37676318e-01, + 4.49330196e-01, 4.61034855e-01, 4.72786043e-01, 4.84576777e-01, + 4.96401707e-01, 5.08252458e-01, 5.20122078e-01, 5.32002077e-01, + 5.43888090e-01, 5.55771601e-01, 5.67645739e-01, 5.79502786e-01, + 5.91335035e-01, 6.03138367e-01, 6.14904172e-01, 6.26623941e-01, + 6.38288834e-01, 6.49893375e-01, 6.61432360e-01, 6.72902514e-01, + 6.84293750e-01, 6.95600460e-01, 7.06811784e-01, 7.17923425e-01, + 7.28931386e-01, 7.39832773e-01, 7.50618982e-01, 7.61284053e-01, + 7.71818919e-01, 7.82220992e-01, 7.92481330e-01, 8.02599448e-01, + 8.12565230e-01, 8.22377129e-01, 8.32030518e-01, 8.41523208e-01, + 8.50848313e-01, 8.60002412e-01, 8.68979881e-01, 8.77778347e-01, + 8.86395904e-01, 8.94829421e-01, 9.03077626e-01, 9.11132652e-01, + 9.18993585e-01, 9.26652937e-01, 9.34111420e-01, 9.41364344e-01, + 9.48412967e-01, 9.55255630e-01, 9.61892013e-01, 9.68316363e-01, + 9.74530156e-01, 9.80528338e-01, 9.86313928e-01, 9.91886049e-01, + 9.97246345e-01, 1.00239190e+00, 1.00731946e+00, 1.01202707e+00, + 1.01651654e+00, 1.02079430e+00, 1.02486082e+00, 1.02871471e+00, + 1.03235170e+00, 1.03577375e+00, 1.03898432e+00, 1.04198786e+00, + 1.04478564e+00, 1.04737818e+00, 1.04976743e+00, 1.05195405e+00, + 1.05394290e+00, 1.05573463e+00, 1.05734177e+00, 1.05875726e+00, + 1.05998674e+00, 1.06103672e+00, 1.06190651e+00, 1.06260369e+00, + 1.06313289e+00, 1.06350237e+00, 1.06370981e+00, 1.06376322e+00, + 1.06366765e+00, 1.06343012e+00, 1.06305656e+00, 1.06255421e+00, + 1.06192235e+00, 1.06116702e+00, 1.06029469e+00, 1.05931469e+00, + 1.05823465e+00, 1.05705891e+00, 1.05578948e+00, 1.05442979e+00, + 1.05298793e+00, 1.05147505e+00, 1.04989930e+00, 1.04826213e+00, + 1.04656691e+00, 1.04481699e+00, 1.04302125e+00, 1.04118768e+00, + 1.03932339e+00, 1.03743168e+00, 1.03551757e+00, 1.03358511e+00, + 1.03164371e+00, 1.02969955e+00, 1.02775944e+00, 1.02582719e+00, + 1.02390791e+00, 1.02200805e+00, 1.02013910e+00, 1.01826310e+00, + 1.01687901e+00, 1.01492195e+00, 1.01309662e+00, 1.01134205e+00, + 1.00965912e+00, 1.00805036e+00, 1.00651754e+00, 1.00505799e+00, + 1.00366956e+00, 1.00235327e+00, 1.00110981e+00, 9.99937523e-01, + 9.98834524e-01, 9.97800606e-01, 9.96835756e-01, 9.95938881e-01, + 9.95108459e-01, 9.94343411e-01, 9.93642921e-01, 9.93005832e-01, + 9.92430984e-01, 9.91917493e-01, 9.91463898e-01, 9.91068214e-01, + 9.90729218e-01, 9.90446225e-01, 9.90217819e-01, 9.90041963e-01, + 9.89917085e-01, 9.89841975e-01, 9.89815048e-01, 9.89834329e-01, + 9.89898211e-01, 9.90005403e-01, 9.90154189e-01, 9.90342427e-01, + 9.90568459e-01, 9.90830953e-01, 9.91128038e-01, 9.91457566e-01, + 9.91817881e-01, 9.92207559e-01, 9.92624757e-01, 9.93067358e-01, + 9.93533398e-01, 9.94021410e-01, 9.94529685e-01, 9.95055964e-01, + 9.95598351e-01, 9.96155580e-01, 9.96725627e-01, 9.97306092e-01, + 9.97895214e-01, 9.98491441e-01, 9.99092890e-01, 9.99697063e-01, + 1.00030303e+00, 1.00090793e+00, 1.00151084e+00, 1.00210923e+00, + 1.00270118e+00, 1.00328513e+00, 1.00385926e+00, 1.00442111e+00, + 1.00496860e+00, 1.00550040e+00, 1.00601455e+00, 1.00650869e+00, + 1.00698104e+00, 1.00743004e+00, 1.00785364e+00, 1.00824962e+00, + 1.00861604e+00, 1.00895138e+00, 1.00925390e+00, 1.00952134e+00, + 1.00975175e+00, 1.00994371e+00, 1.01009550e+00, 1.01020488e+00, + 1.01027007e+00, 1.01028975e+00, 1.01026227e+00, 1.01018562e+00, + 1.01005820e+00, 1.00987882e+00, 1.00964593e+00, 1.00935753e+00, + 1.00901228e+00, 1.00860959e+00, 1.00814837e+00, 1.00762674e+00, + 1.00704343e+00, 1.00639775e+00, 1.00568877e+00, 1.00491559e+00, + 1.00407768e+00, 1.00317429e+00, 1.00220424e+00, 1.00116684e+00, + 1.00006248e+00, 9.98891422e-01, 9.97652252e-01, 9.96343856e-01, + 9.94967462e-01, 9.93524663e-01, 9.92013927e-01, 9.90433283e-01, + 9.88785147e-01, 9.87072681e-01, 9.85297443e-01, 9.83401161e-01, + 9.80949418e-01, 9.78782729e-01, 9.76468238e-01, 9.74042850e-01, + 9.71498848e-01, 9.68829968e-01, 9.66030974e-01, 9.63095104e-01, + 9.60018198e-01, 9.56795738e-01, 9.53426267e-01, 9.49903482e-01, + 9.46222115e-01, 9.42375820e-01, 9.38361702e-01, 9.34177798e-01, + 9.29823124e-01, 9.25292320e-01, 9.20580120e-01, 9.15679793e-01, + 9.10590604e-01, 9.05315030e-01, 8.99852756e-01, 8.94199497e-01, + 8.88350152e-01, 8.82301631e-01, 8.76054874e-01, 8.69612385e-01, + 8.62972799e-01, 8.56135198e-01, 8.49098179e-01, 8.41857024e-01, + 8.34414055e-01, 8.26774617e-01, 8.18939244e-01, 8.10904891e-01, + 8.02675318e-01, 7.94253751e-01, 7.85641662e-01, 7.76838609e-01, + 7.67853193e-01, 7.58685181e-01, 7.49330658e-01, 7.39809171e-01, + 7.30109944e-01, 7.20247781e-01, 7.10224161e-01, 7.00044326e-01, + 6.89711890e-01, 6.79231154e-01, 6.68608179e-01, 6.57850997e-01, + 6.46965718e-01, 6.35959617e-01, 6.24840336e-01, 6.13603503e-01, + 6.02265091e-01, 5.90829083e-01, 5.79309408e-01, 5.67711124e-01, + 5.56037416e-01, 5.44293664e-01, 5.32489768e-01, 5.20636084e-01, + 5.08743273e-01, 4.96811166e-01, 4.84849881e-01, 4.72868107e-01, + 4.60875918e-01, 4.48881081e-01, 4.36891039e-01, 4.24912022e-01, + 4.12960603e-01, 4.01035896e-01, 3.89157867e-01, 3.77322199e-01, + 3.65543767e-01, 3.53832356e-01, 3.42196115e-01, 3.30644820e-01, + 3.19187559e-01, 3.07833309e-01, 2.96588182e-01, 2.85463717e-01, + 2.74462409e-01, 2.63609584e-01, 2.52883101e-01, 2.42323489e-01, + 2.31925746e-01, 2.21690837e-01, 2.11638058e-01, 2.01766920e-01, + 1.92082236e-01, 1.82589160e-01, 1.73305997e-01, 1.64229200e-01, + 1.55362654e-01, 1.46717079e-01, 1.38299391e-01, 1.30105078e-01, + 1.22145310e-01, 1.14423458e-01, 1.06941076e-01, 9.97025893e-02, + 9.27124283e-02, 8.59737427e-02, 7.94893311e-02, 7.32616579e-02, + 6.72934102e-02, 6.15874081e-02, 5.61458003e-02, 5.09700747e-02, + 4.60617047e-02, 4.14220117e-02, 3.70514189e-02, 3.29494666e-02, + 2.91153327e-02, 2.55476401e-02, 2.22437711e-02, 1.92000659e-02, + 1.64122205e-02, 1.38747611e-02, 1.15806353e-02, 9.52213664e-03, + 7.69137380e-03, 6.07207833e-03, 4.62581217e-03, 3.60685164e-03, +}; + +static const float mdct_win_7m5_48k[__LC3_MDCT_WIN_LEN(7500, 48000)] = { + 1.72152668e-03, 2.20824874e-03, 2.68901752e-03, 3.22613342e-03, + 3.81014420e-03, 4.45371932e-03, 5.15369240e-03, 5.91552473e-03, + 6.73869158e-03, 7.62861841e-03, 8.58361457e-03, 9.60938437e-03, + 1.07060753e-02, 1.18759723e-02, 1.31190130e-02, 1.44390108e-02, + 1.58335301e-02, 1.73063081e-02, 1.88584711e-02, 2.04918652e-02, + 2.22061476e-02, 2.40057166e-02, 2.58883593e-02, 2.78552326e-02, + 2.99059145e-02, 3.20415894e-02, 3.42610013e-02, 3.65680973e-02, + 3.89616721e-02, 4.14435824e-02, 4.40140796e-02, 4.66742169e-02, + 4.94214625e-02, 5.22588489e-02, 5.51849337e-02, 5.82005143e-02, + 6.13059845e-02, 6.45038384e-02, 6.77913923e-02, 7.11707833e-02, + 7.46411071e-02, 7.82028053e-02, 8.18549521e-02, 8.56000162e-02, + 8.94357617e-02, 9.33642589e-02, 9.73846703e-02, 1.01496718e-01, + 1.05698760e-01, 1.09993603e-01, 1.14378287e-01, 1.18853508e-01, + 1.23419277e-01, 1.28075997e-01, 1.32820581e-01, 1.37655457e-01, + 1.42578648e-01, 1.47590522e-01, 1.52690437e-01, 1.57878853e-01, + 1.63152529e-01, 1.68513363e-01, 1.73957969e-01, 1.79484737e-01, + 1.85093105e-01, 1.90784835e-01, 1.96556497e-01, 2.02410419e-01, + 2.08345433e-01, 2.14359825e-01, 2.20450365e-01, 2.26617296e-01, + 2.32856279e-01, 2.39167941e-01, 2.45550642e-01, 2.52003951e-01, + 2.58526168e-01, 2.65118408e-01, 2.71775911e-01, 2.78498539e-01, + 2.85284606e-01, 2.92132459e-01, 2.99038432e-01, 3.06004256e-01, + 3.13026529e-01, 3.20104862e-01, 3.27237324e-01, 3.34423210e-01, + 3.41658622e-01, 3.48944976e-01, 3.56279252e-01, 3.63660034e-01, + 3.71085146e-01, 3.78554327e-01, 3.86062695e-01, 3.93610554e-01, + 4.01195225e-01, 4.08815272e-01, 4.16468460e-01, 4.24155411e-01, + 4.31871046e-01, 4.39614744e-01, 4.47384019e-01, 4.55176988e-01, + 4.62990138e-01, 4.70824619e-01, 4.78676593e-01, 4.86545433e-01, + 4.94428714e-01, 5.02324813e-01, 5.10229471e-01, 5.18142927e-01, + 5.26060916e-01, 5.33982818e-01, 5.41906817e-01, 5.49831283e-01, + 5.57751234e-01, 5.65667636e-01, 5.73576883e-01, 5.81476666e-01, + 5.89364661e-01, 5.97241338e-01, 6.05102013e-01, 6.12946170e-01, + 6.20770242e-01, 6.28572094e-01, 6.36348526e-01, 6.44099662e-01, + 6.51820973e-01, 6.59513822e-01, 6.67176382e-01, 6.74806795e-01, + 6.82400711e-01, 6.89958854e-01, 6.97475722e-01, 7.04950145e-01, + 7.12379980e-01, 7.19765434e-01, 7.27103833e-01, 7.34396372e-01, + 7.41638561e-01, 7.48829639e-01, 7.55966688e-01, 7.63049259e-01, + 7.70072273e-01, 7.77036981e-01, 7.83941108e-01, 7.90781257e-01, + 7.97558114e-01, 8.04271381e-01, 8.10914901e-01, 8.17490856e-01, + 8.23997094e-01, 8.30432785e-01, 8.36796950e-01, 8.43089298e-01, + 8.49305847e-01, 8.55447310e-01, 8.61511037e-01, 8.67496281e-01, + 8.73400798e-01, 8.79227518e-01, 8.84972438e-01, 8.90635719e-01, + 8.96217173e-01, 9.01716414e-01, 9.07128770e-01, 9.12456578e-01, + 9.17697261e-01, 9.22848784e-01, 9.27909917e-01, 9.32882596e-01, + 9.37763323e-01, 9.42553356e-01, 9.47252428e-01, 9.51860206e-01, + 9.56376060e-01, 9.60800602e-01, 9.65130600e-01, 9.69366689e-01, + 9.73508812e-01, 9.77556541e-01, 9.81507226e-01, 9.85364580e-01, + 9.89126209e-01, 9.92794201e-01, 9.96367545e-01, 9.99846919e-01, + 1.00322812e+00, 1.00651341e+00, 1.00970073e+00, 1.01279029e+00, + 1.01578293e+00, 1.01868229e+00, 1.02148657e+00, 1.02419772e+00, + 1.02681455e+00, 1.02933598e+00, 1.03176043e+00, 1.03408981e+00, + 1.03632326e+00, 1.03846361e+00, 1.04051196e+00, 1.04246831e+00, + 1.04433331e+00, 1.04610837e+00, 1.04779018e+00, 1.04938334e+00, + 1.05088565e+00, 1.05229923e+00, 1.05362522e+00, 1.05486289e+00, + 1.05601521e+00, 1.05708746e+00, 1.05807221e+00, 1.05897524e+00, + 1.05979447e+00, 1.06053414e+00, 1.06119412e+00, 1.06177366e+00, + 1.06227662e+00, 1.06270324e+00, 1.06305569e+00, 1.06333815e+00, + 1.06354800e+00, 1.06368607e+00, 1.06375557e+00, 1.06375743e+00, + 1.06369358e+00, 1.06356632e+00, 1.06337707e+00, 1.06312782e+00, + 1.06282156e+00, 1.06245782e+00, 1.06203634e+00, 1.06155996e+00, + 1.06102951e+00, 1.06044797e+00, 1.05981709e+00, 1.05914163e+00, + 1.05842136e+00, 1.05765876e+00, 1.05685377e+00, 1.05600761e+00, + 1.05512006e+00, 1.05419505e+00, 1.05323346e+00, 1.05223985e+00, + 1.05121668e+00, 1.05016637e+00, 1.04908779e+00, 1.04798366e+00, + 1.04685334e+00, 1.04569860e+00, 1.04452056e+00, 1.04332348e+00, + 1.04210831e+00, 1.04087907e+00, 1.03963603e+00, 1.03838099e+00, + 1.03711403e+00, 1.03583813e+00, 1.03455276e+00, 1.03326200e+00, + 1.03196750e+00, 1.03067200e+00, 1.02937564e+00, 1.02808244e+00, + 1.02679167e+00, 1.02550635e+00, 1.02422655e+00, 1.02295558e+00, + 1.02169299e+00, 1.02044475e+00, 1.01920733e+00, 1.01799992e+00, + 1.01716022e+00, 1.01587289e+00, 1.01461783e+00, 1.01339738e+00, + 1.01221017e+00, 1.01105652e+00, 1.00993444e+00, 1.00884559e+00, + 1.00778956e+00, 1.00676790e+00, 1.00577851e+00, 1.00482173e+00, + 1.00389592e+00, 1.00300262e+00, 1.00214091e+00, 1.00131213e+00, + 1.00051460e+00, 9.99748988e-01, 9.99013486e-01, 9.98309229e-01, + 9.97634934e-01, 9.96991885e-01, 9.96378601e-01, 9.95795982e-01, + 9.95242217e-01, 9.94718132e-01, 9.94222122e-01, 9.93755313e-01, + 9.93316216e-01, 9.92905809e-01, 9.92522422e-01, 9.92166957e-01, + 9.91837704e-01, 9.91535508e-01, 9.91258603e-01, 9.91007878e-01, + 9.90781723e-01, 9.90581104e-01, 9.90404336e-01, 9.90252267e-01, + 9.90123118e-01, 9.90017726e-01, 9.89934325e-01, 9.89873712e-01, + 9.89834110e-01, 9.89816359e-01, 9.89818707e-01, 9.89841998e-01, + 9.89884438e-01, 9.89946800e-01, 9.90027287e-01, 9.90126680e-01, + 9.90243175e-01, 9.90377594e-01, 9.90528134e-01, 9.90695564e-01, + 9.90878043e-01, 9.91076302e-01, 9.91288540e-01, 9.91515602e-01, + 9.91755666e-01, 9.92009469e-01, 9.92275155e-01, 9.92553486e-01, + 9.92842693e-01, 9.93143533e-01, 9.93454080e-01, 9.93775067e-01, + 9.94104689e-01, 9.94443742e-01, 9.94790398e-01, 9.95145361e-01, + 9.95506800e-01, 9.95875534e-01, 9.96249681e-01, 9.96629919e-01, + 9.97014367e-01, 9.97403799e-01, 9.97796404e-01, 9.98192871e-01, + 9.98591286e-01, 9.98992436e-01, 9.99394506e-01, 9.99798247e-01, + 1.00020179e+00, 1.00060586e+00, 1.00100858e+00, 1.00141070e+00, + 1.00181040e+00, 1.00220846e+00, 1.00260296e+00, 1.00299457e+00, + 1.00338148e+00, 1.00376444e+00, 1.00414155e+00, 1.00451348e+00, + 1.00487832e+00, 1.00523688e+00, 1.00558730e+00, 1.00593027e+00, + 1.00626393e+00, 1.00658905e+00, 1.00690380e+00, 1.00720890e+00, + 1.00750238e+00, 1.00778498e+00, 1.00805489e+00, 1.00831287e+00, + 1.00855700e+00, 1.00878802e+00, 1.00900405e+00, 1.00920593e+00, + 1.00939182e+00, 1.00956244e+00, 1.00971590e+00, 1.00985296e+00, + 1.00997177e+00, 1.01007317e+00, 1.01015529e+00, 1.01021893e+00, + 1.01026225e+00, 1.01028602e+00, 1.01028842e+00, 1.01027030e+00, + 1.01022988e+00, 1.01016802e+00, 1.01008292e+00, 1.00997541e+00, + 1.00984369e+00, 1.00968863e+00, 1.00950846e+00, 1.00930404e+00, + 1.00907371e+00, 1.00881848e+00, 1.00853675e+00, 1.00822947e+00, + 1.00789488e+00, 1.00753391e+00, 1.00714488e+00, 1.00672876e+00, + 1.00628393e+00, 1.00581146e+00, 1.00530991e+00, 1.00478053e+00, + 1.00422177e+00, 1.00363456e+00, 1.00301719e+00, 1.00237067e+00, + 1.00169363e+00, 1.00098749e+00, 1.00025108e+00, 9.99485663e-01, + 9.98689592e-01, 9.97863666e-01, 9.97006370e-01, 9.96119199e-01, + 9.95201404e-01, 9.94254687e-01, 9.93277595e-01, 9.92270651e-01, + 9.91231967e-01, 9.90163286e-01, 9.89064394e-01, 9.87937115e-01, + 9.86779736e-01, 9.85592773e-01, 9.84375125e-01, 9.83129288e-01, + 9.81348463e-01, 9.79890963e-01, 9.78400459e-01, 9.76860435e-01, + 9.75269879e-01, 9.73627353e-01, 9.71931341e-01, 9.70180498e-01, + 9.68372652e-01, 9.66506952e-01, 9.64580027e-01, 9.62592318e-01, + 9.60540986e-01, 9.58425534e-01, 9.56244393e-01, 9.53998416e-01, + 9.51684014e-01, 9.49301185e-01, 9.46846884e-01, 9.44320232e-01, + 9.41718404e-01, 9.39042580e-01, 9.36290624e-01, 9.33464050e-01, + 9.30560854e-01, 9.27580507e-01, 9.24519592e-01, 9.21378471e-01, + 9.18153414e-01, 9.14844696e-01, 9.11451652e-01, 9.07976524e-01, + 9.04417545e-01, 9.00776308e-01, 8.97050058e-01, 8.93238398e-01, + 8.89338681e-01, 8.85351360e-01, 8.81274023e-01, 8.77109638e-01, + 8.72857927e-01, 8.68519505e-01, 8.64092796e-01, 8.59579819e-01, + 8.54976007e-01, 8.50285220e-01, 8.45502615e-01, 8.40630470e-01, + 8.35667925e-01, 8.30619943e-01, 8.25482007e-01, 8.20258909e-01, + 8.14946648e-01, 8.09546696e-01, 8.04059978e-01, 7.98489378e-01, + 7.92831417e-01, 7.87090668e-01, 7.81262450e-01, 7.75353947e-01, + 7.69363613e-01, 7.63291769e-01, 7.57139016e-01, 7.50901711e-01, + 7.44590843e-01, 7.38205136e-01, 7.31738075e-01, 7.25199287e-01, + 7.18588225e-01, 7.11905687e-01, 7.05153668e-01, 6.98332634e-01, + 6.91444101e-01, 6.84490545e-01, 6.77470119e-01, 6.70388375e-01, + 6.63245210e-01, 6.56045780e-01, 6.48788627e-01, 6.41477162e-01, + 6.34114323e-01, 6.26702000e-01, 6.19235334e-01, 6.11720596e-01, + 6.04161612e-01, 5.96559133e-01, 5.88914401e-01, 5.81234783e-01, + 5.73519989e-01, 5.65770616e-01, 5.57988067e-01, 5.50173851e-01, + 5.42330194e-01, 5.34460798e-01, 5.26568538e-01, 5.18656324e-01, + 5.10728813e-01, 5.02781159e-01, 4.94819491e-01, 4.86845139e-01, + 4.78860889e-01, 4.70869928e-01, 4.62875144e-01, 4.54877894e-01, + 4.46882512e-01, 4.38889325e-01, 4.30898123e-01, 4.22918322e-01, + 4.14950878e-01, 4.06993964e-01, 3.99052648e-01, 3.91134614e-01, + 3.83234031e-01, 3.75354653e-01, 3.67502060e-01, 3.59680098e-01, + 3.51887312e-01, 3.44130166e-01, 3.36408100e-01, 3.28728966e-01, + 3.21090505e-01, 3.13496418e-01, 3.05951565e-01, 2.98454319e-01, + 2.91010565e-01, 2.83621109e-01, 2.76285415e-01, 2.69019585e-01, + 2.61812445e-01, 2.54659232e-01, 2.47584348e-01, 2.40578694e-01, + 2.33647009e-01, 2.26788433e-01, 2.20001992e-01, 2.13301325e-01, + 2.06677771e-01, 2.00140409e-01, 1.93683630e-01, 1.87310343e-01, + 1.81027384e-01, 1.74839476e-01, 1.68739644e-01, 1.62737273e-01, + 1.56825277e-01, 1.51012382e-01, 1.45298230e-01, 1.39687469e-01, + 1.34171842e-01, 1.28762544e-01, 1.23455562e-01, 1.18254662e-01, + 1.13159677e-01, 1.08171439e-01, 1.03290734e-01, 9.85202978e-02, + 9.38600023e-02, 8.93117360e-02, 8.48752103e-02, 8.05523737e-02, + 7.63429787e-02, 7.22489246e-02, 6.82699120e-02, 6.44077291e-02, + 6.06620003e-02, 5.70343711e-02, 5.35243715e-02, 5.01334690e-02, + 4.68610790e-02, 4.37084453e-02, 4.06748365e-02, 3.77612269e-02, + 3.49667099e-02, 3.22919275e-02, 2.97357669e-02, 2.72984629e-02, + 2.49787186e-02, 2.27762542e-02, 2.06895808e-02, 1.87178169e-02, + 1.68593418e-02, 1.51125125e-02, 1.34757094e-02, 1.19462709e-02, + 1.05228754e-02, 9.20130941e-03, 7.98124316e-03, 6.85547314e-03, + 5.82657334e-03, 4.87838525e-03, 4.02351119e-03, 3.15418663e-03, +}; + +static const float mdct_win_10m_8k[__LC3_MDCT_WIN_LEN(10000, 8000)] = { + -7.07854671e-04, -2.09819773e-03, -4.52519808e-03, -8.23397633e-03, + -1.33771310e-02, -1.99972156e-02, -2.80090946e-02, -3.72150208e-02, + -4.73176826e-02, -5.79465483e-02, -6.86760675e-02, -7.90464744e-02, + -8.85970547e-02, -9.68830362e-02, -1.03496124e-01, -1.08076646e-01, + -1.10324226e-01, -1.09980985e-01, -1.06817214e-01, -1.00619042e-01, + -9.11645251e-02, -7.82061748e-02, -6.14668812e-02, -4.06336286e-02, + -1.53632952e-02, 1.47015507e-02, 4.98973651e-02, 9.05036926e-02, + 1.36691102e-01, 1.88468639e-01, 2.45645680e-01, 3.07778908e-01, + 3.74164237e-01, 4.43811480e-01, 5.15473546e-01, 5.87666172e-01, + 6.58761977e-01, 7.27057670e-01, 7.90875299e-01, 8.48664336e-01, + 8.99132024e-01, 9.41334815e-01, 9.74763483e-01, 9.99411473e-01, + 1.01576037e+00, 1.02473616e+00, 1.02763429e+00, 1.02599149e+00, + 1.02142721e+00, 1.01543986e+00, 1.00936693e+00, 1.00350816e+00, + 9.98889821e-01, 9.95313390e-01, 9.92594392e-01, 9.90577196e-01, + 9.89137162e-01, 9.88179075e-01, 9.87624927e-01, 9.87405628e-01, + 9.87452485e-01, 9.87695113e-01, 9.88064062e-01, 9.88492687e-01, + 9.88923003e-01, 9.89307497e-01, 9.89614633e-01, 9.89831927e-01, + 9.89969310e-01, 9.90060335e-01, 9.90157502e-01, 9.90325529e-01, + 9.90630379e-01, 9.91129889e-01, 9.91866549e-01, 9.92861973e-01, + 9.94115607e-01, 9.95603378e-01, 9.97279311e-01, 9.99078484e-01, + 1.00092237e+00, 1.00272811e+00, 1.00441604e+00, 1.00591922e+00, + 1.00718935e+00, 1.00820015e+00, 1.00894949e+00, 1.00945824e+00, + 1.00976898e+00, 1.00994034e+00, 1.01003945e+00, 1.01013232e+00, + 1.01027252e+00, 1.01049435e+00, 1.01080807e+00, 1.01120107e+00, + 1.01164127e+00, 1.01208013e+00, 1.01245818e+00, 1.01270696e+00, + 1.01275501e+00, 1.01253013e+00, 1.01196233e+00, 1.01098214e+00, + 1.00951244e+00, 1.00746086e+00, 1.00470868e+00, 1.00111141e+00, + 9.96504102e-01, 9.90720000e-01, 9.82376587e-01, 9.70882175e-01, + 9.54673298e-01, 9.32155386e-01, 9.01800368e-01, 8.62398408e-01, + 8.13281737e-01, 7.54455197e-01, 6.86658072e-01, 6.11348804e-01, + 5.30618165e-01, 4.47130985e-01, 3.63911468e-01, 2.84164703e-01, + 2.11020945e-01, 1.47228797e-01, 9.48266535e-02, 5.48243661e-02, + 2.70146141e-02, 9.99674359e-03, +}; + +static const float mdct_win_10m_16k[__LC3_MDCT_WIN_LEN(10000, 16000)] = { + -4.61989875e-04, -9.74716672e-04, -1.66447310e-03, -2.59710692e-03, + -3.80628516e-03, -5.32460872e-03, -7.17588528e-03, -9.38248086e-03, + -1.19527030e-02, -1.48952816e-02, -1.82066640e-02, -2.18757093e-02, + -2.58847194e-02, -3.02086274e-02, -3.48159779e-02, -3.96706799e-02, + -4.47269805e-02, -4.99422586e-02, -5.52633479e-02, -6.06371724e-02, + -6.60096152e-02, -7.13196627e-02, -7.65117823e-02, -8.15296401e-02, + -8.63113754e-02, -9.08041129e-02, -9.49537776e-02, -9.87073651e-02, + -1.02020268e-01, -1.04843883e-01, -1.07138231e-01, -1.08869014e-01, + -1.09996966e-01, -1.10489847e-01, -1.10322584e-01, -1.09462175e-01, + -1.07883429e-01, -1.05561251e-01, -1.02465016e-01, -9.85701457e-02, + -9.38468492e-02, -8.82630999e-02, -8.17879272e-02, -7.43878560e-02, + -6.60218980e-02, -5.66565564e-02, -4.62445689e-02, -3.47458578e-02, + -2.21158161e-02, -8.31042570e-03, 6.71769764e-03, 2.30064206e-02, + 4.06010646e-02, 5.95323909e-02, 7.98335419e-02, 1.01523314e-01, + 1.24617139e-01, 1.49115252e-01, 1.75006740e-01, 2.02269985e-01, + 2.30865538e-01, 2.60736512e-01, 2.91814469e-01, 3.24009570e-01, + 3.57217518e-01, 3.91314689e-01, 4.26157164e-01, 4.61592545e-01, + 4.97447159e-01, 5.33532682e-01, 5.69654673e-01, 6.05608382e-01, + 6.41183084e-01, 6.76165350e-01, 7.10340055e-01, 7.43494372e-01, + 7.75428189e-01, 8.05943723e-01, 8.34858937e-01, 8.62010834e-01, + 8.87259971e-01, 9.10486312e-01, 9.31596250e-01, 9.50522086e-01, + 9.67236671e-01, 9.81739750e-01, 9.94055718e-01, 1.00424751e+00, + 1.01240743e+00, 1.01865099e+00, 1.02311884e+00, 1.02597245e+00, + 1.02739752e+00, 1.02758583e+00, 1.02673867e+00, 1.02506178e+00, + 1.02275651e+00, 1.02000914e+00, 1.01699650e+00, 1.01391595e+00, + 1.01104487e+00, 1.00777386e+00, 1.00484875e+00, 1.00224501e+00, + 9.99939317e-01, 9.97905542e-01, 9.96120338e-01, 9.94559753e-01, + 9.93203161e-01, 9.92029727e-01, 9.91023065e-01, 9.90166895e-01, + 9.89448837e-01, 9.88855636e-01, 9.88377852e-01, 9.88005163e-01, + 9.87729546e-01, 9.87541274e-01, 9.87432981e-01, 9.87394992e-01, + 9.87419705e-01, 9.87497321e-01, 9.87620124e-01, 9.87778192e-01, + 9.87963798e-01, 9.88167801e-01, 9.88383520e-01, 9.88602222e-01, + 9.88818277e-01, 9.89024798e-01, 9.89217866e-01, 9.89392368e-01, + 9.89546334e-01, 9.89677201e-01, 9.89785920e-01, 9.89872536e-01, + 9.89941079e-01, 9.89994556e-01, 9.90039402e-01, 9.90081472e-01, + 9.90129379e-01, 9.90190227e-01, 9.90273445e-01, 9.90386228e-01, + 9.90537983e-01, 9.90734883e-01, 9.90984259e-01, 9.91290512e-01, + 9.91658694e-01, 9.92090615e-01, 9.92588721e-01, 9.93151653e-01, + 9.93779087e-01, 9.94466818e-01, 9.95211663e-01, 9.96006862e-01, + 9.96846133e-01, 9.97720337e-01, 9.98621352e-01, 9.99538258e-01, + 1.00046196e+00, 1.00138055e+00, 1.00228487e+00, 1.00316385e+00, + 1.00400915e+00, 1.00481138e+00, 1.00556397e+00, 1.00625986e+00, + 1.00689557e+00, 1.00746662e+00, 1.00797244e+00, 1.00841147e+00, + 1.00878601e+00, 1.00909776e+00, 1.00935176e+00, 1.00955240e+00, + 1.00970709e+00, 1.00982209e+00, 1.00990696e+00, 1.00996902e+00, + 1.01001789e+00, 1.01006081e+00, 1.01010656e+00, 1.01016113e+00, + 1.01023108e+00, 1.01031948e+00, 1.01043047e+00, 1.01056410e+00, + 1.01072136e+00, 1.01089966e+00, 1.01109699e+00, 1.01130817e+00, + 1.01152919e+00, 1.01175301e+00, 1.01197388e+00, 1.01218284e+00, + 1.01237303e+00, 1.01253506e+00, 1.01266098e+00, 1.01274058e+00, + 1.01276592e+00, 1.01272696e+00, 1.01261590e+00, 1.01242289e+00, + 1.01214046e+00, 1.01175881e+00, 1.01126996e+00, 1.01066368e+00, + 1.00993075e+00, 1.00905825e+00, 1.00803431e+00, 1.00684335e+00, + 1.00547001e+00, 1.00389477e+00, 1.00209885e+00, 1.00006069e+00, + 9.97760020e-01, 9.95174643e-01, 9.92286108e-01, 9.89075787e-01, + 9.84736245e-01, 9.79861353e-01, 9.74137862e-01, 9.67333198e-01, + 9.59253976e-01, 9.49698408e-01, 9.38463416e-01, 9.25356797e-01, + 9.10198679e-01, 8.92833832e-01, 8.73143784e-01, 8.51042044e-01, + 8.26483991e-01, 7.99468149e-01, 7.70043128e-01, 7.38302860e-01, + 7.04381434e-01, 6.68461648e-01, 6.30775533e-01, 5.91579959e-01, + 5.51170316e-01, 5.09891542e-01, 4.68101711e-01, 4.26177297e-01, + 3.84517234e-01, 3.43522867e-01, 3.03600465e-01, 2.65143468e-01, + 2.28528397e-01, 1.94102191e-01, 1.62173542e-01, 1.33001524e-01, + 1.06784043e-01, 8.36505724e-02, 6.36518811e-02, 4.67653841e-02, + 3.28807275e-02, 2.18305756e-02, 1.33638143e-02, 6.75812489e-03, +}; + +static const float mdct_win_10m_24k[__LC3_MDCT_WIN_LEN(10000, 24000)] = { + -3.61349642e-04, -7.07854671e-04, -1.07444364e-03, -1.53347854e-03, + -2.09819773e-03, -2.77842087e-03, -3.58412992e-03, -4.52519808e-03, + -5.60932724e-03, -6.84323454e-03, -8.23397633e-03, -9.78531476e-03, + -1.14988030e-02, -1.33771310e-02, -1.54218168e-02, -1.76297991e-02, + -1.99972156e-02, -2.25208056e-02, -2.51940630e-02, -2.80090946e-02, + -3.09576509e-02, -3.40299627e-02, -3.72150208e-02, -4.05005325e-02, + -4.38721922e-02, -4.73176826e-02, -5.08232534e-02, -5.43716664e-02, + -5.79465483e-02, -6.15342620e-02, -6.51170816e-02, -6.86760675e-02, + -7.21944781e-02, -7.56569598e-02, -7.90464744e-02, -8.23444256e-02, + -8.55332458e-02, -8.85970547e-02, -9.15209110e-02, -9.42884745e-02, + -9.68830362e-02, -9.92912326e-02, -1.01500847e-01, -1.03496124e-01, + -1.05263700e-01, -1.06793998e-01, -1.08076646e-01, -1.09099730e-01, + -1.09852449e-01, -1.10324226e-01, -1.10508462e-01, -1.10397741e-01, + -1.09980985e-01, -1.09249277e-01, -1.08197423e-01, -1.06817214e-01, + -1.05099580e-01, -1.03036011e-01, -1.00619042e-01, -9.78412002e-02, + -9.46930422e-02, -9.11645251e-02, -8.72464453e-02, -8.29304391e-02, + -7.82061748e-02, -7.30614243e-02, -6.74846818e-02, -6.14668812e-02, + -5.49949726e-02, -4.80544442e-02, -4.06336286e-02, -3.27204559e-02, + -2.43012258e-02, -1.53632952e-02, -5.89143427e-03, 4.12659586e-03, + 1.47015507e-02, 2.58473819e-02, 3.75765277e-02, 4.98973651e-02, + 6.28203403e-02, 7.63539773e-02, 9.05036926e-02, 1.05274712e-01, + 1.20670347e-01, 1.36691102e-01, 1.53334389e-01, 1.70595471e-01, + 1.88468639e-01, 2.06944996e-01, 2.26009300e-01, 2.45645680e-01, + 2.65834602e-01, 2.86554381e-01, 3.07778908e-01, 3.29476944e-01, + 3.51617148e-01, 3.74164237e-01, 3.97073959e-01, 4.20304305e-01, + 4.43811480e-01, 4.67544229e-01, 4.91449863e-01, 5.15473546e-01, + 5.39555764e-01, 5.63639982e-01, 5.87666172e-01, 6.11569531e-01, + 6.35289059e-01, 6.58761977e-01, 6.81923097e-01, 7.04709282e-01, + 7.27057670e-01, 7.48906896e-01, 7.70199019e-01, 7.90875299e-01, + 8.10878869e-01, 8.30157914e-01, 8.48664336e-01, 8.66354816e-01, + 8.83189685e-01, 8.99132024e-01, 9.14154056e-01, 9.28228255e-01, + 9.41334815e-01, 9.53461939e-01, 9.64604825e-01, 9.74763483e-01, + 9.83943539e-01, 9.92152910e-01, 9.99411473e-01, 1.00574608e+00, + 1.01118397e+00, 1.01576037e+00, 1.01951507e+00, 1.02249094e+00, + 1.02473616e+00, 1.02630410e+00, 1.02725098e+00, 1.02763429e+00, + 1.02751106e+00, 1.02694280e+00, 1.02599149e+00, 1.02471615e+00, + 1.02317598e+00, 1.02142721e+00, 1.01952157e+00, 1.01751012e+00, + 1.01543986e+00, 1.01346092e+00, 1.01165490e+00, 1.00936693e+00, + 1.00726318e+00, 1.00531319e+00, 1.00350816e+00, 1.00184079e+00, + 1.00030393e+00, 9.98889821e-01, 9.97591528e-01, 9.96401528e-01, + 9.95313390e-01, 9.94320108e-01, 9.93415896e-01, 9.92594392e-01, + 9.91851028e-01, 9.91179799e-01, 9.90577196e-01, 9.90038105e-01, + 9.89559439e-01, 9.89137162e-01, 9.88768437e-01, 9.88449792e-01, + 9.88179075e-01, 9.87952836e-01, 9.87769137e-01, 9.87624927e-01, + 9.87517995e-01, 9.87445813e-01, 9.87405628e-01, 9.87395112e-01, + 9.87411537e-01, 9.87452485e-01, 9.87514989e-01, 9.87596889e-01, + 9.87695113e-01, 9.87807582e-01, 9.87931200e-01, 9.88064062e-01, + 9.88203257e-01, 9.88347108e-01, 9.88492687e-01, 9.88638659e-01, + 9.88782558e-01, 9.88923003e-01, 9.89058172e-01, 9.89186767e-01, + 9.89307497e-01, 9.89419640e-01, 9.89522076e-01, 9.89614633e-01, + 9.89697035e-01, 9.89769260e-01, 9.89831927e-01, 9.89885257e-01, + 9.89930764e-01, 9.89969310e-01, 9.90002569e-01, 9.90032156e-01, + 9.90060335e-01, 9.90088981e-01, 9.90120659e-01, 9.90157502e-01, + 9.90202395e-01, 9.90257541e-01, 9.90325529e-01, 9.90408791e-01, + 9.90509649e-01, 9.90630379e-01, 9.90772711e-01, 9.90938744e-01, + 9.91129889e-01, 9.91347632e-01, 9.91592856e-01, 9.91866549e-01, + 9.92169132e-01, 9.92501085e-01, 9.92861973e-01, 9.93251918e-01, + 9.93670021e-01, 9.94115607e-01, 9.94587315e-01, 9.95083740e-01, + 9.95603378e-01, 9.96143992e-01, 9.96703453e-01, 9.97279311e-01, + 9.97869086e-01, 9.98469709e-01, 9.99078484e-01, 9.99691901e-01, + 1.00030819e+00, 1.00092237e+00, 1.00153264e+00, 1.00213546e+00, + 1.00272811e+00, 1.00330745e+00, 1.00387093e+00, 1.00441604e+00, + 1.00494055e+00, 1.00544214e+00, 1.00591922e+00, 1.00637030e+00, + 1.00679393e+00, 1.00718935e+00, 1.00755557e+00, 1.00789267e+00, + 1.00820015e+00, 1.00847842e+00, 1.00872788e+00, 1.00894949e+00, + 1.00914411e+00, 1.00931322e+00, 1.00945824e+00, 1.00958128e+00, + 1.00968409e+00, 1.00976898e+00, 1.00983831e+00, 1.00989455e+00, + 1.00994034e+00, 1.00997792e+00, 1.01001023e+00, 1.01003945e+00, + 1.01006820e+00, 1.01009839e+00, 1.01013232e+00, 1.01017166e+00, + 1.01021810e+00, 1.01027252e+00, 1.01033649e+00, 1.01041022e+00, + 1.01049435e+00, 1.01058887e+00, 1.01069350e+00, 1.01080807e+00, + 1.01093144e+00, 1.01106288e+00, 1.01120107e+00, 1.01134470e+00, + 1.01149190e+00, 1.01164127e+00, 1.01179028e+00, 1.01193757e+00, + 1.01208013e+00, 1.01221624e+00, 1.01234291e+00, 1.01245818e+00, + 1.01255888e+00, 1.01264286e+00, 1.01270696e+00, 1.01274895e+00, + 1.01276580e+00, 1.01275501e+00, 1.01271380e+00, 1.01263978e+00, + 1.01253013e+00, 1.01238231e+00, 1.01219407e+00, 1.01196233e+00, + 1.01168517e+00, 1.01135914e+00, 1.01098214e+00, 1.01055072e+00, + 1.01006213e+00, 1.00951244e+00, 1.00889869e+00, 1.00821592e+00, + 1.00746086e+00, 1.00662774e+00, 1.00571234e+00, 1.00470868e+00, + 1.00361147e+00, 1.00241429e+00, 1.00111141e+00, 9.99696165e-01, + 9.98162595e-01, 9.96504102e-01, 9.94714888e-01, 9.92789191e-01, + 9.90720000e-01, 9.88479371e-01, 9.85534766e-01, 9.82376587e-01, + 9.78974733e-01, 9.75162381e-01, 9.70882175e-01, 9.66080552e-01, + 9.60697640e-01, 9.54673298e-01, 9.47947935e-01, 9.40460905e-01, + 9.32155386e-01, 9.22977548e-01, 9.12874535e-01, 9.01800368e-01, + 8.89716328e-01, 8.76590897e-01, 8.62398408e-01, 8.47120080e-01, + 8.30747973e-01, 8.13281737e-01, 7.94729145e-01, 7.75110884e-01, + 7.54455197e-01, 7.32796355e-01, 7.10179084e-01, 6.86658072e-01, + 6.62296243e-01, 6.37168412e-01, 6.11348804e-01, 5.84920660e-01, + 5.57974743e-01, 5.30618165e-01, 5.02952396e-01, 4.75086883e-01, + 4.47130985e-01, 4.19204992e-01, 3.91425291e-01, 3.63911468e-01, + 3.36783777e-01, 3.10162784e-01, 2.84164703e-01, 2.58903371e-01, + 2.34488060e-01, 2.11020945e-01, 1.88599764e-01, 1.67310081e-01, + 1.47228797e-01, 1.28422307e-01, 1.10942255e-01, 9.48266535e-02, + 8.00991437e-02, 6.67676585e-02, 5.48243661e-02, 4.42458885e-02, + 3.49936100e-02, 2.70146141e-02, 2.02437018e-02, 1.46079676e-02, + 9.99674359e-03, 5.30523510e-03, +}; + +static const float mdct_win_10m_32k[__LC3_MDCT_WIN_LEN(10000, 32000)] = { + -3.02115349e-04, -5.86773749e-04, -8.36650400e-04, -1.12663536e-03, + -1.47049294e-03, -1.87347339e-03, -2.33929236e-03, -2.87200807e-03, + -3.47625639e-03, -4.15596382e-03, -4.91456379e-03, -5.75517250e-03, + -6.68062338e-03, -7.69381692e-03, -8.79676075e-03, -9.99050307e-03, + -1.12757412e-02, -1.26533415e-02, -1.41243899e-02, -1.56888962e-02, + -1.73451209e-02, -1.90909737e-02, -2.09254671e-02, -2.28468479e-02, + -2.48520772e-02, -2.69374670e-02, -2.90995249e-02, -3.13350463e-02, + -3.36396073e-02, -3.60082097e-02, -3.84360174e-02, -4.09174603e-02, + -4.34465489e-02, -4.60178672e-02, -4.86259851e-02, -5.12647420e-02, + -5.39264475e-02, -5.66038431e-02, -5.92911675e-02, -6.19826820e-02, + -6.46702555e-02, -6.73454222e-02, -7.00009902e-02, -7.26305701e-02, + -7.52278496e-02, -7.77852594e-02, -8.02948025e-02, -8.27492454e-02, + -8.51412546e-02, -8.74637912e-02, -8.97106934e-02, -9.18756408e-02, + -9.39517698e-02, -9.59313774e-02, -9.78084326e-02, -9.95785130e-02, + -1.01236117e-01, -1.02774104e-01, -1.04186122e-01, -1.05468025e-01, + -1.06616088e-01, -1.07625538e-01, -1.08491230e-01, -1.09208742e-01, + -1.09773615e-01, -1.10180886e-01, -1.10427188e-01, -1.10510836e-01, + -1.10428147e-01, -1.10173922e-01, -1.09743736e-01, -1.09135313e-01, + -1.08346734e-01, -1.07373994e-01, -1.06213016e-01, -1.04860615e-01, + -1.03313240e-01, -1.01567316e-01, -9.96200551e-02, -9.74680323e-02, + -9.51072362e-02, -9.25330338e-02, -8.97412522e-02, -8.67287769e-02, + -8.34921384e-02, -8.00263990e-02, -7.63267954e-02, -7.23880616e-02, + -6.82057680e-02, -6.37761143e-02, -5.90938600e-02, -5.41531632e-02, + -4.89481272e-02, -4.34734711e-02, -3.77246130e-02, -3.16958761e-02, + -2.53817983e-02, -1.87768910e-02, -1.18746138e-02, -4.66909925e-03, + 2.84409675e-03, 1.06697612e-02, 1.88135595e-02, 2.72815601e-02, + 3.60781047e-02, 4.52070276e-02, 5.46723880e-02, 6.44786605e-02, + 7.46286220e-02, 8.51249057e-02, 9.59698399e-02, 1.07165078e-01, + 1.18711585e-01, 1.30610107e-01, 1.42859645e-01, 1.55458473e-01, + 1.68404161e-01, 1.81694789e-01, 1.95327388e-01, 2.09296321e-01, + 2.23594564e-01, 2.38216022e-01, 2.53152972e-01, 2.68396157e-01, + 2.83936139e-01, 2.99762426e-01, 3.15861908e-01, 3.32221055e-01, + 3.48826468e-01, 3.65664038e-01, 3.82715297e-01, 3.99961186e-01, + 4.17384327e-01, 4.34966962e-01, 4.52687640e-01, 4.70524201e-01, + 4.88453925e-01, 5.06454555e-01, 5.24500675e-01, 5.42567437e-01, + 5.60631204e-01, 5.78667265e-01, 5.96647704e-01, 6.14545890e-01, + 6.32336194e-01, 6.49992632e-01, 6.67487403e-01, 6.84793267e-01, + 7.01883546e-01, 7.18732254e-01, 7.35312821e-01, 7.51600199e-01, + 7.67569925e-01, 7.83197457e-01, 7.98458386e-01, 8.13329535e-01, + 8.27789227e-01, 8.41817856e-01, 8.55396130e-01, 8.68506898e-01, + 8.81133444e-01, 8.93259678e-01, 9.04874884e-01, 9.15965761e-01, + 9.26521530e-01, 9.36533999e-01, 9.45997703e-01, 9.54908841e-01, + 9.63265812e-01, 9.71068890e-01, 9.78320416e-01, 9.85022676e-01, + 9.91179208e-01, 9.96798994e-01, 1.00189402e+00, 1.00647434e+00, + 1.01055206e+00, 1.01414254e+00, 1.01726259e+00, 1.01992884e+00, + 1.02215987e+00, 1.02397632e+00, 1.02540073e+00, 1.02645534e+00, + 1.02716451e+00, 1.02755273e+00, 1.02764446e+00, 1.02746325e+00, + 1.02703590e+00, 1.02638907e+00, 1.02554820e+00, 1.02453713e+00, + 1.02338080e+00, 1.02210370e+00, 1.02072836e+00, 1.01927533e+00, + 1.01776518e+00, 1.01621736e+00, 1.01466531e+00, 1.01324907e+00, + 1.01194801e+00, 1.01018909e+00, 1.00855796e+00, 1.00701129e+00, + 1.00554876e+00, 1.00416842e+00, 1.00286727e+00, 1.00164177e+00, + 1.00048907e+00, 9.99406080e-01, 9.98389887e-01, 9.97437085e-01, + 9.96544484e-01, 9.95709855e-01, 9.94930241e-01, 9.94202405e-01, + 9.93524160e-01, 9.92893043e-01, 9.92306810e-01, 9.91763378e-01, + 9.91259764e-01, 9.90795450e-01, 9.90367789e-01, 9.89975161e-01, + 9.89616034e-01, 9.89289016e-01, 9.88992851e-01, 9.88726033e-01, + 9.88486872e-01, 9.88275104e-01, 9.88089217e-01, 9.87927711e-01, + 9.87789826e-01, 9.87674344e-01, 9.87580750e-01, 9.87507202e-01, + 9.87452945e-01, 9.87416974e-01, 9.87398469e-01, 9.87395830e-01, + 9.87408003e-01, 9.87434340e-01, 9.87473624e-01, 9.87524314e-01, + 9.87585620e-01, 9.87656379e-01, 9.87735892e-01, 9.87822558e-01, + 9.87915097e-01, 9.88013273e-01, 9.88115695e-01, 9.88221131e-01, + 9.88328903e-01, 9.88437831e-01, 9.88547679e-01, 9.88656841e-01, + 9.88764587e-01, 9.88870854e-01, 9.88974432e-01, 9.89074727e-01, + 9.89171004e-01, 9.89263102e-01, 9.89350722e-01, 9.89433065e-01, + 9.89509692e-01, 9.89581081e-01, 9.89646747e-01, 9.89706737e-01, + 9.89760693e-01, 9.89809448e-01, 9.89853013e-01, 9.89891471e-01, + 9.89925419e-01, 9.89955420e-01, 9.89982449e-01, 9.90006512e-01, + 9.90028481e-01, 9.90049748e-01, 9.90070956e-01, 9.90092836e-01, + 9.90116392e-01, 9.90142748e-01, 9.90173428e-01, 9.90208733e-01, + 9.90249864e-01, 9.90298369e-01, 9.90354850e-01, 9.90420508e-01, + 9.90495930e-01, 9.90582515e-01, 9.90681257e-01, 9.90792209e-01, + 9.90916546e-01, 9.91055074e-01, 9.91208461e-01, 9.91376861e-01, + 9.91560583e-01, 9.91760421e-01, 9.91976718e-01, 9.92209110e-01, + 9.92457914e-01, 9.92723123e-01, 9.93004954e-01, 9.93302728e-01, + 9.93616108e-01, 9.93945371e-01, 9.94289515e-01, 9.94648168e-01, + 9.95020303e-01, 9.95405817e-01, 9.95803871e-01, 9.96213027e-01, + 9.96632469e-01, 9.97061531e-01, 9.97499058e-01, 9.97943743e-01, + 9.98394057e-01, 9.98849312e-01, 9.99308343e-01, 9.99768922e-01, + 1.00023113e+00, 1.00069214e+00, 1.00115201e+00, 1.00160853e+00, + 1.00206049e+00, 1.00250721e+00, 1.00294713e+00, 1.00337891e+00, + 1.00380137e+00, 1.00421381e+00, 1.00461539e+00, 1.00500462e+00, + 1.00538063e+00, 1.00574328e+00, 1.00609151e+00, 1.00642491e+00, + 1.00674243e+00, 1.00704432e+00, 1.00733022e+00, 1.00759940e+00, + 1.00785206e+00, 1.00808818e+00, 1.00830803e+00, 1.00851125e+00, + 1.00869814e+00, 1.00886952e+00, 1.00902566e+00, 1.00916672e+00, + 1.00929336e+00, 1.00940640e+00, 1.00950702e+00, 1.00959526e+00, + 1.00967215e+00, 1.00973908e+00, 1.00979668e+00, 1.00984614e+00, + 1.00988808e+00, 1.00992409e+00, 1.00995538e+00, 1.00998227e+00, + 1.01000630e+00, 1.01002862e+00, 1.01005025e+00, 1.01007195e+00, + 1.01009437e+00, 1.01011892e+00, 1.01014650e+00, 1.01017711e+00, + 1.01021176e+00, 1.01025100e+00, 1.01029547e+00, 1.01034523e+00, + 1.01040032e+00, 1.01046156e+00, 1.01052862e+00, 1.01060152e+00, + 1.01067979e+00, 1.01076391e+00, 1.01085343e+00, 1.01094755e+00, + 1.01104595e+00, 1.01114849e+00, 1.01125440e+00, 1.01136308e+00, + 1.01147330e+00, 1.01158500e+00, 1.01169742e+00, 1.01180892e+00, + 1.01191926e+00, 1.01202724e+00, 1.01213215e+00, 1.01223273e+00, + 1.01232756e+00, 1.01241638e+00, 1.01249789e+00, 1.01257043e+00, + 1.01263330e+00, 1.01268528e+00, 1.01272556e+00, 1.01275258e+00, + 1.01276506e+00, 1.01276236e+00, 1.01274338e+00, 1.01270648e+00, + 1.01265084e+00, 1.01257543e+00, 1.01247947e+00, 1.01236111e+00, + 1.01221981e+00, 1.01205436e+00, 1.01186400e+00, 1.01164722e+00, + 1.01140252e+00, 1.01112965e+00, 1.01082695e+00, 1.01049292e+00, + 1.01012635e+00, 1.00972589e+00, 1.00929006e+00, 1.00881730e+00, + 1.00830503e+00, 1.00775283e+00, 1.00715783e+00, 1.00651805e+00, + 1.00583140e+00, 1.00509559e+00, 1.00430863e+00, 1.00346750e+00, + 1.00256950e+00, 1.00161271e+00, 1.00059427e+00, 9.99511170e-01, + 9.98360922e-01, 9.97140929e-01, 9.95848886e-01, 9.94481854e-01, + 9.93037528e-01, 9.91514656e-01, 9.89913680e-01, 9.88193062e-01, + 9.85942259e-01, 9.83566790e-01, 9.81142303e-01, 9.78521444e-01, + 9.75663604e-01, 9.72545344e-01, 9.69145663e-01, 9.65440618e-01, + 9.61404362e-01, 9.57011307e-01, 9.52236767e-01, 9.47054884e-01, + 9.41440374e-01, 9.35369161e-01, 9.28819009e-01, 9.21766289e-01, + 9.14189628e-01, 9.06069468e-01, 8.97389168e-01, 8.88133200e-01, + 8.78289389e-01, 8.67846957e-01, 8.56797064e-01, 8.45133465e-01, + 8.32854281e-01, 8.19959478e-01, 8.06451101e-01, 7.92334648e-01, + 7.77620449e-01, 7.62320618e-01, 7.46448649e-01, 7.30020573e-01, + 7.13056738e-01, 6.95580544e-01, 6.77617323e-01, 6.59195531e-01, + 6.40348643e-01, 6.21107220e-01, 6.01504928e-01, 5.81578761e-01, + 5.61367451e-01, 5.40918863e-01, 5.20273683e-01, 4.99478073e-01, + 4.78577418e-01, 4.57617260e-01, 4.36649021e-01, 4.15722146e-01, + 3.94885659e-01, 3.74190319e-01, 3.53686890e-01, 3.33426002e-01, + 3.13458647e-01, 2.93833790e-01, 2.74599264e-01, 2.55803064e-01, + 2.37490219e-01, 2.19703603e-01, 2.02485542e-01, 1.85874992e-01, + 1.69906780e-01, 1.54613227e-01, 1.40023821e-01, 1.26163740e-01, + 1.13053443e-01, 1.00708497e-01, 8.91402439e-02, 7.83561210e-02, + 6.83582123e-02, 5.91421154e-02, 5.06989301e-02, 4.30171776e-02, + 3.60802073e-02, 2.98631634e-02, 2.43372266e-02, 1.94767524e-02, + 1.52571017e-02, 1.16378749e-02, 8.43308778e-03, 4.44966900e-03, +}; + +static const float mdct_win_10m_48k[__LC3_MDCT_WIN_LEN(10000, 48000)] = { + -2.35303215e-04, -4.61989875e-04, -6.26293154e-04, -7.92918043e-04, + -9.74716672e-04, -1.18025689e-03, -1.40920904e-03, -1.66447310e-03, + -1.94659161e-03, -2.25708173e-03, -2.59710692e-03, -2.96760762e-03, + -3.37045488e-03, -3.80628516e-03, -4.27687377e-03, -4.78246990e-03, + -5.32460872e-03, -5.90340381e-03, -6.52041973e-03, -7.17588528e-03, + -7.87142282e-03, -8.60658604e-03, -9.38248086e-03, -1.01982718e-02, + -1.10552055e-02, -1.19527030e-02, -1.28920591e-02, -1.38726348e-02, + -1.48952816e-02, -1.59585662e-02, -1.70628856e-02, -1.82066640e-02, + -1.93906598e-02, -2.06135542e-02, -2.18757093e-02, -2.31752632e-02, + -2.45122745e-02, -2.58847194e-02, -2.72926374e-02, -2.87339090e-02, + -3.02086274e-02, -3.17144037e-02, -3.32509886e-02, -3.48159779e-02, + -3.64089241e-02, -3.80274232e-02, -3.96706799e-02, -4.13357542e-02, + -4.30220337e-02, -4.47269805e-02, -4.64502229e-02, -4.81889149e-02, + -4.99422586e-02, -5.17069080e-02, -5.34816204e-02, -5.52633479e-02, + -5.70512315e-02, -5.88427175e-02, -6.06371724e-02, -6.24310403e-02, + -6.42230355e-02, -6.60096152e-02, -6.77896227e-02, -6.95599687e-02, + -7.13196627e-02, -7.30658127e-02, -7.47975891e-02, -7.65117823e-02, + -7.82071142e-02, -7.98801069e-02, -8.15296401e-02, -8.31523735e-02, + -8.47472895e-02, -8.63113754e-02, -8.78437445e-02, -8.93416436e-02, + -9.08041129e-02, -9.22279576e-02, -9.36123287e-02, -9.49537776e-02, + -9.62515531e-02, -9.75028462e-02, -9.87073651e-02, -9.98627129e-02, + -1.00968022e-01, -1.02020268e-01, -1.03018380e-01, -1.03959636e-01, + -1.04843883e-01, -1.05668684e-01, -1.06434282e-01, -1.07138231e-01, + -1.07779996e-01, -1.08357063e-01, -1.08869014e-01, -1.09313559e-01, + -1.09690356e-01, -1.09996966e-01, -1.10233226e-01, -1.10397281e-01, + -1.10489847e-01, -1.10508642e-01, -1.10453743e-01, -1.10322584e-01, + -1.10114583e-01, -1.09827693e-01, -1.09462175e-01, -1.09016396e-01, + -1.08490885e-01, -1.07883429e-01, -1.07193718e-01, -1.06419636e-01, + -1.05561251e-01, -1.04616281e-01, -1.03584904e-01, -1.02465016e-01, + -1.01256900e-01, -9.99586457e-02, -9.85701457e-02, -9.70891114e-02, + -9.55154582e-02, -9.38468492e-02, -9.20830006e-02, -9.02217102e-02, + -8.82630999e-02, -8.62049382e-02, -8.40474215e-02, -8.17879272e-02, + -7.94262503e-02, -7.69598078e-02, -7.43878560e-02, -7.17079700e-02, + -6.89199478e-02, -6.60218980e-02, -6.30134942e-02, -5.98919191e-02, + -5.66565564e-02, -5.33040616e-02, -4.98342724e-02, -4.62445689e-02, + -4.25345569e-02, -3.87019577e-02, -3.47458578e-02, -3.06634152e-02, + -2.64542508e-02, -2.21158161e-02, -1.76474054e-02, -1.30458136e-02, + -8.31042570e-03, -3.43826866e-03, 1.57031548e-03, 6.71769764e-03, + 1.20047702e-02, 1.74339832e-02, 2.30064206e-02, 2.87248142e-02, + 3.45889635e-02, 4.06010646e-02, 4.67610292e-02, 5.30713391e-02, + 5.95323909e-02, 6.61464781e-02, 7.29129318e-02, 7.98335419e-02, + 8.69080741e-02, 9.41381377e-02, 1.01523314e-01, 1.09065152e-01, + 1.16762655e-01, 1.24617139e-01, 1.32627295e-01, 1.40793819e-01, + 1.49115252e-01, 1.57592141e-01, 1.66222480e-01, 1.75006740e-01, + 1.83943194e-01, 1.93031818e-01, 2.02269985e-01, 2.11656743e-01, + 2.21188852e-01, 2.30865538e-01, 2.40683799e-01, 2.50642064e-01, + 2.60736512e-01, 2.70965907e-01, 2.81325902e-01, 2.91814469e-01, + 3.02427028e-01, 3.13160350e-01, 3.24009570e-01, 3.34971959e-01, + 3.46042294e-01, 3.57217518e-01, 3.68491565e-01, 3.79859512e-01, + 3.91314689e-01, 4.02853287e-01, 4.14468833e-01, 4.26157164e-01, + 4.37911390e-01, 4.49725632e-01, 4.61592545e-01, 4.73506703e-01, + 4.85460018e-01, 4.97447159e-01, 5.09459723e-01, 5.21490984e-01, + 5.33532682e-01, 5.45578981e-01, 5.57621716e-01, 5.69654673e-01, + 5.81668558e-01, 5.93656062e-01, 6.05608382e-01, 6.17519206e-01, + 6.29379661e-01, 6.41183084e-01, 6.52920354e-01, 6.64584079e-01, + 6.76165350e-01, 6.87657395e-01, 6.99051154e-01, 7.10340055e-01, + 7.21514933e-01, 7.32569177e-01, 7.43494372e-01, 7.54284633e-01, + 7.64931365e-01, 7.75428189e-01, 7.85767017e-01, 7.95941465e-01, + 8.05943723e-01, 8.15768707e-01, 8.25408622e-01, 8.34858937e-01, + 8.44112583e-01, 8.53165119e-01, 8.62010834e-01, 8.70645634e-01, + 8.79063156e-01, 8.87259971e-01, 8.95231329e-01, 9.02975168e-01, + 9.10486312e-01, 9.17762555e-01, 9.24799743e-01, 9.31596250e-01, + 9.38149486e-01, 9.44458839e-01, 9.50522086e-01, 9.56340292e-01, + 9.61911452e-01, 9.67236671e-01, 9.72315664e-01, 9.77150119e-01, + 9.81739750e-01, 9.86086587e-01, 9.90190638e-01, 9.94055718e-01, + 9.97684240e-01, 1.00108096e+00, 1.00424751e+00, 1.00718858e+00, + 1.00990665e+00, 1.01240743e+00, 1.01469470e+00, 1.01677466e+00, + 1.01865099e+00, 1.02033046e+00, 1.02181733e+00, 1.02311884e+00, + 1.02424026e+00, 1.02518972e+00, 1.02597245e+00, 1.02659694e+00, + 1.02706918e+00, 1.02739752e+00, 1.02758790e+00, 1.02764895e+00, + 1.02758583e+00, 1.02740852e+00, 1.02712299e+00, 1.02673867e+00, + 1.02626166e+00, 1.02570100e+00, 1.02506178e+00, 1.02435398e+00, + 1.02358239e+00, 1.02275651e+00, 1.02188060e+00, 1.02096387e+00, + 1.02000914e+00, 1.01902729e+00, 1.01801944e+00, 1.01699650e+00, + 1.01595743e+00, 1.01492344e+00, 1.01391595e+00, 1.01304757e+00, + 1.01221613e+00, 1.01104487e+00, 1.00991459e+00, 1.00882489e+00, + 1.00777386e+00, 1.00676170e+00, 1.00578665e+00, 1.00484875e+00, + 1.00394608e+00, 1.00307885e+00, 1.00224501e+00, 1.00144473e+00, + 1.00067619e+00, 9.99939317e-01, 9.99232085e-01, 9.98554813e-01, + 9.97905542e-01, 9.97284268e-01, 9.96689095e-01, 9.96120338e-01, + 9.95576126e-01, 9.95056572e-01, 9.94559753e-01, 9.94086038e-01, + 9.93633779e-01, 9.93203161e-01, 9.92792187e-01, 9.92401518e-01, + 9.92029727e-01, 9.91676778e-01, 9.91340877e-01, 9.91023065e-01, + 9.90721643e-01, 9.90436680e-01, 9.90166895e-01, 9.89913101e-01, + 9.89673564e-01, 9.89448837e-01, 9.89237484e-01, 9.89040193e-01, + 9.88855636e-01, 9.88684347e-01, 9.88524761e-01, 9.88377852e-01, + 9.88242327e-01, 9.88118564e-01, 9.88005163e-01, 9.87903202e-01, + 9.87811174e-01, 9.87729546e-01, 9.87657198e-01, 9.87594984e-01, + 9.87541274e-01, 9.87496906e-01, 9.87460625e-01, 9.87432981e-01, + 9.87412641e-01, 9.87400475e-01, 9.87394992e-01, 9.87396916e-01, + 9.87404906e-01, 9.87419705e-01, 9.87439972e-01, 9.87466328e-01, + 9.87497321e-01, 9.87533893e-01, 9.87574654e-01, 9.87620124e-01, + 9.87668980e-01, 9.87722156e-01, 9.87778192e-01, 9.87837649e-01, + 9.87899199e-01, 9.87963798e-01, 9.88030030e-01, 9.88098468e-01, + 9.88167801e-01, 9.88239030e-01, 9.88310769e-01, 9.88383520e-01, + 9.88456016e-01, 9.88529420e-01, 9.88602222e-01, 9.88674940e-01, + 9.88746626e-01, 9.88818277e-01, 9.88888248e-01, 9.88957438e-01, + 9.89024798e-01, 9.89091125e-01, 9.89155170e-01, 9.89217866e-01, + 9.89277956e-01, 9.89336519e-01, 9.89392368e-01, 9.89446283e-01, + 9.89497212e-01, 9.89546334e-01, 9.89592362e-01, 9.89636265e-01, + 9.89677201e-01, 9.89716220e-01, 9.89752029e-01, 9.89785920e-01, + 9.89817027e-01, 9.89846207e-01, 9.89872536e-01, 9.89897514e-01, + 9.89920005e-01, 9.89941079e-01, 9.89960061e-01, 9.89978226e-01, + 9.89994556e-01, 9.90010350e-01, 9.90024832e-01, 9.90039402e-01, + 9.90053211e-01, 9.90067475e-01, 9.90081472e-01, 9.90096693e-01, + 9.90112245e-01, 9.90129379e-01, 9.90147465e-01, 9.90168060e-01, + 9.90190227e-01, 9.90215190e-01, 9.90242442e-01, 9.90273445e-01, + 9.90307127e-01, 9.90344891e-01, 9.90386228e-01, 9.90432448e-01, + 9.90482565e-01, 9.90537983e-01, 9.90598060e-01, 9.90664037e-01, + 9.90734883e-01, 9.90812038e-01, 9.90894786e-01, 9.90984259e-01, + 9.91079525e-01, 9.91181924e-01, 9.91290512e-01, 9.91406471e-01, + 9.91528801e-01, 9.91658694e-01, 9.91795272e-01, 9.91939622e-01, + 9.92090615e-01, 9.92249503e-01, 9.92415240e-01, 9.92588721e-01, + 9.92768871e-01, 9.92956911e-01, 9.93151653e-01, 9.93353924e-01, + 9.93562689e-01, 9.93779087e-01, 9.94001643e-01, 9.94231202e-01, + 9.94466818e-01, 9.94709344e-01, 9.94957285e-01, 9.95211663e-01, + 9.95471264e-01, 9.95736795e-01, 9.96006862e-01, 9.96282303e-01, + 9.96561799e-01, 9.96846133e-01, 9.97133827e-01, 9.97425669e-01, + 9.97720337e-01, 9.98018509e-01, 9.98318587e-01, 9.98621352e-01, + 9.98925543e-01, 9.99231731e-01, 9.99538258e-01, 9.99846116e-01, + 1.00015391e+00, 1.00046196e+00, 1.00076886e+00, 1.00107561e+00, + 1.00138055e+00, 1.00168424e+00, 1.00198543e+00, 1.00228487e+00, + 1.00258098e+00, 1.00287441e+00, 1.00316385e+00, 1.00345006e+00, + 1.00373157e+00, 1.00400915e+00, 1.00428146e+00, 1.00454934e+00, + 1.00481138e+00, 1.00506827e+00, 1.00531880e+00, 1.00556397e+00, + 1.00580227e+00, 1.00603455e+00, 1.00625986e+00, 1.00647902e+00, + 1.00669054e+00, 1.00689557e+00, 1.00709305e+00, 1.00728380e+00, + 1.00746662e+00, 1.00764273e+00, 1.00781104e+00, 1.00797244e+00, + 1.00812588e+00, 1.00827260e+00, 1.00841147e+00, 1.00854357e+00, + 1.00866802e+00, 1.00878601e+00, 1.00889653e+00, 1.00900077e+00, + 1.00909776e+00, 1.00918888e+00, 1.00927316e+00, 1.00935176e+00, + 1.00942394e+00, 1.00949118e+00, 1.00955240e+00, 1.00960889e+00, + 1.00965997e+00, 1.00970709e+00, 1.00974924e+00, 1.00978774e+00, + 1.00982209e+00, 1.00985371e+00, 1.00988150e+00, 1.00990696e+00, + 1.00992957e+00, 1.00995057e+00, 1.00996902e+00, 1.00998650e+00, + 1.01000236e+00, 1.01001789e+00, 1.01003217e+00, 1.01004672e+00, + 1.01006081e+00, 1.01007567e+00, 1.01009045e+00, 1.01010656e+00, + 1.01012323e+00, 1.01014176e+00, 1.01016113e+00, 1.01018264e+00, + 1.01020559e+00, 1.01023108e+00, 1.01025795e+00, 1.01028773e+00, + 1.01031948e+00, 1.01035408e+00, 1.01039064e+00, 1.01043047e+00, + 1.01047227e+00, 1.01051710e+00, 1.01056410e+00, 1.01061427e+00, + 1.01066629e+00, 1.01072136e+00, 1.01077842e+00, 1.01083825e+00, + 1.01089966e+00, 1.01096373e+00, 1.01102919e+00, 1.01109699e+00, + 1.01116586e+00, 1.01123661e+00, 1.01130817e+00, 1.01138145e+00, + 1.01145479e+00, 1.01152919e+00, 1.01160368e+00, 1.01167880e+00, + 1.01175301e+00, 1.01182748e+00, 1.01190094e+00, 1.01197388e+00, + 1.01204489e+00, 1.01211499e+00, 1.01218284e+00, 1.01224902e+00, + 1.01231210e+00, 1.01237303e+00, 1.01243046e+00, 1.01248497e+00, + 1.01253506e+00, 1.01258168e+00, 1.01262347e+00, 1.01266098e+00, + 1.01269276e+00, 1.01271979e+00, 1.01274058e+00, 1.01275575e+00, + 1.01276395e+00, 1.01276592e+00, 1.01276030e+00, 1.01274782e+00, + 1.01272696e+00, 1.01269861e+00, 1.01266140e+00, 1.01261590e+00, + 1.01256083e+00, 1.01249705e+00, 1.01242289e+00, 1.01233923e+00, + 1.01224492e+00, 1.01214046e+00, 1.01202430e+00, 1.01189756e+00, + 1.01175881e+00, 1.01160845e+00, 1.01144516e+00, 1.01126996e+00, + 1.01108126e+00, 1.01087961e+00, 1.01066368e+00, 1.01043418e+00, + 1.01018968e+00, 1.00993075e+00, 1.00965566e+00, 1.00936525e+00, + 1.00905825e+00, 1.00873476e+00, 1.00839308e+00, 1.00803431e+00, + 1.00765666e+00, 1.00726014e+00, 1.00684335e+00, 1.00640701e+00, + 1.00594915e+00, 1.00547001e+00, 1.00496799e+00, 1.00444353e+00, + 1.00389477e+00, 1.00332190e+00, 1.00272313e+00, 1.00209885e+00, + 1.00144728e+00, 1.00076851e+00, 1.00006069e+00, 9.99324268e-01, + 9.98557350e-01, 9.97760020e-01, 9.96930604e-01, 9.96069427e-01, + 9.95174643e-01, 9.94246644e-01, 9.93283713e-01, 9.92286108e-01, + 9.91252309e-01, 9.90182742e-01, 9.89075787e-01, 9.87931302e-01, + 9.86355322e-01, 9.84736245e-01, 9.83175095e-01, 9.81558334e-01, + 9.79861353e-01, 9.78061749e-01, 9.76157432e-01, 9.74137862e-01, + 9.71999011e-01, 9.69732741e-01, 9.67333198e-01, 9.64791512e-01, + 9.62101150e-01, 9.59253976e-01, 9.56242718e-01, 9.53060091e-01, + 9.49698408e-01, 9.46149812e-01, 9.42407161e-01, 9.38463416e-01, + 9.34311297e-01, 9.29944987e-01, 9.25356797e-01, 9.20540463e-01, + 9.15489628e-01, 9.10198679e-01, 9.04662060e-01, 8.98875519e-01, + 8.92833832e-01, 8.86533719e-01, 8.79971272e-01, 8.73143784e-01, + 8.66047653e-01, 8.58681252e-01, 8.51042044e-01, 8.43129723e-01, + 8.34943514e-01, 8.26483991e-01, 8.17750537e-01, 8.08744982e-01, + 7.99468149e-01, 7.89923516e-01, 7.80113773e-01, 7.70043128e-01, + 7.59714574e-01, 7.49133097e-01, 7.38302860e-01, 7.27229876e-01, + 7.15920192e-01, 7.04381434e-01, 6.92619693e-01, 6.80643883e-01, + 6.68461648e-01, 6.56083014e-01, 6.43517927e-01, 6.30775533e-01, + 6.17864165e-01, 6.04795463e-01, 5.91579959e-01, 5.78228937e-01, + 5.64753589e-01, 5.51170316e-01, 5.37490509e-01, 5.23726350e-01, + 5.09891542e-01, 4.96000807e-01, 4.82066294e-01, 4.68101711e-01, + 4.54121700e-01, 4.40142182e-01, 4.26177297e-01, 4.12241789e-01, + 3.98349961e-01, 3.84517234e-01, 3.70758372e-01, 3.57088679e-01, + 3.43522867e-01, 3.30076376e-01, 3.16764033e-01, 3.03600465e-01, + 2.90599616e-01, 2.77775850e-01, 2.65143468e-01, 2.52716188e-01, + 2.40506985e-01, 2.28528397e-01, 2.16793343e-01, 2.05313990e-01, + 1.94102191e-01, 1.83168087e-01, 1.72522195e-01, 1.62173542e-01, + 1.52132068e-01, 1.42405280e-01, 1.33001524e-01, 1.23926066e-01, + 1.15185830e-01, 1.06784043e-01, 9.87263751e-02, 9.10137900e-02, + 8.36505724e-02, 7.66350831e-02, 6.99703341e-02, 6.36518811e-02, + 5.76817602e-02, 5.20524422e-02, 4.67653841e-02, 4.18095054e-02, + 3.71864025e-02, 3.28807275e-02, 2.88954850e-02, 2.52098057e-02, + 2.18305756e-02, 1.87289619e-02, 1.59212782e-02, 1.33638143e-02, + 1.10855888e-02, 8.94347419e-03, 6.75812489e-03, 3.50443813e-03, +}; + +#if LC3_PLUS_HR + +static const float mdct_win_10m_48k_hr[__LC3_MDCT_WIN_LEN(10000, 48000)] = { + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 9.42341174e-08, 6.19838374e-07, 1.82603810e-06, 4.22741550e-06, + 8.56822135e-06, 1.59013834e-05, 2.76738483e-05, 4.58246141e-05, + 7.28956657e-05, 1.12155336e-04, 1.67733029e-04, 2.44763592e-04, + 3.49539070e-04, 4.89664846e-04, 6.74216484e-04, 9.13893222e-04, + 1.22116262e-03, 1.61039189e-03, 2.09795963e-03, 2.70234118e-03, + 3.44416290e-03, 4.34621749e-03, 5.43343695e-03, 6.73281262e-03, + 8.27326626e-03, 1.00854570e-02, 1.22015327e-02, 1.46548180e-02, + 1.74794346e-02, 2.07098722e-02, 2.43804958e-02, 2.85249949e-02, + 3.31758074e-02, 3.83635014e-02, 4.41161096e-02, 5.04585020e-02, + 5.74117042e-02, 6.49922863e-02, 7.32117295e-02, 8.20759088e-02, + 9.15845558e-02, 1.01730898e-01, 1.12501279e-01, 1.23875007e-01, + 1.35824218e-01, 1.48313895e-01, 1.61302090e-01, 1.74740151e-01, + 1.88573152e-01, 2.02740535e-01, 2.17176691e-01, 2.31811777e-01, + 2.46572644e-01, 2.61383832e-01, 2.76168495e-01, 2.90849626e-01, + 3.05351138e-01, 3.19598824e-01, 3.33521664e-01, 3.47052664e-01, + 3.60129982e-01, 3.72697920e-01, 3.84707332e-01, 3.96116525e-01, + 4.06891733e-01, 4.17007536e-01, 4.26446915e-01, 4.35201406e-01, + 4.43271041e-01, 4.50664014e-01, 4.57396388e-01, 4.63491529e-01, + 4.68979478e-01, 4.73896384e-01, 4.78283674e-01, 4.82187212e-01, + 4.85656589e-01, 4.88744229e-01, 4.91504699e-01, 4.93993789e-01, + 4.96267974e-01, 4.98383760e-01, 5.00396967e-01, 5.02362430e-01, + 5.04333496e-01, 5.06361604e-01, 5.08496106e-01, 5.10783911e-01, + 5.13269365e-01, 5.15994072e-01, 5.18996596e-01, 5.22312462e-01, + 5.25973916e-01, 5.30009925e-01, 5.34445822e-01, 5.39303243e-01, + 5.44600070e-01, 5.50350249e-01, 5.56563497e-01, 5.63245535e-01, + 5.70397854e-01, 5.78017771e-01, 5.86098313e-01, 5.94628513e-01, + 6.03593290e-01, 6.12973869e-01, 6.22747838e-01, 6.32889450e-01, + 6.43370092e-01, 6.54158235e-01, 6.65220201e-01, 6.76520288e-01, + 6.88021243e-01, 6.99684739e-01, 7.11471498e-01, 7.23342001e-01, + 7.35256732e-01, 7.47176409e-01, 7.59062469e-01, 7.70877421e-01, + 7.82584906e-01, 7.94150114e-01, 8.05540025e-01, 8.16723466e-01, + 8.27671409e-01, 8.38356972e-01, 8.48755658e-01, 8.58845115e-01, + 8.68605733e-01, 8.78019989e-01, 8.87072980e-01, 8.95752132e-01, + 9.04047191e-01, 9.11950290e-01, 9.19455826e-01, 9.26560223e-01, + 9.33262229e-01, 9.39562619e-01, 9.45464134e-01, 9.50971425e-01, + 9.56090987e-01, 9.60831106e-01, 9.65201676e-01, 9.69214201e-01, + 9.72881556e-01, 9.76217866e-01, 9.79238510e-01, 9.81959701e-01, + 9.84398544e-01, 9.86572623e-01, 9.88499999e-01, 9.90198970e-01, + 9.91687655e-01, 9.92984235e-01, 9.94106293e-01, 9.95071113e-01, + 9.95895147e-01, 9.96594131e-01, 9.97182965e-01, 9.97675478e-01, + 9.98084545e-01, 9.98421967e-01, 9.98698533e-01, 9.98923838e-01, + 9.99106586e-01, 9.99254227e-01, 9.99373496e-01, 9.99470055e-01, + 9.99548733e-01, 9.99613643e-01, 9.99668002e-01, 9.99714673e-01, + 9.99755740e-01, 9.99792874e-01, 9.99827385e-01, 9.99860168e-01, + 9.99891937e-01, 9.99923110e-01, 9.99953985e-01, 9.99984682e-01, + 1.00001526e+00, 1.00004578e+00, 1.00007617e+00, 1.00010622e+00, + 1.00013602e+00, 1.00016546e+00, 1.00019431e+00, 1.00022256e+00, + 1.00025010e+00, 1.00027692e+00, 1.00030291e+00, 1.00032794e+00, + 1.00035203e+00, 1.00037491e+00, 1.00039685e+00, 1.00041747e+00, + 1.00043690e+00, 1.00045502e+00, 1.00047183e+00, 1.00048721e+00, + 1.00050116e+00, 1.00051367e+00, 1.00052476e+00, 1.00053418e+00, + 1.00054228e+00, 1.00054872e+00, 1.00055361e+00, 1.00055695e+00, + 1.00055885e+00, 1.00055909e+00, 1.00055790e+00, 1.00055504e+00, + 1.00055087e+00, 1.00054502e+00, 1.00053787e+00, 1.00052929e+00, + 1.00051928e+00, 1.00050783e+00, 1.00049520e+00, 1.00048113e+00, + 1.00046599e+00, 1.00044954e+00, 1.00043201e+00, 1.00041330e+00, + 1.00039363e+00, 1.00037301e+00, 1.00035143e+00, 1.00032890e+00, + 1.00030565e+00, 1.00028157e+00, 1.00025690e+00, 1.00023150e+00, + 1.00020564e+00, 1.00017929e+00, 1.00015235e+00, 1.00012517e+00, + 1.00009763e+00, 1.00006998e+00, 1.00004208e+00, 1.00001407e+00, + 9.99985993e-01, 9.99957979e-01, 9.99930084e-01, 9.99902308e-01, + 9.99874830e-01, 9.99847591e-01, 9.99820769e-01, 9.99794364e-01, + 9.99768496e-01, 9.99743164e-01, 9.99718428e-01, 9.99694467e-01, + 9.99671161e-01, 9.99648750e-01, 9.99627173e-01, 9.99606490e-01, + 9.99586821e-01, 9.99568224e-01, 9.99550641e-01, 9.99534249e-01, + 9.99519050e-01, 9.99505103e-01, 9.99492407e-01, 9.99481022e-01, + 9.99471009e-01, 9.99462426e-01, 9.99455214e-01, 9.99449492e-01, + 9.99445200e-01, 9.99442458e-01, 9.99441206e-01, 9.99441504e-01, + 9.99443293e-01, 9.99446690e-01, 9.99451578e-01, 9.99458075e-01, + 9.99466062e-01, 9.99475598e-01, 9.99486566e-01, 9.99499083e-01, + 9.99513030e-01, 9.99528408e-01, 9.99545157e-01, 9.99563277e-01, + 9.99582708e-01, 9.99603331e-01, 9.99625206e-01, 9.99648154e-01, + 9.99672174e-01, 9.99697208e-01, 9.99723136e-01, 9.99749959e-01, + 9.99777496e-01, 9.99805748e-01, 9.99834597e-01, 9.99863982e-01, + 9.99893785e-01, 9.99923885e-01, 9.99954224e-01, 9.99984741e-01, + 1.00001526e+00, 1.00004578e+00, 1.00007617e+00, 1.00010622e+00, + 1.00013602e+00, 1.00016546e+00, 1.00019431e+00, 1.00022256e+00, + 1.00025010e+00, 1.00027692e+00, 1.00030291e+00, 1.00032794e+00, + 1.00035203e+00, 1.00037491e+00, 1.00039685e+00, 1.00041747e+00, + 1.00043690e+00, 1.00045502e+00, 1.00047183e+00, 1.00048721e+00, + 1.00050116e+00, 1.00051367e+00, 1.00052476e+00, 1.00053418e+00, + 1.00054228e+00, 1.00054872e+00, 1.00055361e+00, 1.00055695e+00, + 1.00055885e+00, 1.00055909e+00, 1.00055790e+00, 1.00055504e+00, + 1.00055087e+00, 1.00054502e+00, 1.00053787e+00, 1.00052929e+00, + 1.00051928e+00, 1.00050783e+00, 1.00049520e+00, 1.00048113e+00, + 1.00046599e+00, 1.00044954e+00, 1.00043201e+00, 1.00041330e+00, + 1.00039363e+00, 1.00037301e+00, 1.00035143e+00, 1.00032890e+00, + 1.00030565e+00, 1.00028157e+00, 1.00025690e+00, 1.00023150e+00, + 1.00020564e+00, 1.00017929e+00, 1.00015235e+00, 1.00012517e+00, + 1.00009763e+00, 1.00006998e+00, 1.00004208e+00, 1.00001407e+00, + 9.99985993e-01, 9.99957979e-01, 9.99930084e-01, 9.99902308e-01, + 9.99874830e-01, 9.99847591e-01, 9.99820769e-01, 9.99794364e-01, + 9.99768496e-01, 9.99743164e-01, 9.99718428e-01, 9.99694467e-01, + 9.99671161e-01, 9.99648750e-01, 9.99627173e-01, 9.99606490e-01, + 9.99586821e-01, 9.99568224e-01, 9.99550641e-01, 9.99534249e-01, + 9.99519050e-01, 9.99505103e-01, 9.99492407e-01, 9.99481022e-01, + 9.99471009e-01, 9.99462426e-01, 9.99455214e-01, 9.99449492e-01, + 9.99445200e-01, 9.99442458e-01, 9.99441206e-01, 9.99441504e-01, + 9.99443293e-01, 9.99446690e-01, 9.99451578e-01, 9.99458075e-01, + 9.99466062e-01, 9.99475598e-01, 9.99486566e-01, 9.99499083e-01, + 9.99513030e-01, 9.99528408e-01, 9.99545157e-01, 9.99563277e-01, + 9.99582708e-01, 9.99603331e-01, 9.99625206e-01, 9.99648154e-01, + 9.99672174e-01, 9.99697208e-01, 9.99723136e-01, 9.99749959e-01, + 9.99777496e-01, 9.99805748e-01, 9.99834597e-01, 9.99863982e-01, + 9.99893785e-01, 9.99923885e-01, 9.99954224e-01, 9.99984741e-01, + 1.00001526e+00, 1.00004578e+00, 1.00007617e+00, 1.00010622e+00, + 1.00013602e+00, 1.00016546e+00, 1.00019431e+00, 1.00022256e+00, + 1.00025010e+00, 1.00027692e+00, 1.00030291e+00, 1.00032794e+00, + 1.00035203e+00, 1.00037491e+00, 1.00039685e+00, 1.00041747e+00, + 1.00043690e+00, 1.00045502e+00, 1.00047183e+00, 1.00048721e+00, + 1.00050116e+00, 1.00051367e+00, 1.00052476e+00, 1.00053418e+00, + 1.00054228e+00, 1.00054872e+00, 1.00055361e+00, 1.00055695e+00, + 1.00055885e+00, 1.00055909e+00, 1.00055790e+00, 1.00055504e+00, + 1.00055087e+00, 1.00054502e+00, 1.00053787e+00, 1.00052929e+00, + 1.00051928e+00, 1.00050783e+00, 1.00049520e+00, 1.00048113e+00, + 1.00046599e+00, 1.00044954e+00, 1.00043201e+00, 1.00041330e+00, + 1.00039363e+00, 1.00037301e+00, 1.00035143e+00, 1.00032890e+00, + 1.00030565e+00, 1.00028157e+00, 1.00025690e+00, 1.00023150e+00, + 1.00020564e+00, 1.00017929e+00, 1.00015235e+00, 1.00012517e+00, + 1.00009763e+00, 1.00006998e+00, 1.00004208e+00, 1.00001407e+00, + 9.99985993e-01, 9.99957979e-01, 9.99930084e-01, 9.99902308e-01, + 9.99874830e-01, 9.99847591e-01, 9.99820769e-01, 9.99794364e-01, + 9.99768496e-01, 9.99743164e-01, 9.99718428e-01, 9.99694467e-01, + 9.99671161e-01, 9.99648750e-01, 9.99627173e-01, 9.99606490e-01, + 9.99586821e-01, 9.99568224e-01, 9.99550641e-01, 9.99534249e-01, + 9.99519050e-01, 9.99505103e-01, 9.99492407e-01, 9.99481022e-01, + 9.99471009e-01, 9.99462426e-01, 9.99455214e-01, 9.99449492e-01, + 9.99445200e-01, 9.99442458e-01, 9.99441206e-01, 9.99441504e-01, + 9.99443293e-01, 9.99446690e-01, 9.99451578e-01, 9.99458075e-01, + 9.99466062e-01, 9.99475598e-01, 9.99486566e-01, 9.99499083e-01, + 9.99513030e-01, 9.99528408e-01, 9.99545157e-01, 9.99563277e-01, + 9.99582708e-01, 9.99603331e-01, 9.99625206e-01, 9.99648154e-01, + 9.99672174e-01, 9.99697208e-01, 9.99723136e-01, 9.99749959e-01, + 9.99777496e-01, 9.99805748e-01, 9.99834597e-01, 9.99863982e-01, + 9.99893785e-01, 9.99923885e-01, 9.99954224e-01, 9.99984741e-01, + 1.00001526e+00, 1.00004554e+00, 1.00007534e+00, 1.00010443e+00, + 1.00013220e+00, 1.00015819e+00, 1.00018132e+00, 1.00020075e+00, + 1.00021482e+00, 1.00022173e+00, 1.00021923e+00, 1.00020432e+00, + 1.00017369e+00, 1.00012279e+00, 1.00004685e+00, 9.99939978e-01, + 9.99795198e-01, 9.99604583e-01, 9.99359250e-01, 9.99048889e-01, + 9.98662114e-01, 9.98186171e-01, 9.97606814e-01, 9.96908367e-01, + 9.96073723e-01, 9.95083988e-01, 9.93918717e-01, 9.92555678e-01, + 9.90970671e-01, 9.89137888e-01, 9.87029374e-01, 9.84615326e-01, + 9.81863916e-01, 9.78741586e-01, 9.75212753e-01, 9.71240282e-01, + 9.66785491e-01, 9.61808383e-01, 9.56268132e-01, 9.50123310e-01, + 9.43332374e-01, 9.35854316e-01, 9.27648962e-01, 9.18677926e-01, + 9.08904910e-01, 8.98296535e-01, 8.86823177e-01, 8.74459147e-01, + 8.61183822e-01, 8.46981943e-01, 8.31844091e-01, 8.15767467e-01, + 7.98755884e-01, 7.80820429e-01, 7.61979520e-01, 7.42259145e-01, + 7.21692860e-01, 7.00321794e-01, 6.78194642e-01, 6.55367255e-01, + 6.31902635e-01, 6.07870460e-01, 5.83346546e-01, 5.58412433e-01, + 5.33154905e-01, 5.07664979e-01, 4.82037485e-01, 4.56370175e-01, + 4.30762708e-01, 4.05315757e-01, 3.80130053e-01, 3.55305195e-01, + 3.30938727e-01, 3.07124883e-01, 2.83953428e-01, 2.61508703e-01, + 2.39868388e-01, 2.19102606e-01, 1.99272946e-01, 1.80431694e-01, + 1.62621215e-01, 1.45873442e-01, 1.30209655e-01, 1.15640387e-01, + 1.02165572e-01, 8.97749513e-02, 7.84486011e-02, 6.81576878e-02, + 5.88653944e-02, 5.05279638e-02, 4.30957973e-02, 3.65146622e-02, + 3.07268873e-02, 2.56725382e-02, 2.12905537e-02, 1.75197981e-02, + 1.43000064e-02, 1.15726292e-02, 9.28153656e-03, 7.37359654e-03, + 5.79912262e-03, 4.51218896e-03, 3.47083295e-03, 2.63714185e-03, + 1.97724649e-03, 1.46123092e-03, 1.06297329e-03, 7.59930001e-04, + 5.32880833e-04, 3.65644053e-04, 2.44775380e-04, 1.59260671e-04, + 1.00211051e-04, 6.05685127e-05, 3.48275607e-05, 1.87775731e-05, + 9.26902067e-06, 4.00523413e-06, 1.35989160e-06, 2.06769442e-07, +}; + +static const float mdct_win_10m_96k_hr[__LC3_MDCT_WIN_LEN(10000, 96000)] = { + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, 0.00000000e+00, + 6.66310811e-08, 2.23723916e-07, 4.87541854e-07, 8.99672727e-07, + 1.51141830e-06, 2.38590815e-06, 3.60002150e-06, 5.24645884e-06, + 7.43599958e-06, 1.02999529e-05, 1.39928125e-05, 1.86951092e-05, + 2.46164800e-05, 3.19989194e-05, 4.11202636e-05, 5.22978444e-05, + 6.58923600e-05, 8.23118899e-05, 1.02016144e-04, 1.25520819e-04, + 1.53402099e-04, 1.86301360e-04, 2.24929841e-04, 2.70073535e-04, + 3.22598062e-04, 3.83453589e-04, 4.53679706e-04, 5.34410414e-04, + 6.26878755e-04, 7.32421642e-04, 8.52484489e-04, 9.88625223e-04, + 1.14251883e-03, 1.31596089e-03, 1.51087111e-03, 1.72929652e-03, + 1.97341433e-03, 2.24553375e-03, 2.54809810e-03, 2.88368552e-03, + 3.25501012e-03, 3.66492104e-03, 4.11640201e-03, 4.61257016e-03, + 5.15667303e-03, 5.75208431e-03, 6.40230207e-03, 7.11094262e-03, + 7.88173359e-03, 8.71850923e-03, 9.62519925e-03, 1.06058242e-02, + 1.16644828e-02, 1.28053408e-02, 1.40326228e-02, 1.53505951e-02, + 1.67635549e-02, 1.82758160e-02, 1.98916886e-02, 2.16154736e-02, + 2.34514344e-02, 2.54037846e-02, 2.74766665e-02, 2.96741407e-02, + 3.20001543e-02, 3.44585292e-02, 3.70529443e-02, 3.97869013e-02, + 4.26637232e-02, 4.56865206e-02, 4.88581695e-02, 5.21813035e-02, + 5.56582808e-02, 5.92911765e-02, 6.30817562e-02, 6.70314580e-02, + 7.11413696e-02, 7.54122287e-02, 7.98443928e-02, 8.44378322e-02, + 8.91921073e-02, 9.41063836e-02, 9.91793722e-02, 1.04409374e-01, + 1.09794252e-01, 1.15331404e-01, 1.21017799e-01, 1.26849949e-01, + 1.32823929e-01, 1.38935357e-01, 1.45179421e-01, 1.51550874e-01, + 1.58044025e-01, 1.64652810e-01, 1.71370730e-01, 1.78190947e-01, + 1.85106188e-01, 1.92108899e-01, 1.99191183e-01, 2.06344813e-01, + 2.13561311e-01, 2.20831960e-01, 2.28147790e-01, 2.35499650e-01, + 2.42878228e-01, 2.50274092e-01, 2.57677704e-01, 2.65079439e-01, + 2.72469670e-01, 2.79838771e-01, 2.87177145e-01, 2.94475257e-01, + 3.01723719e-01, 3.08913231e-01, 3.16034675e-01, 3.23079228e-01, + 3.30038190e-01, 3.36903185e-01, 3.43666196e-01, 3.50319386e-01, + 3.56855512e-01, 3.63267571e-01, 3.69548947e-01, 3.75693500e-01, + 3.81695598e-01, 3.87549996e-01, 3.93251985e-01, 3.98797333e-01, + 4.04182315e-01, 4.09403801e-01, 4.14459109e-01, 4.19346124e-01, + 4.24063236e-01, 4.28609401e-01, 4.32984143e-01, 4.37187403e-01, + 4.41219747e-01, 4.45082188e-01, 4.48776275e-01, 4.52303976e-01, + 4.55667824e-01, 4.58870709e-01, 4.61916000e-01, 4.64807451e-01, + 4.67549264e-01, 4.70145911e-01, 4.72602278e-01, 4.74923581e-01, + 4.77115244e-01, 4.79183048e-01, 4.81132984e-01, 4.82971221e-01, + 4.84704226e-01, 4.86338496e-01, 4.87880766e-01, 4.89337832e-01, + 4.90716666e-01, 4.92024213e-01, 4.93267536e-01, 4.94453669e-01, + 4.95589703e-01, 4.96682733e-01, 4.97739762e-01, 4.98767793e-01, + 4.99773741e-01, 5.00764489e-01, 5.01746774e-01, 5.02727270e-01, + 5.03712595e-01, 5.04709125e-01, 5.05723178e-01, 5.06760955e-01, + 5.07828474e-01, 5.08931518e-01, 5.10075927e-01, 5.11267185e-01, + 5.12510598e-01, 5.13811469e-01, 5.15174806e-01, 5.16605377e-01, + 5.18107831e-01, 5.19686580e-01, 5.21345973e-01, 5.23089945e-01, + 5.24922311e-01, 5.26846766e-01, 5.28866649e-01, 5.30985177e-01, + 5.33205211e-01, 5.35529494e-01, 5.37960529e-01, 5.40500462e-01, + 5.43151379e-01, 5.45914948e-01, 5.48792660e-01, 5.51785827e-01, + 5.54895282e-01, 5.58121800e-01, 5.61465800e-01, 5.64927518e-01, + 5.68506777e-01, 5.72203338e-01, 5.76016545e-01, 5.79945564e-01, + 5.83989203e-01, 5.88146091e-01, 5.92414677e-01, 5.96792936e-01, + 6.01278901e-01, 6.05870068e-01, 6.10563993e-01, 6.15357757e-01, + 6.20248437e-01, 6.25232756e-01, 6.30307317e-01, 6.35468543e-01, + 6.40712619e-01, 6.46035612e-01, 6.51433527e-01, 6.56902015e-01, + 6.62436843e-01, 6.68033481e-01, 6.73687398e-01, 6.79393888e-01, + 6.85148239e-01, 6.90945625e-01, 6.96781278e-01, 7.02650130e-01, + 7.08547413e-01, 7.14468122e-01, 7.20407307e-01, 7.26359963e-01, + 7.32321203e-01, 7.38286138e-01, 7.44249880e-01, 7.50207603e-01, + 7.56154597e-01, 7.62086034e-01, 7.67997444e-01, 7.73884177e-01, + 7.79741824e-01, 7.85566032e-01, 7.91352570e-01, 7.97097266e-01, + 8.02796185e-01, 8.08445334e-01, 8.14041018e-01, 8.19579542e-01, + 8.25057447e-01, 8.30471396e-01, 8.35818112e-01, 8.41094613e-01, + 8.46297920e-01, 8.51425231e-01, 8.56473923e-01, 8.61441612e-01, + 8.66325855e-01, 8.71124566e-01, 8.75835657e-01, 8.80457282e-01, + 8.84987772e-01, 8.89425457e-01, 8.93768966e-01, 8.98017049e-01, + 9.02168512e-01, 9.06222403e-01, 9.10177886e-01, 9.14034188e-01, + 9.17790771e-01, 9.21447217e-01, 9.25003231e-01, 9.28458691e-01, + 9.31813419e-01, 9.35067594e-01, 9.38221455e-01, 9.41275299e-01, + 9.44229603e-01, 9.47084904e-01, 9.49841976e-01, 9.52501595e-01, + 9.55064654e-01, 9.57532167e-01, 9.59905326e-01, 9.62185323e-01, + 9.64373529e-01, 9.66471374e-01, 9.68480289e-01, 9.70402002e-01, + 9.72238123e-01, 9.73990440e-01, 9.75660801e-01, 9.77251112e-01, + 9.78763342e-01, 9.80199575e-01, 9.81561780e-01, 9.82852161e-01, + 9.84072864e-01, 9.85226095e-01, 9.86314118e-01, 9.87339139e-01, + 9.88303483e-01, 9.89209354e-01, 9.90059078e-01, 9.90854919e-01, + 9.91599143e-01, 9.92294014e-01, 9.92941797e-01, 9.93544638e-01, + 9.94104803e-01, 9.94624376e-01, 9.95105505e-01, 9.95550215e-01, + 9.95960534e-01, 9.96338427e-01, 9.96685863e-01, 9.97004628e-01, + 9.97296572e-01, 9.97563362e-01, 9.97806728e-01, 9.98028338e-01, + 9.98229563e-01, 9.98412073e-01, 9.98577118e-01, 9.98726189e-01, + 9.98860478e-01, 9.98981178e-01, 9.99089479e-01, 9.99186397e-01, + 9.99273062e-01, 9.99350369e-01, 9.99419153e-01, 9.99480307e-01, + 9.99534547e-01, 9.99582708e-01, 9.99625325e-01, 9.99663055e-01, + 9.99696434e-01, 9.99726057e-01, 9.99752283e-01, 9.99775589e-01, + 9.99796331e-01, 9.99814928e-01, 9.99831557e-01, 9.99846578e-01, + 9.99860287e-01, 9.99872804e-01, 9.99884307e-01, 9.99895036e-01, + 9.99905109e-01, 9.99914587e-01, 9.99923646e-01, 9.99932408e-01, + 9.99940872e-01, 9.99949098e-01, 9.99957144e-01, 9.99965072e-01, + 9.99972939e-01, 9.99980748e-01, 9.99988437e-01, 9.99996126e-01, + 1.00000381e+00, 1.00001144e+00, 1.00001907e+00, 1.00002670e+00, + 1.00003433e+00, 1.00004184e+00, 1.00004935e+00, 1.00005686e+00, + 1.00006437e+00, 1.00007176e+00, 1.00007904e+00, 1.00008631e+00, + 1.00009358e+00, 1.00010073e+00, 1.00010777e+00, 1.00011480e+00, + 1.00012159e+00, 1.00012839e+00, 1.00013518e+00, 1.00014174e+00, + 1.00014830e+00, 1.00015461e+00, 1.00016093e+00, 1.00016701e+00, + 1.00017309e+00, 1.00017893e+00, 1.00018466e+00, 1.00019026e+00, + 1.00019574e+00, 1.00020099e+00, 1.00020623e+00, 1.00021124e+00, + 1.00021613e+00, 1.00022078e+00, 1.00022531e+00, 1.00022972e+00, + 1.00023389e+00, 1.00023794e+00, 1.00024176e+00, 1.00024545e+00, + 1.00024891e+00, 1.00025225e+00, 1.00025535e+00, 1.00025833e+00, + 1.00026107e+00, 1.00026357e+00, 1.00026596e+00, 1.00026822e+00, + 1.00027013e+00, 1.00027204e+00, 1.00027359e+00, 1.00027502e+00, + 1.00027621e+00, 1.00027728e+00, 1.00027812e+00, 1.00027883e+00, + 1.00027919e+00, 1.00027955e+00, 1.00027955e+00, 1.00027943e+00, + 1.00027919e+00, 1.00027859e+00, 1.00027800e+00, 1.00027704e+00, + 1.00027597e+00, 1.00027478e+00, 1.00027335e+00, 1.00027168e+00, + 1.00026989e+00, 1.00026786e+00, 1.00026572e+00, 1.00026345e+00, + 1.00026095e+00, 1.00025821e+00, 1.00025535e+00, 1.00025237e+00, + 1.00024927e+00, 1.00024593e+00, 1.00024235e+00, 1.00023878e+00, + 1.00023496e+00, 1.00023091e+00, 1.00022686e+00, 1.00022256e+00, + 1.00021827e+00, 1.00021374e+00, 1.00020909e+00, 1.00020421e+00, + 1.00019932e+00, 1.00019431e+00, 1.00018907e+00, 1.00018382e+00, + 1.00017846e+00, 1.00017297e+00, 1.00016737e+00, 1.00016165e+00, + 1.00015581e+00, 1.00014985e+00, 1.00014389e+00, 1.00013781e+00, + 1.00013161e+00, 1.00012529e+00, 1.00011897e+00, 1.00011253e+00, + 1.00010610e+00, 1.00009954e+00, 1.00009298e+00, 1.00008631e+00, + 1.00007963e+00, 1.00007284e+00, 1.00006604e+00, 1.00005913e+00, + 1.00005233e+00, 1.00004542e+00, 1.00003850e+00, 1.00003147e+00, + 1.00002456e+00, 1.00001752e+00, 1.00001049e+00, 1.00000346e+00, + 9.99996483e-01, 9.99989510e-01, 9.99982476e-01, 9.99975502e-01, + 9.99968529e-01, 9.99961555e-01, 9.99954641e-01, 9.99947727e-01, + 9.99940813e-01, 9.99933958e-01, 9.99927163e-01, 9.99920428e-01, + 9.99913692e-01, 9.99907076e-01, 9.99900460e-01, 9.99893904e-01, + 9.99887466e-01, 9.99881029e-01, 9.99874711e-01, 9.99868453e-01, + 9.99862254e-01, 9.99856174e-01, 9.99850154e-01, 9.99844253e-01, + 9.99838412e-01, 9.99832690e-01, 9.99827087e-01, 9.99821603e-01, + 9.99816179e-01, 9.99810934e-01, 9.99805748e-01, 9.99800682e-01, + 9.99795794e-01, 9.99791026e-01, 9.99786317e-01, 9.99781847e-01, + 9.99777436e-01, 9.99773204e-01, 9.99769092e-01, 9.99765158e-01, + 9.99761343e-01, 9.99757707e-01, 9.99754190e-01, 9.99750853e-01, + 9.99747694e-01, 9.99744654e-01, 9.99741852e-01, 9.99739170e-01, + 9.99736667e-01, 9.99734342e-01, 9.99732137e-01, 9.99730170e-01, + 9.99728382e-01, 9.99726772e-01, 9.99725342e-01, 9.99724090e-01, + 9.99723017e-01, 9.99722123e-01, 9.99721408e-01, 9.99720931e-01, + 9.99720633e-01, 9.99720514e-01, 9.99720573e-01, 9.99720812e-01, + 9.99721289e-01, 9.99721944e-01, 9.99722779e-01, 9.99723792e-01, + 9.99725044e-01, 9.99726474e-01, 9.99728084e-01, 9.99729872e-01, + 9.99731898e-01, 9.99734104e-01, 9.99736488e-01, 9.99739051e-01, + 9.99741793e-01, 9.99744713e-01, 9.99747872e-01, 9.99751151e-01, + 9.99754667e-01, 9.99758303e-01, 9.99762177e-01, 9.99766171e-01, + 9.99770403e-01, 9.99774754e-01, 9.99779284e-01, 9.99783993e-01, + 9.99788821e-01, 9.99793828e-01, 9.99799013e-01, 9.99804318e-01, + 9.99809742e-01, 9.99815404e-01, 9.99821126e-01, 9.99826968e-01, + 9.99832988e-01, 9.99839127e-01, 9.99845386e-01, 9.99851763e-01, + 9.99858260e-01, 9.99864876e-01, 9.99871552e-01, 9.99878347e-01, + 9.99885261e-01, 9.99892235e-01, 9.99899328e-01, 9.99906480e-01, + 9.99913692e-01, 9.99920964e-01, 9.99928296e-01, 9.99935687e-01, + 9.99943137e-01, 9.99950647e-01, 9.99958158e-01, 9.99965727e-01, + 9.99973297e-01, 9.99980927e-01, 9.99988556e-01, 9.99996185e-01, + 1.00000381e+00, 1.00001144e+00, 1.00001907e+00, 1.00002670e+00, + 1.00003433e+00, 1.00004184e+00, 1.00004935e+00, 1.00005686e+00, + 1.00006437e+00, 1.00007176e+00, 1.00007904e+00, 1.00008631e+00, + 1.00009358e+00, 1.00010073e+00, 1.00010777e+00, 1.00011480e+00, + 1.00012159e+00, 1.00012839e+00, 1.00013518e+00, 1.00014174e+00, + 1.00014830e+00, 1.00015461e+00, 1.00016093e+00, 1.00016701e+00, + 1.00017309e+00, 1.00017893e+00, 1.00018466e+00, 1.00019026e+00, + 1.00019574e+00, 1.00020099e+00, 1.00020623e+00, 1.00021124e+00, + 1.00021613e+00, 1.00022078e+00, 1.00022531e+00, 1.00022972e+00, + 1.00023389e+00, 1.00023794e+00, 1.00024176e+00, 1.00024545e+00, + 1.00024891e+00, 1.00025225e+00, 1.00025535e+00, 1.00025833e+00, + 1.00026107e+00, 1.00026357e+00, 1.00026596e+00, 1.00026822e+00, + 1.00027013e+00, 1.00027204e+00, 1.00027359e+00, 1.00027502e+00, + 1.00027621e+00, 1.00027728e+00, 1.00027812e+00, 1.00027883e+00, + 1.00027919e+00, 1.00027955e+00, 1.00027955e+00, 1.00027943e+00, + 1.00027919e+00, 1.00027859e+00, 1.00027800e+00, 1.00027704e+00, + 1.00027597e+00, 1.00027478e+00, 1.00027335e+00, 1.00027168e+00, + 1.00026989e+00, 1.00026786e+00, 1.00026572e+00, 1.00026345e+00, + 1.00026095e+00, 1.00025821e+00, 1.00025535e+00, 1.00025237e+00, + 1.00024927e+00, 1.00024593e+00, 1.00024235e+00, 1.00023878e+00, + 1.00023496e+00, 1.00023091e+00, 1.00022686e+00, 1.00022256e+00, + 1.00021827e+00, 1.00021374e+00, 1.00020909e+00, 1.00020421e+00, + 1.00019932e+00, 1.00019431e+00, 1.00018907e+00, 1.00018382e+00, + 1.00017846e+00, 1.00017297e+00, 1.00016737e+00, 1.00016165e+00, + 1.00015581e+00, 1.00014985e+00, 1.00014389e+00, 1.00013781e+00, + 1.00013161e+00, 1.00012529e+00, 1.00011897e+00, 1.00011253e+00, + 1.00010610e+00, 1.00009954e+00, 1.00009298e+00, 1.00008631e+00, + 1.00007963e+00, 1.00007284e+00, 1.00006604e+00, 1.00005913e+00, + 1.00005233e+00, 1.00004542e+00, 1.00003850e+00, 1.00003147e+00, + 1.00002456e+00, 1.00001752e+00, 1.00001049e+00, 1.00000346e+00, + 9.99996483e-01, 9.99989510e-01, 9.99982476e-01, 9.99975502e-01, + 9.99968529e-01, 9.99961555e-01, 9.99954641e-01, 9.99947727e-01, + 9.99940813e-01, 9.99933958e-01, 9.99927163e-01, 9.99920428e-01, + 9.99913692e-01, 9.99907076e-01, 9.99900460e-01, 9.99893904e-01, + 9.99887466e-01, 9.99881029e-01, 9.99874711e-01, 9.99868453e-01, + 9.99862254e-01, 9.99856174e-01, 9.99850154e-01, 9.99844253e-01, + 9.99838412e-01, 9.99832690e-01, 9.99827087e-01, 9.99821603e-01, + 9.99816179e-01, 9.99810934e-01, 9.99805748e-01, 9.99800682e-01, + 9.99795794e-01, 9.99791026e-01, 9.99786317e-01, 9.99781847e-01, + 9.99777436e-01, 9.99773204e-01, 9.99769092e-01, 9.99765158e-01, + 9.99761343e-01, 9.99757707e-01, 9.99754190e-01, 9.99750853e-01, + 9.99747694e-01, 9.99744654e-01, 9.99741852e-01, 9.99739170e-01, + 9.99736667e-01, 9.99734342e-01, 9.99732137e-01, 9.99730170e-01, + 9.99728382e-01, 9.99726772e-01, 9.99725342e-01, 9.99724090e-01, + 9.99723017e-01, 9.99722123e-01, 9.99721408e-01, 9.99720931e-01, + 9.99720633e-01, 9.99720514e-01, 9.99720573e-01, 9.99720812e-01, + 9.99721289e-01, 9.99721944e-01, 9.99722779e-01, 9.99723792e-01, + 9.99725044e-01, 9.99726474e-01, 9.99728084e-01, 9.99729872e-01, + 9.99731898e-01, 9.99734104e-01, 9.99736488e-01, 9.99739051e-01, + 9.99741793e-01, 9.99744713e-01, 9.99747872e-01, 9.99751151e-01, + 9.99754667e-01, 9.99758303e-01, 9.99762177e-01, 9.99766171e-01, + 9.99770403e-01, 9.99774754e-01, 9.99779284e-01, 9.99783993e-01, + 9.99788821e-01, 9.99793828e-01, 9.99799013e-01, 9.99804318e-01, + 9.99809742e-01, 9.99815404e-01, 9.99821126e-01, 9.99826968e-01, + 9.99832988e-01, 9.99839127e-01, 9.99845386e-01, 9.99851763e-01, + 9.99858260e-01, 9.99864876e-01, 9.99871552e-01, 9.99878347e-01, + 9.99885261e-01, 9.99892235e-01, 9.99899328e-01, 9.99906480e-01, + 9.99913692e-01, 9.99920964e-01, 9.99928296e-01, 9.99935687e-01, + 9.99943137e-01, 9.99950647e-01, 9.99958158e-01, 9.99965727e-01, + 9.99973297e-01, 9.99980927e-01, 9.99988556e-01, 9.99996185e-01, + 1.00000381e+00, 1.00001144e+00, 1.00001907e+00, 1.00002670e+00, + 1.00003433e+00, 1.00004184e+00, 1.00004935e+00, 1.00005686e+00, + 1.00006437e+00, 1.00007176e+00, 1.00007904e+00, 1.00008631e+00, + 1.00009358e+00, 1.00010073e+00, 1.00010777e+00, 1.00011480e+00, + 1.00012159e+00, 1.00012839e+00, 1.00013518e+00, 1.00014174e+00, + 1.00014830e+00, 1.00015461e+00, 1.00016093e+00, 1.00016701e+00, + 1.00017309e+00, 1.00017893e+00, 1.00018466e+00, 1.00019026e+00, + 1.00019574e+00, 1.00020099e+00, 1.00020623e+00, 1.00021124e+00, + 1.00021613e+00, 1.00022078e+00, 1.00022531e+00, 1.00022972e+00, + 1.00023389e+00, 1.00023794e+00, 1.00024176e+00, 1.00024545e+00, + 1.00024891e+00, 1.00025225e+00, 1.00025535e+00, 1.00025833e+00, + 1.00026107e+00, 1.00026357e+00, 1.00026596e+00, 1.00026822e+00, + 1.00027013e+00, 1.00027204e+00, 1.00027359e+00, 1.00027502e+00, + 1.00027621e+00, 1.00027728e+00, 1.00027812e+00, 1.00027883e+00, + 1.00027919e+00, 1.00027955e+00, 1.00027955e+00, 1.00027943e+00, + 1.00027919e+00, 1.00027859e+00, 1.00027800e+00, 1.00027704e+00, + 1.00027597e+00, 1.00027478e+00, 1.00027335e+00, 1.00027168e+00, + 1.00026989e+00, 1.00026786e+00, 1.00026572e+00, 1.00026345e+00, + 1.00026095e+00, 1.00025821e+00, 1.00025535e+00, 1.00025237e+00, + 1.00024927e+00, 1.00024593e+00, 1.00024235e+00, 1.00023878e+00, + 1.00023496e+00, 1.00023091e+00, 1.00022686e+00, 1.00022256e+00, + 1.00021827e+00, 1.00021374e+00, 1.00020909e+00, 1.00020421e+00, + 1.00019932e+00, 1.00019431e+00, 1.00018907e+00, 1.00018382e+00, + 1.00017846e+00, 1.00017297e+00, 1.00016737e+00, 1.00016165e+00, + 1.00015581e+00, 1.00014985e+00, 1.00014389e+00, 1.00013781e+00, + 1.00013161e+00, 1.00012529e+00, 1.00011897e+00, 1.00011253e+00, + 1.00010610e+00, 1.00009954e+00, 1.00009298e+00, 1.00008631e+00, + 1.00007963e+00, 1.00007284e+00, 1.00006604e+00, 1.00005913e+00, + 1.00005233e+00, 1.00004542e+00, 1.00003850e+00, 1.00003147e+00, + 1.00002456e+00, 1.00001752e+00, 1.00001049e+00, 1.00000346e+00, + 9.99996483e-01, 9.99989510e-01, 9.99982476e-01, 9.99975502e-01, + 9.99968529e-01, 9.99961555e-01, 9.99954641e-01, 9.99947727e-01, + 9.99940813e-01, 9.99933958e-01, 9.99927163e-01, 9.99920428e-01, + 9.99913692e-01, 9.99907076e-01, 9.99900460e-01, 9.99893904e-01, + 9.99887466e-01, 9.99881029e-01, 9.99874711e-01, 9.99868453e-01, + 9.99862254e-01, 9.99856174e-01, 9.99850154e-01, 9.99844253e-01, + 9.99838412e-01, 9.99832690e-01, 9.99827087e-01, 9.99821603e-01, + 9.99816179e-01, 9.99810934e-01, 9.99805748e-01, 9.99800682e-01, + 9.99795794e-01, 9.99791026e-01, 9.99786317e-01, 9.99781847e-01, + 9.99777436e-01, 9.99773204e-01, 9.99769092e-01, 9.99765158e-01, + 9.99761343e-01, 9.99757707e-01, 9.99754190e-01, 9.99750853e-01, + 9.99747694e-01, 9.99744654e-01, 9.99741852e-01, 9.99739170e-01, + 9.99736667e-01, 9.99734342e-01, 9.99732137e-01, 9.99730170e-01, + 9.99728382e-01, 9.99726772e-01, 9.99725342e-01, 9.99724090e-01, + 9.99723017e-01, 9.99722123e-01, 9.99721408e-01, 9.99720931e-01, + 9.99720633e-01, 9.99720514e-01, 9.99720573e-01, 9.99720812e-01, + 9.99721289e-01, 9.99721944e-01, 9.99722779e-01, 9.99723792e-01, + 9.99725044e-01, 9.99726474e-01, 9.99728084e-01, 9.99729872e-01, + 9.99731898e-01, 9.99734104e-01, 9.99736488e-01, 9.99739051e-01, + 9.99741793e-01, 9.99744713e-01, 9.99747872e-01, 9.99751151e-01, + 9.99754667e-01, 9.99758303e-01, 9.99762177e-01, 9.99766171e-01, + 9.99770403e-01, 9.99774754e-01, 9.99779284e-01, 9.99783993e-01, + 9.99788821e-01, 9.99793828e-01, 9.99799013e-01, 9.99804318e-01, + 9.99809742e-01, 9.99815404e-01, 9.99821126e-01, 9.99826968e-01, + 9.99832988e-01, 9.99839127e-01, 9.99845386e-01, 9.99851763e-01, + 9.99858260e-01, 9.99864876e-01, 9.99871552e-01, 9.99878347e-01, + 9.99885261e-01, 9.99892235e-01, 9.99899328e-01, 9.99906480e-01, + 9.99913692e-01, 9.99920964e-01, 9.99928296e-01, 9.99935687e-01, + 9.99943137e-01, 9.99950647e-01, 9.99958158e-01, 9.99965727e-01, + 9.99973297e-01, 9.99980927e-01, 9.99988556e-01, 9.99996185e-01, + 1.00000381e+00, 1.00001132e+00, 1.00001884e+00, 1.00002635e+00, + 1.00003362e+00, 1.00004077e+00, 1.00004780e+00, 1.00005460e+00, + 1.00006104e+00, 1.00006711e+00, 1.00007272e+00, 1.00007772e+00, + 1.00008214e+00, 1.00008571e+00, 1.00008833e+00, 1.00008976e+00, + 1.00008988e+00, 1.00008845e+00, 1.00008512e+00, 1.00007975e+00, + 1.00007200e+00, 1.00006139e+00, 1.00004768e+00, 1.00003028e+00, + 1.00000894e+00, 9.99982893e-01, 9.99951661e-01, 9.99914646e-01, + 9.99871135e-01, 9.99820411e-01, 9.99761701e-01, 9.99694109e-01, + 9.99616742e-01, 9.99528646e-01, 9.99428689e-01, 9.99315858e-01, + 9.99188840e-01, 9.99046445e-01, 9.98887360e-01, 9.98710036e-01, + 9.98513043e-01, 9.98294711e-01, 9.98053491e-01, 9.97787535e-01, + 9.97494996e-01, 9.97173846e-01, 9.96822178e-01, 9.96437728e-01, + 9.96018291e-01, 9.95561540e-01, 9.95064974e-01, 9.94526088e-01, + 9.93942142e-01, 9.93310452e-01, 9.92628038e-01, 9.91891921e-01, + 9.91099000e-01, 9.90245998e-01, 9.89329517e-01, 9.88346159e-01, + 9.87292290e-01, 9.86164153e-01, 9.84957933e-01, 9.83669639e-01, + 9.82295156e-01, 9.80830312e-01, 9.79270697e-01, 9.77612019e-01, + 9.75849628e-01, 9.73978817e-01, 9.71994996e-01, 9.69893157e-01, + 9.67668533e-01, 9.65315938e-01, 9.62830484e-01, 9.60206985e-01, + 9.57440197e-01, 9.54525113e-01, 9.51456368e-01, 9.48228836e-01, + 9.44837391e-01, 9.41276729e-01, 9.37541902e-01, 9.33627844e-01, + 9.29529607e-01, 9.25242424e-01, 9.20761466e-01, 9.16082382e-01, + 9.11200643e-01, 9.06112134e-01, 9.00812864e-01, 8.95299196e-01, + 8.89567554e-01, 8.83614719e-01, 8.77437830e-01, 8.71034324e-01, + 8.64401877e-01, 8.57538521e-01, 8.50442827e-01, 8.43113542e-01, + 8.35549891e-01, 8.27751517e-01, 8.19718421e-01, 8.11451137e-01, + 8.02950621e-01, 7.94218183e-01, 7.85255671e-01, 7.76065350e-01, + 7.66650081e-01, 7.57013023e-01, 7.47157931e-01, 7.37088978e-01, + 7.26810873e-01, 7.16328681e-01, 7.05648124e-01, 6.94775164e-01, + 6.83716357e-01, 6.72478795e-01, 6.61069810e-01, 6.49497330e-01, + 6.37769580e-01, 6.25895321e-01, 6.13883674e-01, 6.01744056e-01, + 5.89486361e-01, 5.77120781e-01, 5.64657867e-01, 5.52108407e-01, + 5.39483547e-01, 5.26794672e-01, 5.14053404e-01, 5.01271665e-01, + 4.88461435e-01, 4.75634992e-01, 4.62804615e-01, 4.49982822e-01, + 4.37182158e-01, 4.24415171e-01, 4.11694527e-01, 3.99032772e-01, + 3.86442453e-01, 3.73936087e-01, 3.61525953e-01, 3.49224269e-01, + 3.37043047e-01, 3.24994087e-01, 3.13088894e-01, 3.01338732e-01, + 2.89754450e-01, 2.78346658e-01, 2.67125458e-01, 2.56100595e-01, + 2.45281324e-01, 2.34676436e-01, 2.24294156e-01, 2.14142203e-01, + 2.04227716e-01, 1.94557235e-01, 1.85136691e-01, 1.75971389e-01, + 1.67065978e-01, 1.58424467e-01, 1.50050193e-01, 1.41945809e-01, + 1.34113312e-01, 1.26554012e-01, 1.19268581e-01, 1.12257004e-01, + 1.05518632e-01, 9.90521908e-02, 9.28557739e-02, 8.69268849e-02, + 8.12624842e-02, 7.58589506e-02, 7.07121640e-02, 6.58175275e-02, + 6.11699894e-02, 5.67640625e-02, 5.25939018e-02, 4.86532971e-02, + 4.49357443e-02, 4.14344519e-02, 3.81424055e-02, 3.50523964e-02, + 3.21570449e-02, 2.94488575e-02, 2.69202497e-02, 2.45635863e-02, + 2.23712083e-02, 2.03354694e-02, 1.84487645e-02, 1.67035554e-02, + 1.50924018e-02, 1.36079816e-02, 1.22431125e-02, 1.09907771e-02, + 9.84413363e-03, 8.79654102e-03, 7.84156192e-03, 6.97298534e-03, + 6.18482940e-03, 5.47135156e-03, 4.82705561e-03, 4.24669450e-03, + 3.72527563e-03, 3.25805834e-03, 2.84055714e-03, 2.46853800e-03, + 2.13801605e-03, 1.84525200e-03, 1.58674677e-03, 1.35923503e-03, + 1.15967961e-03, 9.85263032e-04, 8.33379803e-04, 7.01628160e-04, + 5.87800692e-04, 4.89875500e-04, 4.06006613e-04, 3.34514218e-04, + 2.73875427e-04, 2.22714254e-04, 1.79792376e-04, 1.43999539e-04, + 1.14344395e-04, 8.99455481e-05, 7.00227974e-05, 5.38887325e-05, + 4.09407221e-05, 3.06531692e-05, 2.25702297e-05, 1.62988836e-05, + 1.15024377e-05, 7.89443584e-06, 5.23298331e-06, 3.31548563e-06, + 1.97379018e-06, 1.06971811e-06, 4.90905393e-07, 1.46209757e-07, +}; + +#endif /* LC3_PLUS_HR */ + +#undef __LC3_MDCT_WIN_LEN + +const float *lc3_mdct_win[LC3_NUM_DT][LC3_NUM_SRATE] = { + + [LC3_DT_2M5] = { + LC3_IF_PLUS( mdct_win_2m5_8k , NULL ), + LC3_IF_PLUS( mdct_win_2m5_16k, NULL ), + LC3_IF_PLUS( mdct_win_2m5_24k, NULL ), + LC3_IF_PLUS( mdct_win_2m5_32k, NULL ), + LC3_IF_PLUS( mdct_win_2m5_48k, NULL ), + LC3_IF_PLUS( LC3_IF_PLUS_HR( mdct_win_2m5_48k_hr, NULL ), NULL ), + LC3_IF_PLUS( LC3_IF_PLUS_HR( mdct_win_2m5_96k_hr, NULL ), NULL ) }, + + [LC3_DT_5M ] = { + LC3_IF_PLUS( mdct_win_5m_8k , NULL ), + LC3_IF_PLUS( mdct_win_5m_16k, NULL ), + LC3_IF_PLUS( mdct_win_5m_24k, NULL ), + LC3_IF_PLUS( mdct_win_5m_32k, NULL ), + LC3_IF_PLUS( mdct_win_5m_48k, NULL ), + LC3_IF_PLUS( LC3_IF_PLUS_HR( mdct_win_5m_48k_hr, NULL ), NULL ), + LC3_IF_PLUS( LC3_IF_PLUS_HR( mdct_win_5m_96k_hr, NULL ), NULL ) }, + + [LC3_DT_7M5] = { + mdct_win_7m5_8k , mdct_win_7m5_16k, mdct_win_7m5_24k, + mdct_win_7m5_32k, mdct_win_7m5_48k }, + + [LC3_DT_10M] = { + mdct_win_10m_8k , mdct_win_10m_16k, mdct_win_10m_24k, + mdct_win_10m_32k, mdct_win_10m_48k, + LC3_IF_PLUS_HR( mdct_win_10m_48k_hr, NULL), + LC3_IF_PLUS_HR( mdct_win_10m_96k_hr, NULL), }, +}; + + +/** + * Bands limits + */ + +#if LC3_PLUS + +static const int band_lim_2m5_8k[] = { + 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, + 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, + 20 +}; + +static const int band_lim_2m5_16k[] = { + 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, + 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, + 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, + 30, 32, 34, 36, 38, 40 +}; + +static const int band_lim_2m5_24k[] = { + 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, + 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, + 20, 21, 22, 23, 24, 25, 26, 28, 30, 32, + 34, 36, 38, 40, 42, 44, 47, 50, 53, 56, + 60 +}; + +static const int band_lim_2m5_32k[] = { + 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, + 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, + 20, 21, 22, 23, 24, 26, 28, 30, 32, 34, + 36, 38, 40, 43, 46, 49, 52, 55, 59, 63, + 67, 71, 75, 80 +}; + +static const int band_lim_2m5_48k[] = { + 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, + 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, + 20, 21, 23, 25, 27, 29, 31, 33, 35, 37, + 40, 43, 46, 49, 52, 56, 60, 64, 68, 72, + 77, 82, 87, 93, 100 +}; + +#if LC3_PLUS_HR + +static const int band_lim_2m5_48k_hr[] = { + 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, + 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, + 21, 23, 25, 27, 29, 31, 33, 35, 37, 40, + 43, 46, 49, 53, 57, 61, 65, 69, 74, 79, + 85, 91, 97, 104, 112, 120 +}; + +static const int band_lim_2m5_96k_hr[] = { + 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, + 10, 11, 12, 13, 14, 15, 16, 18, 20, 22, + 24, 26, 28, 30, 32, 35, 38, 41, 45, 49, + 53, 57, 62, 67, 73, 79, 85, 92, 100, 108, + 117, 127, 137, 149, 161, 174, 189, 204, 221, 240 +}; + +#endif /* LC3_PLUS_HR */ + +static const int band_lim_5m_8k[] = { + 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, + 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, + 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, + 30, 31, 32, 33, 34, 35, 36, 37, 38, 40 +}; + +static const int band_lim_5m_16k[] = { + 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, + 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, + 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, + 30, 32, 34, 36, 38, 40, 42, 44, 46, 48, + 50, 52, 54, 57, 60, 63, 66, 69, 72, 76, + 80 +}; + +static const int band_lim_5m_24k[] = { + 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, + 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, + 20, 21, 22, 23, 24, 26, 28, 30, 32, 34, + 36, 38, 40, 42, 44, 47, 50, 53, 56, 59, + 62, 65, 69, 73, 77, 81, 86, 91, 96, 101, + 107, 113, 120 +}; + +static const int band_lim_5m_32k[] = { + 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, + 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, + 20, 21, 22, 24, 26, 28, 30, 32, 34, 36, + 38, 40, 42, 45, 48, 51, 54, 57, 61, 65, + 69, 73, 78, 83, 88, 93, 99, 105, 112, 119, + 126, 134, 142, 151, 160 +}; + +static const int band_lim_5m_48k[] = { + 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, + 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, + 20, 21, 23, 25, 27, 29, 31, 33, 35, 37, + 40, 43, 46, 49, 52, 55, 59, 63, 67, 72, + 77, 82, 87, 93, 99, 105, 112, 120, 128, 136, + 145, 155, 165, 176, 187, 200 +}; + +#if LC3_PLUS_HR + +static const int band_lim_5m_48k_hr[] = { + 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, + 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, + 21, 23, 25, 27, 29, 31, 33, 35, 38, 41, + 44, 47, 50, 54, 58, 62, 66, 71, 76, 81, + 87, 93, 100, 107, 114, 122, 131, 140, 149, 160, + 171, 183, 196, 209, 224, 240 +}; + +static const int band_lim_5m_96k_hr[] = { + 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, + 10, 11, 12, 13, 14, 15, 16, 17, 19, 21, + 23, 25, 27, 29, 31, 34, 37, 40, 44, 48, + 52, 56, 61, 66, 71, 77, 83, 90, 98, 106, + 115, 124, 135, 146, 158, 171, 185, 200, 217, 235, + 254, 275, 298, 323, 349, 378, 409, 443, 480 +}; + +#endif /* LC3_PLUS_HR */ +#endif /* LC3_PLUS */ + +static const int band_lim_7m5_8k[] = { + 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, + 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, + 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, + 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, + 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, + 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, + 60 +}; + +static const int band_lim_7m5_16k[] = { + 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, + 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, + 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, + 30, 31, 32, 33, 34, 36, 38, 40, 42, 44, + 46, 48, 50, 52, 54, 56, 58, 60, 62, 65, + 68, 71, 74, 77, 80, 83, 86, 90, 94, 98, + 102, 106, 110, 115, 120 +}; + +static const int band_lim_7m5_24k[] = { + 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, + 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, + 20, 21, 22, 23, 24, 25, 26, 27, 29, 31, + 33, 35, 37, 39, 41, 43, 45, 47, 49, 52, + 55, 58, 61, 64, 67, 70, 74, 78, 82, 86, + 90, 95, 100, 105, 110, 115, 121, 127, 134, 141, + 148, 155, 163, 171, 180 +}; + +static const int band_lim_7m5_32k[] = { + 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, + 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, + 20, 21, 22, 23, 24, 26, 28, 30, 32, 34, + 36, 38, 40, 42, 45, 48, 51, 54, 57, 60, + 63, 67, 71, 75, 79, 84, 89, 94, 99, 105, + 111, 117, 124, 131, 138, 146, 154, 163, 172, 182, + 192, 203, 215, 227, 240 +}; + +static const int band_lim_7m5_48k[] = { + 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, + 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, + 20, 21, 22, 24, 26, 28, 30, 32, 34, 36, + 38, 40, 43, 46, 49, 52, 55, 59, 63, 67, + 71, 75, 80, 85, 90, 96, 102, 108, 115, 122, + 129, 137, 146, 155, 165, 175, 186, 197, 209, 222, + 236, 251, 266, 283, 300 +}; + +static const int band_lim_10m_8k[] = { + 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, + 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, + 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, + 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, + 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, + 51, 53, 55, 57, 59, 61, 63, 65, 67, 69, + 71, 73, 75, 77, 80 +}; + +static const int band_lim_10m_16k[] = { + 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, + 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, + 20, 21, 22, 23, 24, 25, 26, 27, 28, 30, + 32, 34, 36, 38, 40, 42, 44, 46, 48, 50, + 52, 55, 58, 61, 64, 67, 70, 73, 76, 80, + 84, 88, 92, 96, 101, 106, 111, 116, 121, 127, + 133, 139, 146, 153, 160 +}; + +static const int band_lim_10m_24k[] = { + 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, + 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, + 20, 21, 22, 23, 25, 27, 29, 31, 33, 35, + 37, 39, 41, 43, 46, 49, 52, 55, 58, 61, + 64, 68, 72, 76, 80, 85, 90, 95, 100, 106, + 112, 118, 125, 132, 139, 147, 155, 164, 173, 183, + 193, 204, 215, 227, 240 +}; + +static const int band_lim_10m_32k[] = { + 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, + 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, + 20, 22, 24, 26, 28, 30, 32, 34, 36, 38, + 41, 44, 47, 50, 53, 56, 60, 64, 68, 72, + 76, 81, 86, 91, 97, 103, 109, 116, 123, 131, + 139, 148, 157, 166, 176, 187, 199, 211, 224, 238, + 252, 268, 284, 302, 320 +}; + +static const int band_lim_10m_48k[] = { + 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, + 10, 11, 12, 13, 14, 15, 16, 17, 18, 20, + 22, 24, 26, 28, 30, 32, 34, 36, 39, 42, + 45, 48, 51, 55, 59, 63, 67, 71, 76, 81, + 86, 92, 98, 105, 112, 119, 127, 135, 144, 154, + 164, 175, 186, 198, 211, 225, 240, 256, 273, 291, + 310, 330, 352, 375, 400 +}; + +#if LC3_PLUS_HR + +static const int band_lim_10m_48k_hr[] = { + 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, + 10, 11, 12, 13, 14, 15, 16, 17, 19, 21, + 23, 25, 27, 29, 31, 33, 36, 39, 42, 45, + 48, 51, 55, 59, 63, 67, 72, 77, 83, 89, + 95, 101, 108, 116, 124, 133, 142, 152, 163, 174, + 187, 200, 214, 229, 244, 262, 280, 299, 320, 343, + 367, 392, 419, 449, 480 +}; + +static const int band_lim_10m_96k_hr[] = { + 0, 1, 2, 3, 4, 5, 6, 7, 8 , 9, + 10, 11, 12, 14, 16, 18, 20, 22, 24, 26, + 28, 30, 33, 36, 39, 42, 46, 50, 54, 59, + 64, 69, 75, 82, 89, 96, 104, 113, 122, 132, + 143, 155, 168, 181, 196, 213, 230, 249, 270, 292, + 316, 342, 371, 401, 434, 470, 509, 551, 596, 646, + 699, 757, 819, 887, 960 +}; + +#endif /* LC3_PLUS_HR */ + +const int *lc3_band_lim[LC3_NUM_DT][LC3_NUM_SRATE] = { + + [LC3_DT_2M5] = { + LC3_IF_PLUS( band_lim_2m5_8k , NULL ), + LC3_IF_PLUS( band_lim_2m5_16k, NULL ), + LC3_IF_PLUS( band_lim_2m5_24k, NULL ), + LC3_IF_PLUS( band_lim_2m5_32k, NULL ), + LC3_IF_PLUS( band_lim_2m5_48k, NULL ), + LC3_IF_PLUS( LC3_IF_PLUS_HR( band_lim_2m5_48k_hr, NULL ), NULL ), + LC3_IF_PLUS( LC3_IF_PLUS_HR( band_lim_2m5_96k_hr, NULL ), NULL ) }, + + [LC3_DT_5M] = { + LC3_IF_PLUS( band_lim_5m_8k , NULL ), + LC3_IF_PLUS( band_lim_5m_16k, NULL ), + LC3_IF_PLUS( band_lim_5m_24k, NULL ), + LC3_IF_PLUS( band_lim_5m_32k, NULL ), + LC3_IF_PLUS( band_lim_5m_48k, NULL ), + LC3_IF_PLUS( LC3_IF_PLUS_HR( band_lim_5m_48k_hr, NULL ), NULL ), + LC3_IF_PLUS( LC3_IF_PLUS_HR( band_lim_5m_96k_hr, NULL ), NULL ) }, + + [LC3_DT_7M5] = { + band_lim_7m5_8k , band_lim_7m5_16k, band_lim_7m5_24k, + band_lim_7m5_32k, band_lim_7m5_48k }, + + [LC3_DT_10M] = { + band_lim_10m_8k , band_lim_10m_16k, band_lim_10m_24k, + band_lim_10m_32k, band_lim_10m_48k, + LC3_IF_PLUS_HR( band_lim_10m_48k_hr, NULL ), + LC3_IF_PLUS_HR( band_lim_10m_96k_hr, NULL ) }, +}; + +#define __LC3_NUM_BANDS(_lim) \ + ( sizeof(_lim) / sizeof(*(_lim)) - 1 ) + +const int lc3_num_bands[LC3_NUM_DT][LC3_NUM_SRATE] = { + + [LC3_DT_2M5] = { + LC3_IF_PLUS( __LC3_NUM_BANDS( band_lim_2m5_8k ), 0 ), + LC3_IF_PLUS( __LC3_NUM_BANDS( band_lim_2m5_16k ), 0 ), + LC3_IF_PLUS( __LC3_NUM_BANDS( band_lim_2m5_24k ), 0 ), + LC3_IF_PLUS( __LC3_NUM_BANDS( band_lim_2m5_32k ), 0 ), + LC3_IF_PLUS( __LC3_NUM_BANDS( band_lim_2m5_48k ), 0 ), + LC3_IF_PLUS( LC3_IF_PLUS_HR( + __LC3_NUM_BANDS( band_lim_2m5_48k_hr ), 0 ), 0 ), + LC3_IF_PLUS( LC3_IF_PLUS_HR( + __LC3_NUM_BANDS( band_lim_2m5_96k_hr ), 0 ), 0 ) }, + + [LC3_DT_5M] = { + LC3_IF_PLUS( __LC3_NUM_BANDS( band_lim_5m_8k ), 0 ), + LC3_IF_PLUS( __LC3_NUM_BANDS( band_lim_5m_16k ), 0 ), + LC3_IF_PLUS( __LC3_NUM_BANDS( band_lim_5m_24k ), 0 ), + LC3_IF_PLUS( __LC3_NUM_BANDS( band_lim_5m_32k ), 0 ), + LC3_IF_PLUS( __LC3_NUM_BANDS( band_lim_5m_48k ), 0 ), + LC3_IF_PLUS( LC3_IF_PLUS_HR( + __LC3_NUM_BANDS( band_lim_5m_48k_hr ), 0 ), 0 ), + LC3_IF_PLUS( LC3_IF_PLUS_HR( + __LC3_NUM_BANDS( band_lim_5m_96k_hr ), 0 ), 0 ) }, + + [LC3_DT_7M5] = { + __LC3_NUM_BANDS( band_lim_7m5_8k ), + __LC3_NUM_BANDS( band_lim_7m5_16k ), + __LC3_NUM_BANDS( band_lim_7m5_24k ), + __LC3_NUM_BANDS( band_lim_7m5_32k ), + __LC3_NUM_BANDS( band_lim_7m5_48k ) }, + + [LC3_DT_10M] = { + __LC3_NUM_BANDS( band_lim_10m_8k ), + __LC3_NUM_BANDS( band_lim_10m_16k ), + __LC3_NUM_BANDS( band_lim_10m_24k ), + __LC3_NUM_BANDS( band_lim_10m_32k ), + __LC3_NUM_BANDS( band_lim_10m_48k ), + LC3_IF_PLUS_HR( __LC3_NUM_BANDS( band_lim_10m_48k_hr ), 0 ), + LC3_IF_PLUS_HR( __LC3_NUM_BANDS( band_lim_10m_96k_hr ), 0 ) }, +}; + +#undef __LC3_NUM_BANDS + + +/** + * SNS Quantization + */ + +const float lc3_sns_lfcb[32][8] = { + + { 2.26283366e+00, 8.13311269e-01, -5.30193495e-01, -1.35664836e+00, + -1.59952177e+00, -1.44098768e+00, -1.14381648e+00, -7.55203768e-01 }, + + { 2.94516479e+00, 2.41143318e+00, 9.60455106e-01, -4.43226488e-01, + -1.22913612e+00, -1.55590039e+00, -1.49688656e+00, -1.11689987e+00 }, + + { -2.18610707e+00, -1.97152136e+00, -1.78718620e+00, -1.91865896e+00, + -1.79399122e+00, -1.35738404e+00, -7.05444279e-01, -4.78172945e-02 }, + + { 6.93688237e-01, 9.55609857e-01, 5.75230787e-01, -1.14603419e-01, + -6.46050637e-01, -9.52351370e-01, -1.07405247e+00, -7.58087707e-01 }, + + { -1.29752132e+00, -7.40369057e-01, -3.45372484e-01, -3.13285696e-01, + -4.02977243e-01, -3.72020853e-01, -7.83414177e-02, 9.70441304e-02 }, + + { 9.14652038e-01, 1.74293043e+00, 1.90906627e+00, 1.54408484e+00, + 1.09344961e+00, 6.47479550e-01, 3.61790752e-02, -2.97092807e-01 }, + + { -2.51428813e+00, -2.89175271e+00, -2.00450667e+00, -7.50912274e-01, + 4.41202105e-01, 1.20190988e+00, 1.32742857e+00, 1.22049081e+00 }, + + { -9.22188405e-01, 6.32495141e-01, 1.08736431e+00, 6.08628625e-01, + 1.31174568e-01, -2.96149158e-01, -2.07013517e-01, 1.34924917e-01 }, + + { 7.90322288e-01, 6.28401262e-01, 3.93117924e-01, 4.80007711e-01, + 4.47815138e-01, 2.09734215e-01, 6.56691996e-03, -8.61242342e-02 }, + + { 1.44775580e+00, 2.72399952e+00, 2.31083269e+00, 9.35051270e-01, + -2.74743911e-01, -9.02077697e-01, -9.40681512e-01, -6.33697039e-01 }, + + { 7.93354526e-01, 1.43931186e-02, -5.67834845e-01, -6.54760468e-01, + -4.79458998e-01, -1.73894662e-01, 6.80162706e-02, 2.95125948e-01 }, + + { 2.72425347e+00, 2.95947572e+00, 1.84953559e+00, 5.63284922e-01, + 1.39917088e-01, 3.59641093e-01, 6.89461355e-01, 6.39790177e-01 }, + + { -5.30830198e-01, -2.12690683e-01, 5.76613628e-03, 4.24871484e-01, + 4.73128952e-01, 8.58894199e-01, 1.19111161e+00, 9.96189670e-01 }, + + { 1.68728411e+00, 2.43614509e+00, 2.33019429e+00, 1.77983778e+00, + 1.44411295e+00, 1.51995177e+00, 1.47199394e+00, 9.77682474e-01 }, + + { -2.95183273e+00, -1.59393497e+00, -1.09918773e-01, 3.88609073e-01, + 5.12932650e-01, 6.28112597e-01, 8.22621796e-01, 8.75891425e-01 }, + + { 1.01878343e-01, 5.89857324e-01, 6.19047647e-01, 1.26731314e+00, + 2.41961048e+00, 2.25174253e+00, 5.26537031e-01, -3.96591513e-01 }, + + { 2.68254575e+00, 1.32738011e+00, 1.30185274e-01, -3.38533089e-01, + -3.68219236e-01, -1.91689947e-01, -1.54782377e-01, -2.34207178e-01 }, + + { 4.82697924e+00, 3.11947804e+00, 1.39513671e+00, 2.50295316e-01, + -3.93613839e-01, -6.43458173e-01, -6.42570737e-01, -7.23193223e-01 }, + + { 8.78419936e-02, -5.69586840e-01, -1.14506016e+00, -1.66968488e+00, + -1.84534418e+00, -1.56468027e+00, -1.11746759e+00, -5.33981663e-01 }, + + { 1.39102308e+00, 1.98146479e+00, 1.11265796e+00, -2.20107509e-01, + -7.74965612e-01, -5.94063874e-01, 1.36937681e-01, 8.18242891e-01 }, + + { 3.84585894e-01, -1.60588786e-01, -5.39366810e-01, -5.29309079e-01, + 1.90433547e-01, 2.56062918e+00, 2.81896398e+00, 6.56670876e-01 }, + + { 1.93227399e+00, 3.01030180e+00, 3.06543894e+00, 2.50110161e+00, + 1.93089593e+00, 5.72153811e-01, -8.11741794e-01, -1.17641811e+00 }, + + { 1.75080463e-01, -7.50522832e-01, -1.03943893e+00, -1.13577509e+00, + -1.04197904e+00, -1.52060099e-02, 2.07048392e+00, 3.42948918e+00 }, + + { -1.18817020e+00, 3.66792874e-01, 1.30957830e+00, 1.68330687e+00, + 1.25100924e+00, 9.42375752e-01, 8.26250483e-01, 4.39952741e-01 }, + + { 2.53322203e+00, 2.11274643e+00, 1.26288412e+00, 7.61513512e-01, + 5.22117938e-01, 1.18680070e-01, -4.52346828e-01, -7.00352426e-01 }, + + { 3.99889837e+00, 4.07901751e+00, 2.82285661e+00, 1.72607213e+00, + 6.47144377e-01, -3.31148521e-01, -8.84042571e-01, -1.12697341e+00 }, + + { 5.07902593e-01, 1.58838450e+00, 1.72899024e+00, 1.00692230e+00, + 3.77121232e-01, 4.76370767e-01, 1.08754740e+00, 1.08756266e+00 }, + + { 3.16856825e+00, 3.25853458e+00, 2.42230591e+00, 1.79446078e+00, + 1.52177911e+00, 1.17196707e+00, 4.89394597e-01, -6.22795716e-02 }, + + { 1.89414767e+00, 1.25108695e+00, 5.90451211e-01, 6.08358583e-01, + 8.78171010e-01, 1.11912511e+00, 1.01857662e+00, 6.20453891e-01 }, + + { 9.48880605e-01, 2.13239439e+00, 2.72345350e+00, 2.76986077e+00, + 2.54286973e+00, 2.02046264e+00, 8.30045859e-01, -2.75569174e-02 }, + + { -1.88026757e+00, -1.26431073e+00, 3.11424977e-01, 1.83670210e+00, + 2.25634192e+00, 2.04818998e+00, 2.19526837e+00, 2.02659614e+00 }, + + { 2.46375746e-01, 9.55621773e-01, 1.52046777e+00, 1.97647400e+00, + 1.94043867e+00, 2.23375847e+00, 1.98835978e+00, 1.27232673e+00 }, + +}; + +const float lc3_sns_hfcb[32][8] = { + + { 2.32028419e-01, -1.00890271e+00, -2.14223503e+00, -2.37533814e+00, + -2.23041933e+00, -2.17595881e+00, -2.29065914e+00, -2.53286398e+00 }, + + { -1.29503937e+00, -1.79929965e+00, -1.88703148e+00, -1.80991660e+00, + -1.76340038e+00, -1.83418428e+00, -1.80480981e+00, -1.73679545e+00 }, + + { 1.39285716e-01, -2.58185126e-01, -6.50804573e-01, -1.06815732e+00, + -1.61928742e+00, -2.18762566e+00, -2.63757587e+00, -2.97897750e+00 }, + + { -3.16513102e-01, -4.77747657e-01, -5.51162076e-01, -4.84788283e-01, + -2.38388394e-01, -1.43024507e-01, 6.83186674e-02, 8.83061717e-02 }, + + { 8.79518405e-01, 2.98340096e-01, -9.15386396e-01, -2.20645975e+00, + -2.74142181e+00, -2.86139074e+00, -2.88841597e+00, -2.95182608e+00 }, + + { -2.96701922e-01, -9.75004919e-01, -1.35857500e+00, -9.83721106e-01, + -6.52956939e-01, -9.89986993e-01, -1.61467225e+00, -2.40712302e+00 }, + + { 3.40981100e-01, 2.68899789e-01, 5.63335685e-02, 4.99114047e-02, + -9.54130727e-02, -7.60166146e-01, -2.32758120e+00, -3.77155485e+00 }, + + { -1.41229759e+00, -1.48522119e+00, -1.18603580e+00, -6.25001634e-01, + 1.53902497e-01, 5.76386498e-01, 7.95092604e-01, 5.96564632e-01 }, + + { -2.28839512e-01, -3.33719070e-01, -8.09321359e-01, -1.63587877e+00, + -1.88486397e+00, -1.64496691e+00, -1.40515778e+00, -1.46666471e+00 }, + + { -1.07148629e+00, -1.41767015e+00, -1.54891762e+00, -1.45296062e+00, + -1.03182970e+00, -6.90642640e-01, -4.28843805e-01, -4.94960215e-01 }, + + { -5.90988511e-01, -7.11737759e-02, 3.45719523e-01, 3.00549461e-01, + -1.11865218e+00, -2.44089151e+00, -2.22854732e+00, -1.89509228e+00 }, + + { -8.48434099e-01, -5.83226811e-01, 9.00423688e-02, 8.45025008e-01, + 1.06572385e+00, 7.37582999e-01, 2.56590452e-01, -4.91963360e-01 }, + + { 1.14069146e+00, 9.64016892e-01, 3.81461206e-01, -4.82849341e-01, + -1.81632721e+00, -2.80279513e+00, -3.23385725e+00, -3.45908714e+00 }, + + { -3.76283238e-01, 4.25675462e-02, 5.16547697e-01, 2.51716882e-01, + -2.16179968e-01, -5.34074091e-01, -6.40786096e-01, -8.69745032e-01 }, + + { 6.65004121e-01, 1.09790765e+00, 1.38342667e+00, 1.34327359e+00, + 8.22978837e-01, 2.15876799e-01, -4.04925753e-01, -1.07025606e+00 }, + + { -8.26265954e-01, -6.71181233e-01, -2.28495593e-01, 5.18980853e-01, + 1.36721896e+00, 2.18023038e+00, 2.53596093e+00, 2.20121099e+00 }, + + { 1.41008327e+00, 7.54441908e-01, -1.30550585e+00, -1.87133711e+00, + -1.24008685e+00, -1.26712925e+00, -2.03670813e+00, -2.89685162e+00 }, + + { 3.61386818e-01, -2.19991705e-02, -5.79368834e-01, -8.79427961e-01, + -8.50685023e-01, -7.79397050e-01, -7.32182927e-01, -8.88348515e-01 }, + + { 4.37469239e-01, 3.05440420e-01, -7.38786566e-03, -4.95649855e-01, + -8.06651271e-01, -1.22431892e+00, -1.70157770e+00, -2.24491914e+00 }, + + { 6.48100319e-01, 6.82299134e-01, 2.53247464e-01, 7.35842144e-02, + 3.14216709e-01, 2.34729881e-01, 1.44600134e-01, -6.82120179e-02 }, + + { 1.11919833e+00, 1.23465533e+00, 5.89170238e-01, -1.37192460e+00, + -2.37095707e+00, -2.00779783e+00, -1.66688540e+00, -1.92631846e+00 }, + + { 1.41847497e-01, -1.10660071e-01, -2.82824593e-01, -6.59813475e-03, + 2.85929280e-01, 4.60445530e-02, -6.02596416e-01, -2.26568729e+00 }, + + { 5.04046955e-01, 8.26982163e-01, 1.11981236e+00, 1.17914044e+00, + 1.07987429e+00, 6.97536239e-01, -9.12548817e-01, -3.57684747e+00 }, + + { -5.01076050e-01, -3.25678006e-01, 2.80798195e-02, 2.62054555e-01, + 3.60590806e-01, 6.35623722e-01, 9.59012467e-01, 1.30745157e+00 }, + + { 3.74970983e+00, 1.52342612e+00, -4.57715662e-01, -7.98711008e-01, + -3.86819329e-01, -3.75901062e-01, -6.57836900e-01, -1.28163964e+00 }, + + { -1.15258991e+00, -1.10800886e+00, -5.62615117e-01, -2.20562124e-01, + -3.49842880e-01, -7.53432770e-01, -9.88596593e-01, -1.28790472e+00 }, + + { 1.02827246e+00, 1.09770519e+00, 7.68645546e-01, 2.06081978e-01, + -3.42805735e-01, -7.54939405e-01, -1.04196178e+00, -1.50335653e+00 }, + + { 1.28831972e-01, 6.89439395e-01, 1.12346905e+00, 1.30934523e+00, + 1.35511965e+00, 1.42311381e+00, 1.15706449e+00, 4.06319438e-01 }, + + { 1.34033030e+00, 1.38996825e+00, 1.04467922e+00, 6.35822746e-01, + -2.74733756e-01, -1.54923372e+00, -2.44239710e+00, -3.02457607e+00 }, + + { 2.13843105e+00, 4.24711267e+00, 2.89734110e+00, 9.32730658e-01, + -2.92822250e-01, -8.10404297e-01, -7.88868099e-01, -9.35353149e-01 }, + + { 5.64830487e-01, 1.59184978e+00, 2.39771699e+00, 3.03697344e+00, + 2.66424350e+00, 1.39304485e+00, 4.03834024e-01, -6.56270971e-01 }, + + { -4.22460548e-01, 3.26149625e-01, 1.39171313e+00, 2.23146615e+00, + 2.61179442e+00, 2.66540340e+00, 2.40103554e+00, 1.75920380e+00 }, + +}; + +const struct lc3_sns_vq_gains lc3_sns_vq_gains[4] = { + + { 2, (const float []){ + 8915.f / 4096, 12054.f / 4096 } }, + + { 4, (const float []){ + 6245.f / 4096, 15043.f / 4096, 17861.f / 4096, 21014.f / 4096 } }, + + { 4, (const float []){ + 7099.f / 4096, 9132.f / 4096, 11253.f / 4096, 14808.f / 4096 } }, + + { 8, (const float []){ + 4336.f / 4096, 5067.f / 4096, 5895.f / 4096, 8149.f / 4096, + 10235.f / 4096, 12825.f / 4096, 16868.f / 4096, 19882.f / 4096 } } +}; + +const int32_t lc3_sns_mpvq_offsets[][11] = { + { 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1 }, + { 0, 1, 3, 5, 7, 9, 11, 13, 15, 17, 19 }, + { 0, 1, 5, 13, 25, 41, 61, 85, 113, 145, 181 }, + { 0, 1, 7, 25, 63, 129, 231, 377, 575, 833, 1159 }, + { 0, 1, 9, 41, 129, 321, 681, 1289, 2241, 3649, 5641 }, + { 0, 1, 11, 61, 231, 681, 1683, 3653, 7183, 13073 , 22363 }, + { 0, 1, 13, 85, 377, 1289, 3653, 8989, 19825, 40081, 75517 }, + { 0, 1, 15, 113, 575, 2241, 7183, 19825, 48639, 108545, 224143 }, + { 0, 1, 17, 145, 833, 3649, 13073, 40081, 108545, 265729, 598417 }, + { 0, 1, 19, 181, 1159, 5641, 22363, 75517, 224143, 598417, 1462563 }, + { 0, 1, 21, 221, 1561, 8361, 36365, 134245, 433905, 1256465, 3317445 }, + { 0, 1, 23, 265, 2047, 11969, 56695, 227305, 795455, 2485825, 7059735 }, + { 0, 1, 25, 313, 2625, 16641, 85305, 369305,1392065, 4673345,14218905 }, + { 0, 1, 27, 365, 3303, 22569, 124515, 579125,2340495, 8405905,27298155 }, + { 0, 1, 29, 421, 4089, 29961, 177045, 880685,3800305,14546705,50250765 }, + { 0, 1, 31, 481, 4991, 39041, 246047,1303777,5984767,24331777,89129247 }, +}; + + +/** + * TNS Arithmetic Coding + * The number of bits are given at 2048th of bits + */ + +const struct lc3_ac_model lc3_tns_order_models[] = { + + { { { 0, 3 }, { 3, 9 }, { 12, 23 }, { 35, 54 }, + { 89, 111 }, { 200, 190 }, { 390, 268 }, { 658, 366 }, + { 1024, 0 }, { 1024, 0 }, { 1024, 0 }, { 1024, 0 }, + { 1024, 0 }, { 1024, 0 }, { 1024, 0 }, { 1024, 0 }, + { 1024, 0 } } }, + + { { { 0, 14 }, { 14, 42 }, { 56, 100 }, { 156, 157 }, + { 313, 181 }, { 494, 178 }, { 672, 167 }, { 839, 185 }, + { 1024, 0 }, { 1024, 0 }, { 1024, 0 }, { 1024, 0 }, + { 1024, 0 }, { 1024, 0 }, { 1024, 0 }, { 1024, 0 }, + { 1024, 0 } } }, +}; + +const uint16_t lc3_tns_order_bits[][8] = { + { 17234, 13988, 11216, 8694, 6566, 4977, 3961, 3040 }, + { 12683, 9437, 6874, 5541, 5121, 5170, 5359, 5056 } +}; + +const struct lc3_ac_model lc3_tns_coeffs_models[] = { + + { { { 0, 1 }, { 1, 5 }, { 6, 15 }, { 21, 31 }, + { 52, 54 }, { 106, 86 }, { 192, 97 }, { 289, 120 }, + { 409, 159 }, { 568, 152 }, { 720, 111 }, { 831, 104 }, + { 935, 59 }, { 994, 22 }, { 1016, 6 }, { 1022, 1 }, + { 1023, 1 } } }, + + { { { 0, 1 }, { 1, 1 }, { 2, 1 }, { 3, 1 }, + { 4, 13 }, { 17, 43 }, { 60, 94 }, { 154, 139 }, + { 293, 173 }, { 466, 160 }, { 626, 154 }, { 780, 131 }, + { 911, 78 }, { 989, 27 }, { 1016, 6 }, { 1022, 1 }, + { 1023, 1 } } }, + + { { { 0, 1 }, { 1, 1 }, { 2, 1 }, { 3, 1 }, + { 4, 9 }, { 13, 43 }, { 56, 106 }, { 162, 199 }, + { 361, 217 }, { 578, 210 }, { 788, 141 }, { 929, 74 }, + { 1003, 17 }, { 1020, 1 }, { 1021, 1 }, { 1022, 1 }, + { 1023, 1 } } }, + + { { { 0, 1 }, { 1, 1 }, { 2, 1 }, { 3, 1 }, + { 4, 2 }, { 6, 11 }, { 17, 49 }, { 66, 204 }, + { 270, 285 }, { 555, 297 }, { 852, 120 }, { 972, 39 }, + { 1011, 9 }, { 1020, 1 }, { 1021, 1 }, { 1022, 1 }, + { 1023, 1 } } }, + + { { { 0, 1 }, { 1, 1 }, { 2, 1 }, { 3, 1 }, + { 4, 1 }, { 5, 7 }, { 12, 42 }, { 54, 241 }, + { 295, 341 }, { 636, 314 }, { 950, 58 }, { 1008, 9 }, + { 1017, 3 }, { 1020, 1 }, { 1021, 1 }, { 1022, 1 }, + { 1023, 1 } } }, + + { { { 0, 1 }, { 1, 1 }, { 2, 1 }, { 3, 1 }, + { 4, 1 }, { 5, 1 }, { 6, 13 }, { 19, 205 }, + { 224, 366 }, { 590, 377 }, { 967, 47 }, { 1014, 5 }, + { 1019, 1 }, { 1020, 1 }, { 1021, 1 }, { 1022, 1 }, + { 1023, 1 } } }, + + { { { 0, 1 }, { 1, 1 }, { 2, 1 }, { 3, 1 }, + { 4, 1 }, { 5, 1 }, { 6, 13 }, { 19, 281 }, + { 300, 330 }, { 630, 371 }, { 1001, 17 }, { 1018, 1 }, + { 1019, 1 }, { 1020, 1 }, { 1021, 1 }, { 1022, 1 }, + { 1023, 1 } } }, + + { { { 0, 1 }, { 1, 1 }, { 2, 1 }, { 3, 1 }, + { 4, 1 }, { 5, 1 }, { 6, 5 }, { 11, 297 }, + { 308, 1 }, { 309, 682 }, { 991, 26 }, { 1017, 2 }, + { 1019, 1 }, { 1020, 1 }, { 1021, 1 }, { 1022, 1 }, + { 1023, 1 } } }, + +}; + +const uint16_t lc3_tns_coeffs_bits[][17] = { + + { 20480, 15725, 12479, 10334, 8694, 7320, 6964, 6335, + 5504, 5637, 6566, 6758, 8433, 11348, 15186, 20480, 20480 }, + + { 20480, 20480, 20480, 20480, 12902, 9368, 7057, 5901, + 5254, 5485, 5598, 6076, 7608, 10742, 15186, 20480, 20480 }, + + { 20480, 20480, 20480, 20480, 13988, 9368, 6702, 4841, + 4585, 4682, 5859, 7764, 12109, 20480, 20480, 20480, 20480 }, + + { 20480, 20480, 20480, 20480, 18432, 13396, 8982, 4767, + 3779, 3658, 6335, 9656, 13988, 20480, 20480, 20480, 20480 }, + + { 20480, 20480, 20480, 20480, 20480, 14731, 9437, 4275, + 3249, 3493, 8483, 13988, 17234, 20480, 20480, 20480, 20480 }, + + { 20480, 20480, 20480, 20480, 20480, 20480, 12902, 4753, + 3040, 2953, 9105, 15725, 20480, 20480, 20480, 20480, 20480 }, + + { 20480, 20480, 20480, 20480, 20480, 20480, 12902, 3821, + 3346, 3000, 12109, 20480, 20480, 20480, 20480, 20480, 20480 }, + + { 20480, 20480, 20480, 20480, 20480, 20480, 15725, 3658, + 20480, 1201, 10854, 18432, 20480, 20480, 20480, 20480, 20480 } + +}; + + +/** + * Long Term Postfilter Synthesis + * with - addition of a 0 for num coefficients + * - remove of first 0 den coefficients + */ + +const float *lc3_ltpf_cnum[LC3_NUM_SRATE][4] = { + + [LC3_SRATE_8K] = { + (const float []){ + 6.02361821e-01, 4.19760926e-01, -1.88342453e-02, 0. }, + (const float []){ + 5.99476858e-01, 4.19760926e-01, -1.59492828e-02, 0. }, + (const float []){ + 5.96776466e-01, 4.19760926e-01, -1.32488910e-02, 0. }, + (const float []){ + 5.94241012e-01, 4.19760926e-01, -1.07134366e-02, 0. }, + }, + + [LC3_SRATE_16K] = { + (const float []){ + 6.02361821e-01, 4.19760926e-01, -1.88342453e-02, 0. }, + (const float []){ + 5.99476858e-01, 4.19760926e-01, -1.59492828e-02, 0. }, + (const float []){ + 5.96776466e-01, 4.19760926e-01, -1.32488910e-02, 0. }, + (const float []){ + 5.94241012e-01, 4.19760926e-01, -1.07134366e-02, 0. }, + }, + + [LC3_SRATE_24K] = { + (const float []){ + 3.98969559e-01, 5.14250861e-01, 1.00438297e-01, -1.27889396e-02, + -1.57228008e-03, 0. }, + (const float []){ + 3.94863491e-01, 5.12381921e-01, 1.04319493e-01, -1.09199996e-02, + -1.34740833e-03, 0. }, + (const float []){ + 3.90984448e-01, 5.10605352e-01, 1.07983252e-01, -9.14343107e-03, + -1.13212462e-03, 0. }, + (const float []){ + 3.87309389e-01, 5.08912208e-01, 1.11451738e-01, -7.45028713e-03, + -9.25551405e-04, 0. }, + }, + + [LC3_SRATE_32K] = { + (const float []){ + 2.98237945e-01, 4.65280920e-01, 2.10599743e-01, 3.76678038e-02, + -1.01569616e-02, -2.53588100e-03, -3.18294617e-04, 0. }, + (const float []){ + 2.94383415e-01, 4.61929400e-01, 2.12946577e-01, 4.06617500e-02, + -8.69327230e-03, -2.17830711e-03, -2.74288806e-04, 0. }, + (const float []){ + 2.90743921e-01, 4.58746191e-01, 2.15145697e-01, 4.35010477e-02, + -7.29549535e-03, -1.83439564e-03, -2.31692019e-04, 0. }, + (const float []){ + 2.87297585e-01, 4.55714889e-01, 2.17212695e-01, 4.62008888e-02, + -5.95746380e-03, -1.50293428e-03, -1.90385191e-04, 0. }, + }, + + [LC3_SRATE_48K] = { + (const float []){ + 1.98136374e-01, 3.52449490e-01, 2.51369527e-01, 1.42414624e-01, + 5.70473102e-02, 9.29336624e-03, -7.22602537e-03, -3.17267989e-03, + -1.12183596e-03, -2.90295724e-04, -4.27081559e-05, 0. }, + (const float []){ + 1.95070943e-01, 3.48466041e-01, 2.50998846e-01, 1.44116741e-01, + 5.92894732e-02, 1.10892383e-02, -6.19290811e-03, -2.72670551e-03, + -9.66712583e-04, -2.50810092e-04, -3.69993877e-05, 0. }, + (const float []){ + 1.92181006e-01, 3.44694556e-01, 2.50622009e-01, 1.45710245e-01, + 6.14113213e-02, 1.27994140e-02, -5.20372109e-03, -2.29732451e-03, + -8.16560813e-04, -2.12385575e-04, -3.14127133e-05, 0. }, + (const float []){ + 1.89448531e-01, 3.41113925e-01, 2.50240688e-01, 1.47206563e-01, + 6.34247723e-02, 1.44320343e-02, -4.25444914e-03, -1.88308147e-03, + -6.70961906e-04, -1.74936334e-04, -2.59386474e-05, 0. }, + } +}; + +const float *lc3_ltpf_cden[LC3_NUM_SRATE][4] = { + + [LC3_SRATE_8K] = { + (const float []){ + 2.09880463e-01, 5.83527575e-01, 2.09880463e-01, 0.00000000e+00 }, + (const float []){ + 1.06999186e-01, 5.50075002e-01, 3.35690625e-01, 6.69885837e-03 }, + (const float []){ + 3.96711478e-02, 4.59220930e-01, 4.59220930e-01, 3.96711478e-02 }, + (const float []){ + 6.69885837e-03, 3.35690625e-01, 5.50075002e-01, 1.06999186e-01 }, + }, + + [LC3_SRATE_16K] = { + (const float []){ + 2.09880463e-01, 5.83527575e-01, 2.09880463e-01, 0.00000000e+00 }, + (const float []){ + 1.06999186e-01, 5.50075002e-01, 3.35690625e-01, 6.69885837e-03 }, + (const float []){ + 3.96711478e-02, 4.59220930e-01, 4.59220930e-01, 3.96711478e-02 }, + (const float []){ + 6.69885837e-03, 3.35690625e-01, 5.50075002e-01, 1.06999186e-01 }, + }, + + [LC3_SRATE_24K] = { + (const float []){ + 6.32223163e-02, 2.50730961e-01, 3.71390943e-01, 2.50730961e-01, + 6.32223163e-02, 0.00000000e+00 }, + (const float []){ + 3.45927217e-02, 1.98651560e-01, 3.62641173e-01, 2.98675055e-01, + 1.01309287e-01, 4.26354371e-03 }, + (const float []){ + 1.53574678e-02, 1.47434488e-01, 3.37425955e-01, 3.37425955e-01, + 1.47434488e-01, 1.53574678e-02 }, + (const float []){ + 4.26354371e-03, 1.01309287e-01, 2.98675055e-01, 3.62641173e-01, + 1.98651560e-01, 3.45927217e-02 }, + }, + + [LC3_SRATE_32K] = { + (const float []){ + 2.90040188e-02, 1.12985742e-01, 2.21202403e-01, 2.72390947e-01, + 2.21202403e-01, 1.12985742e-01, 2.90040188e-02, 0.00000000e+00 }, + (const float []){ + 1.70315342e-02, 8.72250379e-02, 1.96140776e-01, 2.68923798e-01, + 2.42499910e-01, 1.40577336e-01, 4.47487717e-02, 3.12703024e-03 }, + (const float []){ + 8.56367375e-03, 6.42622294e-02, 1.68767671e-01, 2.58744594e-01, + 2.58744594e-01, 1.68767671e-01, 6.42622294e-02, 8.56367375e-03 }, + (const float []){ + 3.12703024e-03, 4.47487717e-02, 1.40577336e-01, 2.42499910e-01, + 2.68923798e-01, 1.96140776e-01, 8.72250379e-02, 1.70315342e-02 }, + }, + + [LC3_SRATE_48K] = { + (const float []){ + 1.08235939e-02, 3.60896922e-02, 7.67640147e-02, 1.24153058e-01, + 1.62759644e-01, 1.77677142e-01, 1.62759644e-01, 1.24153058e-01, + 7.67640147e-02, 3.60896922e-02, 1.08235939e-02, 0.00000000e+00 }, + (const float []){ + 7.04140493e-03, 2.81970232e-02, 6.54704494e-02, 1.12464799e-01, + 1.54841896e-01, 1.76712238e-01, 1.69150721e-01, 1.35290158e-01, + 8.85142501e-02, 4.49935385e-02, 1.55761371e-02, 2.03972196e-03 }, + (const float []){ + 4.14699847e-03, 2.13575731e-02, 5.48273558e-02, 1.00497144e-01, + 1.45606034e-01, 1.73843984e-01, 1.73843984e-01, 1.45606034e-01, + 1.00497144e-01, 5.48273558e-02, 2.13575731e-02, 4.14699847e-03 }, + (const float []){ + 2.03972196e-03, 1.55761371e-02, 4.49935385e-02, 8.85142501e-02, + 1.35290158e-01, 1.69150721e-01, 1.76712238e-01, 1.54841896e-01, + 1.12464799e-01, 6.54704494e-02, 2.81970232e-02, 7.04140493e-03 }, + } +}; + + +/** + * Spectral Data Arithmetic Coding + * The number of bits are given at 2048th of bits + * + * The dimensions of the lookup table are set as following : + * 1: Rate selection + * 2: Half spectrum selection (1st half / 2nd half) + * 3: State of the arithmetic coder + * 4: Number of msb bits (significant - 2), limited to 3 + * + * table[r][h][s][k] = table(normative)[s + h*256 + r*512 + k*1024] + */ + +const uint8_t lc3_spectrum_lookup[2][2][256][4] = { + + { { { 1,13, 0, 0 }, { 39,13, 0, 0 }, { 7,13, 0, 0 }, { 25,13, 0, 0 }, + { 22,13, 0, 0 }, { 22,13, 0, 0 }, { 28,13, 0, 0 }, { 22,13, 0, 0 }, + { 22,60, 0, 0 }, { 22,60, 0, 0 }, { 22,60, 0, 0 }, { 28,60, 0, 0 }, + { 28,60, 0, 0 }, { 28,60,13, 0 }, { 34,60,13, 0 }, { 31,16,13, 0 }, + { 31,16,13, 0 }, { 40, 0, 0, 0 }, { 43, 0, 0, 0 }, { 46, 0, 0, 0 }, + { 49, 0, 0, 0 }, { 52, 0, 0, 0 }, { 14, 0, 0, 0 }, { 17, 0, 0, 0 }, + { 36, 0, 0, 0 }, { 36, 0, 0, 0 }, { 36, 0, 0, 0 }, { 38, 0, 0, 0 }, + { 0, 0, 0, 0 }, { 57, 0, 0, 0 }, { 38,13, 0, 0 }, { 22,60, 0, 0 }, + { 0, 0, 0, 0 }, { 8, 0, 0, 0 }, { 9, 0, 0, 0 }, { 11, 0, 0, 0 }, + { 47, 0, 0, 0 }, { 14, 0, 0, 0 }, { 14, 0, 0, 0 }, { 17, 0, 0, 0 }, + { 36, 0, 0, 0 }, { 36, 0, 0, 0 }, { 36, 0, 0, 0 }, { 38, 0, 0, 0 }, + { 59, 0, 0, 0 }, { 59, 0, 0, 0 }, { 38,13, 0, 0 }, { 22,60, 0, 0 }, + { 22,60, 0, 0 }, { 26, 0, 0, 0 }, { 46, 0, 0, 0 }, { 29, 0, 0, 0 }, + { 30, 0, 0, 0 }, { 32, 0, 0, 0 }, { 33, 0, 0, 0 }, { 35, 0, 0, 0 }, + { 36, 0, 0, 0 }, { 36, 0, 0, 0 }, { 36, 0, 0, 0 }, { 38, 0, 0, 0 }, + { 0,13, 0, 0 }, { 59,13, 0, 0 }, { 23,13, 0, 0 }, { 22,60, 0, 0 }, + { 46,60, 0, 0 }, { 46, 0, 0, 0 }, { 45, 0, 0, 0 }, { 47, 0, 0, 0 }, + { 48, 0, 0, 0 }, { 50, 0, 0, 0 }, { 50, 0, 0, 0 }, { 18, 0, 0, 0 }, + { 54, 0, 0, 0 }, { 54, 0, 0, 0 }, { 54, 0, 0, 0 }, { 38, 0, 0, 0 }, + { 59,13, 0, 0 }, { 59,13, 0, 0 }, { 59,13, 0, 0 }, { 22,60, 0, 0 }, + { 0,60, 0, 0 }, { 62, 0, 0, 0 }, { 63, 0, 0, 0 }, { 3, 0, 0, 0 }, + { 33, 0, 0, 0 }, { 2, 0, 0, 0 }, { 2, 0, 0, 0 }, { 61, 0, 0, 0 }, + { 20, 0, 0, 0 }, { 20, 0, 0, 0 }, { 20,13, 0, 0 }, { 21,13, 0, 0 }, + { 59,13, 0, 0 }, { 59,13, 0, 0 }, { 39,13, 0, 0 }, { 28,60, 0, 0 }, + { 28,60, 0, 0 }, { 63, 0, 0, 0 }, { 63, 0, 0, 0 }, { 3, 0, 0, 0 }, + { 33, 0, 0, 0 }, { 2, 0, 0, 0 }, { 2, 0, 0, 0 }, { 61, 0, 0, 0 }, + { 38, 0, 0, 0 }, { 38, 0, 0, 0 }, { 38,13, 0, 0 }, { 21,13, 0, 0 }, + { 59,13, 0, 0 }, { 59,13, 0, 0 }, { 39,13, 0, 0 }, { 28,60, 0, 0 }, + { 28,60, 0, 0 }, { 6, 0, 0, 0 }, { 6, 0, 0, 0 }, { 6, 0, 0, 0 }, + { 2, 0, 0, 0 }, { 18, 0, 0, 0 }, { 61, 0, 0, 0 }, { 20, 0, 0, 0 }, + { 21, 0, 0, 0 }, { 21, 0, 0, 0 }, { 21,13, 0, 0 }, { 59,13, 0, 0 }, + { 39,13, 0, 0 }, { 39,13, 0, 0 }, { 7,13, 0, 0 }, { 34,60,13, 0 }, + { 34,60,13, 0 }, { 34,60,13, 0 }, { 34,60,13, 0 }, { 34,60,13, 0 }, + { 34,60,13, 0 }, { 34,60,13, 0 }, { 34,60,13, 0 }, { 34,60,13, 0 }, + { 34,60,13, 0 }, { 34,60,13, 0 }, { 34,60,13, 0 }, { 34,60,13, 0 }, + { 34,60,13, 0 }, { 34,60,13, 0 }, { 34,60,13, 0 }, { 34,60,13, 0 }, + { 34,60,13, 0 }, { 51, 0, 0, 0 }, { 51, 0, 0, 0 }, { 51, 0, 0, 0 }, + { 53, 0, 0, 0 }, { 54, 0, 0, 0 }, { 20, 0, 0, 0 }, { 38, 0, 0, 0 }, + { 38, 0, 0, 0 }, { 57, 0, 0, 0 }, { 39,13, 0, 0 }, { 39,13, 0, 0 }, + { 39,13, 0, 0 }, { 7,13, 0, 0 }, { 24,13, 0, 0 }, { 34,60,13, 0 }, + { 4,60, 0, 0 }, { 4,60, 0, 0 }, { 4,60, 0, 0 }, { 4,60, 0, 0 }, + { 4,60, 0, 0 }, { 4,60, 0, 0 }, { 4,60, 0, 0 }, { 4,60, 0, 0 }, + { 4,60, 0, 0 }, { 4,60, 0, 0 }, { 4,60, 0, 0 }, { 4,60, 0, 0 }, + { 4,60, 0, 0 }, { 4,60, 0, 0 }, { 4,60, 0, 0 }, { 4,60, 0, 0 }, + { 4,60, 0, 0 }, { 4, 0, 0, 0 }, { 4, 0, 0, 0 }, { 4, 0, 0, 0 }, + { 4, 0, 0, 0 }, { 56, 0, 0, 0 }, { 38, 0, 0, 0 }, { 57, 0, 0, 0 }, + { 57,13, 0, 0 }, { 59,13, 0, 0 }, { 7,13, 0, 0 }, { 7,13, 0, 0 }, + { 7,13, 0, 0 }, { 42,13, 0, 0 }, { 42,13, 0, 0 }, { 34,60,13, 0 }, + { 0,60,13, 0 }, { 0,60,13, 0 }, { 0,60,13, 0 }, { 0,60,13, 0 }, + { 0,60,13, 0 }, { 0,60,13, 0 }, { 0,60,13, 0 }, { 0,60,13, 0 }, + { 0,60,13, 0 }, { 0,60,13, 0 }, { 0,60,13, 0 }, { 0,60,13, 0 }, + { 0,60,13, 0 }, { 0,60,13, 0 }, { 0,60,13, 0 }, { 0,60,13, 0 }, + { 0,60,13, 0 }, { 5, 0, 0, 0 }, { 4, 0, 0, 0 }, { 4, 0, 0, 0 }, + { 5, 0, 0, 0 }, { 21, 0, 0, 0 }, { 21, 0, 0, 0 }, { 59,13, 0, 0 }, + { 7,13, 0, 0 }, { 7,13, 0, 0 }, { 7,13, 0, 0 }, { 7,13, 0, 0 }, + { 25,13, 0, 0 }, { 25,13, 0, 0 }, { 25,13, 0, 0 }, { 34,60,13, 0 }, + { 4,13, 0, 0 }, { 4,13, 0, 0 }, { 4,13, 0, 0 }, { 4,13, 0, 0 }, + { 5,13, 0, 0 }, { 23,13, 0, 0 }, { 23,13, 0, 0 }, { 39,13, 0, 0 }, + { 7,13, 0, 0 }, { 7,13, 0, 0 }, { 7,13, 0, 0 }, { 42,13, 0, 0 }, + { 25,13, 0, 0 }, { 25,13, 0, 0 }, { 22,13, 0, 0 }, { 31,60,13, 0 }, + { 31,60,13, 0 }, { 39,60, 0, 0 }, { 39,60, 0, 0 }, { 39,60, 0, 0 }, + { 39,60, 0, 0 }, { 7,60, 0, 0 }, { 7,60, 0, 0 }, { 42,60, 0, 0 }, + { 0,60, 0, 0 }, { 25,60, 0, 0 }, { 22,60, 0, 0 }, { 22,60, 0, 0 }, + { 22,60, 0, 0 }, { 28,60, 0, 0 }, { 34,60, 0, 0 }, { 31,16,13, 0 } }, + + { { 55, 0,13, 0 }, { 55, 0,13, 0 }, { 55, 0,13, 0 }, { 55, 0,13, 0 }, + { 55, 0,13, 0 }, { 55, 0,13, 0 }, { 55, 0,13, 0 }, { 55, 0,13, 0 }, + { 55, 0,13, 0 }, { 55, 0,13, 0 }, { 55, 0,13, 0 }, { 55, 0,13, 0 }, + { 55, 0,13, 0 }, { 55, 0,13, 0 }, { 55, 0,13, 0 }, { 55, 0,13, 0 }, + { 55, 0,13, 0 }, { 55, 0, 0, 0 }, { 40, 0, 0, 0 }, { 8, 0, 0, 0 }, + { 9, 0, 0, 0 }, { 49, 0, 0, 0 }, { 49, 0, 0, 0 }, { 52, 0, 0, 0 }, + { 17, 0, 0, 0 }, { 17, 0, 0, 0 }, { 17, 0, 0, 0 }, { 4,13, 0, 0 }, + { 0,13, 0, 0 }, { 20,13, 0, 0 }, { 17, 0, 0, 0 }, { 60,13,60,13 }, + { 40, 0, 0,13 }, { 40, 0, 0, 0 }, { 8, 0, 0, 0 }, { 43, 0, 0, 0 }, + { 27, 0, 0, 0 }, { 49, 0, 0, 0 }, { 49, 0, 0, 0 }, { 14, 0, 0, 0 }, + { 17, 0, 0, 0 }, { 17, 0, 0, 0 }, { 17, 0, 0, 0 }, { 36, 0, 0, 0 }, + { 42,13, 0, 0 }, { 42,13, 0, 0 }, { 17, 0, 0, 0 }, { 57,60,13, 0 }, + { 57, 0,13, 0 }, { 40, 0, 0, 0 }, { 8, 0, 0, 0 }, { 26, 0, 0, 0 }, + { 27, 0, 0, 0 }, { 49, 0, 0, 0 }, { 12, 0, 0, 0 }, { 14, 0, 0, 0 }, + { 17, 0, 0, 0 }, { 17, 0, 0, 0 }, { 17, 0, 0, 0 }, { 36, 0, 0, 0 }, + { 0, 0,13, 0 }, { 38, 0,13, 0 }, { 36,13, 0, 0 }, { 1,60, 0, 0 }, + { 8,60, 0, 0 }, { 8, 0, 0, 0 }, { 43, 0, 0, 0 }, { 9, 0, 0, 0 }, + { 11, 0, 0, 0 }, { 49, 0, 0, 0 }, { 12, 0, 0, 0 }, { 14, 0, 0, 0 }, + { 14, 0,13, 0 }, { 33, 0,13, 0 }, { 50, 0,13, 0 }, { 50, 0, 0, 0 }, + { 50, 0,13, 0 }, { 61, 0,13, 0 }, { 36,13, 0, 0 }, { 39,60, 0, 0 }, + { 8,60, 0, 0 }, { 8, 0, 0, 0 }, { 43, 0, 0, 0 }, { 46, 0, 0, 0 }, + { 49, 0, 0, 0 }, { 52, 0, 0, 0 }, { 30, 0, 0, 0 }, { 14, 0, 0, 0 }, + { 14, 0,13, 0 }, { 33, 0,13, 0 }, { 50, 0,13, 0 }, { 50, 0,13, 0 }, + { 50,13,13, 0 }, { 50,13, 0, 0 }, { 18,13,13, 0 }, { 25,60,13, 0 }, + { 8,60,13,13 }, { 8, 0, 0,13 }, { 43, 0, 0,13 }, { 46, 0, 0,13 }, + { 49, 0, 0,13 }, { 52, 0, 0, 0 }, { 30, 0, 0, 0 }, { 14, 0, 0, 0 }, + { 14, 0, 0, 0 }, { 18, 0,60, 0 }, { 5, 0, 0,13 }, { 5, 0, 0,13 }, + { 5, 0, 0,13 }, { 61,13, 0,13 }, { 18,13,13, 0 }, { 23,13,60, 0 }, + { 43,13, 0,13 }, { 43, 0, 0,13 }, { 43, 0, 0,13 }, { 9, 0, 0,13 }, + { 49, 0, 0,13 }, { 52, 0, 0, 0 }, { 3, 0, 0, 0 }, { 14, 0, 0, 0 }, + { 14, 0, 0, 0 }, { 50, 0, 0, 0 }, { 50,13,13, 0 }, { 50,13,13, 0 }, + { 50,13,13, 0 }, { 61, 0, 0, 0 }, { 17,13,13, 0 }, { 24,60,13, 0 }, + { 43,60,13, 0 }, { 43,60,13, 0 }, { 43,60,13, 0 }, { 43,60,13, 0 }, + { 43,60,13, 0 }, { 43,60,13, 0 }, { 43,60,13, 0 }, { 43,60,13, 0 }, + { 43,60,13, 0 }, { 43,60,13, 0 }, { 43,60,13, 0 }, { 43,60,13, 0 }, + { 43,60,13, 0 }, { 43,60,13, 0 }, { 43,60,13, 0 }, { 43,60,13, 0 }, + { 43,60,13, 0 }, { 43, 0, 0, 0 }, { 43, 0,19, 0 }, { 9, 0, 0, 0 }, + { 11, 0, 0, 0 }, { 52, 0, 0, 0 }, { 52, 0, 0, 0 }, { 14, 0, 0, 0 }, + { 14, 0, 0, 0 }, { 17, 0, 0, 0 }, { 61,13, 0, 0 }, { 61,13, 0, 0 }, + { 61,13, 0, 0 }, { 54, 0, 0, 0 }, { 17, 0,13,13 }, { 39,13,13, 0 }, + { 45,13,13, 0 }, { 45,13,13, 0 }, { 45,13,13, 0 }, { 45,13,13, 0 }, + { 45,13,13, 0 }, { 45,13,13, 0 }, { 45,13,13, 0 }, { 45,13,13, 0 }, + { 45,13,13, 0 }, { 45,13,13, 0 }, { 45,13,13, 0 }, { 45,13,13, 0 }, + { 45,13,13, 0 }, { 45,13,13, 0 }, { 45,13,13, 0 }, { 45,13,13, 0 }, + { 45,13,13, 0 }, { 45, 0,13, 0 }, { 44, 0,13, 0 }, { 27, 0, 0, 0 }, + { 29, 0, 0, 0 }, { 52, 0, 0, 0 }, { 48, 0, 0, 0 }, { 52, 0, 0, 0 }, + { 52, 0, 0, 0 }, { 17, 0, 0, 0 }, { 17, 0, 0, 0 }, { 17, 0,19, 0 }, + { 17, 0,13, 0 }, { 2, 0,13, 0 }, { 17, 0,13, 0 }, { 7,13, 0, 0 }, + { 27, 0, 0,13 }, { 27, 0, 0,13 }, { 27, 0, 0,13 }, { 27, 0, 0,13 }, + { 27, 0, 0,13 }, { 27, 0, 0,13 }, { 27, 0, 0,13 }, { 27, 0, 0,13 }, + { 27, 0, 0,13 }, { 27, 0, 0,13 }, { 27, 0, 0,13 }, { 27, 0, 0,13 }, + { 27, 0, 0,13 }, { 27, 0, 0,13 }, { 27, 0, 0,13 }, { 27, 0, 0,13 }, + { 27, 0, 0,13 }, { 27, 0, 0,13 }, { 9, 0, 0,13 }, { 27, 0, 0,13 }, + { 27, 0, 0,13 }, { 12, 0, 0,13 }, { 52, 0, 0,13 }, { 14, 0, 0,13 }, + { 14, 0, 0,13 }, { 58, 0, 0,13 }, { 41, 0, 0,13 }, { 41, 0, 0,13 }, + { 41, 0, 0,13 }, { 6, 0, 0,13 }, { 17,60, 0,13 }, { 37, 0,19,13 }, + { 9, 0, 0,13 }, { 9,16, 0,13 }, { 9, 0, 0,13 }, { 27, 0, 0,13 }, + { 11, 0, 0,13 }, { 49, 0, 0, 0 }, { 12, 0, 0, 0 }, { 52, 0, 0, 0 }, + { 14, 0, 0, 0 }, { 14, 0, 0, 0 }, { 14, 0, 0, 0 }, { 50, 0, 0, 0 }, + { 0, 0, 0,13 }, { 53, 0, 0,13 }, { 17, 0, 0,13 }, { 28, 0,13, 0 }, + { 52, 0,13, 0 }, { 52, 0,13, 0 }, { 49, 0,13, 0 }, { 52, 0, 0, 0 }, + { 12, 0, 0, 0 }, { 52, 0, 0, 0 }, { 30, 0, 0, 0 }, { 14, 0, 0, 0 }, + { 14, 0, 0, 0 }, { 17, 0, 0, 0 }, { 2, 0, 0, 0 }, { 2, 0, 0, 0 }, + { 2, 0, 0, 0 }, { 38, 0, 0, 0 }, { 38, 0, 0, 0 }, { 34, 0, 0, 0 } } }, + + { { { 31,16,60,13 }, { 34,16,13, 0 }, { 34,16,13, 0 }, { 31,16,13, 0 }, + { 31,16,13, 0 }, { 31,16,13, 0 }, { 31,16,13, 0 }, { 19,16,60, 0 }, + { 19,16,60, 0 }, { 19,16,60, 0 }, { 19,16,60, 0 }, { 19,16,60, 0 }, + { 19,16,60, 0 }, { 19,16,60, 0 }, { 31,16,60,13 }, { 19,37,16,60 }, + { 44, 0, 0,60 }, { 44, 0, 0, 0 }, { 62, 0, 0, 0 }, { 30, 0, 0, 0 }, + { 32, 0, 0, 0 }, { 58, 0, 0, 0 }, { 35, 0, 0, 0 }, { 36, 0, 0, 0 }, + { 36, 0, 0, 0 }, { 38,13, 0, 0 }, { 0,13, 0, 0 }, { 59,13, 0, 0 }, + { 7,13, 0, 0 }, { 7,13, 0, 0 }, { 39,13, 0, 0 }, { 34,60,13, 0 }, + { 34, 0,13, 0 }, { 45, 0, 0, 0 }, { 47, 0, 0, 0 }, { 48, 0, 0, 0 }, + { 33, 0, 0, 0 }, { 35, 0, 0, 0 }, { 35, 0, 0, 0 }, { 36, 0, 0, 0 }, + { 38,13, 0, 0 }, { 38,13, 0, 0 }, { 38,13, 0, 0 }, { 59,13, 0, 0 }, + { 7,13, 0, 0 }, { 7,13, 0, 0 }, { 39,13, 0, 0 }, { 34,60,13, 0 }, + { 34, 0,13, 0 }, { 62, 0, 0, 0 }, { 30, 0, 0, 0 }, { 15, 0, 0, 0 }, + { 50, 0, 0, 0 }, { 53, 0, 0, 0 }, { 53, 0, 0, 0 }, { 54,13, 0, 0 }, + { 21,13, 0, 0 }, { 21,13, 0, 0 }, { 21,13, 0, 0 }, { 59,13, 0, 0 }, + { 7,13, 0, 0 }, { 7,13, 0, 0 }, { 7,13, 0, 0 }, { 34,60,13, 0 }, + { 30, 0,13, 0 }, { 30, 0, 0, 0 }, { 48, 0, 0, 0 }, { 33, 0, 0, 0 }, + { 58, 0, 0, 0 }, { 18, 0, 0, 0 }, { 18, 0, 0, 0 }, { 56,13, 0, 0 }, + { 23,13, 0, 0 }, { 23,13, 0, 0 }, { 23,13, 0, 0 }, { 59,13, 0, 0 }, + { 7,13, 0, 0 }, { 7,13, 0, 0 }, { 24,13, 0, 0 }, { 34,60,13, 0 }, + { 34, 0,13, 0 }, { 6, 0, 0, 0 }, { 6, 0, 0, 0 }, { 58, 0, 0, 0 }, + { 53, 0, 0, 0 }, { 54, 0, 0, 0 }, { 54, 0, 0, 0 }, { 21,13, 0, 0 }, + { 59,13, 0, 0 }, { 59,13, 0, 0 }, { 59,13, 0, 0 }, { 39,13, 0, 0 }, + { 7,13, 0, 0 }, { 7,13, 0, 0 }, { 42,60, 0, 0 }, { 34,16,13, 0 }, + { 6, 0,13, 0 }, { 6, 0, 0, 0 }, { 33, 0, 0, 0 }, { 58, 0, 0, 0 }, + { 53, 0, 0, 0 }, { 54, 0, 0, 0 }, { 61, 0, 0, 0 }, { 21,13, 0, 0 }, + { 59,13, 0, 0 }, { 59,13, 0, 0 }, { 59,13, 0, 0 }, { 39,13, 0, 0 }, + { 7,13, 0, 0 }, { 7,13, 0, 0 }, { 42,60, 0, 0 }, { 34,16,13, 0 }, + { 34, 0,13, 0 }, { 51, 0, 0, 0 }, { 51, 0, 0, 0 }, { 53, 0, 0, 0 }, + { 54, 0, 0, 0 }, { 56,13, 0, 0 }, { 56,13, 0, 0 }, { 57,13, 0, 0 }, + { 39,13, 0, 0 }, { 39,13, 0, 0 }, { 39,13, 0, 0 }, { 7,13, 0, 0 }, + { 42,13, 0, 0 }, { 42,13, 0, 0 }, { 25,60, 0, 0 }, { 31,16,13, 0 }, + { 31, 0,13, 0 }, { 31, 0,13, 0 }, { 31, 0,13, 0 }, { 31, 0,13, 0 }, + { 31, 0,13, 0 }, { 31, 0,13, 0 }, { 31, 0,13, 0 }, { 31, 0,13, 0 }, + { 31, 0,13, 0 }, { 31, 0,13, 0 }, { 31, 0,13, 0 }, { 31, 0,13, 0 }, + { 31, 0,13, 0 }, { 31, 0,13, 0 }, { 31, 0,13, 0 }, { 31, 0,13, 0 }, + { 31, 0,13, 0 }, { 4, 0, 0, 0 }, { 4, 0, 0, 0 }, { 4, 0, 0, 0 }, + { 5,13, 0, 0 }, { 23,13, 0, 0 }, { 23,13, 0, 0 }, { 39,13, 0, 0 }, + { 7,13, 0, 0 }, { 7,13, 0, 0 }, { 7,13, 0, 0 }, { 42,13, 0, 0 }, + { 25,13, 0, 0 }, { 25,13, 0, 0 }, { 22,60, 0, 0 }, { 31,16,60, 0 }, + { 31,13, 0, 0 }, { 31,13, 0, 0 }, { 31,13, 0, 0 }, { 31,13, 0, 0 }, + { 31,13, 0, 0 }, { 31,13, 0, 0 }, { 31,13, 0, 0 }, { 31,13, 0, 0 }, + { 31,13, 0, 0 }, { 31,13, 0, 0 }, { 31,13, 0, 0 }, { 31,13, 0, 0 }, + { 31,13, 0, 0 }, { 31,13, 0, 0 }, { 31,13, 0, 0 }, { 31,13, 0, 0 }, + { 31,13, 0, 0 }, { 5,13, 0, 0 }, { 5,13, 0, 0 }, { 5,13, 0, 0 }, + { 5,13, 0, 0 }, { 57,13, 0, 0 }, { 57,13, 0, 0 }, { 39,13, 0, 0 }, + { 24,13, 0, 0 }, { 24,13, 0, 0 }, { 24,13, 0, 0 }, { 42,13, 0, 0 }, + { 22,13, 0, 0 }, { 22,60, 0, 0 }, { 28,60,13, 0 }, { 31,16,60, 0 }, + { 31,13, 0, 0 }, { 31,13, 0, 0 }, { 31,13, 0, 0 }, { 31,13, 0, 0 }, + { 31,13, 0, 0 }, { 31,13, 0, 0 }, { 31,13, 0, 0 }, { 31,13, 0, 0 }, + { 31,13, 0, 0 }, { 31,13, 0, 0 }, { 31,13, 0, 0 }, { 31,13, 0, 0 }, + { 31,13, 0, 0 }, { 31,13, 0, 0 }, { 31,13, 0, 0 }, { 31,13, 0, 0 }, + { 31,13, 0, 0 }, { 41,13, 0, 0 }, { 41,13, 0, 0 }, { 41,13, 0, 0 }, + { 41,13, 0, 0 }, { 39,13, 0, 0 }, { 39,13, 0, 0 }, { 7,13, 0, 0 }, + { 42,13, 0, 0 }, { 42,13, 0, 0 }, { 42,13, 0, 0 }, { 25,13, 0, 0 }, + { 28,13, 0, 0 }, { 28,60, 0, 0 }, { 28,60,13, 0 }, { 31,16,60,13 }, + { 31,13, 0, 0 }, { 41,13, 0, 0 }, { 41,13, 0, 0 }, { 41,13, 0, 0 }, + { 41,13, 0, 0 }, { 39,13, 0, 0 }, { 39,13, 0, 0 }, { 24,13, 0, 0 }, + { 25,60, 0, 0 }, { 25,60, 0, 0 }, { 25,60, 0, 0 }, { 22,60, 0, 0 }, + { 28,60, 0, 0 }, { 28,60, 0, 0 }, { 34,60,13, 0 }, { 31,16,60,13 }, + { 31,60,13,13 }, { 10,60,13, 0 }, { 10,60,13, 0 }, { 10,60,13, 0 }, + { 10,60,13, 0 }, { 10,60,13, 0 }, { 10,60,13, 0 }, { 28,60,13, 0 }, + { 34,60,13, 0 }, { 34,60,13, 0 }, { 34,16,13, 0 }, { 34,16,13, 0 }, + { 34,16,60, 0 }, { 34,16,60, 0 }, { 31,16,60, 0 }, { 19,37,16,13 } }, + + { { 8, 0,16, 0 }, { 8, 0,16, 0 }, { 8, 0,16, 0 }, { 8, 0,16, 0 }, + { 8, 0,16, 0 }, { 8, 0,16, 0 }, { 8, 0,16, 0 }, { 8, 0,16, 0 }, + { 8, 0,16, 0 }, { 8, 0,16, 0 }, { 8, 0,16, 0 }, { 8, 0,16, 0 }, + { 8, 0,16, 0 }, { 8, 0,16, 0 }, { 8, 0,16, 0 }, { 8, 0,16, 0 }, + { 8, 0,16, 0 }, { 8, 0, 0, 0 }, { 9, 0, 0, 0 }, { 11, 0, 0, 0 }, + { 47, 0, 0, 0 }, { 32, 0, 0, 0 }, { 50, 0, 0, 0 }, { 18, 0, 0, 0 }, + { 18, 0, 0, 0 }, { 20, 0, 0, 0 }, { 21, 0, 0, 0 }, { 21, 0, 0, 0 }, + { 21,13, 0, 0 }, { 39,13, 0, 0 }, { 59,13, 0, 0 }, { 34,16,60, 0 }, + { 26, 0, 0, 0 }, { 26, 0, 0, 0 }, { 27, 0, 0, 0 }, { 29, 0, 0, 0 }, + { 30, 0, 0, 0 }, { 33, 0, 0, 0 }, { 50, 0, 0, 0 }, { 18, 0, 0, 0 }, + { 18, 0, 0, 0 }, { 20, 0, 0, 0 }, { 57, 0, 0, 0 }, { 57,13, 0, 0 }, + { 57,13, 0, 0 }, { 59,13, 0, 0 }, { 59,13, 0, 0 }, { 34,16,60, 0 }, + { 27, 0, 0, 0 }, { 27, 0, 0, 0 }, { 11, 0, 0, 0 }, { 12, 0, 0, 0 }, + { 48, 0, 0, 0 }, { 50, 0, 0, 0 }, { 58, 0, 0, 0 }, { 61, 0, 0, 0 }, + { 61, 0, 0, 0 }, { 56, 0, 0, 0 }, { 57,13, 0, 0 }, { 57,13, 0, 0 }, + { 57,13, 0, 0 }, { 59,13, 0, 0 }, { 39,13, 0, 0 }, { 34,16,60, 0 }, + { 45, 0, 0, 0 }, { 45, 0, 0, 0 }, { 12, 0, 0, 0 }, { 30, 0, 0, 0 }, + { 32, 0, 0, 0 }, { 2, 0, 0, 0 }, { 2, 0, 0, 0 }, { 61, 0, 0, 0 }, + { 38, 0, 0, 0 }, { 38, 0, 0, 0 }, { 38,13, 0, 0 }, { 57,13, 0, 0 }, + { 0,13, 0, 0 }, { 59,13, 0, 0 }, { 39,13, 0, 0 }, { 34,16,60, 0 }, + { 63, 0, 0, 0 }, { 63, 0, 0, 0 }, { 3, 0, 0, 0 }, { 32, 0, 0, 0 }, + { 58, 0, 0, 0 }, { 18, 0, 0, 0 }, { 18, 0, 0, 0 }, { 20, 0, 0, 0 }, + { 21, 0, 0, 0 }, { 21, 0, 0, 0 }, { 21,13, 0, 0 }, { 59,13, 0, 0 }, + { 39,13, 0, 0 }, { 39,13, 0, 0 }, { 7,13,13, 0 }, { 31,16,60, 0 }, + { 31, 0, 0, 0 }, { 3, 0, 0, 0 }, { 3, 0, 0, 0 }, { 33, 0, 0, 0 }, + { 58, 0, 0, 0 }, { 18, 0, 0, 0 }, { 18, 0, 0, 0 }, { 20, 0, 0, 0 }, + { 21, 0, 0, 0 }, { 21, 0, 0, 0 }, { 21,13, 0, 0 }, { 59,13, 0, 0 }, + { 7,13, 0, 0 }, { 7,13, 0, 0 }, { 7,13,13, 0 }, { 31,16,60, 0 }, + { 6, 0, 0, 0 }, { 6, 0, 0, 0 }, { 51, 0, 0, 0 }, { 51, 0, 0, 0 }, + { 53, 0, 0, 0 }, { 54, 0, 0, 0 }, { 54, 0, 0, 0 }, { 38, 0, 0, 0 }, + { 57,13, 0, 0 }, { 57,13, 0, 0 }, { 57,13, 0, 0 }, { 39,13, 0, 0 }, + { 7,13, 0, 0 }, { 7,13, 0, 0 }, { 42,60,13, 0 }, { 31,16,60, 0 }, + { 31, 0, 0, 0 }, { 31, 0, 0, 0 }, { 31, 0, 0, 0 }, { 31, 0, 0, 0 }, + { 31, 0, 0, 0 }, { 31, 0, 0, 0 }, { 31, 0, 0, 0 }, { 31, 0, 0, 0 }, + { 31, 0, 0, 0 }, { 31, 0, 0, 0 }, { 31, 0, 0, 0 }, { 31, 0, 0, 0 }, + { 31, 0, 0, 0 }, { 31, 0, 0, 0 }, { 31, 0, 0, 0 }, { 31, 0, 0, 0 }, + { 31, 0, 0, 0 }, { 51, 0, 0, 0 }, { 53, 0, 0, 0 }, { 53, 0, 0, 0 }, + { 54, 0, 0, 0 }, { 56, 0, 0, 0 }, { 56, 0, 0, 0 }, { 57,13, 0, 0 }, + { 59,13, 0, 0 }, { 59,13, 0, 0 }, { 59,13, 0, 0 }, { 7,13, 0, 0 }, + { 24,13, 0, 0 }, { 24,13, 0, 0 }, { 25,60,13, 0 }, { 31,16,60, 0 }, + { 31, 0, 0, 0 }, { 31, 0, 0, 0 }, { 31, 0, 0, 0 }, { 31, 0, 0, 0 }, + { 31, 0, 0, 0 }, { 31, 0, 0, 0 }, { 31, 0, 0, 0 }, { 31, 0, 0, 0 }, + { 31, 0, 0, 0 }, { 31, 0, 0, 0 }, { 31, 0, 0, 0 }, { 31, 0, 0, 0 }, + { 31, 0, 0, 0 }, { 31, 0, 0, 0 }, { 31, 0, 0, 0 }, { 31, 0, 0, 0 }, + { 31, 0, 0, 0 }, { 4, 0, 0, 0 }, { 4, 0, 0, 0 }, { 4, 0, 0, 0 }, + { 54, 0, 0, 0 }, { 21,13, 0, 0 }, { 21, 0, 0, 0 }, { 57,13, 0, 0 }, + { 39,13, 0, 0 }, { 39,13, 0, 0 }, { 39,13, 0, 0 }, { 7,13, 0, 0 }, + { 42,13,13, 0 }, { 42,13,13, 0 }, { 22,60,13, 0 }, { 31,16,60, 0 }, + { 31,16, 0, 0 }, { 31,16, 0, 0 }, { 31,16, 0, 0 }, { 31,16, 0, 0 }, + { 31,16, 0, 0 }, { 31,16, 0, 0 }, { 31,16, 0, 0 }, { 31,16, 0, 0 }, + { 31,16, 0, 0 }, { 31,16, 0, 0 }, { 31,16, 0, 0 }, { 31,16, 0, 0 }, + { 31,16, 0, 0 }, { 31,16, 0, 0 }, { 31,16, 0, 0 }, { 31,16, 0, 0 }, + { 31,16, 0, 0 }, { 5, 0, 0, 0 }, { 5, 0, 0, 0 }, { 5, 0, 0, 0 }, + { 5,13, 0, 0 }, { 23,13, 0, 0 }, { 23,13, 0, 0 }, { 59,13, 0, 0 }, + { 7,13, 0, 0 }, { 7,13, 0, 0 }, { 7,13,13, 0 }, { 42,13,13, 0 }, + { 22,60,13, 0 }, { 22,60,13, 0 }, { 28,60,13, 0 }, { 31,16,60, 0 }, + { 31,13, 0, 0 }, { 4,13, 0, 0 }, { 4,13, 0, 0 }, { 4,13, 0, 0 }, + { 5,13, 0, 0 }, { 23,13, 0, 0 }, { 23,13, 0, 0 }, { 39,13,13, 0 }, + { 24,60,13, 0 }, { 24,60,13, 0 }, { 24,60,13, 0 }, { 25,60,13, 0 }, + { 28,60,13, 0 }, { 28,60,13, 0 }, { 34,16,13, 0 }, { 31,16,60, 0 }, + { 31,16,13, 0 }, { 10,16,13, 0 }, { 10,16,13, 0 }, { 10,16,13, 0 }, + { 10,16,13, 0 }, { 10,16,60, 0 }, { 10,16,60, 0 }, { 28,16,60, 0 }, + { 34,16,60, 0 }, { 34,16,60, 0 }, { 34,16,60, 0 }, { 31,16,60, 0 }, + { 31,16,60, 0 }, { 31,16,60, 0 }, { 31,16,60, 0 }, { 19,37,60, 0 } } } +}; + +const struct lc3_ac_model lc3_spectrum_models[] = { + + { { { 0, 1 }, { 1, 1 }, { 2, 175 }, { 177, 48 }, + { 225, 1 }, { 226, 1 }, { 227, 109 }, { 336, 36 }, + { 372, 171 }, { 543, 109 }, { 652, 47 }, { 699, 20 }, + { 719, 49 }, { 768, 36 }, { 804, 20 }, { 824, 10 }, + { 834, 190 } } }, + + { { { 0, 18 }, { 18, 26 }, { 44, 17 }, { 61, 10 }, + { 71, 27 }, { 98, 37 }, { 135, 24 }, { 159, 16 }, + { 175, 22 }, { 197, 32 }, { 229, 22 }, { 251, 14 }, + { 265, 17 }, { 282, 26 }, { 308, 20 }, { 328, 13 }, + { 341, 683 } } }, + + { { { 0, 71 }, { 71, 92 }, { 163, 49 }, { 212, 25 }, + { 237, 81 }, { 318, 102 }, { 420, 61 }, { 481, 33 }, + { 514, 42 }, { 556, 57 }, { 613, 39 }, { 652, 23 }, + { 675, 22 }, { 697, 30 }, { 727, 22 }, { 749, 15 }, + { 764, 260 } } }, + + { { { 0, 160 }, { 160, 130 }, { 290, 46 }, { 336, 18 }, + { 354, 121 }, { 475, 123 }, { 598, 55 }, { 653, 24 }, + { 677, 45 }, { 722, 55 }, { 777, 31 }, { 808, 15 }, + { 823, 19 }, { 842, 24 }, { 866, 15 }, { 881, 9 }, + { 890, 134 } } }, + + { { { 0, 71 }, { 71, 73 }, { 144, 33 }, { 177, 18 }, + { 195, 71 }, { 266, 76 }, { 342, 43 }, { 385, 26 }, + { 411, 34 }, { 445, 44 }, { 489, 30 }, { 519, 20 }, + { 539, 20 }, { 559, 27 }, { 586, 21 }, { 607, 15 }, + { 622, 402 } } }, + + { { { 0, 48 }, { 48, 60 }, { 108, 32 }, { 140, 19 }, + { 159, 58 }, { 217, 68 }, { 285, 42 }, { 327, 27 }, + { 354, 31 }, { 385, 42 }, { 427, 30 }, { 457, 21 }, + { 478, 19 }, { 497, 27 }, { 524, 21 }, { 545, 16 }, + { 561, 463 } } }, + + { { { 0, 138 }, { 138, 109 }, { 247, 43 }, { 290, 18 }, + { 308, 111 }, { 419, 112 }, { 531, 53 }, { 584, 25 }, + { 609, 46 }, { 655, 55 }, { 710, 32 }, { 742, 17 }, + { 759, 21 }, { 780, 27 }, { 807, 18 }, { 825, 11 }, + { 836, 188 } } }, + + { { { 0, 16 }, { 16, 24 }, { 40, 22 }, { 62, 17 }, + { 79, 24 }, { 103, 36 }, { 139, 31 }, { 170, 25 }, + { 195, 20 }, { 215, 30 }, { 245, 25 }, { 270, 20 }, + { 290, 15 }, { 305, 22 }, { 327, 19 }, { 346, 16 }, + { 362, 662 } } }, + + { { { 0, 579 }, { 579, 150 }, { 729, 12 }, { 741, 2 }, + { 743, 154 }, { 897, 73 }, { 970, 10 }, { 980, 2 }, + { 982, 14 }, { 996, 11 }, { 1007, 3 }, { 1010, 1 }, + { 1011, 3 }, { 1014, 3 }, { 1017, 1 }, { 1018, 1 }, + { 1019, 5 } } }, + + { { { 0, 398 }, { 398, 184 }, { 582, 25 }, { 607, 5 }, + { 612, 176 }, { 788, 114 }, { 902, 23 }, { 925, 6 }, + { 931, 25 }, { 956, 23 }, { 979, 8 }, { 987, 3 }, + { 990, 6 }, { 996, 6 }, { 1002, 3 }, { 1005, 2 }, + { 1007, 17 } } }, + + { { { 0, 13 }, { 13, 21 }, { 34, 18 }, { 52, 11 }, + { 63, 20 }, { 83, 29 }, { 112, 22 }, { 134, 15 }, + { 149, 14 }, { 163, 20 }, { 183, 16 }, { 199, 12 }, + { 211, 10 }, { 221, 14 }, { 235, 12 }, { 247, 10 }, + { 257, 767 } } }, + + { { { 0, 281 }, { 281, 183 }, { 464, 37 }, { 501, 9 }, + { 510, 171 }, { 681, 139 }, { 820, 37 }, { 857, 10 }, + { 867, 35 }, { 902, 36 }, { 938, 15 }, { 953, 6 }, + { 959, 9 }, { 968, 10 }, { 978, 6 }, { 984, 3 }, + { 987, 37 } } }, + + { { { 0, 198 }, { 198, 164 }, { 362, 46 }, { 408, 13 }, + { 421, 154 }, { 575, 147 }, { 722, 51 }, { 773, 16 }, + { 789, 43 }, { 832, 49 }, { 881, 24 }, { 905, 10 }, + { 915, 13 }, { 928, 16 }, { 944, 10 }, { 954, 5 }, + { 959, 65 } } }, + + { { { 0, 1 }, { 1, 1 }, { 2, 93 }, { 95, 44 }, + { 139, 1 }, { 140, 1 }, { 141, 72 }, { 213, 38 }, + { 251, 86 }, { 337, 70 }, { 407, 43 }, { 450, 25 }, + { 475, 40 }, { 515, 36 }, { 551, 25 }, { 576, 16 }, + { 592, 432 } } }, + + { { { 0, 133 }, { 133, 141 }, { 274, 64 }, { 338, 28 }, + { 366, 117 }, { 483, 122 }, { 605, 59 }, { 664, 27 }, + { 691, 39 }, { 730, 48 }, { 778, 29 }, { 807, 15 }, + { 822, 15 }, { 837, 20 }, { 857, 13 }, { 870, 8 }, + { 878, 146 } } }, + + { { { 0, 128 }, { 128, 125 }, { 253, 49 }, { 302, 18 }, + { 320, 123 }, { 443, 134 }, { 577, 59 }, { 636, 23 }, + { 659, 49 }, { 708, 59 }, { 767, 32 }, { 799, 15 }, + { 814, 19 }, { 833, 24 }, { 857, 15 }, { 872, 9 }, + { 881, 143 } } }, + + { { { 0, 1 }, { 1, 1 }, { 2, 23 }, { 25, 17 }, + { 42, 1 }, { 43, 1 }, { 44, 23 }, { 67, 18 }, + { 85, 20 }, { 105, 21 }, { 126, 18 }, { 144, 15 }, + { 159, 15 }, { 174, 17 }, { 191, 14 }, { 205, 12 }, + { 217, 807 } } }, + + { { { 0, 70 }, { 70, 96 }, { 166, 63 }, { 229, 38 }, + { 267, 89 }, { 356, 112 }, { 468, 65 }, { 533, 36 }, + { 569, 37 }, { 606, 47 }, { 653, 32 }, { 685, 20 }, + { 705, 17 }, { 722, 23 }, { 745, 17 }, { 762, 12 }, + { 774, 250 } } }, + + { { { 0, 55 }, { 55, 75 }, { 130, 45 }, { 175, 25 }, + { 200, 68 }, { 268, 90 }, { 358, 58 }, { 416, 33 }, + { 449, 39 }, { 488, 54 }, { 542, 39 }, { 581, 25 }, + { 606, 22 }, { 628, 31 }, { 659, 24 }, { 683, 16 }, + { 699, 325 } } }, + + { { { 0, 1 }, { 1, 2 }, { 3, 2 }, { 5, 2 }, + { 7, 2 }, { 9, 2 }, { 11, 2 }, { 13, 2 }, + { 15, 2 }, { 17, 2 }, { 19, 2 }, { 21, 2 }, + { 23, 2 }, { 25, 2 }, { 27, 2 }, { 29, 2 }, + { 31, 993 } } }, + + { { { 0, 34 }, { 34, 51 }, { 85, 38 }, { 123, 24 }, + { 147, 49 }, { 196, 69 }, { 265, 52 }, { 317, 35 }, + { 352, 34 }, { 386, 47 }, { 433, 37 }, { 470, 27 }, + { 497, 21 }, { 518, 31 }, { 549, 25 }, { 574, 19 }, + { 593, 431 } } }, + + { { { 0, 30 }, { 30, 43 }, { 73, 32 }, { 105, 22 }, + { 127, 43 }, { 170, 59 }, { 229, 45 }, { 274, 31 }, + { 305, 30 }, { 335, 42 }, { 377, 34 }, { 411, 25 }, + { 436, 19 }, { 455, 28 }, { 483, 23 }, { 506, 18 }, + { 524, 500 } } }, + + { { { 0, 9 }, { 9, 15 }, { 24, 14 }, { 38, 13 }, + { 51, 14 }, { 65, 22 }, { 87, 21 }, { 108, 18 }, + { 126, 13 }, { 139, 20 }, { 159, 18 }, { 177, 16 }, + { 193, 11 }, { 204, 17 }, { 221, 15 }, { 236, 14 }, + { 250, 774 } } }, + + { { { 0, 30 }, { 30, 44 }, { 74, 31 }, { 105, 20 }, + { 125, 41 }, { 166, 58 }, { 224, 42 }, { 266, 28 }, + { 294, 28 }, { 322, 39 }, { 361, 30 }, { 391, 22 }, + { 413, 18 }, { 431, 26 }, { 457, 21 }, { 478, 16 }, + { 494, 530 } } }, + + { { { 0, 15 }, { 15, 23 }, { 38, 20 }, { 58, 15 }, + { 73, 22 }, { 95, 33 }, { 128, 28 }, { 156, 22 }, + { 178, 18 }, { 196, 26 }, { 222, 23 }, { 245, 18 }, + { 263, 13 }, { 276, 20 }, { 296, 18 }, { 314, 15 }, + { 329, 695 } } }, + + { { { 0, 11 }, { 11, 17 }, { 28, 16 }, { 44, 13 }, + { 57, 17 }, { 74, 26 }, { 100, 23 }, { 123, 19 }, + { 142, 15 }, { 157, 22 }, { 179, 20 }, { 199, 17 }, + { 216, 12 }, { 228, 18 }, { 246, 16 }, { 262, 14 }, + { 276, 748 } } }, + + { { { 0, 448 }, { 448, 171 }, { 619, 20 }, { 639, 4 }, + { 643, 178 }, { 821, 105 }, { 926, 18 }, { 944, 4 }, + { 948, 23 }, { 971, 20 }, { 991, 7 }, { 998, 2 }, + { 1000, 5 }, { 1005, 5 }, { 1010, 2 }, { 1012, 1 }, + { 1013, 11 } } }, + + { { { 0, 332 }, { 332, 188 }, { 520, 29 }, { 549, 6 }, + { 555, 186 }, { 741, 133 }, { 874, 29 }, { 903, 7 }, + { 910, 30 }, { 940, 30 }, { 970, 11 }, { 981, 4 }, + { 985, 6 }, { 991, 7 }, { 998, 4 }, { 1002, 2 }, + { 1004, 20 } } }, + + { { { 0, 8 }, { 8, 13 }, { 21, 13 }, { 34, 11 }, + { 45, 13 }, { 58, 20 }, { 78, 18 }, { 96, 16 }, + { 112, 12 }, { 124, 17 }, { 141, 16 }, { 157, 13 }, + { 170, 10 }, { 180, 14 }, { 194, 13 }, { 207, 12 }, + { 219, 805 } } }, + + { { { 0, 239 }, { 239, 176 }, { 415, 42 }, { 457, 11 }, + { 468, 163 }, { 631, 145 }, { 776, 44 }, { 820, 13 }, + { 833, 39 }, { 872, 42 }, { 914, 19 }, { 933, 7 }, + { 940, 11 }, { 951, 13 }, { 964, 7 }, { 971, 4 }, + { 975, 49 } } }, + + { { { 0, 165 }, { 165, 145 }, { 310, 49 }, { 359, 16 }, + { 375, 138 }, { 513, 139 }, { 652, 55 }, { 707, 20 }, + { 727, 47 }, { 774, 54 }, { 828, 28 }, { 856, 12 }, + { 868, 16 }, { 884, 20 }, { 904, 12 }, { 916, 7 }, + { 923, 101 } } }, + + { { { 0, 3 }, { 3, 5 }, { 8, 5 }, { 13, 5 }, + { 18, 5 }, { 23, 7 }, { 30, 7 }, { 37, 7 }, + { 44, 4 }, { 48, 7 }, { 55, 7 }, { 62, 6 }, + { 68, 4 }, { 72, 6 }, { 78, 6 }, { 84, 6 }, + { 90, 934 } } }, + + { { { 0, 115 }, { 115, 122 }, { 237, 52 }, { 289, 22 }, + { 311, 111 }, { 422, 125 }, { 547, 61 }, { 608, 27 }, + { 635, 45 }, { 680, 57 }, { 737, 34 }, { 771, 17 }, + { 788, 19 }, { 807, 25 }, { 832, 17 }, { 849, 10 }, + { 859, 165 } } }, + + { { { 0, 107 }, { 107, 114 }, { 221, 51 }, { 272, 21 }, + { 293, 106 }, { 399, 122 }, { 521, 61 }, { 582, 28 }, + { 610, 46 }, { 656, 58 }, { 714, 35 }, { 749, 18 }, + { 767, 20 }, { 787, 26 }, { 813, 18 }, { 831, 11 }, + { 842, 182 } } }, + + { { { 0, 6 }, { 6, 10 }, { 16, 10 }, { 26, 9 }, + { 35, 10 }, { 45, 15 }, { 60, 15 }, { 75, 14 }, + { 89, 9 }, { 98, 14 }, { 112, 13 }, { 125, 12 }, + { 137, 8 }, { 145, 12 }, { 157, 11 }, { 168, 10 }, + { 178, 846 } } }, + + { { { 0, 72 }, { 72, 88 }, { 160, 50 }, { 210, 26 }, + { 236, 84 }, { 320, 102 }, { 422, 60 }, { 482, 32 }, + { 514, 41 }, { 555, 53 }, { 608, 36 }, { 644, 21 }, + { 665, 20 }, { 685, 27 }, { 712, 20 }, { 732, 13 }, + { 745, 279 } } }, + + { { { 0, 45 }, { 45, 63 }, { 108, 45 }, { 153, 30 }, + { 183, 61 }, { 244, 83 }, { 327, 58 }, { 385, 36 }, + { 421, 34 }, { 455, 47 }, { 502, 34 }, { 536, 23 }, + { 559, 19 }, { 578, 27 }, { 605, 21 }, { 626, 15 }, + { 641, 383 } } }, + + { { { 0, 1 }, { 1, 1 }, { 2, 7 }, { 9, 7 }, + { 16, 1 }, { 17, 1 }, { 18, 8 }, { 26, 8 }, + { 34, 6 }, { 40, 8 }, { 48, 7 }, { 55, 7 }, + { 62, 6 }, { 68, 7 }, { 75, 7 }, { 82, 6 }, + { 88, 936 } } }, + + { { { 0, 29 }, { 29, 44 }, { 73, 35 }, { 108, 24 }, + { 132, 42 }, { 174, 62 }, { 236, 48 }, { 284, 34 }, + { 318, 30 }, { 348, 43 }, { 391, 35 }, { 426, 26 }, + { 452, 19 }, { 471, 29 }, { 500, 24 }, { 524, 19 }, + { 543, 481 } } }, + + { { { 0, 20 }, { 20, 31 }, { 51, 25 }, { 76, 17 }, + { 93, 30 }, { 123, 43 }, { 166, 34 }, { 200, 25 }, + { 225, 22 }, { 247, 32 }, { 279, 26 }, { 305, 21 }, + { 326, 16 }, { 342, 23 }, { 365, 20 }, { 385, 16 }, + { 401, 623 } } }, + + { { { 0, 742 }, { 742, 103 }, { 845, 5 }, { 850, 1 }, + { 851, 108 }, { 959, 38 }, { 997, 4 }, { 1001, 1 }, + { 1002, 7 }, { 1009, 5 }, { 1014, 2 }, { 1016, 1 }, + { 1017, 2 }, { 1019, 1 }, { 1020, 1 }, { 1021, 1 }, + { 1022, 2 } } }, + + { { { 0, 42 }, { 42, 52 }, { 94, 27 }, { 121, 16 }, + { 137, 49 }, { 186, 58 }, { 244, 36 }, { 280, 23 }, + { 303, 27 }, { 330, 36 }, { 366, 26 }, { 392, 18 }, + { 410, 17 }, { 427, 24 }, { 451, 19 }, { 470, 14 }, + { 484, 540 } } }, + + { { { 0, 13 }, { 13, 20 }, { 33, 18 }, { 51, 15 }, + { 66, 19 }, { 85, 29 }, { 114, 26 }, { 140, 21 }, + { 161, 17 }, { 178, 25 }, { 203, 22 }, { 225, 18 }, + { 243, 13 }, { 256, 19 }, { 275, 17 }, { 292, 15 }, + { 307, 717 } } }, + + { { { 0, 501 }, { 501, 169 }, { 670, 19 }, { 689, 4 }, + { 693, 155 }, { 848, 88 }, { 936, 16 }, { 952, 4 }, + { 956, 19 }, { 975, 16 }, { 991, 6 }, { 997, 2 }, + { 999, 5 }, { 1004, 4 }, { 1008, 2 }, { 1010, 1 }, + { 1011, 13 } } }, + + { { { 0, 445 }, { 445, 136 }, { 581, 22 }, { 603, 6 }, + { 609, 158 }, { 767, 98 }, { 865, 23 }, { 888, 7 }, + { 895, 31 }, { 926, 28 }, { 954, 10 }, { 964, 4 }, + { 968, 9 }, { 977, 9 }, { 986, 5 }, { 991, 2 }, + { 993, 31 } } }, + + { { { 0, 285 }, { 285, 157 }, { 442, 37 }, { 479, 10 }, + { 489, 161 }, { 650, 129 }, { 779, 39 }, { 818, 12 }, + { 830, 40 }, { 870, 42 }, { 912, 18 }, { 930, 7 }, + { 937, 12 }, { 949, 14 }, { 963, 8 }, { 971, 4 }, + { 975, 49 } } }, + + { { { 0, 349 }, { 349, 179 }, { 528, 33 }, { 561, 8 }, + { 569, 162 }, { 731, 121 }, { 852, 31 }, { 883, 9 }, + { 892, 31 }, { 923, 30 }, { 953, 12 }, { 965, 5 }, + { 970, 8 }, { 978, 9 }, { 987, 5 }, { 992, 2 }, + { 994, 30 } } }, + + { { { 0, 199 }, { 199, 156 }, { 355, 47 }, { 402, 15 }, + { 417, 146 }, { 563, 137 }, { 700, 50 }, { 750, 17 }, + { 767, 44 }, { 811, 49 }, { 860, 24 }, { 884, 10 }, + { 894, 15 }, { 909, 17 }, { 926, 10 }, { 936, 6 }, + { 942, 82 } } }, + + { { { 0, 141 }, { 141, 134 }, { 275, 50 }, { 325, 18 }, + { 343, 128 }, { 471, 135 }, { 606, 58 }, { 664, 22 }, + { 686, 48 }, { 734, 57 }, { 791, 31 }, { 822, 14 }, + { 836, 18 }, { 854, 23 }, { 877, 14 }, { 891, 8 }, + { 899, 125 } } }, + + { { { 0, 243 }, { 243, 194 }, { 437, 56 }, { 493, 17 }, + { 510, 139 }, { 649, 126 }, { 775, 45 }, { 820, 16 }, + { 836, 33 }, { 869, 36 }, { 905, 18 }, { 923, 8 }, + { 931, 10 }, { 941, 12 }, { 953, 7 }, { 960, 4 }, + { 964, 60 } } }, + + { { { 0, 91 }, { 91, 106 }, { 197, 51 }, { 248, 23 }, + { 271, 99 }, { 370, 117 }, { 487, 63 }, { 550, 30 }, + { 580, 45 }, { 625, 59 }, { 684, 37 }, { 721, 20 }, + { 741, 20 }, { 761, 27 }, { 788, 19 }, { 807, 12 }, + { 819, 205 } } }, + + { { { 0, 107 }, { 107, 94 }, { 201, 41 }, { 242, 20 }, + { 262, 92 }, { 354, 97 }, { 451, 52 }, { 503, 28 }, + { 531, 42 }, { 573, 53 }, { 626, 34 }, { 660, 20 }, + { 680, 21 }, { 701, 29 }, { 730, 21 }, { 751, 14 }, + { 765, 259 } } }, + + { { { 0, 168 }, { 168, 171 }, { 339, 68 }, { 407, 25 }, + { 432, 121 }, { 553, 123 }, { 676, 55 }, { 731, 24 }, + { 755, 34 }, { 789, 41 }, { 830, 24 }, { 854, 12 }, + { 866, 13 }, { 879, 16 }, { 895, 11 }, { 906, 6 }, + { 912, 112 } } }, + + { { { 0, 67 }, { 67, 80 }, { 147, 44 }, { 191, 23 }, + { 214, 76 }, { 290, 94 }, { 384, 57 }, { 441, 31 }, + { 472, 41 }, { 513, 54 }, { 567, 37 }, { 604, 23 }, + { 627, 21 }, { 648, 30 }, { 678, 22 }, { 700, 15 }, + { 715, 309 } } }, + + { { { 0, 46 }, { 46, 63 }, { 109, 39 }, { 148, 23 }, + { 171, 58 }, { 229, 78 }, { 307, 52 }, { 359, 32 }, + { 391, 36 }, { 427, 49 }, { 476, 37 }, { 513, 24 }, + { 537, 21 }, { 558, 30 }, { 588, 24 }, { 612, 17 }, + { 629, 395 } } }, + + { { { 0, 848 }, { 848, 70 }, { 918, 2 }, { 920, 1 }, + { 921, 75 }, { 996, 16 }, { 1012, 1 }, { 1013, 1 }, + { 1014, 2 }, { 1016, 1 }, { 1017, 1 }, { 1018, 1 }, + { 1019, 1 }, { 1020, 1 }, { 1021, 1 }, { 1022, 1 }, + { 1023, 1 } } }, + + { { { 0, 36 }, { 36, 52 }, { 88, 35 }, { 123, 22 }, + { 145, 48 }, { 193, 67 }, { 260, 48 }, { 308, 32 }, + { 340, 32 }, { 372, 45 }, { 417, 35 }, { 452, 24 }, + { 476, 20 }, { 496, 29 }, { 525, 23 }, { 548, 17 }, + { 565, 459 } } }, + + { { { 0, 24 }, { 24, 37 }, { 61, 29 }, { 90, 20 }, + { 110, 35 }, { 145, 51 }, { 196, 41 }, { 237, 29 }, + { 266, 26 }, { 292, 38 }, { 330, 31 }, { 361, 24 }, + { 385, 18 }, { 403, 27 }, { 430, 23 }, { 453, 18 }, + { 471, 553 } } }, + + { { { 0, 85 }, { 85, 97 }, { 182, 48 }, { 230, 23 }, + { 253, 91 }, { 344, 110 }, { 454, 61 }, { 515, 30 }, + { 545, 45 }, { 590, 58 }, { 648, 37 }, { 685, 21 }, + { 706, 21 }, { 727, 29 }, { 756, 20 }, { 776, 13 }, + { 789, 235 } } }, + + { { { 0, 22 }, { 22, 33 }, { 55, 27 }, { 82, 20 }, + { 102, 33 }, { 135, 48 }, { 183, 39 }, { 222, 30 }, + { 252, 26 }, { 278, 37 }, { 315, 30 }, { 345, 23 }, + { 368, 17 }, { 385, 25 }, { 410, 21 }, { 431, 17 }, + { 448, 576 } } }, + + { { { 0, 1 }, { 1, 1 }, { 2, 54 }, { 56, 33 }, + { 89, 1 }, { 90, 1 }, { 91, 49 }, { 140, 32 }, + { 172, 49 }, { 221, 47 }, { 268, 35 }, { 303, 25 }, + { 328, 30 }, { 358, 30 }, { 388, 24 }, { 412, 18 }, + { 430, 594 } } }, + + { { { 0, 45 }, { 45, 64 }, { 109, 43 }, { 152, 25 }, + { 177, 62 }, { 239, 81 }, { 320, 56 }, { 376, 35 }, + { 411, 37 }, { 448, 51 }, { 499, 38 }, { 537, 26 }, + { 563, 22 }, { 585, 31 }, { 616, 24 }, { 640, 18 }, + { 658, 366 } } }, + + { { { 0, 247 }, { 247, 148 }, { 395, 38 }, { 433, 12 }, + { 445, 154 }, { 599, 130 }, { 729, 42 }, { 771, 14 }, + { 785, 44 }, { 829, 46 }, { 875, 21 }, { 896, 9 }, + { 905, 15 }, { 920, 17 }, { 937, 9 }, { 946, 5 }, + { 951, 73 } } }, + + { { { 0, 231 }, { 231, 136 }, { 367, 41 }, { 408, 15 }, + { 423, 134 }, { 557, 119 }, { 676, 47 }, { 723, 19 }, + { 742, 44 }, { 786, 49 }, { 835, 25 }, { 860, 12 }, + { 872, 17 }, { 889, 20 }, { 909, 12 }, { 921, 7 }, + { 928, 96 } } } + +}; + +const uint16_t lc3_spectrum_bits[][17] = { + + { 20480, 20480, 5220, 9042, 20480, 20480, 6619, 9892, + 5289, 6619, 9105, 11629, 8982, 9892, 11629, 13677, 4977 }, + + { 11940, 10854, 12109, 13677, 10742, 9812, 11090, 12288, + 11348, 10240, 11348, 12683, 12109, 10854, 11629, 12902, 1197 }, + + { 7886, 7120, 8982, 10970, 7496, 6815, 8334, 10150, + 9437, 8535, 9656, 11216, 11348, 10431, 11348, 12479, 4051 }, + + { 5485, 6099, 9168, 11940, 6311, 6262, 8640, 11090, + 9233, 8640, 10334, 12479, 11781, 11090, 12479, 13988, 6009 }, + + { 7886, 7804, 10150, 11940, 7886, 7685, 9368, 10854, + 10061, 9300, 10431, 11629, 11629, 10742, 11485, 12479, 2763 }, + + { 9042, 8383, 10240, 11781, 8483, 8013, 9437, 10742, + 10334, 9437, 10431, 11485, 11781, 10742, 11485, 12288, 2346 }, + + { 5922, 6619, 9368, 11940, 6566, 6539, 8750, 10970, + 9168, 8640, 10240, 12109, 11485, 10742, 11940, 13396, 5009 }, + + { 12288, 11090, 11348, 12109, 11090, 9892, 10334, 10970, + 11629, 10431, 10970, 11629, 12479, 11348, 11781, 12288, 1289 }, + + { 1685, 5676, 13138, 18432, 5598, 7804, 13677, 18432, + 12683, 13396, 17234, 20480, 17234, 17234, 20480, 20480, 15725 }, + + { 2793, 5072, 10970, 15725, 5204, 6487, 11216, 15186, + 10970, 11216, 14336, 17234, 15186, 15186, 17234, 18432, 12109 }, + + { 12902, 11485, 11940, 13396, 11629, 10531, 11348, 12479, + 12683, 11629, 12288, 13138, 13677, 12683, 13138, 13677, 854 }, + + { 3821, 5088, 9812, 13988, 5289, 5901, 9812, 13677, + 9976, 9892, 12479, 15186, 13988, 13677, 15186, 17234, 9812 }, + + { 4856, 5412, 9168, 12902, 5598, 5736, 8863, 12288, + 9368, 8982, 11090, 13677, 12902, 12288, 13677, 15725, 8147 }, + + { 20480, 20480, 7088, 9300, 20480, 20480, 7844, 9733, + 7320, 7928, 9368, 10970, 9581, 9892, 10970, 12288, 2550 }, + + { 6031, 5859, 8192, 10635, 6410, 6286, 8433, 10742, + 9656, 9042, 10531, 12479, 12479, 11629, 12902, 14336, 5756 }, + + { 6144, 6215, 8982, 11940, 6262, 6009, 8433, 11216, + 8982, 8433, 10240, 12479, 11781, 11090, 12479, 13988, 5817 }, + + { 20480, 20480, 11216, 12109, 20480, 20480, 11216, 11940, + 11629, 11485, 11940, 12479, 12479, 12109, 12683, 13138, 704 }, + + { 7928, 6994, 8239, 9733, 7218, 6539, 8147, 9892, + 9812, 9105, 10240, 11629, 12109, 11216, 12109, 13138, 4167 }, + + { 8640, 7724, 9233, 10970, 8013, 7185, 8483, 10150, + 9656, 8694, 9656, 10970, 11348, 10334, 11090, 12288, 3391 }, + + { 20480, 18432, 18432, 18432, 18432, 18432, 18432, 18432, + 18432, 18432, 18432, 18432, 18432, 18432, 18432, 18432, 91 }, + + { 10061, 8863, 9733, 11090, 8982, 7970, 8806, 9976, + 10061, 9105, 9812, 10742, 11485, 10334, 10970, 11781, 2557 }, + + { 10431, 9368, 10240, 11348, 9368, 8433, 9233, 10334, + 10431, 9437, 10061, 10970, 11781, 10635, 11216, 11940, 2119 }, + + { 13988, 12479, 12683, 12902, 12683, 11348, 11485, 11940, + 12902, 11629, 11940, 12288, 13396, 12109, 12479, 12683, 828 }, + + { 10431, 9300, 10334, 11629, 9508, 8483, 9437, 10635, + 10635, 9656, 10431, 11348, 11940, 10854, 11485, 12288, 1946 }, + + { 12479, 11216, 11629, 12479, 11348, 10150, 10635, 11348, + 11940, 10854, 11216, 11940, 12902, 11629, 11940, 12479, 1146 }, + + { 13396, 12109, 12288, 12902, 12109, 10854, 11216, 11781, + 12479, 11348, 11629, 12109, 13138, 11940, 12288, 12683, 928 }, + + { 2443, 5289, 11629, 16384, 5170, 6730, 11940, 16384, + 11216, 11629, 14731, 18432, 15725, 15725, 18432, 20480, 13396 }, + + { 3328, 5009, 10531, 15186, 5040, 6031, 10531, 14731, + 10431, 10431, 13396, 16384, 15186, 14731, 16384, 18432, 11629 }, + + { 14336, 12902, 12902, 13396, 12902, 11629, 11940, 12288, + 13138, 12109, 12288, 12902, 13677, 12683, 12902, 13138, 711 }, + + { 4300, 5204, 9437, 13396, 5430, 5776, 9300, 12902, + 9656, 9437, 11781, 14731, 13396, 12902, 14731, 16384, 8982 }, + + { 5394, 5776, 8982, 12288, 5922, 5901, 8640, 11629, + 9105, 8694, 10635, 13138, 12288, 11629, 13138, 14731, 6844 }, + + { 17234, 15725, 15725, 15725, 15725, 14731, 14731, 14731, + 16384, 14731, 14731, 15186, 16384, 15186, 15186, 15186, 272 }, + + { 6461, 6286, 8806, 11348, 6566, 6215, 8334, 10742, + 9233, 8535, 10061, 12109, 11781, 10970, 12109, 13677, 5394 }, + + { 6674, 6487, 8863, 11485, 6702, 6286, 8334, 10635, + 9168, 8483, 9976, 11940, 11629, 10854, 11940, 13396, 5105 }, + + { 15186, 13677, 13677, 13988, 13677, 12479, 12479, 12683, + 13988, 12683, 12902, 13138, 14336, 13138, 13396, 13677, 565 }, + + { 7844, 7252, 8922, 10854, 7389, 6815, 8383, 10240, + 9508, 8750, 9892, 11485, 11629, 10742, 11629, 12902, 3842 }, + + { 9233, 8239, 9233, 10431, 8334, 7424, 8483, 9892, + 10061, 9105, 10061, 11216, 11781, 10742, 11485, 12479, 2906 }, + + { 20480, 20480, 14731, 14731, 20480, 20480, 14336, 14336, + 15186, 14336, 14731, 14731, 15186, 14731, 14731, 15186, 266 }, + + { 10531, 9300, 9976, 11090, 9437, 8286, 9042, 10061, + 10431, 9368, 9976, 10854, 11781, 10531, 11090, 11781, 2233 }, + + { 11629, 10334, 10970, 12109, 10431, 9368, 10061, 10970, + 11348, 10240, 10854, 11485, 12288, 11216, 11629, 12288, 1469 }, + + { 952, 6787, 15725, 20480, 6646, 9733, 16384, 20480, + 14731, 15725, 18432, 20480, 18432, 20480, 20480, 20480, 18432 }, + + { 9437, 8806, 10742, 12288, 8982, 8483, 9892, 11216, + 10742, 9892, 10854, 11940, 12109, 11090, 11781, 12683, 1891 }, + + { 12902, 11629, 11940, 12479, 11781, 10531, 10854, 11485, + 12109, 10970, 11348, 11940, 12902, 11781, 12109, 12479, 1054 }, + + { 2113, 5323, 11781, 16384, 5579, 7252, 12288, 16384, + 11781, 12288, 15186, 18432, 15725, 16384, 18432, 20480, 12902 }, + + { 2463, 5965, 11348, 15186, 5522, 6934, 11216, 14731, + 10334, 10635, 13677, 16384, 13988, 13988, 15725, 18432, 10334 }, + + { 3779, 5541, 9812, 13677, 5467, 6122, 9656, 13138, + 9581, 9437, 11940, 14731, 13138, 12683, 14336, 16384, 8982 }, + + { 3181, 5154, 10150, 14336, 5448, 6311, 10334, 13988, + 10334, 10431, 13138, 15725, 14336, 13988, 15725, 18432, 10431 }, + + { 4841, 5560, 9105, 12479, 5756, 5944, 8922, 12109, + 9300, 8982, 11090, 13677, 12479, 12109, 13677, 15186, 7460 }, + + { 5859, 6009, 8922, 11940, 6144, 5987, 8483, 11348, + 9042, 8535, 10334, 12683, 11940, 11216, 12683, 14336, 6215 }, + + { 4250, 4916, 8587, 12109, 5901, 6191, 9233, 12288, + 10150, 9892, 11940, 14336, 13677, 13138, 14731, 16384, 8383 }, + + { 7153, 6702, 8863, 11216, 6904, 6410, 8239, 10431, + 9233, 8433, 9812, 11629, 11629, 10742, 11781, 13138, 4753 }, + + { 6674, 7057, 9508, 11629, 7120, 6964, 8806, 10635, + 9437, 8750, 10061, 11629, 11485, 10531, 11485, 12683, 4062 }, + + { 5341, 5289, 8013, 10970, 6311, 6262, 8640, 11090, + 10061, 9508, 11090, 13138, 12902, 12288, 13396, 15186, 6539 }, + + { 8057, 7533, 9300, 11216, 7685, 7057, 8535, 10334, + 9508, 8694, 9812, 11216, 11485, 10431, 11348, 12479, 3541 }, + + { 9168, 8239, 9656, 11216, 8483, 7608, 8806, 10240, + 9892, 8982, 9812, 11090, 11485, 10431, 11090, 12109, 2815 }, + + { 558, 7928, 18432, 20480, 7724, 12288, 20480, 20480, + 18432, 20480, 20480, 20480, 20480, 20480, 20480, 20480, 20480 }, + + { 9892, 8806, 9976, 11348, 9042, 8057, 9042, 10240, + 10240, 9233, 9976, 11090, 11629, 10531, 11216, 12109, 2371 }, + + { 11090, 9812, 10531, 11629, 9976, 8863, 9508, 10531, + 10854, 9733, 10334, 11090, 11940, 10742, 11216, 11940, 1821 }, + + { 7354, 6964, 9042, 11216, 7153, 6592, 8334, 10431, + 9233, 8483, 9812, 11485, 11485, 10531, 11629, 12902, 4349 }, + + { 11348, 10150, 10742, 11629, 10150, 9042, 9656, 10431, + 10854, 9812, 10431, 11216, 12109, 10970, 11485, 12109, 1700 }, + + { 20480, 20480, 8694, 10150, 20480, 20480, 8982, 10240, + 8982, 9105, 9976, 10970, 10431, 10431, 11090, 11940, 1610 }, + + { 9233, 8192, 9368, 10970, 8286, 7496, 8587, 9976, + 9812, 8863, 9733, 10854, 11348, 10334, 11090, 11940, 3040 }, + + { 4202, 5716, 9733, 13138, 5598, 6099, 9437, 12683, + 9300, 9168, 11485, 13988, 12479, 12109, 13988, 15725, 7804 }, + + { 4400, 5965, 9508, 12479, 6009, 6360, 9105, 11781, + 9300, 8982, 10970, 13138, 12109, 11629, 13138, 14731, 6994 } + +}; diff --git a/App_Resources/iOS/src/lc3/tables.h b/App_Resources/iOS/src/lc3/tables.h new file mode 100644 index 00000000..2dc7810c --- /dev/null +++ b/App_Resources/iOS/src/lc3/tables.h @@ -0,0 +1,161 @@ +/****************************************************************************** + * + * Copyright 2022 Google LLC + * + * 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. + * + ******************************************************************************/ + +#ifndef __LC3_TABLES_H +#define __LC3_TABLES_H + +#include "common.h" +#include "bits.h" + + +/** + * Characteristics + * + * ns Number of temporal samples / frequency coefficients within a frame + * + * ne Number of encoded frequency coefficients + * + * nd Number of MDCT delayed samples, sum of half a frame and an ovelap + * of future by 1.25 ms (2.5ms, 5ms and 10ms frame durations), + * or 2 ms (7.5ms frame duration). + * + * nh Number of 18 ms samples of the history buffer, aligned on a frame + * + * nt Number of 1.25 ms previous samples + */ + +extern const int lc3_ns_2m5[LC3_NUM_SRATE]; +extern const int lc3_ne_2m5[LC3_NUM_SRATE]; +extern const int lc3_ns_4m [LC3_NUM_SRATE]; + +static inline int lc3_ns(enum lc3_dt dt, enum lc3_srate sr) { + return lc3_ns_2m5[sr] * (1 + dt); +} + +static inline int lc3_ne(enum lc3_dt dt, enum lc3_srate sr) { + return lc3_ne_2m5[sr] * (1 + dt); +} + +static inline int lc3_nd(enum lc3_dt dt, enum lc3_srate sr) { + return ( lc3_ns(dt, sr) + + (dt == LC3_DT_7M5 ? lc3_ns_4m[sr] : lc3_ns_2m5[sr]) ) >> 1; +} + +static inline int lc3_nh(enum lc3_dt dt, enum lc3_srate sr) { + return sr > LC3_SRATE_48K_HR ? 0 : + (8 + (dt == LC3_DT_7M5)) * lc3_ns_2m5[sr]; +} + +static inline int lc3_nt(enum lc3_srate sr) { + return lc3_ns_2m5[sr] >> 1; +} + +#define LC3_MAX_SRATE_HZ ( LC3_PLUS_HR ? 96000 : 48000 ) + +#define LC3_MAX_NS ( LC3_NS(10000, LC3_MAX_SRATE_HZ) ) +#define LC3_MAX_NE ( LC3_PLUS_HR ? LC3_MAX_NS : LC3_NS(10000, 40000) ) + + +/** + * Limits on size of frame + */ + +extern const int lc3_frame_bytes_hr_lim + [LC3_NUM_DT][LC3_NUM_SRATE - LC3_SRATE_48K_HR][2]; + +static inline int lc3_min_frame_bytes(enum lc3_dt dt, enum lc3_srate sr) { + return !lc3_hr(sr) ? LC3_MIN_FRAME_BYTES : + lc3_frame_bytes_hr_lim[dt][sr - LC3_SRATE_48K_HR][0]; +} + +static inline int lc3_max_frame_bytes(enum lc3_dt dt, enum lc3_srate sr) { + return !lc3_hr(sr) ? LC3_MAX_FRAME_BYTES : + lc3_frame_bytes_hr_lim[dt][sr - LC3_SRATE_48K_HR][1]; +} + + +/** + * MDCT Twiddles and window coefficients + */ + +struct lc3_fft_bf3_twiddles { int n3; const struct lc3_complex (*t)[2]; }; +struct lc3_fft_bf2_twiddles { int n2; const struct lc3_complex *t; }; +struct lc3_mdct_rot_def { int n4; const struct lc3_complex *w; }; + +extern const struct lc3_fft_bf3_twiddles *lc3_fft_twiddles_bf3[]; +extern const struct lc3_fft_bf2_twiddles *lc3_fft_twiddles_bf2[][3]; +extern const struct lc3_mdct_rot_def *lc3_mdct_rot[LC3_NUM_DT][LC3_NUM_SRATE]; + +extern const float *lc3_mdct_win[LC3_NUM_DT][LC3_NUM_SRATE]; + + +/** + * Limits of bands + */ + +#define LC3_MAX_BANDS 64 + +extern const int lc3_num_bands[LC3_NUM_DT][LC3_NUM_SRATE]; +extern const int *lc3_band_lim[LC3_NUM_DT][LC3_NUM_SRATE]; + + +/** + * SNS Quantization + */ + +extern const float lc3_sns_lfcb[32][8]; +extern const float lc3_sns_hfcb[32][8]; + +struct lc3_sns_vq_gains { + int count; const float *v; +}; + +extern const struct lc3_sns_vq_gains lc3_sns_vq_gains[4]; + +extern const int32_t lc3_sns_mpvq_offsets[][11]; + + +/** + * TNS Arithmetic Coding + */ + +extern const struct lc3_ac_model lc3_tns_order_models[]; +extern const uint16_t lc3_tns_order_bits[][8]; + +extern const struct lc3_ac_model lc3_tns_coeffs_models[]; +extern const uint16_t lc3_tns_coeffs_bits[][17]; + + +/** + * Long Term Postfilter + */ + +extern const float *lc3_ltpf_cnum[LC3_NUM_SRATE][4]; +extern const float *lc3_ltpf_cden[LC3_NUM_SRATE][4]; + + +/** + * Spectral Data Arithmetic Coding + */ + +extern const uint8_t lc3_spectrum_lookup[2][2][256][4]; +extern const struct lc3_ac_model lc3_spectrum_models[]; +extern const uint16_t lc3_spectrum_bits[][17]; + + +#endif /* __LC3_TABLES_H */ diff --git a/App_Resources/iOS/src/lc3/tns.c b/App_Resources/iOS/src/lc3/tns.c new file mode 100644 index 00000000..b2b9305e --- /dev/null +++ b/App_Resources/iOS/src/lc3/tns.c @@ -0,0 +1,510 @@ +/****************************************************************************** + * + * Copyright 2022 Google LLC + * + * 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 "tns.h" +#include "tables.h" + + +/* ---------------------------------------------------------------------------- + * Filter Coefficients + * -------------------------------------------------------------------------- */ + +/** + * Resolve LPC Weighting indication according bitrate + * dt, nbytes Duration and size of the frame + * return True when LPC Weighting enabled + */ +static bool resolve_lpc_weighting(enum lc3_dt dt, int nbytes) +{ + return nbytes * 8 < 120 * (int)(1 + dt); +} + +/** + * Return dot product of 2 vectors + * a, b, n The 2 vectors of size `n` + * return sum( a[i] * b[i] ), i = [0..n-1] + */ +LC3_HOT static inline float dot(const float *a, const float *b, int n) +{ + float v = 0; + + while (n--) + v += *(a++) * *(b++); + + return v; +} + +/** + * LPC Coefficients + * dt, bw Duration and bandwidth of the frame + * maxorder Maximum order of filter + * x Spectral coefficients + * gain, a Output the prediction gains and LPC coefficients + */ +LC3_HOT static void compute_lpc_coeffs( + enum lc3_dt dt, enum lc3_bandwidth bw, int maxorder, + const float *x, float *gain, float (*a)[9]) +{ + +#if LC3_PLUS + + static const int sub_2m5_nb[] = { 3, 10, 20 }; + static const int sub_2m5_wb[] = { 3, 20, 40 }; + static const int sub_2m5_sswb[] = { 3, 30, 60 }; + static const int sub_2m5_swb[] = { 3, 40, 80 }; + static const int sub_2m5_fb[] = { 3, 51, 100 }; + + static const int sub_5m_nb[] = { 6, 23, 40 }; + static const int sub_5m_wb[] = { 6, 43, 80 }; + static const int sub_5m_sswb[] = { 6, 63, 120 }; + static const int sub_5m_swb[] = { 6, 43, 80, 120, 160 }; + static const int sub_5m_fb[] = { 6, 53, 100, 150, 200 }; + +#endif /* LC3_PLUS */ + + static const int sub_7m5_nb[] = { 9, 26, 43, 60 }; + static const int sub_7m5_wb[] = { 9, 46, 83, 120 }; + static const int sub_7m5_sswb[] = { 9, 66, 123, 180 }; + static const int sub_7m5_swb[] = { 9, 46, 82, 120, 159, 200, 240 }; + static const int sub_7m5_fb[] = { 9, 56, 103, 150, 200, 250, 300 }; + + static const int sub_10m_nb[] = { 12, 34, 57, 80 }; + static const int sub_10m_wb[] = { 12, 61, 110, 160 }; + static const int sub_10m_sswb[] = { 12, 88, 164, 240 }; + static const int sub_10m_swb[] = { 12, 61, 110, 160, 213, 266, 320 }; + static const int sub_10m_fb[] = { 12, 74, 137, 200, 266, 333, 400 }; + + static const float lag_window[] = { + 1.00000000e+00, 9.98028026e-01, 9.92135406e-01, 9.82391584e-01, + 9.68910791e-01, 9.51849807e-01, 9.31404933e-01, 9.07808230e-01, + 8.81323137e-01 + }; + + const int *sub = (const int * const [LC3_NUM_DT][LC3_NUM_BANDWIDTH]){ + +#if LC3_PLUS + + [LC3_DT_2M5] = { + sub_2m5_nb, sub_2m5_wb, sub_2m5_sswb, sub_2m5_swb, + sub_2m5_fb, sub_2m5_fb, sub_2m5_fb }, + + [LC3_DT_5M] = { + sub_5m_nb , sub_5m_wb , sub_5m_sswb , sub_5m_swb , + sub_5m_fb , sub_5m_fb , sub_5m_fb }, + +#endif /* LC3_PLUS */ + + [LC3_DT_7M5] = { + sub_7m5_nb, sub_7m5_wb, sub_7m5_sswb, sub_7m5_swb, + sub_7m5_fb }, + + [LC3_DT_10M] = { + sub_10m_nb, sub_10m_wb, sub_10m_sswb, sub_10m_swb, + sub_10m_fb, sub_10m_fb, sub_10m_fb }, + + }[dt][bw]; + + /* --- Normalized autocorrelation --- */ + + int nfilters = 1 + (dt >= LC3_DT_5M && bw >= LC3_BANDWIDTH_SWB); + int nsubdivisions = 2 + (dt >= LC3_DT_7M5); + + const float *xs, *xe = x + *sub; + float r[2][9]; + + for (int f = 0; f < nfilters; f++) { + float c[9][3] = { 0 }; + + for (int s = 0; s < nsubdivisions; s++) { + xs = xe, xe = x + *(++sub); + + for (int k = 0; k <= maxorder; k++) + c[k][s] = dot(xs, xs + k, (xe - xs) - k); + } + + r[f][0] = nsubdivisions; + if (nsubdivisions == 2) { + float e0 = c[0][0], e1 = c[0][1]; + for (int k = 1; k <= maxorder; k++) + r[f][k] = e0 == 0 || e1 == 0 ? 0 : + (c[k][0]/e0 + c[k][1]/e1) * lag_window[k]; + + } else { + float e0 = c[0][0], e1 = c[0][1], e2 = c[0][2]; + for (int k = 1; k <= maxorder; k++) + r[f][k] = e0 == 0 || e1 == 0 || e2 == 0 ? 0 : + (c[k][0]/e0 + c[k][1]/e1 + c[k][2]/e2) * lag_window[k]; + } + } + + /* --- Levinson-Durbin recursion --- */ + + for (int f = 0; f < nfilters; f++) { + float *a0 = a[f], a1[9]; + float err = r[f][0], rc; + + gain[f] = err; + + a0[0] = 1; + for (int k = 1; k <= maxorder; ) { + + rc = -r[f][k]; + for (int i = 1; i < k; i++) + rc -= a0[i] * r[f][k-i]; + + rc /= err; + err *= 1 - rc * rc; + + for (int i = 1; i < k; i++) + a1[i] = a0[i] + rc * a0[k-i]; + a1[k++] = rc; + + rc = -r[f][k]; + for (int i = 1; i < k; i++) + rc -= a1[i] * r[f][k-i]; + + rc /= err; + err *= 1 - rc * rc; + + for (int i = 1; i < k; i++) + a0[i] = a1[i] + rc * a1[k-i]; + a0[k++] = rc; + } + + gain[f] /= err; + } +} + +/** + * LPC Weighting + * gain, a Prediction gain and LPC coefficients, weighted as output + */ +LC3_HOT static void lpc_weighting(float pred_gain, float *a) +{ + float gamma = 1.f - (1.f - 0.85f) * (2.f - pred_gain) / (2.f - 1.5f); + float g = 1.f; + + for (int i = 1; i < 9; i++) + a[i] *= (g *= gamma); +} + +/** + * LPC reflection + * a, maxorder LPC coefficients, and maximum order (4 or 8) + * rc Output refelection coefficients + */ +LC3_HOT static void lpc_reflection( + const float *a, int maxorder, float *rc) +{ + float e, b[2][7], *b0, *b1; + + rc[maxorder-1] = a[maxorder]; + e = 1 - rc[maxorder-1] * rc[maxorder-1]; + + b1 = b[1]; + for (int i = 0; i < maxorder-1; i++) + b1[i] = (a[1+i] - rc[maxorder-1] * a[(maxorder-1)-i]) / e; + + for (int k = maxorder-2; k > 0; k--) { + b0 = b1, b1 = b[k & 1]; + + rc[k] = b0[k]; + e = 1 - rc[k] * rc[k]; + + for (int i = 0; i < k; i++) + b1[i] = (b0[i] - rc[k] * b0[k-1-i]) / e; + } + + rc[0] = b1[0]; +} + +/** + * Quantization of RC coefficients + * rc, maxorder Refelection coefficients, and maximum order (4 or 8) + * order Return order of coefficients + * rc_i Return quantized coefficients + */ +static void quantize_rc(const float *rc, int maxorder, int *order, int *rc_q) +{ + /* Quantization table, sin(delta * (i + 0.5)), delta = Pi / 17, + * rounded to fixed point Q15 value (LC3-Plus HR requirements). */ + + static float q_thr[] = { + 0x0bcfp-15, 0x2307p-15, 0x390ep-15, 0x4d23p-15, + 0x5e98p-15, 0x6cd4p-15, 0x775bp-15, 0x7dd2p-15, + }; + + *order = maxorder; + + for (int i = 0; i < maxorder; i++) { + float rc_m = fabsf(rc[i]); + + rc_q[i] = 4 * (rc_m >= q_thr[4]); + for (int j = 0; j < 4 && rc_m >= q_thr[rc_q[i]]; j++, rc_q[i]++); + + if (rc[i] < 0) + rc_q[i] = -rc_q[i]; + + *order = rc_q[i] != 0 ? maxorder : *order - 1; + } +} + +/** + * Unquantization of RC coefficients + * rc_q, order Quantized coefficients, and order + * rc Return refelection coefficients + */ +static void unquantize_rc(const int *rc_q, int order, float rc[8]) +{ + /* Quantization table, sin(delta * i), delta = Pi / 17, + * rounded to fixed point Q15 value (LC3-Plus HR requirements). */ + + static float q_inv[] = { + 0x0000p-15, 0x1785p-15, 0x2e3dp-15, 0x4362p-15, + 0x563cp-15, 0x6625p-15, 0x7295p-15, 0x7b1dp-15, 0x7f74p-15, + }; + + int i; + + for (i = 0; i < order; i++) { + float rc_m = q_inv[LC3_ABS(rc_q[i])]; + rc[i] = rc_q[i] < 0 ? -rc_m : rc_m; + } +} + + +/* ---------------------------------------------------------------------------- + * Filtering + * -------------------------------------------------------------------------- */ + +/** + * Forward filtering + * dt, bw Duration and bandwidth of the frame + * rc_order, rc Order of coefficients, and coefficients + * x Spectral coefficients, filtered as output + */ +LC3_HOT static void forward_filtering( + enum lc3_dt dt, enum lc3_bandwidth bw, + const int rc_order[2], float (* const rc)[8], float *x) +{ + int nfilters = 1 + (dt >= LC3_DT_5M && bw >= LC3_BANDWIDTH_SWB); + int nf = lc3_ne(dt, (enum lc3_srate)LC3_MIN(bw, LC3_BANDWIDTH_FB)) + >> (nfilters - 1); + int i0, ie = 3*(1 + dt); + + float s[8] = { 0 }; + + for (int f = 0; f < nfilters; f++) { + + i0 = ie; + ie = nf * (1 + f); + + if (!rc_order[f]) + continue; + + for (int i = i0; i < ie; i++) { + float xi = x[i]; + float s0, s1 = xi; + + for (int k = 0; k < rc_order[f]; k++) { + s0 = s[k]; + s[k] = s1; + + s1 = rc[f][k] * xi + s0; + xi += rc[f][k] * s0; + } + + x[i] = xi; + } + } +} + +/** + * Inverse filtering + * dt, bw Duration and bandwidth of the frame + * rc_order, rc Order of coefficients, and unquantized coefficients + * x Spectral coefficients, filtered as output + */ +LC3_HOT static void inverse_filtering( + enum lc3_dt dt, enum lc3_bandwidth bw, + const int rc_order[2], float (* const rc)[8], float *x) +{ + int nfilters = 1 + (dt >= LC3_DT_5M && bw >= LC3_BANDWIDTH_SWB); + int nf = lc3_ne(dt, (enum lc3_srate)LC3_MIN(bw, LC3_BANDWIDTH_FB)) + >> (nfilters - 1); + int i0, ie = 3*(1 + dt); + + float s[8] = { 0 }; + + for (int f = 0; f < nfilters; f++) { + + i0 = ie; + ie = nf * (1 + f); + + if (!rc_order[f]) + continue; + + for (int i = i0; i < ie; i++) { + float xi = x[i]; + + xi -= s[7] * rc[f][7]; + for (int k = 6; k >= 0; k--) { + xi -= s[k] * rc[f][k]; + s[k+1] = s[k] + rc[f][k] * xi; + } + s[0] = xi; + x[i] = xi; + } + + for (int k = 7; k >= rc_order[f]; k--) + s[k] = 0; + } +} + + +/* ---------------------------------------------------------------------------- + * Interface + * -------------------------------------------------------------------------- */ + +/** + * TNS analysis + */ +void lc3_tns_analyze(enum lc3_dt dt, enum lc3_bandwidth bw, + bool nn_flag, int nbytes, struct lc3_tns_data *data, float *x) +{ + /* Processing steps : + * - Determine the LPC (Linear Predictive Coding) Coefficients + * - Check is the filtering is disabled + * - The coefficients are weighted on low bitrates and predicition gain + * - Convert to reflection coefficients and quantize + * - Finally filter the spectral coefficients */ + + float pred_gain[2], a[2][9]; + float rc[2][8]; + + data->lpc_weighting = resolve_lpc_weighting(dt, nbytes); + data->nfilters = 1 + (dt >= LC3_DT_5M && bw >= LC3_BANDWIDTH_SWB); + int maxorder = dt <= LC3_DT_5M ? 4 : 8; + + compute_lpc_coeffs(dt, bw, maxorder, x, pred_gain, a); + + for (int f = 0; f < data->nfilters; f++) { + + data->rc_order[f] = 0; + if (nn_flag || pred_gain[f] <= 1.5f) + continue; + + if (data->lpc_weighting && pred_gain[f] < 2.f) + lpc_weighting(pred_gain[f], a[f]); + + lpc_reflection(a[f], maxorder, rc[f]); + + quantize_rc(rc[f], maxorder, &data->rc_order[f], data->rc[f]); + unquantize_rc(data->rc[f], data->rc_order[f], rc[f]); + } + + forward_filtering(dt, bw, data->rc_order, rc, x); +} + +/** + * TNS synthesis + */ +void lc3_tns_synthesize(enum lc3_dt dt, enum lc3_bandwidth bw, + const struct lc3_tns_data *data, float *x) +{ + float rc[2][8] = { 0 }; + + for (int f = 0; f < data->nfilters; f++) + if (data->rc_order[f]) + unquantize_rc(data->rc[f], data->rc_order[f], rc[f]); + + inverse_filtering(dt, bw, data->rc_order, rc, x); +} + +/** + * Bit consumption of bitstream data + */ +int lc3_tns_get_nbits(const struct lc3_tns_data *data) +{ + int nbits = 0; + + for (int f = 0; f < data->nfilters; f++) { + + int nbits_2048 = 2048; + int rc_order = data->rc_order[f]; + + nbits_2048 += rc_order > 0 ? lc3_tns_order_bits + [data->lpc_weighting][rc_order-1] : 0; + + for (int i = 0; i < rc_order; i++) + nbits_2048 += lc3_tns_coeffs_bits[i][8 + data->rc[f][i]]; + + nbits += (nbits_2048 + (1 << 11) - 1) >> 11; + } + + return nbits; +} + +/** + * Put bitstream data + */ +void lc3_tns_put_data(lc3_bits_t *bits, const struct lc3_tns_data *data) +{ + for (int f = 0; f < data->nfilters; f++) { + int rc_order = data->rc_order[f]; + + lc3_put_bits(bits, rc_order > 0, 1); + if (rc_order <= 0) + continue; + + lc3_put_symbol(bits, + lc3_tns_order_models + data->lpc_weighting, rc_order-1); + + for (int i = 0; i < rc_order; i++) + lc3_put_symbol(bits, + lc3_tns_coeffs_models + i, 8 + data->rc[f][i]); + } +} + +/** + * Get bitstream data + */ +int lc3_tns_get_data(lc3_bits_t *bits, + enum lc3_dt dt, enum lc3_bandwidth bw, int nbytes, lc3_tns_data_t *data) +{ + data->nfilters = 1 + (dt >= LC3_DT_5M && bw >= LC3_BANDWIDTH_SWB); + data->lpc_weighting = resolve_lpc_weighting(dt, nbytes); + + for (int f = 0; f < data->nfilters; f++) { + + data->rc_order[f] = lc3_get_bit(bits); + if (!data->rc_order[f]) + continue; + + data->rc_order[f] += lc3_get_symbol(bits, + lc3_tns_order_models + data->lpc_weighting); + if (dt <= LC3_DT_5M && data->rc_order[f] > 4) + return -1; + + for (int i = 0; i < data->rc_order[f]; i++) + data->rc[f][i] = (int)lc3_get_symbol(bits, + lc3_tns_coeffs_models + i) - 8; + } + + return 0; +} diff --git a/App_Resources/iOS/src/lc3/tns.h b/App_Resources/iOS/src/lc3/tns.h new file mode 100644 index 00000000..95d4e672 --- /dev/null +++ b/App_Resources/iOS/src/lc3/tns.h @@ -0,0 +1,93 @@ +/****************************************************************************** + * + * Copyright 2022 Google LLC + * + * 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. + * + ******************************************************************************/ + +#ifndef __LC3_TNS_H +#define __LC3_TNS_H + +#include "common.h" +#include "bits.h" + + +/** + * Bitstream data + */ + +typedef struct lc3_tns_data { + int nfilters; + bool lpc_weighting; + int rc_order[2]; + int rc[2][8]; +} lc3_tns_data_t; + + +/* ---------------------------------------------------------------------------- + * Encoding + * -------------------------------------------------------------------------- */ + +/** + * TNS analysis + * dt, bw Duration and bandwidth of the frame + * nn_flag True when high energy detected near Nyquist frequency + * nbytes Size in bytes of the frame + * data Return bitstream data + * x Spectral coefficients, filtered as output + */ +void lc3_tns_analyze(enum lc3_dt dt, enum lc3_bandwidth bw, + bool nn_flag, int nbytes, lc3_tns_data_t *data, float *x); + +/** + * Return number of bits coding the data + * data Bitstream data + * return Bit consumption + */ +int lc3_tns_get_nbits(const lc3_tns_data_t *data); + +/** + * Put bitstream data + * bits Bitstream context + * data Bitstream data + */ +void lc3_tns_put_data(lc3_bits_t *bits, const lc3_tns_data_t *data); + + +/* ---------------------------------------------------------------------------- + * Decoding + * -------------------------------------------------------------------------- */ + +/** + * Get bitstream data + * bits Bitstream context + * dt, bw Duration and bandwidth of the frame + * nbytes Size in bytes of the frame + * data Bitstream data + * return 0: Ok -1: Invalid bitstream data + */ +int lc3_tns_get_data(lc3_bits_t *bits, + enum lc3_dt dt, enum lc3_bandwidth bw, int nbytes, lc3_tns_data_t *data); + +/** + * TNS synthesis + * dt, bw Duration and bandwidth of the frame + * data Bitstream data + * x Spectral coefficients, filtered as output + */ +void lc3_tns_synthesize(enum lc3_dt dt, enum lc3_bandwidth bw, + const lc3_tns_data_t *data, float *x); + + +#endif /* __LC3_TNS_H */ diff --git a/App_Resources/iOS/src/module.modulemap b/App_Resources/iOS/src/module.modulemap index e1c2c706..abe55cd1 100644 --- a/App_Resources/iOS/src/module.modulemap +++ b/App_Resources/iOS/src/module.modulemap @@ -1,6 +1,9 @@ module FaceclawGraphics { header "FaceclawGraphics.h" + header "FaceclawFontRenderer.h" header "FaceclawBluetooth.h" header "FaceclawSocket.h" + header "FaceclawLc3Decoder.h" + header "FaceclawSpeech.h" export * } diff --git a/app/apps/files/files-app.ts b/app/apps/files/files-app.ts index 60b53725..540be7d2 100644 --- a/app/apps/files/files-app.ts +++ b/app/apps/files/files-app.ts @@ -45,7 +45,7 @@ export type FilesAppOptions = InProcessAppOptions & { export function createFilesAppWindow(options: FilesAppOptions): InProcessWindow { let created: InProcessWindow | null = null; const browser = new FileBrowserLayer({ - isSupportedFile: (name) => TEXT_FILE.test(name) || (!global.isIOS && (isDecodableImageFile(name) || EHPK_FILE.test(name) || isFontFile(name))), + isSupportedFile: (name) => TEXT_FILE.test(name) || isFontFile(name) || (!global.isIOS && (isDecodableImageFile(name) || EHPK_FILE.test(name))), // The browser handles double-click itself (up a level), so it is not // wrapped in YieldAtRootLayer; it yields explicitly from the top level. onLeave: () => shell.yieldFocusToSidebar(), @@ -170,7 +170,7 @@ function confirmEhpkPermissions(ctx: LayerContext, entry: DirectoryEntry, procee * window for viewable types, empty for everything else (metadata only). */ function fileOpenActions(entry: DirectoryEntry, options: FilesAppOptions): FileInfoAction[] { - if (global.isIOS && !TEXT_FILE.test(entry.name)) return []; + if (global.isIOS && !TEXT_FILE.test(entry.name) && !isFontFile(entry.name)) return []; if (TEXT_FILE.test(entry.name)) { return [ { diff --git a/app/apps/files/font-previewer.ts b/app/apps/files/font-previewer.ts index 46a4aea2..a486497a 100644 --- a/app/apps/files/font-previewer.ts +++ b/app/apps/files/font-previewer.ts @@ -27,7 +27,7 @@ const PARAGRAPH = /** * Font previewer for a font file on disk (TTF/OTF/TTC), rendered through the - * Android text stack: a single-line pangram, a character-set sample, and a + * native text stack: a single-line pangram, a character-set sample, and a * wrapped paragraph, all at an adjustable pixel size. Scroll changes size, * click cycles the coverage gamma (for judging antialiasing on the lens), * double-click closes. Sized to its hosting stack (a Files document window, diff --git a/app/g2/ble-protocol.ts b/app/g2/ble-protocol.ts index a85c2219..4465ea9e 100644 --- a/app/g2/ble-protocol.ts +++ b/app/g2/ble-protocol.ts @@ -21,6 +21,7 @@ const wrap = (command: number, magic: number, field: number, body: Uint8Array) = export const authentication = (magic: number) => wrap(4, magic, 3, concat(integer(1, 1), integer(2, 4))) export const prelude = () => wrap(2, 156, 4, bytes(3, bytes(2, bytes(2, concat(integer(1, 0), integer(2, 0)))))) export const heartbeat = (magic: number) => wrap(12, magic, 14, integer(1, 0)) +export const audioControl = (magic: number, enabled: boolean) => wrap(15, magic, 18, integer(1, enabled ? 1 : 0)) export const settingsQuery = (magic: number) => wrap(2, magic, 4, integer(1, 1)) export const shutdown = (magic: number) => wrap(9, magic, 11, integer(1, 1)) export const framebufferLease = (acquire: boolean) => concat(integer(1, 1), integer(2, 0), bytes(101, new Uint8Array([70, 67, 1, acquire ? 5 : 6, 0, 0]))) diff --git a/app/g2/glasses-session.ts b/app/g2/glasses-session.ts index ec89e2da..7066fc99 100644 --- a/app/g2/glasses-session.ts +++ b/app/g2/glasses-session.ts @@ -51,6 +51,10 @@ export class GlassesSession { private layoutCreated = false private off: () => void private stopping: Promise | null = null + private audioListener: ((packet: Uint8Array) => void) | null = null + private microphoneToken = 0 + private microphoneWork: Promise = Promise.resolve() + private microphoneEnabled = false constructor(private readonly transport: SessionTransport, private readonly deflate: (data: Uint8Array) => Uint8Array, private readonly onState: (state: SessionState) => void, @@ -211,6 +215,13 @@ export class GlassesSession { return } if (event.kind !== 'notification' || !event.data) return + if (event.characteristic === protocol.G2_RENDER_NOTIFY && event.identifier !== this.ids.ring) { + if (this.audioListener && this.state.phase === 'connected') { + this.audioListener(hexToBytes(event.data)) + this.onActivity(); this.wake() + } + return + } const ring = event.identifier === this.ids.ring if (ring ? !protocol.RING_NOTIFY.includes(event.characteristic ?? '') : event.characteristic !== protocol.G2_NOTIFY) return try { @@ -268,6 +279,30 @@ export class GlassesSession { if (this.state.phase !== 'connected') return this.latest = protocol.packGray4(gray, 640, 480); this.schedule(0) } + /** Serialize mic enable/disable, including a release while enable awaits ACK. */ + setMicrophone(enabled: boolean, listener?: (packet: Uint8Array) => void): Promise { + const token = ++this.microphoneToken, generation = this.generation + this.audioListener = enabled ? listener ?? null : null + const current = () => generation === this.generation && token === this.microphoneToken + const work = this.microphoneWork.catch(() => {}).then(async () => { + if (!current()) return + if (this.state.phase !== 'connected') { + if (enabled) throw new Error('Connect the glasses before starting voice input.') + return + } + if (enabled) { + await Promise.all(['left', 'right'].map(role => this.transport.subscribe(this.ids[role], protocol.G2_RENDER_NOTIFY))) + if (!current()) return + } + await this.request('right', protocol.SID.hub, magic => protocol.audioControl(magic, enabled), enabled ? 'Microphone enable' : 'Microphone disable') + if (current()) { this.microphoneEnabled = enabled; this.log(`Glasses microphone ${enabled ? 'enabled' : 'disabled'}`) } + }).catch(error => { + if (current()) { this.audioListener = null; this.microphoneEnabled = false } + throw error + }) + this.microphoneWork = work + return work + } wake(): void { if (this.timer !== null) { clearTimeout(this.timer); this.timer = null } void this.pump() @@ -308,6 +343,7 @@ export class GlassesSession { } private reset(): void { ++this.generation + ++this.microphoneToken; this.audioListener = null; this.microphoneEnabled = false if (this.timer !== null) clearTimeout(this.timer) if (this.retryTimer !== null) clearTimeout(this.retryTimer) if (this.ringRetryTimer !== null) clearTimeout(this.ringRetryTimer) @@ -337,6 +373,11 @@ export class GlassesSession { } private async stopInternal(): Promise { this.wanted = false + // Stop mic capture before ending the display session. Late enable ACKs + // cannot leave a microphone streaming after an explicit Disconnect. + if (this.audioListener || this.microphoneEnabled) { + try { await this.setMicrophone(false) } catch (error) { this.log(`Microphone cleanup: ${this.message(error)}`) } + } const cleanup = this.layoutCreated && this.state.phase === 'connected' this.update('disconnecting', 'Disconnecting…'); this.reset() try { diff --git a/app/g2/ios-preview-controller.ts b/app/g2/ios-preview-controller.ts index 6bab4f2f..582ce85d 100644 --- a/app/g2/ios-preview-controller.ts +++ b/app/g2/ios-preview-controller.ts @@ -1,5 +1,6 @@ import { Dialogs, File, knownFolders, path, type ImageSource } from '@nativescript/core' import { iosBluetooth } from '../native/ios-bluetooth' +import { iosVoiceInput } from '../native/ios-voice-input' import { GlassesSession, type SessionState } from './glasses-session' import { loadDeviceAddresses } from './device-addresses' import { deviceAddressError } from './ios-peripheral-identity' @@ -47,7 +48,8 @@ export class IosPreviewController { ...noopLayerActions, requestRender: () => this.requestShellRender(), disconnect: () => this.disconnect(), - startVoiceCapture: () => this.typeIntoApp(), + startVoiceCapture: () => this.startVoiceCapture(), + stopVoiceCapture: () => iosVoiceInput.stopPushToTalk(), startContinuousVoiceCapture: () => this.onError("Voice capture is not available on iOS yet."), startTextSettingEdit: setting => this.editSetting(setting), startTextSettingsEdit: async (settings, _title, finished) => { @@ -62,7 +64,8 @@ export class IosPreviewController { this.compositor.configureSurface('shell', { x: 0, y: 0, width: 640, height: 480, zOrder: 1, transparency: 'color-key' }) shell.configure({ actions: this.actions, - voiceInputEnabled: false, + voiceInputEnabled: true, + prepareVoiceCapture: () => this.prepareVoiceCapture(), getScreenTimeoutMs: () => null, requestShellRender: () => this.requestShellRender(), onWindowsChanged: () => this.requestShellRender(), @@ -285,7 +288,7 @@ export class IosPreviewController { openSettings: section => { void this.launchApp('settings', { section }) }, startTextSettingEdit: id => { const setting = getStringSettingById(id); if (setting) void this.editSetting(setting) }, endTextSettingEdit: () => {}, - startTextInput: () => { void this.typeIntoApp() }, + startTextInput: () => shell.startVoiceInput(), }) this.appHosts.set(appId, host) return host @@ -307,6 +310,7 @@ export class IosPreviewController { if (!this.session) { const { deflate } = require('pako') as { deflate: (data: Uint8Array) => Uint8Array } this.session = new GlassesSession(iosBluetooth(), deflate, state => { + if (state.phase !== 'connected') iosVoiceInput.handleSessionEnded() shell.setBatteryLevels({ headset: state.battery, headsetCharging: state.charging }) this.syncRuntime() if (this.active) this.onConnectionState(state) @@ -322,6 +326,20 @@ export class IosPreviewController { await this.session.start(addresses) } async disconnect(): Promise { await this.session?.stop() } + startVoiceInput(): void { shell.startVoiceInput() } + private async prepareVoiceCapture(): Promise { + if (this.session?.state.phase !== 'connected') { + if (this.active) this.onError('Connect the glasses to use their microphone.') + return false + } + const ready = await iosVoiceInput.prepare(this.active) + if (!ready && this.active) this.onError(iosVoiceInput.statusText) + return ready && this.session?.state.phase === 'connected' + } + private async startVoiceCapture(): Promise { + if (!this.session || this.session.state.phase !== 'connected') return + await iosVoiceInput.startGlassesCapture(this.session, message => this.logBluetooth(message)) + } private logBluetooth(message: string): void { const line = `${new Date().toISOString()} [${this.active ? 'foreground' : 'background'}${UIApplication.sharedApplication.protectedDataAvailable ? '' : ',protected-data-unavailable'}] ${message}` console.log(`[ios-ble] ${line}`); this.logLines.push(line) diff --git a/app/graphics/installed-fonts.ts b/app/graphics/installed-fonts.ts index 14d7259a..8eec0c04 100644 --- a/app/graphics/installed-fonts.ts +++ b/app/graphics/installed-fonts.ts @@ -4,14 +4,14 @@ * app assets on first listing (so the directory is the single source of * truth), and user installs from the Files app ("Install" on a font file). * - * Listing parses each file's name table for family/style (via the Java - * FontFileRenderer) and probes monospace-ness by comparing advances, both + * Listing parses each file's name table for family/style (via the native + * font renderer) and probes monospace-ness by comparing advances, both * memoized per path for the session. */ import { File, Folder, knownFolders, path as nsPath } from "@nativescript/core"; import { canLoadFontFile, fontFileDisplayName, isFontFile } from "../native/font-files"; -declare const com: any; +import { fontRenderer } from "../native/font-renderer"; declare const java: any; declare const global: any; @@ -62,7 +62,7 @@ let preinstalledEnsured = false; * before every listing. */ export function ensurePreinstalledFonts(): void { - if (preinstalledEnsured || !global.isAndroid) return; + if (preinstalledEnsured || (!global.isAndroid && !global.isIOS)) return; const assetsDir = nsPath.join(knownFolders.currentApp().path, "fonts/ttf"); for (const fileName of PREINSTALLED_FONT_FILES) { const target = installedFontPath(fileName); @@ -83,7 +83,7 @@ export function ensurePreinstalledFonts(): void { * same-named file). Returns an error message for the UI, or null on success. */ export function installFontFile(sourcePath: string): string | null { - if (!global.isAndroid) return "Not available on this platform."; + if ((!global.isAndroid && !global.isIOS)) return "Not available on this platform."; if (!isFontFile(sourcePath)) return "Not a font file."; if (!canLoadFontFile(sourcePath)) return "This file could not be loaded as a font."; const fileName = sourcePath.slice(sourcePath.lastIndexOf("/") + 1); @@ -108,7 +108,7 @@ export function isFontInstalled(sourcePath: string): boolean { * then weight. Unloadable files are skipped. */ export function listInstalledFonts(): InstalledFont[] { - if (!global.isAndroid) return []; + if ((!global.isAndroid && !global.isIOS)) return []; ensurePreinstalledFonts(); const fonts: InstalledFont[] = []; try { @@ -195,7 +195,7 @@ function styleWeightOrder(style: string): number { function isMonospaceFont(path: string): boolean { try { const measure = (text: string) => - Number(com.faceclaw.app.FontFileRenderer.measureTextExact(path, text, 48)); + Number(fontRenderer.measureTextExact(path, text, 48)); const narrow = measure("i"); if (!(narrow > 0)) return false; return ( @@ -217,6 +217,14 @@ function isMonospaceFont(path: string): boolean { // isolates on first launch (each resolving the default UI font), and readers // must never see a half-written font file. function copyFileBytes(source: string, target: string): void { + if (source === target) return; + if (global.isIOS) { + const data = NSData.dataWithContentsOfFile(source); + // Foundation's atomic write uses a sibling temporary file and rename. + // Multiple worker isolates can safely preinstall the same bundled face. + if (!data || !data.writeToFileAtomically(target, true)) throw new Error(`Copy to ${target} failed`); + return; + } const temp = `${target}.tmp-${Math.floor(Math.random() * 0x7fffffff).toString(36)}`; const input = new java.io.FileInputStream(source); try { diff --git a/app/graphics/ttf-font.ts b/app/graphics/ttf-font.ts index 3118235e..c3f9ceac 100644 --- a/app/graphics/ttf-font.ts +++ b/app/graphics/ttf-font.ts @@ -1,7 +1,6 @@ /** * TTF/OTF fonts for on-glasses UI text, rendered per-codepoint through the - * Java FontFileRenderer (Android minikin/HarfBuzz: real shaping, kerning, - * antialiasing) and cached as 4bpp coverage rasters that ride the + * native font renderer (Android Paint / iOS Core Text) and cached as 4bpp coverage rasters that ride the * texture-cache glyph pipeline (CFW mode 14; see * notes/texture-cache-display-list-design.md and graphics/glyph-wire.ts). * @@ -14,9 +13,9 @@ * never drifts. * * Kerning uses memoized per-pair measurements (measure("ab") - a - b); - * ligatures are disabled Java-side so per-codepoint rasters plus pairwise + * ligatures are disabled native-side so per-codepoint rasters plus pairwise * kerning fully describe a line. Glyph rasters and advances come from one - * JNI render per (font, size, codepoint) per JS context, memoized forever. + * native render per (font, size, codepoint) per JS context, memoized forever. * * Cross-context determinism: worker threads and the main thread each build * their own TtfFont, but the Java GlyphAtlas dedupes by atlasKey and treats @@ -26,8 +25,8 @@ import { allocateFontFingerprintId, type Glyph } from "./bdffont"; import { GrayImage, grayToNibble, type GlyphFont } from "./image"; import { toUint8Array } from "../util/array-util"; +import { fontRenderer } from "../native/font-renderer"; -declare const com: any; declare const global: any; /** @@ -65,7 +64,7 @@ export class TtfFont implements GlyphFont { /** * Load (or return the memoized) font at a pixel size. Null when the font - * file is missing/unloadable or off-Android — callers fall back to a BDF + * file is missing/unloadable or the platform has no renderer — callers fall back to a BDF * face. */ static load(path: string, sizePx: number, gamma = DEFAULT_TTF_GAMMA): TtfFont | null { @@ -73,9 +72,9 @@ export class TtfFont implements GlyphFont { const cached = loadedFonts.get(key); if (cached !== undefined) return cached; let font: TtfFont | null = null; - if (global.isAndroid && sizePx > 0) { + if ((global.isAndroid || global.isIOS) && Number.isFinite(sizePx) && sizePx > 0) { try { - const raw = String(com.faceclaw.app.FontFileRenderer.getFontMetrics(path, sizePx) ?? ""); + const raw = String(fontRenderer.getFontMetrics(path, sizePx) ?? ""); const parts = raw.split(" ").map((part) => parseInt(part, 10)); if (parts.length === 3 && parts.every((part) => Number.isFinite(part))) { const [ascent, descent] = parts as [number, number, number]; @@ -170,7 +169,7 @@ export class TtfFont implements GlyphFont { /** * Kerning between two adjacent codepoints: measure(ab) - a - b, memoized. - * One JNI measurement per distinct pair per JS context. + * One native measurement per distinct pair per JS context. */ private kernBetween(a: number, b: number): number { const key = a * 0x200000 + b; @@ -179,7 +178,7 @@ export class TtfFont implements GlyphFont { let kern = 0; try { const pair = Number( - com.faceclaw.app.FontFileRenderer.measureTextExact( + fontRenderer.measureTextExact( this.path, String.fromCodePoint(a) + String.fromCodePoint(b), this.sizePx, @@ -203,7 +202,7 @@ export class TtfFont implements GlyphFont { let bytes: Uint8Array; try { bytes = toUint8Array( - com.faceclaw.app.FontFileRenderer.renderGlyphCell(this.path, this.sizePx, codePoint, this.gamma), + fontRenderer.renderGlyphCell(this.path, this.sizePx, codePoint, this.gamma), ); } catch (error) { console.warn(`renderGlyphCell failed for U+${codePoint.toString(16)}: ${error}`); diff --git a/app/native/font-files.ts b/app/native/font-files.ts index 8d0deb30..d27d976c 100644 --- a/app/native/font-files.ts +++ b/app/native/font-files.ts @@ -1,17 +1,16 @@ /** * Font-file text rendering for the on-glasses font previewer, backed by the - * Java FontFileRenderer (Android Typeface/Paint, so shaping, kerning, and - * line breaking come from minikin/HarfBuzz). Rendered text arrives as + * native font renderer (Android Paint / iOS Core Text). Rendered text arrives as * antialiased 8bpp coverage, which the compositor quantizes to the display's * 16 shades. */ import { GrayImage } from "../graphics/image"; import { grayImageFromPacket } from "./image-files"; -declare const com: any; +import { fontRenderer } from "./font-renderer"; declare const global: any; -/** Font file formats Android's Typeface can load. */ +/** Font file formats supported by the native renderers. */ const FONT_FILE = /\.(ttf|otf|ttc)$/i; export function isFontFile(name: string): boolean { @@ -37,9 +36,9 @@ export const DEFAULT_FONT_GAMMA = 1.0; /** Whether the font file parses as a loadable font. */ export function canLoadFontFile(path: string): boolean { - if (!global.isAndroid) return false; + if (!global.isAndroid && !global.isIOS) return false; try { - return !!com.faceclaw.app.FontFileRenderer.canLoadFont(path); + return !!fontRenderer.canLoadFont(path); } catch { return false; } @@ -50,9 +49,9 @@ export function canLoadFontFile(path: string): boolean { * unavailable (caller should fall back to the filename). */ export function fontFileDisplayName(path: string): { family: string; style: string } | null { - if (!global.isAndroid) return null; + if (!global.isAndroid && !global.isIOS) return null; try { - const raw = String(com.faceclaw.app.FontFileRenderer.getFontName(path) ?? ""); + const raw = String(fontRenderer.getFontName(path) ?? ""); if (!raw) return null; const [family, style] = raw.split("\n"); if (!family) return null; @@ -64,9 +63,9 @@ export function fontFileDisplayName(path: string): { family: string; style: stri /** Line metrics at a pixel size; null when the font cannot be loaded. */ export function fontFileMetrics(path: string, sizePx: number): FontFileMetrics | null { - if (!global.isAndroid) return null; + if (!global.isAndroid && !global.isIOS) return null; try { - const raw = String(com.faceclaw.app.FontFileRenderer.getFontMetrics(path, sizePx) ?? ""); + const raw = String(fontRenderer.getFontMetrics(path, sizePx) ?? ""); const parts = raw.split(" ").map((part) => parseInt(part, 10)); if (parts.length !== 3 || parts.some((part) => !Number.isFinite(part))) return null; return { ascent: parts[0]!, descent: parts[1]!, lineGap: parts[2]! }; @@ -86,9 +85,9 @@ export function renderFontFileText( sizePx: number, gamma = DEFAULT_FONT_GAMMA, ): GrayImage | null { - if (!global.isAndroid) return null; + if (!global.isAndroid && !global.isIOS) return null; try { - return grayImageFromPacket(com.faceclaw.app.FontFileRenderer.renderText(path, text, sizePx, gamma)); + return grayImageFromPacket(fontRenderer.renderText(path, text, sizePx, gamma)); } catch (error) { console.warn(`renderFontFileText failed for ${path}: ${error}`); return null; @@ -96,7 +95,7 @@ export function renderFontFileText( } /** - * Render a paragraph wrapped to maxWidth (StaticLayout line breaking), + * Render a paragraph wrapped to maxWidth (native line breaking), * truncated with an ellipsis past maxLines. */ export function renderFontFileWrapped(opts: { @@ -107,10 +106,10 @@ export function renderFontFileWrapped(opts: { maxLines: number; gamma?: number; }): GrayImage | null { - if (!global.isAndroid) return null; + if (!global.isAndroid && !global.isIOS) return null; try { return grayImageFromPacket( - com.faceclaw.app.FontFileRenderer.renderWrapped( + fontRenderer.renderWrapped( opts.path, opts.text, opts.sizePx, diff --git a/app/native/font-renderer.ios.ts b/app/native/font-renderer.ios.ts new file mode 100644 index 00000000..a828e24f --- /dev/null +++ b/app/native/font-renderer.ios.ts @@ -0,0 +1,13 @@ +declare const FaceclawFontRenderer: any +function bytes(data: NSData | null): Uint8Array { + return data ? new Uint8Array(interop.bufferFromData(data)).slice() : new Uint8Array() +} +export const fontRenderer = { + canLoadFont: (path: string): boolean => !!FaceclawFontRenderer.canLoadFont(path), + getFontName: (path: string): string => String(FaceclawFontRenderer.getFontName(path) ?? ''), + getFontMetrics: (path: string, size: number): string => String(FaceclawFontRenderer.getFontMetricsSize(path, size) ?? ''), + measureTextExact: (path: string, text: string, size: number): number => Number(FaceclawFontRenderer.measureTextExactTextSize(path, text, size)), + renderGlyphCell: (path: string, size: number, cp: number, gamma: number): Uint8Array => bytes(FaceclawFontRenderer.renderGlyphCellSizeCodePointGamma(path, size, cp, gamma)), + renderText: (path: string, text: string, size: number, gamma: number): Uint8Array => bytes(FaceclawFontRenderer.renderTextTextSizeGamma(path, text, size, gamma)), + renderWrapped: (path: string, text: string, size: number, width: number, gamma: number, lines: number): Uint8Array => bytes(FaceclawFontRenderer.renderWrappedTextSizeWidthGammaMaxLines(path, text, size, width, gamma, lines)), +} diff --git a/app/native/font-renderer.ts b/app/native/font-renderer.ts new file mode 100644 index 00000000..fc1a8063 --- /dev/null +++ b/app/native/font-renderer.ts @@ -0,0 +1,12 @@ +/** Platform boundary for font rasterization; layout and glyph caches stay shared. */ +import { toUint8Array } from '../util/array-util' +declare const com: any +export const fontRenderer = { + canLoadFont: (path: string): boolean => !!com.faceclaw.app.FontFileRenderer.canLoadFont(path), + getFontName: (path: string): string => String(com.faceclaw.app.FontFileRenderer.getFontName(path) ?? ''), + getFontMetrics: (path: string, size: number): string => String(com.faceclaw.app.FontFileRenderer.getFontMetrics(path, size) ?? ''), + measureTextExact: (path: string, text: string, size: number): number => Number(com.faceclaw.app.FontFileRenderer.measureTextExact(path, text, size)), + renderGlyphCell: (path: string, size: number, cp: number, gamma: number): Uint8Array => toUint8Array(com.faceclaw.app.FontFileRenderer.renderGlyphCell(path, size, cp, gamma)), + renderText: (path: string, text: string, size: number, gamma: number): Uint8Array => toUint8Array(com.faceclaw.app.FontFileRenderer.renderText(path, text, size, gamma)), + renderWrapped: (path: string, text: string, size: number, width: number, gamma: number, lines: number): Uint8Array => toUint8Array(com.faceclaw.app.FontFileRenderer.renderWrapped(path, text, size, width, gamma, lines)), +} diff --git a/app/native/ios-voice-input.ts b/app/native/ios-voice-input.ts new file mode 100644 index 00000000..5b93f85b --- /dev/null +++ b/app/native/ios-voice-input.ts @@ -0,0 +1 @@ +export { voiceControlBridge as iosVoiceInput } from './voice-control.ios' diff --git a/app/native/voice-control.ios.ts b/app/native/voice-control.ios.ts new file mode 100644 index 00000000..873c4e2d --- /dev/null +++ b/app/native/voice-control.ios.ts @@ -0,0 +1,116 @@ +import type { VoiceControlState, VoiceTranscriptEvent } from './voice-control' + +declare const FaceclawSpeech: any +export type IosMicrophoneSession = { + setMicrophone(enabled: boolean, listener?: (packet: Uint8Array) => void): Promise +} + +/** iOS implementation of the shared voice dialog's event bridge. Audio comes + * exclusively from the connected glasses, never from the phone microphone. + */ +export class IosVoiceControlBridge { + private native: any = null + private readonly statuses = new Set<(state: VoiceControlState) => void>() + private readonly transcripts = new Set<(event: VoiceTranscriptEvent) => void>() + private readonly ends = new Set<() => void>() + private status = 'Voice input ready.' + private generation = 0 + private session: IosMicrophoneSession | null = null + private capturing = false + private finalizing = false + private audioTimer: ReturnType | null = null + private packets = 0 + private log: (message: string) => void = () => {} + + onStatus(listener: (state: VoiceControlState) => void): () => void { + this.statuses.add(listener); listener({ status: this.status }); return () => { this.statuses.delete(listener) } + } + onTranscript(listener: (event: VoiceTranscriptEvent) => void): () => void { + this.transcripts.add(listener); return () => { this.transcripts.delete(listener) } + } + onSpeechEnd(listener: () => void): () => void { this.ends.add(listener); return () => { this.ends.delete(listener) } } + onSpeechPause(_listener: () => void): () => void { return () => {} } + private setStatus(status: string): void { this.status = status; for (const fn of [...this.statuses]) fn({ status }) } + private ensureNative(): any { + if (!this.native) { + this.native = FaceclawSpeech.new() + this.native.eventHandler = (json: string) => this.receive(JSON.parse(json)) + } + return this.native + } + async prepare(foreground: boolean): Promise { + let status = FaceclawSpeech.authorizationStatus() + if (status === 0) { + if (!foreground) { this.setStatus('Open Faceclaw on the phone once to allow Speech Recognition.'); return false } + status = await new Promise(resolve => FaceclawSpeech.requestAuthorization(resolve)) + } + if (status !== 3) { this.setStatus('Allow Speech Recognition for Faceclaw in iPhone Settings.'); return false } + return true + } + get statusText(): string { return this.status } + async startGlassesCapture(session: IosMicrophoneSession, log: (message: string) => void): Promise { + this.stop() + const generation = ++this.generation + this.log = log; this.session = session; this.packets = 0; this.capturing = true + const error = String(this.ensureNative().start() ?? '') + if (error) { this.capturing = false; this.session = null; this.setStatus(error); this.emitEnd(); return } + try { + await session.setMicrophone(true, packet => { + if (generation !== this.generation || !this.capturing) return + this.packets++ + const copy = new Uint8Array(packet) + this.native.acceptPacket(NSData.dataWithBytesLength(interop.handleof(copy.buffer), copy.byteLength)) + }) + if (generation !== this.generation || !this.capturing) return + log('Voice: glasses microphone enabled; using on-device recognition') + this.audioTimer = setTimeout(() => { + this.audioTimer = null + if (generation === this.generation && this.capturing && !this.packets) { + this.stop(); this.setStatus('No microphone audio received. Reconnect the glasses and try again.'); this.emitEnd() + } + }, 5000) + } catch (error) { + if (generation !== this.generation) return + this.stop(); this.setStatus(error instanceof Error ? error.message : String(error)); this.emitEnd() + } + } + stopPushToTalk(): void { + if (!this.capturing) return + this.capturing = false; this.finalizing = true + this.clearAudioTimer(); this.releaseMicrophone() + this.setStatus('Recognizing…'); this.native?.finish() + } + stop(): void { + ++this.generation + this.capturing = this.finalizing = false + this.clearAudioTimer(); this.releaseMicrophone(); this.native?.cancel() + } + handleSessionEnded(): void { + if (!this.capturing && !this.finalizing) return + this.stop(); this.setStatus('Glasses disconnected. Start voice input again after reconnecting.'); this.emitEnd() + } + private clearAudioTimer(): void { if (this.audioTimer !== null) clearTimeout(this.audioTimer); this.audioTimer = null } + private releaseMicrophone(): void { + const session = this.session; this.session = null + if (session) void session.setMicrophone(false).catch(error => this.log(`Voice microphone cleanup: ${error}`)) + } + private emitEnd(): void { for (const fn of [...this.ends]) fn() } + private receive(event: { kind: string; text?: string; final?: boolean; message?: string; seconds?: number; packets?: number; rms?: number; missing?: number; errors?: number }): void { + if (!this.capturing && !this.finalizing) return + if (event.kind === 'transcript') { + this.log(`Voice: ${event.final ? 'final' : 'partial'} transcript (${event.text?.length ?? 0} characters)`) + for (const fn of [...this.transcripts]) fn({ text: event.text ?? '', isFinal: !!event.final }) + } else if (event.kind === 'status') this.setStatus(event.message ?? '') + else if (event.kind === 'audio') { + this.log(`Voice audio: ${event.seconds?.toFixed(1)}s, packets=${event.packets}, RMS=${event.rms?.toFixed(4)}, missing=${event.missing}, errors=${event.errors}`) + if (this.capturing) this.setStatus(`Listening on glasses… ${event.seconds?.toFixed(0)}s`) + } else if (event.kind === 'finishing') { + this.stopPushToTalk(); this.emitEnd() + } else if (event.kind === 'ended') { + this.capturing = this.finalizing = false + this.clearAudioTimer(); this.releaseMicrophone() + this.setStatus(event.message ?? 'Ready to send'); this.emitEnd() + } + } +} +export const voiceControlBridge = new IosVoiceControlBridge() diff --git a/app/phone-ui/main-page.ios.ts b/app/phone-ui/main-page.ios.ts index 518e7eb5..a681c919 100644 --- a/app/phone-ui/main-page.ios.ts +++ b/app/phone-ui/main-page.ios.ts @@ -116,13 +116,14 @@ export function createMainPage(): Page { help.text = 'Tap preview icons to open apps.\nHold: system menu\nTap then hold: app menu' help.fontSize = 13; help.textWrap = true; help.margin = 6; settings.addChild(help) const footer = new GridLayout() - footer.columns = '*,*,*'; GridLayout.setRow(footer, 2); controls.addChild(footer) + footer.columns = '*,*,*,*'; GridLayout.setRow(footer, 2); controls.addChild(footer) const back = button('Back', () => controller.gesture('double-tap', 'watch')) const menu = button('Menu', () => { controller.gesture('long-press', 'watch'); controller.gesture('long-press-release', 'watch') }) const keyboard = button('Keyboard', () => { void controller.typeIntoApp() }) - for (const [index, view] of [back, menu, keyboard].entries()) { + const voice = button('Voice', () => controller.startVoiceInput()) + for (const [index, view] of [back, menu, voice, keyboard].entries()) { view.padding = '16 8'; view.fontSize = 14 GridLayout.setColumn(view, index); footer.addChild(view) } diff --git a/app/ui/dashboard-settings.ts b/app/ui/dashboard-settings.ts index 32411b4b..780663ae 100644 --- a/app/ui/dashboard-settings.ts +++ b/app/ui/dashboard-settings.ts @@ -59,9 +59,14 @@ export function onAnySettingChanged(listener: () => void): () => void { } onSettingsStoreChanged(() => { - for (const listener of Array.from(settingChangeListeners)) { - listener(); - } + // Font/cache invalidation listeners may register after this relay. Let the + // entire store notification finish before observers synchronously repaint. + // Otherwise Save updates the label but paints the previous typeface once. + setTimeout(() => { + for (const listener of Array.from(settingChangeListeners)) { + listener(); + } + }, 0); }); export abstract class ConfigSetting { diff --git a/app/ui/dashboard/settings-menus.ts b/app/ui/dashboard/settings-menus.ts index 2e6c0989..8ccb6ef9 100644 --- a/app/ui/dashboard/settings-menus.ts +++ b/app/ui/dashboard/settings-menus.ts @@ -233,8 +233,12 @@ function settingsSections(): SettingsSection[] { }, ]; if (!global.isIOS) return sections; - const deferred = new Set(["Voice", "Assistant", "Navigate", "Watch", "Developer"]); + const deferred = new Set(["Assistant", "Navigate", "Watch", "Developer"]); return sections.map(section => { + if (section.label === "Voice") return { label: "Voice", items: [{ + label: "On-device dictation (Apple)", disabled: true, onSelect: () => {}, + description: "Uses the glasses microphone and your iPhone's speech language. No API key needed. Open Voice from the phone or glasses menu, speak, then click to finish and send the text into an app.", + }] }; if (deferred.has(section.label)) return { label: section.label, items: [{ label: "Not available on iOS yet", disabled: true, onSelect: () => {}, description: `${section.label} integration has not been ported to iOS.`, diff --git a/app/ui/font-picker.ts b/app/ui/font-picker.ts index 66d05364..70b113ca 100644 --- a/app/ui/font-picker.ts +++ b/app/ui/font-picker.ts @@ -278,7 +278,6 @@ export class FontPickerLayer implements Layer { /** Installed fonts grouped into families (styles sorted by weight). */ function collectFamilies(monospaceOnly: boolean): FontFamily[] { - if (global.isIOS) return []; // Native TTF rendering has not been ported. const byLabel = new Map(); for (const font of listInstalledFonts()) { if (monospaceOnly && !font.monospace) continue; @@ -327,7 +326,7 @@ export function terminalFontPickerMenuItem(): MenuItem { function fontPickerMenuItem(options: FontPickerOptions & { rowLabel: string; description: string }): MenuItem { return { label: options.rowLabel, - description: global.isIOS ? "Choose a bundled bitmap font. Native TTF rendering is not available on iOS yet." : options.description, + description: options.description, onSelect: (ctx) => { ctx.stack.push(new FontPickerLayer(options)); }, @@ -339,7 +338,7 @@ function fontPickerMenuItem(options: FontPickerOptions & { rowLabel: string; des y, width, options.rowLabel, - global.isIOS && options.get().kind === "ttf" ? "Terminus (iOS)" : fontSelectionLabel(options.get()), + fontSelectionLabel(options.get()), ); }, }; diff --git a/app/ui/shell/shell.ts b/app/ui/shell/shell.ts index 9495f57b..a36eaabb 100644 --- a/app/ui/shell/shell.ts +++ b/app/ui/shell/shell.ts @@ -970,7 +970,7 @@ class Shell { */ private buildVoiceSendTargets(): VoiceSendTarget[] { const targets: VoiceSendTarget[] = []; - if (this.isAssistantAvailable()) { + if (!global.isIOS && this.isAssistantAvailable()) { targets.push({ id: "assistant", label: "Send to Assistant", diff --git a/app/ui/shell/voice-input.ts b/app/ui/shell/voice-input.ts index ed5f88c8..ab43944a 100644 --- a/app/ui/shell/voice-input.ts +++ b/app/ui/shell/voice-input.ts @@ -116,9 +116,9 @@ export class VoiceInputLayer implements Layer { this.status = state.status; this.actions.requestRender(); }); - if (this.handsFree) { - // No button is held, so the mic has to stop itself. endCapture() is - // idempotent, and a click still ends the utterance early. + if (this.handsFree || global.isIOS) { + // Endpointing or the recognizer ending its session can finish capture. + // endCapture() is idempotent, including after a manual button release. this.unsubscribeSpeechEnd = voiceControlBridge.onSpeechEnd(() => { if (this.phase === "capturing") { this.endCapture(); @@ -186,7 +186,7 @@ export class VoiceInputLayer implements Layer { private menuRows(): Array<{ label: string; dim: boolean; onSelect: () => void }> { const text = this.displayText().trim(); const hasText = text.length > 0; - const hasLlmKey = anthropicApiKeySetting.get().trim().length > 0; + const hasLlmKey = !global.isIOS && anthropicApiKeySetting.get().trim().length > 0; const rows: Array<{ label: string; dim: boolean; onSelect: () => void }> = []; for (const target of this.sendTargets) { rows.push({ @@ -199,7 +199,7 @@ export class VoiceInputLayer implements Layer { }); } rows.push({ - label: hasLlmKey ? "Continue" : "Continue (Needs LLM API key)", + label: global.isIOS ? "Continue (Not available on iOS)" : hasLlmKey ? "Continue" : "Continue (Needs LLM API key)", dim: !hasLlmKey, onSelect: () => { if (hasLlmKey) this.startContinuation(); @@ -379,6 +379,7 @@ export class VoiceInputLayer implements Layer { this.capturing = false; void this.actions.stopVoiceCapture(); } + if (global.isIOS) voiceControlBridge.stop(); this.onClosed(); } diff --git a/tests/ios-app-host.test.cjs b/tests/ios-app-host.test.cjs index f937330d..2621b745 100644 --- a/tests/ios-app-host.test.cjs +++ b/tests/ios-app-host.test.cjs @@ -55,6 +55,21 @@ test('iOS worker frames preserve baked grayscale bytes through the message bound assert.deepEqual(Buffer.from(messages[0].pixels, 'base64'), Buffer.from(pixels)); }); +test('settings-driven repaint runs after font cache invalidation, regardless of subscription order', () => { + const listeners = [], tasks = [], painted = []; + let cachedFont = 'Light'; + const api = load('app/ui/dashboard-settings.ts', { + require: id => id.includes('settings-store') ? { onSettingsStoreChanged: fn => listeners.push(fn) } + : { Layer: class {}, ASSISTANT_MODEL_VALUES: [] }, + setTimeout: fn => tasks.push(fn), + }); + api.onAnySettingChanged(() => painted.push(cachedFont)); + listeners.push(() => { cachedFont = 'Bold'; }); + for (const listener of listeners) listener('display.uiFont2'); + while (tasks.length) tasks.shift()(); + assert.deepEqual(painted, ['Bold']); +}); + test('background glasses input still composites frames; phone resume preserves the session; explicit stop stays stopped', async () => { const tasks = new Map(), screenStates = [], inputs = [], frames = [], previews = [], states = []; let nextTask = 0, starts = 0, stops = 0, session; @@ -75,6 +90,7 @@ test('background glasses input still composites frames; phone resume preserves t const settings = { onAnySettingChanged: () => () => {}, previewColorSetting: { get: () => 'white' } }; const modules = { '@nativescript/core': { File: { fromPath: () => ({ writeTextSync() {} }) }, knownFolders: { documents: () => ({ path: '/tmp' }) }, path }, + '../native/ios-voice-input': { iosVoiceInput: { handleSessionEnded() {} } }, '../native/ios-bluetooth': { iosBluetooth: () => ({}) }, './glasses-session': { GlassesSession: Session }, './device-addresses': { loadDeviceAddresses: () => ({}) }, './ios-peripheral-identity': { deviceAddressError: () => null }, '../apps/launcher/launcher-app': { createLauncherWindow: () => window, LAUNCHER_SURFACE_ID: 'launcher' }, diff --git a/tests/ios-ble.test.cjs b/tests/ios-ble.test.cjs index eae347c4..19eb12a1 100644 --- a/tests/ios-ble.test.cjs +++ b/tests/ios-ble.test.cjs @@ -222,3 +222,37 @@ test('a BLE wake services overdue heartbeat and lease without waiting for a susp assert.equal(h.transport.sent.length, count); assert.equal(h.session.state.phase, 'disconnected'); }); + +test('glasses mic uses Android wire control and only routes bound-arm audio during capture', async t => { + assert.equal(hex(p.audioControl(101, true)), '080f10659201020801'); + assert.equal(hex(p.audioControl(101, false)), '080f10659201020800'); + const h = harness(t), audio = []; + await h.session.start(addresses); + const send = id => h.transport.emit({ kind: 'notification', identifier: id, characteristic: p.G2_RENDER_NOTIFY, data: '010203' }); + send('R'); assert.equal(audio.length, 0); + await h.session.setMicrophone(true, bytes => audio.push(hex(bytes))); + assert.ok(h.transport.subscriptions.some(([id, c]) => id === 'R' && c === p.G2_RENDER_NOTIFY)); + assert.ok(h.transport.subscriptions.some(([id, c]) => id === 'L' && c === p.G2_RENDER_NOTIFY)); + send('stranger'); send('ring'); send('L'); send('R'); + assert.deepEqual(audio, ['010203', '010203']); + const disabling = h.session.setMicrophone(false); + send('R'); assert.equal(audio.length, 2); // Immediate, before the disable ACK. + await disabling; + assert.deepEqual(h.transport.sent.filter(s => s.message.command === 15).map(s => + [s.id, p.readInteger(p.readBytes(s.message.payload, 18), 1)]), [['R', 1], ['R', 0]]); +}); +test('release while microphone enable awaits ACK sends disable last and rejects further audio', async t => { + const h = harness(t); await h.session.start(addresses); + h.transport.hold = true; + let packets = 0; + const enabling = h.session.setMicrophone(true, () => packets++); + await until(() => h.transport.held.some(s => s.message.command === 15)); + const disabling = h.session.setMicrophone(false); + h.transport.emit({ kind: 'notification', identifier: 'R', characteristic: p.G2_RENDER_NOTIFY, data: '01' }); + assert.equal(packets, 0); + h.transport.hold = false; + for (const s of h.transport.held) h.transport.ack(s.id, s.message); + await Promise.all([enabling, disabling]); + const mic = h.transport.sent.filter(s => s.message.command === 15); + assert.equal(p.readInteger(p.readBytes(mic.at(-1).message.payload, 18), 1), 0); +}); diff --git a/tests/ios-font-native.cjs b/tests/ios-font-native.cjs new file mode 100644 index 00000000..9057b69b --- /dev/null +++ b/tests/ios-font-native.cjs @@ -0,0 +1,10 @@ +// Runs the production Core Text renderer on macOS, without UIKit or a simulator. +const { execFileSync } = require('node:child_process'); +const { mkdtempSync } = require('node:fs'); +const { tmpdir } = require('node:os'); +const { join, resolve } = require('node:path'); +const root = resolve(__dirname, '..'), dir = mkdtempSync(join(tmpdir(), 'faceclaw-font-')); +execFileSync('xcrun', ['clang', '-fobjc-arc', '-Wall', '-Wextra', '-framework', 'Foundation', '-framework', 'CoreText', '-framework', 'CoreGraphics', + '-I', 'App_Resources/iOS/src', 'tests/native/ios-font-test.m', 'App_Resources/iOS/src/FaceclawFontRenderer.m', '-o', join(dir, 'font-test')], { cwd: root, stdio: 'inherit' }); +execFileSync(join(dir, 'font-test'), [join(root, 'app/fonts/ttf'), dir], { stdio: 'inherit' }); +console.log(`Font test artifacts: ${dir}`); diff --git a/tests/ios-lc3-native.cjs b/tests/ios-lc3-native.cjs new file mode 100644 index 00000000..8f248142 --- /dev/null +++ b/tests/ios-lc3-native.cjs @@ -0,0 +1,11 @@ +// Exercise the actual decoder with stock G2 packet framing and encoded PCM. +const { execFileSync } = require('node:child_process'); +const { mkdtempSync, readdirSync } = require('node:fs'); +const { tmpdir } = require('node:os'); +const { join, resolve } = require('node:path'); +const root = resolve(__dirname, '..'), dir = mkdtempSync(join(tmpdir(), 'faceclaw-lc3-')); +const src = 'App_Resources/iOS/src'; +const files = readdirSync(join(root, src, 'lc3')).filter(f => f.endsWith('.c')).map(f => `${src}/lc3/${f}`); +execFileSync('xcrun', ['clang', '-fobjc-arc', '-O2', '-framework', 'Foundation', '-I', src, '-I', `${src}/lc3`, + 'tests/native/ios-lc3-test.m', `${src}/FaceclawLc3Decoder.m`, ...files, '-o', join(dir, 'lc3-test')], { cwd: root, stdio: 'inherit' }); +execFileSync(join(dir, 'lc3-test'), [], { stdio: 'inherit' }); diff --git a/tests/ios-voice.test.cjs b/tests/ios-voice.test.cjs new file mode 100644 index 00000000..ec29c011 --- /dev/null +++ b/tests/ios-voice.test.cjs @@ -0,0 +1,63 @@ +const test = require('node:test'); +const assert = require('node:assert/strict'); +const fs = require('node:fs'); +const vm = require('node:vm'); +const ts = require('typescript'); +function harness() { + const native = { start: () => '', cancel() { this.cancels++; }, cancels: 0, finish() { this.finished = true; }, acceptPacket: p => audio.push(p) }; + const audio = [], timers = new Map(), commands = [], text = []; + let authorization = 3, permissionRequests = 0, release; + const sandbox = { exports: {}, FaceclawSpeech: { new: () => native, authorizationStatus: () => authorization, + requestAuthorization: done => { permissionRequests++; done(3); } }, + setTimeout: fn => { timers.set(fn, fn); return fn; }, clearTimeout: fn => timers.delete(fn), + NSData: { dataWithBytesLength: (b, n) => Buffer.from(b, 0, n) }, interop: { handleof: b => b } }; + vm.runInNewContext(ts.transpileModule(fs.readFileSync('app/native/voice-control.ios.ts', 'utf8'), { + compilerOptions: { module: ts.ModuleKind.CommonJS, target: ts.ScriptTarget.ES2020 } }).outputText, sandbox); + const bridge = new sandbox.exports.IosVoiceControlBridge(); + bridge.onTranscript(event => text.push({ ...event })); + const session = { setMicrophone(enabled, fn) { + commands.push(enabled); + if (enabled) { this.packet = fn; return new Promise(resolve => { release = resolve; }); } + return Promise.resolve(); + } }; + return { bridge, native, session, audio, commands, text, timers, release: () => release(), + authorization: value => { authorization = value; }, permissionRequests: () => permissionRequests, + event: event => native.eventHandler(JSON.stringify(event)) }; +} +test('iOS speech permission is requested only in foreground and denial stays actionable', async () => { + const h = harness(); h.authorization(0); + assert.equal(await h.bridge.prepare(false), false); assert.equal(h.permissionRequests(), 0); + assert.equal(await h.bridge.prepare(true), true); assert.equal(h.permissionRequests(), 1); + h.authorization(2); assert.equal(await h.bridge.prepare(true), false); + assert.match(h.bridge.statusText, /Settings/); +}); +test('glasses speech sends PCM-source packets, replaces partials, and drains final text after manual release', async () => { + const h = harness(); const start = h.bridge.startGlassesCapture(h.session, () => {}); + h.session.packet(new Uint8Array([1, 2, 3])); assert.deepEqual([...h.audio[0]], [1, 2, 3]); + h.release(); await start; + h.event({ kind: 'transcript', text: 'hello', final: false }); + h.event({ kind: 'transcript', text: 'hello world', final: false }); + h.bridge.stopPushToTalk(); assert.deepEqual(h.commands, [true, false]); assert.equal(h.native.finished, true); + h.session.packet(new Uint8Array([4])); assert.equal(h.audio.length, 1); + h.event({ kind: 'transcript', text: 'Hello world.', final: true }); + h.event({ kind: 'ended', message: 'Ready to send' }); + assert.deepEqual(h.text, [{ text: 'hello', isFinal: false }, { text: 'hello world', isFinal: false }, { text: 'Hello world.', isFinal: true }]); + h.event({ kind: 'transcript', text: 'stale', final: true }); assert.equal(h.text.length, 3); + assert.equal(h.timers.size, 0); +}); +test('cancel and disconnect during enable cannot resurrect capture or leave its microphone listener active', async () => { + for (const stop of ['stop', 'handleSessionEnded']) { + const h = harness(); let ends = 0; h.bridge.onSpeechEnd(() => ends++); + const start = h.bridge.startGlassesCapture(h.session, () => {}); + h.bridge[stop](); h.release(); await start; + h.session.packet(new Uint8Array([9])); + h.event({ kind: 'transcript', text: 'stale', final: true }); + assert.deepEqual(h.commands, [true, false]); assert.equal(h.audio.length, 0); assert.equal(h.text.length, 0); + assert.equal(h.timers.size, 0); assert.equal(ends, stop === 'stop' ? 0 : 1); + } +}); +test('missing microphone data ends the session and disables the mic with an actionable status', async () => { + const h = harness(); const start = h.bridge.startGlassesCapture(h.session, () => {}); h.release(); await start; + for (const fn of h.timers.values()) fn(); + assert.deepEqual(h.commands, [true, false]); assert.match(h.bridge.statusText, /No microphone audio/); +}); diff --git a/tests/native/ios-font-test.m b/tests/native/ios-font-test.m new file mode 100644 index 00000000..a97ebcc9 --- /dev/null +++ b/tests/native/ios-font-test.m @@ -0,0 +1,82 @@ +#import +#import "FaceclawFontRenderer.h" +#import +static int U16(const uint8_t *p) { return p[0] | p[1] << 8; } +static int S16(const uint8_t *p) { return (int16_t)U16(p); } +static void Check(BOOL ok, NSString *message) { if (!ok) { NSLog(@"FAIL: %@", message); exit(1); } } +static void SavePGM(NSData *packet, NSString *path) { + const uint8_t *p = packet.bytes; + NSMutableData *out = [[NSString stringWithFormat:@"P5\n%d %d\n255\n", U16(p), U16(p + 2)] dataUsingEncoding:NSUTF8StringEncoding].mutableCopy; + [out appendBytes:p + 4 length:packet.length - 4]; [out writeToFile:path atomically:YES]; +} +int main(int argc, char **argv) { @autoreleasepool { + Check(argc == 3, @"font directory and output directory required"); + NSString *dir = @(argv[1]), *outDir = @(argv[2]); + NSString *font = [dir stringByAppendingPathComponent:@"Roboto-Regular.ttf"]; + NSString *bad = [outDir stringByAppendingPathComponent:@"invalid.ttf"]; + [@"not a font" writeToFile:bad atomically:YES encoding:NSUTF8StringEncoding error:nil]; + Check(![FaceclawFontRenderer canLoadFont:bad], @"invalid font rejected"); + Check(![FaceclawFontRenderer canLoadFont:@"/missing/font.ttf"], @"missing font rejected"); + Check([FaceclawFontRenderer renderGlyphCell:font size:NAN codePoint:65 gamma:1].length == 0, @"invalid size rejected"); + Check([FaceclawFontRenderer renderGlyphCell:font size:16 codePoint:0xd800 gamma:1].length == 0, @"surrogate rejected"); + NSMutableArray *metadata = [NSMutableArray new]; + for (NSString *file in [[NSFileManager defaultManager] contentsOfDirectoryAtPath:dir error:nil]) { + if (![file.pathExtension isEqual:@"ttf"]) continue; + NSString *path = [dir stringByAppendingPathComponent:file]; + Check([FaceclawFontRenderer canLoadFont:path], file); + NSString *name = [FaceclawFontRenderer getFontName:path]; + Check(name.length > 2, @"family/style metadata"); + [metadata addObject:@{@"file":file, @"name":name, @"metrics14":[FaceclawFontRenderer getFontMetrics:path size:14]}]; + for (NSNumber *size in @[@8, @14, @18, @32, @64]) { + NSData *glyph = [FaceclawFontRenderer renderGlyphCell:path size:size.doubleValue codePoint:65 gamma:1]; + Check(glyph.length > 10, @"bundled glyph coverage"); + const uint8_t *p = glyph.bytes; + Check(glyph.length == (NSUInteger)(10 + U16(p+6)*U16(p+8)), @"glyph packet dimensions"); + } + } + Check(metadata.count == 12, @"all twelve bundled fonts"); + NSString *mono = [dir stringByAppendingPathComponent:@"RobotoMono-Regular.ttf"]; + Check(fabs([FaceclawFontRenderer measureTextExact:mono text:@"i" size:48] - [FaceclawFontRenderer measureTextExact:mono text:@"W" size:48]) < 0.01, @"monospace widths"); + double av = [FaceclawFontRenderer measureTextExact:font text:@"AV" size:32]; + double a = [FaceclawFontRenderer measureTextExact:font text:@"A" size:32], v = [FaceclawFontRenderer measureTextExact:font text:@"V" size:32]; + Check(av < a + v, @"kerning retained"); + NSMutableDictionary *packets = [NSMutableDictionary new]; + NSArray *metrics = [[FaceclawFontRenderer getFontMetrics:font size:32] componentsSeparatedByString:@" "]; + NSInteger ascent = [metrics[0] integerValue], descent = [metrics[1] integerValue]; + for (NSString *text in @[@"A", @"g", @"j", @"É", @" "]) { + NSData *glyph = [FaceclawFontRenderer renderGlyphCell:font size:32 codePoint:[text characterAtIndex:0] gamma:1]; + const uint8_t *g = glyph.bytes; + Check(fabs(U16(g)/64.0 - [FaceclawFontRenderer measureTextExact:font text:text size:32]) <= 1.0/128, @"advance precision"); + NSData *line = [FaceclawFontRenderer renderText:font text:text size:32 gamma:1]; const uint8_t *p = line.bytes; + if ([text isEqual:@" "]) { Check(glyph.length == 10 && U16(g) > 0, @"space preserves advance with no ink"); continue; } + Check(S16(g+4) >= 0 && S16(g+4)+U16(g+8) <= ascent+descent, @"glyph inside line box"); + NSInteger shiftX = MAX(0, -S16(g+2)); + // Glyph bearings/top must place precisely the same pixels as a native + // single-character line. Detects upside-down buffers and baseline drift. + for (NSInteger y=0; y= d[i], @"gamma monotonic"); if (l[i] > 0 && l[i] < 255) antialiased = YES; } + Check(antialiased, @"antialias coverage"); + Check([FaceclawFontRenderer renderGlyphCell:font size:32 codePoint:0x1f642 gamma:1].length > 10, @"non-BMP fallback glyph"); + NSString *sample = @"AgjÉ 0123456789 — AV fi ffi"; + SavePGM([FaceclawFontRenderer renderText:font text:sample size:32 gamma:1], [outDir stringByAppendingPathComponent:@"line.pgm"]); + NSString *paragraph = @"The quick brown fox jumps over the lazy dog.\nCafé déjà vu — 23°C. ALongWordWithoutSpacesToExerciseWrapping. More text for truncation."; + NSData *wrapped = [FaceclawFontRenderer renderWrapped:font text:paragraph size:18 width:200 gamma:1 maxLines:3]; + Check(U16(wrapped.bytes) == 200 && U16((const uint8_t *)wrapped.bytes+2) <= 3*24, @"bounded wrapped text"); + SavePGM(wrapped, [outDir stringByAppendingPathComponent:@"wrapped.pgm"]); + NSData *reference = [FaceclawFontRenderer renderGlyphCell:font size:14 codePoint:65 gamma:1]; + dispatch_apply(32, dispatch_get_global_queue(QOS_CLASS_DEFAULT, 0), ^(size_t i) { (void)i; @autoreleasepool { + Check([[FaceclawFontRenderer renderGlyphCell:font size:14 codePoint:65 gamma:1] isEqual:reference], @"concurrent workers deterministic"); + }}); + NSDictionary *result = @{@"fonts":metadata, @"glyphs32":packets, @"kernAV32":@(av-a-v)}; + [[NSJSONSerialization dataWithJSONObject:result options:NSJSONWritingPrettyPrinted error:nil] writeToFile:[outDir stringByAppendingPathComponent:@"result.json"] atomically:YES]; + NSLog(@"PASS: font loading, metadata, glyph placement, coverage, kerning, wrapping, gamma and worker concurrency"); +} return 0; } diff --git a/tests/native/ios-lc3-test.m b/tests/native/ios-lc3-test.m new file mode 100644 index 00000000..984d53f8 --- /dev/null +++ b/tests/native/ios-lc3-test.m @@ -0,0 +1,34 @@ +#import +#import "FaceclawLc3Decoder.h" +#include "lc3/lc3.h" +#include +#include +int main(void) { @autoreleasepool { + void *memory = calloc(1, lc3_encoder_size(10000, 16000)); + lc3_encoder_t encoder = lc3_setup_encoder(10000, 16000, 0, memory); + assert(encoder); + FaceclawLc3Decoder *decoder = [FaceclawLc3Decoder new]; + double energy = 0; NSUInteger samples = 0; + for (int packetIndex = 0; packetIndex < 32; packetIndex++) { + NSMutableData *packet = [NSMutableData dataWithLength:205]; + uint8_t *bytes = packet.mutableBytes; + for (int frame = 0; frame < 5; frame++) { + int16_t input[160]; + for (int i = 0; i < 160; i++) input[i] = (int16_t)(12000 * sin(2 * M_PI * 440 * (packetIndex * 800 + frame * 160 + i) / 16000)); + assert(lc3_encode(encoder, LC3_PCM_FORMAT_S16, input, 1, 40, bytes + frame * 40) == 0); + } + bytes[204] = (uint8_t)(250 + packetIndex); // Cross counter wrap. + NSData *pcm = [decoder decodePacket:packet]; + assert(pcm.length == 1600); + const int16_t *out = pcm.bytes; + for (int i = 0; i < 800; i++) { energy += (double)out[i] * out[i]; samples++; } + assert([decoder decodePacket:packet] == nil); // Other arm's relay. + bytes[204]--; assert([decoder decodePacket:packet] == nil); // Late relay. + } + assert(decoder.packets == 32 && decoder.duplicates == 64 && decoder.missing == 0); + assert(sqrt(energy / samples) > 6000 && sqrt(energy / samples) < 10000); + assert([decoder decodePacket:[NSMutableData dataWithLength:204]] == nil); + assert(decoder.errors == 1); + free(memory); + puts("PASS: LC3 G2 packets decode to 16 kHz PCM; signal energy, duplicate/late relays, counter wrap and malformed packets checked."); +} return 0; } From 319d3dc44b254ab4b871175ada136197cbde3209 Mon Sep 17 00:00:00 2001 From: James Babcock Date: Tue, 8 Sep 2026 12:41:02 -0700 Subject: [PATCH 08/99] iOS porting: Config pull and push scripts; Terminal works; voice input with Siri works --- .gitignore | 1 + App_Resources/iOS/Info.plist | 12 ++++ App_Resources/iOS/src/FaceclawConfigPort.h | 6 ++ App_Resources/iOS/src/FaceclawConfigPort.m | 59 +++++++++++++++++++ App_Resources/iOS/src/FaceclawSpeech.m | 13 +++- .../iOS/src/FaceclawSpeechTranscript.h | 6 ++ .../iOS/src/FaceclawSpeechTranscript.m | 38 ++++++++++++ App_Resources/iOS/src/module.modulemap | 1 + README.md | 4 +- app/apps/terminal/hub-header.ts | 11 ++++ app/apps/terminal/terminal-app.worker.ts | 9 +-- app/bootstrap.ios.ts | 6 +- app/native/g2mirror-client.ts | 4 +- tests/ios-config-native.cjs | 10 ++++ tests/ios-config-scripts.test.cjs | 21 +++++++ tests/ios-speech-transcript-native.cjs | 10 ++++ tests/ios-terminal-input.test.cjs | 43 ++++++++++++++ tests/native/ios-config-test.m | 35 +++++++++++ tests/native/ios-speech-transcript-test.m | 28 +++++++++ tests/terminal-header.test.cjs | 30 ++++++++++ tests/tsconfig.json | 1 + 21 files changed, 339 insertions(+), 9 deletions(-) create mode 100644 App_Resources/iOS/src/FaceclawConfigPort.h create mode 100644 App_Resources/iOS/src/FaceclawConfigPort.m create mode 100644 App_Resources/iOS/src/FaceclawSpeechTranscript.h create mode 100644 App_Resources/iOS/src/FaceclawSpeechTranscript.m create mode 100644 app/apps/terminal/hub-header.ts create mode 100644 tests/ios-config-native.cjs create mode 100644 tests/ios-config-scripts.test.cjs create mode 100644 tests/ios-speech-transcript-native.cjs create mode 100644 tests/ios-terminal-input.test.cjs create mode 100644 tests/native/ios-config-test.m create mode 100644 tests/native/ios-speech-transcript-test.m create mode 100644 tests/terminal-header.test.cjs diff --git a/.gitignore b/.gitignore index 0559f6db..6d3aefcb 100644 --- a/.gitignore +++ b/.gitignore @@ -39,6 +39,7 @@ old # pull_config.sh output: the phone's live settings, including API keys faceclaw_settings.xml +faceclaw_settings.ios.json # Developer configs build_paths.sh diff --git a/App_Resources/iOS/Info.plist b/App_Resources/iOS/Info.plist index f9fc115e..eb192802 100644 --- a/App_Resources/iOS/Info.plist +++ b/App_Resources/iOS/Info.plist @@ -26,6 +26,18 @@ bluetooth-central + NSAppTransportSecurity + + NSAllowsLocalNetworking + + + NSExceptionDomains + + 100.68.94.67 + NSExceptionAllowsInsecureHTTPLoads + + NSLocalNetworkUsageDescription Faceclaw connects to the terminal servers you configure on your local network. UILaunchScreen diff --git a/App_Resources/iOS/src/FaceclawConfigPort.h b/App_Resources/iOS/src/FaceclawConfigPort.h new file mode 100644 index 00000000..768f5cd5 --- /dev/null +++ b/App_Resources/iOS/src/FaceclawConfigPort.h @@ -0,0 +1,6 @@ +#import +/** Developer config transfer through the app container, before workers start. */ +@interface FaceclawConfigPort : NSObject ++ (void)processPendingRequest; ++ (void)processDirectory:(NSString *)directory defaults:(NSUserDefaults *)defaults domain:(NSString *)domain; +@end diff --git a/App_Resources/iOS/src/FaceclawConfigPort.m b/App_Resources/iOS/src/FaceclawConfigPort.m new file mode 100644 index 00000000..7da8efa2 --- /dev/null +++ b/App_Resources/iOS/src/FaceclawConfigPort.m @@ -0,0 +1,59 @@ +#import "FaceclawConfigPort.h" +@implementation FaceclawConfigPort ++ (void)processPendingRequest { + NSString *library = NSSearchPathForDirectoriesInDomains(NSLibraryDirectory, NSUserDomainMask, YES).firstObject; + [self processDirectory:[library stringByAppendingPathComponent:@"FaceclawConfigPort"] + defaults:NSUserDefaults.standardUserDefaults domain:NSBundle.mainBundle.bundleIdentifier]; +} ++ (BOOL)validSettings:(id)settings { + if (![settings isKindOfClass:NSDictionary.class] || [settings count] > 4096) return NO; + for (id key in settings) { + id value = settings[key]; + if (![key isKindOfClass:NSString.class] || ![key length] || [key length] > 512 || + !([value isKindOfClass:NSString.class] || [value isKindOfClass:NSNumber.class])) return NO; + } + return YES; +} ++ (void)processDirectory:(NSString *)directory defaults:(NSUserDefaults *)defaults domain:(NSString *)domain { + NSString *requestPath = [directory stringByAppendingPathComponent:@"request.json"]; + NSData *data = [NSData dataWithContentsOfFile:requestPath]; + if (!data) return; + NSFileManager *fm = NSFileManager.defaultManager; + // Consume once. A failed import must never be replayed at a later launch. + [fm removeItemAtPath:requestPath error:nil]; + id request = data.length <= 2 * 1024 * 1024 ? [NSJSONSerialization JSONObjectWithData:data options:0 error:nil] : nil; + BOOL valid = [request isKindOfClass:NSDictionary.class]; + NSString *identifier = valid && [request[@"id"] isKindOfClass:NSString.class] ? request[@"id"] : @""; + NSMutableDictionary *reply = [@{@"id":identifier, @"ok":@NO, @"message":@"Invalid config request"} mutableCopy]; + [defaults synchronize]; + NSDictionary *before = [defaults persistentDomainForName:domain] ?: @{}; + if (valid && [request[@"operation"] isEqual:@"pull"]) { + NSMutableDictionary *settings = [NSMutableDictionary new]; + for (NSString *key in before) { + id value = before[key]; + if ([value isKindOfClass:NSString.class] || [value isKindOfClass:NSNumber.class]) settings[key] = value; + } + [settings removeObjectForKey:@"ios.settings.changeToken"]; + reply[@"config"] = @{@"schema":@1, @"settings":settings}; reply[@"ok"] = @YES; + reply[@"message"] = @"Config exported"; + } else if (valid && [request[@"operation"] isEqual:@"push"] && [self validSettings:request[@"settings"]]) { + NSError *error = nil; + NSData *backup = [NSPropertyListSerialization dataWithPropertyList:before format:NSPropertyListBinaryFormat_v1_0 options:0 error:&error]; + if (backup && [backup writeToFile:[directory stringByAppendingPathComponent:@"previous.plist"] options:NSDataWritingAtomic error:&error]) { + NSMutableDictionary *next = [before mutableCopy]; + [next addEntriesFromDictionary:request[@"settings"]]; + next[@"ios.settings.changeToken"] = NSUUID.UUID.UUIDString; + [defaults setPersistentDomain:next forName:domain]; + if ([defaults synchronize]) { + reply[@"ok"] = @YES; reply[@"message"] = @"Config imported"; + reply[@"count"] = @([request[@"settings"] count]); + } else { + [defaults setPersistentDomain:before forName:domain]; [defaults synchronize]; + reply[@"message"] = @"Could not persist config; restored previous settings"; + } + } else reply[@"message"] = @"Could not back up existing settings; import skipped"; + } + NSData *response = [NSJSONSerialization dataWithJSONObject:reply options:NSJSONWritingPrettyPrinted error:nil]; + [response writeToFile:[directory stringByAppendingPathComponent:@"response.json"] options:NSDataWritingAtomic error:nil]; +} +@end diff --git a/App_Resources/iOS/src/FaceclawSpeech.m b/App_Resources/iOS/src/FaceclawSpeech.m index ba018155..631d6748 100644 --- a/App_Resources/iOS/src/FaceclawSpeech.m +++ b/App_Resources/iOS/src/FaceclawSpeech.m @@ -1,5 +1,6 @@ #import "FaceclawSpeech.h" #import "FaceclawLc3Decoder.h" +#import "FaceclawSpeechTranscript.h" #import #import #import @@ -14,6 +15,7 @@ @property(nonatomic) NSUInteger pendingPackets; @property(nonatomic) BOOL accepting; @property(nonatomic, copy) NSString *bestText; +@property(nonatomic, strong) FaceclawSpeechTranscript *transcript; @end @implementation FaceclawSpeech - (instancetype)init { @@ -49,6 +51,7 @@ self.request.taskHint = SFSpeechRecognitionTaskHintDictation; if (@available(iOS 16.0, *)) self.request.addsPunctuation = YES; self.bestText = @""; self.accepting = YES; + self.transcript = [FaceclawSpeechTranscript new]; NSUInteger generation = self.generation; __weak FaceclawSpeech *weakSelf = self; self.task = [self.recognizer recognitionTaskWithRequest:self.request resultHandler:^(SFSpeechRecognitionResult *result, NSError *error) { @@ -56,7 +59,13 @@ FaceclawSpeech *owner = weakSelf; if (!owner || owner.generation != generation) return; if (result) { - owner.bestText = result.bestTranscription.formattedString ?: @""; + SFSpeechRecognitionMetadata *metadata = result.speechRecognitionMetadata; + SFTranscriptionSegment *first = result.bestTranscription.segments.firstObject; + SFTranscriptionSegment *last = result.bestTranscription.segments.lastObject; + NSTimeInterval start = metadata ? metadata.speechStartTimestamp : first.timestamp; + NSTimeInterval duration = metadata ? metadata.speechDuration : last.timestamp + last.duration - start; + owner.bestText = [owner.transcript updateText:result.bestTranscription.formattedString ?: @"" + start:start duration:duration settled:metadata != nil || result.final final:result.final]; if (!result.final) [owner emit:@{@"kind":@"transcript", @"text":owner.bestText, @"final":@NO}]; } if (result.final || error) { @@ -131,6 +140,6 @@ self.generation++; self.accepting = NO; self.pendingPackets = 0; [self.task cancel]; self.task = nil; self.request = nil; self.decoder = nil; self.recognizer = nil; - self.bestText = @""; + self.bestText = @""; self.transcript = nil; } @end diff --git a/App_Resources/iOS/src/FaceclawSpeechTranscript.h b/App_Resources/iOS/src/FaceclawSpeechTranscript.h new file mode 100644 index 00000000..1b72a8dc --- /dev/null +++ b/App_Resources/iOS/src/FaceclawSpeechTranscript.h @@ -0,0 +1,6 @@ +#import +/** Accumulates on-device utterances while allowing revisions within each one. */ +@interface FaceclawSpeechTranscript : NSObject +@property(nonatomic, readonly) NSString *text; +- (NSString *)updateText:(NSString *)text start:(NSTimeInterval)start duration:(NSTimeInterval)duration settled:(BOOL)settled final:(BOOL)final; +@end diff --git a/App_Resources/iOS/src/FaceclawSpeechTranscript.m b/App_Resources/iOS/src/FaceclawSpeechTranscript.m new file mode 100644 index 00000000..f8acfdd1 --- /dev/null +++ b/App_Resources/iOS/src/FaceclawSpeechTranscript.m @@ -0,0 +1,38 @@ +#import "FaceclawSpeechTranscript.h" +#import +@interface FaceclawSpeechTranscript () +@property(nonatomic, strong) NSMutableArray *utterances; +@end +@implementation FaceclawSpeechTranscript +- (instancetype)init { + if ((self = [super init])) _utterances = [NSMutableArray new]; + return self; +} +- (NSString *)text { + NSMutableArray *parts = [NSMutableArray new]; + for (NSDictionary *utterance in self.utterances) [parts addObject:utterance[@"text"]]; + return [parts componentsJoinedByString:@" "]; +} +- (NSString *)updateText:(NSString *)text start:(NSTimeInterval)start duration:(NSTimeInterval)duration settled:(BOOL)settled final:(BOOL)final { + text = [text stringByTrimmingCharactersInSet:NSCharacterSet.whitespaceAndNewlineCharacterSet]; + // Apple's final callback can be empty after a pause. Keep the best result. + if (!text.length || (final && [text isEqual:self.text])) return self.text; + BOOL timed = isfinite(start) && start >= 0 && isfinite(duration) && duration > 0; + NSUInteger index = self.utterances.count; + if (timed) { + // Audio timestamps identify revisions, repeated callbacks and cumulative + // results. Replace the covered suffix, preserving earlier utterances. + for (NSUInteger i = 0; i < self.utterances.count; i++) { + NSDictionary *item = self.utterances[i]; + if (![item[@"settled"] boolValue] || start < [item[@"end"] doubleValue] - 0.01) { index = i; break; } + } + } else if (index && (final || ![self.utterances.lastObject[@"settled"] boolValue])) { + index--; // An ordinary partial corrects the active utterance. + } + // Untimed partials following a metadata-bearing result begin a new + // utterance even when the words are identical ("yes" ... "yes"). + if (index < self.utterances.count) [self.utterances removeObjectsInRange:NSMakeRange(index, self.utterances.count - index)]; + [self.utterances addObject:@{@"text":text, @"end":@(timed ? start + duration : 0), @"settled":@(settled)}]; + return self.text; +} +@end diff --git a/App_Resources/iOS/src/module.modulemap b/App_Resources/iOS/src/module.modulemap index abe55cd1..e98bde65 100644 --- a/App_Resources/iOS/src/module.modulemap +++ b/App_Resources/iOS/src/module.modulemap @@ -5,5 +5,6 @@ module FaceclawGraphics { header "FaceclawSocket.h" header "FaceclawLc3Decoder.h" header "FaceclawSpeech.h" + header "FaceclawConfigPort.h" export * } diff --git a/README.md b/README.md index be3f29bd..7e7d87b8 100644 --- a/README.md +++ b/README.md @@ -29,7 +29,9 @@ walk you through pairing with the glasses and installing custom firmware. ## Compiling -For the initial NativeScript iOS port, see [iOS development](notes/ios-development.md). +For the NativeScript iOS port, see [iOS development](notes/ios-development.md). +Use `scripts/pull_config_ios.sh` and `scripts/push_config_ios.sh` to transfer iPhone +settings; see [iOS config transfer](scripts/ios-config.md) for options and Android XML support. The instructions below build the Android app. If you want to customize faceclaw, the best way to do it is to download the diff --git a/app/apps/terminal/hub-header.ts b/app/apps/terminal/hub-header.ts new file mode 100644 index 00000000..fc7b5a91 --- /dev/null +++ b/app/apps/terminal/hub-header.ts @@ -0,0 +1,11 @@ +import { wrapText, type WrapFont } from '../../graphics/textwrap'; + +/** Keep short status on the title row; give long errors their full width. */ +export function layoutHubHeader(font: WrapFont, title: string, status: string, width: number, step: number) { + const inlineX = 18 + font.measureText(title) + 16; + const inline = !/[\r\n]/.test(status) && font.measureText(status) <= Math.max(0, width - inlineX - 12); + const lines = inline ? [status] : wrapText(font, status, Math.max(1, width - 30)); + const x = inline ? inlineX : 18; + const y = inline ? 10 : 10 + step; + return { x, y, lines, listTop: inline ? 16 + step : 16 + step * (1 + lines.length) }; +} diff --git a/app/apps/terminal/terminal-app.worker.ts b/app/apps/terminal/terminal-app.worker.ts index 8e1913dd..275505eb 100644 --- a/app/apps/terminal/terminal-app.worker.ts +++ b/app/apps/terminal/terminal-app.worker.ts @@ -35,6 +35,7 @@ import { GrayImage, type UiFont } from "../../graphics/image"; import { flattenPlanesWithDraws, planesFingerprint, type Plane } from "../../graphics/plane"; import { prepareFrameDraws } from "../../graphics/glyph-wire"; import { getDefaultSmallFont, getTerminalFontConfig } from "../../graphics/ui-fonts"; +import { layoutHubHeader } from "./hub-header"; import { truncateText } from "../../graphics/textwrap"; import { TERMINAL_ICON_GLYPHS } from "../../graphics/icons"; import * as frameTimings from "../../native/frame-timings"; @@ -1497,13 +1498,13 @@ function paintHub(window: HubWindow): GrayImage { const font = chromeFont(); const step = lineStep(font); // No border box: the shell chrome (top bar + sidebar) already frames the app. - // Title and status share the top line. + // Long statuses get a wrapped block and move the list below it. const title = window.mode === "connections" ? "Terminal - Connections" : "Terminal"; image.drawText(font, 18, 10, title, 220); - const statusX = 18 + font.measureText(title) + 16; - image.drawText(font, statusX, 10, truncateText(font, hubStatusLine(window), Math.max(0, window.viewportWidth - statusX - 12)), 170); + const header = layoutHubHeader(font, title, hubStatusLine(window), window.viewportWidth, step); + header.lines.forEach((line, index) => image.drawText(font, header.x, header.y + index * step, line, 170)); - let listTop = 16 + step; + let listTop = header.listTop; if (window.mode === "sessions" && controls.size === 0) { image.drawText(font, 24, listTop, "Add a g2mirror:// connection to get started, see:", 150); image.drawText(font, 24, listTop + step, "https://github.com/jimrandomh/g2mirror", 190); diff --git a/app/bootstrap.ios.ts b/app/bootstrap.ios.ts index 977ab199..1878ffce 100644 --- a/app/bootstrap.ios.ts +++ b/app/bootstrap.ios.ts @@ -1,4 +1,8 @@ import { Application } from '@nativescript/core' -import { createMainPage } from './phone-ui/main-page.ios' +declare const FaceclawConfigPort: any + +// Apply transferred preferences before settings getters or app workers load. +FaceclawConfigPort.processPendingRequest() +const { createMainPage } = require('./phone-ui/main-page.ios') as typeof import('./phone-ui/main-page.ios') Application.run({ create: createMainPage }) diff --git a/app/native/g2mirror-client.ts b/app/native/g2mirror-client.ts index ae58dc40..c0b1274d 100644 --- a/app/native/g2mirror-client.ts +++ b/app/native/g2mirror-client.ts @@ -326,7 +326,9 @@ export class G2MirrorClient { */ submitInput(text: string): void { if (this.phase !== "attached") return; - const textByteLength = new java.lang.String(text).getBytes("UTF-8").length; + const textByteLength = global.isIOS + ? NSString.stringWithString(text).lengthOfBytesUsingEncoding(NSUTF8StringEncoding) + : new java.lang.String(text).getBytes("UTF-8").length; this.send({ type: "input", data: encodeBase64Utf8(`${text}\r`), diff --git a/tests/ios-config-native.cjs b/tests/ios-config-native.cjs new file mode 100644 index 00000000..a2653a0d --- /dev/null +++ b/tests/ios-config-native.cjs @@ -0,0 +1,10 @@ +const { execFileSync } = require('node:child_process'); +const { mkdtempSync, rmSync } = require('node:fs'); +const { tmpdir } = require('node:os'); +const { join, resolve } = require('node:path'); +const root = resolve(__dirname, '..'), dir = mkdtempSync(join(tmpdir(), 'faceclaw-config-')); +try { + execFileSync('xcrun', ['clang', '-fobjc-arc', '-framework', 'Foundation', '-I', 'App_Resources/iOS/src', + 'tests/native/ios-config-test.m', 'App_Resources/iOS/src/FaceclawConfigPort.m', '-o', join(dir, 'config-test')], { cwd: root, stdio: 'inherit' }); + execFileSync(join(dir, 'config-test'), [dir], { stdio: 'inherit' }); +} finally { rmSync(dir, { recursive: true, force: true }); } diff --git a/tests/ios-config-scripts.test.cjs b/tests/ios-config-scripts.test.cjs new file mode 100644 index 00000000..ea58f159 --- /dev/null +++ b/tests/ios-config-scripts.test.cjs @@ -0,0 +1,21 @@ +const test = require('node:test'); +const { execFileSync } = require('node:child_process'); +test('iOS config codec preserves Android XML and JSON types and rejects malformed imports', () => { + execFileSync('python3', ['-c', ` +import importlib.util, pathlib, tempfile +spec = importlib.util.spec_from_file_location('config', 'scripts/ios_config.py') +m = importlib.util.module_from_spec(spec); spec.loader.exec_module(m) +values = {'terminal.connections': '[{"url":"g2mirror://test@host"}]', 'flag': True, 'empty': '', 'number': 42, 'ratio': 0.25, 'unicode': 'π & < 🔋\\nnext'} +with tempfile.TemporaryDirectory() as d: + p = pathlib.Path(d) / 'settings' + for xml in [False, True]: + m.atomic_write(p, m.encode_config(values, xml)) + assert m.read_config(p) == values + assert p.stat().st_mode & 0o777 == 0o600 + for invalid in [b'{}', b'', b'', b'ab', b'{"schema":1,"settings":{"x":null}}', b'{"schema":1,"settings":{"x":NaN}}', b'oops']: + p.write_bytes(invalid) + try: m.read_config(p) + except (ValueError, m.ET.ParseError): pass + else: raise AssertionError('accepted invalid config') +`], { stdio: 'inherit' }); +}); diff --git a/tests/ios-speech-transcript-native.cjs b/tests/ios-speech-transcript-native.cjs new file mode 100644 index 00000000..49462c11 --- /dev/null +++ b/tests/ios-speech-transcript-native.cjs @@ -0,0 +1,10 @@ +const { execFileSync } = require('node:child_process'); +const { mkdtempSync, rmSync } = require('node:fs'); +const { tmpdir } = require('node:os'); +const { join } = require('node:path'); +const dir = mkdtempSync(join(tmpdir(), 'faceclaw-transcript-')); +try { + execFileSync('xcrun', ['clang', '-fobjc-arc', '-framework', 'Foundation', '-I', 'App_Resources/iOS/src', + 'tests/native/ios-speech-transcript-test.m', 'App_Resources/iOS/src/FaceclawSpeechTranscript.m', '-o', join(dir, 'test')], { stdio: 'inherit' }); + execFileSync(join(dir, 'test'), [], { stdio: 'inherit' }); +} finally { rmSync(dir, { recursive: true, force: true }); } diff --git a/tests/ios-terminal-input.test.cjs b/tests/ios-terminal-input.test.cjs new file mode 100644 index 00000000..e58e02ce --- /dev/null +++ b/tests/ios-terminal-input.test.cjs @@ -0,0 +1,43 @@ +const test = require('node:test'); +const assert = require('node:assert/strict'); +const fs = require('node:fs'); +const vm = require('node:vm'); +const ts = require('typescript'); +function load(file, context) { + const sandbox = { exports: {}, ...context }; + vm.runInNewContext(ts.transpileModule(fs.readFileSync(file, 'utf8'), { + compilerOptions: { module: ts.ModuleKind.CommonJS, target: ts.ScriptTarget.ES2020 } }).outputText, sandbox); + return sandbox.exports; +} +test('iOS Type Into App submits UTF-8 terminal text and delays Enter at the byte boundary without Java', () => { + const sent = []; + const { G2MirrorClient } = load('app/native/g2mirror-client.ts', { + require: () => ({}), global: { isIOS: true }, NSUTF8StringEncoding: 4, + NSString: { stringWithString: text => ({ + lengthOfBytesUsingEncoding: () => Buffer.byteLength(text, 'utf8'), + dataUsingEncoding: () => ({ base64EncodedStringWithOptions: () => Buffer.from(text).toString('base64') }), + }) }, + }); + const client = new G2MirrorClient({}); + client.ws = { sendText: json => sent.push(JSON.parse(json)) }; + client.handleMessage(JSON.stringify({ type: 'connect', command: 'test' })); + const { VoiceInputLayer } = load('app/ui/shell/voice-input.ts', { + require: id => id.includes('voice-control') ? { voiceControlBridge: { stop() {} } } + : id.includes('dashboard-settings') ? { anthropicApiKeySetting: { get: () => '' } } : {}, + global: { isIOS: true }, + }); + for (const text of ['hello terminal', 'café π 🔋', 'line one\n第二行', '']) { + let closed = false; + const layer = new VoiceInputLayer({ actions: { requestRender() {} }, onClosed() {}, + dismiss() { closed = true; layer.onRemoved(); }, sendTargets: [{ id: 'app', label: 'Type Into App', onSend: value => client.submitInput(value) }] }); + layer.onTranscript({ text, isFinal: true }); + const count = sent.length; + layer.menuRows()[0].onSelect(); + assert.equal(closed, true); + if (!text) { assert.equal(sent.length, count); continue; } + const message = sent.at(-1); + assert.equal(message.type, 'input'); + assert.equal(Buffer.from(message.data, 'base64').toString('utf8'), text + '\r'); + assert.deepEqual(message.delays, [{ at: Buffer.byteLength(text), ms: 150 }]); + } +}); diff --git a/tests/native/ios-config-test.m b/tests/native/ios-config-test.m new file mode 100644 index 00000000..a5420335 --- /dev/null +++ b/tests/native/ios-config-test.m @@ -0,0 +1,35 @@ +#import +#import "FaceclawConfigPort.h" +#include +static NSDictionary *send(NSString *dir, NSUserDefaults *defaults, NSString *domain, NSDictionary *request) { + NSData *json = [NSJSONSerialization dataWithJSONObject:request options:0 error:nil]; + assert([json writeToFile:[dir stringByAppendingPathComponent:@"request.json"] atomically:YES]); + [FaceclawConfigPort processDirectory:dir defaults:defaults domain:domain]; + assert(![NSFileManager.defaultManager fileExistsAtPath:[dir stringByAppendingPathComponent:@"request.json"]]); + return [NSJSONSerialization JSONObjectWithData:[NSData dataWithContentsOfFile:[dir stringByAppendingPathComponent:@"response.json"]] options:0 error:nil]; +} +int main(int argc, const char **argv) { @autoreleasepool { + NSString *dir = [NSString stringWithUTF8String:argv[1]]; + NSString *domain = [@"com.faceclaw.config-test." stringByAppendingString:NSUUID.UUID.UUIDString]; + NSUserDefaults *defaults = [[NSUserDefaults alloc] initWithSuiteName:domain]; + [defaults setPersistentDomain:@{@"keep":@"original", @"enabled":@NO} forName:domain]; + NSDictionary *input = @{@"terminal.connections":@"[{\"url\":\"g2mirror://test@host\"}]", @"enabled":@YES, @"empty":@"", @"number":@42, @"unicode":@"π & < \n 🔋"}; + NSDictionary *reply = send(dir, defaults, domain, @{@"id":@"1", @"operation":@"push", @"settings":input}); + assert([reply[@"ok"] boolValue] && [reply[@"count"] intValue] == 5); + assert([[defaults persistentDomainForName:domain][@"keep"] isEqual:@"original"]); + NSDictionary *backup = [NSDictionary dictionaryWithContentsOfFile:[dir stringByAppendingPathComponent:@"previous.plist"]]; + assert([backup[@"keep"] isEqual:@"original"] && ![backup[@"enabled"] boolValue]); + reply = send(dir, defaults, domain, @{@"id":@"2", @"operation":@"pull"}); + assert([reply[@"id"] isEqual:@"2"] && [reply[@"ok"] boolValue]); + NSDictionary *output = reply[@"config"][@"settings"]; + for (NSString *key in input) assert([output[key] isEqual:input[key]]); + assert(!output[@"ios.settings.changeToken"]); + NSDictionary *before = [defaults persistentDomainForName:domain]; + reply = send(dir, defaults, domain, @{@"id":@"3", @"operation":@"push", @"settings":@{@"keep":@"changed", @"invalid":@[]}}); + assert(![reply[@"ok"] boolValue]); + assert([[defaults persistentDomainForName:domain] isEqual:before]); + reply = send(dir, defaults, domain, @{@"id":@"4", @"operation":@"bad"}); + assert(![reply[@"ok"] boolValue]); + [defaults removePersistentDomainForName:domain]; [defaults synchronize]; + puts("PASS: native config merges typed values, backs up, exports, consumes requests once and rejects invalid imports atomically"); +} return 0; } diff --git a/tests/native/ios-speech-transcript-test.m b/tests/native/ios-speech-transcript-test.m new file mode 100644 index 00000000..873ab0a0 --- /dev/null +++ b/tests/native/ios-speech-transcript-test.m @@ -0,0 +1,28 @@ +#import +#import "FaceclawSpeechTranscript.h" +#include +static void check(NSString *actual, NSString *expected) { assert([actual isEqual:expected]); } +int main(void) { @autoreleasepool { + FaceclawSpeechTranscript *t = [FaceclawSpeechTranscript new]; + check([t updateText:@"How" start:0 duration:0 settled:NO final:NO], @"How"); + check([t updateText:@"How are you" start:0 duration:0 settled:NO final:NO], @"How are you"); + check([t updateText:@"How are you?" start:0.5 duration:1.2 settled:YES final:NO], @"How are you?"); + check([t updateText:@"How are you?" start:0.5 duration:1.2 settled:YES final:NO], @"How are you?"); + check([t updateText:@"Fine" start:0 duration:0 settled:NO final:NO], @"How are you? Fine"); + check([t updateText:@"Fine thanks" start:0 duration:0 settled:NO final:NO], @"How are you? Fine thanks"); + check([t updateText:@"Fine, thanks." start:3 duration:1 settled:YES final:NO], @"How are you? Fine, thanks."); + check([t updateText:@"" start:0 duration:0 settled:YES final:NO], @"How are you? Fine, thanks."); + check([t updateText:@"Fine, thanks." start:0 duration:0 settled:YES final:YES], @"How are you? Fine, thanks."); + // Identical utterances are real repetition, not duplicate callbacks. + check([t updateText:@"Fine, thanks." start:0 duration:0 settled:NO final:NO], @"How are you? Fine, thanks. Fine, thanks."); + check([t updateText:@"Fine, thanks." start:5 duration:1 settled:YES final:NO], @"How are you? Fine, thanks. Fine, thanks."); + // Some OS/model combinations return cumulative text; retain it once. + check([t updateText:@"How are you? Fine, thanks. Fine, thanks." start:0.5 duration:5.5 settled:YES final:NO], @"How are you? Fine, thanks. Fine, thanks."); + t = [FaceclawSpeechTranscript new]; + check([t updateText:@"I scream" start:0.5 duration:1 settled:NO final:NO], @"I scream"); + check([t updateText:@"Ice cream" start:0.5 duration:1.1 settled:NO final:NO], @"Ice cream"); + check([t updateText:@"Ice cream is good." start:0.5 duration:2 settled:YES final:NO], @"Ice cream is good."); + check([t updateText:@"Next sentence" start:4 duration:1 settled:NO final:NO], @"Ice cream is good. Next sentence"); + check([t updateText:@"Next sentence." start:4 duration:1 settled:YES final:NO], @"Ice cream is good. Next sentence."); + puts("PASS: utterance accumulation, live revisions, repeated words, duplicate/cumulative results and empty final callbacks"); +} return 0; } diff --git a/tests/terminal-header.test.cjs b/tests/terminal-header.test.cjs new file mode 100644 index 00000000..ff697abc --- /dev/null +++ b/tests/terminal-header.test.cjs @@ -0,0 +1,30 @@ +const test = require('node:test'); +const assert = require('node:assert/strict'); +const { layoutHubHeader } = require('../.test-build/app/apps/terminal/hub-header.js'); +const font = size => ({ measureText: text => [...text].length * size, getGlyph: () => ({ dwidthX: size }) }); +test('terminal short status stays inline; exact-fit status does not move the list', () => { + const f = font(7), title = 'Terminal', status = 'Connected.'; + const width = 18 + f.measureText(title) + 16 + f.measureText(status) + 12; + const header = layoutHubHeader(f, title, status, width, 18); + assert.equal(header.y, 10); assert.equal(header.listTop, 34); assert.deepEqual(header.lines, [status]); + assert.equal(layoutHubHeader(f, title, status, width - 1, 18).y, 28); +}); +test('terminal long error wraps in full-width block and moves menu below all lines at each font size', () => { + const status = 'Connection failed. The resource could not be loaded because the App Transport Security policy requires the use of a secure connection.'; + for (const size of [5, 7, 12, 20]) for (const width of [320, 576, 640]) { + const f = font(size), step = size * 2; + const header = layoutHubHeader(f, 'Terminal - Connections', status, width, step); + assert.equal(header.x, 18); assert.equal(header.y, 10 + step); + assert.equal(header.lines.join(' '), status); + assert.ok(header.lines.every(line => f.measureText(line) <= width - 30)); + assert.ok(header.listTop >= header.y + header.lines.length * step); + assert.equal(header.listTop, 16 + step * (1 + header.lines.length)); + } +}); +test('terminal explicit newlines and long unbroken messages remain complete', () => { + const h = layoutHubHeader(font(7), 'Terminal', 'First\nSecond', 640, 18); + assert.equal(h.x, 18); assert.deepEqual(h.lines, ['First', 'Second']); + const word = 'x'.repeat(200); + const wrapped = layoutHubHeader(font(7), 'Terminal', word, 320, 18); + assert.equal(wrapped.lines.join(''), word); +}); diff --git a/tests/tsconfig.json b/tests/tsconfig.json index 8d1b49d9..4e947d45 100644 --- a/tests/tsconfig.json +++ b/tests/tsconfig.json @@ -12,6 +12,7 @@ }, "include": [ "../app/g2/ble-protocol.ts", + "../app/apps/terminal/hub-header.ts", "../app/g2/ios-peripheral-identity.ts", "../app/g2/glasses-session.ts", "../app/graphics/surface-compositor.ts", From 16764359bd10ab2b13986e9b75dbd8b53cdc4f01 Mon Sep 17 00:00:00 2001 From: James Babcock Date: Tue, 8 Sep 2026 12:42:45 -0700 Subject: [PATCH 09/99] iOS porting: Work around missing punctuation between segments in multi-segment Siri voice input --- .../iOS/src/FaceclawSpeechTranscript.m | 26 ++++++++++++++++-- tests/native/ios-speech-transcript-test.m | 27 +++++++++++++++++++ 2 files changed, 51 insertions(+), 2 deletions(-) diff --git a/App_Resources/iOS/src/FaceclawSpeechTranscript.m b/App_Resources/iOS/src/FaceclawSpeechTranscript.m index f8acfdd1..934b5806 100644 --- a/App_Resources/iOS/src/FaceclawSpeechTranscript.m +++ b/App_Resources/iOS/src/FaceclawSpeechTranscript.m @@ -8,15 +8,37 @@ if ((self = [super init])) _utterances = [NSMutableArray new]; return self; } -- (NSString *)text { +// Only infer a sentence boundary between separate recognizer utterances. +// Keep the raw hypotheses unchanged so later revisions remain authoritative. +static NSString *sentenceJoin(NSString *previous, NSString *next) { + NSCharacterSet *openingQuotes = [NSCharacterSet characterSetWithCharactersInString:@"\"'“‘«"]; + NSUInteger first = 0; + while (first < next.length && [openingQuotes characterIsMember:[next characterAtIndex:first]]) first++; + if (first == next.length || ![NSCharacterSet.uppercaseLetterCharacterSet characterIsMember:[next characterAtIndex:first]]) return previous; + NSCharacterSet *closingQuotes = [NSCharacterSet characterSetWithCharactersInString:@"\"'”’»"]; + NSUInteger end = previous.length; + while (end && [closingQuotes characterIsMember:[previous characterAtIndex:end - 1]]) end--; + if (!end || [NSCharacterSet.punctuationCharacterSet characterIsMember:[previous characterAtIndex:end - 1]]) return previous; + return [NSString stringWithFormat:@"%@.%@", [previous substringToIndex:end], [previous substringFromIndex:end]]; +} +- (NSString *)rawText { NSMutableArray *parts = [NSMutableArray new]; for (NSDictionary *utterance in self.utterances) [parts addObject:utterance[@"text"]]; return [parts componentsJoinedByString:@" "]; } +- (NSString *)text { + NSMutableArray *parts = [NSMutableArray new]; + for (NSUInteger i = 0; i < self.utterances.count; i++) { + NSString *part = self.utterances[i][@"text"]; + if (i + 1 < self.utterances.count) part = sentenceJoin(part, self.utterances[i + 1][@"text"]); + [parts addObject:part]; + } + return [parts componentsJoinedByString:@" "]; +} - (NSString *)updateText:(NSString *)text start:(NSTimeInterval)start duration:(NSTimeInterval)duration settled:(BOOL)settled final:(BOOL)final { text = [text stringByTrimmingCharactersInSet:NSCharacterSet.whitespaceAndNewlineCharacterSet]; // Apple's final callback can be empty after a pause. Keep the best result. - if (!text.length || (final && [text isEqual:self.text])) return self.text; + if (!text.length || (final && ([text isEqual:self.text] || [text isEqual:self.rawText]))) return self.text; BOOL timed = isfinite(start) && start >= 0 && isfinite(duration) && duration > 0; NSUInteger index = self.utterances.count; if (timed) { diff --git a/tests/native/ios-speech-transcript-test.m b/tests/native/ios-speech-transcript-test.m index 873ab0a0..0ce8d549 100644 --- a/tests/native/ios-speech-transcript-test.m +++ b/tests/native/ios-speech-transcript-test.m @@ -24,5 +24,32 @@ int main(void) { @autoreleasepool { check([t updateText:@"Ice cream is good." start:0.5 duration:2 settled:YES final:NO], @"Ice cream is good."); check([t updateText:@"Next sentence" start:4 duration:1 settled:NO final:NO], @"Ice cream is good. Next sentence"); check([t updateText:@"Next sentence." start:4 duration:1 settled:YES final:NO], @"Ice cream is good. Next sentence."); + t = [FaceclawSpeechTranscript new]; + check([t updateText:@"First sentence" start:0 duration:1 settled:YES final:NO], @"First sentence"); + check([t updateText:@"Second" start:0 duration:0 settled:NO final:NO], @"First sentence. Second"); + check([t updateText:@"Second sentence" start:2 duration:1 settled:YES final:NO], @"First sentence. Second sentence"); + check([t updateText:@"Third" start:0 duration:0 settled:NO final:NO], @"First sentence. Second sentence. Third"); + check([t updateText:@"Third" start:4 duration:1 settled:YES final:NO], @"First sentence. Second sentence. Third"); + // A cumulative final without punctuation must not erase inferred joins. + check([t updateText:@"First sentence Second sentence Third" start:0 duration:5 settled:YES final:YES], @"First sentence. Second sentence. Third"); + // Lowercase continuation: a pause alone does not introduce a period. + t = [FaceclawSpeechTranscript new]; + check([t updateText:@"We should" start:0 duration:1 settled:YES final:NO], @"We should"); + check([t updateText:@"keep going" start:2 duration:1 settled:YES final:NO], @"We should keep going"); + // Existing punctuation (including non-ASCII) always wins. + for (NSString *punctuation in @[@".", @"?", @"!", @",", @":", @";", @"—", @"…", @"。", @"!"]) { + t = [FaceclawSpeechTranscript new]; + NSString *first = [@"First" stringByAppendingString:punctuation]; + [t updateText:first start:0 duration:1 settled:YES final:NO]; + check([t updateText:@"Next" start:2 duration:1 settled:YES final:NO], [first stringByAppendingString:@" Next"]); + } + t = [FaceclawSpeechTranscript new]; + [t updateText:@"He said “yes”" start:0 duration:1 settled:YES final:NO]; + check([t updateText:@"“Then go”" start:2 duration:1 settled:YES final:NO], @"He said “yes.” “Then go”"); + // A revised lowercase start removes the inferred period; raw text survives. + t = [FaceclawSpeechTranscript new]; + [t updateText:@"Keep" start:0 duration:1 settled:YES final:NO]; + check([t updateText:@"Going" start:2 duration:1 settled:NO final:NO], @"Keep. Going"); + check([t updateText:@"going" start:2 duration:1 settled:YES final:NO], @"Keep going"); puts("PASS: utterance accumulation, live revisions, repeated words, duplicate/cumulative results and empty final callbacks"); } return 0; } From 79b6c276f835923dde48adf7531f51d1d03af36e Mon Sep 17 00:00:00 2001 From: James Babcock Date: Tue, 8 Sep 2026 13:18:50 -0700 Subject: [PATCH 10/99] iOS porting: Image-sending performance: Pipelining, bounding-box updates --- app/g2/ble-image-optimizer.ts | 34 ++++ app/g2/ble-traffic-counters.ts | 17 ++ app/g2/glasses-session.ts | 82 ++++++++-- app/native/ble-traffic.ios.ts | 3 + app/phone-ui/ble-bandwidth-meter.ts | 27 ++++ app/phone-ui/main-page.ios.ts | 43 ++++- app/phone-ui/main-view-model.ts | 37 +---- app/ui/dashboard-settings.ts | 2 +- app/ui/dashboard/settings-menus.ts | 3 +- tests/ble-bandwidth.test.cjs | 24 +++ tests/ble-image-optimizer.test.cjs | 67 ++++++++ tests/helpers/display-payload.cjs | 25 +++ tests/ios-app-host.test.cjs | 46 ++++++ tests/ios-ble.test.cjs | 238 ++++++++++++++++++++++++++++ tests/tsconfig.json | 1 + 15 files changed, 592 insertions(+), 57 deletions(-) create mode 100644 app/g2/ble-image-optimizer.ts create mode 100644 app/g2/ble-traffic-counters.ts create mode 100644 app/native/ble-traffic.ios.ts create mode 100644 app/phone-ui/ble-bandwidth-meter.ts create mode 100644 tests/ble-bandwidth.test.cjs create mode 100644 tests/ble-image-optimizer.test.cjs create mode 100644 tests/helpers/display-payload.cjs diff --git a/app/g2/ble-image-optimizer.ts b/app/g2/ble-image-optimizer.ts new file mode 100644 index 00000000..46948a67 --- /dev/null +++ b/app/g2/ble-image-optimizer.ts @@ -0,0 +1,34 @@ +import { concat, rle4 } from './ble-protocol' + +/** Android BleImageOptimizer's mode-3 changed rectangle. Coordinates are in + * units of 4 columns / 2 rows; pixels are top-down packed 4bpp, high nibble first. + * null means identical, incomparable, or a full-screen box: use dedup/mode 6. + */ +export function buildBoundingBoxPayload(previous: Uint8Array | null, next: Uint8Array, + width: number, height: number, frameId: number, deflate: (data: Uint8Array) => Uint8Array): Uint8Array | null { + if (!Number.isInteger(width) || !Number.isInteger(height) || width <= 0 || height <= 0 || + width % 4 || height % 2 || width / 4 > 255 || height / 2 > 255 || + !previous || previous.length !== width * height / 2 || next.length !== previous.length) return null + const stride = width / 2 + let minX = stride, maxX = -1, minY = height, maxY = -1 + for (let y = 0; y < height; y++) { + const row = y * stride + for (let x = 0; x < stride; x++) { + if (previous[row + x] === next[row + x]) continue + minX = Math.min(minX, x); maxX = Math.max(maxX, x) + minY = Math.min(minY, y); maxY = y + } + } + if (maxY < 0) return null + const left = (minX * 2) & ~3, right = Math.min(width, ((maxX + 1) * 2 + 3) & ~3) + const top = minY & ~1, bottom = Math.min(height, (maxY + 2) & ~1) + const boxWidth = right - left, boxHeight = bottom - top + if (boxWidth === width && boxHeight === height) return null + const regionStride = boxWidth / 2, region = new Uint8Array(regionStride * boxHeight) + for (let y = 0; y < boxHeight; y++) { + const start = (top + y) * stride + left / 2 + region.set(next.subarray(start, start + regionStride), y * regionStride) + } + return concat(new Uint8Array([3, left / 4, top / 2, boxWidth / 4, boxHeight / 2, + frameId & 255, (frameId >>> 8) & 255]), deflate(rle4(region))) +} diff --git a/app/g2/ble-traffic-counters.ts b/app/g2/ble-traffic-counters.ts new file mode 100644 index 00000000..d37023aa --- /dev/null +++ b/app/g2/ble-traffic-counters.ts @@ -0,0 +1,17 @@ +/** Same units as Android FaceclawBleManager: protocol messages, framed write + * bytes accepted by the transport, and fully acknowledged display updates. + * Totals survive reconnects and the setting being switched off. + */ +export class BleTrafficCounters { + private messages = 0 + private bytes = 0 + private frames = 0 + recordWrite(bytes: number): void { this.bytes += bytes } + recordMessage(): void { this.messages++ } + recordDisplayFrame(): void { this.frames++ } + sample(): { messages: number; bytes: number; frames: number } { + return { messages: this.messages, bytes: this.bytes, frames: this.frames } + } +} +// The iOS BLE session and phone UI both run in the main isolate. +export const iosBleTraffic = new BleTrafficCounters() diff --git a/app/g2/glasses-session.ts b/app/g2/glasses-session.ts index 7066fc99..e18190b5 100644 --- a/app/g2/glasses-session.ts +++ b/app/g2/glasses-session.ts @@ -1,4 +1,6 @@ import * as protocol from './ble-protocol' +import { iosBleTraffic } from './ble-traffic-counters' +import { buildBoundingBoxPayload } from './ble-image-optimizer' import { hexToBytes } from '../util/hex-util' import { deviceAddressError } from './ios-peripheral-identity' @@ -20,6 +22,10 @@ export type SessionState = { phase: 'disconnected' | 'connecting' | 'connected' type PendingAck = { resolve: (message: protocol.ProtocolMessage) => void; reject: (error: Error) => void; timer: number | null; command: number; label: string } class AckTimeout extends Error {} +// Match Android ConnectionOptions.WINDOW_SIZE. This bounds complete image +// messages queued for writing or awaiting ACK, not individual BLE packets. +const DISPLAY_WINDOW_SIZE = 3 +type DisplayFrame = { packed: Uint8Array; payload: Uint8Array; offset: number; pending: number } /** G2 session independent of the phone OS. Images go to L, control to R, as on Android. */ export class GlassesSession { @@ -43,6 +49,12 @@ export class GlassesSession { private addresses: SessionAddresses | null = null private latest: Uint8Array | null = null private displayed: Uint8Array | null = null + private lastEnqueued: Uint8Array | null = null + // Match Android: advance only for emitted deltas, skipping 0 / 0xffff. + private nextImageFrameId = 1 + private displayFrames: DisplayFrame[] = [] + private displaySending: DisplayFrame | null = null + private displayInFlight = 0 private pumping = false private lastHeartbeat = 0 private lastLease = 0 @@ -192,8 +204,15 @@ export class GlassesSession { if (!identifier) return Promise.reject(new Error(`No ${role} device connected`)) const frames = protocol.frameMessage(payload, sid, flag, this.sequence++, this.limits[role]) const previous = this.writes.get(identifier) ?? Promise.resolve() - const work = previous.catch(() => {}).then(async () => { - for (const frame of frames) { this.check(generation); await this.transport.write(identifier, protocol.G2_WRITE, frame) } + // A failed write poisons this link's queue until reset: do not transmit + // later fragments after a hole in the image stream. + const work = previous.then(async () => { + for (const frame of frames) { + this.check(generation) + await this.transport.write(identifier, protocol.G2_WRITE, frame) + iosBleTraffic.recordWrite(frame.length) + } + iosBleTraffic.recordMessage() }) // A whole message owns the write queue; heartbeat packets cannot split an image message. this.writes.set(identifier, work) @@ -312,6 +331,49 @@ export class GlassesSession { if (this.timer !== null || this.pumping || this.state.phase !== 'connected') return this.timer = setTimeout(() => { this.timer = null; void this.pump() }, delay) } + private canSendDisplay(): boolean { + // Also bound completed frames retained behind a missing/out-of-order ACK. + return this.displayInFlight < DISPLAY_WINDOW_SIZE && !!(this.displaySending || + (this.latest && !this.charging && this.displayFrames.length < DISPLAY_WINDOW_SIZE)) + } + private fillDisplayWindow(generation: number): void { + while (this.canSendDisplay()) { + if (!this.displaySending) { + const packed = this.latest!; this.latest = null + // Compare with the last enqueued image, not the last ACKed one. In an + // A -> B -> A sequence, B may still be in flight when A is requested. + if (this.lastEnqueued && packed.every((value, i) => value === this.lastEnqueued![i])) continue + const delta = buildBoundingBoxPayload(this.lastEnqueued, packed, 640, 480, this.nextImageFrameId, this.deflate) + const payload = delta ?? protocol.concat(new Uint8Array([6]), this.deflate(protocol.rle4(packed))) + if (payload.length > 165888) throw new Error('Compressed frame exceeds the glasses image buffer') + if (delta) { + this.nextImageFrameId = this.nextImageFrameId >= 0xfffe ? 1 : this.nextImageFrameId + 1 + this.log(`Display bbox ${delta[3] * 4}x${delta[4] * 2}+${delta[1] * 4}+${delta[2] * 2} fid=${delta[5] | (delta[6] << 8)} (${payload.length} bytes)`) + } else this.log(`Display full 640x480 (${payload.length} bytes)`) + this.displaySending = { packed, payload, offset: 0, pending: 0 } + this.displayFrames.push(this.displaySending); this.lastEnqueued = packed + } + const frame = this.displaySending, offset = frame.offset + frame.offset += 3800; frame.pending++; this.displayInFlight++ + if (frame.offset >= frame.payload.length) this.displaySending = null + // send() serializes whole messages on L, but request() waits for each + // magic's ACK independently. Fill the other slots without awaiting it. + void this.request('left', protocol.SID.hub, magic => protocol.imageFragment(magic, frame.payload, offset), 'Display frame').then(() => { + if (generation !== this.generation) return + frame.pending--; this.displayInFlight--; this.lastHeartbeat = Date.now() + // Retire in submission order even if relayed ACKs arrive out of order. + // A frame counts only after every fragment has been acknowledged. + while (this.displayFrames.length) { + const completed = this.displayFrames[0] + if (completed.offset < completed.payload.length || completed.pending) break + this.displayFrames.shift(); this.displayed = completed.packed + this.state.frames++; iosBleTraffic.recordDisplayFrame(); this.onState({ ...this.state }) + this.log(`Display frame ${this.state.frames} acknowledged (${completed.payload.length} bytes)`) + } + this.wake() + }).catch(error => { if (generation === this.generation) this.fail(error, true) }) + } + } private async pump(): Promise { if (this.pumping || this.state.phase !== 'connected') return this.pumping = true; const generation = this.generation @@ -327,19 +389,10 @@ export class GlassesSession { const settings = await this.request('right', protocol.SID.settings, protocol.settingsQuery, 'Battery query') this.applySettings(settings); this.lastSettings = Date.now() } - const frame = this.latest; this.latest = null - if (frame && !this.charging && (!this.displayed || !frame.every((value, i) => value === this.displayed![i]))) { - const payload = protocol.concat(new Uint8Array([6]), this.deflate(protocol.rle4(frame))) - if (payload.length > 165888) throw new Error('Compressed frame exceeds the glasses image buffer') - for (let offset = 0; offset < payload.length; offset += 3800) { - await this.request('left', protocol.SID.hub, magic => protocol.imageFragment(magic, payload, offset), 'Display frame') - this.check(generation); this.lastHeartbeat = Date.now() - } - this.displayed = frame; this.state.frames++; this.onState({ ...this.state }) - this.log(`Display frame ${this.state.frames} acknowledged (${payload.length} bytes)`) - } else if (frame && this.charging) this.latest = frame + this.check(generation) + this.fillDisplayWindow(generation) } catch (error) { if (generation === this.generation) this.fail(error, true) } - finally { if (generation === this.generation) { this.pumping = false; this.schedule(this.latest && !this.charging ? 0 : 1000) } } + finally { if (generation === this.generation) { this.pumping = false; this.schedule(this.canSendDisplay() ? 0 : 1000) } } } private reset(): void { ++this.generation @@ -352,6 +405,7 @@ export class GlassesSession { const pending = [...this.pending.values()]; this.pending.clear() for (const request of pending) { if (request.timer) clearTimeout(request.timer); request.reject(new Error('Connection ended')) } this.receiver.clear(); this.writes.clear(); this.latest = this.displayed = null + this.lastEnqueued = null; this.displayFrames = []; this.displaySending = null; this.displayInFlight = 0 } private closeLinks(): void { const ids = this.ids; this.ids = {}; this.limits = {} diff --git a/app/native/ble-traffic.ios.ts b/app/native/ble-traffic.ios.ts new file mode 100644 index 00000000..ef3f9a25 --- /dev/null +++ b/app/native/ble-traffic.ios.ts @@ -0,0 +1,3 @@ +import { iosBleTraffic } from '../g2/ble-traffic-counters' +export type { BleTrafficSample } from './ble-traffic' +export function sampleBleTraffic(): { messages: number; bytes: number; frames: number } { return iosBleTraffic.sample() } diff --git a/app/phone-ui/ble-bandwidth-meter.ts b/app/phone-ui/ble-bandwidth-meter.ts new file mode 100644 index 00000000..b534f009 --- /dev/null +++ b/app/phone-ui/ble-bandwidth-meter.ts @@ -0,0 +1,27 @@ +import type { BleTrafficSample } from '../native/ble-traffic' + +/** Shared Android/iOS five-second traffic readout. Poll once per second. */ +export class BleBandwidthMeter { + private history: Array<{ atMs: number; bytes: number; frames: number }> = [] + reset(): void { this.history = [] } + sample(sample: BleTrafficSample, atMs: number): string { + const previous = this.history[this.history.length - 1] + if (previous && (atMs <= previous.atMs || sample.bytes < previous.bytes || sample.frames < previous.frames)) this.reset() + this.history.push({ atMs, bytes: sample.bytes, frames: sample.frames }) + while (this.history.length && this.history[0]!.atMs < atMs - 5000) this.history.shift() + let label = `BLE sent: ${formatCount(sample.messages)} messages, ${formatCount(sample.bytes)} bytes` + const oldest = this.history[0]!, elapsedSec = (atMs - oldest.atMs) / 1000 + if (elapsedSec > 0) { + const byteDelta = sample.bytes - oldest.bytes, frameDelta = sample.frames - oldest.frames + label += ` · ${formatByteRate(byteDelta / elapsedSec)}, ${(frameDelta / elapsedSec).toFixed(1)} fps` + if (frameDelta > 0) label += `, ${formatCount(byteDelta / frameDelta)} B/frame` + } + return label + } +} +function formatCount(value: number): string { return String(Math.round(value)).replace(/\B(?=(\d{3})+(?!\d))/g, ',') } +function formatByteRate(bytesPerSec: number): string { + if (bytesPerSec >= 1e6) return (bytesPerSec / 1e6).toFixed(2) + ' MB/s' + if (bytesPerSec >= 1e3) return (bytesPerSec / 1e3).toFixed(1) + ' kB/s' + return Math.round(bytesPerSec) + ' B/s' +} diff --git a/app/phone-ui/main-page.ios.ts b/app/phone-ui/main-page.ios.ts index a681c919..6e50eac8 100644 --- a/app/phone-ui/main-page.ios.ts +++ b/app/phone-ui/main-page.ios.ts @@ -3,7 +3,9 @@ import { createConfigureDevicesPage } from './config-page.ios' import { ALL_APPS } from '../apps/all-apps' import { IosPreviewController } from '../g2/ios-preview-controller' import { PhoneGestureRecognizer } from './phone-gestures' -import { onAnySettingChanged, previewColorSetting } from '../ui/dashboard-settings' +import { BleBandwidthMeter } from './ble-bandwidth-meter' +import { sampleBleTraffic } from '../native/ble-traffic' +import { onAnySettingChanged, previewColorSetting, showBleBandwidthSetting } from '../ui/dashboard-settings' import { loadDeviceAddresses } from '../g2/device-addresses' import { deviceAddressError } from '../g2/ios-peripheral-identity' @@ -11,7 +13,7 @@ export function createMainPage(): Page { const page = new Page() page.actionBarHidden = true const root = new GridLayout() - root.rows = 'auto,*' + root.rows = 'auto,*,auto' page.content = root const header = new GridLayout() header.columns = '*,auto'; header.padding = '12 20' @@ -127,20 +129,44 @@ export function createMainPage(): Page { view.padding = '16 8'; view.fontSize = 14 GridLayout.setColumn(view, index); footer.addChild(view) } + const bandwidth = new Label() + bandwidth.accessibilityIdentifier = 'ble-bandwidth-indicator' + bandwidth.fontSize = 10; bandwidth.textWrap = true; bandwidth.padding = '2 8 4' + bandwidth.color = new Color('#68756c'); bandwidth.isUserInteractionEnabled = false + bandwidth.visibility = 'collapse' + GridLayout.setRow(bandwidth, 2); root.addChild(bandwidth) + const bandwidthMeter = new BleBandwidthMeter() + let bandwidthTimer: ReturnType | null = null + let foreground = false + function stopBandwidth(): void { + if (bandwidthTimer !== null) clearInterval(bandwidthTimer) + bandwidthTimer = null; bandwidthMeter.reset() + } + function syncBandwidth(): void { + if (!foreground) { stopBandwidth(); return } + const enabled = showBleBandwidthSetting.get() + bandwidth.visibility = enabled ? 'visible' : 'collapse' + if (!enabled) { stopBandwidth(); return } + if (bandwidthTimer !== null) return + const refresh = () => { bandwidth.text = bandwidthMeter.sample(sampleBleTraffic(), Date.now()) } + refresh(); bandwidthTimer = setInterval(refresh, 1000) + } let lastLayout = '' function layout(): void { const size = root.getActualSize() if (size.width <= 0 || size.height <= 0) return - const key = `${size.width}:${size.height}:${selectedTab}` + const metricsHeight = bandwidth.visibility === 'visible' ? bandwidth.getActualSize().height : 0 + const availableHeight = size.height - metricsHeight + const key = `${size.width}:${availableHeight}:${selectedTab}` if (key === lastLayout) return lastLayout = key; padInput.cancel(); mirrorInput.cancel() const landscape = size.width > size.height body.rows = landscape ? '*' : 'auto,*'; body.columns = landscape ? '*,320' : '*' GridLayout.setRow(controls, landscape ? 0 : 1); GridLayout.setColumn(controls, landscape ? 1 : 0) - const width = landscape ? Math.min(size.width - 320, (size.height - 64) * 4 / 3) : size.width + const width = landscape ? Math.min(size.width - 320, (availableHeight - 64) * 4 / 3) : size.width mirror.width = width; mirror.height = width * 3 / 4 pad.width = selectedTab === 'ring' ? 150 : Math.min(360, (landscape ? 320 : size.width) - 32) - pad.height = Math.max(120, Math.min(250, size.height - (landscape ? 180 : width * 3 / 4 + 200))) + pad.height = Math.max(120, Math.min(250, availableHeight - (landscape ? 180 : width * 3 / 4 + 200))) } // iOS emits layoutChanged inside its layout pass. Defer mutations so // NativeScript does not clear our new layout request at the end of that pass. @@ -150,17 +176,18 @@ export function createMainPage(): Page { layoutTimer = setTimeout(() => { layoutTimer = null; layout() }, 0) }) const pause = () => { + foreground = false; stopBandwidth() if (layoutTimer !== null) clearTimeout(layoutTimer) layoutTimer = null padInput.cancel(); mirrorInput.cancel(); controller.pause() } - const resume = () => controller.resume() + const resume = () => { foreground = true; controller.resume(); syncBandwidth() } let offSettings: (() => void) | null = null let firstLoad = true page.on('loaded', () => { Application.on(Application.suspendEvent, pause); Application.on(Application.resumeEvent, resume) - offSettings?.(); offSettings = onAnySettingChanged(() => { sizeButton.text = controller.displayModeLabel }) - selectTab(selectedTab); controller.resume() + offSettings?.(); offSettings = onAnySettingChanged(() => { sizeButton.text = controller.displayModeLabel; syncBandwidth() }) + selectTab(selectedTab); resume() if (firstLoad) { firstLoad = false // Match Android's reconnect-on-launch behavior once addresses are saved. diff --git a/app/phone-ui/main-view-model.ts b/app/phone-ui/main-view-model.ts index 29ad6251..bc1a5de3 100644 --- a/app/phone-ui/main-view-model.ts +++ b/app/phone-ui/main-view-model.ts @@ -1,3 +1,4 @@ +import { BleBandwidthMeter } from "./ble-bandwidth-meter"; import { Application, Dialogs, @@ -1268,7 +1269,7 @@ export class MainViewModel extends Observable { private _bleBandwidthLabel = ""; private bleBandwidthTimer: ReturnType | null = null; // Recent counter samples, one per poll tick, for the windowed rates. - private bleRateHistory: Array<{ atMs: number; bytes: number; frames: number }> = []; + private readonly bleBandwidthMeter = new BleBandwidthMeter(); get bleBandwidthVisibility(): "visible" | "collapse" { return showBleBandwidthSetting.get() ? "visible" : "collapse"; @@ -1297,29 +1298,13 @@ export class MainViewModel extends Observable { this.bleBandwidthTimer = null; } // Don't let a later re-enable compute a rate across the disabled gap. - this.bleRateHistory = []; + this.bleBandwidthMeter.reset(); } private refreshBleBandwidth(): void { let label: string; try { - const sample = sampleBleTraffic(); - const atMs = Date.now(); - this.bleRateHistory.push({ atMs, bytes: sample.bytes, frames: sample.frames }); - while (this.bleRateHistory.length > 0 && this.bleRateHistory[0]!.atMs < atMs - BLE_RATE_WINDOW_MS) { - this.bleRateHistory.shift(); - } - label = `BLE sent: ${formatCount(sample.messages)} messages, ${formatCount(sample.bytes)} bytes`; - const oldest = this.bleRateHistory[0]!; - const elapsedSec = (atMs - oldest.atMs) / 1000; - if (elapsedSec > 0) { - const byteDelta = sample.bytes - oldest.bytes; - const frameDelta = sample.frames - oldest.frames; - label += ` · ${formatByteRate(byteDelta / elapsedSec)}, ${(frameDelta / elapsedSec).toFixed(1)} fps`; - if (frameDelta > 0) { - label += `, ${formatCount(byteDelta / frameDelta)} B/frame`; - } - } + label = this.bleBandwidthMeter.sample(sampleBleTraffic(), Date.now()); } catch (error) { label = `BLE sent: ${this.formatError(error)}`; } @@ -1342,20 +1327,6 @@ export class MainViewModel extends Observable { } } -/** 1234567 -> "1,234,567"; kept exact rather than rounded so growth is visible at a glance. */ -function formatCount(value: number): string { - return String(Math.round(value)).replace(/\B(?=(\d{3})+(?!\d))/g, ","); -} - -/** How far back the BLE bandwidth indicator's rates look. */ -const BLE_RATE_WINDOW_MS = 5000; - -function formatByteRate(bytesPerSec: number): string { - if (bytesPerSec >= 1e6) return (bytesPerSec / 1e6).toFixed(2) + " MB/s"; - if (bytesPerSec >= 1e3) return (bytesPerSec / 1e3).toFixed(1) + " kB/s"; - return Math.round(bytesPerSec) + " B/s"; -} - /** NativeScript swipe direction -> the watch-scheme directional gesture. */ function swipeKind(direction: SwipeDirection): "swipe-up" | "swipe-down" | "swipe-left" | "swipe-right" { switch (direction) { diff --git a/app/ui/dashboard-settings.ts b/app/ui/dashboard-settings.ts index 780663ae..64a81870 100644 --- a/app/ui/dashboard-settings.ts +++ b/app/ui/dashboard-settings.ts @@ -444,7 +444,7 @@ export const showBleBandwidthSetting = new ConfigSettingBoolean({ storageKey: "developer.showBleBandwidth", defaultValue: false, description: - "Show a running total of Bluetooth messages and bytes sent, at the bottom of the phone app's main screen.", + "Show Bluetooth messages and bytes sent, throughput, acknowledged display fps, and bytes per frame at the bottom of the phone screen. Rates use a five-second window; bytes include control traffic and protocol framing.", }); export type RingConnectionMode = "glasses" | "direct"; diff --git a/app/ui/dashboard/settings-menus.ts b/app/ui/dashboard/settings-menus.ts index 8ccb6ef9..7d183a43 100644 --- a/app/ui/dashboard/settings-menus.ts +++ b/app/ui/dashboard/settings-menus.ts @@ -233,8 +233,9 @@ function settingsSections(): SettingsSection[] { }, ]; if (!global.isIOS) return sections; - const deferred = new Set(["Assistant", "Navigate", "Watch", "Developer"]); + const deferred = new Set(["Assistant", "Navigate", "Watch"]); return sections.map(section => { + if (section.label === "Developer") return { ...section, items: [toggleSettingMenuItem(showBleBandwidthSetting)] }; if (section.label === "Voice") return { label: "Voice", items: [{ label: "On-device dictation (Apple)", disabled: true, onSelect: () => {}, description: "Uses the glasses microphone and your iPhone's speech language. No API key needed. Open Voice from the phone or glasses menu, speak, then click to finish and send the text into an app.", diff --git a/tests/ble-bandwidth.test.cjs b/tests/ble-bandwidth.test.cjs new file mode 100644 index 00000000..c9ce838e --- /dev/null +++ b/tests/ble-bandwidth.test.cjs @@ -0,0 +1,24 @@ +const test = require('node:test'); +const assert = require('node:assert/strict'); +const { BleBandwidthMeter } = require('../.test-build/app/phone-ui/ble-bandwidth-meter.js'); +test('bandwidth meter matches Android units, includes control bytes and counts acknowledged frames', () => { + const meter = new BleBandwidthMeter(); + assert.equal(meter.sample({ messages: 10, bytes: 1000, frames: 2 }, 0), 'BLE sent: 10 messages, 1,000 bytes'); + assert.equal(meter.sample({ messages: 13, bytes: 4000, frames: 4 }, 1000), + 'BLE sent: 13 messages, 4,000 bytes · 3.0 kB/s, 2.0 fps, 1,500 B/frame'); + meter.reset(); + meter.sample({ messages: 0, bytes: 0, frames: 0 }, 0); + assert.equal(meter.sample({ messages: 1, bytes: 20, frames: 0 }, 1000), 'BLE sent: 1 messages, 20 bytes · 20 B/s, 0.0 fps'); +}); +test('bandwidth rates decay to zero at idle and reset over suspend/toggle/counter resets', () => { + const meter = new BleBandwidthMeter(); + meter.sample({ messages: 0, bytes: 0, frames: 0 }, 0); + for (let second = 1; second <= 6; second++) { + const label = meter.sample({ messages: 10, bytes: 5000, frames: 5 }, second * 1000); + if (second === 6) assert.match(label, /0 B\/s, 0.0 fps$/); + } + meter.reset(); + assert.doesNotMatch(meter.sample({ messages: 20, bytes: 9000, frames: 10 }, 20000), /fps/); + assert.doesNotMatch(meter.sample({ messages: 0, bytes: 0, frames: 0 }, 21000), /fps/); + assert.doesNotMatch(meter.sample({ messages: 1, bytes: 10, frames: 0 }, 30000), /fps/); +}); diff --git a/tests/ble-image-optimizer.test.cjs b/tests/ble-image-optimizer.test.cjs new file mode 100644 index 00000000..b0767fc8 --- /dev/null +++ b/tests/ble-image-optimizer.test.cjs @@ -0,0 +1,67 @@ +const test = require('node:test'); +const assert = require('node:assert/strict'); +const { deflate } = require('pako'); +const { buildBoundingBoxPayload: bbox } = require('../.test-build/app/g2/ble-image-optimizer.js'); +const { applyDisplayPayload } = require('./helpers/display-payload.cjs'); +const { rle4 } = require('../.test-build/app/g2/ble-protocol.js'); + +test('mode-3 payload matches the production Android encoder byte for byte', () => { + // Generated with javac from g2protocol/BleImageOptimizer.java, 2026-09-08. + const vectors = [ + [0, 0, 0xab, '03000001013412789c93924e000000e70096'], + [319, 479, 0x12, '039fef01013412789c4b1014020001570084'], + [3, 5, 0xa5, '03010201013412789c4b90120500016c0090'], + ]; + for (const [x, y, value, expected] of vectors) { + const base = new Uint8Array(320 * 480), next = base.slice(); next[y * 320 + x] = value; + const payload = bbox(base, next, 640, 480, 0x1234, deflate); + assert.equal(Buffer.from(payload).toString('hex'), expected); + assert.deepEqual(applyDisplayPayload(base, payload), next); + } +}); + +test('bounding boxes include both nibbles, preserve neighboring pixels and cover all four screen edges', () => { + const base = Uint8Array.from({ length: 320 * 480 }, (_, i) => i & 255); + for (const x of [0, 1, 2, 3, 4, 637, 638, 639]) for (const y of [0, 1, 2, 477, 478, 479]) { + const next = base.slice(); next[y * 320 + (x >> 1)] ^= x % 2 ? 15 : 240; + const payload = bbox(base, next, 640, 480, 1, deflate); + assert.deepEqual([...payload.slice(1, 5)], [Math.floor(x / 4), Math.floor(y / 2), 1, 1]); + assert.deepEqual(applyDisplayPayload(base, payload), next); + } +}); + +test('unchanged, incompatible and full-screen boxes fall back without compressing a region', () => { + const base = new Uint8Array(320 * 480), next = base.slice(); next[0] = next[next.length - 1] = 255; + const compress = () => assert.fail('A fallback must not compress a bounding box'); + assert.equal(bbox(base, base, 640, 480, 1, compress), null); + assert.equal(bbox(base, next, 640, 480, 1, compress), null); + assert.equal(bbox(null, next, 640, 480, 1, compress), null); + assert.equal(bbox(base.subarray(1), next, 640, 480, 1, compress), null); + assert.equal(bbox(base, next.subarray(1), 640, 480, 1, compress), null); + for (const [w, h] of [[0, 480], [639, 480], [640, 479], [1024, 480], [640, 512]]) + assert.equal(bbox(base, next, w, h, 1, compress), null); +}); + +test('seeded sparse edits reconstruct exactly across successive bounding-box updates', () => { + let seed = 42; + const random = limit => { seed = (Math.imul(seed, 1664525) + 1013904223) >>> 0; return seed % limit; }; + let base = Uint8Array.from({ length: 320 * 480 }, () => random(256)); + for (let fid = 1; fid <= 60; fid++) { + const next = base.slice(), bx = random(280), by = random(440); + for (let n = 0; n < 20; n++) next[(by + random(40)) * 320 + bx + random(40)] ^= 0xff; + const payload = bbox(base, next, 640, 480, fid, deflate); + assert.ok(payload); assert.equal(payload[5] | (payload[6] << 8), fid); + assert.deepEqual(applyDisplayPayload(base, payload), next); + base = next; + } +}); + +test('a small edit compresses only its region and reduces bytes on a busy screen', () => { + const base = Uint8Array.from({ length: 320 * 480 }, (_, i) => i & 255), next = base.slice(); + next[100 * 320 + 100] ^= 255; + let compressedInputBytes = 0; + const payload = bbox(base, next, 640, 480, 1, bytes => { compressedInputBytes += bytes.length; return deflate(bytes); }); + assert.ok(compressedInputBytes <= 8); // A 4x2 rectangle, at most one RLE byte per pixel. + assert.ok(payload.length < (1 + deflate(rle4(next)).length) / 10); + assert.deepEqual(applyDisplayPayload(base, payload), next); +}); diff --git a/tests/helpers/display-payload.cjs b/tests/helpers/display-payload.cjs new file mode 100644 index 00000000..9159763f --- /dev/null +++ b/tests/helpers/display-payload.cjs @@ -0,0 +1,25 @@ +const assert = require('node:assert/strict'); +const { inflateSync } = require('node:zlib'); + +// Independent firmware-format decoder for reconstruction tests (not app code). +function applyDisplayPayload(base, payload, width = 640, height = 480) { + const mode = payload[0]; assert.ok(mode === 3 || mode === 6); + const [left, top, w, h] = mode === 3 + ? [payload[1] * 4, payload[2] * 2, payload[3] * 4, payload[4] * 2] : [0, 0, width, height]; + assert.ok(w > 0 && h > 0 && left + w <= width && top + h <= height); + const tokens = inflateSync(payload.subarray(mode === 3 ? 7 : 1)); + const pixels = []; + for (let i = 0; i < tokens.length;) { + const token = tokens[i++], color = token & 15; + let count = token >>> 4; + if (!count) { count = tokens[i++]; if (!count) { count = tokens[i] | (tokens[i + 1] << 8); i += 2; } } + assert.ok(count > 0 && pixels.length + count <= w * h); + for (let n = 0; n < count; n++) pixels.push(color); + } + assert.equal(pixels.length, w * h); + const out = base.slice(); + for (let y = 0; y < h; y++) for (let x = 0; x < w; x += 2) + out[(top + y) * (width / 2) + (left + x) / 2] = (pixels[y * w + x] << 4) | pixels[y * w + x + 1]; + return out; +} +module.exports = { applyDisplayPayload }; diff --git a/tests/ios-app-host.test.cjs b/tests/ios-app-host.test.cjs index 2621b745..9f20046f 100644 --- a/tests/ios-app-host.test.cjs +++ b/tests/ios-app-host.test.cjs @@ -135,3 +135,49 @@ test('background glasses input still composites frames; phone resume preserves t controller.resume(); flush(); assert.equal(starts, 1); assert.equal(controller.connectionState.phase, 'disconnected'); }); + +test('iOS bandwidth footer toggles live, polls only in foreground and resets its rate window on resume', () => { + const views = [], intervals = new Map(), appEvents = new Map(), settingListeners = new Set(); + let enabled = false, atMs = 0, totals = { messages: 0, bytes: 0, frames: 0 }, nextId = 0; + class View { + events = new Map(); children = []; + constructor() { views.push(this); } + on(event, fn) { this.events.set(event, fn); } + addChild(view) { this.children.push(view); } + getActualSize() { return { width: 0, height: 0 }; } + static setRow() {} static setColumn() {} + } + const core = { Application: { suspendEvent: 'suspend', resumeEvent: 'resume', + on: (key, fn) => appEvents.set(key, fn), off: key => appEvents.delete(key) }, + Button: View, Color: class {}, Dialogs: {}, GridLayout: View, Image: View, Label: View, Page: View, StackLayout: View }; + const modules = { + '@nativescript/core': core, + '../apps/all-apps': { ALL_APPS: [] }, + '../g2/ios-preview-controller': { IosPreviewController: class { resume() {} pause() {} } }, + './phone-gestures': { PhoneGestureRecognizer: class { cancel() {} } }, + './ble-bandwidth-meter': require('../.test-build/app/phone-ui/ble-bandwidth-meter.js'), + '../native/ble-traffic': { sampleBleTraffic: () => totals }, + '../ui/dashboard-settings': { showBleBandwidthSetting: { get: () => enabled }, + onAnySettingChanged: fn => { settingListeners.add(fn); return () => settingListeners.delete(fn); } }, + '../g2/device-addresses': { loadDeviceAddresses: () => ({}) }, + '../g2/ios-peripheral-identity': { deviceAddressError: () => 'no test devices' }, + }; + const { createMainPage } = load('app/phone-ui/main-page.ios.ts', { + require: id => modules[id] ?? {}, Date: { now: () => atMs }, + setInterval: fn => { const id = ++nextId; intervals.set(id, fn); return id; }, clearInterval: id => intervals.delete(id), + setTimeout: () => 1, clearTimeout() {}, + }); + const page = createMainPage(), footer = views.find(v => v.accessibilityIdentifier === 'ble-bandwidth-indicator'); + page.events.get('loaded')(); assert.equal(intervals.size, 0); assert.equal(footer.visibility, 'collapse'); + enabled = true; for (const fn of settingListeners) fn(); + assert.equal(intervals.size, 1); assert.equal(footer.visibility, 'visible'); + totals = { messages: 4, bytes: 2000, frames: 2 }; atMs = 1000; for (const fn of intervals.values()) fn(); + assert.match(footer.text, /2.0 fps, 1,000 B\/frame/); + appEvents.get('suspend')(); assert.equal(intervals.size, 0); + const previousText = footer.text; + totals = { messages: 40, bytes: 20000, frames: 20 }; atMs = 20000; + for (const fn of settingListeners) fn(); assert.equal(footer.text, previousText); assert.equal(intervals.size, 0); + appEvents.get('resume')(); assert.equal(intervals.size, 1); assert.doesNotMatch(footer.text, /fps/); + enabled = false; for (const fn of settingListeners) fn(); assert.equal(footer.visibility, 'collapse'); assert.equal(intervals.size, 0); + page.events.get('unloaded')(); assert.equal(appEvents.size, 0); assert.equal(settingListeners.size, 0); +}); diff --git a/tests/ios-ble.test.cjs b/tests/ios-ble.test.cjs index 19eb12a1..d4633fab 100644 --- a/tests/ios-ble.test.cjs +++ b/tests/ios-ble.test.cjs @@ -256,3 +256,241 @@ test('release while microphone enable awaits ACK sends disable last and rejects const mic = h.transport.sent.filter(s => s.message.command === 15); assert.equal(p.readInteger(p.readBytes(mic.at(-1).message.payload, 18), 1), 0); }); + +test('iOS traffic counts framed writes and logical messages, and advances fps only after the complete image ACK', async t => { + const { iosBleTraffic } = require('../.test-build/app/g2/ble-traffic-counters.js'); + const h = harness(t); await h.session.start(addresses); + const before = iosBleTraffic.sample(); + let writtenBytes = 0; + const write = h.transport.write.bind(h.transport); + h.transport.write = async (...args) => { await write(...args); writtenBytes += args[2].length; }; + // Force multiple EvenHub messages so first-message ACK is not mistaken for a frame. + h.session.deflate = () => new Uint8Array(8000).fill(1); + h.transport.hold = true; + h.session.setFrame(new Uint8Array(640 * 480).fill(255)); + await until(() => iosBleTraffic.sample().messages > before.messages); + assert.equal(iosBleTraffic.sample().frames, before.frames); + assert.equal(iosBleTraffic.sample().bytes - before.bytes, writtenBytes); + h.transport.hold = false; + for (const held of h.transport.held) h.transport.ack(held.id, held.message); + await until(() => h.session.state.frames === 1); + const after = iosBleTraffic.sample(); + assert.equal(after.messages - before.messages, 3); + assert.equal(after.frames - before.frames, 1); + assert.equal(after.bytes - before.bytes, writtenBytes); + assert.ok(writtenBytes > 8001); // Includes protobuf, fragmentation headers and CRCs. + h.session.setFrame(new Uint8Array(640 * 480).fill(255)); + await h.session.pump(); + assert.deepEqual(iosBleTraffic.sample(), after); // Deduplicated image is not an ACKed frame. + await h.session.stop(); + assert.equal(iosBleTraffic.sample().frames, after.frames); // No reset on disconnect. +}); + +const imageMessages = transport => transport.sent.filter(s => s.message.sid === p.SID.hub && s.message.command === 3); +const imageBody = sent => p.readBytes(sent.message.payload, 5); +const ack = (transport, sent) => transport.ack(sent.id, sent.message); +const tick = () => new Promise(resolve => setImmediate(resolve)); + +test('display window sends three complete messages before any ACK and refills on an out-of-order ACK', async t => { + const h = harness(t); await h.session.start(addresses); + // Five protocol messages, each split into many negotiated-MTU BLE writes. + const compressed = Uint8Array.from({ length: 16000 }, (_, i) => i & 255); + h.session.deflate = () => compressed; h.transport.hold = true; + h.session.setFrame(new Uint8Array(640 * 480).fill(255)); + await until(() => imageMessages(h.transport).length === 3); + await tick(); assert.equal(imageMessages(h.transport).length, 3); + assert.equal(h.session.state.frames, 0); + const first = imageMessages(h.transport); + ack(h.transport, first[1]); // Relayed ACKs need not arrive in submission order. + await until(() => imageMessages(h.transport).length === 4); + ack(h.transport, first[1]); // Duplicate ACK must not open another slot. + await tick(); assert.equal(imageMessages(h.transport).length, 4); + ack(h.transport, first[2]); + await until(() => imageMessages(h.transport).length === 5); + const sent = imageMessages(h.transport); + assert.deepEqual(sent.map(s => p.readInteger(imageBody(s), 6)), [0, 1, 2, 3, 4]); + assert.deepEqual(p.concat(...sent.map(s => p.readBytes(imageBody(s), 8))), p.concat(new Uint8Array([6]), compressed)); + ack(h.transport, sent[4]); ack(h.transport, sent[3]); + await tick(); assert.equal(h.session.state.frames, 0); // First fragment still unacknowledged. + ack(h.transport, sent[0]); + await until(() => h.session.state.frames === 1); + assert.equal(h.session.displayInFlight, 0); assert.equal(h.session.displayFrames.length, 0); +}); + +test('display pipelines across frames, deduplicates against enqueued images and coalesces to the newest waiting frame', async t => { + const h = harness(t); await h.session.start(addresses); h.transport.hold = true; + const submit = async value => { h.session.setFrame(new Uint8Array(640 * 480).fill(value)); await h.session.pump(); await tick(); }; + await submit(0); await until(() => imageMessages(h.transport).length === 1); + await submit(0); assert.equal(imageMessages(h.transport).length, 1); // Duplicate still in flight. + await submit(255); await submit(0); // A -> B -> A must transmit all three. + await until(() => imageMessages(h.transport).length === 3); + const sent = imageMessages(h.transport); + assert.deepEqual(p.readBytes(imageBody(sent[0]), 8), p.readBytes(imageBody(sent[2]), 8)); + await submit(80); await submit(160); // Only the newest waiting frame survives. + assert.equal(imageMessages(h.transport).length, 3); + ack(h.transport, sent[2]); ack(h.transport, sent[1]); await tick(); + assert.equal(h.session.state.frames, 0); + assert.equal(h.session.displayFrames.length, 3); // Bounded behind the missing oldest ACK. + assert.equal(imageMessages(h.transport).length, 3); + ack(h.transport, sent[0]); + await until(() => imageMessages(h.transport).length === 4); + assert.equal(h.session.state.frames, 3); + const newest = imageMessages(h.transport)[3]; + assert.deepEqual(p.readBytes(imageBody(newest), 8), p.concat(new Uint8Array([6]), deflate(p.rle4(p.packGray4(new Uint8Array(640 * 480).fill(160), 640, 480))))); + ack(h.transport, newest); await until(() => h.session.state.frames === 4); + await submit(160); assert.equal(imageMessages(h.transport).length, 4); +}); + +test('ACK timeout starts after transport writes drain; a lost display ACK flushes the whole pipeline', async t => { + const h = harness(t); await h.session.start(addresses); + const request = h.session.request.bind(h.session); + h.session.request = (role, sid, build, label, ...rest) => request(role, sid, build, label, ...(label === 'Display frame' ? [40] : rest)); + const write = h.transport.write.bind(h.transport); + let release; + const blocked = new Promise(resolve => { release = resolve; }); + h.transport.write = async (...args) => { if (args[0] === 'L') await blocked; await write(...args); }; + h.transport.hold = true; h.session.deflate = () => new Uint8Array(16000); + h.session.setFrame(new Uint8Array(640 * 480)); await h.session.pump(); + await new Promise(resolve => setTimeout(resolve, 65)); + assert.equal(h.session.state.phase, 'connected'); assert.equal(imageMessages(h.transport).length, 0); + release(); await until(() => imageMessages(h.transport).length === 3); + const stale = imageMessages(h.transport); + await until(() => h.session.state.phase === 'retrying'); + assert.match(h.session.state.status, /Display frame was not acknowledged/); + assert.equal(h.session.displayInFlight, 0); assert.equal(h.session.displayFrames.length, 0); + assert.equal(h.session.lastEnqueued, null); assert.equal(h.session.pending.size, 0); + for (const sent of stale) ack(h.transport, sent); + await tick(); assert.equal(h.session.state.frames, 0); assert.equal(imageMessages(h.transport).length, 3); + // A new session must resend even the identical image; old ACKs cannot count it. + await h.session.stop(); h.transport.hold = false; await h.session.start(addresses); + h.session.deflate = deflate; h.transport.hold = true; + h.session.setFrame(new Uint8Array(640 * 480)); + await until(() => imageMessages(h.transport).length === 4); + for (const sent of stale) ack(h.transport, sent); + await tick(); assert.equal(h.session.state.frames, 0); + ack(h.transport, imageMessages(h.transport)[3]); await until(() => h.session.state.frames === 1); +}); + +test('failed transport write prevents queued display messages from being written', async t => { + const h = harness(t); await h.session.start(addresses); + let attempts = 0; + const write = h.transport.write.bind(h.transport); + h.transport.write = async (...args) => { + if (args[0] === 'L') { attempts++; throw new Error('test write failed'); } + return write(...args); + }; + h.session.deflate = () => new Uint8Array(16000); + h.session.setFrame(new Uint8Array(640 * 480)); + await until(() => h.session.state.phase === 'retrying'); + assert.equal(attempts, 1); assert.equal(h.session.pending.size, 0); + assert.equal(h.session.displayInFlight, 0); assert.equal(h.session.state.frames, 0); +}); + +test('disconnect cancels the display window and sends cleanup after the queued images stop', async t => { + const h = harness(t); await h.session.start(addresses); + h.transport.hold = true; h.session.deflate = () => new Uint8Array(16000); + h.session.setFrame(new Uint8Array(640 * 480)); + await until(() => imageMessages(h.transport).length === 3); + const stale = imageMessages(h.transport); + h.transport.hold = false; await h.session.stop(); + for (const sent of stale) ack(h.transport, sent); + await tick(); + assert.equal(h.session.state.phase, 'disconnected'); assert.equal(h.session.state.frames, 0); + assert.equal(h.session.displayInFlight, 0); assert.equal(h.session.displayFrames.length, 0); + const images = imageMessages(h.transport); + assert.equal(images.length, 4); assert.deepEqual(p.readBytes(imageBody(images[3]), 8), new Uint8Array([11])); +}); + +test('a full display window leaves glasses input, microphone control and audio responsive', async t => { + const h = harness(t); await h.session.start(addresses); + h.transport.hold = true; h.session.deflate = () => new Uint8Array(16000); + h.session.setFrame(new Uint8Array(640 * 480)); + await until(() => imageMessages(h.transport).length === 3); + const input = p.bytes(13, p.bytes(3, p.concat(p.integer(1, 9), p.integer(2, 3)))); + h.transport.emit({ kind: 'notification', identifier: 'R', characteristic: p.G2_NOTIFY, + data: hex(p.concat(...p.frameMessage(input, p.SID.hub, 1, 22))) }); + assert.equal(h.input.length, 1); assert.equal(h.input[0].eventSource, 3); + const audio = [], enabling = h.session.setMicrophone(true, packet => audio.push(hex(packet))); + await until(() => h.transport.sent.some(s => s.message.command === 15)); + ack(h.transport, h.transport.sent.find(s => s.message.command === 15)); await enabling; + h.transport.emit({ kind: 'notification', identifier: 'L', characteristic: p.G2_RENDER_NOTIFY, data: '010203' }); + assert.deepEqual(audio, ['010203']); + assert.equal(imageMessages(h.transport).length, 3); assert.equal(h.session.state.frames, 0); + assert.equal(h.session.displayInFlight, 3); +}); + +test('pipelined bounding boxes reconstruct moving and erased content against the last queued frame', async t => { + const { applyDisplayPayload } = require('./helpers/display-payload.cjs'); + const h = harness(t); await h.session.start(addresses); h.transport.hold = true; + const base = new Uint8Array(640 * 480), a = base.slice(), b = base.slice(); + a[11 * 640 + 13] = 255; b[11 * 640 + 101] = 160; + const frames = [base, a, b]; + for (let i = 0; i < frames.length; i++) { + h.session.setFrame(frames[i]); await h.session.pump(); + await until(() => imageMessages(h.transport).length === i + 1); + } + const messages = imageMessages(h.transport), payloads = messages.map(m => p.readBytes(imageBody(m), 8)); + assert.deepEqual(payloads.map(b => b[0]), [6, 3, 3]); + assert.deepEqual(payloads.slice(1).map(b => b[5] | (b[6] << 8)), [1, 2]); + assert.equal(h.session.state.frames, 0); // All three updates precede any ACK. + let shadow = new Uint8Array(320 * 480); + for (let i = 0; i < payloads.length; i++) { + shadow = applyDisplayPayload(shadow, payloads[i]); + assert.deepEqual(shadow, p.packGray4(frames[i], 640, 480)); + } + // A late ACK for the old full frame must not replace the delta comparison base. + ack(h.transport, messages[0]); await until(() => h.session.state.frames === 1); + h.session.setFrame(base); await h.session.pump(); + await until(() => imageMessages(h.transport).length === 4); + const clear = p.readBytes(imageBody(imageMessages(h.transport)[3]), 8); + assert.equal(clear[0], 3); assert.equal(clear[1], 25); // Only B's dot needs clearing. + assert.deepEqual(applyDisplayPayload(shadow, clear), p.packGray4(base, 640, 480)); + for (const message of imageMessages(h.transport).slice(1)) ack(h.transport, message); + await until(() => h.session.state.frames === 4); +}); + +test('delta ids skip reserved values and advance only on emitted deltas; reconnect reseeds with a full frame', async t => { + const h = harness(t); await h.session.start(addresses); + const submit = async gray => { + const before = h.session.state.frames; h.session.setFrame(gray); + await until(() => h.session.state.frames === before + 1); + return p.readBytes(imageBody(imageMessages(h.transport).at(-1)), 8); + }; + const base = new Uint8Array(640 * 480), next = base.slice(); next[1234] = 255; + assert.equal((await submit(base))[0], 6); + h.session.nextImageFrameId = 0xfffe; + const delta = await submit(next); assert.equal(delta[5] | (delta[6] << 8), 0xfffe); + h.session.setFrame(next); await h.session.pump(); await tick(); + assert.equal(h.session.nextImageFrameId, 1); + const full = await submit(new Uint8Array(640 * 480).fill(255)); assert.equal(full[0], 6); + assert.equal(h.session.nextImageFrameId, 1); + const clear = await submit(next); assert.equal(clear[0], 6); // Whole-screen bounding box. + const wrapped = await submit(base); assert.equal(wrapped[5] | (wrapped[6] << 8), 1); + await h.session.stop(); await h.session.start(addresses); + assert.equal((await submit(base))[0], 6); // Even the same pixels need a trusted full base. +}); + +test('a lost delta ACK invalidates the queued base and late delta ACKs cannot seed a new session', async t => { + const h = harness(t); await h.session.start(addresses); + const base = new Uint8Array(640 * 480); h.session.setFrame(base); + await until(() => h.session.state.frames === 1); + const request = h.session.request.bind(h.session); + h.session.request = (role, sid, build, label, ...rest) => request(role, sid, build, label, ...(label === 'Display frame' ? [50] : rest)); + h.transport.hold = true; + const a = base.slice(), b = base.slice(); a[1234] = 255; b[4321] = 255; + h.session.setFrame(a); await h.session.pump(); + h.session.setFrame(b); await h.session.pump(); + await until(() => imageMessages(h.transport).length === 3); + const stale = imageMessages(h.transport).slice(1); + assert.deepEqual(stale.map(m => p.readBytes(imageBody(m), 8)[0]), [3, 3]); + ack(h.transport, stale[1]); // Even a later successful delta does not rescue a hole. + await until(() => h.session.state.phase === 'retrying'); + assert.equal(h.session.lastEnqueued, null); assert.equal(h.session.state.frames, 1); + await h.session.stop(); h.transport.hold = false; await h.session.start(addresses); + h.transport.hold = true; h.session.setFrame(b); await h.session.pump(); + await until(() => imageMessages(h.transport).length === 4); + const reseed = imageMessages(h.transport)[3]; assert.equal(p.readBytes(imageBody(reseed), 8)[0], 6); + for (const message of stale) ack(h.transport, message); + await tick(); assert.equal(h.session.state.frames, 1); + ack(h.transport, reseed); await until(() => h.session.state.frames === 2); +}); diff --git a/tests/tsconfig.json b/tests/tsconfig.json index 4e947d45..068ece2a 100644 --- a/tests/tsconfig.json +++ b/tests/tsconfig.json @@ -12,6 +12,7 @@ }, "include": [ "../app/g2/ble-protocol.ts", + "../app/phone-ui/ble-bandwidth-meter.ts", "../app/apps/terminal/hub-header.ts", "../app/g2/ios-peripheral-identity.ts", "../app/g2/glasses-session.ts", From 44bd1d8a2d9cc13d2a1764a521547567660c0cd5 Mon Sep 17 00:00:00 2001 From: James Babcock Date: Tue, 8 Sep 2026 14:47:58 -0700 Subject: [PATCH 11/99] iOS porting: EvenHub app compatibility first pass --- App_Resources/iOS/build.xcconfig | 2 +- .../iOS/src/FaceclawEvenHubWebView.h | 13 ++ .../iOS/src/FaceclawEvenHubWebView.m | 148 +++++++++++++ App_Resources/iOS/src/module.modulemap | 1 + app/apps/evenhub/ehpk.ts | 7 + app/apps/evenhub/manager.ts | 28 ++- app/apps/evenhub/privacy-policy.ios.ts | 5 + app/apps/evenhub/session.ts | 17 +- app/apps/evenhub/webview.ios.ts | 43 ++++ app/apps/files/files-app.ts | 7 +- app/apps/files/index.ts | 1 + app/apps/ios-availability.ts | 2 +- app/graphics/evenhub-font.ts | 8 +- app/graphics/lvgl-font.ts | 53 +++++ app/native/lvgl-font.ios.ts | 16 ++ app/native/lvgl-font.ts | 4 + scripts/ios-config.md | 53 +++++ scripts/ios_config.py | 197 ++++++++++++++++++ scripts/pull_config_ios.sh | 3 + scripts/push_config_ios.sh | 3 + tests/ios-evenhub-native.cjs | 42 ++++ tests/ios-evenhub.test.cjs | 156 ++++++++++++++ tests/native/ios-evenhub-test.m | 57 +++++ tests/tsconfig.json | 1 + 24 files changed, 843 insertions(+), 24 deletions(-) create mode 100644 App_Resources/iOS/src/FaceclawEvenHubWebView.h create mode 100644 App_Resources/iOS/src/FaceclawEvenHubWebView.m create mode 100644 app/apps/evenhub/privacy-policy.ios.ts create mode 100644 app/apps/evenhub/webview.ios.ts create mode 100644 app/graphics/lvgl-font.ts create mode 100644 app/native/lvgl-font.ios.ts create mode 100644 app/native/lvgl-font.ts create mode 100644 scripts/ios-config.md create mode 100644 scripts/ios_config.py create mode 100755 scripts/pull_config_ios.sh create mode 100755 scripts/push_config_ios.sh create mode 100644 tests/ios-evenhub-native.cjs create mode 100644 tests/ios-evenhub.test.cjs create mode 100644 tests/native/ios-evenhub-test.m diff --git a/App_Resources/iOS/build.xcconfig b/App_Resources/iOS/build.xcconfig index b8939fa9..950bebe4 100644 --- a/App_Resources/iOS/build.xcconfig +++ b/App_Resources/iOS/build.xcconfig @@ -3,7 +3,7 @@ TARGETED_DEVICE_FAMILY = 1; CODE_SIGN_STYLE = Automatic; // Select the local signing team in Xcode or pass --teamId to the iOS scripts. -OTHER_LDFLAGS = $(inherited) -framework CoreBluetooth -framework CoreText -framework Speech -framework AVFoundation +OTHER_LDFLAGS = $(inherited) -framework CoreBluetooth -framework CoreText -framework Speech -framework AVFoundation -framework WebKit -framework UniformTypeIdentifiers ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; diff --git a/App_Resources/iOS/src/FaceclawEvenHubWebView.h b/App_Resources/iOS/src/FaceclawEvenHubWebView.h new file mode 100644 index 00000000..04f3827d --- /dev/null +++ b/App_Resources/iOS/src/FaceclawEvenHubWebView.h @@ -0,0 +1,13 @@ +#import +#import + +/** One local EHPK runtime, retained by its TS session until its window closes. */ +@interface FaceclawEvenHubWebView : NSObject +@property(nonatomic, copy) void (^eventHandler)(NSString *json); +@property(nonatomic, copy) NSString *packageIdentifier; +- (void)start:(NSString *)directory entrypoint:(NSString *)entrypoint script:(NSString *)script; +- (void)evaluate:(NSString *)script; +- (void)showOnPhone; +- (void)hideOnPhone; +- (void)destroy; +@end diff --git a/App_Resources/iOS/src/FaceclawEvenHubWebView.m b/App_Resources/iOS/src/FaceclawEvenHubWebView.m new file mode 100644 index 00000000..f31b1cec --- /dev/null +++ b/App_Resources/iOS/src/FaceclawEvenHubWebView.m @@ -0,0 +1,148 @@ +#import "FaceclawEvenHubWebView.h" +#import +#import +#import + +@interface FaceclawEvenHubWebView () +@property(nonatomic) WKWebView *webView; +@property(nonatomic) UIView *host; +@property(nonatomic) UIButton *back; +@property(nonatomic) NSTimer *timer; +@property(nonatomic) NSString *directory; +@property(nonatomic) BOOL ticking; +@property(nonatomic) BOOL destroyed; +@end + +@implementation FaceclawEvenHubWebView +- (void)emit:(NSDictionary *)event { + if (!_eventHandler || _destroyed) return; + NSData *data = [NSJSONSerialization dataWithJSONObject:event options:0 error:nil]; + if (data) _eventHandler([[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding]); +} +- (void)start:(NSString *)directory entrypoint:(NSString *)entrypoint script:(NSString *)script { + _directory = directory.stringByStandardizingPath.stringByResolvingSymlinksInPath; + WKWebViewConfiguration *config = [WKWebViewConfiguration new]; + // Isolate browser storage by package, retaining it across closing/reopening. + // SDK storage also persists independently through the shared TS session. + config.websiteDataStore = WKWebsiteDataStore.nonPersistentDataStore; + if (@available(iOS 17.0, *)) { + if (_packageIdentifier.length) { + NSData *key = [[@"com.faceclaw.ehpk:" stringByAppendingString:_packageIdentifier] dataUsingEncoding:NSUTF8StringEncoding]; + unsigned char digest[CC_SHA256_DIGEST_LENGTH]; CC_SHA256(key.bytes, (CC_LONG)key.length, digest); + config.websiteDataStore = [WKWebsiteDataStore dataStoreForIdentifier:[[NSUUID alloc] initWithUUIDBytes:digest]]; + } + } + [config setURLSchemeHandler:self forURLScheme:@"faceclaw-ehpk"]; + [config.userContentController addScriptMessageHandler:self name:@"faceclaw"]; + [config.userContentController addUserScript:[[WKUserScript alloc] initWithSource:script + injectionTime:WKUserScriptInjectionTimeAtDocumentStart forMainFrameOnly:YES]]; + _webView = [[WKWebView alloc] initWithFrame:CGRectZero configuration:config]; + _webView.navigationDelegate = self; + _webView.accessibilityIdentifier = @"evenhub-webview"; + UIWindow *window = nil; + for (UIScene *scene in UIApplication.sharedApplication.connectedScenes) { + if (![scene isKindOfClass:UIWindowScene.class]) continue; + for (UIWindow *candidate in ((UIWindowScene *)scene).windows) if (candidate.isKeyWindow) window = candidate; + } + if (!window) window = UIApplication.sharedApplication.keyWindow; + if (!window) { [self emit:@{@"kind": @"error", @"message": @"No phone window is available."}]; return; } + _host = [[UIView alloc] initWithFrame:window.bounds]; + _host.autoresizingMask = UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight; + _host.backgroundColor = UIColor.systemBackgroundColor; + _host.userInteractionEnabled = NO; + _host.accessibilityElementsHidden = YES; + [window insertSubview:_host atIndex:0]; + [_host addSubview:_webView]; + _webView.translatesAutoresizingMaskIntoConstraints = NO; + _back = [UIButton buttonWithType:UIButtonTypeSystem]; + [_back setTitle:@"Back to Faceclaw" forState:UIControlStateNormal]; + _back.accessibilityIdentifier = @"evenhub-back"; + [_back addTarget:self action:@selector(hideOnPhone) forControlEvents:UIControlEventTouchUpInside]; + [_host addSubview:_back]; _back.translatesAutoresizingMaskIntoConstraints = NO; + [NSLayoutConstraint activateConstraints:@[ + [_back.topAnchor constraintEqualToAnchor:_host.safeAreaLayoutGuide.topAnchor], + [_back.leadingAnchor constraintEqualToAnchor:_host.leadingAnchor], + [_back.trailingAnchor constraintEqualToAnchor:_host.trailingAnchor], + [_back.heightAnchor constraintEqualToConstant:44], + [_webView.topAnchor constraintEqualToAnchor:_back.bottomAnchor], + [_webView.leadingAnchor constraintEqualToAnchor:_host.leadingAnchor], + [_webView.trailingAnchor constraintEqualToAnchor:_host.trailingAnchor], + [_webView.bottomAnchor constraintEqualToAnchor:_host.safeAreaLayoutGuide.bottomAnchor] + ]]; + // Keep a nonzero attached view behind the dashboard; do not hide/detach it. + // Bound host ticks to one evaluation in flight, including across suspension. + __weak typeof(self) weakSelf = self; + _timer = [NSTimer timerWithTimeInterval:1.0 / 60 repeats:YES block:^(NSTimer *timer) { + typeof(self) strongSelf = weakSelf; + if (!strongSelf || strongSelf.ticking || UIApplication.sharedApplication.applicationState != UIApplicationStateActive) return; + strongSelf.ticking = YES; + [strongSelf.webView evaluateJavaScript:@"window.__fcTimerTick && window.__fcTimerTick(); window.__fcRafTick && window.__fcRafTick();" completionHandler:^(id result, NSError *error) { + weakSelf.ticking = NO; + }]; + }]; + [NSRunLoop.mainRunLoop addTimer:_timer forMode:NSRunLoopCommonModes]; + NSURLComponents *url = [NSURLComponents new]; + url.scheme = @"faceclaw-ehpk"; url.host = @"app"; url.path = [@"/" stringByAppendingString:entrypoint]; + [_webView loadRequest:[NSURLRequest requestWithURL:url.URL]]; +} +- (void)evaluate:(NSString *)script { + if (!_destroyed) [_webView evaluateJavaScript:script completionHandler:nil]; +} +- (void)showOnPhone { + if (_destroyed) return; + [_host.superview bringSubviewToFront:_host]; _host.userInteractionEnabled = YES; _host.accessibilityElementsHidden = NO; +} +- (void)hideOnPhone { + [_host endEditing:YES]; [_host.superview sendSubviewToBack:_host]; _host.userInteractionEnabled = NO; _host.accessibilityElementsHidden = YES; + [self emit:@{@"kind": @"hidden"}]; +} +- (void)destroy { + if (_destroyed) return; + _destroyed = YES; [_timer invalidate]; _timer = nil; + [_webView stopLoading]; _webView.navigationDelegate = nil; + [_webView.configuration.userContentController removeScriptMessageHandlerForName:@"faceclaw"]; + [_webView.configuration.userContentController removeAllUserScripts]; + [_host removeFromSuperview]; _host = nil; _back = nil; _webView = nil; _eventHandler = nil; +} +- (void)userContentController:(WKUserContentController *)controller didReceiveScriptMessage:(WKScriptMessage *)message { + // Subframes and navigated third-party documents never receive host access. + NSURL *url = message.frameInfo.request.URL; + if (!message.frameInfo.isMainFrame || ![url.scheme isEqual:@"faceclaw-ehpk"] || ![url.host isEqual:@"app"]) return; + if ([message.body isKindOfClass:NSDictionary.class]) [self emit:message.body]; +} +- (void)webView:(WKWebView *)webView decidePolicyForNavigationAction:(WKNavigationAction *)action decisionHandler:(void (^)(WKNavigationActionPolicy))decisionHandler { + NSURL *url = action.request.URL; + BOOL local = [url.scheme isEqual:@"faceclaw-ehpk"] && [url.host isEqual:@"app"]; + decisionHandler(local && action.targetFrame.isMainFrame ? WKNavigationActionPolicyAllow : WKNavigationActionPolicyCancel); +} +- (void)webView:(WKWebView *)webView didFinishNavigation:(WKNavigation *)navigation { + [self emit:@{@"kind": @"loaded"}]; +} +- (void)webView:(WKWebView *)webView didFailProvisionalNavigation:(WKNavigation *)navigation withError:(NSError *)error { + [self emit:@{@"kind": @"error", @"message": error.localizedDescription}]; +} +- (void)webView:(WKWebView *)webView didFailNavigation:(WKNavigation *)navigation withError:(NSError *)error { + [self emit:@{@"kind": @"error", @"message": error.localizedDescription}]; +} +- (void)webViewWebContentProcessDidTerminate:(WKWebView *)webView { + [self emit:@{@"kind": @"error", @"message": @"The app's web process ended. Close and reopen the app."}]; +} +- (void)webView:(WKWebView *)webView startURLSchemeTask:(id)task { + NSURL *url = task.request.URL; + NSString *relative = [url.path stringByTrimmingCharactersInSet:[NSCharacterSet characterSetWithCharactersInString:@"/"]]; + NSString *file = [[_directory stringByAppendingPathComponent:relative] stringByStandardizingPath].stringByResolvingSymlinksInPath; + BOOL allowed = !_destroyed && [url.host isEqual:@"app"] && + [file hasPrefix:[_directory stringByAppendingString:@"/"]]; + NSData *data = allowed ? [NSData dataWithContentsOfFile:file options:NSDataReadingMappedIfSafe error:nil] : nil; + NSString *ext = file.pathExtension.lowercaseString; + NSString *mime = [@{@"js": @"text/javascript", @"mjs": @"text/javascript", @"html": @"text/html", + @"css": @"text/css", @"json": @"application/json", @"wasm": @"application/wasm", @"svg": @"image/svg+xml"} objectForKey:ext]; + if (!mime) mime = [UTType typeWithFilenameExtension:ext].preferredMIMEType ?: @"application/octet-stream"; + NSHTTPURLResponse *response = [[NSHTTPURLResponse alloc] initWithURL:url statusCode:data ? 200 : 404 + HTTPVersion:@"HTTP/1.1" headerFields:@{@"Content-Type": mime, @"Access-Control-Allow-Origin": @"*", @"Cache-Control": @"no-store"}]; + // Synchronous completion on WebKit's main-queue callback means there is no + // outstanding task to finish after stopURLSchemeTask cancels it. + [task didReceiveResponse:response]; [task didReceiveData:data ?: NSData.data]; [task didFinish]; +} +- (void)webView:(WKWebView *)webView stopURLSchemeTask:(id)task {} +@end diff --git a/App_Resources/iOS/src/module.modulemap b/App_Resources/iOS/src/module.modulemap index e98bde65..7f9d2b72 100644 --- a/App_Resources/iOS/src/module.modulemap +++ b/App_Resources/iOS/src/module.modulemap @@ -6,5 +6,6 @@ module FaceclawGraphics { header "FaceclawLc3Decoder.h" header "FaceclawSpeech.h" header "FaceclawConfigPort.h" + header "FaceclawEvenHubWebView.h" export * } diff --git a/app/apps/evenhub/ehpk.ts b/app/apps/evenhub/ehpk.ts index f082a2be..28638f1a 100644 --- a/app/apps/evenhub/ehpk.ts +++ b/app/apps/evenhub/ehpk.ts @@ -18,6 +18,11 @@ const RECORD_FILE = 0xe4; const RECORD_DIR = 0xe5; const RECORD_FOOTER = 0xe3; +/** Archive paths are relative to one package, never to the phone container. */ +export function safeEhpkPath(value: string): boolean { + return !!value && !/[\\\u0000:]/.test(value) && value.split('/').every(part => !!part && part !== '.' && part !== '..'); +} + export type EhpkArchive = { /** Relative path (e.g. "app.json", "dist/index.html") to contents. */ files: Map; @@ -90,6 +95,7 @@ export function parseEhpk(data: Uint8Array): EhpkArchive { const uncompressedLength = view.getUint32(p + 8, true); const nameLength = view.getUint16(p + 14, true); const name = utf8Decode(unxor(data, p + 16, nameLength)); + if (!safeEhpkPath(name)) throw new Error(`ehpk: invalid file path ${name}`); const blob = unxor(data, p + 16 + nameLength, compressedLength); const content = decompress(blob, new Uint8Array(uncompressedLength)); if (content.length !== uncompressedLength) { @@ -119,6 +125,7 @@ export function parseManifest(appJsonText: string): EvenHubManifest { const name = String(raw.name ?? packageId); const version = String(raw.version ?? "0"); const entrypoint = String(raw.entrypoint ?? "index.html"); + if (!safeEhpkPath(entrypoint)) throw new Error('Invalid EHPK entrypoint'); const permissions = parsePermissions(raw.permissions); const privacyPolicyUrl = firstSafeHttpsUrl( diff --git a/app/apps/evenhub/manager.ts b/app/apps/evenhub/manager.ts index 12b45346..036f9b3e 100644 --- a/app/apps/evenhub/manager.ts +++ b/app/apps/evenhub/manager.ts @@ -66,16 +66,15 @@ export async function launchPackage( ): Promise { const data = readBinaryFile(ehpkPath); if (!data) { - ctx.appendLog(`evenhub: could not read ${ehpkPath}`); - return; + throw new Error('Could not read the EHPK file.'); } const archive = parseEhpk(data); const appJson = archive.files.get("app.json"); if (!appJson) { - ctx.appendLog("evenhub: package has no app.json"); - return; + throw new Error('The EHPK package has no app.json.'); } const manifest = parseManifest(utf8Decode(appJson)); + if (!archive.files.has(`dist/${manifest.entrypoint}`)) throw new Error('The EHPK entrypoint is missing from dist/.'); const appId = options.appId ?? "evenhub"; if (options.singleton) { const existing = Array.from(running.values()).find((app) => app.appId === appId); @@ -88,16 +87,18 @@ export async function launchPackage( // Unpack fresh into app-private storage, keyed by package id. const safeId = manifest.packageId.replace(/[^A-Za-z0-9._-]/g, "_"); - const baseDir = `${appFilesDirPath()}/evenhub-apps/${safeId}`; + if (!safeId || safeId === '.' || safeId === '..') throw new Error('Invalid EHPK package ID'); + const baseDir = `${appFilesDirPath()}/evenhub-apps/${safeId}${global.isIOS ? `-${Date.now()}-${nextSerial}` : ''}`; deletePathRecursively(baseDir); for (const [name, content] of Array.from(archive.files)) { if (!writeBinaryFile(`${baseDir}/${name}`, content)) { - ctx.appendLog(`evenhub: failed to write ${name}`); - return; + deletePathRecursively(baseDir); + throw new Error(`Could not unpack ${name}.`); } } - await startApp(ctx, manifest, `${baseDir}/dist`, "", appId); + try { await startApp(ctx, manifest, `${baseDir}/dist`, "", appId, global.isIOS ? () => deletePathRecursively(baseDir) : undefined); } + catch (error) { deletePathRecursively(baseDir); throw error; } } /** @@ -111,6 +112,7 @@ async function startApp( distDir: string, remoteUrl: string, appId: string, + cleanup?: () => void, ): Promise { const windowId = `evenhub:app:${nextSerial++}`; const session = new EvenHubSession(manifest, distDir, ctx.appendLog, remoteUrl); @@ -123,6 +125,7 @@ async function startApp( phoneShownWindowId = null; } webView.destroy(); + cleanup?.(); running.delete(windowId); }, }); @@ -130,9 +133,11 @@ async function startApp( ensureBackHandler(); ctx.appendLog(`evenhub: launching ${manifest.name} ${manifest.version} (${manifest.packageId})`); - await ctx.launchInProcessApp(windowId, `window:${windowId}`, (options) => - createEvenHubWindow(windowId, appId, session, options, () => showOnPhone(windowId)), - ); + try { + await ctx.launchInProcessApp(windowId, `window:${windowId}`, (options) => + createEvenHubWindow(windowId, appId, session, options, () => showOnPhone(windowId)), + ); + } catch (error) { session.close(); throw error; } } /** @@ -210,6 +215,7 @@ export function closeRunningPackage(packageId: string): void { export function showOnPhone(windowId: string): void { const app = running.get(windowId); if (!app) return; + if (phoneShownWindowId && phoneShownWindowId !== windowId) hidePhone(); app.webView.showOnPhone(); phoneShownWindowId = windowId; } diff --git a/app/apps/evenhub/privacy-policy.ios.ts b/app/apps/evenhub/privacy-policy.ios.ts new file mode 100644 index 00000000..98d20710 --- /dev/null +++ b/app/apps/evenhub/privacy-policy.ios.ts @@ -0,0 +1,5 @@ +import { Utils } from '@nativescript/core' +/** Open outside the app runtime; this page has no EvenHub bridge. */ +export function openPrivacyPolicyOnPhone(url: string, _appName: string): void { + if (/^https:\/\//i.test(url)) Utils.openUrl(url) +} diff --git a/app/apps/evenhub/session.ts b/app/apps/evenhub/session.ts index c9341c8c..318f7cd6 100644 --- a/app/apps/evenhub/session.ts +++ b/app/apps/evenhub/session.ts @@ -334,6 +334,7 @@ export class EvenHubSession implements EvenHubMicClient, EvenHubImuClient, EvenH private windowHooks: EvenHubWindowHooks | null = null; private closed = false; private launchContextPushed = false; + private loadError = ''; private systemExitSent = false; /** The one-shot launch FOREGROUND_ENTER has been delivered (page exists). */ private launchEnterSent = false; @@ -383,6 +384,11 @@ export class EvenHubSession implements EvenHubMicClient, EvenHubImuClient, EvenH this.webViewHandle = handle; } + webViewFailed(message: string): void { + if (this.closed) return; + this.loadError = message; this.log(`evenhub: ${message}`); this.windowHooks?.requestRender(); + } + /** The WebView finished loading the app: push the one-shot launch context. */ webViewLoaded(): void { if (this.launchContextPushed) return; @@ -416,11 +422,12 @@ export class EvenHubSession implements EvenHubMicClient, EvenHubImuClient, EvenH // Focus changes always trigger a repaint of the foreground window, so paint // is a reliable place to sample shell input-focus for lifecycle events. this.updateShellFocus(focused); - if (!this.pageCreated || !this.page) { + if (this.loadError || !this.pageCreated || !this.page) { const image = new GrayImage(size.width, size.height, 0); const font = EvenHubFont.get(); - font.drawText(image, 16, 16, `Loading ${this.manifest.name}...`, 255); - font.drawText(image, 16, 16 + 2 * font.lineHeight, "(waiting for the app to build its page)", 120); + font.drawText(image, 16, 16, `${this.loadError ? 'Could not run' : 'Loading'} ${this.manifest.name}...`, 255); + font.drawTextWrapped(image, 16, 16 + 2 * font.lineHeight, Math.max(1, size.width - 32), + this.loadError || "(waiting for the app to build its page)", 120); return image; } return compositePage(this.page, size, focused); @@ -604,6 +611,7 @@ export class EvenHubSession implements EvenHubMicClient, EvenHubImuClient, EvenH * flows (foreground + screen on + no assistant modal). */ private audioControl(data: Record): boolean { + if (global.isIOS) return false; // EvenHub PCM routing is not ported yet. if (!permissionsIncludeMicrophone(this.manifest.permissions)) { this.log("evenhub: audioControl denied (app declares no microphone permission)"); return false; @@ -634,6 +642,7 @@ export class EvenHubSession implements EvenHubMicClient, EvenHubImuClient, EvenH /** getAppLocation(): one-shot fix, or null on denial/error (SDK contract). */ private async getAppLocation(): Promise { + if (global.isIOS) return null; if (!this.declaresLocation()) return null; if (!(await ensureFineLocationPermission())) return null; try { @@ -657,6 +666,7 @@ export class EvenHubSession implements EvenHubMicClient, EvenHubImuClient, EvenH * Navigate app's foreground-service-backed tracking. */ private async startLocationUpdates(data: Record): Promise { + if (global.isIOS) return false; if (!this.declaresLocation()) return false; if (!(await ensureFineLocationPermission())) return false; if (this.closed) return false; @@ -697,6 +707,7 @@ export class EvenHubSession implements EvenHubMicClient, EvenHubImuClient, EvenH * to the foreground app. reportFrq is one of 100..1000 (step 100). */ private imuControl(data: Record): boolean { + if (global.isIOS) return false; const enable = readEnableFlag(data); const freq = clampImuFreq(readOptionalNumber(data, "reportFrq") ?? readOptionalNumber(data, "reportFreq") ?? 100); // Payload field spelling isn't fully captured; log once per toggle. diff --git a/app/apps/evenhub/webview.ios.ts b/app/apps/evenhub/webview.ios.ts new file mode 100644 index 00000000..d4421b0a --- /dev/null +++ b/app/apps/evenhub/webview.ios.ts @@ -0,0 +1,43 @@ +import { EVENHUB_BRIDGE_INJECT_SCRIPT, buildFaceclawExtensionsScript, type EvenHubSession } from './session' +import { FACECLAW_VERSION } from '../../version' +import type { EvenHubWebView } from './webview' +declare const FaceclawEvenHubWebView: any + +export const IOS_EVENHUB_TRANSPORT_SCRIPT = ` +window.__faceclawEvenHub = { postMessage: function(name, args, id) { + window.webkit.messageHandlers.faceclaw.postMessage({kind:'call', name:name, args:args, id:id}); +}}; +(function() { + ['log','warn','error'].forEach(function(level) { + var original = console[level]; + console[level] = function() { + original.apply(console, arguments); + window.webkit.messageHandlers.faceclaw.postMessage({kind:'console', message:Array.prototype.map.call(arguments, String).join(' ').slice(0,4000)}); + }; + }); + window.addEventListener('error', function(e) { console.error(e.message); }); + window.addEventListener('unhandledrejection', function(e) { console.error(String(e.reason)); }); +})(); +` + +export function createEvenHubWebView(session: EvenHubSession): EvenHubWebView { + if (session.remoteUrl) throw new Error('On iOS, open a local .ehpk package from Files.') + const host = FaceclawEvenHubWebView.new() + host.packageIdentifier = session.manifest.packageId + host.eventHandler = (json: string) => { + try { + const event = JSON.parse(json) + if (event.kind === 'call' && typeof event.name === 'string' && typeof event.args === 'string' && Number.isSafeInteger(event.id)) + session.handleBridgeCall(event.name, event.args, event.id) + else if (event.kind === 'loaded') session.webViewLoaded() + else if (event.kind === 'error') session.webViewFailed(String(event.message)) + else if (event.kind === 'console') console.log(`[evenhub:${session.manifest.name}] ${event.message}`) + } catch (error) { console.warn(`EvenHub bridge: ${error}`) } + } + // Defer loading until manager.ts has attached the session/window handles. + const loading = setTimeout(() => host.startEntrypointScript(session.distDir, session.manifest.entrypoint, + IOS_EVENHUB_TRANSPORT_SCRIPT + EVENHUB_BRIDGE_INJECT_SCRIPT + buildFaceclawExtensionsScript(`Faceclaw/${FACECLAW_VERSION}`)), 0) + return { native: host, evaluateJs: js => host.evaluate(js), + destroy: () => { clearTimeout(loading); host.destroy() }, + showOnPhone: () => host.showOnPhone(), hideOnPhone: () => host.hideOnPhone() } +} diff --git a/app/apps/files/files-app.ts b/app/apps/files/files-app.ts index 540be7d2..f628289d 100644 --- a/app/apps/files/files-app.ts +++ b/app/apps/files/files-app.ts @@ -45,7 +45,7 @@ export type FilesAppOptions = InProcessAppOptions & { export function createFilesAppWindow(options: FilesAppOptions): InProcessWindow { let created: InProcessWindow | null = null; const browser = new FileBrowserLayer({ - isSupportedFile: (name) => TEXT_FILE.test(name) || isFontFile(name) || (!global.isIOS && (isDecodableImageFile(name) || EHPK_FILE.test(name))), + isSupportedFile: (name) => TEXT_FILE.test(name) || isFontFile(name) || EHPK_FILE.test(name) || (!global.isIOS && isDecodableImageFile(name)), // The browser handles double-click itself (up a level), so it is not // wrapped in YieldAtRootLayer; it yields explicitly from the top level. onLeave: () => shell.yieldFocusToSidebar(), @@ -170,7 +170,7 @@ function confirmEhpkPermissions(ctx: LayerContext, entry: DirectoryEntry, procee * window for viewable types, empty for everything else (metadata only). */ function fileOpenActions(entry: DirectoryEntry, options: FilesAppOptions): FileInfoAction[] { - if (global.isIOS && !TEXT_FILE.test(entry.name) && !isFontFile(entry.name)) return []; + if (global.isIOS && !TEXT_FILE.test(entry.name) && !isFontFile(entry.name) && !EHPK_FILE.test(entry.name)) return []; if (TEXT_FILE.test(entry.name)) { return [ { @@ -192,7 +192,7 @@ function fileOpenActions(entry: DirectoryEntry, options: FilesAppOptions): FileI ]; } if (EHPK_FILE.test(entry.name)) { - return [ + const actions: FileInfoAction[] = [ { label: "Run app", onSelect: (ctx) => { @@ -210,6 +210,7 @@ function fileOpenActions(entry: DirectoryEntry, options: FilesAppOptions): FileI }, }, ]; + return global.isIOS ? actions.slice(0, 1) : actions; } if (isDecodableImageFile(entry.name)) { return [ diff --git a/app/apps/files/index.ts b/app/apps/files/index.ts index 0b744e48..92301cca 100644 --- a/app/apps/files/index.ts +++ b/app/apps/files/index.ts @@ -64,6 +64,7 @@ const filesApp: AppDefinition = { openEhpkApp: (path) => { void openEvenHubPackage(ctx, path).catch((error) => { ctx.appendLog(`evenhub launch failed: ${error}`); + openTextDocumentWindow(ctx, 'Could not run app', String(error)); }); }, installEhpkApp: async (path) => { diff --git a/app/apps/ios-availability.ts b/app/apps/ios-availability.ts index 0a157dbe..4a6b794a 100644 --- a/app/apps/ios-availability.ts +++ b/app/apps/ios-availability.ts @@ -8,7 +8,7 @@ const unavailable: Record = { navigate: 'Navigation location tracking is not available on iOS yet.', weather: 'Weather location access is not available on iOS yet.', calendar: 'Calendar access is not available on iOS yet.', - evenhub: 'The EvenHub store and app runtime are not available on iOS yet.', + evenhub: 'Open a local .ehpk file in Files to run an EvenHub app. The EvenHub store is not available on iOS yet.', } export function iosAppUnavailableReason(appId: string): string | null { return unavailable[appId] ?? null diff --git a/app/graphics/evenhub-font.ts b/app/graphics/evenhub-font.ts index e1a8f55f..61e5025a 100644 --- a/app/graphics/evenhub-font.ts +++ b/app/graphics/evenhub-font.ts @@ -22,12 +22,10 @@ import { File, knownFolders } from "@nativescript/core"; import { getTextWidth } from "@evenrealities/pretext"; import { EVENHUB_RUNTIME_FONT_FILENAME, isEvenHubFontAsset } from "../g2/firmware-fonts"; -import { toUint8Array } from "../util/array-util"; +import { lvglMetrics, lvglGlyph } from "../native/lvgl-font"; import { GrayImage, grayToNibble, type FwTextFont, type PlacedFwText, type PlacedFwTextGlyph } from "./image"; import { TtfFont } from "./ttf-font"; -declare const com: any; - const CJK_ASSET_PATH = "fonts/source-han-sans/SourceHanSansSC-Light-20.lvgl.bin"; /** @@ -124,7 +122,7 @@ export class EvenHubFont implements FwTextFont { this.glyphs.set(Number(key), asset.glyphs[key]!); } this.cjkPath = knownFolders.currentApp().getFile(CJK_ASSET_PATH).path; - const metrics = toUint8Array(com.faceclaw.app.LvglFontFile.getMetrics(this.cjkPath)); + const metrics = lvglMetrics(this.cjkPath); if (metrics.length < 2) { throw new Error("The bundled Source Han Sans font could not be loaded."); } @@ -388,7 +386,7 @@ export class EvenHubFont implements FwTextFont { private getCjkGlyph(codePoint: number): CjkGlyph | null { const cached = this.cjkGlyphs.get(codePoint); if (cached !== undefined) return cached; - const bytes = toUint8Array(com.faceclaw.app.LvglFontFile.getGlyph(this.cjkPath, codePoint)); + const bytes = lvglGlyph(this.cjkPath, codePoint); if (bytes.length < 8) { this.cjkGlyphs.set(codePoint, null); return null; diff --git a/app/graphics/lvgl-font.ts b/app/graphics/lvgl-font.ts new file mode 100644 index 00000000..60dd57e2 --- /dev/null +++ b/app/graphics/lvgl-font.ts @@ -0,0 +1,53 @@ +/** Reader for the bundled Source Han Sans serialized LVGL font. Matches + * Android LvglFontFile's metrics/glyph byte format, without a Java dependency. */ +export class LvglFont { + readonly metrics: Uint8Array + private readonly view: DataView + private readonly ids = new Map() + private readonly bitmaps: number + private readonly descriptors: number + constructor(private readonly bytes: Uint8Array) { + this.view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength) + if (bytes.length < 64 || bytes.slice(0, 4).some(v => v !== 90)) throw new Error('Missing LVGL font header') + const height = this.u16(0x38), baseline = height - this.u16(0x3a) + const descriptor = this.pointer(this.u32(0x34)) + this.bitmaps = this.pointer(this.u32(descriptor)); this.descriptors = this.pointer(this.u32(descriptor + 4)) + const cmaps = this.pointer(this.u32(descriptor + 8)), packed = this.u16(descriptor + 18), count = packed & 0x1ff + if (!height || baseline < 0 || !count || ((packed >>> 9) & 15) !== 4 || (packed >>> 14) !== 3) throw new Error('Unsupported LVGL font') + this.metrics = new Uint8Array([height, baseline]) + for (let i = 0; i < count; i++) { + const at = cmaps + i * 20, start = this.u32(at), length = this.u16(at + 4), first = this.u16(at + 6) + const unicodePtr = this.u32(at + 8), offsetsPtr = this.u32(at + 12), listLength = this.u16(at + 16), type = this.u8(at + 18) + if (type === 2 || type === 0) { + const offsets = type === 0 ? this.pointer(offsetsPtr) : 0 + for (let n = 0; n < length; n++) { + const offset = type === 0 ? this.u8(offsets + n) : n + if (n && !offset) continue + this.ids.set(start + n, first + offset) + } + } else if (type === 1 || type === 3) { + const unicode = this.pointer(unicodePtr), offsets = offsetsPtr ? this.pointer(offsetsPtr) : -1 + for (let n = 0; n < listLength; n++) { + const offset = offsets < 0 ? n : type === 1 ? this.u16(offsets + n * 2) : this.u8(offsets + n) + if (n && !offset) continue + this.ids.set(start + this.u16(unicode + n * 2), first + offset) + } + } else throw new Error('Unsupported LVGL cmap') + } + } + glyph(codePoint: number): Uint8Array { + const id = this.ids.get(codePoint) + if (!id) return new Uint8Array() + const at = this.descriptors + id * 16, bitmap = this.bitmaps + this.u32(at) + const width = this.u16(at + 8), height = this.u16(at + 10), length = width && height ? (Math.floor(width / 2) + 1) * height : 0 + this.check(bitmap, length) + const result = new Uint8Array(8 + length) + result.set(this.bytes.subarray(at + 8, at + 16)); result.set(this.bytes.subarray(bitmap, bitmap + length), 8) + return result + } + private check(at: number, size: number): void { if (at < 0 || at + size > this.bytes.length) throw new Error('Truncated LVGL font') } + private pointer(address: number): number { const at = address - 0x80100000; this.check(at, 1); return at } + private u8(at: number): number { this.check(at, 1); return this.bytes[at] } + private u16(at: number): number { return this.view.getUint16(at, true) } + private u32(at: number): number { return this.view.getUint32(at, true) } +} diff --git a/app/native/lvgl-font.ios.ts b/app/native/lvgl-font.ios.ts new file mode 100644 index 00000000..99dbdd01 --- /dev/null +++ b/app/native/lvgl-font.ios.ts @@ -0,0 +1,16 @@ +import { LvglFont } from '../graphics/lvgl-font' +import { readBinaryFile } from './file-access' +const cache = new Map() +function load(path: string): LvglFont { + let font = cache.get(path) + if (!font) { + const bytes = readBinaryFile(path) + if (!bytes) throw new Error('Cannot read LVGL font') + font = new LvglFont(bytes) + if (cache.size >= 2) cache.delete(cache.keys().next().value!) + cache.set(path, font) + } + return font +} +export function lvglMetrics(path: string): Uint8Array { return load(path).metrics } +export function lvglGlyph(path: string, codePoint: number): Uint8Array { return load(path).glyph(codePoint) } diff --git a/app/native/lvgl-font.ts b/app/native/lvgl-font.ts new file mode 100644 index 00000000..9b403e91 --- /dev/null +++ b/app/native/lvgl-font.ts @@ -0,0 +1,4 @@ +import { toUint8Array } from '../util/array-util' +declare const com: any +export function lvglMetrics(path: string): Uint8Array { return toUint8Array(com.faceclaw.app.LvglFontFile.getMetrics(path)) } +export function lvglGlyph(path: string, codePoint: number): Uint8Array { return toUint8Array(com.faceclaw.app.LvglFontFile.getGlyph(path, codePoint)) } diff --git a/scripts/ios-config.md b/scripts/ios-config.md new file mode 100644 index 00000000..e53b6ac7 --- /dev/null +++ b/scripts/ios-config.md @@ -0,0 +1,53 @@ +# iOS config transfer + +Requires Xcode, Python 3, a development build with `FaceclawConfigPort`, and an +unlocked/trusted iPhone. Both commands restart Faceclaw, briefly interrupting its +Bluetooth and Terminal sessions. + +```sh +scripts/pull_config_ios.sh # faceclaw_settings.ios.json +scripts/push_config_ios.sh # import the edited file +scripts/pull_config_ios.sh -f /tmp/settings.json --device IPHONE_UDID +scripts/push_config_ios.sh faceclaw_settings.xml # Android pull_config.sh output +``` + +Use `--device` / `-d` or set `IOS_DEVICE` when more than one device is connected. +Without either, the script selects the only device with an active Xcode tunnel. +For the simulator, add `--simulator` (defaults to `booted`; `--device` selects one). + +The JSON format preserves setting types: + +```json +{ + "schema": 1, + "settings": { + "terminal.connections": "[]", + "terminal.autoReconnect": true + } +} +``` + +Pull accepts an `.xml` output filename to write Android shared-preferences XML. +Push detects JSON or XML by content and supports strings, booleans and numbers. +Malformed input, unsupported values and files over 2 MiB fail before restarting +the app. Push **merges supplied keys**, preserving omitted settings (including +phone-specific pairing). To clear a value, supply its empty/default value. + +Transfers use `devicectl` app-container access. The app consumes a uniquely +identified request at bootstrap, before loading settings getters and workers; +it applies imports through NSUserDefaults rather than overwriting a plist that +cfprefsd could restore from cache. Each successful push first saves the previous +preferences to `Library/FaceclawConfigPort/previous.plist`. Replies are checked +against the request ID, so a stale export cannot appear to confirm an import. + +Exports may contain API keys and Terminal tokens. Scripts do not print values, +write local exports with mode 600, and remove their private temporary directory +on exit. Default export filenames are gitignored. Device request/reply/backup +files stay in the private Library directory, outside Files/Finder Documents. + +Terminal's configured `g2mirror://` scheme uses plain WebSockets; `g2mirrors://` +uses TLS. The iOS build declares local networking and an explicit ATS exception +for the current development server `100.68.94.67`. On iOS 17+, another literal IP +requires its own build-time `NSExceptionDomains` entry, or a TLS endpoint. The +exception does not disable TLS certificate verification. See Apple's +[IP exception rules](https://developer.apple.com/documentation/bundleresources/information-property-list/nsapptransportsecurity/nsexceptiondomains). diff --git a/scripts/ios_config.py b/scripts/ios_config.py new file mode 100644 index 00000000..f5962a39 --- /dev/null +++ b/scripts/ios_config.py @@ -0,0 +1,197 @@ +#!/usr/bin/env python3 +"""Transfer Faceclaw preferences using Xcode's supported app-container APIs.""" +import argparse +import json +import math +import os +from pathlib import Path +import subprocess +import sys +import tempfile +import time +import uuid +import xml.etree.ElementTree as ET + +BUNDLE = 'com.faceclaw.app' +REMOTE = 'Library/FaceclawConfigPort' +LIMIT = 2 * 1024 * 1024 + + +def validate(settings): + if not isinstance(settings, dict) or len(settings) > 4096: + raise ValueError('Expected a settings object with at most 4096 entries') + for key, value in settings.items(): + if not isinstance(key, str) or not key or len(key) > 512: + raise ValueError('Invalid setting name') + if type(value) not in (str, bool, int, float) or isinstance(value, float) and not math.isfinite(value): + raise ValueError('Settings must contain only strings, booleans and finite numbers') + return settings + + +def read_config(path): + data = Path(path).read_bytes() + if len(data) > LIMIT: + raise ValueError('Config exceeds 2 MiB') + if data.lstrip().startswith(b'<'): + if b'') + settings = {} + for item in root: + key = item.get('name') + if key in settings: + raise ValueError('Duplicate setting name') + if item.tag == 'string': + value = item.text or '' + elif item.tag == 'boolean' and item.get('value') in ('true', 'false'): + value = item.get('value') == 'true' + elif item.tag in ('int', 'long', 'float'): + try: + value = float(item.get('value', '')) if item.tag == 'float' else int(item.get('value', '')) + except ValueError: + raise ValueError('Invalid numeric preference value') from None + else: + raise ValueError('Unsupported Android preference type') + if len(item): + raise ValueError('Nested preference content is not supported') + settings[key] = value + else: + config = json.loads(data) + if not isinstance(config, dict) or config.get('schema') != 1: + raise ValueError('Expected Faceclaw config with schema: 1 and a settings object') + settings = config.get('settings') + return validate(settings) + + +def encode_config(settings, xml=False): + validate(settings) + if not xml: + return (json.dumps({'schema': 1, 'settings': settings}, indent=2, ensure_ascii=False, allow_nan=False) + '\n').encode() + root = ET.Element('map') + for key, value in sorted(settings.items()): + if isinstance(value, str): + ET.SubElement(root, 'string', name=key).text = value + else: + kind = 'boolean' if isinstance(value, bool) else 'long' if isinstance(value, int) else 'float' + ET.SubElement(root, kind, name=key, value=str(value).lower()) + ET.indent(root) + return ET.tostring(root, encoding='utf-8', xml_declaration=True) + b'\n' + + +def run(args, tolerate=False): + try: + result = subprocess.run(['xcrun', *args], stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True, timeout=30) + except subprocess.TimeoutExpired: + if tolerate: + return subprocess.CompletedProcess(args, 1, '', 'Xcode device command timed out') + raise RuntimeError('Xcode device command timed out; check that the phone is connected and unlocked') from None + if result.returncode and not tolerate: + raise RuntimeError(result.stderr.strip() or result.stdout.strip() or 'Xcode device command failed') + return result + + +def atomic_write(path, data): + path = Path(path).absolute() + with tempfile.NamedTemporaryFile(dir=path.parent, delete=False) as output: + temporary = Path(output.name) + try: + os.chmod(temporary, 0o600) + output.write(data) + output.flush() + os.fsync(output.fileno()) + os.replace(temporary, path) + finally: + temporary.unlink(missing_ok=True) + + +def transfer(args): + # Parse and validate before touching the device or restarting its app. + settings = read_config(args.file) if args.operation == 'push' else None + with tempfile.TemporaryDirectory(prefix='faceclaw-config-') as work: + work = Path(work) + device = args.device or os.environ.get('IOS_DEVICE') + if args.simulator: + device = device or 'booted' + container = Path(run(['simctl', 'get_app_container', device, BUNDLE, 'data']).stdout.strip()) + else: + if not device: + listing = work / 'devices.json' + run(['devicectl', 'list', 'devices', '--json-output', str(listing)]) + devices = json.loads(listing.read_text())['result']['devices'] + available = [d for d in devices if d.get('connectionProperties', {}).get('tunnelState') == 'connected'] + if len(available) != 1: + raise ValueError('Specify the iPhone with --device UDID (or IOS_DEVICE)') + device = available[0]['identifier'] + identifier = str(uuid.uuid4()) + payload = {'id': identifier, 'operation': args.operation} + if settings is not None: + payload['settings'] = settings + encoded = json.dumps(payload, ensure_ascii=False, allow_nan=False).encode() + if len(encoded) > LIMIT: + raise ValueError('Config request exceeds 2 MiB') + stage = work / 'FaceclawConfigPort' + stage.mkdir(mode=0o700) + atomic_write(stage / 'request.json', encoded) + if args.simulator: + remote = container / REMOTE + remote.mkdir(parents=True, exist_ok=True) + atomic_write(remote / 'request.json', encoded) + run(['simctl', 'terminate', device, BUNDLE], tolerate=True) + run(['simctl', 'launch', device, BUNDLE]) + else: + run(['devicectl', 'device', 'copy', 'to', '--device', device, '--domain-type', 'appDataContainer', + '--domain-identifier', BUNDLE, '--source', str(stage), '--destination', REMOTE]) + run(['devicectl', 'device', 'process', 'launch', '--device', device, '--terminate-existing', BUNDLE]) + deadline = time.monotonic() + 25 + response = None + while time.monotonic() < deadline: + if args.simulator: + response_path = remote / 'response.json' + else: + response_path = work / 'response.json' + run(['devicectl', 'device', 'copy', 'from', '--device', device, '--domain-type', 'appDataContainer', + '--domain-identifier', BUNDLE, '--source', REMOTE + '/response.json', '--destination', str(response_path)], tolerate=True) + try: + candidate = json.loads(response_path.read_text()) + if candidate.get('id') == identifier: + response = candidate + break + except (OSError, ValueError): + pass + time.sleep(0.5) + if response is None: + raise RuntimeError('No matching config response. Unlock the phone and install a build with config-port support, then retry.') + if not response.get('ok'): + raise RuntimeError(response.get('message', 'Config transfer failed')) + if args.operation == 'pull': + settings = response['config']['settings'] + atomic_write(args.file, encode_config(settings, Path(args.file).suffix.lower() == '.xml')) + print(f'Pulled {len(settings)} settings to {args.file} (mode 600). App restarted.') + else: + print(f'Pushed {response["count"]} settings; app restarted. Unspecified settings preserved; previous preferences backed up in {REMOTE}/previous.plist.') + + +def main(): + os.umask(0o077) + parser = argparse.ArgumentParser(description='Pull/push iOS Faceclaw config; restarts the app. Requires Xcode and an unlocked development device. Push merges supplied keys; accepts Android XML or Faceclaw JSON.') + parser.add_argument('operation', choices=['pull', 'push']) + parser.add_argument('path', nargs='?') + parser.add_argument('-f', '--file') + parser.add_argument('-d', '--device', help='iPhone UDID/name, or simulator ID with --simulator; defaults to IOS_DEVICE or the only connected device') + parser.add_argument('--simulator', action='store_true', help='Use simctl (default device: booted)') + args = parser.parse_args() + if args.path and args.file: + parser.error('Specify one file, either positional or with -f') + args.file = args.file or args.path or 'faceclaw_settings.ios.json' + try: + transfer(args) + except (OSError, ValueError, RuntimeError, ET.ParseError) as error: + print(f'Error: {error}', file=sys.stderr) + return 1 + return 0 + + +if __name__ == '__main__': + sys.exit(main()) diff --git a/scripts/pull_config_ios.sh b/scripts/pull_config_ios.sh new file mode 100755 index 00000000..65a482c4 --- /dev/null +++ b/scripts/pull_config_ios.sh @@ -0,0 +1,3 @@ +#!/usr/bin/env bash +set -euo pipefail +exec python3 "$(cd "$(dirname "$0")" && pwd)/ios_config.py" pull "$@" diff --git a/scripts/push_config_ios.sh b/scripts/push_config_ios.sh new file mode 100755 index 00000000..f3cc5bd0 --- /dev/null +++ b/scripts/push_config_ios.sh @@ -0,0 +1,3 @@ +#!/usr/bin/env bash +set -euo pipefail +exec python3 "$(cd "$(dirname "$0")" && pwd)/ios_config.py" push "$@" diff --git a/tests/ios-evenhub-native.cjs b/tests/ios-evenhub-native.cjs new file mode 100644 index 00000000..209caffc --- /dev/null +++ b/tests/ios-evenhub-native.cjs @@ -0,0 +1,42 @@ +// Run the production WKWebView host in an isolated simulator app, no glasses. +const { execFileSync } = require('node:child_process'); +const fs = require('node:fs'), path = require('node:path'), os = require('node:os'); +const { loader } = require('./helpers/load-typescript.cjs'); +const root = path.resolve(__dirname, '..'), work = fs.mkdtempSync(path.join(os.tmpdir(), 'faceclaw-evenhub-probe-')); +const bundle = path.join(work, 'EvenHubProbe.app'), dist = path.join(bundle, 'dist'); +fs.mkdirSync(dist, { recursive: true }); +const source = fs.readFileSync(path.join(root, 'app/apps/evenhub/session.ts'), 'utf8'); +const shim = source.match(/export const EVENHUB_BRIDGE_INJECT_SCRIPT = `([\s\S]*?)`;/)[1]; +const adapter = loader({}, { './session': {}, '../../version': {} })('app/apps/evenhub/webview.ios.ts').IOS_EVENHUB_TRANSPORT_SCRIPT; +fs.writeFileSync(path.join(bundle, 'bridge.js'), adapter + shim); +fs.writeFileSync(path.join(bundle, 'secret.txt'), 'must not be served'); +fs.writeFileSync(path.join(dist, 'index.html'), ``); +fs.writeFileSync(path.join(dist, 'app.js'), ` +import { value } from './module.js'; +const call = name => flutter_inappwebview.callHandler(name); +if (value === 42) await call('module'); +const previous = localStorage.getItem('probe'); localStorage.setItem('probe','saved'); await call(previous === 'saved' ? 'restored' : 'stored'); +if ((await (await fetch('/data.json')).json()).ok) await call('fetch'); +const image = new Image(); image.onload = () => call('image'); image.src = '/pixel.png'; +setTimeout(() => call('timer'), 40); requestAnimationFrame(() => call('raf')); +await WebAssembly.instantiate(new Uint8Array([0,97,115,109,1,0,0,0])); await call('wasm'); +if (!(await fetch('/%2e%2e/secret.txt')).ok) await call('traversal'); +`); +fs.writeFileSync(path.join(dist, 'module.js'), 'export const value = 42;'); +fs.writeFileSync(path.join(dist, 'data.json'), '{"ok":true}'); +fs.writeFileSync(path.join(dist, 'pixel.png'), Buffer.from('iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO+aBVkAAAAASUVORK5CYII=', 'base64')); +fs.writeFileSync(path.join(bundle, 'Info.plist'), `CFBundleIdentifiercom.faceclaw.evenhub-probeCFBundleExecutableEvenHubProbeCFBundleNameEvenHubProbeCFBundlePackageTypeAPPLCFBundleVersion1CFBundleShortVersionString1UILaunchScreenLSRequiresIPhoneOS`); +const sdk = execFileSync('xcrun', ['--sdk', 'iphonesimulator', '--show-sdk-path'], { encoding: 'utf8' }).trim(); +execFileSync('xcrun', ['clang', '-fobjc-arc', '-target', `${process.arch === 'arm64' ? 'arm64' : 'x86_64'}-apple-ios15.1-simulator`, '-isysroot', sdk, + '-framework', 'UIKit', '-framework', 'Foundation', '-framework', 'CoreGraphics', '-framework', 'WebKit', '-framework', 'UniformTypeIdentifiers', + '-I', 'App_Resources/iOS/src', 'tests/native/ios-evenhub-test.m', 'App_Resources/iOS/src/FaceclawEvenHubWebView.m', '-o', path.join(bundle, 'EvenHubProbe')], { cwd: root, stdio: 'inherit' }); +const device = process.argv[2] || 'booted'; +execFileSync('xcrun', ['simctl', 'install', device, bundle], { stdio: 'inherit' }); +execFileSync('xcrun', ['simctl', 'launch', '--terminate-running-process', device, 'com.faceclaw.evenhub-probe'], { stdio: 'inherit' }); +const container = execFileSync('xcrun', ['simctl', 'get_app_container', device, 'com.faceclaw.evenhub-probe', 'data'], { encoding: 'utf8' }).trim(); +const resultFile = path.join(container, 'Documents/result.json'); +setTimeout(() => { + const result = JSON.parse(fs.readFileSync(resultFile, 'utf8')); + console.log(JSON.stringify({ work, ...result })); + if (!result.passed) process.exitCode = 1; +}, 14000); diff --git a/tests/ios-evenhub.test.cjs b/tests/ios-evenhub.test.cjs new file mode 100644 index 00000000..69953879 --- /dev/null +++ b/tests/ios-evenhub.test.cjs @@ -0,0 +1,156 @@ +const test = require('node:test'); +const assert = require('node:assert/strict'); +const fs = require('node:fs'), vm = require('node:vm'); +const { createHash } = require('node:crypto'); +const { zstdCompressSync } = require('node:zlib'); +const { loader } = require('./helpers/load-typescript.cjs'); +const { LvglFont } = require('../.test-build/app/graphics/lvgl-font.js'); + +function pack(files) { + const key = Buffer.from('EVEN REALITIES'); + const xor = b => Buffer.from(b.map((v, i) => v ^ key[i % key.length])); + const header = Buffer.alloc(20); header.write('EHPK'); header.writeUInt32LE(20, 8); + return Buffer.concat([header, ...Object.entries(files).map(([name, value]) => { + const text = Buffer.from(value), body = zstdCompressSync(text), path = Buffer.from(name), record = Buffer.alloc(16); + record.writeUInt32LE(0xbaa9bae4); record.writeUInt32LE(body.length, 4); record.writeUInt32LE(text.length, 8); record.writeUInt16LE(path.length, 14); + return Buffer.concat([record, xor(path), xor(body)]); + })]); +} + +test('iOS LVGL reader loads the bundled font including CJK and game symbols', () => { + const bytes = new Uint8Array(fs.readFileSync('app/fonts/source-han-sans/SourceHanSansSC-Light-20.lvgl.bin')); + const font = new LvglFont(bytes); + // Metrics and full glyph SHA-256 vectors from production Java LvglFontFile. + assert.deepEqual([...font.metrics], [25, 19]); + const vectors = [ + [0x25a6, 'b08ecb603fd059b0a00ba3088f18b79185c421e73049797cd3cb0828e1e5cd04'], + [0x25c6, 'c176d5dcdb5f7e3a7220455528efde3760672c40cee39b422fc3f5ad20df66dd'], + [0x4e2d, '9bde2c8f1ffcf7afc598f4d0350c9ff262484816aa0c9b46d31f0c3c09613003'], + [0xff21, '0074f96299a75b86912282416e47e0823790e091352aec852eff49b89b2e719d'], + ]; + for (const [cp, hash] of vectors) { + const glyph = font.glyph(cp); + const w = glyph[0] | glyph[1] << 8, h = glyph[2] | glyph[3] << 8; + assert.ok(w > 0 && h > 0); assert.equal(glyph.length, 8 + (Math.floor(w / 2) + 1) * h); + assert.equal(createHash('sha256').update(glyph).digest('hex'), hash); + } + assert.equal(font.glyph(0x10ffff).length, 0); + assert.throws(() => new LvglFont(bytes.subarray(0, 80)), /bounds|Truncated/); +}); + +test('EHPK entrypoints and extraction paths cannot escape their package directory', () => { + const load = loader({}, { fzstd: require('fzstd') }); + const api = load('app/apps/evenhub/ehpk.ts'); + assert.equal(api.safeEhpkPath('dist/assets/game.js'), true); + for (const path of ['../settings.json', '/private/file', 'dist/../../file', 'dist\\file', 'dist//x', '.', '..', 'x\0y', 'https://host/app']) { + assert.equal(api.safeEhpkPath(path), false); + assert.throws(() => api.parseManifest(JSON.stringify({ entrypoint: path })), /entrypoint/); + assert.throws(() => api.parseEhpk(pack({ [path]: 'test' })), /invalid file path/); + } + const archive = api.parseEhpk(pack({ 'app.json': '{"package_id":"test.app"}', 'dist/index.html': 'test' })); + assert.ok(archive.files.has('dist/index.html')); +}); + +test('Files on iOS exposes Run app for EHPKs and passes the selected local path', () => { + let browserOptions, actions, opened; + const load = loader({ global: { isIOS: true } }, { + '../../native/file-access': {}, '../../native/font-files': { isFontFile: () => false }, + '../../graphics/installed-fonts': {}, '../../native/image-files': { isDecodableImageFile: () => false }, + '../evenhub/installed-apps': { readEvenHubPackageManifest: () => null }, '../evenhub/permission-dialog': {}, + './file-browser': { FileBrowserLayer: class { constructor(options) { browserOptions = options; } } }, + './file-info-dialog': { FileInfoDialogLayer: class { constructor(entry, value) { actions = value; } } }, + './font-previewer': {}, './image-viewer': {}, './text-viewer': {}, + '../../ui/shell/in-process-window': { createInProcessWindow: () => ({}) }, '../../ui/shell/shell': {}, + }); + load('app/apps/files/files-app.ts').createFilesAppWindow({ openEhpkApp: path => { opened = path; } }); + assert.equal(browserOptions.isSupportedFile('test.EHPK'), true); + const ctx = { stack: { push() {}, pop() {} } }; + browserOptions.onFilePicked({ name: 'test.ehpk', path: '/Documents/test.ehpk' }, ctx); + assert.deepEqual(Array.from(actions, a => a.label), ['Run app']); + actions[0].onSelect(ctx); assert.equal(opened, '/Documents/test.ehpk'); +}); + +test('local package runtimes unpack independently and clean up after closing or a failed launch', async () => { + const files = new Map(), sessions = []; + const manifest = { package_id: 'test.app', name: 'Test' }; + let archive = pack({ 'app.json': JSON.stringify(manifest), 'dist/index.html': 'test' }); + class Session { constructor(manifest, distDir) { this.manifest = manifest; this.distDir = distDir; sessions.push(this); } attachWebView(handle) { this.handle = handle; } close() { this.handle.destroy(); } } + const load = loader({ global: { isIOS: true } }, { + '@nativescript/core': { Application: {} }, fzstd: require('fzstd'), + '../../native/file-access': { appFilesDirPath: () => '/private/app', readBinaryFile: () => archive, + writeBinaryFile: (path, bytes) => { files.set(path, bytes); return true; }, + deletePathRecursively: path => { for (const key of files.keys()) if (key.startsWith(path + '/')) files.delete(key); } }, + './session': { EvenHubSession: Session }, './evenhub-window': { createEvenHubWindow: () => ({}) }, + './webview': { createEvenHubWebView: () => ({ evaluateJs() {}, destroy() {} }) }, + '../../ui/shell/shell': {}, './installed-apps': {}, + }); + const manager = load('app/apps/evenhub/manager.ts'), ctx = { appendLog() {}, launchInProcessApp: async () => {} }; + await manager.launchPackage(ctx, '/test.ehpk'); await manager.launchPackage(ctx, '/test.ehpk'); + assert.notEqual(sessions[0].distDir, sessions[1].distDir); assert.equal(manager.runningAppCount(), 2); + sessions[0].close(); assert.equal(manager.runningAppCount(), 1); + assert.ok(files.has(sessions[1].distDir + '/index.html')); assert.ok(!files.has(sessions[0].distDir + '/index.html')); + sessions[1].close(); assert.equal(files.size, 0); + await assert.rejects(manager.launchPackage({ ...ctx, launchInProcessApp: async () => { throw new Error('test launch failed'); } }, '/test.ehpk'), /test launch failed/); + assert.equal(files.size, 0); assert.equal(manager.runningAppCount(), 0); + archive = pack({ 'app.json': JSON.stringify(manifest) }); + await assert.rejects(manager.launchPackage(ctx, '/bad.ehpk'), /entrypoint is missing/); + assert.equal(files.size, 0); +}); + +function sessionHarness() { + const settings = new Map(), logs = [], renders = []; + const load = loader({ global: { isIOS: true }, setTimeout, clearTimeout, Promise }, { + '@nativescript/core': { ApplicationSettings: { getString: (k, d) => settings.get(k) ?? d, setString: (k, v) => settings.set(k, v) } }, + 'upng-js': require('upng-js'), + '../../graphics/evenhub-font': { EvenHubFont: { get: () => ({ drawText() {}, drawTextWrapped() {}, lineHeight: 20 }) } }, + '../../ui/dashboard-settings': {}, '../../ui/sound-effects': {}, './api-key-dialog': {}, + './mic-router': { evenHubMicRouter: {} }, './imu-router': { evenHubImuRouter: {} }, + './compass-router': { evenHubCompassRouter: {} }, '../../assistant/tool-registry': {}, + '../../native/location': {}, '../../native/location-tracker': {}, '../../g2/android-permissions': {}, + }); + const api = load('app/apps/evenhub/session.ts'); + const session = new api.EvenHubSession({ name: 'Probe', packageId: 'test.probe', permissions: [] }, '/test/dist', line => logs.push(line)); + session.attachWindow({ requestRender: () => renders.push(1), windowId: 'probe', closeWindow() {} }); + const web = vm.createContext({ Promise, Map, Date, console }); + web.window = web; + web.__faceclawEvenHub = { postMessage: (name, args, id) => session.handleBridgeCall(name, args, id) }; + let destroyed = false; + session.attachWebView({ evaluateJs: script => vm.runInContext(script, web), destroy: () => { destroyed = true; } }); + vm.runInContext(api.EVENHUB_BRIDGE_INJECT_SCRIPT, web); + const call = (method, data = {}) => web.flutter_inappwebview.callHandler('evenAppMessage', JSON.stringify({ method, data })); + return { session, call, web, logs, renders, destroyed: () => destroyed }; +} + +test('injected EvenHub RPC creates, updates and composites an image page with no Android globals', async () => { + const h = sessionHarness(); + assert.equal(await h.call('createStartUpPageContainer', { containerTotalNum: 1, + imageObject: [{ containerID: 1, containerName: 'board', xPosition: 0, yPosition: 0, width: 2, height: 2 }] }), 0); + assert.equal(await h.call('updateImageRawData', { containerID: 1, containerName: 'board', imageData: [0, 80, 160, 255] }), 0); + const painted = h.session.paint({ width: 576, height: 288 }, true); + assert.deepEqual([painted.pixels[0], painted.pixels[1], painted.pixels[576], painted.pixels[577]], [0, 80, 160, 255]); + assert.equal(await h.call('setLocalStorage', { key: 'score', value: '42' }), true); + assert.equal(await h.call('getLocalStorage', { key: 'score' }), '42'); + const events = []; + h.web._listenEvenAppMessage = value => events.push(typeof value === 'string' ? JSON.parse(value) : value); + h.session.handleGesture({ type: 'click', source: 'ring' }); + assert.ok(events.some(e => e.method === 'evenHubEvent')); + assert.equal(await h.call('audioControl', { isOpen: true }), false); + assert.equal(await h.call('imuControl', { isOpen: true }), false); + assert.equal(await h.call('getAppLocation'), null); + h.session.close(); await new Promise(resolve => setTimeout(resolve, 120)); assert.equal(h.destroyed(), true); +}); + +test('iOS webview adapter defers loading until handles attach and destroys a not-yet-loaded app', () => { + const timers = new Map(), calls = []; + const native = { startEntrypointScript: (...args) => calls.push(args), destroy: () => calls.push('destroy') }; + const load = loader({ FaceclawEvenHubWebView: { new: () => native }, + setTimeout: fn => { timers.set(1, fn); return 1; }, clearTimeout: id => timers.delete(id) }, { + './session': { EVENHUB_BRIDGE_INJECT_SCRIPT: 'BRIDGE', buildFaceclawExtensionsScript: () => 'EXT' }, '../../version': { FACECLAW_VERSION: 'test' }, + }); + const { createEvenHubWebView } = load('app/apps/evenhub/webview.ios.ts'); + const session = { manifest: { name: 'Probe', entrypoint: 'index.html' }, distDir: '/app/dist' }; + const host = createEvenHubWebView(session); assert.equal(calls.length, 0); + timers.get(1)(); assert.equal(calls[0][0], '/app/dist'); assert.match(calls[0][2], /postMessage/); assert.match(calls[0][2], /BRIDGEEXT$/); + host.destroy(); assert.equal(timers.size, 0); assert.equal(calls.at(-1), 'destroy'); + assert.throws(() => createEvenHubWebView({ ...session, remoteUrl: 'https://example.test' }), /local/); +}); diff --git a/tests/native/ios-evenhub-test.m b/tests/native/ios-evenhub-test.m new file mode 100644 index 00000000..83c3230e --- /dev/null +++ b/tests/native/ios-evenhub-test.m @@ -0,0 +1,57 @@ +#import +#import "FaceclawEvenHubWebView.h" + +@interface Probe : UIResponder +@property(nonatomic) UIWindow *window; +@property(nonatomic) FaceclawEvenHubWebView *host; +@property(nonatomic) NSMutableSet *seen; +@property(nonatomic) NSInteger phase; +@end +@implementation Probe +- (BOOL)application:(UIApplication *)app didFinishLaunchingWithOptions:(NSDictionary *)options { + self.window = [[UIWindow alloc] initWithFrame:UIScreen.mainScreen.bounds]; + self.window.rootViewController = [UIViewController new]; + self.window.rootViewController.view.backgroundColor = UIColor.whiteColor; + [self.window makeKeyAndVisible]; + self.seen = [NSMutableSet new]; self.host = [FaceclawEvenHubWebView new]; self.phase = 1; + NSString *package = NSUUID.UUID.UUIDString; + self.host.packageIdentifier = package; + __weak Probe *weakSelf = self; + self.host.eventHandler = ^(NSString *json) { + NSLog(@"EHPROBE %@", json); + NSDictionary *event = [NSJSONSerialization JSONObjectWithData:[json dataUsingEncoding:NSUTF8StringEncoding] options:0 error:nil]; + if ([event[@"kind"] isEqual:@"call"]) { + [weakSelf.seen addObject:event[@"name"]]; + [weakSelf.seen addObject:[NSString stringWithFormat:@"%ld:%@", (long)weakSelf.phase, event[@"name"]]]; + [weakSelf.host evaluate:[NSString stringWithFormat:@"window.__fcResolve(%@,true,true)", event[@"id"]]]; + } + }; + NSString *root = NSBundle.mainBundle.resourcePath; + NSString *script = [NSString stringWithContentsOfFile:[root stringByAppendingPathComponent:@"bridge.js"] encoding:NSUTF8StringEncoding error:nil]; + dispatch_async(dispatch_get_main_queue(), ^{ + [self.host start:[root stringByAppendingPathComponent:@"dist"] entrypoint:@"index.html" script:script]; + }); + for (NSInteger phase = 2; phase <= 3; phase++) { + dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (phase - 1) * 4 * NSEC_PER_SEC), dispatch_get_main_queue(), ^{ + void (^handler)(NSString *) = self.host.eventHandler; + [self.host showOnPhone]; [self.host hideOnPhone]; [self.host destroy]; + self.phase = phase; self.host = [FaceclawEvenHubWebView new]; + self.host.eventHandler = handler; + self.host.packageIdentifier = phase == 2 ? package : [package stringByAppendingString:@".other"]; + [self.host start:[root stringByAppendingPathComponent:@"dist"] entrypoint:@"index.html" script:script]; + }); + } + dispatch_after(dispatch_time(DISPATCH_TIME_NOW, 12 * NSEC_PER_SEC), dispatch_get_main_queue(), ^{ + NSArray *required = @[@"early", @"module", @"fetch", @"image", @"timer", @"raf", @"wasm", @"traversal", @"1:stored", @"2:restored", @"3:stored"]; + BOOL passed = [[NSSet setWithArray:required] isSubsetOfSet:self.seen]; + [self.host showOnPhone]; [self.host hideOnPhone]; [self.host destroy]; + NSDictionary *result = @{@"passed": @(passed), @"seen": self.seen.allObjects}; + NSData *data = [NSJSONSerialization dataWithJSONObject:result options:0 error:nil]; + NSString *documents = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).firstObject; + [data writeToFile:[documents stringByAppendingPathComponent:@"result.json"] atomically:YES]; + NSLog(@"EHPROBE RESULT %@", result); + }); + return YES; +} +@end +int main(int argc, char **argv) { @autoreleasepool { return UIApplicationMain(argc, argv, nil, NSStringFromClass(Probe.class)); } } diff --git a/tests/tsconfig.json b/tests/tsconfig.json index 068ece2a..655701c7 100644 --- a/tests/tsconfig.json +++ b/tests/tsconfig.json @@ -12,6 +12,7 @@ }, "include": [ "../app/g2/ble-protocol.ts", + "../app/graphics/lvgl-font.ts", "../app/phone-ui/ble-bandwidth-meter.ts", "../app/apps/terminal/hub-header.ts", "../app/g2/ios-peripheral-identity.ts", From 6b2e0375e65f43363c0d9b37f6e1cb47382b4bfd Mon Sep 17 00:00:00 2001 From: James Babcock Date: Thu, 17 Sep 2026 23:38:56 -0700 Subject: [PATCH 12/99] Document iOS LiveSync refresh and device protocol validation --- notes/ios-protocol-sync.md | 31 +++++++++++++++++++++++-------- 1 file changed, 23 insertions(+), 8 deletions(-) diff --git a/notes/ios-protocol-sync.md b/notes/ios-protocol-sync.md index 7aeb390c..ec419a95 100644 --- a/notes/ios-protocol-sync.md +++ b/notes/ios-protocol-sync.md @@ -31,10 +31,10 @@ and the shared SVG rasterizer. Validation: TypeScript checking and signed physical-device iOS build pass. The simulator build launches and renders the main screen and shared launcher. -The final signed app is installed on the development iPhone, but iOS rejects -automatic launch with a signing/entitlement/developer-trust error. Local code -signature verification passes; the current provisioning profile includes the -iPhone and expires September 25. On-phone trust/launch needs checking. +The final signed app is installed on the development iPhone. The user renewed +developer-certificate trust after iOS initially blocked launch. A subsequent +NativeScript deployment launched successfully, connected to the glasses, and +received both-lens ACKs for a display frame. The transport parity test compiles Android's production Java encoder and compares complete packets, including persistent history, reset, MTU limits, and raw fallback for incompressible maximum-size records. Session tests cover @@ -45,7 +45,22 @@ The full suite has 420 passing tests and 21 failures. All 21 reproduce on a clean archive of main at 1727474: compass, pinball/touch, and terminal test harness/behavior checks. There are no additional failing tests from this merge. -Hardware acceptance still requires current-firmware glasses: connect, scroll -and animate the display, check both lenses, exercise mic and ring input, lock -the phone, and disconnect/reconnect. Automated tests do not establish on-lens -or radio reliability. +Further hardware acceptance: scroll and animate the display, visually check +both lenses, exercise mic and ring input, lock the phone, and disconnect/reconnect. +The initial successful frame does not establish sustained radio reliability. + +## Development deployment and stale LiveSync code + +Installing the IPA with `devicectl` alone left an old September 8 JavaScript +bundle in `Library/Application Support/LiveSync/app` in the app's data container. +NativeScript debug startup used that bundle instead of the newly installed +one, causing the obsolete `img640, fbguard, wearnotify` firmware rejection. +Refreshing through NativeScript fixed the issue without clearing app settings: + +```sh +npm run run:ios -- --device 00008150-000C383921A3C01C --no-hmr --no-watch +``` + +Use this deployment path when updating an existing development installation. +The refreshed on-device `bundle.mjs` was copied back and verified against the +prepared bundle; it contains the shared revision-13 check and SID `0xf0`. From 14fbbe66ff3b8387b6aaea21ae830b077fe3e822 Mon Sep 17 00:00:00 2001 From: James Babcock Date: Thu, 17 Sep 2026 23:47:45 -0700 Subject: [PATCH 13/99] iOS porting: Glanceboard wake gestures --- app/g2/ble-protocol.ts | 6 +- app/g2/glance-host.ts | 10 +- app/g2/ios-preview-controller.ts | 62 +++++++++- tests/ios-app-host.test.cjs | 3 +- tests/ios-ble.test.cjs | 5 + tests/ios-glanceboard.test.cjs | 189 +++++++++++++++++++++++++++++++ 6 files changed, 263 insertions(+), 12 deletions(-) create mode 100644 tests/ios-glanceboard.test.cjs diff --git a/app/g2/ble-protocol.ts b/app/g2/ble-protocol.ts index 201ca280..9fd16184 100644 --- a/app/g2/ble-protocol.ts +++ b/app/g2/ble-protocol.ts @@ -1,4 +1,5 @@ /** G2 wire protocol, ported from g2protocol/BleProtocol.java. No platform APIs. */ +import { OsEventTypeList } from './events' export const G2_WRITE = '00002760-08c2-11e1-9073-0e8ac72e5401' export const G2_NOTIFY = '00002760-08c2-11e1-9073-0e8ac72e5402' export const G2_RENDER_NOTIFY = '00002760-08c2-11e1-9073-0e8ac72e6402' @@ -125,13 +126,14 @@ export function readString(data: Uint8Array, number: number): string { return Ar export function authenticationSucceeded(message: ProtocolMessage, magic: number): boolean { return message.sid === SID.auth && message.command === 4 && message.magic === magic && readBytes(message.payload, 3)?.length === 0 } -export type GlassesInput = { kind: 'sys-event' | 'list-click' | 'text-click'; eventType: number; eventSource: number; systemExitReasonCode: number; containerName: string; frameId: number } +export type GlassesInput = { kind: 'sys-event' | 'list-click' | 'text-click' | 'display-wake'; eventType: number; eventSource: number; systemExitReasonCode: number; containerName: string; frameId: number } export function decodeGlassesInput(message: ProtocolMessage): GlassesInput | null { if (message.sid !== SID.hub || ![1, 6].includes(message.flag)) return null const events = readBytes(message.payload, 13); if (!events) return null for (const [field, kind, typeField] of [[1, 'list-click', 5], [2, 'text-click', 3], [3, 'sys-event', 1]] as const) { const event = readBytes(events, field) - if (event) return { kind, eventType: readInteger(event, typeField), eventSource: field === 3 ? readInteger(event, 2) : 0, + if (event) return { kind: kind === 'sys-event' && readInteger(event, typeField) === OsEventTypeList.HEAD_UP_EVENT ? 'display-wake' : kind, + eventType: readInteger(event, typeField), eventSource: field === 3 ? readInteger(event, 2) : 0, systemExitReasonCode: field === 3 ? readInteger(event, 4) : 0, containerName: field === 3 ? '' : readString(event, 2), frameId: 0 } } return null diff --git a/app/g2/glance-host.ts b/app/g2/glance-host.ts index d58781c7..002fc147 100644 --- a/app/g2/glance-host.ts +++ b/app/g2/glance-host.ts @@ -21,8 +21,12 @@ export const GLANCE_SURFACE_ID = "glance"; /** Above the shell (1) and every window (0); below the lock screen (1000). */ export const GLANCE_SURFACE_Z_ORDER = 900; +/** Surface operations needed by the board, shared by Android and iOS. */ +export type GlanceDisplay = Pick; + export type GlanceHostOptions = { - getDisplay: () => DisplayTarget | null; + getDisplay: () => GlanceDisplay | null; getProvider: () => GlanceboardProvider | null; /** Whether a board may show right now (connected or preview, not locked). */ canShow: () => boolean; @@ -47,7 +51,7 @@ export class GlanceHost { /** Whether the surface is currently visible on the compositor. */ private shown = false; private hideTimer: ReturnType | null = null; - private configuredFor: DisplayTarget | null = null; + private configuredFor: GlanceDisplay | null = null; /** Serializes show/hide against each other and against in-flight renders. */ private queue: Promise = Promise.resolve(); private rendering = false; @@ -144,7 +148,7 @@ export class GlanceHost { }, Math.max(0, hideAtMs - Date.now())); } - private async configureSurface(display: DisplayTarget): Promise { + private async configureSurface(display: GlanceDisplay): Promise { await display.configureSurface(GLANCE_SURFACE_ID, { x: 0, y: 0, diff --git a/app/g2/ios-preview-controller.ts b/app/g2/ios-preview-controller.ts index 21cdbf31..37106104 100644 --- a/app/g2/ios-preview-controller.ts +++ b/app/g2/ios-preview-controller.ts @@ -2,6 +2,8 @@ import { Dialogs, File, knownFolders, path, type ImageSource } from '@nativescri import { iosBluetooth } from '../native/ios-bluetooth' import { iosVoiceInput } from '../native/ios-voice-input' import { GlassesSession, type SessionState } from './glasses-session' +import { GlanceHost, type GlanceDisplay } from './glance-host' +import { OsEventTypeList } from './events' import { loadDeviceAddresses } from './device-addresses' import { deviceAddressError } from './ios-peripheral-identity' import { createLauncherWindow, LAUNCHER_SURFACE_ID } from '../apps/launcher/launcher-app' @@ -16,7 +18,7 @@ import { SurfaceCompositor } from '../graphics/surface-compositor' import { flattenPlanes, type Plane } from '../graphics/plane' import { G2_LENS_WIDTH, G2_LENS_HEIGHT } from '../graphics/image' import { previewPixels } from '../native/ios-graphics' -import { makeInputEvent, type InputEventPayload } from '../ui/gestures' +import { makeInputEvent, type InputEvent, type InputEventPayload } from '../ui/gestures' import { noopLayerActions, type LayerActions } from '../ui/layers' import { TextViewerLayer } from '../apps/files/text-viewer' import { shell, rawInputEventToInputEvent, type ShellWindow } from '../ui/shell/shell' @@ -28,6 +30,36 @@ import type { PhoneGesture } from '../phone-ui/phone-gestures' /** iOS host for the shared app registry, shell, compositor and BLE session. */ export class IosPreviewController { private readonly compositor = new SurfaceCompositor(G2_LENS_WIDTH, G2_LENS_HEIGHT) + private readonly glanceDisplay: GlanceDisplay = { + configureSurface: async (id, options) => { + this.compositor.configureSurface(id, options) + }, + setSurfaceVisible: async (id, visible) => { + this.compositor.setSurfaceVisible(id, visible); this.scheduleFrame() + }, + setScreenBlanked: async blanked => { + this.compositor.setScreenBlanked(blanked); this.scheduleFrame() + }, + submitSurfaceFrame: async (id, pixels, rect) => { + this.compositor.submitSurfaceFrame(id, pixels, rect); this.scheduleFrame() + }, + } + private readonly glance = new GlanceHost({ + getDisplay: () => this.glanceDisplay, + getProvider: () => ALL_APPS.find(app => app.glanceboard)?.glanceboard ?? null, + canShow: () => this.runtimeNeeded, + // iOS retains the EvenHub session while the shell sleeps. The board's + // opaque first frame is ready before we unblank the compositor. + ensureSessionActive: async () => { + this.compositor.setScreenBlanked(false); this.scheduleFrame(); return true + }, + onHiddenWhileAsleep: () => { + if (!shell.isScreenOn()) this.compositor.setScreenBlanked(true) + this.scheduleFrame() + }, + onVisibilityChanged: () => this.scheduleFrame(), + appendLog: message => this.logBluetooth(message), + }) private renderTimer: ReturnType | null = null private clockTimer: ReturnType | null = null private offSettings: (() => void) | null = null @@ -69,7 +101,10 @@ export class IosPreviewController { getScreenTimeoutMs: () => null, requestShellRender: () => this.requestShellRender(), onWindowsChanged: () => this.requestShellRender(), - onScreenStateChanged: on => { this.compositor.setScreenBlanked(!on); this.requestShellRender() }, + onScreenStateChanged: on => { + if (on) this.glance.dismiss() + this.compositor.setScreenBlanked(!on); this.requestShellRender() + }, }) const launcher = createLauncherWindow({ actions: this.actions, @@ -117,6 +152,8 @@ export class IosPreviewController { this.runtimeRunning = running for (const window of shell.getWindows()) window.setScreenOn?.(running && shell.isScreenOn()) if (!running) { + this.glance.dismiss() + this.compositor.setScreenBlanked(!shell.isScreenOn()) this.offSettings?.(); this.offSettings = null for (const observer of this.batteryObservers.splice(0)) NSNotificationCenter.defaultCenter.removeObserver(observer) UIDevice.currentDevice.batteryMonitoringEnabled = false @@ -180,7 +217,8 @@ export class IosPreviewController { this.session?.setFrame(pixels) if (this.active) { const image = previewPixels(pixels, 640, 480, previewColorSetting.get() === 'green') - this.onFrame(image, `${shell.foregroundWindow()?.title ?? 'Apps'} · ${shell.getFocus() === 'sidebar' ? 'App switcher' : 'App'}`) + this.onFrame(image, this.glance.isVisible() ? 'Glanceboard' + : `${shell.foregroundWindow()?.title ?? 'Apps'} · ${shell.getFocus() === 'sidebar' ? 'App switcher' : 'App'}`) } } catch (error) { this.fail(error) } }, 33) @@ -203,12 +241,23 @@ export class IosPreviewController { type = type === 'swipe-up' ? 'scroll-up' : 'scroll-down' } const event = makeInputEvent({ type, source: origin === 'ring' ? 'ring' : 'watch' } as InputEventPayload) - await shell.receiveInput(event) - this.requestShellRender() + await this.receiveInput(event) } console.log(`[ios-preview] ${origin} ${gesture}: ${shell.describeInputTarget()}`) }).catch(error => this.fail(error)) } + private async receiveInput(event: InputEvent, headTilt = false): Promise { + if (!shell.isScreenOn()) { + const glanceEvent = this.glance.eventForGesture(headTilt ? 'head-tilt' : event.type) + if (glanceEvent?.type === 'dismiss') this.glance.dismiss() + else if (glanceEvent) { + await this.glance.handleEvent(glanceEvent, 0) + return + } + } + await shell.receiveInput(event) + this.requestShellRender() + } private async mirrorTap(nx: number, ny: number): Promise { const x = Math.max(0, Math.min(639, Math.floor(nx * 640))) const y = Math.max(0, Math.min(479, Math.floor(ny * 480))) @@ -317,7 +366,8 @@ export class IosPreviewController { }, input => { this.inputQueue = this.inputQueue.then(async () => { if (this.session?.state.phase !== 'connected') return - await shell.receiveInput(rawInputEventToInputEvent(input)); this.requestShellRender() + await this.receiveInput(rawInputEventToInputEvent(input), + input.kind === 'display-wake' && input.eventType === OsEventTypeList.HEAD_UP_EVENT) this.logBluetooth(`Input ${input.eventType} source ${input.eventSource}`) }).catch(error => this.fail(error)) }, message => this.logBluetooth(message), () => this.refreshClock()) diff --git a/tests/ios-app-host.test.cjs b/tests/ios-app-host.test.cjs index 8c1b3586..5a180c9b 100644 --- a/tests/ios-app-host.test.cjs +++ b/tests/ios-app-host.test.cjs @@ -92,12 +92,13 @@ test('background glasses input still composites frames; phone resume preserves t '@nativescript/core': { File: { fromPath: () => ({ writeTextSync() {} }) }, knownFolders: { documents: () => ({ path: '/tmp' }) }, path }, '../native/ios-voice-input': { iosVoiceInput: { handleSessionEnded() {} } }, '../native/ios-bluetooth': { iosBluetooth: () => ({}) }, './glasses-session': { GlassesSession: Session }, + './glance-host': { GlanceHost: class { dismiss() {} isVisible() { return false; } } }, './device-addresses': { loadDeviceAddresses: () => ({}) }, './ios-peripheral-identity': { deviceAddressError: () => null }, '../apps/launcher/launcher-app': { createLauncherWindow: () => window, LAUNCHER_SURFACE_ID: 'launcher' }, '../apps/all-apps': { ALL_APPS: [] }, '../ui/dashboard-settings': settings, '../native/phone-battery': { readPhoneBatteryState: () => ({ battery: 80, charging: false }) }, '../graphics/surface-compositor': { SurfaceCompositor: class { - configureSurface() {} setSurfaceVisible() {} submitSurfaceFrame() {} setUnderlayDim() {} + configureSurface() {} setSurfaceVisible() {} submitSurfaceFrame() {} setUnderlayDim() {} setScreenBlanked() {} composite() { return new Uint8Array([1, 2]); } } }, '../graphics/plane': { flattenPlanes: () => ({ pixels: new Uint8Array([1, 2]), width: 2, height: 1 }) }, diff --git a/tests/ios-ble.test.cjs b/tests/ios-ble.test.cjs index 4e6a12e2..55694b12 100644 --- a/tests/ios-ble.test.cjs +++ b/tests/ios-ble.test.cjs @@ -87,6 +87,11 @@ test('ring and arm input decoders preserve gesture and source', () => { const payload = p.bytes(13, p.bytes(3, p.concat(p.integer(1, 9), p.integer(2, 3)))); assert.equal(p.decodeGlassesInput({ sid: 224, flag: 1, payload }).eventSource, 3); assert.equal(p.decodeGlassesInput({ sid: 224, flag: 32, payload }), null); + const headUp = p.bytes(13, p.bytes(3, p.concat(p.integer(1, 12), p.integer(2, 1)))); + const wake = p.decodeGlassesInput({ sid: 224, flag: 1, payload: headUp }); + assert.equal(wake.kind, 'display-wake'); + assert.equal(wake.eventType, 12); + assert.equal(wake.eventSource, 1); }); class FakeTransport { diff --git a/tests/ios-glanceboard.test.cjs b/tests/ios-glanceboard.test.cjs new file mode 100644 index 00000000..51a03554 --- /dev/null +++ b/tests/ios-glanceboard.test.cjs @@ -0,0 +1,189 @@ +const test = require('node:test'); +const assert = require('node:assert/strict'); +const fs = require('node:fs'); +const path = require('node:path'); +const vm = require('node:vm'); +const ts = require('typescript'); +const images = require('../.test-build/app/graphics/image.js'); +const { SurfaceCompositor } = require('../.test-build/app/graphics/surface-compositor.js'); +const protocol = require('../.test-build/app/g2/ble-protocol.js'); +const events = require('../.test-build/app/g2/events.js'); + +function load(file, modules, globals = {}) { + const context = { exports: {}, require: id => { + if (!(id in modules)) throw new Error(`Unstubbed import: ${id}`); + return modules[id]; + }, ...globals }; + vm.runInNewContext(ts.transpileModule(fs.readFileSync(path.join(__dirname, '..', file), 'utf8'), { + compilerOptions: { module: ts.ModuleKind.CommonJS, target: ts.ScriptTarget.ES2020 }, + }).outputText, context); + return context.exports; +} +const planes = load('app/graphics/plane.ts', { './image': images }); +const timings = load('app/native/frame-timings.ts', {}); + +function fixture() { + let now = 1000, nextTask = 0, screenOn = true, shellOptions, session; + const tasks = new Map(), sent = [], previews = [], received = [], errors = []; + const boardStats = { starts: 0, stops: 0, paints: 0 }; + const settings = { enabled: true, tap: true, hold: true, tilt: true, duration: 3000 }; + const clock = { Date: class extends Date { static now() { return now; } }, + setTimeout: (fn, ms) => { tasks.set(++nextTask, { fn, at: now + ms }); return nextTask; }, + clearTimeout: id => tasks.delete(id), setInterval: () => ++nextTask, clearInterval() {} }; + const { GlanceHost } = load('app/g2/glance-host.ts', { + '../graphics/image': images, '../graphics/plane': planes, + '../graphics/glyph-wire': { prepareFrameDraws: () => null }, '../native/frame-timings': timings, + '../ui/shell/geometry': { minWindowTop: () => 48 }, + '../util/render-freshness': { beginRenderPass() {}, endRenderPass: () => false }, + './glance-state': require('../.test-build/app/g2/glance-state.js'), + }, clock); + const window = { windowId: 'launcher', surfaceId: 'launcher', appId: 'launcher', title: 'Apps', + requestRender() {}, setScreenOn() {} }; + const shell = { + configure: options => { shellOptions = options; }, registerWindow() {}, focusWindow() {}, + wake: () => { screenOn = true; shellOptions.onScreenStateChanged(true); }, + sleep: () => { screenOn = false; shellOptions.onScreenStateChanged(false); }, + isScreenOn: () => screenOn, getWindows: () => [window], foregroundWindow: () => window, + setBatteryLevels() {}, underlayDim: () => 1, getFocus: () => 'app', hasOverlay: () => false, + describeInputTarget: () => 'test app', + paintSurface: () => [{ image: new images.GrayImage(640, 480, 0), x: 0, y: 0 }], + receiveInput: async input => { + received.push(input); + if (input.type === 'display-wake' || !screenOn && input.type === 'double-click') shell.wake(); + }, + }; + class Session { + state = { phase: 'disconnected' }; + constructor(_transport, onState, onInput) { session = this; this.onState = onState; this.onInput = onInput; } + async start() { this.state = { phase: 'connected' }; this.onState(this.state); } + async stop() { this.state = { phase: 'disconnected' }; this.onState(this.state); } + setFrame(pixels) { if (this.state.phase === 'connected') sent.push(pixels); } + wake() {} + } + const provider = { + isEnabled: () => settings.enabled, showOnTap: () => settings.tap, + showOnLongPress: () => settings.hold, showOnHeadTilt: () => settings.tilt, + tapTimeoutMs: () => settings.duration, + createBoard: () => ({ start: () => boardStats.starts++, stop: () => boardStats.stops++, + paint: () => { boardStats.paints++; return new images.GrayImage(100, 80, 200); } }), + }; + const modules = { + '@nativescript/core': { File: { fromPath: () => ({ writeTextSync() {} }) }, + knownFolders: { documents: () => ({ path: '/tmp' }) }, path }, + '../native/ios-bluetooth': { iosBluetooth: () => ({}) }, + '../native/ios-voice-input': { iosVoiceInput: { handleSessionEnded() {} } }, + './glasses-session': { GlassesSession: Session }, './glance-host': { GlanceHost }, './events': events, + './device-addresses': { loadDeviceAddresses: () => ({}) }, './ios-peripheral-identity': { deviceAddressError: () => null }, + '../apps/launcher/launcher-app': { createLauncherWindow: () => window, LAUNCHER_SURFACE_ID: 'launcher' }, + '../apps/all-apps': { ALL_APPS: [{ appId: 'glanceboard', glanceboard: provider }] }, + '../ui/shell/worker-window': {}, '../ui/shell/in-process-window': {}, + '../ui/dashboard-settings': { onAnySettingChanged: () => () => {}, previewColorSetting: { get: () => 'white' } }, + '../native/phone-battery': { readPhoneBatteryState: () => ({ battery: 80, charging: false }) }, + '../apps/ios-availability': { iosAppUnavailableReason: () => null }, + '../graphics/surface-compositor': { SurfaceCompositor }, '../graphics/plane': planes, '../graphics/image': images, + '../native/ios-graphics': { previewPixels: pixels => pixels }, + '../ui/gestures': { makeInputEvent: event => event }, '../ui/layers': { noopLayerActions: {} }, + '../apps/files/text-viewer': {}, + '../ui/shell/shell': { shell, rawInputEventToInputEvent: event => ({ + type: event.kind === 'display-wake' ? 'display-wake' + : ({ 0: 'click', 1: 'scroll-up', 2: 'scroll-down', 3: 'double-click', 9: 'long-press', + 10: 'long-press-release', 11: 'short-then-long-press' })[event.eventType] ?? 'unknown', source: 'ring', + }) }, + '../ui/shell/geometry': { appViewportRect: () => ({ x: 0, y: 0, width: 640, height: 480 }) }, + }; + const { IosPreviewController } = load('app/g2/ios-preview-controller.ts', modules, { + ...clock, console: { log() {}, warn() {}, error: text => errors.push(text) }, + UIDevice: { currentDevice: {} }, UIApplication: { sharedApplication: { protectedDataAvailable: true } }, + UIDeviceBatteryLevelDidChangeNotification: 'level', UIDeviceBatteryStateDidChangeNotification: 'state', + NSNotificationCenter: { defaultCenter: { addObserverForNameObjectQueueUsingBlock() {}, removeObserver() {} } }, + NSOperationQueue: { mainQueue: {} }, + }); + const controller = new IosPreviewController((pixels, title) => previews.push({ pixels, title }), message => errors.push(message)); + controller.compositor.submitSurfaceFrame('launcher', new Uint8Array(640 * 480).fill(75), { x: 0, y: 0, width: 640, height: 480 }); + controller.resume(); + async function drain() { await controller.inputQueue; await controller.glance.queue; } + async function advance(ms) { + now += ms; + for (const [id, task] of [...tasks]) if (task.at <= now && tasks.delete(id)) task.fn(); + await drain(); + } + async function render() { await drain(); await advance(33); assert.deepEqual(errors, []); } + async function hardware(type, source = 2) { + const payload = protocol.bytes(13, protocol.bytes(3, protocol.concat(protocol.integer(1, type), protocol.integer(2, source)))); + session.onInput(protocol.decodeGlassesInput({ sid: protocol.SID.hub, flag: 1, payload })); + await render(); + } + async function phone(type, origin = 'ring') { controller.gesture(type, origin); await render(); } + return { controller, shell, settings, sent, previews, received, boardStats, hardware, phone, advance, render }; +} +const assertBlank = pixels => assert.ok(pixels.every(p => p === 0)); +const assertBoard = pixels => { + assert.equal(pixels[48 * 640 + 270], 200); + assert.equal(pixels[0], 0, 'opaque Glanceboard hides the retained app and shell'); +}; + +test('iOS sleep tap shows the shared board; repeated tap renews timeout and hides to black', async () => { + const f = fixture(); await f.controller.connect(); f.shell.sleep(); await f.render(); + assertBlank(f.sent.at(-1)); + await f.hardware(0); assertBoard(f.sent.at(-1)); assert.equal(f.shell.isScreenOn(), false); + assert.equal(f.previews.at(-1).title, 'Glanceboard'); assert.equal(f.received.length, 0); + await f.advance(2000); await f.hardware(0); await f.advance(1100); + assert.equal(f.controller.glance.isVisible(), true); + const offset = f.sent.length; + await f.advance(2000); await f.render(); + assert.equal(f.controller.glance.isVisible(), false); + for (const pixels of f.sent.slice(offset)) assertBlank(pixels); + assert.equal(f.boardStats.starts, 1); assert.equal(f.boardStats.stops, 1); +}); + +test('iOS holds and tap-then-holds last until release, including with phone backgrounded', async () => { + const f = fixture(); await f.controller.connect(); f.shell.sleep(); f.controller.pause(); + const previews = f.previews.length; + for (const type of [9, 11]) { + await f.hardware(type, 1); assertBoard(f.sent.at(-1)); + await f.advance(10000); assert.equal(f.controller.glance.isVisible(), true); + await f.hardware(10, 1); assertBlank(f.sent.at(-1)); + } + assert.equal(f.previews.length, previews); assert.equal(f.received.length, 0); +}); + +test('double-tap and other shell wakes replace Glanceboard without waking it again', async () => { + const f = fixture(); await f.controller.connect(); f.shell.sleep(); + await f.hardware(9); await f.hardware(3); + assert.equal(f.shell.isScreenOn(), true); assert.equal(f.controller.glance.isVisible(), false); + assert.equal(f.sent.at(-1)[0], 75); assert.equal(f.boardStats.stops, 1); + f.shell.sleep(); await f.hardware(0); f.shell.wake(); await f.render(); + assert.equal(f.controller.glance.isVisible(), false); assert.equal(f.sent.at(-1)[0], 75); + await f.advance(5000); await f.render(); assert.equal(f.sent.at(-1)[0], 75); +}); + +test('head tilt uses Glanceboard when enabled and otherwise wakes the regular UI', async () => { + const f = fixture(); await f.controller.connect(); f.shell.sleep(); + await f.hardware(12, 1); assertBoard(f.sent.at(-1)); assert.equal(f.shell.isScreenOn(), false); + await f.hardware(3); f.shell.sleep(); f.settings.tilt = false; + await f.hardware(12, 1); assert.equal(f.shell.isScreenOn(), true); assert.equal(f.sent.at(-1)[0], 75); +}); + +test('disabled triggers and scrolls do not show the board; awake taps still reach the shell', async () => { + const f = fixture(); await f.controller.connect(); + await f.hardware(0); assert.equal(f.received.at(-1).type, 'click'); assert.equal(f.boardStats.starts, 0); + f.shell.sleep(); f.settings.tap = false; f.settings.hold = false; + for (const type of [0, 9, 11, 10, 1, 2]) await f.hardware(type); + assert.equal(f.boardStats.starts, 0); assertBlank(f.sent.at(-1)); + f.settings.enabled = false; f.settings.tap = f.settings.hold = true; + for (const type of [0, 9, 11]) await f.hardware(type); + assert.equal(f.boardStats.starts, 0); + await f.hardware(3); assert.equal(f.shell.isScreenOn(), true); +}); + +test('phone preview gestures use Glanceboard; losing runtime cleans up holds and timers', async () => { + const f = fixture(); f.shell.sleep(); + await f.phone('tap', 'mirror'); assertBoard(f.previews.at(-1).pixels); + await f.phone('double-tap', 'mirror'); assert.equal(f.shell.isScreenOn(), true); + f.shell.sleep(); await f.phone('long-press', 'ring'); + await f.phone('long-press-release', 'ring'); assertBlank(f.previews.at(-1).pixels); + await f.phone('short-then-long-press', 'ring'); assert.equal(f.controller.glance.isVisible(), true); + f.controller.pause(); await f.render(); assert.equal(f.controller.glance.isVisible(), false); + f.controller.resume(); await f.render(); assertBlank(f.previews.at(-1).pixels); + assert.equal(f.boardStats.starts, f.boardStats.stops); +}); From fc50c7314c7f064b08db5102185f9b752e1df632 Mon Sep 17 00:00:00 2001 From: James Babcock Date: Fri, 18 Sep 2026 11:30:27 -0700 Subject: [PATCH 14/99] Don't discard calibration when compass is off --- app/g2/firmware/cfw-patches.ts | 50 +++++++++++++++++++--------------- 1 file changed, 28 insertions(+), 22 deletions(-) diff --git a/app/g2/firmware/cfw-patches.ts b/app/g2/firmware/cfw-patches.ts index 445e4551..a95d9c72 100644 --- a/app/g2/firmware/cfw-patches.ts +++ b/app/g2/firmware/cfw-patches.ts @@ -19,7 +19,7 @@ export type FirmwarePatchSet = { export const CFW_PATCH_SET: FirmwarePatchSet = { "base": "g2_2.2.9.22.bin", "baseSha256": "a03fbea9f68a9de6bc271daabb9f3a41c59053d1086622c76a4e990f829cc561", - "outputSha256": "32cea69474252a2b2f9c0fdc5f89bf0d5d6f745b4eec10aea8e9c34e3f106b3f", + "outputSha256": "2d72b37a6e3ac4e3e493bbc12d48566f2bf52eb62d2707c11c8da11aaaf0bb14", "patches": [ { "offset": 935280, @@ -72,61 +72,61 @@ export const CFW_PATCH_SET: FirmwarePatchSet = { { "offset": 1242342, "old": "d4f790fb", - "new": "1af33cfc", + "new": "1af362fc", "desc": "bl settings_send_wrapper (append caps field 100)" }, { "offset": 1240038, "old": "f5f710f9", - "new": "1af3dafd", + "new": "1af300fe", "desc": "bl settings_decode_wrapper (Faceclaw lease field 101)" }, { "offset": 939336, "old": "0bf02af9", - "new": "64f351f8", + "new": "64f377f8", "desc": "bl faceclaw_display_start @ 0x45f146 (fail-open wake takeover)" }, { "offset": 939528, "old": "0bf0caf8", - "new": "64f3bff8", + "new": "64f3e5f8", "desc": "bl faceclaw_display_start_headup @ 0x45f206 (fail-open wake takeover)" }, { "offset": 939016, "old": "10f096f8", - "new": "65f397fd", + "new": "65f3bdfd", "desc": "bl headup_gate (head-up sensor event -> EvenHub sys event 12 under lease)" }, { "offset": 939036, "old": "fff765fb", - "new": "63f3ddff", + "new": "64f303f8", "desc": "bl faceclaw_idle_input_gate (idle tap/long/release -> field-102 events 2/3/4)" }, { "offset": 831036, "old": "1df057fc", - "new": "7ff373ff", + "new": "7ff399ff", "desc": "bl gesture_press (Faceclaw lease gates event 9 vs stock UI event 8)" }, { "offset": 831042, "old": "24f023f9", - "new": "80f314f8", + "new": "80f33af8", "desc": "bl gesture_short_long (Faceclaw lease gates event 11 vs stock Menu path)" }, { "offset": 831800, "old": "1df0d9fa", - "new": "7ff3f9fd", + "new": "7ff31ffe", "desc": "bl gesture_release (source-qualified event 10 vs stock UI event 0x4a)" }, { "offset": 1553752, "old": "7fb50600", - "new": "cef2f1bb", + "new": "cef217bc", "desc": "even_ai_display_ctrl entry -> conditional Faceclaw lease trampoline" }, { @@ -144,67 +144,73 @@ export const CFW_PATCH_SET: FirmwarePatchSet = { { "offset": 1255404, "old": "d9f758ff", - "new": "16f3f9fd", + "new": "16f31ffe", "desc": "bl faceclaw_send_wear_event @ 0x4ac3ea (outside onboarding)" }, { "offset": 1255504, "old": "d9f726ff", - "new": "16f3c7fd", + "new": "16f3edfd", "desc": "bl faceclaw_send_wear_event @ 0x4ac44e (outside onboarding)" }, { "offset": 1297700, "old": "65f0affd", - "new": "0cf351f8", + "new": "0cf377f8", "desc": "bl compass_decode_capture (sample-matched GAF diagnostics)" }, { "offset": 1296176, "old": "fff759fc", - "new": "0cf3c7fb", + "new": "0cf3edfb", "desc": "bl compass_report_event (stock UI + heading with diagnostics over BLE)" }, + { + "offset": 1290360, + "old": "00210170", + "new": "0df3a7fe", + "desc": "bl compass_preserve_accuracy (retain magnetic calibration under Faceclaw framebuffer lease)" + }, { "offset": 4476518, "old": "", - "new": "b0b581ea00039b0701d0034637e0c2b110f0030315d000f1010ca2f1010e0023cc5c9e45c45403f1010404d0634413f003032346f4d121440319121b102a14d302e00346102a10d3d1f800c0d1f804e0cc688d68103adc609d60c3f804e043f810cb0f2a01f11001eed8042a07d300bf51f8045b043a032a43f8045bf8d8002a08bfb0bd0139013b11f8015f013a03f8015ff9d1b0bd00bf884218bf002a00d1704710b50b1a38bf431a934207d288420ad281ea00039b0726d0034669e0fff79fffbde81040704781ea000300eb020c9b0701eb020e42d15fea8c732bd0a0f1010c00bf8b1813f801ec8418531e04f801ec04d0624412f003021a46f2d101eb030e00eb030c17e0830736d0a2f1010c00f1010e002300bfcc5c9c45c45403f1010404d0734413f003032346f4d1121b2144031922e01346042b0ed3aef10402acf1040152f80449043b032b41f80449f8d802f1040e01f1040c1a4653b1aef10101acf1010300bf11f80149013a03f80149f9d1bde8104070470346042a06d351f8044b043a032a43f8044bf8d8002af0d00139013b00bf11f8014f013a03f8014ff9d1e6e700bf2de9f04fa5b04ef66c6b4ff2a84416460d46ccf2ff0bc2f229044ff6ff7900274ff00108019006e048f2c731c0f24501bff32f8f8847d4f800a0bff35f8f20680321cff680710140b1f1005fbff35f8f03d10168594500f0bb804ff4377005f039f8002800f0a1824ff62451cff6ff7142183d3182f8dc7282f8dd7282f8de7282f8df7282f8e07282f8e17282f8e27282f8e37282f8e47282f8e57282f8e67282f8e77282f8e87282f8e97282f8ea7282f8eb7282f8ec7282f8ed7282f8ee7282f8ef7282f8f07282f8f17282f8f27282f8f37282f8f47282f8f57282f8f67282f8f77282f8f87282f8f97282f8fa7282f8fb7282f8fc7282f8fd7282f8fe7282f8ff7282f8007382f8017382f8027382f8037382f8047382f8057382f8067382f8077382f8087382f8097382f80a7382f80b7382f80c7382f80d7382f80e7382f80f7382f8107382f8117382f8127382f8137382f8147382f8157382f8167382f8177382f8187382d1c0f800b080f80a80a0f81c90a0f81e90a0f82090a0f82290a0f82490a0f82690a0f82890a0f82a90a0f82c90a0f82e90a0f83090a0f83290a0f83490a0f83690a0f83890a0f83a9054e8001f51457ff436afbff35f8f44e8000121b154e8001f5145f8d02be7aa4645ea064100260127c0f8701206e048f2c731c0f24501bff32f8f88472568bff35f8f20680321cff680710140b1f1005fbff35f8f03d10168594500f0bc804ff4377004f05eff002800f0c6814ff62451cff6ff7100bf42183d3182f8dc6282f8dd6282f8de6282f8df6282f8e06282f8e16282f8e26282f8e36282f8e46282f8e56282f8e66282f8e76282f8e86282f8e96282f8ea6282f8eb6282f8ec6282f8ed6282f8ee6282f8ef6282f8f06282f8f16282f8f26282f8f36282f8f46282f8f56282f8f66282f8f76282f8f86282f8f96282f8fa6282f8fb6282f8fc6282f8fd6282f8fe6282f8ff6282f8006382f8016382f8026382f8036382f8046382f8056382f8066382f8076382f8086382f8096382f80a6382f80b6382f80c6382f80d6382f80e6382f80f6382f8106382f8116382f8126382f8136382f8146382f8156382f8166382f8176382f8186382d1c0f800b08772a0f81c90a0f81e90a0f82090a0f82290a0f82490a0f82690a0f82890a0f82a90a0f82c90a0f82e90a0f83090a0f83290a0f83490a0f83690a0f83890a0f83a9054e8001fa9427ff437afbff35f8f00bf44e8000121b154e8001fa942f8d02be7d0f8746242f6f767c0f24407002ebff35f8f00f0eb8007f19a0230464ff0ff314ff0ff379047002840f0418143f67750c0f24f00804700274ff001080397adf8107006e048f2c731c0f24501bff32f8f88472568bff35f8f20680321cff680710140b1f1005fbff35f8f03d10168594500f0e1804ff4377004f068fe002800f0d9804ff62451cff6ff7100bf42183d3182f8dc7282f8dd7282f8de7282f8df7282f8e07282f8e17282f8e27282f8e37282f8e47282f8e57282f8e67282f8e77282f8e87282f8e97282f8ea7282f8eb7282f8ec7282f8ed7282f8ee7282f8ef7282f8f07282f8f17282f8f27282f8f37282f8f47282f8f57282f8f67282f8f77282f8f87282f8f97282f8fa7282f8fb7282f8fc7282f8fd7282f8fe7282f8ff7282f8007382f8017382f8027382f8037382f8047382f8057382f8067382f8077382f8087382f8097382f80a7382f80b7382f80c7382f80d7382f80e7382f80f7382f8107382f8117382f8127382f8137382f8147382f8157382f8167382f8177382f8187382d1c0f800b080f80a80a0f81c90a0f81e90a0f82090a0f82290a0f82490a0f82690a0f82890a0f82a90a0f82c90a0f82e90a0f83090a0f83290a0f83490a0f83690a0f83890a0f83a9054e8001fa9427ff436afbff35f8f44e8000149b354e8001fa942f8d02be705460020b847b0b105f51d7151e8006f4eb9bff35f8f00bf41e8000292b151e8006f002ef8d00021bff32f8fbff35f8f21b10646f9e64ff0ff3742e007f5a9718847f2e60121f1e70020019d42f6f764002d4ff0010bc0f2440418bfbaf1000f33d10df108098046484602f07df903ab28465146012205f0abfc9df8111007464846002918bf4ff0ff3702f0a3fabbf1000f044608d19df8100028b949f28340c0f247004c308047b8f1000f18bfc8f80c4042f6f764c0f2440404f5807130468847384625b0bde8f08f2a7802f07f01a1f1150313f1030f0bd802f07b030b2b07d002f07e02082a03d0032901d00629b7d140b149f28341c0f247010746884797f8641111b14ff0ff37d6e738464ff0000ba6e770b500284dd001684ef66c62ccf2ff02914218bf70bd90f8441090f8455046f6756c8d42c0f2510c2ad205eb8501014491f8492091f84a4091f846e091f8473091f8481042ea0424012c4ff0010298bf14466e1c054680f84560b9b164294eea032028bf6421012888bf024644f62060824228bf02460cf5e2731046984706e0002180f84410bde870406047e047286c38b142f64d42c0f244022146bde87040104770bd02464ff64b70cff6ff7042f6653c7844c0f2440c00210023604700bf2de9f04f9fb04ff2a840c2f229000668bff35f8f30466ff39600b0f1005f42d130684ef66c65ccf2ff05a8423bd196f8640130b3d6f860411cb340f6b400c2f20000076804a802f0a5f8002f00f06a8140f2030a384621464ff416320296cff6807a4ff6ff760397fff752fb4ff6245b48f2c738cff6ff7b00270124c0f245081ce096f8660170b1d6f8680140b146f68051c2f207010968401a002802f37080002086f8660140f6d100c0f247001fb0bde8f04f0047bff32f8fc0474ff2a840c2f22900d0f80090bff35f8f0068bff35f8f00ea0a01b1f1005f03d10168a94200f0aa804ff4377004f050fc002802f02f80594642183d3182f8dc7282f8dd7282f8de7282f8df7282f8e07282f8e17282f8e27282f8e37282f8e47282f8e57282f8e67282f8e77282f8e87282f8e97282f8ea7282f8eb7282f8ec7282f8ed7282f8ee7282f8ef7282f8f07282f8f17282f8f27282f8f37282f8f47282f8f57282f8f67282f8f77282f8f87282f8f97282f8fa7282f8fb7282f8fc7282f8fd7282f8fe7282f8ff7282f8007382f8017382f8027382f8037382f8047382f8057382f8067382f8077382f8087382f8097382f80a7382f80b7382f80c7382f80d7382f80e7382f80f7382f8107382f8117382f8127382f8137382f8147382f8157382f8167382f8177382f8187382d14ff2a842056084728683c683068446848684c684068546858685c685068646868686c68606874687c2f2290252e8001f49457ff449afbff35f8f42e8000121b152e8001f4945f8d03ee7817a002941f08887027e0021002a8df81c107cd04ff2a84507aac2f22905535c002b00f0b68053185f78002f74d09f78002f73d0df78002f72d01f79002f71d05f79002f70d09f79002f6fd0df79002f6ed01f7a002f6dd05f7a002f6cd09f7a002f6bd0df7a002f6ad01f7b002f69d05f7b002f68d09f7b002f67d0df7b002f66d01f7c002f65d05f7c002f64d09f7c002f63d0df7c002f62d01f7d002f61d05f7d002f60d09f7d002f5fd0df7d002f5ed01f7e002f5dd05f7e002f5cd09f7e002f5bd0df7e002f5ad01f7f002f59d05f7f002f58d09f7f002f57d0db7f002b56d0203160297ff49aaf76e0002086f86401c6f8600186f86601012086f8650140f6d100c0f24700804701f019bf4ff2a845c2f2290564e001313ae0023138e0033136e0043134e0053132e0063130e007312ee008312ce009312ae00a3128e00b3126e00c3124e00d3122e00e3120e00f311ee010311ce011311ae0123118e0133116e0143114e0153112e0163110e017310ee018310ce019310ae01a3108e01b3106e01c3104e01d3102e01e3100e01f315f2921d84ff0520353541dd00a4445235e29537018d04f235d29937014d052235c29d37010d044235b2913710cd045235a29537108d052235929937104d020235829d37141f0d68300218df87b100121427e002a00f0c280002207ab9f5c002f00f0a0809f187e78002e5ed0be78002e5dd0fe78002e5cd03e79002e5bd07e79002e5ad0be79002e59d0fe79002e58d03e7a002e57d07e7a002e56d0be7a002e55d0fe7a002e54d03e7b002e53d07e7b002e52d0be7b002e51d0fe7b002e50d03e7c002e4fd07e7c002e4ed0be7c002e4dd0fe7c002e4cd03e7d002e4bd07e7d002e4ad0be7d002e49d0fe7d002e48d03e7e002e47d07e7e002e46d0be7e002e45d0fe7e002e44d03e7f002e43d07e7f002e42d0be7f002e41d0ff7f002f40d02032602a7ff49aaf54e001323ae0023238e0033236e0043234e0053232e0063230e007322ee008322ce009322ae00a3228e00b3226e00c3224e00d3222e00e3220e00f321ee010321ce011321ae0123218e0133216e0143214e0153212e0163210e017320ee018320ce019320ae01a3208e01b3206e01c3204e01d3202e01e3200e01f325f2a15d84ff053079f5411d013444b275e2a5f700cd049275d2a9f7008d050275c2adf7004d020275b2a1f7140f0f08100228df87b200131827e002a00f0be80002107aa535c002b00f0a08053185f78002f5ed09f78002f5dd0df78002f5cd01f79002f5bd05f79002f5ad09f79002f59d0df79002f58d01f7a002f57d05f7a002f56d09f7a002f55d0df7a002f54d01f7b002f53d05f7b002f52d09f7b002f51d0df7b002f50d01f7c002f4fd05f7c002f4ed09f7c002f4dd0df7c002f4cd01f7d002f4bd05f7d002f4ad09f7d002f49d0df7d002f48d01f7e002f47d05f7e002f46d09f7e002f45d0df7e002f44d01f7f002f43d05f7f002f42d09f7f002f41d0db7f002b40d0203160297ff49aaf50e001313ae0023138e0033136e0043134e0053132e0063130e007312ee008312ce009312ae00a3128e00b3126e00c3124e00d3122e00e3120e00f311ee010311ce011311ae0123118e0133116e0143114e0153112e0163110e017310ee018310ce019310ae01a3108e01b3106e01c3104e01d3102e01e3100e01f315f2911d84ff0440353540dd00a4455235e29537008d050235d29937004d020235c29d37040f0098100218df87b1001216a6846f23f53c5f28803b3eb520f40f08b80d20700f08d80002107aa535c002b00f0858153185f78002f00f0f9809f78002f00f0f980df78002f00f0f9801f79002f00f0f9805f79002f00f0f9809f79002f00f0f980df79002f00f0f9801f7a002f00f0fc805f7a002f00f0fc809f7a002f00f0fc80df7a002f00f0fc801f7b002f00f0fc805f7b002f00f0fc809f7b002f00f0fc80df7b002f00f0fc801f7c002f00f0fc805f7c002f00f0fc809f7c002f00f0fc80df7c002f00f0fc801f7d002f00f0fc805f7d002f00f0fc809f7d002f00f0fc80df7d002f00f0fc801f7e002f00f0fc805f7e002f00f0fc809f7e002f00f0fc80df7e002f00f0fc801f7f002f00f00d815f7f002f00f00b819f7f002f00f00981db7f002b00f00781203160297ff47baf1de14cf67e22caf210126a60002940f01981002107aa535c002b00f0dc8053185f78002f61d09f78002f60d0df78002f5fd01f79002f5ed05f79002f5fd09f79002f60d0df79002f61d01f7a002f62d05f7a002f63d09f7a002f64d0df7a002f68d01f7b002f69d05f7b002f6ad09f7b002f6bd0df7b002f6cd01f7c002f6dd05f7c002f6ed09f7c002f6fd0df7c002f70d01f7d002f71d05f7d002f72d09f7d002f73d0df7d002f74d01f7e002f75d05f7e002f76d09f7e002f77d0df7e002f78d01f7f002f79d05f7f002f7ad09f7f002f7bd0db7f002b7cd0203160297ff49aaface000211171f6e6013173e0023171e003316fe004316de0013184e0053169e0023180e0063165e003317ce0073161e0043178e008315de0053174e0093159e0063170e00a3155e007316ce000225a710fe60b314ee0083165e00c314ae0093161e00d3146e00a315de00e3142e00b3159e00f313ee00c3155e010313ae00d3151e0113136e00e314de0123132e00f3149e013312ee0103145e014312ae0113141e0153126e012313de0163122e0133139e017311ee0143135e018311ae0153131e0193116e016312de01a3112e0173129e01b310ee0183125e01c310ae0193121e01d3106e01a311de01e3102e01b3119e01f315f2931d84ff04f0353542dd00a444b235e29537028d020235d29937024d00021d17024e01c3104e01d3102e01e3100e01f315f2918d84ff04103535414d00a444c235e2953700fd05d2993700cd04f235c29d37008d043235b29137104d020235a29537141f0948000218df87b1000210df11c0c1cf80120002a00f0a1800ceb01025378002b5ed09378002b5dd0d378002b5cd01379002b5bd05379002b5ad09379002b59d0d379002b58d0137a002b57d0537a002b56d0937a002b55d0d37a002b54d0137b002b53d0537b002b52d0937b002b51d0d37b002b50d0137c002b4fd0537c002b4ed0937c002b4dd0d37c002b4cd0137d002b4bd0537d002b4ad0937d002b49d0d37d002b48d0137e002b47d0537e002b46d0937e002b45d0d37e002b44d0137f002b43d0537f002b42d0937f002b41d0d27f002a40d0203160297ff498af43e001313ae0023138e0033136e0043134e0053132e0063130e007312ee008312ce009312ae00a3128e00b3126e00c3124e00d3122e00e3120e00f311ee010311ce011311ae0123118e0133116e0143114e0153112e0163110e017310ee018310ce019310ae01a3108e01b3106e01c3104e01d3102e01e3100e01f315f2904d84ff077020cf8012003d100218df87b1002e0614400224a70c2684ff0000e1cf80e10002900f0c4800ceb0e035978002962d09978002962d0d978002962d01979002962d05979002962d09979002962d0d979002962d0197a002962d0597a002962d0997a002962d0d97a002962d0197b002962d0597b002962d0997b002962d0d97b002962d0197c002962d0597c002962d0997c002962d0d97c002962d0197d002962d0597d002962d0997d002962d0d97d002962d0197e002962d0597e002962d0997e002962d0d97e002962d0197f002962d0597f002962d0997f002962d0d97f002962d00ef1200ebef1600f7ff496af4ff0600e5be00ef1010e58e00ef1020e55e00ef1030e52e00ef1040e4fe00ef1050e4ce00ef1060e49e00ef1070e46e00ef1080e43e00ef1090e40e00ef10a0e3de00ef10b0e3ae00ef10c0e37e00ef10d0e34e00ef10e0e31e00ef10f0e2ee00ef1100e2be00ef1110e28e00ef1120e25e00ef1130e22e00ef1140e1fe00ef1150e1ce00ef1160e19e00ef1170e16e00ef1180e13e00ef1190e10e00ef11a0e0de00ef11b0e0ae00ef11c0e07e00ef11d0e04e00ef11e0e01e00ef11f0e01230a2a1ed364274ff47a7642f2107503eb83014900b2fbf1f40a2c11d303fb07f1b2fbf1f40a2c0bd303fb06f1b2fbf1f40a2c05d36b43b2fbf3f10929e7d800e00b46f146bef15f0f98bf4ff05f09c9f1000818eb0e0b52d0b2fbf3f40a2b04f130010cf80e104cf6cd41ccf6cc41a3fb011646d31bf1010141d004fb1324f708b4fbf7fa0ceb0e020af13001517048f21f51c5f2eb11642ba3fb011634d31bf102012cd00afb17447709b4fbf7f6b3f57a7f06f13001917044f6d351c1f26201a3fb015123d31bf1030518d006fb1744890941f25976b4fbf1f5cdf2b716a3fb066705f13006d67005fb114242f210710ef1040e8b424fea5733aad209e0ce4607e00ef1010e04e00ef1020e01e00ef1030e0022e3460cf80e201bf80210002900f0a1800beb02014b78002b5ed08b78002b5dd0cb78002b5cd00b79002b5bd04b79002b5ad08b79002b59d0cb79002b58d00b7a002b57d04b7a002b56d08b7a002b55d0cb7a002b54d00b7b002b53d04b7b002b52d08b7b002b51d0cb7b002b50d00b7c002b4fd04b7c002b4ed08b7c002b4dd0cb7c002b4cd00b7d002b4bd04b7d002b4ad08b7d002b49d0cb7d002b48d00b7e002b47d04b7e002b46d08b7e002b45d0cb7e002b44d00b7f002b43d04b7f002b42d08b7f002b41d0c97f002940d02032602a7ff498af52e001323ae0023238e0033236e0043234e0053232e0063230e007322ee008322ce009322ae00a3228e00b3226e00c3224e00d3222e00e3220e00f321ee010321ce011321ae0123218e0133216e0143214e0153212e0163210e017320ee018320ce019320ae01a3208e01b3206e01c3204e01d3202e01e3200e01f325f2a13d84ff075010bf802100ed00beb020173235e2a4b7008d020235d2a8b7004d070235c2acb7040f09d8000218df87b1002694ff000081bf80810002900f0c7800beb08035978002962d09978002962d0d978002962d01979002962d05979002962d09979002962d0d979002962d0197a002962d0597a002962d0997a002962d0d97a002962d0197b002962d0597b002962d0997b002962d0d97b002965d0197c002965d0597c002965d0997c002965d0d97c002965d0197d002965d0597d002965d0997d002965d0d97d002965d0197e002965d0597e002965d0997e002965d0d97e002965d0197f002965d0597f002965d0997f002965d0d97f002965d008f12008b8f1600f7ff496af4ff060085ee008f101085be008f1020858e008f1030855e008f1040852e008f105084fe008f106084ce008f1070849e008f1080846e008f1090843e008f10a0840e008f10b083de008f10c083ae008f10d0837e008f10e0834e000220a7162e708f10f082ee008f110082be008f1110828e008f1120825e008f1130822e008f114081fe008f115081ce008f1160819e008f1170816e008f1180813e008f1190810e008f11a080de008f11b080ae008f11c0807e008f11d0804e008f11e0801e008f11f0801230a2a1ed364274ff47a7642f2107503eb83014900b2fbf1f40a2c11d303fb07f1b2fbf1f40a2c0bd303fb06f1b2fbf1f40a2c05d36b43b2fbf3f10929e7d800e00b46c646b8f15f0f98bf4ff05f0ecef1000a42f2107c1aeb080950d0b2fbf3f40a2b04f130010bf808104cf6cd41ccf6cc41a3fb011644d319f101013fd004fb1324f708b4fbf7f60beb080206f13001517048f21f51c5f2eb11642ba3fb015132d319f102052ad006fb17444e09b4fbf6f7b3f57a7f07f13001917044f6d351c1f26201a3fb015121d319f1030516d007fb1644890941f25976b4fbf1f5cdf2b716a3fb066705f13006d67005fb114208f1040863454fea5733acd209e0f04607e008f1010804e008f1020801e008f10308039f00220bf808201bf80210002900f0a1800beb02014b78002b5ed08b78002b5dd0cb78002b5cd00b79002b5bd04b79002b5ad08b79002b59d0cb79002b58d00b7a002b57d04b7a002b56d08b7a002b55d0cb7a002b54d00b7b002b53d04b7b002b52d08b7b002b51d0cb7b002b50d00b7c002b4fd04b7c002b4ed08b7c002b4dd0cb7c002b4cd00b7d002b4bd04b7d002b4ad08b7d002b49d0cb7d002b48d00b7e002b47d04b7e002b46d08b7e002b45d0cb7e002b44d00b7f002b43d04b7f002b42d08b7f002b41d0c97f002940d02032602a7ff498af4ae001323ae0023238e0033236e0043234e0053232e0063230e007322ee008322ce009322ae00a3228e00b3226e00c3224e00d3222e00e3220e00f321ee010321ce011321ae0123218e0133216e0143214e0153212e0163210e017320ee018320ce019320ae01a3208e01b3206e01c3204e01d3202e01e3200e01f325f2a0bd84ff075010bf8021006d00beb020173235e2a4b7040f08780044600208df87b00384602215a4608f09ef8d4f870c272208df81c0078208df81d0020204ff000091ffa8cf28df81e008df81f901bf80900002800f0c8800beb09035878002866d09878002866d0d878002866d01879002866d05879002866d09879002866d0d879002866d0187a002866d0587a002866d0987a002866d0d87a002866d0187b002866d0587b002866d0987b002866d0d87b002866d0187c002866d0587c002866d0987c002866d0d87c002866d0187d002866d0587d002866d0987d002866d0d87d002866d0187e002866d0587e002866d0987e002866d0d87e002866d0187f002866d0587f002866d0987f002866d0d87f002866d009f12009b9f1600f7ff496af4ff060095fe004460020887078e709f1010958e009f1020955e009f1030952e009f104094fe009f105094ce009f1060949e009f1070946e009f1080943e009f1090940e009f10a093de009f10b093ae009f10c0937e009f10d0934e009f10e0931e009f10f092ee009f110092be009f1110928e009f1120925e009f1130922e009f114091fe009f115091ce009f1160919e009f1170916e009f1180913e009f1190910e009f11a090de009f11b090ae009f11c0907e009f11d0904e009f11e0901e009f11f0901230a2a1ed364274ff47a7642f2107503eb83004000b2fbf0f40a2c11d303fb07f0b2fbf0f40a2c0bd303fb06f0b2fbf0f40a2c05d36b43b2fbf3f00928e7d800e00346ca46b9f15f0f98bf4ff05f0acaf1000842f2107e18eb09054dd0b2fbf3f04cf6cd4100f13004ccf6cc410bf809400a2ba3fb016441d36e1c3dd000fb1320e408b0fbf4f748f21f5107f130060beb0902c5f2eb115670642ba3fb011630d3a91c29d007fb14007409b0fbf4f7b3f57a7f07f13001917044f6d351c1f26201a3fb011620d3e91c16d007fb1400b10941f25975b0fbf1f4cdf2b715a3fb055604f13005d57004fb110209f1040973454fea5633afd209e0d14607e009f1010904e009f1020901e009f1030900220bf809201bf80200002800f0a1800beb0201487800285ed0887800285dd0c87800285cd0087900285bd0487900285ad08879002859d0c879002858d0087a002857d0487a002856d0887a002855d0c87a002854d0087b002853d0487b002852d0887b002851d0c87b002850d0087c00284fd0487c00284ed0887c00284dd0c87c00284cd0087d00284bd0487d00284ad0887d002849d0c87d002848d0087e002847d0487e002846d0887e002845d0c87e002844d0087f002843d0487f002842d0887f002841d0c87f002840d02032602a7ff498af56e001323ae0023238e0033236e0043234e0053232e0063230e007322ee008322ce009322ae00a3228e00b3226e00c3224e00d3222e00e3220e00f321ee010321ce011321ae0123218e0133216e0143214e0153212e0163210e017320ee018320ce019320ae01a3208e01b3206e01c3204e01d3202e01e3200e01f325f2a17d84ff020000bf8020012d00beb020163205e2a48700cd072205d2a887008d063205c2ac87004d020205b2a087140f0668100208df87b0037214fea1c7001eb1c71bcf1204f38bf00f13001ccf303608df8171000f137010a2838bf00f13001ccf303508df8181000f137010a2838bf00f13001ccf303408df8191000f137010a2838bf00f1300100208df81b001f208df81a100beb000111f81f2c002a00f0818011f81e2c002a7ed011f81d2c002a7cd011f81c2c002a7ad011f81b2c002a78d011f81a2c002a76d011f8192c002a74d011f8182c002a72d011f8172c002a70d011f8162c002a6ed011f8152c002a6cd011f8142c002a6ad011f8132c002a68d011f8122c002a66d011f8112c002a64d011f8102c002a62d011f80f2c002a60d011f80e2c002a5ed011f80d2c002a5cd011f80c2c002a5ad011f80b2c002a58d011f80a2c002a56d011f8092c002a54d011f8082c002a52d011f8072c002a50d011f8062c002a4ed011f8052c002a4cd011f8042c002a4ad011f8032c002a48d011f8022c002a46d011f8011c002944d01bf80010002941d020307f287ff479af61e01f383ae01e3838e01d3836e01c3834e01b3832e01a3830e019382ee018382ce017382ae0163828e0153826e0143824e0133822e0123820e011381ee010381ce00f381ae00e3818e00d3816e00c3814e00b3812e00a3810e009380ee008380ce007380ae0063808e0053806e0043804e0033802e0023800e001385f2822d8c0f15d0ec0f15e02c0f15f03c0f1600c584400260df11705af5d8755b7b1b34211d0af1979788419617079b1b2420ad0b978a17051b1b64505d0f978e17029b10436b445e8d100208df87b00039842f2a00845f2a80440f2403507aa0e21c2f22008c2f21304c2f2000507f047fde869ae46a0425fd1def82800b0f54d2f5ad1def82c00a04256d145f61c530020c2f213034cf6394508f1040c002763454ad81c6834f003061cd098454ff0ff3228bf0c2c42d3a8eb03018e424ff0ff313ed83946be4288bf3146e2071cbf0f4630449919013d01f10403e0d12ce00020487199e60421b7f5807f1ed300223e46b6f5007f14d3b6f5806f13d3b6f5006f12d30901b2eb163f4fea1616f0d10ce000219171fef76bbf00211172fef729bc490002e0890000e0c900634504d1494207ea0102014603e04ff0ff324ff0ff3146f68050c2f20700d0f8880008f1080342f6a00c9842c2f2270c29d142f61c574ff00008c2f2200746f6b9750cf1040b00264ff0ff394ff0ff3a5f4518d83c6834f003005cd0bc4528bf0c2c12d3aceb0703984210d8b042334688bf0346e4071cbf1e4680443844013d00f10407e4d14ff0ff394ff0ff3adef800300cf10800834240f08b80def80c30b3f5333f40f08580def81030834240f080804ff2a84043f21c53c2f229004ff0000bc2f2270342f6f934a0f1040ca0f1080e00264ff0ff3863456ad81d6835f0030730d09e454ff0ff30019028bf0c2d62d3aeeb0300874260d83046b74288bf3846ed071cbf0646bb44d819013c00f10403e1d14de073460425b6f5807f2dd34ff0000e3046b0f5007f22d3b0f5806f21d3b0f5006f20d32d01beeb103f4fea1010f0d11ae00425b6f5807f29d300273446b4f5007f1fd3b4f5806f1ed3b4f5006f1dd32d01b7eb143f4fea1414f0d117e06d0002e0ad0000e0ed005f4505d1684206ea0009c2469e4680e74ff0ff394ff0ff3a9e467ae76d0002e0ad0000e0ed00634505d16b4206ea03000190d84604e04ff0ff3001904ff0ff3866208df81c0072208df81d0065208df81e008df81f002f208df820006d204b238df8210061208df8253069238df8220078208df82630422356278df8230020208df827303a238df82b70472707ac8df824008df828308df829004c238df82c708df82e00002720468df82a308df82d308df82f7007f04efde05d002800f0a080e019417800295ed0817800295dd0c17800295cd0017900295bd0417900295ad08179002959d0c179002958d0017a002957d0417a002956d0817a002955d0c17a002954d0017b002953d0417b002952d0817b002951d0c17b002950d0017c00294fd0417c00294ed0817c00294dd0c17c00294cd0017d00294bd0417d00294ad0817d002949d0c17d002948d0017e002947d0417e002946d0817e002945d0c17e002944d0017f002943d0417f002942d0817f002941d0c07f002840d02037602f7ff49aaf64e001373ae0023738e0033736e0043734e0053732e0063730e007372ee008372ce009372ae00a3728e00b3726e00c3724e00d3722e00e3720e00f371ee010371ce011371ae0123718e0133716e0143714e0153712e0163710e017370ee018370ce019370ae01a3708e01b3706e01c3704e01d3702e01e3700e01f375f2f25d84ff02000e05521d0e01945215e2f41701cd076215d2f817018d065215c2fc17014d06e215b2f017110d048215a2f41710cd07521592f817108d06221582fc17104d02021572f017240f0f88000208df87b00204651464a4607f07afc0020215c002900f0a08021184a78002a5ed08a78002a5dd0ca78002a5cd00a79002a5bd04a79002a5ad08a79002a59d0ca79002a58d00a7a002a57d04a7a002a56d08a7a002a55d0ca7a002a54d00a7b002a53d04a7b002a52d08a7b002a51d0ca7b002a50d00a7c002a4fd04a7c002a4ed08a7c002a4dd0ca7c002a4cd00a7d002a4bd04a7d002a4ad08a7d002a49d0ca7d002a48d00a7e002a47d04a7e002a46d08a7e002a45d0ca7e002a44d00a7f002a43d04a7f002a42d08a7f002a41d0c97f002940d0203060287ff49aaf5be001303ae0023038e0033036e0043034e0053032e0063030e007302ee008302ce009302ae00a3028e00b3026e00c3024e00d3022e00e3020e00f301ee010301ce011301ae0123018e0133016e0143014e0153012e0163010e017300ee018300ce019300ae01a3008e01b3006e01c3004e01d3002e01e3000e01f305f281cd84ff02001215418d021184f225e284a7013d074225d288a700fd068225c28ca700bd065225b280a7107d072225a284a7103d0202259288a7128d100208df87b0007ac019a2046414607f0adfb03981a21224607f02afa029e002086f86401c6f8600103984cf6036107904ff41630089007a8c0f247018847012086f8660104a800f041f930611fb0bde8f08f0020c871d6e70021417207e700bf2de9f04f81b0009041f204024cf65560cef20002ccf2ac50c2f8ac0f4ef6fc50cef2000001684ef66c6641f08071016052f8040c4ff2a8474ff6245a48f2c738ccf2ff06c2f229074ff6ff7440f00100cff6ff7a00254ff0010bc0f2450842f8040c02e0bff32f8fc047d7f80090bff35f8f3868bff35f8f01466ff39601b1f1005f03d10168b14200f0a8804ff4377002f0b2fb002800f0de80514642183d3182f8dc5282f8dd5282f8de5282f8df5282f8e05282f8e15282f8e25282f8e35282f8e45282f8e55282f8e65282f8e75282f8e85282f8e95282f8ea5282f8eb5282f8ec5282f8ed5282f8ee5282f8ef5282f8f05282f8f15282f8f25282f8f35282f8f45282f8f55282f8f65282f8f75282f8f85282f8f95282f8fa5282f8fb5282f8fc5282f8fd5282f8fe5282f8ff5282f8005382f8015382f8025382f8035382f8045382f8055382f8065382f8075382f8085382f8095382f80a5382f80b5382f80c5382f80d5382f80e5382f80f5382f8105382f8115382f8125382f8135382f8145382f8155382f8165382f8175382f8185382d1066080f80ab08483c483048444848484c484048544858485c485048644868486c4860487448757e8001f49457ff44fafbff35f8f00bf47e8000121b157e8001f4945f8d043e74169d1bb46f6805245f6e466c2f20702cff6f8761368314617689f420ed117689f420bd117689f4208d117689f4203d1002901f10401efd19f421ed041f20401cef200010b6817681168b9420ed11168b9420bd11168b94208d11168b94203d1002e06f10406efd1b94206d041f20401cef200010968c91a416141f20400cef2000000680099086001b0bde8f08f00bf2de9f04f81b041f20401cef200014ef66c674ff2a846d1f8009000684ff6245bccf2ff07c2f229064ff6ff74cff6ff7b00254ff00108009007e000bf48f2c731c0f24501bff32f8f8847d6f800a0bff35f8f3068bff35f8f01466ff39601b1f1005f03d10168b94200f0a8804ff4377002f08cfa002800f0fc80594642183d3182f8dc5282f8dd5282f8de5282f8df5282f8e05282f8e15282f8e25282f8e35282f8e45282f8e55282f8e65282f8e75282f8e85282f8e95282f8ea5282f8eb5282f8ec5282f8ed5282f8ee5282f8ef5282f8f05282f8f15282f8f25282f8f35282f8f45282f8f55282f8f65282f8f75282f8f85282f8f95282f8fa5282f8fb5282f8fc5282f8fd5282f8fe5282f8ff5282f8005382f8015382f8025382f8035382f8045382f8055382f8065382f8075382f8085382f8095382f80a5382f80b5382f80c5382f80d5382f80e5382f80f5382f8105382f8115382f8125382f8135382f8145382f8155382f8165382f8175382f8185382d1076080f80a808483c483048444848484c484048544858485c485048644868486c4860487448756e8001f51457ff44bafbff35f8f00bf46e8000121b156e8001f5145f8d03fe74169009d61b144f6d350c1f26200a1fb0001880901284ff0010088bf88094ce046f6805245f6e466c2f20702cff6f8761368314617689f420ed117689f420bd117689f4208d117689f4203d1002901f10401efd19f422fd041f20401cef200010b6817681168b9420ed11168b9420bd11168b94208d11168b94203d1002e06f10406efd1b94217d041f20401cef20001096844f6d357ca1ac1f26207a2fb07764261b00901284ff0010088bfb009994208bffa2001e0009dfa20a9eb0501b1fbf0f001b0bde8f08f002858d1002956d0082a54d30b78aa2b51d18b79f02b4ed12de9f04f83b00b2a4ed3c878a2f10803834249d14878212848d10879012845d14879012842d1c87900283fd10c4614f8080f10f03c0f39d18818884610f8021c10f8010c164641ea0025a2f10a0081b2204606f0affd854228d14cf6dd70c0f245008047811eb1fa81f14f09012808bf0227002f00f02b81207887f00301084200f02781012039464246334600f06cfa0446002898f8080018bf06241ae14ff2e933c0f24c0318470b2400e00a244cf6dd70c0f245008047811eb1fa81f14d09012808bf0225002d00f0fd804ef66c6a4ff2a8474ff624580294ccf2ff0ac2f229074ff6ff74cff6ff7800264ff0010b06e048f2c731c0f24501bff32f8f8847d7f80090bff35f8f3868bff35f8f01466ff39601b1f1005f03d10168514500f0a9804ff4377002f0e3f8002800f0ca80414600bf42183d3182f8dc6282f8dd6282f8de6282f8df6282f8e06282f8e16282f8e26282f8e36282f8e46282f8e56282f8e66282f8e76282f8e86282f8e96282f8ea6282f8eb6282f8ec6282f8ed6282f8ee6282f8ef6282f8f06282f8f16282f8f26282f8f36282f8f46282f8f56282f8f66282f8f76282f8f86282f8f96282f8fa6282f8fb6282f8fc6282f8fd6282f8fe6282f8ff6282f8006382f8016382f8026382f8036382f8046382f8056382f8066382f8076382f8086382f8096382f80a6382f80b6382f80c6382f80d6382f80e6382f80f6382f8106382f8116382f8126382f8136382f8146382f8156382f8166382f8176382f8186382d1c0f800a080f80ab08483c483048444848484c484048544858485c485048644868486c4860487448757e8001f49457ff449afbff35f8f47e8000121b157e8001f4945f8d03ee705eb450100eb011090f85d1201b300f513760024304629462a460323009406f047fd706840b146f22b11c0f25d018847706806f0b7fb74603068b475002818bf06f0b0fb0020029c3060b060308200e0029c204603b0bde8f08f0624f9e700243842f6d0404631463a463b4600f064f9002818bf0446ece70b291dd3c278a1f10803934218d10278aa2a13d14278212a10d10279012a0dd14279012a0ad18279f02a07d1c2792ab9024612f8083f13f03c0f03d00a2070470b20704710b5084410f8023c10f8010c43ea0024a1f10a0081b2104606f034fc201a18bf0a2010bd002808bf7047b0b582b00446407cd0b1002520460323009506f0dafc606840b146f22b11c0f25d018847606806f04afb65602068a575002818bf06f043fb00202060a060208202b0bde8b040704700bf2de9f04f81b04ef66c654ff2a8464ff624598046ccf2ff05c2f229064ff6ff77cff6ff7900244ff0010a06e048f2c731c0f24501bff32f8f8847d6f800b0bff35f8f3068bff35f8f01466ff39601b1f1005f03d10168a94200f0a9804ff4377001f074ff002800f0a180494642183d3182f8dc4282f8dd4282f8de4282f8df4282f8e04282f8e14282f8e24282f8e34282f8e44282f8e54282f8e64282f8e74282f8e84282f8e94282f8ea4282f8eb4282f8ec4282f8ed4282f8ee4282f8ef4282f8f04282f8f14282f8f24282f8f34282f8f44282f8f54282f8f64282f8f74282f8f84282f8f94282f8fa4282f8fb4282f8fc4282f8fd4282f8fe4282f8ff4282f8004382f8014382f8024382f8034382f8044382f8054382f8064382f8074382f8084382f8094382f80a4382f80b4382f80c4382f80d4382f80e4382f80f4382f8104382f8114382f8124382f8134382f8144382f8154382f8164382f8174382f8184382d1056080f80aa08783c783078447848784c784078547858785c785078647868786c7860787478756e8001f59457ff44bafbff35f8f00bf46e8000129b156e8001f5945f8d03fe7002008eb480100eb0111002818bf01f5137001b0bde8f08fb0b5c4b0dc08202c03d94ff0ff3044b0b0bd0df107048df807008df80810a01c11461a461d46fcf771fda81c4af28d5582b2c0f24605f02021460023a84744b0b0bd00bf2de9f04f8bb04ef66c654ff2a8464ff6245948f2c73bccf2ff05c2f229064ff6ff77cff6ff7900244ff0010ac0f2450bcde90612cde9080303e000bfbff32f8fd847d6f80080bff35f8f3068bff35f8f01466ff39601b1f1005f03d10168a94200f0a8804ff4377001f06cfe002800f04484494642183d3182f8dc4282f8dd4282f8de4282f8df4282f8e04282f8e14282f8e24282f8e34282f8e44282f8e54282f8e64282f8e74282f8e84282f8e94282f8ea4282f8eb4282f8ec4282f8ed4282f8ee4282f8ef4282f8f04282f8f14282f8f24282f8f34282f8f44282f8f54282f8f64282f8f74282f8f84282f8f94282f8fa4282f8fb4282f8fc4282f8fd4282f8fe4282f8ff4282f8004382f8014382f8024382f8034382f8044382f8054382f8064382f8074382f8084382f8094382f80a4382f80b4382f80c4382f80d4382f80e4382f80f4382f8104382f8114382f8124382f8134382f8144382f8154382f8164382f8174382f8184382d1056080f80aa08783c783078447848784c784078547858785c785078647868786c7860787478756e8001f41457ff44fafbff35f8f00bf46e8000121b156e8001f4145f8d043e70999089d01eb410100eb011095f9081000f51376b1f1ff3f01f0030409dd374617f8110fd0bb3068002818bf06f044f92ee3307cf0b1707ce0b10799099a002730460323009706f0bdfa706840b146f22b11c0f25d018847706806f02df977603068b775002818bf06f026f900203060b06030823068002818bf06f01df900204ff480713060b0603182a978b081092006f11107f174b17434757076b07ca978884240f0da82317da14240f0d682069b411ca3f10b00727e02971e2828bf1e209042b17488bf7076981e84b200270a2c4ff00008c0f0e682092241f221090920039419e030684f46002818bf06f0e4f8b089376001303774b760b081002c18bf4ff00608039cd146ddf814a00aeb0b0082b2a24280f0c682317c80b20429824600f28880aa5c00f1010a4b1c0129337405dd022906d0032970d1f28106e021b9727503e0338943ea02223281a24580f0a98204296ed015f80a204ff0000c831c8f1c0129377406ddff290bd0032967460dd19a4652e000291cbf378947ea0222328100e072756746a34204d38ae2f281a34280f08782022936d8ea5c00f1030acb1c0129337407dd022937d0fe2907d17275a2450cd375e231b9338943ea02223281a24504d36de2f281a24580f06a8202292fd015f80a20031d41f00407fc29377408ddfd2909d0fe291cbf378947ea0222328103e079b9f28100e072756746a34280f04f8209b19a4613e0ea5c00f1050a0520307401e09a466746f189308941ea0221f18128b106f050f80028306000f0698233897089191a1ffa81fb1ffa8af1621a5a45b8bf93465fea0b4208d03268294410441ffa8bf2fcf75bfb70893389584481b2994270817ff44faf0025cdf81080d6f800808df82b50707db8f1000f06930df12b0108bf88460f2806d8317d00f00302511ab1fa81f14d09000706d4317e707e814238bf30760fe000bf706840b146f22b11c0f25d018847706805f0faff7760707e30760120f082cdf814a09db1707db57d400714d4002d4ff0000400f0888106984ff6ff7381b2002900f00d8101295ed10020d2e0707d400753d4002477e14ff4803005f0dfff002d804600f06f81b07d002800f06b81b8f1000f00f067817568002d00f0ff8030890428c0f05f8131680a1812f8043c002b40f0588112f8033c002b40f0538112f8023cff2b40f04e8112f8012cff2a40f049814ff4803429606860c5f80c802c610028019000f0668146f22b10c0f25d0000f58572284600219047002840f032812969002900f02e8168688c420c46e7d1019a0c468242e3d124e14ff4803005f08dff04461fe1069a4ff6fe701040a44642426ff0010000bf08eb0005ac78ed7883ea04231cb25f003fb209ead43484ea430309ead7375c0087ea430324b25f003fb209ead43484ea430309ead7375c0087ea430324b25f003fb209ead43484ea430309ead7375c0087ea430324b25f003fb209ead43484ea430309ead73787ea430383ea05231fb25d002db209ead73787ea430309ead5355f0085ea43033fb25d002db209ead73787ea430309ead5355f0085ea43033fb25d002db209ead73787ea430309ead5355f0085ea43033fb25d002db209ead737023087ea430309ead5371518023587ea430395d1023000276446069ad20732d018f8000083ea002002b243001bb209ead23282ea400009ead333420083ea400012b243001bb209ead23282ea400009ead333420083ea400012b243001bb209ead23282ea400009ead333420083ea400012b243001bb209ead23282ea400009ead33282ea4003f0899ab282426fd14046fcf7d0fa00286ad141f2210a4ff00009012375e0382005f0cdfe00285ed00546077047708770c770077147718771c771077247728772c772077347738773c773077447748774c774077547758775c775077647768776c776077747778777c77780f8287080f8297080f82a7080f82b7080f82c7080f82d7080f82e7080f82f7080f8307080f8317080f8327080f8337080f8347080f8357080f8367080f8377046f28510c0f200007844286246f28d10c0f200007844686246f22b10c0f25d0047f2f85200f13c0c28460f21c0f27b023823e04740b3284605f062fe4446706841f2210a40b146f22b11c0f25d018847706805f055fe77604ff000090323b77506980799099a089dddf8108087b23046009705f0cbff002c214604463ff456ad084605f03dfe51e5756074e6c4f58030b4f5803f444606902f60ef607ff647aecde70799099a002430460323009405f0adff706840b146f22b11c0f25d018847706805f01dfe74603068b475002818bf05f016fe0020387000203060b06030824ff00a0840460bb0bde8f08f287a4006f8d5307c08b302980078e0b10799099a002430460323009405f080ff706840b146f22b11c0f25d018847706805f0f0fd74603068b475002818bf05f0e9fd00203060b06030824ff00b083068002818bf05f0defd00203060b0603082cae702980078e0b10799099a002430460323009405f054ff706840b146f22b11c0f25d018847706805f0c4fd74603068b475002818bf05f0bdfd00203060b06030824ff00608a7e72de9f041f02846d100294ff00b0000f08880022ac0f085804cf6dd70c0f245000e4617468047811eb1fa81f14c09012808bf0224002c4ff00a0072d07578e91ec9b2fe2938bfbde8f081307833463946022829d0012866d1ac4204bf0020bde8f0814808842884bf0b20bde8f081881e03f1020887b240463946fff7e1f920b306462846fff738fa21462a46fff70cfa3046bde8f0814cf6dd77c0f2450707f5e27cbde8f0416047ac4219d1a1f1210010f1160f06d36ff0480048432330c0b2242810d90b20bde8f081b07a204207d04046394622462b46bde8f041fff710bb0020bde8f0811a4612f8020f40f00207032f18d19b796340032b14d10b2904d0032804bf0b20bde8f081881e4df22d7783b2c0f247070120f021b847002818bf0620bde8f0810a20bde8f081b0b54cf28544c0f251041d46a0474ff2a841c2f229010968bff35f8f0a466ff39602b2f1005f08d10a684ef66c63ccf2ff039a4218bf002100e00021421c18bf002900d1b0bd95f84d20002afad091f84321002a08bfb0bd45f2e823c2f206031a68132aeed8c2ebc20403eb04135b6801ebc2014ff40042c1f8c031a1f8c6212a7a01f5e071002a0fbf802248f20112ca808122ab7c33b1ab7d23b1022342f002028b71ca7195f820303bb195f8243023b1032342f004028b71ca7195f846304bb195f8443042f008020b7195f84530ca714b71b0bd47f27e32c2f207021378002b14bf9378ff230b711378002b14bf5278ff224a71b0bdf0b589b045f6e532c0f24b020c46054690474ff2a841c2f229010e68bff35f8f31466ff39601b1f1005f08d131684ef66c62ccf2ff02914208bf092d01d009b0f0bde1082c29fad896f843110029f6d04cf6dd71c0f2450107468847014638460129ecd1ff22079244f6435245f2e8210020cff60172c2f20601089006920b685a1e132a4fd8c3ebc30501eb05111a1fa1f5de7191f85451ad0618d4d51c42d091f8e450ad0616d4951c3cd091f87450ad0613d4551c36d00d79ad0610d4043aa1f5e071151da3f10403e3d12be05a1e01f5a87104e09a1ee03101e0da1e703106ebc203096893f9c721b2f1ff3f1adc03f5e0731e688e4215d11e798df81b605e798df81c609b798df81e200a0a8df820108df821200a0c090e8df81d308df822208df823100f228df8012010228df80220522208218df80420b4f5804f4ff080028df800108df8061038bf4ff48042b4f5001f6ff07f0604f07f0138bf0026802c28bf80318df807109df809509df80a108df8030004d29df808200223002415e0c4f3c610b4f5804f024403d20323012400200be0b4f5001f03d204230224012003e0052303240120002135468df8053004f108038df808208df809508df80a1070b96846a222c118c254062048700c208870c81c06a90c22fbf7e3fe04f117034df60f166a46c0f2470601200821b047384609b0f0bd70b582b00546ff208df8040044f25220c0f2010000904ef6a970c0f2470016460c46804798b147f2a620c2f2070000880122c1b264298df8032008d80721b0f5807f38bf03218df803108df80400301b28bf08280cd3d221281929550621417005218170033069460522fbf79ffe0834204602b070bd00bf024600284ff0ff3009d0022918bf70471078112801d1507810b14ff0ff30704710b586b04cf6dd70c0f24500804701284ff000003ed1cde9020040f20830c0f210000190ff208df8140044f25220c0f2010004904ef6a970c0f24700804798b147f2a620c2f2070000880122c1b264298df8132008d80721b0f5807f38bf03218df813108df8140040f2d260adf80800052001ac8df80a00e01d04a90522fbf749fe4df60f1cc0f2470c0120092122460c23e04706b010bd4ff2a840c2f22900016808466ff39600b0f1005f16d108684ef66c62ccf2ff0290420fd1d1f8380160b146f68052c2f207021268801a0028cebf01200020c1f838017047002070474ff2a840c2f22900026810466ff39600b0f1005f2bd110684ef66c61ccf2ff01884224d1d2f8680108b346f68051c2f207010968401a0028c4bf01207047d2f86c1100200029c2f8680182f8660108bf704710b5c2f86c0148f2c732c0f245020446084690472046bde8104070470020704700bff0b101684ef66c62ccf2ff02914218bf704790f8421199b110b54af29f344ff0000cc0f24604864680f842c10120002100220023aef840c1a446bde810406047704700bff0b581b004464ef2e960c0f245008047002c18bf012801d101b0f0bd21796279a379e77941ea022141ea034151ea076109d00e2904d00329eed10646032504e00646042501e006460225fff759ff00283046e1d04ff2a841c2f229010e6831466ff39601b1f1005fd6d131684ef66c62ccf2ff029142cfd14cf6dd71a778c0f2450104468847014620460129c4d1b221082086f86412062186f86002032086f8651286f86612462186f86102102086f86712432186f86202002086f86812012186f86b724df6090706f5187286f8630286f8691286f86c02c0f24707012009210d2386f86a52b847204601b0f0bd00bf2046fff785bf00bf2de9f04f81b04ef66c694ff2a8464ff624580446ccf2ff09c2f229064ff6ff77cff6ff7800254ff0010a06e048f2c731c0f24501bff32f8f8847d6f800b0bff35f8f3068bff35f8f01466ff39601b1f1005f03d10168494500f0a8804ff4377000f04efe002800f0cd80414642183d3182f8dc5282f8dd5282f8de5282f8df5282f8e05282f8e15282f8e25282f8e35282f8e45282f8e55282f8e65282f8e75282f8e85282f8e95282f8ea5282f8eb5282f8ec5282f8ed5282f8ee5282f8ef5282f8f05282f8f15282f8f25282f8f35282f8f45282f8f55282f8f65282f8f75282f8f85282f8f95282f8fa5282f8fb5282f8fc5282f8fd5282f8fe5282f8ff5282f8005382f8015382f8025382f8035382f8045382f8055382f8065382f8075382f8085382f8095382f80a5382f80b5382f80c5382f80d5382f80e5382f80f5382f8105382f8115382f8125382f8135382f8145382f8155382f8165382f8175382f8185382d1c0f8009080f80aa08783c783078447848784c784078547858785c785078647868786c7860787478756e8001f59457ff44aafbff35f8f46e8000121b156e8001f5945f8d03fe7002780f857712a270821032380f85871042780f8541180f85531102380f8597180f85a1101214df60f1c074600f5aa7280f8563180f85b1180f85c31002c18bf0124c0f2470c012010210a2387f85d4101b0bde8f04f604701b0bde8f08f00bf80b582b04ff0010ccdf800c000f002f802b080bd2de9f04381b04ff2a847c2f229073f684ff000093e466ff39606b6f1005f07d13e684ef66c65ccf2ff05ae4208bfb946012811d1ddf820801c4615460e460746fff7d2fd2346044631462a463846002c18bfb9f1000f07d14af29f3cc0f2460c01b0bde8f043604799f8420188b1b8f1010f40f08580d9f83c01002189f84211a9f84011e0b342f68d41c0f24401884736e0b9f840010121013080b2012898bf0846a9f84001d9f83c0142f68d44c0f2440489f8421168b94ff6dd30cff6ff70a4f59477784400214a460023b847c9f83c0140b1a047d9f83c01a4f140024ff4c8719047a8b199f84201002848d0d9f83c01002189f84211a9f8401100b1a0474af29f3cc0f2460c0120002100220023a6e74cf6dd70c0f24500804701282fd1082089f84401032089f84501102089f84601002089f84701b22089f84801062089f8490189f84a01462089f84b01432089f84c01012089f84d01b9f840014df6090c070a09f5a27289f84e8189f84f01c0f2470c012009210d2389f850716fe701b0bde8f08300bf80b582b04ff0050ccdf800c0fff734ff02b080bd2de9f04f83b04468002c00f0c1828368002b00f0bd8204eb030b4ff000090027002614e046f68053c2f207031b6845f69077c0f201073b44c6f838310ceb0a0300275b451c464ff0000680f0a182a04618f9013b03f07f05bd40002b46ea050610d406f00703012b16dc0bb3012b40f08f82abeb0803082bc0f08a8204f10903dee700bfd84580f08382182f07f107074446dcd97ce200bf022b3ad0052b40f07782abeb0803042bc0f07282631dc7e7d84580f06d8294f90130002b04f10203bed55b4580f0648294f90230b3f1ff3f04f10303b4dc5b4580f05a8294f90330b3f1ff3f04f10403aadc5b4580f0508294f90430b3f1ff3f04f10503a0dc5b4580f0468294f90530002b00f14182a31d96e7d84580f03c8294f9013004f1020c002b03f07f0a1ed5dc4580f0318294f90270e31c07f07f05b7f1ff3f4aeac51a02dde0469c460ee05b4580f0218294f9037004f1040c07f07f05b7f1ff3f4aea853a33dd9846abeb0c039a4500f21082f308672b1dd0652b7ff460afbaf1060ffff45caf9cf80030462b7ff457af98f80230432b7ff452af98f80330012b7ff44daf4ff2a844c2f229040290cde9002132e0044660460e4651461746654600f01bfcac4631463a46204637e7dc4580f0df8194f90470631d07f07f05b7f1ff3f4aea455aaddc5b4580f0d28194f90570002f00f1cd8104f1060c4aea077ab1e748f2c7313046c0f24501bff32f8f8847dde900210298ac462768bff35f8f2668bff35f8f33466ff39603b3f1005f07d133684ef66c65ccf2ff05ab4200f0bc804ff43770654600f07dfbdde9002106460298ac46002e3ff4f1ae4ff62453cff6ff7300bff4183d3384f8dc9284f8dd9284f8de9284f8df9284f8e09284f8e19284f8e29284f8e39284f8e49284f8e59284f8e69284f8e79284f8e89284f8e99284f8ea9284f8eb9284f8ec9284f8ed9284f8ee9284f8ef9284f8f09284f8f19284f8f29284f8f39284f8f49284f8f59284f8f69284f8f79284f8f89284f8f99284f8fa9284f8fb9284f8fc9284f8fd9284f8fe9284f8ff9284f8009384f8019384f8029384f8039384f8049384f8059384f8069384f8079384f8089384f8099384f80a9384f80b9384f80c9384f80d9384f80e9384f80f9384f8109384f8119384f8129384f8139384f8149384f8159384f8169384f8179384f8189382d14ef66c63ccf2ff0333600123b3724ff6ff734ff2a844b383f38333847384b384f38433857385b385f38533867386b386f38633877387c2f2290454e8003fbb427ff42fafbff35f8f00bf44e8006323b154e8003fbb42f8d023e798f8043098f8057098f80650032b47ea052433dd052b54dc042b74d0052b7ff431aed6f868313bb146f68057c2f207073f68db1b002b14dcd6f86c3186f866917bb10c4648f2c73180461846c0f24501c6f86c91174665468847ac4621463a46404646f68053c2f207031b6845f69077c0f201073b44c6f8683103e6012b3ff4f5ad022b00f08380032b7ff4fbad174688466546fff7fefa03460298ac4641463a46002b3ff4eead96f84231002b3ff4e9ad304641f28831a6f8404105f04ef847e0062b4ad0072b7ff4dcad80464cf23330c0f24a0016460f466446804703465d1ea446394632464046012d3ff6caad981eb0fa80f04009fff7c8fba446394632464046bee5174688466546fff7c2fa03460298ac4641463a46002b3ff4b2ad96f84231002b3ff4adadb6f84031a3427ff4a8add6f83c3186f84291002ba6f840913ff49fad42f68d411846c0f2440188470298ac4641463a4693e5d6f86c31c6f86891002b86f866913ff48bad0f4648f2c73104461846c0f24501c6f86c91164665468847ac463946324640e696f84231c6f83891002b3ff474ad0446d6f83c0165468846174686f84291a6f8409120b142f68d41c0f2440188474af29f360120002100220023c0f24606b04720463a464146ac4655e54df60923c0f2490303b0bde8f04f18477fb50646002806d1fff750fa002807d19de80f00064645f25b1cc0f24f0c60477fbd00bf2de9f04182b04df609061d4614460929c0f247064cd180460f46f22d10d8a22160196155062141700b21817045f64251c0f20001033079440b22fbf763f80e35204629464ff4807200f038f80546ff208df8040044f25220c0f20100009006f5bd50804798b147f2a620c2f2070000880122c1b264298df8032008d80721b0f5807f38bf03218df803108df80400f82d0cd8d221601961550621417005218170033069460522fbf72df808353946404622462b46b04702b0bde8f081f0b587b00c464ff2a841c2f229010d68bff35f8f29466ff39601b1f1005f52d129684ef66c63ccf2ff0399424bd14d218df8041043218df8051001218df8061095f8701195f871318df807108df8083095f87511b5f878318df80b108df80c30190ab5f87a318df80d10190a8df80f1095f8761195f8737195f874618df80e3095f877318df810104cf6dd71c0f245018df809708df80a608df81130064617468847d5f87c3101468df81210190a8df81410190c3a4630468df813308df81510190ea02328e04d218df8041043218df8051001218df80610002100238df807108df808108df809108df80a108df80b108df80c108df80d108df80e108df80f108df810108df811108df812108df813108df814108df815108df816108df817300023111b8df8183028bf18290cd3c222011902550620487015208870c81c01a91522faf781ff1834204607b0f0bd00bf2de9f04f81b04ff2a840c2f229000468bff35f8f20466ff39600b0f1005f0dd120684ef66c63ccf2ff03984206d194f8700118b1002a18bf002902d101b0bde8f08f94f877010028f8d0d4f880010028f4d046f68059c2f20709d9f80030c01a0128ebdb94f87101012802d14ff0010b06e094f873b1bbf1010f18bf4ff0020b94f876510020eb078846adf80200adf8000013d0bbf1020f10d194f8750168b96b464bf2f1270df10201c0f25a07404615461a46b8472a4694f876511646b2f5c86f28bf4ff4c86606f1150a5046174600f050f80028b1d0b7f5c86f88bf45f08005d9f80010d4f87c2153230271120a42710a0a8171c2710a0c090e03704d234172a02143700123c17200218370c570027280f80ab0017394f87511bdf802204173bdf800108373c173090a0174110a8174310a017500f115014274c6740746084641463246faf7d7fe4df66d22c0f24702384651469047d4f87c0148f2c7310130c4f87c01c0f245013846884701b0bde8f08fb0b54ff2ac44c2f22904216846f23f52c5f28802b2eb510f48f283314cf67e25c0f24501caf2101518bf25608847002804bf691c2160b0bd10b301684ef66c62ccf2ff0291421bd190f87711c1b1d0f88011b1b146f68052c2f207021368cb1a012b0edb1268d0f88401002808bf7047891a42f64d42c0f2440208bf01211047704710b5002143f2c942c0f8801180f87711c0f25902002044f24361904748f65354c0f25a04a04704f1bc00bde81040004700bf2de9f04f81b00429c0f0f7800c46014600784d2840f0f1804878432840f0ed808878012840f0e9804ef66c684ff2a847ccf2ff08c2f229074ff6ff7600254ff0010b8a4607e048f2c731c0f24501bff32f8f88475146d7f80090bff35f8f3868bff35f8f02466ff39602b2f1005f03d10268424500f0ac804ff43770fff766ff002800f0ba804ff624525146cff6ff7283183d3283f8dc5283f8dd5283f8de5283f8df5283f8e05283f8e15283f8e25283f8e35283f8e45283f8e55283f8e65283f8e75283f8e85283f8e95283f8ea5283f8eb5283f8ec5283f8ed5283f8ee5283f8ef5283f8f05283f8f15283f8f25283f8f35283f8f45283f8f55283f8f65283f8f75283f8f85283f8f95283f8fa5283f8fb5283f8fc5283f8fd5283f8fe5283f8ff5283f8005383f8015383f8025383f8035383f8045383f8055383f8065383f8075383f8085383f8095383f80a5383f80b5383f80c5383f80d5383f80e5383f80f5383f8105383f8115383f8125383f8135383f8145383f8155383f8165383f8175383f8185382d1c0f8008080f80ab08683c683068446848684c684068546858685c685068646868686c6860687468757e8002f4a457ff445afbff35f8f47e8000222b157e8002f4a45f8d03ae7ca78022a04dc012a0dd0022a79d00ce0032a0dd0042a08d190f8701129b101b0bde8f04faae00d2c06d201b0bde8f08f044600f045f963e090f87721aab1002143f2c94280f87711c0f259020446002044f24361904748f65355c0f25a05a84705f1bc008047204651460a790446012a88bf002280f871214a7902f00303012b4ff0010298bf134680f873318f79012f88bf002780f87471cf79022f88bf002780f875710f7a4e7a47ea0627502f98bf5027b7f5f07f28bf4ff4f077a0f878718f7ace7a47ea062741f28836b74238bf3e46a0f87a61097b80f8702101f0030180f8761103f0010101eb530180f872110021c0f87c1100f009f8204600f03ef8204601b0bde8f04f6ae000bfb0b5044690f87601800758bfb0bd94f8710148f6a3450128c0f25a0507d105f1b000804705f58b71002088470ee005f5b670804794f87101012801d1002004e094f87301013818bf0120a8474ff6a122cff6ff7243f271337a44c0f25903002044f243619847012084f87701b0bd00bf70b5044646f68050c2f20700006894f8771145f69075c0f2010500292844c4f8800108bf70bdd4f8840142f66536c0f2440658b94ff6f930cff6ff707844002122460023b047c4f8840150b106f594718847d4f8840106f1e8022946bde87040104770bd70b5044600f5c475082084f88801032084f88901102084f88a01c22084f88c01062084f88d014d2084f88f01432084f89001012084f8910194f8700194f8711184f8920184f8931194f87501b4f8781184f8960184f89711080ab4f87a1184f89801080a84f89a0194f8760194f8732194f8743184f8991194f8771184f89b014cf6dd700026c0f2450084f88b6184f8942184f8953184f89c118047d4f87c1184f89d01080a84f89f01080c84f8a001080e84f8a101a02084f8a36115264df6090c84f89e1184f8a201c0f2470c012009212a461c2384f88e61bde87040604770b54ff2a840c2f229000468bff35f8f20466ff39600b0f1005f33d120684ef66c61ccf2ff01884218bf70bd94f877010025c4f8805188b143f2c942c0f25902002044f2436184f87751904748f65356c0f25a06b04706f1bc008047d4f8840184f8705170b142f68d45c0f24405a847d4f8840105f166018847002804bf0020c4f8840170bd00bf2de9f04182b04ff2a841c2f229010c68bff35f8f21466ff39601b1f1005f75d121684ef66c62ccf2ff0291426ed194f8a81179b394f8aa01c0070ad0d4f8680178b346f68051c2f207010968401a002827dd46f2d835c2f2070555f8040c002854d04ff27717c0f24b0747f62938002607f5437101a8c0f24b0801968847a8b1032084f8ab612860b4f8ac01c04702b0bde8f081d4f8b411c1b302b0bde8f0410847204602b0bde8f04133e001984ef6ed56c0f24b06a861b04706f5af708047e861b847012084f8ab0103202860b4f8ac01c047d4f8bc01a0b10199d4f8b821b4f8ae71531a38bf8b1abb420ad2b4f8b01159b146f68052c2f207021268101a884203d32046022100f06ef802b0bde8f08100bfb0b590f8a841002c42d043f60852c2f2000211880829114622d0114631f8083f082b1dd0114631f8103f082b18d0114631f8183f082b13d0114631f8203f082b0ed0114631f8283f082b09d0114631f8303f082b04d032f8381f0829114614d14a68b2f5870f10d36ff35602012a0cd14a684ff66f63cff6ff737b449a4204d1d0f8b421002a18bf4a60002180f8a81190f8a911b1b1002180f8a91144f68241c2f20701097869b946f2d431c2f20701096839b148f26111c0f24b010546042088472846002c08bfb0bd0321bde8b04000e000bfb0b588b004464cf6dd70c0f245000d468047012840f08f8008208df8010003208df8020010208df8030000208df80400ca208df8050006208df8060018208df8070046f2f030c2f2070050f81c2c94f8a811002a18bf0122002944f68141c2f207014b7818bf0232002b94f8ab3118bf0432002b4ff0410318bf08328df808304c238df8093001238df80a308df80b508df80c2050f8182c4df609058df80d200268c0f24705130a8df80e208df80f30130c120e8df810308df811204268130a8df812208df81330130c120e8df814308df8152002698df81620120a8df8172009788df8181081688df819106821c2f2000109688df81a10090a8df81b1046f68051c2f207010a68130a8df81c208df81d30130c120e8df81e308df81f2000680df10102c4f8b80108680921c4f8bc0101201f23a84708b0b0bd00bf2de9f04f83b0022902d24ff0ff35fee0cde901100120cff680704ef66c644ff2a8464ff6245bccf2ff04c2f229064ff6ff77851ccff6ff7b4ff000084ff0010907e000bf48f2c731c0f24501bff32f8f8847d6f800a0bff35f8f3068bff35f8f00ea0501b1f1005f03d10168a14200f0a7804ff43770fff74bfb0028c5d0594642183d3182f8dc8282f8dd8282f8de8282f8df8282f8e08282f8e18282f8e28282f8e38282f8e48282f8e58282f8e68282f8e78282f8e88282f8e98282f8ea8282f8eb8282f8ec8282f8ed8282f8ee8282f8ef8282f8f08282f8f18282f8f28282f8f38282f8f48282f8f58282f8f68282f8f78282f8f88282f8f98282f8fa8282f8fb8282f8fc8282f8fd8282f8fe8282f8ff8282f8008382f8018382f8028382f8038382f8048382f8058382f8068382f8078382f8088382f8098382f80a8382f80b8382f80c8382f80d8382f80e8382f80f8382f8108382f8118382f8128382f8138382f8148382f8158382f8168382f8178382f8188382d1046080f80a908783c783078447848784c784078547858785c785078647868786c7860787478756e8001f51457ff44dafbff35f8f00bf46e8000121b156e8001f5145f8d041e704464cf6dd70c0f24500804701281dd1029d6978022916d00129204607d000297ff413af00210025fff76cfe0fe0019f41f28831022f0ed14ff4fa730022012741f2883624e02046fff7f2fd0025284603b0bde8f08faa78052f11d3eb782e79072f43ea062310d395f805c0ae79092f4cea0627e4d3ee792d7a46ea052607e041f288364ff4fa7301e041f288360127642b98bf64238b4228bf0b4690f8a81180f8aa21a0f8ac31a0f8ae71a0f8b06171b146f2d431c2f207010968002954d001210446fff71efe0025c4f8bc51bee743f60852c2f2000211880829114622d0114631f8083f082b1dd0114631f8103f082b18d0114631f8183f082b13d0114631f8203f082b0ed0114631f8283f082b09d0114631f8303f082b04d032f8381f0829114632d14a686ff00105b2f5870ffff48daf0123cff680731a40012a7ff486af4b684ff6cd12cff6ff727a44934214bfc0f8b431d0f8b431002b3ff477af4a60012180f8a811a3e748f2ef01c0f24b010420884720b105462046fff758fd65e70121204684f8a91199e76ff001055de700bf334600f005b800bf334600f037b800bf2de9f04182b042f2d7281e4614460d460746c0f24608fef771fa002e18bf002808d108f1160338462946224602b0bde8f041184746f26870c2f207000068c0470028eed00068e028ebd130784bf6d32601900027c0f24e0600200021002209230097b047012002b0bde8f0812de9f04182b042f2d7281e4614460d460746c0f24608fef73bfa002e18bf002808d108f1160338462946224602b0bde8f041184746f26870c2f207000068c0470028eed00068e028ebd130784bf6d32601900027c0f24e060020002100220a230097b047012002b0bde8f08110b582b00446fef70dfa0146002c4ff0000018bf002901d102b010bd46f26870c2f20700006842f2d721c0f24601884790b10068e0284ff00000edd121784bf6d32c0191c0f24e0c002100220b230090e047012002b010bd002002b010bd00bf08b53046fff7ccff002805d002b044f6e970c0f24400004748f68b43c0f24603984708bd012818bf002900d170478968002908bf704710b582b00a794b798c79c97942ea032242ea044242ea0161062910d14ef22151c0f24501044688470146204639b144f6e100c0f2440080470146204619b102b0bde810407047fef7a2f9014620460029f5d046f26870c2f20700006842f2d721c0f246018847014620460029e7d00968e029e4d14bf6d32e4ff0000cc0f24e0e0020002100220c23cdf804c0cdf800c0f0472046d3e710b5059c4ff23710c0f2460080472146fff7a2ff10bd00bf2de9f04f8bb0044600284ff0ff3000f031830d46002900f02d83217801f07f070a2f0edd102f27dc0b2f00f08482102f40f02482204629460bb0bde8f04ffff71fbd052f00f03081072f00f016830a2f40f01482022dc0f00d834ef66c6b4ff2a847ccf2ff0bc2f229074ff6ff764ff0000a4ff0010858e0112f00f0f682122f40f0fc81b5f1010b01f0728004f1010a00230021abeb03000628c0f0b1860aeb0304207962799d1d40ea0222abeb050082424ff0ff3000f2dd821af803306778a678e47843ea072343ea064343ea0463b3f5802f00f2ce82c3f580239a4200f2c982002a02eb050318bf01215b45d1d3002901f03d80fef7f3f8002800f080864ef66c674ff2a845ccf2ff07c2f229054ff6ff764ff0000800f02fbc48f2c731c0f24501bff32f8f8847d7f80090bff35f8f38680321cff680710140b1f1005fbff35f8f03d10168594500f0a2834ff43770fff71df8002800f052864ff62451cff6ff7142183d3182f8dca282f8dda282f8dea282f8dfa282f8e0a282f8e1a282f8e2a282f8e3a282f8e4a282f8e5a282f8e6a282f8e7a282f8e8a282f8e9a282f8eaa282f8eba282f8eca282f8eda282f8eea282f8efa282f8f0a282f8f1a282f8f2a282f8f3a282f8f4a282f8f5a282f8f6a282f8f7a282f8f8a282f8f9a282f8faa282f8fba282f8fca282f8fda282f8fea282f8ffa282f800a382f801a382f802a382f803a382f804a382f805a382f806a382f807a382f808a382f809a382f80aa382f80ba382f80ca382f80da382f80ea382f80fa382f810a382f811a382f812a382f813a382f814a382f815a382f816a382f817a382f818a382d1c0f800b080f80a808683c683068446848684c684068546858685c685068646868686c6860687468757e8001f49457ff446afbff35f8f47e80001002900f0fa8257e8001f4945f6d039e74ef66c664ff2a847ccf2ff06c2f229074ff6ff7b4ff000084ff00109022d2cbf6078ff20059006e048f2c731c0f24501bff32f8f8847d7f800a0bff35f8f38680321cff680710140b1f1005fbff35f8f03d10168b14200f091824ff43770fef743ff002800f0d9844ff62451cff6ff7142183d3182f8dc8282f8dd8282f8de8282f8df8282f8e08282f8e18282f8e28282f8e38282f8e48282f8e58282f8e68282f8e78282f8e88282f8e98282f8ea8282f8eb8282f8ec8282f8ed8282f8ee8282f8ef8282f8f08282f8f18282f8f28282f8f38282f8f48282f8f58282f8f68282f8f78282f8f88282f8f98282f8fa8282f8fb8282f8fc8282f8fd8282f8fe8282f8ff8282f8008382f8018382f8028382f8038382f8048382f8058382f8068382f8078382f8088382f8098382f80a8382f80b8382f80c8382f80d8382f80e8382f80f8382f8108382f8118382f8128382f8138382f8148382f8158382f8168382f8178382f8188382d1066080f80a90a0f81cb0a0f81eb0a0f820b0a0f822b0a0f824b0a0f826b0a0f828b0a0f82ab0a0f82cb0a0f82eb0a0f830b0a0f832b0a0f834b0a0f836b0a0f838b0a0f83ab057e8001f51457ff437afbff35f8f00bf47e80001002900f0d98157e8001f5145f6d029e70f2f9b4600f0f481a7f11300012840f2ef81092f00f05d83082f40f0d583002a4ff0ff3000f0e880022dc0f0e58094f80190b9f1000f00f0ad8402264ff0010848f2482ab21caa4200f29c84a019a15d407851ea002100f095848e18ae4200f29184a05cde4600f07f07153fffb2fd2f16d8c0b20f280ed9a0f1830cbcf10c0f4ff0ff3000f2b88008fa0cf741f249031f4205d1b0e008fa00f717ea0a0febd0a01800227346fff76dfd002840f06a84b9f10109c6d100f06dbc4ff2a846c2f229063468bff35f8f20466ff39600b0f1005f40f00f8620684ef66c67ccf2ff07b8424ff0000040f08780c4f8680184f8660184f86401d4f86c11c4f8600184f8650139b148f2c732c4f86c01c0f2450208469047d4f87802002818bf03f08ef90021c4f87812206c40f2030942f68d48cff68079c0f24408a4f8441040b1c047206c08f166018847002804bf0020206446f67560c0f2510080473568bff35f8f05ea0900b0f1005f2bd12868b84228d195f877014ff0000ac5f880a188b143f2c942c0f25902002044f2436185f877a1904748f6535bc0f25a0bd8470bf1bc008047d5f8840185f870a150b1c047d5f8840108f166018847002804bf0020c5f884013068bff35f8f00ea0901b1f1005f40f029850168b94240f0258590f8a811002900f01a85fff705f900f01cbd022d08bf112900f02b810bb0bde8f08f4ef66c6a4ff2a847ccf2ff0ac2f229074ff6ff764ff0000b4ff0010806e048f2c731c0f24501bff32f8f8847d7f80090bff35f8f38680321cff680710140b1f1005fbff35f8f03d10168514500f05e834ff43770fef75ffd002800f056834ff62451cff6ff7142183d3182f8dcb282f8ddb282f8deb282f8dfb282f8e0b282f8e1b282f8e2b282f8e3b282f8e4b282f8e5b282f8e6b282f8e7b282f8e8b282f8e9b282f8eab282f8ebb282f8ecb282f8edb282f8eeb282f8efb282f8f0b282f8f1b282f8f2b282f8f3b282f8f4b282f8f5b282f8f6b282f8f7b282f8f8b282f8f9b282f8fab282f8fbb282f8fcb282f8fdb282f8feb282f8ffb282f800b382f801b382f802b382f803b382f804b382f805b382f806b382f807b382f808b382f809b382f80ab382f80bb382f80cb382f80db382f80eb382f80fb382f810b382f811b382f812b382f813b382f814b382f815b382f816b382f817b382f818b382d1c0f800a080f80a808683c683068446848684c684068546858685c685068646868686c6860687468757e8001f49457ff446afbff35f8f47e80001002900f0b68257e8001f4945f6d039e790f84410059f61b1016c39b142f68d42c0f244020646084690473046002180f844100121002f40f04082032dc0f03d82a078082800f28a8446f67561c0f251019631884700f082bc164600f0a9fc002800f0c482611c142fa5f1010200f0b782132f5b4640f0b78200f0eefdb5e26678002e00f04581022e00f2b08240f03d84062dc0f0ab82a178e2782379677941ea022143ea072232290691079280f02784322100f029bc6078002840f097824cf6dd70c0f24500804701284ff000007ff4c7aecde9070040f20830c0f210000690ff208df8280044f25220c0f2010009904ef6a970c0f24700804798b147f2a620c2f2070000880122c1b264298df8272008d80721b0f5807f38bf03218df827108df8280040f2d260adf81c00052006ac8df81e00e01d09a90522f9f7e1fa4df60f17c0f247070120092122460c23b8470bb0bde8f08f48f2c7314846c0f24501bff32f8f88472c68bff35f8fd5f800900320cff6807000ea0900b0f1005fbff35f8f04d1d9f80000b84200f03b824ff43770fef7f3fb002800f0288281464ff62450cff6ff7000bf09eb00013d3081f8dc8281f8dd8281f8de8281f8df8281f8e08281f8e18281f8e28281f8e38281f8e48281f8e58281f8e68281f8e78281f8e88281f8e98281f8ea8281f8eb8281f8ec8281f8ed8281f8ee8281f8ef8281f8f08281f8f18281f8f28281f8f38281f8f48281f8f58281f8f68281f8f78281f8f88281f8f98281f8fa8281f8fb8281f8fc8281f8fd8281f8fe8281f8ff8281f8008381f8018381f8028381f8038381f8048381f8058381f8068381f8078381f8088381f8098381f80a8381f80b8381f80c8381f80d8381f80e8381f80f8381f8108381f8118381f8128381f8138381f8148381f8158381f8168381f8178381f8188381d10120c9f8007089f80a00a9f81c60a9f81e60a9f82060a9f82260a9f82460a9f82660a9f82860a9f82a60a9f82c60a9f82e60a9f83060a9f83260a9f83460a9f83660a9f83860a9f83a6055e8000fa0427ff42fafbff35f8f45e80090002800f07f8155e8000fa042f6d022e7002480f843414cf6dd70c0f2450080470146204601297ff49bad4df25f50c0f255000bb0bde8f04f004708064ff0210158bf11218d42c0f05181002804f101060ad54cf6dd70c0f24500154680472a46022818bf04f111063079717950ea01244ff0ff301ebfb179f37951ea03253ff46fad317b737b41ea03218c427ff468adb17bf37b41ea03218d427ff461ad3078717840ea012804eb0800b0f5207f4ff0ff303ff655adb178f37841ea0327e919b1f5f07f3ff64cad317a737a41ea032904eb0901b1f5207f3ff642adb17af37a41ea0326a919b1f5f07f3ff639ad924600f0defa002800f0f98041463a464b46cde90145009602f0adf9dbf800100f2909d80bebc1020131a2f80690168154819581cbf80010baf1000f40f0e78095e2f81e18bf0120bb1f18bf012318424ff0ff307ff40dad032dfff40aad032f00f0b281062f7ff404ad00200021164602f0edfa00f0a5fa002800f0c0800246601c691e4ff4f0774ff4a073009702f01efc002800f0b380dbf800100f2900f2b3800bebc1020023d38013814ff4207353814ff4f07301319381cbf80010a3e0059f00210020002f3ff4c0ad012f19d1052d17d3a378581e06284ff000003ff6c8ace17803293ff6c4ac2279002a3ff4c0ac46f67560c0f2510000f59a771846b84734e2022f05d146f67560c0f2510080472ce2032f40f01381072dc0f01081a078e278217940ea02206579a67901284ff0010498bf204644f62062904228bf104646f67562c0f2510202f5e272642928bf6421904746f2a070c2f207000068002800f0048245ea0621012988bf0c4642f68d41c0f24401a1f1400221469047f5e10020022d2cbf6178ff21002800f0ee81024602294ff0000025d0012920d000297ff466ac4cf67e21caf21011907610837960108150609683d683168456849684d684168556859685d685168656869686d6861687568782f83c000bb0bde8f08f01209072c2e190720bb0bde8f08f5b4600f0ecfe01e001f067fb20b14ff0ff300bb0bde8f08f002e00f0b081584601f0a7ffabe1d9f86c0100286ed14ff48020fef7b4f90028e9d000210022831881544032b2f5802f59709970d970197159719971d971197259729972d972197359739973d973197459749974d974197559759975d975197659769976d976197759779977d97783f8201083f8211083f8221083f8231083f8241083f8251083f8261083f8271083f8281083f8291083f82a1083f82b1083f82c1083f82d1083f82e1083f82f1083f8301083f8311083f8321083f8331083f8341083f8351083f8361083f8371083f8381083f8391083f83a1083f83b1083f83c1083f83d1083f83e1083f83f109ad1c9f86c0100210aeb010006794579437846ea0525d9f86c611af8012087788c1d06eb0321c078114401eb074101eb00600aeb04012a46f8f7f0ff291959454ff00000e0d3fff799bb3a1f80460020b2fa82f2022d88bf012052091040084001284ff000007ff489ab4cf6cd42e91eccf6cc42a578a1fb0212b5eb920f88bf95082f4608f14603302d28bf3027e11c07eb870204461846f8f7c0ff002d88f8447088f8454000f0b480d8f8400038b94046f9f71dfc0028c8f8400000f0fc8042f68d41c0f24401a1f1400201219047d2e0080600f1d480082dfff415af07214ff0050c0123e71897f802804ff0ff30b8f1000f3ff442abfe78002e3ff43eab14f8039005914fea880101eb8903b3f5207f04913ff632ab97f801a0770007eb4a03b3f5f07f3ff629ab04eb0c0014f80c104078039241ea002081b2012002f00bf900f0c3f800283ff4deae05990aeb8a020c4400ebc2104fea4803691a00eb49022046009702f037fa00283ff4ccaedbf800100f290dd84fea89020bebc106f280049a4fea4a03013133817281b781cbf80010039900297ff4beae6ce090f8a911002918bffef7e7fb94f84301002684f8436158b14cf6dd70c0f245008047012804d14df25f50c0f255008047d4f83c0194f84251c4f8386184f84261a4f8406150b1c047d4f83c0108f166018847002804bf0020c4f83c010120a072ddb34af29f37c0f246070021002200230024b84720460bb0bde8f08fb1f5fa6f02d94ff4fa6106910121044680f843114cf6dd70c0f24500804701281dd14df25f55c0f25505a5f188008047022e08bf002801d058b910e048f2d31206a9c0f24b020220904740b10646a8473046002184f843110bb0bde8f08f00200bb0bde8f08f0c2dfff441aee078e17988427ff43cae2079217a88427ff437ae4cf6dd70c0f24500164680470523022808bf01230b214ff0090c324616e746f675600024c0f2510088f844408047a3e700bf2de9f04f81b04ef66c6b4ff2a8454ff6245848f2c73accf2ff0bc2f229054ff6ff76cff6ff7800274ff00109c0f2450a03e000bfbff32f8fd0472c68bff35f8f2868bff35f8f01466ff39601b1f1005f03d10168594500f0a9804ff43770fdf7b5ff002800f01a81414600bf42183d3182f8dc7282f8dd7282f8de7282f8df7282f8e07282f8e17282f8e27282f8e37282f8e47282f8e57282f8e67282f8e77282f8e87282f8e97282f8ea7282f8eb7282f8ec7282f8ed7282f8ee7282f8ef7282f8f07282f8f17282f8f27282f8f37282f8f47282f8f57282f8f67282f8f77282f8f87282f8f97282f8fa7282f8fb7282f8fc7282f8fd7282f8fe7282f8ff7282f8007382f8017382f8027382f8037382f8047382f8057382f8067382f8077382f8087382f8097382f80a7382f80b7382f80c7382f80d7382f80e7382f80f7382f8107382f8117382f8127382f8137382f8147382f8157382f8167382f8177382f8187382d1c0f800b080f80a908683c683068446848684c684068546858685c685068646868686c6860687468755e8001fa1427ff44eafbff35f8f45e8000121b155e8001fa142f8d043e7d0f87812002974d104464ff4163002f0a5fa014600284ff0000069d0002200bf8b1888544032b2f5163f58709870d870187158719871d871187258729872d872187358739873d873187458749874d874187558759875d875187658769876d876187758779877d87783f8200083f8210083f8220083f8230083f8240083f8250083f8260083f8270083f8280083f8290083f82a0083f82b0083f82c0083f82d0083f82e0083f82f0083f8300083f8310083f8320083f8330083f8340083f8350083f8360083f8370083f8380083f8390083f83a0083f83b0083f83c0083f83d0083f83e0083f83f009ad1c4f8781200e00021084601b0bde8f08f00bf092a1cbf4ff0ff3070472de9f04f8db08a4683460693fcf72dff002800f015824ef66c684ff2a847ccf2ff08c2f229074ff6ff740026012507e000bf48f2c731c0f24501bff32f8f8847d7f80090bff35f8f3868bff35f8f01466ff39601b1f1005f03d10168414500f0ad804ff43770fdf758fe002800f0a5804ff62451cff6ff7100bf42183d3182f8dc6282f8dd6282f8de6282f8df6282f8e06282f8e16282f8e26282f8e36282f8e46282f8e56282f8e66282f8e76282f8e86282f8e96282f8ea6282f8eb6282f8ec6282f8ed6282f8ee6282f8ef6282f8f06282f8f16282f8f26282f8f36282f8f46282f8f56282f8f66282f8f76282f8f86282f8f96282f8fa6282f8fb6282f8fc6282f8fd6282f8fe6282f8ff6282f8006382f8016382f8026382f8036382f8046382f8056382f8066382f8076382f8086382f8096382f80a6382f80b6382f80c6382f80d6382f80e6382f80f6382f8106382f8116382f8126382f8136382f8146382f8156382f8166382f8176382f8186382d1c0f8008085728483c483048444848484c484048544858485c485048644868486c4860487448757e8001f49457ff447afbff35f8f00bf47e8000129b157e8001f4945f8d03be70020002800f03f819af800109af801209af802309af8037041ea022141ea034141ea07624ff6fe77c0f20307ba424ff0ff3100f28982d0f86c310846002b00f02481995c4ff0ff30002900f01e81134493f80190b9f1000f00f0178109fb01f09d1c4ff0000c4ff0000368b3a7f101089e18be4200f007819e462b441c78240904d00126a0421bd2fde000bf464500f0fa805c781cb10226a04211d2f3e00524cff6fc743444042cc0f0ed809c78db7854ea032400f0e7800426a042c0f0e380001b06eb0e03d3d19af804009af8052098469af806309af807609af80870cdf8009040ea022943ea0626b8060f2307f00f0403eae07000fb04f389204343db0a8df824300e2317f0200f08bf4ff00f0c08bf012304fb03f300fb03f34fead3238df825304ff00d0308bf022304fb03f300fb03f34fead3238df826304ff00c0308bf032304fb03f300fb03f34fead3238df827304ff00b0308bf042304fb03f300fb03f34fead3238df828304ff00a0308bf052304fb03f300fb03f34fead3238df829304ff0090308bf062304fb03f300fb03f34fead3238df82a304ff0080308bf072304fb03f300fb03f34fead3238df82b304ff0070308bf082304fb03f300fb03f34fead3238df82c304ff0060308bf092304fb03f300fb03f34fead3238df82d304ff0050308bf0a2304fb03f300fb03f34fead3238df82e304ff0040308bf0b2304fb03f300fb03f34fead3238df82f304ff0030308bf0c2304fb03f300fb03f34fead3238df830304ff0020308bf0d2304fb03f300fb03f34fead3238df831304ff0010308bf0e2363434343db0a8df832300cfb04f358434ff0010ec00ab8f1000fcdf814808df8330000f06f8107f010008eea1010002403904ff0000804950ce04ff0ff300db0bde8f08fdde90704049d04440598844280f05881285d0894020901d0012313e0059a171b012f00f04d812b195a780ab1022309e0042fc0f045819f78db7857ea032200f03f810423079310f00f0309a810f803a018bf012303984fea0a1e40ea030c12f00300474600f08080b8fbf1f300259f19b7f1ff3fc8bf012505ea0c05012d1dd103fb11834b44dd09042d17d87d090e2d14d807eb87050beb85155f08ec5ddb076ff00f03019408bf0f230290504608bf7046019c234003430298eb55012808f1010751d0b7fbf1f300249d19b5f1ff3fc8bf012404ea0c04012c1ad103fb11734b44dc09042c14d86c090e2c11d805eb85040beb84145d08db070290605d6ff00f03574604bf0f237746034002983b436355022808f1020726d0b7fbf1f300259c19b4f1ff3fc8bf012505ea0c05012d18d103fb11734b44dd09042d12d865090e2d0fd804eb84040beb84145d08db07605d6ff00f03574604bf0f23774603403b43635508f10307531e032b904405d246e700bf0437b8453ff442afb7fbf1f40025a319b3f1ff3fc8bf012505ea0c05012d18d104fb11744c44e509042d12d85d090e2d0fd803eb83030beb831365085a5de4076ff00f04504604bf0f2470462240104358557c1cb4fbf1f50020ab19b3f1ff3fc8bf012000ea0c00012819d105fb114000eb0904e009042812d858090e280fd803eb83000beb80106208835ce4076ff00f04554604bf0f24754623402b438354bc1cb4fbf1f50020ab19b3f1ff3fc8bf012000ea0c00012819d105fb114000eb0904e009042812d858090e280fd803eb83000beb80106208835ce4076ff00f04554604bf0f24754623402b438354fc1cb4fbf1f50020ab19b3f1ff3fc8bf012000ea0c0001287ff47baf05fb114000eb0904e00904283ff673af58090e283ff66faf03eb83000beb80106208835ce4076ff00f04554604bf0f24754623402b4383545de708460db0bde8f08f09eb01000099b0f5207f06eb0103a8bf4ff42070b3f5f07fa8bf4ff4f0730699484588bfb34203d800200db0bde8f08f0f680f2ff8d89a1ba0eb090001ebc7035881781ca3f806901e819a810860ebe70a2a3cbf4ff0ff3070472de9f04f95b017468a4605461c46fcf77afb002800f0f9809af8096006f10a0087424ff0ff3040f0f2809af800109af801209af802309af8037041ea022141ea034141ea07624ff68061c0f203018a4200f2dd8010960e95cde90c429af808004ef66c644ff2a8454ff62456ccf2ff04c2f229054ff6ff77cff6ff764ff0000b4ff001080f9007e000bf48f2c731c0f24501bff32f8f8847d5f80090bff35f8f2868bff35f8f01466ff39601b1f1005f03d10168a14200f0ad804ff43770fdf77afa002800f0e681314642183d3182f8dcb282f8ddb282f8deb282f8dfb282f8e0b282f8e1b282f8e2b282f8e3b282f8e4b282f8e5b282f8e6b282f8e7b282f8e8b282f8e9b282f8eab282f8ebb282f8ecb282f8edb282f8eeb282f8efb282f8f0b282f8f1b282f8f2b282f8f3b282f8f4b282f8f5b282f8f6b282f8f7b282f8f8b282f8f9b282f8fab282f8fbb282f8fcb282f8fdb282f8feb282f8ffb282f800b382f801b382f802b382f803b382f804b382f805b382f806b382f807b382f808b382f809b382f80ab382f80bb382f80cb382f80db382f80eb382f80fb382f810b382f811b382f812b382f813b382f814b382f815b382f816b382f817b382f818b382d1046080f80a808783c783078447848784c784078547858785c785078647868786c7860787478755e8001f49457ff44bafbff35f8f00bf45e8000149b155e8001f4945f8d03fe74ff0ff3015b0bde8f08fd0f86c91109eb9f1000f00f039810f9c0f23a10604f00f0203eae171514389235943c90a8df844100e219af804c09af805709af806e09af8075014f0200f08bf012102fb01f103fb01f14fead1218df845104ff00d0108bf022102fb01f103fb01f14fead1218df846104ff00c0108bf032102fb01f103fb01f14fead1218df847104ff00b0108bf042102fb01f103fb01f14fead1218df848104ff00a0108bf052102fb01f103fb01f14fead1218df849104ff0090108bf062102fb01f103fb01f14fead1218df84a104ff0080108bf072102fb01f103fb01f14fead1218df84b104ff0070108bf082102fb01f103fb01f14fead1218df84c104ff0060108bf092102fb01f103fb01f14fead1218df84d104ff0050108bf0a2102fb01f103fb01f14fead1218df84e104ff0040108bf0b2102fb01f103fb01f14fead1218df84f104ff0030108bf0c2102fb01f103fb01f14fead1218df850104ff0020108bf0d2102fb01f103fb01f14fead1218df851104ff0010108bf0e2102fb01f103fb01f14fead1218df852104ff0000108bf0f21514359430024c90a002e8df853106ad00d994ff6fe7449440af10a0a4cea07284eea052b4ff0000cc0f203040d9104e010990cf1010c8c455ed01af80c104a1e1f2af5d34ab2202a4bdb0d9a02eb810111f8802c11f87f3c11f87e7c11f87d1c42ea032242ea074242ea0165a54238d819f805104ff0ff34a9b309eb050253788bb34ff6fe7402f1020e03fb01f60023c0f2030406e000bf0121be4221d3f61b0b44c5d05a19a2421bd00eeb03010f783f09f1d1671eba4213d04f781fb10221be42ecd20de00527cff6fc773a44042a07d38a78c97852ea012702d00421be42ddd24ff0ff34204615b0bde8f08f4ff0ff3015b0bde8f08f0c990122063100910f99002601f0100182ea1111cde9071a1af806101f2908d84144109f0b3901360024be428846f3d1dde7d0f86c214ff0ff34002ad7d00d9b03eb810111f8803c11f87f7c11f87e5c11f87d1c43ea072343ea054343ea01614ff6fe73c0f203039942c0d812f801e0bef1000fbbd053185f78002fb7d007fb0ef2ddf83890002acde9027600f0ac819d1c00244ff6fe736618c0f203039e42a3d02f193b781b0901d0012718e04ff6fe73c0f20303013b9e4296d07b780bb102270de00523cff6fc733344042bfff48cafbb78ff7853ea07233ff486af04279a42fff482afd21a3c44d3d1002c00f07b81002100220f91cde9054509e0dde90a12059c0a44ddf820a0069da24280f06b81a95c0b920e0901d0012212e0a71a012f00f06181ab185e780eb1022209e0042fc0f059819f78db7857ea032600f0538104220a9211f00f0111aa525c18bf0121079b0f9c19434fea021a16f00305a446099600f08c80b4fbfef7002607fb1e434344b3f1ff3fc8bf01260e40012e1fd117eb0b071cd4de09042e19d87e090e2e16d807eb870709eb871c5e081cf80670db076ff00f03019708bf0f230495154608bf5546019f3b402b43049d0cf80630012d04f1010c5ad0bcfbfef6002706fb1ec34344b3f1ff3fc8bf01270f40012f1fd116eb0b071cd4de09042e19d87e090e2e16d807eb870709eb871c5e081cf80670db076ff00f03019708bf0f230495154608bf5546019f3b402b43049d0cf80630022d04f1020c29d0bcfbfef5002705fb1ec34344b3f1ff3fc8bf01270f40012f1ad115eb0b0717d4de09042e14d87e090e2e11d807eb870709eb87175e08db0717f806c06ff00f03154604bf0f23554603ea0c032b43bb5504f1030c099d6b1e032b2c440f9407d237e700bf0f9b0cf1040c63453ff431afbcfbfef5002605fb1ec34344b3f1ff3fc8bf01260e40012e1bd115eb0b0518d4de09042e15d86e090e2e12d805eb850509eb85155e08db07af5d6ff00f03914604bf0f23d1463b4043ea0903ddf83890ab550cf10103b3fbfef5002605fb1e334344b3f1ff3fc8bf01260e40012e18d115eb0b0515d4de09042e12d86e090e2e0fd805eb850509eb85155e08db07af5d6ff00f03144604bf0f2354463b402343ab550cf10203b3fbfef5002405fb1e334344b3f1ff3fc8bf01240c40012c18d115eb0b0515d4dc09042c12d86c090e2c0fd805eb850409eb84145d08db07665d6ff00f03174604bf0f23574633403b4363550cf10303b3fbfef5002405fb1e334344b3f1ff3fc8bf01240c40012c7ff471af15eb0b053ff56dafdc09042c3ff669af6c090e2c3ff665af05eb850409eb84145d08db07665d6ff00f03174604bf0f23574633403b43635553e7029a08eb0e010beb0203b1f5207f0d4628eae872a8bf4ff42075b3f5f07fa8bf4ff4f07395421edd039e109f5b457ff606aeddf830e0def800400f2c3ff6ffada3eb0b0c009ba5eb020803ebc40523f83420621ca5f802b0a5f80480a5f806c0cef80020ebe5039e109fe8e5062a3cbf4ff0ff3070472de9f04fadf2944d9a46154688460f90fbf7fbfe002800f0d68098f80510881d854240f0298446f6ac10c2f20700d0f800b0bbf1000f00f01f849bf80c009bf80d209bf80e309bf80f7040ea022040ea034040ea0769a9f1810010f1800f4ff0ff30c0f0b2809bf810209bf811309bf8137042ea03229bf8123042ea034242ea07620692813a12f5817f40f29e800029cdf828b000f09d8008f1060b002426aa4ff4e01c00270ae000bf05f1004042f8240001378f4204f1010480f08e801bf80750681e1e28f0d968b21f2801dd012075e0a5f1c2000beb07061d28a1eb07000fd8012800f0c88396f9010010f1410f00f3c28300f03f0365f38a1302201d465de005f0f003e02b24d10328c0f0b48396f9013013f1410f00f3ae8396f9020010f1410f00f3a883e02ddeb202d1a02ec0f0a283ed2d02d19f2e00f29d832b039bb206f03f0643ea861300f03f001d18032034e004284ff0ff3036d3a5f1f50313f1050f31d396f9013013f1410f2cdc96f9020010f1410f00f37e8396f9036016f1410f00f37883f02ddbb202d1902bc0f07283f42d02d18f2b00f26d830cea854e03f03f054eea053300f03f0043ea801006f03f0326aac518042000bf074442f8245076e74ff0ff300df2944dbde8f08f0021012007915ee0002c57d0a4f1010bcdf86090cdf810a000250df1780a5f46914608e026aaab4505f1010509f10409a7f1010739d052f825100029f3d400202b4687421dd009eb80067268b2f1ff3f18dc5a1c934514d0b268b2f1ff3f11dc9a1c93450dd0f268b2f1ff3f0adcda1c934506d032690433002a00f10400e0d400e000220a9853461aae009601f0ecf8002800f008831a980028c3d046f2a1415046c0f24e018847bce7ddf810a0ddf828b0ddf860900020079404e00020ddf828b00790012098f804400f21a20604f00f0501eae271694389225143c90a8df8681001260e2198f800c098f801e098f8023098f8037014f0200f08bf0e2608bf012105fb01f102fb01f14fead1218df869104ff00d0108bf022105fb01f102fb01f14fead1218df86a104ff00c0108bf032105fb01f102fb01f14fead1218df86b104ff00b0108bf042105fb01f102fb01f14fead1218df86c104ff00a0108bf052105fb01f102fb01f14fead1218df86d104ff0090108bf062105fb01f102fb01f14fead1218df86e104ff0080108bf072105fb01f102fb01f14fead1218df86f104ff0070108bf082105fb01f102fb01f14fead1218df870104ff0060108bf092105fb01f102fb01f14fead1218df871104ff0050108bf0a2105fb01f102fb01f14fead1218df872104ff0040108bf0b2105fb01f102fb01f14fead1218df873104ff0030108bf0c2105fb01f102fb01f14fead1218df874104ff0020108bf0d2105fb01f102fb01f14fead1218df8751006fb05f102fb01f14fead1218df876104ff0000108bf0f2169435143c90a00284ff000008df877107ff4cdae43ea0720079a484403904cea0e290af10600571e00260df198080190cdf810a0029718e000bf46f2a1411ea8c0f24e0188479df87c009df87d10dde90ab9029fdde9072640ea01200df1980801369642814400f0ff8158f82610b1f1ff3f1edd33469f421fd008eb83004268b2f1ff3f1adc0133bb4216d08268b2f1ff3f13dc0133bb420fd0c268b2f1ff3f0cdc0133bb4208d002690133002ae2d404e001f01f000b38d2e7002258461eab19ad009500f0abff002800f0c781199900290d9100f0ba819df880209df881309df87e009df87f1052ea03259df8822040ea01279df8833010979df884704fea024208969df8856042ea0362069b4fea074747ea06672b4403eb2743039fcdf82c90a7eb030609eb22491aaf149500f05e810902109b014400f0030809f101004ff0010c099009f102000ceb530305900d980c934b1e0e930b9b0130121415900ceb510003eb020e9a1acde91180a1eb08001890d0074ff0000a17904feace70169013960ae014980af1010a824512981599139e0144159100f029810aeb06014b090e2befd810980028ecd00e9801eb810103280f984ff0000600eb811e80f0848011980028ded0dde90c105feac67c0afb01084fea560018f8000000f00f03c1b208bf0b09b3fa83f0400910ea141f14d106eb0901c80904280fd848081ef80020fb5c02f00f0b02f0f0021a431aafc90708bf4bea03120ef8002011980128b1d0701c400818f80000bcf1000fc1b24fea111308bf00f00f03d8b2b0fa80f0400910ea141f14d109983118c80904280fd848081ef80020fb5c02f00f0b02f0f0021a431aafc90708bf4bea03120ef80020119802283ff486afb01c400818f80000bcf1000f00f00f01c2b208bf1109b1fa81f0400910ea141f7ff474af05983318d80904283ff66eaf58081ef80020795c02f00f0602f0f0020a43db0708bf46ea01120ef800205de7ddf8548007e000bf18980436b04208f102083ff471af18f8011c0023c9b2102938bf012313ea141f09eb060c16d14feadc13042b12d84fea5c0309091ef80320795c02f00f0b02f0f0020a431aaf5feac97008bf4bea01120ef8032018f8010c00f00f01b1fa81f0400910ea141f15d10cf10103d809042810d858081ef80020795c02f00f03179d43ea011302f0f002002d08bf42ea01030ef8003098f80000c1b210294ff0000038bf012010ea141f15d10cf10203d809042810d8080959081ef80120385c02f00f0302f0f002169d0243002d08bf43ea00120ef8012098f8000000f00f01b1fa81f0400910ea141f8ad10cf10303d80904283ff685af58081ef80020795c02f00f03179d43ea011302f0f002002d08bf42ea01030ef8003072e700bf109809eb00011498b1f5207f06eb000229eae970a8bf4ff42071b2f5f07fa8bf4ff4f072ddf810a081427ff70fae26eae6739a427ff70aaedaf800700f2f3ff605ae019dd21a091a05ebc70625f83700781c7380b180f280caf80000f6e59df87c009df87d10079a40ea012001e64ff0ff300df2944dbde8f08f00200df2944dbde8f08f2de9f04f83b04ef66c654ff2a8464ff6245948f2c73bccf2ff05c2f229064ff6ff77cff6ff7900244ff0010ac0f2450b029002e0bff32f8fd847d6f80080bff35f8f3068bff35f8f01466ff39601b1f1005f03d10168a94200f0a8804ff43770fcf7e4f9002800f0d280494642183d3182f8dc4282f8dd4282f8de4282f8df4282f8e04282f8e14282f8e24282f8e34282f8e44282f8e54282f8e64282f8e74282f8e84282f8e94282f8ea4282f8eb4282f8ec4282f8ed4282f8ee4282f8ef4282f8f04282f8f14282f8f24282f8f34282f8f44282f8f54282f8f64282f8f74282f8f84282f8f94282f8fa4282f8fb4282f8fc4282f8fd4282f8fe4282f8ff4282f8004382f8014382f8024382f8034382f8044382f8054382f8064382f8074382f8084382f8094382f80a4382f80b4382f80c4382f80d4382f80e4382f80f4382f8104382f8114382f8124382f8134382f8144382f8154382f8164382f8174382f8184382d1056080f80aa08783c783078447848784c784078547858785c785078647868786c7860787478756e8001f41457ff44fafbff35f8f00bf46e8000121b156e8001f4145f8d043e70446fef757f9002c18bf002805d102990120487103b0bde8f08fc4f8600101254ff4f07084f8645101904ff4207049f683570090c0f2470700200021002200230026b84740b184f864610298c4f86061457103b0bde8f08f0298057103b0bde8f08f0024cde700bf2de9f04f87b0dde91065924643ea0102ddf848b02a43d20722d14fea550800eb510900eb5304abf1010700252846564588bf384600eb0a01304401eb810100eb800009eb811104eb80104246f6f7f2ff013f781c05f10105e8d107b0bde8f08f4ff6fc722a4005f0030406926a1e002701920494cde902a005e000bf059f039801375f45e9d0fa435645059788bf0beb020707eb0a0202eb820200eb821cba1902eb8202042d00eb821e4ff00008c0f09c80ddf8049000bf40468b4288bf484600eb010200eb03044fea52001cf800706ff0010088ea000608f1010088bfa8196ff0020686ea080608f1020b88bf05eb060b6ff0030686ea080608f1030a4feac27288bf05eb060a07f00f06002a4fea540208bf3e091ef80270e40707f00f0407f0f007374408bf44ea06170ef80270421854081cf804401844d20704f00f064fea500208bf26091ef80240c00704f00f0004f0f004344408bf40ea06140beb01000ef8024042081cf802200beb0304c00702f00f064fea540008bf16091ef80020e40702f00f0402f0f002324408bf44ea06120ef800200aeb010042081cf802200aeb0304c00702f00f064fea540008bf16091ef80020e40702f00f0402f0f002324408bf44ea06120ef80020069808f104088045a9f104097ff46dafddf808a0109eddf848b0049c002c3ff446af6fea080047468b4288bf2f18781842081f441cf80220c0074fea57091ef8090002f00f0408bf140900f00f0200f0f0002044ff0708bf42ea0410049c0ef80900012c3ff423af08f10102a5eb08098b4288bfa9f102025418670802eb030ae4074fea5a041cf807701ef8042007f00f0002f00f0b02f0f00208bf380902445feaca77ddf808a008bf4bea00120498109eddf848b00ef80420049c02283ff4f6ae08f102008b4288bfa9f10300421854081cf8047000eb030cd2074fea5c021ef8020007f00f0400f00f0800f0f00008bf3c0920445feacc7708bf48ea0410049c0ef80200d2e600bf2de9f04f83b04ef66c664ff2a8474ff6245a48f2c738ccf2ff06c2f229074ff6ff74cff6ff7a00254ff0010bc0f24508cde9010103e000bfbff32f8fc047d7f80090bff35f8f3868bff35f8f01466ff39601b1f1005f03d10168b14200f0a8804ff43770fbf76cff002800f00581514642183d3182f8dc5282f8dd5282f8de5282f8df5282f8e05282f8e15282f8e25282f8e35282f8e45282f8e55282f8e65282f8e75282f8e85282f8e95282f8ea5282f8eb5282f8ec5282f8ed5282f8ee5282f8ef5282f8f05282f8f15282f8f25282f8f35282f8f45282f8f55282f8f65282f8f75282f8f85282f8f95282f8fa5282f8fb5282f8fc5282f8fd5282f8fe5282f8ff5282f8005382f8015382f8025382f8035382f8045382f8055382f8065382f8075382f8085382f8095382f80a5382f80b5382f80c5382f80d5382f80e5382f80f5382f8105382f8115382f8125382f8135382f8145382f8155382f8165382f8175382f8185382d1066080f80ab08483c483048444848484c484048544858485c485048644868486c4860487448757e8001f49457ff44fafbff35f8f00bf47e8000121b157e8001f4945f8d043e7019a029b01210172b2b3014631f81c2f9a422cd0c28b9a4229d0028c9a4226d0428c9a4223d0828c9a4220d0c28c9a421dd0028d9a421ad0428d9a4217d0828d9a4214d0c28d9a4211d0028e9a420ed0428e9a420bd0828e9a4208d0c28e9a4205d0028f9a4202d0428f9a4208d10121817603b0bde8f08f417203b0bde8f08f427a72b98288029b9a1a13b2b3f1ff3f05dd92b2022a24bf0122427601e00122027600224272029ac38882809a4284bf029ac28090f83c20029b21f81230511c01f00f0180f83c1003b0bde8f08f00bf2de9f04f89b0129f029003fb07f000294fea400b069300f0d58100200890029807924ff0010a4ff000084ff0000e002400264ff0000c0022009107e04ff0000c03244e4601328a4200f0c181bcf1000f40f0bb8110f80290022cefd0012c15d0ddf81cc0129b002c554640f095805fea191409f00f070596089700f09b80a34580f0a1804ff0010c002499e1ddf81cc0129bb9f1000f00f08980cb45c0f0828008980392069a5546abeb090b00eb001700010596cdf810b0019016e010f80810089e01f0f001314300f8081008f10108a9f101090125904524bf4ff000080ef1010eb9f1000f00f062819e4580f05a810eeb8e00002d0ceb8010dfd0a2eb0801b1eb590f88bf4fea590169b38c0800eb080b1cd000220bf10106a2eb840a6ff0030c00bf06eb0c020cf1040c0aeb0c040434d770177157719771f3d10cf10406dde9062c129b11f0030404d10ce0002611f0030408d0012c0bf8067004d05e44022c777018bfb770a9eb4109b9f1000f88440dd09045aed210f80810019c01f00f012143a9f10109002500f80810a8e74ff000099fe700bf56ea09260ed0b34580f088804ff0010c00244be74ff0000c022447e74ff0000c012401e14ff0010c002400263ee708980392069aabeb040b00eb00170001cdf810b0019015e000bf1af80800089900f0f00008440af8080008f10108013c0125904524bf4ff000080ef1010e002c00f0d2809e4580f0ca800eeb8e00002d0ceb801ae1d0a2eb0800b0eb540f88bf600880b381080aeb08091ed00022ab4609f10106a2eb81016ff0030c00bf06eb0c020cf1040c01eb0c050435d770177157719771f3d10cf10401dde9062c129b5d4610f0030604d10de0002110f0030609d0012e09f8017005d04944022e4f7018bf8f7000bfa4eb400480446cb19045afd21af80800019900f00f000843013c00250af80800aae700bf0024a1e708980392069aabeb060b314600eb00170001cdf810b00190059613e01af80800089e00f0f00030430af8080008f1010801390125904524bf4ff000080ef1010e00295ad09e4553d20eeb8e00002d0ceb801ae3d0a2eb0800b0eb510f88bf480880b384080aeb08091ed00022ab4609f10106a2eb84046ff0030c00bf06eb0c020cf1040c04eb0c050435d770177157719771f3d10cf10406dde9062c129b5d4610f0030404d10de0002610f0030409d0012c09f8067005d04e44022c777018bfb77000bfa1eb4001804479b19045b1d21af80800019c00f00f002043013900250af808000029add107e000bf0021a1e7aa464ff0010c002403e0aa4600244ff0000c0df1080b00999be80508059e3fe60120012106e04ff0010cb4fa84f08cf001014009bbfa8bf252091140084009b0bde8f08f014640f258304cf20732c2f20000c0f248021047b0b54ff2ac44c2f229040146206846f23f52c5f28802b2eb500f40f258304cf2e9124cf67e25c2f20000c0f24802caf2101518bf25609047002804bf691c2160b0bd00bf2de9f04188b046f24f461c46c0f24e0613460a46ddf83880002706f1ae05214627706770a770e77027716771a771e77127726772a772e77227736773a773e77327746774a774e77427756775a775e77527766776a776e77627776777a777e777a8470028c8f800705cd020786178a278e3780843104318434ff0010008d0e179a27911431ebf617a227a51ea020102d108b0bde8f081a07b14284ff00000f7d1217d8df8040041f0010121758df805008df806008df807008df808008df809008df80a008df80b008df80c008df80d008df80e008df80f008df810008df811008df812008df813008df814008df815008df816008df817008df818008df819008df81a008df81b008df81c008df81d008df81e008df81f0001a92046b047c8f8000018b1012008b0bde8f08106f1520120468847d8f80000002818bf012008b0bde8f081f0b500294ff6ff7e00f0af80012903d10022c90775d1a8e021f00102c2f1000c6ff0010241f221038418a578e7788eea05252cb26e0036b203ead43484ea450503ead6366c0086ea450624b275002db203ead43484ea460603ead535740085ea460624b275002db203ead43484ea460603ead535740085ea460624b275002db203ead43484ea460603ead53585ea460686ea07273eb27d002db203ead63686ea470703ead5357e0085ea470736b27d002db203ead63686ea470703ead5357e0085ea470736b27d002db203ead63686ea470703ead5357e0085ea470736b27d002db203ead636023286ea470703ead5360ceb0205023586ea470e95d10232c90733d0805c41f221038eea002001b2420012b203ead13181ea400003ead232410082ea400009b2420012b203ead13181ea400003ead232410082ea400009b2420012b203ead13181ea400003ead232410082ea400009b2420012b203ead13181ea400003ead23181ea400e1ffa8ef0f0bd2de9f04fcbb00646c07c8b468df80600b08954998df80700000a8df808008df80a10080af1898df80b00080a17468df80d000020012b8df805308df809b08df80c108df80e008df80f008df810008df811008df812008df813008df814008df815008df816008df817008df818008df819008df81a008df81b008df81c008df81d008df81e008df81f008df820008df821008df822004cd1307e96f81780a0f1090144f62510c2f29240a1fb0002891a02eb510100970df10500b8eb910f88bf4fea9108c8ebc80706f11a0400f1010a00f10509093021463a46f6f739f906f1210506f1280029460722f6f731f9284621460722f6f72cf920465146032207f10905f6f725f906f11d0049460422f6f71ff9f07d02289cbf0130f075009fbb450cd0b8f1240f13d94ff0ff304bb0bde8f08fbb454ff00905f07509d14df22d77abb20df10502c0f247070120f02115e002200df12304aab28df82300a01c0df105018df82470f6f7f3f8a81c4af28d5782b2c0f24607f02021460023b8474bb0bde8f08f2ab1a2fb0103002b1cbf0020704702fb01f0b7e50846abe570b50446d0f83c0142f665360d46c0f2440668b94af2d550cff6ff707844002122460023b0470028c4f83c0108bf70bd06f594718847d4f83c0106f1e8022946bde87040104700bf2de9f04f81b0934612788ab1022300bf0beb030717f8012c62b11bf8032062b17a784ab1ba780433002af1d1023b04e0002205e0013b00e0013303eb4302520042eae272931c02f1010c01eb810203f0030e23f0030a00eb8213a3f5a0784ff0ff3906e009f10109b9f10d0f08f5a0786bd009eb010202eb8202bcf1030f00eb821605d24ff0ff34bef1000f2ed1e9e70024474604e000bfa24507f1020721d0621cd209042a03d83a7802f0f0023a70a21cd209042a03d87a7802f00f027a70e21cd209042a03d87a7802f0f0027a700434e209042adfd86208b55c05f00f05b554d9e7013cbef1000fbbd0a21cd509042d08d85208b55ce7076ff00f0708bf0f273d40b554bef1010fabd0e21cd509042d09d85208b55ce7074ff00f0708bf6ff00f073d40b554bef1020f9ad0221dd509042d96d85208e407b55c6ff00f0408bf0f242c40b4548ce79bf80010cdf800b0002900f0ce80022041f2410a41f2420b41f2430808e0009a063012f8011f03330029009200f0bd80a1f17f0717f15f0ff1d340f65c42c0f2000201eb41017a4402eb81014ff20014a1f5c079cff6ff7402e014f52074ded0494619f9027bc509042d09d8b7f1ff3f06dc1a1992f8016f46f0f00682f8016f5ffa87fe5fea4e6208d5042d06d81a1992f8017f47f00f0782f8017f5fea8e620ad540f27d22904206d81a1992f8027f47f0f00782f8027f5feace6209d5b0f51f7f06d81a1992f8027f47f00f0782f8027f5fea0e724fea900c09d5bcf19e0f06d81a1992f8036f46f0f00682f8036f5fea4e720ad540f27a22904206d81a1992f8037f47f00f0782f8037f91f90110042d09d8b1f1ff3f06dc1a1912f80a7047f0f00702f80a70c9b24a0608d5042d06d81a1912f80a7047f00f0702f80a708a060ad540f27d22904206d81a1912f80b7047f0f00702f80b70ca0609d5b0f51f7f06d81a1912f80b7047f00f0702f80b700a0709d5bcf19e0f06d81a1912f8087047f0f00702f8087049077ff565af40f27a2188423ff660af191911f8082042f00f0201f8082057e701b0bde8f08f00bf2de9f04f81b0134681464a1c00f08f808e0a4ff0000b19f80b20002a00f0888109eb0b077a78002a00f00a81ba78002a00f00981fa78002a00f008813a79002a00f007817a79002a00f00681ba79002a00f00581fa79002a00f004813a7a002a00f003817a7a002a00f00281ba7a002a00f00181fa7a002a00f000813a7b002a00f0ff807a7b002a00f0fe80ba7b002a00f0fd80fa7b002a00f0fc803a7c002a00f0fb807a7c002a00f0fa80ba7c002a00f0fb80fa7c002a00f0fc803a7d002a00f0fd807a7d002a00f0fe80ba7d002a00f0ff80fa7d002a00f000813a7e002a00f001817a7e002a00f00281ba7e002a00f00381fa7e002a00f004813a7f002a00f005817a7f002a00f00681ba7f002a00f00781fa7f002a00f008810bf1200bbbf1600f7ff477af4ff0600b00e1002119f80120002a00f0af8109eb01056a78002a00f0b080aa78002a00f0b180ea78002a00f0b2802a79002a00f0b3806a79002a00f0b480aa79002a00f0b580ea79002a00f0b6802a7a002a00f0b7806a7a002a00f0b880aa7a002a00f0b980ea7a002a00f0ba802a7b002a00f0bb806a7b002a00f0bc80aa7b002a00f0bd80ea7b002a00f050812a7c002a00f04e816a7c002a00f04c81aa7c002a00f04a81ea7c002a00f048812a7d002a00f046816a7d002a00f04481aa7d002a00f04281ea7d002a00f040812a7e002a00f03e816a7e002a00f03c81aa7e002a00f03a81ea7e002a00f038812a7f002a00f036816a7f002a00f03481aa7f002a00f03281ea7f002a00f03081203160297ff479af32e10bf1010b74e00bf1020b71e00bf1030b6ee00bf1040b6be00bf1050b68e00bf1060b65e00bf1070b62e00bf1080b5fe00bf1090b5ce00bf10a0b59e00bf10b0b56e00bf10c0b53e00bf10d0b50e00bf10e0b4de00bf10f0b4ae00bf1100b47e00bf1110b44e00131f6e00bf1120b3fe00231f1e00bf1130b3ae00331ece00bf1140b35e00431e7e00bf1150b30e00531e2e00bf1160b2be00631dde00bf1170b26e00731d8e00bf1180b21e00831d3e00bf1190b1ce00931cee00bf11a0b17e00a31c9e00bf11b0b12e00b31c4e00bf11c0b0de00c31bfe00bf11d0b08e00d31bae00bf11e0b03e00e31b5e00bf11f0bb1f5205f4ff0010100931fd364234ff47a7442f2107700bf01eb81025200b6fbf2f50a2d11d301fb03f2b6fbf2f50a2d0bd301fb04f2b6fbf2f50a2d05d37943b6fbf1f2092ae7d800e011465846bbf15f0f98bf5f20c0f1000c1ceb0b0a53d0b6fbf1f74cf6cd4207f13003ccf6cc4209f80b300a29a1fb023547d31af1010342d007fb11674fead508b7fbf8fe48f21f520ef1300309eb0b06c5f2eb1273706429a1fb023434d31af102032cd00efb18776409b7fbf4f544f6d35205f13003c1f26202b370b1f57a7fa1fb022323d31af1030218d005fb14729b0941f25975b2fbf3f7cdf2b715a1fb055407f13005f57007fb132642f210720bf1040b91424fea5431a9d209e0834607e00bf1010b04e00bf1020b01e00bf1030b0020009b09f80b002de00f311ee010311ce011311ae0123118e0133116e0143114e0153112e0163110e017310ee018310ce019310ae01a3108e01b3106e01c3104e01d3102e01e3100e01f315f2904d849444ff03f020a7003d1002189f85f1001e000204870002119f80100002800f0a18009eb0105687800285ed0a87800285dd0e87800285cd0287900285bd0687900285ad0a879002859d0e879002858d0287a002857d0687a002856d0a87a002855d0e87a002854d0287b002853d0687b002852d0a87b002851d0e87b002850d0287c00284fd0687c00284ed0a87c00284dd0e87c00284cd0287d00284bd0687d00284ad0a87d002849d0e87d002848d0287e002847d0687e002846d0a87e002845d0e87e002844d0287f002843d0687f002842d0a87f002841d0e87f002840d0203160297ff498af44e001313ae0023138e0033136e0043134e0053132e0063130e007312ee008312ce009312ae00a3128e00b3126e00c3124e00d3122e00e3120e00f311ee010311ce011311ae0123118e0133116e0143114e0153112e0163110e017310ee018310ce019310ae01a3108e01b3106e01c3104e01d3102e01e3100e01f315f2905d849444ff02f00087040f09580002089f85f00581c00f094809d0a4ff0000e19f80e00002800f08d8109eb0e067078002800f00f81b078002800f00e81f078002800f00d813079002800f00c817079002800f00b81b079002800f00a81f079002800f00981307a002800f00881707a002800f00781b07a002800f00681f07a002800f00581307b002800f00481707b002800f00381b07b002800f00281f07b002800f00181307c002800f00081707c002800f0ff80b07c002800f00081f07c002800f00181307d002800f00281707d002800f00381b07d002800f00481f07d002800f00581307e002800f00681707e002800f00781b07e002800f00881f07e002800f00981307f002800f00a81707f002800f00b81b07f002800f00c81f07f002800f00d810ef1200ebef1600f7ff477af4ff0600e05e100204870581c7ff46caf002119f80100002800f0aa8109eb01025078002800f0b0809078002800f0b180d078002800f0b2801079002800f0b3805079002800f0b4809079002800f0b580d079002800f0b680107a002800f0b780507a002800f0b880907a002800f0b980d07a002800f0ba80107b002800f0bb80507b002800f0bc80907b002800f0bd80d07b002800f04b81107c002800f04981507c002800f04781907c002800f04581d07c002800f04381107d002800f04181507d002800f03f81907d002800f03d81d07d002800f03b81107e002800f03981507e002800f03781907e002800f03581d07e002800f03381107f002800f03181507f002800f02f81907f002800f02d81d07f002800f02b81203160297ff479af2de10ef1010e74e00ef1020e71e00ef1030e6ee00ef1040e6be00ef1050e68e00ef1060e65e00ef1070e62e00ef1080e5fe00ef1090e5ce00ef10a0e59e00ef10b0e56e00ef10c0e53e00ef10d0e50e00ef10e0e4de00ef10f0e4ae00ef1100e47e00ef1110e44e00131f1e00ef1120e3fe00231ece00ef1130e3ae00331e7e00ef1140e35e00431e2e00ef1150e30e00531dde00ef1160e2be00631d8e00ef1170e26e00731d3e00ef1180e21e00831cee00ef1190e1ce00931c9e00ef11a0e17e00a31c4e00ef11b0e12e00b31bfe00ef11c0e0de00c31bae00ef11d0e08e00d31b5e00ef11e0e03e00e31b0e00ef11f0e0122b3f5205f1ed364234ff47a7442f2107602eb82004100b5fbf1f00a2811d302fb03f1b5fbf1f00a280bd302fb04f1b5fbf1f00a2805d37243b5fbf2f00928e7d800e00a46f046bef15f0f98bf4ff05f08c8f1000c42f2107a1ceb0e074dd0b5fbf2f30a2a03f1300009f80e004cf6cd40ccf6cc40a2fb000641d3781c3dd003fb1253f608b3fbf6f409eb0e0504f13000687048f21f50c5f2eb10642aa2fb000130d3b81c29d004fb16334e09b3fbf6f4b2f57a7f04f13000a87044f6d350c1f26200a2fb000120d3f81c16d004fb1630890941f25974b0fbf1f3cdf2b714a2fb044603f13004ec7003fb11050ef1040e52454fea5632afd209e0c64607e00ef1010e04e00ef1020e01e00ef1030e002009f80e0001b0bde8f08f0f311ee010311ce011311ae0123118e0133116e0143114e0153112e0163110e017310ee018310ce019310ae01a3108e01b3106e01c3104e01d3102e01e3100e01f315f2904d849444ff03f00087005d1002089f85f0001b0bde8f08f0020487001b0bde8f08f434d01ffff0000000000000052420100ff00000008031000000000000000000046616365636c61772f31330000000000000000000000000000002020202020002020000000505050000000000000000000005050f85050f85050000000002070a8a07028a8702000000048a85010202854480000000020505020689090680000002020200000000000000000000010204040404020100000000040201010101020400000000000005020f82050000000000000002020f82020000000000000000000000020204000000000000000f800000000000000000000000000202000000000080810102020404000000000708898a8c88888700000000020602020202020700000000070888808102040f8000000007088083008088870000000000818284888f8080800000000f88080f00808887000000000708080f08888887000000000f808081010202020000000007088887088888870000000007088888878080870000000000000202000002020000000000000202000002020400000000008102040201008000000000000f80000f8000000000000004020100810204000000000708888102000202000000000708898a8a89880780000000070888888f888888800000000f08888f0888888f000000000708880808080887000000000e0908888888890e000000000f88080f0808080f800000000f88080f0808080800000000070888080b888887000000000888888f888888888000000007020202020202070000000003810101010909060000000008890a0c0c0a090880000000080808080808080f80000000088d8a8a888888888000000008888c8a89888888800000000708888888888887000000000f0888888f080808000000000708888888888a87008000000f0888888f0a0908800000000708880700808887000000000f8202020202020200000000088888888888888700000000088888850505020200000000088888888a8a8d88800000000888850202050888800000000888850502020202000000000f8081020408080f8000000007040404040404070000000004040202010100808000000007010101010101070000000205088000000000000000000000000000000000000f80040200000000000000000000000000000700878888878000000008080f088888888f00000000000007088808088700000000008087888888888780000000000007088f8808078000000001820702020202020000000000000788888888878087000008080f08888888888000000202000602020202070000000080800180808080808483000004040485060605048000000006020202020202070000000000000f0a8a8a8a8a8000000000000f08888888888000000000000708888888870000000000000f088888888f0808000000000788888888878080800000000b8c0808080800000000000007880700808f00000000020207020202020180000000000008888888888780000000000008888505020200000000000008888a8a8a870000000000000885020205088000000000000888888888878087000000000f810204080f800000000182020402020201800000000202020202020202000000000601010081010106000000048a8900000000000000000", + "new": "b0b581ea00039b0701d0034637e0c2b110f0030315d000f1010ca2f1010e0023cc5c9e45c45403f1010404d0634413f003032346f4d121440319121b102a14d302e00346102a10d3d1f800c0d1f804e0cc688d68103adc609d60c3f804e043f810cb0f2a01f11001eed8042a07d300bf51f8045b043a032a43f8045bf8d8002a08bfb0bd0139013b11f8015f013a03f8015ff9d1b0bd00bf884218bf002a00d1704710b50b1a38bf431a934207d288420ad281ea00039b0726d0034669e0fff79fffbde81040704781ea000300eb020c9b0701eb020e42d15fea8c732bd0a0f1010c00bf8b1813f801ec8418531e04f801ec04d0624412f003021a46f2d101eb030e00eb030c17e0830736d0a2f1010c00f1010e002300bfcc5c9c45c45403f1010404d0734413f003032346f4d1121b2144031922e01346042b0ed3aef10402acf1040152f80449043b032b41f80449f8d802f1040e01f1040c1a4653b1aef10101acf1010300bf11f80149013a03f80149f9d1bde8104070470346042a06d351f8044b043a032a43f8044bf8d8002af0d00139013b00bf11f8014f013a03f8014ff9d1e6e700bf2de9f04fa5b04ef66c6b4ff2a84416460d46ccf2ff0bc2f229044ff6ff7900274ff00108019006e048f2c731c0f24501bff32f8f8847d4f800a0bff35f8f20680321cff680710140b1f1005fbff35f8f03d10168594500f0bb804ff4377005f05ff8002800f0a1824ff62451cff6ff7142183d3182f8dc7282f8dd7282f8de7282f8df7282f8e07282f8e17282f8e27282f8e37282f8e47282f8e57282f8e67282f8e77282f8e87282f8e97282f8ea7282f8eb7282f8ec7282f8ed7282f8ee7282f8ef7282f8f07282f8f17282f8f27282f8f37282f8f47282f8f57282f8f67282f8f77282f8f87282f8f97282f8fa7282f8fb7282f8fc7282f8fd7282f8fe7282f8ff7282f8007382f8017382f8027382f8037382f8047382f8057382f8067382f8077382f8087382f8097382f80a7382f80b7382f80c7382f80d7382f80e7382f80f7382f8107382f8117382f8127382f8137382f8147382f8157382f8167382f8177382f8187382d1c0f800b080f80a80a0f81c90a0f81e90a0f82090a0f82290a0f82490a0f82690a0f82890a0f82a90a0f82c90a0f82e90a0f83090a0f83290a0f83490a0f83690a0f83890a0f83a9054e8001f51457ff436afbff35f8f44e8000121b154e8001f5145f8d02be7aa4645ea064100260127c0f8701206e048f2c731c0f24501bff32f8f88472568bff35f8f20680321cff680710140b1f1005fbff35f8f03d10168594500f0bc804ff4377004f084ff002800f0c6814ff62451cff6ff7100bf42183d3182f8dc6282f8dd6282f8de6282f8df6282f8e06282f8e16282f8e26282f8e36282f8e46282f8e56282f8e66282f8e76282f8e86282f8e96282f8ea6282f8eb6282f8ec6282f8ed6282f8ee6282f8ef6282f8f06282f8f16282f8f26282f8f36282f8f46282f8f56282f8f66282f8f76282f8f86282f8f96282f8fa6282f8fb6282f8fc6282f8fd6282f8fe6282f8ff6282f8006382f8016382f8026382f8036382f8046382f8056382f8066382f8076382f8086382f8096382f80a6382f80b6382f80c6382f80d6382f80e6382f80f6382f8106382f8116382f8126382f8136382f8146382f8156382f8166382f8176382f8186382d1c0f800b08772a0f81c90a0f81e90a0f82090a0f82290a0f82490a0f82690a0f82890a0f82a90a0f82c90a0f82e90a0f83090a0f83290a0f83490a0f83690a0f83890a0f83a9054e8001fa9427ff437afbff35f8f00bf44e8000121b154e8001fa942f8d02be7d0f8746242f6f767c0f24407002ebff35f8f00f0eb8007f19a0230464ff0ff314ff0ff379047002840f0418143f67750c0f24f00804700274ff001080397adf8107006e048f2c731c0f24501bff32f8f88472568bff35f8f20680321cff680710140b1f1005fbff35f8f03d10168594500f0e1804ff4377004f08efe002800f0d9804ff62451cff6ff7100bf42183d3182f8dc7282f8dd7282f8de7282f8df7282f8e07282f8e17282f8e27282f8e37282f8e47282f8e57282f8e67282f8e77282f8e87282f8e97282f8ea7282f8eb7282f8ec7282f8ed7282f8ee7282f8ef7282f8f07282f8f17282f8f27282f8f37282f8f47282f8f57282f8f67282f8f77282f8f87282f8f97282f8fa7282f8fb7282f8fc7282f8fd7282f8fe7282f8ff7282f8007382f8017382f8027382f8037382f8047382f8057382f8067382f8077382f8087382f8097382f80a7382f80b7382f80c7382f80d7382f80e7382f80f7382f8107382f8117382f8127382f8137382f8147382f8157382f8167382f8177382f8187382d1c0f800b080f80a80a0f81c90a0f81e90a0f82090a0f82290a0f82490a0f82690a0f82890a0f82a90a0f82c90a0f82e90a0f83090a0f83290a0f83490a0f83690a0f83890a0f83a9054e8001fa9427ff436afbff35f8f44e8000149b354e8001fa942f8d02be705460020b847b0b105f51d7151e8006f4eb9bff35f8f00bf41e8000292b151e8006f002ef8d00021bff32f8fbff35f8f21b10646f9e64ff0ff3742e007f5a9718847f2e60121f1e70020019d42f6f764002d4ff0010bc0f2440418bfbaf1000f33d10df108098046484602f07df903ab28465146012205f0d1fc9df8111007464846002918bf4ff0ff3702f0a3fabbf1000f044608d19df8100028b949f28340c0f247004c308047b8f1000f18bfc8f80c4042f6f764c0f2440404f5807130468847384625b0bde8f08f2a7802f07f01a1f1150313f1030f0bd802f07b030b2b07d002f07e02082a03d0032901d00629b7d140b149f28341c0f247010746884797f8641111b14ff0ff37d6e738464ff0000ba6e770b500284dd001684ef66c62ccf2ff02914218bf70bd90f8441090f8455046f6756c8d42c0f2510c2ad205eb8501014491f8492091f84a4091f846e091f8473091f8481042ea0424012c4ff0010298bf14466e1c054680f84560b9b164294eea032028bf6421012888bf024644f62060824228bf02460cf5e2731046984706e0002180f84410bde870406047e047286c38b142f64d42c0f244022146bde87040104770bd02464ff64b70cff6ff7042f6653c7844c0f2440c00210023604700bf2de9f04f9fb04ff2a840c2f229000668bff35f8f30466ff39600b0f1005f42d130684ef66c65ccf2ff05a8423bd196f8640130b3d6f860411cb340f6b400c2f20000076804a802f0a5f8002f00f06a8140f2030a384621464ff416320296cff6807a4ff6ff760397fff752fb4ff6245b48f2c738cff6ff7b00270124c0f245081ce096f8660170b1d6f8680140b146f68051c2f207010968401a002802f37080002086f8660140f6d100c0f247001fb0bde8f04f0047bff32f8fc0474ff2a840c2f22900d0f80090bff35f8f0068bff35f8f00ea0a01b1f1005f03d10168a94200f0aa804ff4377004f076fc002802f02f80594642183d3182f8dc7282f8dd7282f8de7282f8df7282f8e07282f8e17282f8e27282f8e37282f8e47282f8e57282f8e67282f8e77282f8e87282f8e97282f8ea7282f8eb7282f8ec7282f8ed7282f8ee7282f8ef7282f8f07282f8f17282f8f27282f8f37282f8f47282f8f57282f8f67282f8f77282f8f87282f8f97282f8fa7282f8fb7282f8fc7282f8fd7282f8fe7282f8ff7282f8007382f8017382f8027382f8037382f8047382f8057382f8067382f8077382f8087382f8097382f80a7382f80b7382f80c7382f80d7382f80e7382f80f7382f8107382f8117382f8127382f8137382f8147382f8157382f8167382f8177382f8187382d14ff2a842056084728683c683068446848684c684068546858685c685068646868686c68606874687c2f2290252e8001f49457ff449afbff35f8f42e8000121b152e8001f4945f8d03ee7817a002941f08887027e0021002a8df81c107cd04ff2a84507aac2f22905535c002b00f0b68053185f78002f74d09f78002f73d0df78002f72d01f79002f71d05f79002f70d09f79002f6fd0df79002f6ed01f7a002f6dd05f7a002f6cd09f7a002f6bd0df7a002f6ad01f7b002f69d05f7b002f68d09f7b002f67d0df7b002f66d01f7c002f65d05f7c002f64d09f7c002f63d0df7c002f62d01f7d002f61d05f7d002f60d09f7d002f5fd0df7d002f5ed01f7e002f5dd05f7e002f5cd09f7e002f5bd0df7e002f5ad01f7f002f59d05f7f002f58d09f7f002f57d0db7f002b56d0203160297ff49aaf76e0002086f86401c6f8600186f86601012086f8650140f6d100c0f24700804701f019bf4ff2a845c2f2290564e001313ae0023138e0033136e0043134e0053132e0063130e007312ee008312ce009312ae00a3128e00b3126e00c3124e00d3122e00e3120e00f311ee010311ce011311ae0123118e0133116e0143114e0153112e0163110e017310ee018310ce019310ae01a3108e01b3106e01c3104e01d3102e01e3100e01f315f2921d84ff0520353541dd00a4445235e29537018d04f235d29937014d052235c29d37010d044235b2913710cd045235a29537108d052235929937104d020235829d37141f0d68300218df87b100121427e002a00f0c280002207ab9f5c002f00f0a0809f187e78002e5ed0be78002e5dd0fe78002e5cd03e79002e5bd07e79002e5ad0be79002e59d0fe79002e58d03e7a002e57d07e7a002e56d0be7a002e55d0fe7a002e54d03e7b002e53d07e7b002e52d0be7b002e51d0fe7b002e50d03e7c002e4fd07e7c002e4ed0be7c002e4dd0fe7c002e4cd03e7d002e4bd07e7d002e4ad0be7d002e49d0fe7d002e48d03e7e002e47d07e7e002e46d0be7e002e45d0fe7e002e44d03e7f002e43d07e7f002e42d0be7f002e41d0ff7f002f40d02032602a7ff49aaf54e001323ae0023238e0033236e0043234e0053232e0063230e007322ee008322ce009322ae00a3228e00b3226e00c3224e00d3222e00e3220e00f321ee010321ce011321ae0123218e0133216e0143214e0153212e0163210e017320ee018320ce019320ae01a3208e01b3206e01c3204e01d3202e01e3200e01f325f2a15d84ff053079f5411d013444b275e2a5f700cd049275d2a9f7008d050275c2adf7004d020275b2a1f7140f0f08100228df87b200131827e002a00f0be80002107aa535c002b00f0a08053185f78002f5ed09f78002f5dd0df78002f5cd01f79002f5bd05f79002f5ad09f79002f59d0df79002f58d01f7a002f57d05f7a002f56d09f7a002f55d0df7a002f54d01f7b002f53d05f7b002f52d09f7b002f51d0df7b002f50d01f7c002f4fd05f7c002f4ed09f7c002f4dd0df7c002f4cd01f7d002f4bd05f7d002f4ad09f7d002f49d0df7d002f48d01f7e002f47d05f7e002f46d09f7e002f45d0df7e002f44d01f7f002f43d05f7f002f42d09f7f002f41d0db7f002b40d0203160297ff49aaf50e001313ae0023138e0033136e0043134e0053132e0063130e007312ee008312ce009312ae00a3128e00b3126e00c3124e00d3122e00e3120e00f311ee010311ce011311ae0123118e0133116e0143114e0153112e0163110e017310ee018310ce019310ae01a3108e01b3106e01c3104e01d3102e01e3100e01f315f2911d84ff0440353540dd00a4455235e29537008d050235d29937004d020235c29d37040f0098100218df87b1001216a6846f23f53c5f28803b3eb520f40f08b80d20700f08d80002107aa535c002b00f0858153185f78002f00f0f9809f78002f00f0f980df78002f00f0f9801f79002f00f0f9805f79002f00f0f9809f79002f00f0f980df79002f00f0f9801f7a002f00f0fc805f7a002f00f0fc809f7a002f00f0fc80df7a002f00f0fc801f7b002f00f0fc805f7b002f00f0fc809f7b002f00f0fc80df7b002f00f0fc801f7c002f00f0fc805f7c002f00f0fc809f7c002f00f0fc80df7c002f00f0fc801f7d002f00f0fc805f7d002f00f0fc809f7d002f00f0fc80df7d002f00f0fc801f7e002f00f0fc805f7e002f00f0fc809f7e002f00f0fc80df7e002f00f0fc801f7f002f00f00d815f7f002f00f00b819f7f002f00f00981db7f002b00f00781203160297ff47baf1de14cf67e22caf210126a60002940f01981002107aa535c002b00f0dc8053185f78002f61d09f78002f60d0df78002f5fd01f79002f5ed05f79002f5fd09f79002f60d0df79002f61d01f7a002f62d05f7a002f63d09f7a002f64d0df7a002f68d01f7b002f69d05f7b002f6ad09f7b002f6bd0df7b002f6cd01f7c002f6dd05f7c002f6ed09f7c002f6fd0df7c002f70d01f7d002f71d05f7d002f72d09f7d002f73d0df7d002f74d01f7e002f75d05f7e002f76d09f7e002f77d0df7e002f78d01f7f002f79d05f7f002f7ad09f7f002f7bd0db7f002b7cd0203160297ff49aaface000211171f6e6013173e0023171e003316fe004316de0013184e0053169e0023180e0063165e003317ce0073161e0043178e008315de0053174e0093159e0063170e00a3155e007316ce000225a710fe60b314ee0083165e00c314ae0093161e00d3146e00a315de00e3142e00b3159e00f313ee00c3155e010313ae00d3151e0113136e00e314de0123132e00f3149e013312ee0103145e014312ae0113141e0153126e012313de0163122e0133139e017311ee0143135e018311ae0153131e0193116e016312de01a3112e0173129e01b310ee0183125e01c310ae0193121e01d3106e01a311de01e3102e01b3119e01f315f2931d84ff04f0353542dd00a444b235e29537028d020235d29937024d00021d17024e01c3104e01d3102e01e3100e01f315f2918d84ff04103535414d00a444c235e2953700fd05d2993700cd04f235c29d37008d043235b29137104d020235a29537141f0948000218df87b1000210df11c0c1cf80120002a00f0a1800ceb01025378002b5ed09378002b5dd0d378002b5cd01379002b5bd05379002b5ad09379002b59d0d379002b58d0137a002b57d0537a002b56d0937a002b55d0d37a002b54d0137b002b53d0537b002b52d0937b002b51d0d37b002b50d0137c002b4fd0537c002b4ed0937c002b4dd0d37c002b4cd0137d002b4bd0537d002b4ad0937d002b49d0d37d002b48d0137e002b47d0537e002b46d0937e002b45d0d37e002b44d0137f002b43d0537f002b42d0937f002b41d0d27f002a40d0203160297ff498af43e001313ae0023138e0033136e0043134e0053132e0063130e007312ee008312ce009312ae00a3128e00b3126e00c3124e00d3122e00e3120e00f311ee010311ce011311ae0123118e0133116e0143114e0153112e0163110e017310ee018310ce019310ae01a3108e01b3106e01c3104e01d3102e01e3100e01f315f2904d84ff077020cf8012003d100218df87b1002e0614400224a70c2684ff0000e1cf80e10002900f0c4800ceb0e035978002962d09978002962d0d978002962d01979002962d05979002962d09979002962d0d979002962d0197a002962d0597a002962d0997a002962d0d97a002962d0197b002962d0597b002962d0997b002962d0d97b002962d0197c002962d0597c002962d0997c002962d0d97c002962d0197d002962d0597d002962d0997d002962d0d97d002962d0197e002962d0597e002962d0997e002962d0d97e002962d0197f002962d0597f002962d0997f002962d0d97f002962d00ef1200ebef1600f7ff496af4ff0600e5be00ef1010e58e00ef1020e55e00ef1030e52e00ef1040e4fe00ef1050e4ce00ef1060e49e00ef1070e46e00ef1080e43e00ef1090e40e00ef10a0e3de00ef10b0e3ae00ef10c0e37e00ef10d0e34e00ef10e0e31e00ef10f0e2ee00ef1100e2be00ef1110e28e00ef1120e25e00ef1130e22e00ef1140e1fe00ef1150e1ce00ef1160e19e00ef1170e16e00ef1180e13e00ef1190e10e00ef11a0e0de00ef11b0e0ae00ef11c0e07e00ef11d0e04e00ef11e0e01e00ef11f0e01230a2a1ed364274ff47a7642f2107503eb83014900b2fbf1f40a2c11d303fb07f1b2fbf1f40a2c0bd303fb06f1b2fbf1f40a2c05d36b43b2fbf3f10929e7d800e00b46f146bef15f0f98bf4ff05f09c9f1000818eb0e0b52d0b2fbf3f40a2b04f130010cf80e104cf6cd41ccf6cc41a3fb011646d31bf1010141d004fb1324f708b4fbf7fa0ceb0e020af13001517048f21f51c5f2eb11642ba3fb011634d31bf102012cd00afb17447709b4fbf7f6b3f57a7f06f13001917044f6d351c1f26201a3fb015123d31bf1030518d006fb1744890941f25976b4fbf1f5cdf2b716a3fb066705f13006d67005fb114242f210710ef1040e8b424fea5733aad209e0ce4607e00ef1010e04e00ef1020e01e00ef1030e0022e3460cf80e201bf80210002900f0a1800beb02014b78002b5ed08b78002b5dd0cb78002b5cd00b79002b5bd04b79002b5ad08b79002b59d0cb79002b58d00b7a002b57d04b7a002b56d08b7a002b55d0cb7a002b54d00b7b002b53d04b7b002b52d08b7b002b51d0cb7b002b50d00b7c002b4fd04b7c002b4ed08b7c002b4dd0cb7c002b4cd00b7d002b4bd04b7d002b4ad08b7d002b49d0cb7d002b48d00b7e002b47d04b7e002b46d08b7e002b45d0cb7e002b44d00b7f002b43d04b7f002b42d08b7f002b41d0c97f002940d02032602a7ff498af52e001323ae0023238e0033236e0043234e0053232e0063230e007322ee008322ce009322ae00a3228e00b3226e00c3224e00d3222e00e3220e00f321ee010321ce011321ae0123218e0133216e0143214e0153212e0163210e017320ee018320ce019320ae01a3208e01b3206e01c3204e01d3202e01e3200e01f325f2a13d84ff075010bf802100ed00beb020173235e2a4b7008d020235d2a8b7004d070235c2acb7040f09d8000218df87b1002694ff000081bf80810002900f0c7800beb08035978002962d09978002962d0d978002962d01979002962d05979002962d09979002962d0d979002962d0197a002962d0597a002962d0997a002962d0d97a002962d0197b002962d0597b002962d0997b002962d0d97b002965d0197c002965d0597c002965d0997c002965d0d97c002965d0197d002965d0597d002965d0997d002965d0d97d002965d0197e002965d0597e002965d0997e002965d0d97e002965d0197f002965d0597f002965d0997f002965d0d97f002965d008f12008b8f1600f7ff496af4ff060085ee008f101085be008f1020858e008f1030855e008f1040852e008f105084fe008f106084ce008f1070849e008f1080846e008f1090843e008f10a0840e008f10b083de008f10c083ae008f10d0837e008f10e0834e000220a7162e708f10f082ee008f110082be008f1110828e008f1120825e008f1130822e008f114081fe008f115081ce008f1160819e008f1170816e008f1180813e008f1190810e008f11a080de008f11b080ae008f11c0807e008f11d0804e008f11e0801e008f11f0801230a2a1ed364274ff47a7642f2107503eb83014900b2fbf1f40a2c11d303fb07f1b2fbf1f40a2c0bd303fb06f1b2fbf1f40a2c05d36b43b2fbf3f10929e7d800e00b46c646b8f15f0f98bf4ff05f0ecef1000a42f2107c1aeb080950d0b2fbf3f40a2b04f130010bf808104cf6cd41ccf6cc41a3fb011644d319f101013fd004fb1324f708b4fbf7f60beb080206f13001517048f21f51c5f2eb11642ba3fb015132d319f102052ad006fb17444e09b4fbf6f7b3f57a7f07f13001917044f6d351c1f26201a3fb015121d319f1030516d007fb1644890941f25976b4fbf1f5cdf2b716a3fb066705f13006d67005fb114208f1040863454fea5733acd209e0f04607e008f1010804e008f1020801e008f10308039f00220bf808201bf80210002900f0a1800beb02014b78002b5ed08b78002b5dd0cb78002b5cd00b79002b5bd04b79002b5ad08b79002b59d0cb79002b58d00b7a002b57d04b7a002b56d08b7a002b55d0cb7a002b54d00b7b002b53d04b7b002b52d08b7b002b51d0cb7b002b50d00b7c002b4fd04b7c002b4ed08b7c002b4dd0cb7c002b4cd00b7d002b4bd04b7d002b4ad08b7d002b49d0cb7d002b48d00b7e002b47d04b7e002b46d08b7e002b45d0cb7e002b44d00b7f002b43d04b7f002b42d08b7f002b41d0c97f002940d02032602a7ff498af4ae001323ae0023238e0033236e0043234e0053232e0063230e007322ee008322ce009322ae00a3228e00b3226e00c3224e00d3222e00e3220e00f321ee010321ce011321ae0123218e0133216e0143214e0153212e0163210e017320ee018320ce019320ae01a3208e01b3206e01c3204e01d3202e01e3200e01f325f2a0bd84ff075010bf8021006d00beb020173235e2a4b7040f08780044600208df87b00384602215a4608f0c4f8d4f870c272208df81c0078208df81d0020204ff000091ffa8cf28df81e008df81f901bf80900002800f0c8800beb09035878002866d09878002866d0d878002866d01879002866d05879002866d09879002866d0d879002866d0187a002866d0587a002866d0987a002866d0d87a002866d0187b002866d0587b002866d0987b002866d0d87b002866d0187c002866d0587c002866d0987c002866d0d87c002866d0187d002866d0587d002866d0987d002866d0d87d002866d0187e002866d0587e002866d0987e002866d0d87e002866d0187f002866d0587f002866d0987f002866d0d87f002866d009f12009b9f1600f7ff496af4ff060095fe004460020887078e709f1010958e009f1020955e009f1030952e009f104094fe009f105094ce009f1060949e009f1070946e009f1080943e009f1090940e009f10a093de009f10b093ae009f10c0937e009f10d0934e009f10e0931e009f10f092ee009f110092be009f1110928e009f1120925e009f1130922e009f114091fe009f115091ce009f1160919e009f1170916e009f1180913e009f1190910e009f11a090de009f11b090ae009f11c0907e009f11d0904e009f11e0901e009f11f0901230a2a1ed364274ff47a7642f2107503eb83004000b2fbf0f40a2c11d303fb07f0b2fbf0f40a2c0bd303fb06f0b2fbf0f40a2c05d36b43b2fbf3f00928e7d800e00346ca46b9f15f0f98bf4ff05f0acaf1000842f2107e18eb09054dd0b2fbf3f04cf6cd4100f13004ccf6cc410bf809400a2ba3fb016441d36e1c3dd000fb1320e408b0fbf4f748f21f5107f130060beb0902c5f2eb115670642ba3fb011630d3a91c29d007fb14007409b0fbf4f7b3f57a7f07f13001917044f6d351c1f26201a3fb011620d3e91c16d007fb1400b10941f25975b0fbf1f4cdf2b715a3fb055604f13005d57004fb110209f1040973454fea5633afd209e0d14607e009f1010904e009f1020901e009f1030900220bf809201bf80200002800f0a1800beb0201487800285ed0887800285dd0c87800285cd0087900285bd0487900285ad08879002859d0c879002858d0087a002857d0487a002856d0887a002855d0c87a002854d0087b002853d0487b002852d0887b002851d0c87b002850d0087c00284fd0487c00284ed0887c00284dd0c87c00284cd0087d00284bd0487d00284ad0887d002849d0c87d002848d0087e002847d0487e002846d0887e002845d0c87e002844d0087f002843d0487f002842d0887f002841d0c87f002840d02032602a7ff498af56e001323ae0023238e0033236e0043234e0053232e0063230e007322ee008322ce009322ae00a3228e00b3226e00c3224e00d3222e00e3220e00f321ee010321ce011321ae0123218e0133216e0143214e0153212e0163210e017320ee018320ce019320ae01a3208e01b3206e01c3204e01d3202e01e3200e01f325f2a17d84ff020000bf8020012d00beb020163205e2a48700cd072205d2a887008d063205c2ac87004d020205b2a087140f0668100208df87b0037214fea1c7001eb1c71bcf1204f38bf00f13001ccf303608df8171000f137010a2838bf00f13001ccf303508df8181000f137010a2838bf00f13001ccf303408df8191000f137010a2838bf00f1300100208df81b001f208df81a100beb000111f81f2c002a00f0818011f81e2c002a7ed011f81d2c002a7cd011f81c2c002a7ad011f81b2c002a78d011f81a2c002a76d011f8192c002a74d011f8182c002a72d011f8172c002a70d011f8162c002a6ed011f8152c002a6cd011f8142c002a6ad011f8132c002a68d011f8122c002a66d011f8112c002a64d011f8102c002a62d011f80f2c002a60d011f80e2c002a5ed011f80d2c002a5cd011f80c2c002a5ad011f80b2c002a58d011f80a2c002a56d011f8092c002a54d011f8082c002a52d011f8072c002a50d011f8062c002a4ed011f8052c002a4cd011f8042c002a4ad011f8032c002a48d011f8022c002a46d011f8011c002944d01bf80010002941d020307f287ff479af61e01f383ae01e3838e01d3836e01c3834e01b3832e01a3830e019382ee018382ce017382ae0163828e0153826e0143824e0133822e0123820e011381ee010381ce00f381ae00e3818e00d3816e00c3814e00b3812e00a3810e009380ee008380ce007380ae0063808e0053806e0043804e0033802e0023800e001385f2822d8c0f15d0ec0f15e02c0f15f03c0f1600c584400260df11705af5d8755b7b1b34211d0af1979788419617079b1b2420ad0b978a17051b1b64505d0f978e17029b10436b445e8d100208df87b00039842f2a00845f2a80440f2403507aa0e21c2f22008c2f21304c2f2000507f06dfde869ae46a0425fd1def82800b0f54d2f5ad1def82c00a04256d145f61c530020c2f213034cf6394508f1040c002763454ad81c6834f003061cd098454ff0ff3228bf0c2c42d3a8eb03018e424ff0ff313ed83946be4288bf3146e2071cbf0f4630449919013d01f10403e0d12ce00020487199e60421b7f5807f1ed300223e46b6f5007f14d3b6f5806f13d3b6f5006f12d30901b2eb163f4fea1616f0d10ce000219171fef76bbf00211172fef729bc490002e0890000e0c900634504d1494207ea0102014603e04ff0ff324ff0ff3146f68050c2f20700d0f8880008f1080342f6a00c9842c2f2270c29d142f61c574ff00008c2f2200746f6b9750cf1040b00264ff0ff394ff0ff3a5f4518d83c6834f003005cd0bc4528bf0c2c12d3aceb0703984210d8b042334688bf0346e4071cbf1e4680443844013d00f10407e4d14ff0ff394ff0ff3adef800300cf10800834240f08b80def80c30b3f5333f40f08580def81030834240f080804ff2a84043f21c53c2f229004ff0000bc2f2270342f6f934a0f1040ca0f1080e00264ff0ff3863456ad81d6835f0030730d09e454ff0ff30019028bf0c2d62d3aeeb0300874260d83046b74288bf3846ed071cbf0646bb44d819013c00f10403e1d14de073460425b6f5807f2dd34ff0000e3046b0f5007f22d3b0f5806f21d3b0f5006f20d32d01beeb103f4fea1010f0d11ae00425b6f5807f29d300273446b4f5007f1fd3b4f5806f1ed3b4f5006f1dd32d01b7eb143f4fea1414f0d117e06d0002e0ad0000e0ed005f4505d1684206ea0009c2469e4680e74ff0ff394ff0ff3a9e467ae76d0002e0ad0000e0ed00634505d16b4206ea03000190d84604e04ff0ff3001904ff0ff3866208df81c0072208df81d0065208df81e008df81f002f208df820006d204b238df8210061208df8253069238df8220078208df82630422356278df8230020208df827303a238df82b70472707ac8df824008df828308df829004c238df82c708df82e00002720468df82a308df82d308df82f7007f074fde05d002800f0a080e019417800295ed0817800295dd0c17800295cd0017900295bd0417900295ad08179002959d0c179002958d0017a002957d0417a002956d0817a002955d0c17a002954d0017b002953d0417b002952d0817b002951d0c17b002950d0017c00294fd0417c00294ed0817c00294dd0c17c00294cd0017d00294bd0417d00294ad0817d002949d0c17d002948d0017e002947d0417e002946d0817e002945d0c17e002944d0017f002943d0417f002942d0817f002941d0c07f002840d02037602f7ff49aaf64e001373ae0023738e0033736e0043734e0053732e0063730e007372ee008372ce009372ae00a3728e00b3726e00c3724e00d3722e00e3720e00f371ee010371ce011371ae0123718e0133716e0143714e0153712e0163710e017370ee018370ce019370ae01a3708e01b3706e01c3704e01d3702e01e3700e01f375f2f25d84ff02000e05521d0e01945215e2f41701cd076215d2f817018d065215c2fc17014d06e215b2f017110d048215a2f41710cd07521592f817108d06221582fc17104d02021572f017240f0f88000208df87b00204651464a4607f0a0fc0020215c002900f0a08021184a78002a5ed08a78002a5dd0ca78002a5cd00a79002a5bd04a79002a5ad08a79002a59d0ca79002a58d00a7a002a57d04a7a002a56d08a7a002a55d0ca7a002a54d00a7b002a53d04a7b002a52d08a7b002a51d0ca7b002a50d00a7c002a4fd04a7c002a4ed08a7c002a4dd0ca7c002a4cd00a7d002a4bd04a7d002a4ad08a7d002a49d0ca7d002a48d00a7e002a47d04a7e002a46d08a7e002a45d0ca7e002a44d00a7f002a43d04a7f002a42d08a7f002a41d0c97f002940d0203060287ff49aaf5be001303ae0023038e0033036e0043034e0053032e0063030e007302ee008302ce009302ae00a3028e00b3026e00c3024e00d3022e00e3020e00f301ee010301ce011301ae0123018e0133016e0143014e0153012e0163010e017300ee018300ce019300ae01a3008e01b3006e01c3004e01d3002e01e3000e01f305f281cd84ff02001215418d021184f225e284a7013d074225d288a700fd068225c28ca700bd065225b280a7107d072225a284a7103d0202259288a7128d100208df87b0007ac019a2046414607f0d3fb03981a21224607f050fa029e002086f86401c6f8600103984cf6036107904ff41630089007a8c0f247018847012086f8660104a800f041f930611fb0bde8f08f0020c871d6e70021417207e700bf2de9f04f81b0009041f204024cf65560cef20002ccf2ac50c2f8ac0f4ef6fc50cef2000001684ef66c6641f08071016052f8040c4ff2a8474ff6245a48f2c738ccf2ff06c2f229074ff6ff7440f00100cff6ff7a00254ff0010bc0f2450842f8040c02e0bff32f8fc047d7f80090bff35f8f3868bff35f8f01466ff39601b1f1005f03d10168b14200f0a8804ff4377002f0d8fb002800f0de80514642183d3182f8dc5282f8dd5282f8de5282f8df5282f8e05282f8e15282f8e25282f8e35282f8e45282f8e55282f8e65282f8e75282f8e85282f8e95282f8ea5282f8eb5282f8ec5282f8ed5282f8ee5282f8ef5282f8f05282f8f15282f8f25282f8f35282f8f45282f8f55282f8f65282f8f75282f8f85282f8f95282f8fa5282f8fb5282f8fc5282f8fd5282f8fe5282f8ff5282f8005382f8015382f8025382f8035382f8045382f8055382f8065382f8075382f8085382f8095382f80a5382f80b5382f80c5382f80d5382f80e5382f80f5382f8105382f8115382f8125382f8135382f8145382f8155382f8165382f8175382f8185382d1066080f80ab08483c483048444848484c484048544858485c485048644868486c4860487448757e8001f49457ff44fafbff35f8f00bf47e8000121b157e8001f4945f8d043e74169d1bb46f6805245f6e466c2f20702cff6f8761368314617689f420ed117689f420bd117689f4208d117689f4203d1002901f10401efd19f421ed041f20401cef200010b6817681168b9420ed11168b9420bd11168b94208d11168b94203d1002e06f10406efd1b94206d041f20401cef200010968c91a416141f20400cef2000000680099086001b0bde8f08f00bf2de9f04f81b041f20401cef200014ef66c674ff2a846d1f8009000684ff6245bccf2ff07c2f229064ff6ff74cff6ff7b00254ff00108009007e000bf48f2c731c0f24501bff32f8f8847d6f800a0bff35f8f3068bff35f8f01466ff39601b1f1005f03d10168b94200f0a8804ff4377002f0b2fa002800f0fc80594642183d3182f8dc5282f8dd5282f8de5282f8df5282f8e05282f8e15282f8e25282f8e35282f8e45282f8e55282f8e65282f8e75282f8e85282f8e95282f8ea5282f8eb5282f8ec5282f8ed5282f8ee5282f8ef5282f8f05282f8f15282f8f25282f8f35282f8f45282f8f55282f8f65282f8f75282f8f85282f8f95282f8fa5282f8fb5282f8fc5282f8fd5282f8fe5282f8ff5282f8005382f8015382f8025382f8035382f8045382f8055382f8065382f8075382f8085382f8095382f80a5382f80b5382f80c5382f80d5382f80e5382f80f5382f8105382f8115382f8125382f8135382f8145382f8155382f8165382f8175382f8185382d1076080f80a808483c483048444848484c484048544858485c485048644868486c4860487448756e8001f51457ff44bafbff35f8f00bf46e8000121b156e8001f5145f8d03fe74169009d61b144f6d350c1f26200a1fb0001880901284ff0010088bf88094ce046f6805245f6e466c2f20702cff6f8761368314617689f420ed117689f420bd117689f4208d117689f4203d1002901f10401efd19f422fd041f20401cef200010b6817681168b9420ed11168b9420bd11168b94208d11168b94203d1002e06f10406efd1b94217d041f20401cef20001096844f6d357ca1ac1f26207a2fb07764261b00901284ff0010088bfb009994208bffa2001e0009dfa20a9eb0501b1fbf0f001b0bde8f08f002858d1002956d0082a54d30b78aa2b51d18b79f02b4ed12de9f04f83b00b2a4ed3c878a2f10803834249d14878212848d10879012845d14879012842d1c87900283fd10c4614f8080f10f03c0f39d18818884610f8021c10f8010c164641ea0025a2f10a0081b2204606f0d5fd854228d14cf6dd70c0f245008047811eb1fa81f14f09012808bf0227002f00f02b81207887f00301084200f02781012039464246334600f06cfa0446002898f8080018bf06241ae14ff2e933c0f24c0318470b2400e00a244cf6dd70c0f245008047811eb1fa81f14d09012808bf0225002d00f0fd804ef66c6a4ff2a8474ff624580294ccf2ff0ac2f229074ff6ff74cff6ff7800264ff0010b06e048f2c731c0f24501bff32f8f8847d7f80090bff35f8f3868bff35f8f01466ff39601b1f1005f03d10168514500f0a9804ff4377002f009f9002800f0ca80414600bf42183d3182f8dc6282f8dd6282f8de6282f8df6282f8e06282f8e16282f8e26282f8e36282f8e46282f8e56282f8e66282f8e76282f8e86282f8e96282f8ea6282f8eb6282f8ec6282f8ed6282f8ee6282f8ef6282f8f06282f8f16282f8f26282f8f36282f8f46282f8f56282f8f66282f8f76282f8f86282f8f96282f8fa6282f8fb6282f8fc6282f8fd6282f8fe6282f8ff6282f8006382f8016382f8026382f8036382f8046382f8056382f8066382f8076382f8086382f8096382f80a6382f80b6382f80c6382f80d6382f80e6382f80f6382f8106382f8116382f8126382f8136382f8146382f8156382f8166382f8176382f8186382d1c0f800a080f80ab08483c483048444848484c484048544858485c485048644868486c4860487448757e8001f49457ff449afbff35f8f47e8000121b157e8001f4945f8d03ee705eb450100eb011090f85d1201b300f513760024304629462a460323009406f06dfd706840b146f22b11c0f25d018847706806f0ddfb74603068b475002818bf06f0d6fb0020029c3060b060308200e0029c204603b0bde8f08f0624f9e700243842f6d0404631463a463b4600f064f9002818bf0446ece70b291dd3c278a1f10803934218d10278aa2a13d14278212a10d10279012a0dd14279012a0ad18279f02a07d1c2792ab9024612f8083f13f03c0f03d00a2070470b20704710b5084410f8023c10f8010c43ea0024a1f10a0081b2104606f05afc201a18bf0a2010bd002808bf7047b0b582b00446407cd0b1002520460323009506f000fd606840b146f22b11c0f25d018847606806f070fb65602068a575002818bf06f069fb00202060a060208202b0bde8b040704700bf2de9f04f81b04ef66c654ff2a8464ff624598046ccf2ff05c2f229064ff6ff77cff6ff7900244ff0010a06e048f2c731c0f24501bff32f8f8847d6f800b0bff35f8f3068bff35f8f01466ff39601b1f1005f03d10168a94200f0a9804ff4377001f09aff002800f0a180494642183d3182f8dc4282f8dd4282f8de4282f8df4282f8e04282f8e14282f8e24282f8e34282f8e44282f8e54282f8e64282f8e74282f8e84282f8e94282f8ea4282f8eb4282f8ec4282f8ed4282f8ee4282f8ef4282f8f04282f8f14282f8f24282f8f34282f8f44282f8f54282f8f64282f8f74282f8f84282f8f94282f8fa4282f8fb4282f8fc4282f8fd4282f8fe4282f8ff4282f8004382f8014382f8024382f8034382f8044382f8054382f8064382f8074382f8084382f8094382f80a4382f80b4382f80c4382f80d4382f80e4382f80f4382f8104382f8114382f8124382f8134382f8144382f8154382f8164382f8174382f8184382d1056080f80aa08783c783078447848784c784078547858785c785078647868786c7860787478756e8001f59457ff44bafbff35f8f00bf46e8000129b156e8001f5945f8d03fe7002008eb480100eb0111002818bf01f5137001b0bde8f08fb0b5c4b0dc08202c03d94ff0ff3044b0b0bd0df107048df807008df80810a01c11461a461d46fcf771fda81c4af28d5582b2c0f24605f02021460023a84744b0b0bd00bf2de9f04f8bb04ef66c654ff2a8464ff6245948f2c73bccf2ff05c2f229064ff6ff77cff6ff7900244ff0010ac0f2450bcde90612cde9080303e000bfbff32f8fd847d6f80080bff35f8f3068bff35f8f01466ff39601b1f1005f03d10168a94200f0a8804ff4377001f092fe002800f04484494642183d3182f8dc4282f8dd4282f8de4282f8df4282f8e04282f8e14282f8e24282f8e34282f8e44282f8e54282f8e64282f8e74282f8e84282f8e94282f8ea4282f8eb4282f8ec4282f8ed4282f8ee4282f8ef4282f8f04282f8f14282f8f24282f8f34282f8f44282f8f54282f8f64282f8f74282f8f84282f8f94282f8fa4282f8fb4282f8fc4282f8fd4282f8fe4282f8ff4282f8004382f8014382f8024382f8034382f8044382f8054382f8064382f8074382f8084382f8094382f80a4382f80b4382f80c4382f80d4382f80e4382f80f4382f8104382f8114382f8124382f8134382f8144382f8154382f8164382f8174382f8184382d1056080f80aa08783c783078447848784c784078547858785c785078647868786c7860787478756e8001f41457ff44fafbff35f8f00bf46e8000121b156e8001f4145f8d043e70999089d01eb410100eb011095f9081000f51376b1f1ff3f01f0030409dd374617f8110fd0bb3068002818bf06f06af92ee3307cf0b1707ce0b10799099a002730460323009706f0e3fa706840b146f22b11c0f25d018847706806f053f977603068b775002818bf06f04cf900203060b06030823068002818bf06f043f900204ff480713060b0603182a978b081092006f11107f174b17434757076b07ca978884240f0da82317da14240f0d682069b411ca3f10b00727e02971e2828bf1e209042b17488bf7076981e84b200270a2c4ff00008c0f0e682092241f221090920039419e030684f46002818bf06f00af9b089376001303774b760b081002c18bf4ff00608039cd146ddf814a00aeb0b0082b2a24280f0c682317c80b20429824600f28880aa5c00f1010a4b1c0129337405dd022906d0032970d1f28106e021b9727503e0338943ea02223281a24580f0a98204296ed015f80a204ff0000c831c8f1c0129377406ddff290bd0032967460dd19a4652e000291cbf378947ea0222328100e072756746a34204d38ae2f281a34280f08782022936d8ea5c00f1030acb1c0129337407dd022937d0fe2907d17275a2450cd375e231b9338943ea02223281a24504d36de2f281a24580f06a8202292fd015f80a20031d41f00407fc29377408ddfd2909d0fe291cbf378947ea0222328103e079b9f28100e072756746a34280f04f8209b19a4613e0ea5c00f1050a0520307401e09a466746f189308941ea0221f18128b106f076f80028306000f0698233897089191a1ffa81fb1ffa8af1621a5a45b8bf93465fea0b4208d03268294410441ffa8bf2fcf75bfb70893389584481b2994270817ff44faf0025cdf81080d6f800808df82b50707db8f1000f06930df12b0108bf88460f2806d8317d00f00302511ab1fa81f14d09000706d4317e707e814238bf30760fe000bf706840b146f22b11c0f25d018847706806f020f87760707e30760120f082cdf814a09db1707db57d400714d4002d4ff0000400f0888106984ff6ff7381b2002900f00d8101295ed10020d2e0707d400753d4002477e14ff4803006f005f8002d804600f06f81b07d002800f06b81b8f1000f00f067817568002d00f0ff8030890428c0f05f8131680a1812f8043c002b40f0588112f8033c002b40f0538112f8023cff2b40f04e8112f8012cff2a40f049814ff4803429606860c5f80c802c610028019000f0668146f22b10c0f25d0000f58572284600219047002840f032812969002900f02e8168688c420c46e7d1019a0c468242e3d124e14ff4803005f0b3ff04461fe1069a4ff6fe701040a44642426ff0010000bf08eb0005ac78ed7883ea04231cb25f003fb209ead43484ea430309ead7375c0087ea430324b25f003fb209ead43484ea430309ead7375c0087ea430324b25f003fb209ead43484ea430309ead7375c0087ea430324b25f003fb209ead43484ea430309ead73787ea430383ea05231fb25d002db209ead73787ea430309ead5355f0085ea43033fb25d002db209ead73787ea430309ead5355f0085ea43033fb25d002db209ead73787ea430309ead5355f0085ea43033fb25d002db209ead737023087ea430309ead5371518023587ea430395d1023000276446069ad20732d018f8000083ea002002b243001bb209ead23282ea400009ead333420083ea400012b243001bb209ead23282ea400009ead333420083ea400012b243001bb209ead23282ea400009ead333420083ea400012b243001bb209ead23282ea400009ead33282ea4003f0899ab282426fd14046fcf7d0fa00286ad141f2210a4ff00009012375e0382005f0f3fe00285ed00546077047708770c770077147718771c771077247728772c772077347738773c773077447748774c774077547758775c775077647768776c776077747778777c77780f8287080f8297080f82a7080f82b7080f82c7080f82d7080f82e7080f82f7080f8307080f8317080f8327080f8337080f8347080f8357080f8367080f8377046f2d110c0f200007844286246f2d910c0f200007844686246f22b10c0f25d0047f2f85200f13c0c28460f21c0f27b023823e04740b3284605f088fe4446706841f2210a40b146f22b11c0f25d018847706805f07bfe77604ff000090323b77506980799099a089dddf8108087b23046009705f0f1ff002c214604463ff456ad084605f063fe51e5756074e6c4f58030b4f5803f444606902f60ef607ff647aecde70799099a002430460323009405f0d3ff706840b146f22b11c0f25d018847706805f043fe74603068b475002818bf05f03cfe0020387000203060b06030824ff00a0840460bb0bde8f08f287a4006f8d5307c08b302980078e0b10799099a002430460323009405f0a6ff706840b146f22b11c0f25d018847706805f016fe74603068b475002818bf05f00ffe00203060b06030824ff00b083068002818bf05f004fe00203060b0603082cae702980078e0b10799099a002430460323009405f07aff706840b146f22b11c0f25d018847706805f0eafd74603068b475002818bf05f0e3fd00203060b06030824ff00608a7e72de9f041f02846d100294ff00b0000f08880022ac0f085804cf6dd70c0f245000e4617468047811eb1fa81f14c09012808bf0224002c4ff00a0072d07578e91ec9b2fe2938bfbde8f081307833463946022829d0012866d1ac4204bf0020bde8f0814808842884bf0b20bde8f081881e03f1020887b240463946fff7e1f920b306462846fff738fa21462a46fff70cfa3046bde8f0814cf6dd77c0f2450707f5e27cbde8f0416047ac4219d1a1f1210010f1160f06d36ff0480048432330c0b2242810d90b20bde8f081b07a204207d04046394622462b46bde8f041fff710bb0020bde8f0811a4612f8020f40f00207032f18d19b796340032b14d10b2904d0032804bf0b20bde8f081881e4df22d7783b2c0f247070120f021b847002818bf0620bde8f0810a20bde8f0814ff2a841c2f229010968bff35f8f0a466ff39602b2f1005f15d10a684ef66c63ccf2ff039a420ed1d1f8681159b146f68052c2f207021268891a012903db0178042938bf7047002101707047b0b54cf28544c0f251041d46a0474ff2a841c2f229010968bff35f8f0a466ff39602b2f1005f08d10a684ef66c63ccf2ff039a4218bf002100e00021421c18bf002900d1b0bd95f84d20002afad091f84321002a08bfb0bd45f2e823c2f206031a68132aeed8c2ebc20403eb04135b6801ebc2014ff40042c1f8c031a1f8c6212a7a01f5e071002a0fbf802248f20112ca808122ab7c33b1ab7d23b1022342f002028b71ca7195f820303bb195f8243023b1032342f004028b71ca7195f846304bb195f8443042f008020b7195f84530ca714b71b0bd47f27e32c2f207021378002b14bf9378ff230b711378002b14bf5278ff224a71b0bdf0b589b045f6e532c0f24b020c46054690474ff2a841c2f229010e68bff35f8f31466ff39601b1f1005f08d131684ef66c62ccf2ff02914208bf092d01d009b0f0bde1082c29fad896f843110029f6d04cf6dd71c0f2450107468847014638460129ecd1ff22079244f6435245f2e8210020cff60172c2f20601089006920b685a1e132a4fd8c3ebc30501eb05111a1fa1f5de7191f85451ad0618d4d51c42d091f8e450ad0616d4951c3cd091f87450ad0613d4551c36d00d79ad0610d4043aa1f5e071151da3f10403e3d12be05a1e01f5a87104e09a1ee03101e0da1e703106ebc203096893f9c721b2f1ff3f1adc03f5e0731e688e4215d11e798df81b605e798df81c609b798df81e200a0a8df820108df821200a0c090e8df81d308df822208df823100f228df8012010228df80220522208218df80420b4f5804f4ff080028df800108df8061038bf4ff48042b4f5001f6ff07f0604f07f0138bf0026802c28bf80318df807109df809509df80a108df8030004d29df808200223002415e0c4f3c610b4f5804f024403d20323012400200be0b4f5001f03d204230224012003e0052303240120002135468df8053004f108038df808208df809508df80a1070b96846a222c118c254062048700c208870c81c06a90c22fbf7bdfe04f117034df60f166a46c0f2470601200821b047384609b0f0bd70b582b00546ff208df8040044f25220c0f2010000904ef6a970c0f2470016460c46804798b147f2a620c2f2070000880122c1b264298df8032008d80721b0f5807f38bf03218df803108df80400301b28bf08280cd3d221281929550621417005218170033069460522fbf779fe0834204602b070bd00bf024600284ff0ff3009d0022918bf70471078112801d1507810b14ff0ff30704710b586b04cf6dd70c0f24500804701284ff000003ed1cde9020040f20830c0f210000190ff208df8140044f25220c0f2010004904ef6a970c0f24700804798b147f2a620c2f2070000880122c1b264298df8132008d80721b0f5807f38bf03218df813108df8140040f2d260adf80800052001ac8df80a00e01d04a90522fbf723fe4df60f1cc0f2470c0120092122460c23e04706b010bd4ff2a840c2f22900016808466ff39600b0f1005f16d108684ef66c62ccf2ff0290420fd1d1f8380160b146f68052c2f207021268801a0028cebf01200020c1f838017047002070474ff2a840c2f22900026810466ff39600b0f1005f2bd110684ef66c61ccf2ff01884224d1d2f8680108b346f68051c2f207010968401a0028c4bf01207047d2f86c1100200029c2f8680182f8660108bf704710b5c2f86c0148f2c732c0f245020446084690472046bde8104070470020704700bff0b101684ef66c62ccf2ff02914218bf704790f8421199b110b54af29f344ff0000cc0f24604864680f842c10120002100220023aef840c1a446bde810406047704700bff0b581b004464ef2e960c0f245008047002c18bf012801d101b0f0bd21796279a379e77941ea022141ea034151ea076109d00e2904d00329eed10646032504e00646042501e006460225fff759ff00283046e1d04ff2a841c2f229010e6831466ff39601b1f1005fd6d131684ef66c62ccf2ff029142cfd14cf6dd71a778c0f2450104468847014620460129c4d1b221082086f86412062186f86002032086f8651286f86612462186f86102102086f86712432186f86202002086f86812012186f86b724df6090706f5187286f8630286f8691286f86c02c0f24707012009210d2386f86a52b847204601b0f0bd00bf2046fff785bf00bf2de9f04f81b04ef66c694ff2a8464ff624580446ccf2ff09c2f229064ff6ff77cff6ff7800254ff0010a06e048f2c731c0f24501bff32f8f8847d6f800b0bff35f8f3068bff35f8f01466ff39601b1f1005f03d10168494500f0a8804ff4377000f04efe002800f0cd80414642183d3182f8dc5282f8dd5282f8de5282f8df5282f8e05282f8e15282f8e25282f8e35282f8e45282f8e55282f8e65282f8e75282f8e85282f8e95282f8ea5282f8eb5282f8ec5282f8ed5282f8ee5282f8ef5282f8f05282f8f15282f8f25282f8f35282f8f45282f8f55282f8f65282f8f75282f8f85282f8f95282f8fa5282f8fb5282f8fc5282f8fd5282f8fe5282f8ff5282f8005382f8015382f8025382f8035382f8045382f8055382f8065382f8075382f8085382f8095382f80a5382f80b5382f80c5382f80d5382f80e5382f80f5382f8105382f8115382f8125382f8135382f8145382f8155382f8165382f8175382f8185382d1c0f8009080f80aa08783c783078447848784c784078547858785c785078647868786c7860787478756e8001f59457ff44aafbff35f8f46e8000121b156e8001f5945f8d03fe7002780f857712a270821032380f85871042780f8541180f85531102380f8597180f85a1101214df60f1c074600f5aa7280f8563180f85b1180f85c31002c18bf0124c0f2470c012010210a2387f85d4101b0bde8f04f604701b0bde8f08f00bf80b582b04ff0010ccdf800c000f002f802b080bd2de9f04381b04ff2a847c2f229073f684ff000093e466ff39606b6f1005f07d13e684ef66c65ccf2ff05ae4208bfb946012811d1ddf820801c4615460e460746fff7d2fd2346044631462a463846002c18bfb9f1000f07d14af29f3cc0f2460c01b0bde8f043604799f8420188b1b8f1010f40f08580d9f83c01002189f84211a9f84011e0b342f68d41c0f24401884736e0b9f840010121013080b2012898bf0846a9f84001d9f83c0142f68d44c0f2440489f8421168b94ff6dd30cff6ff70a4f59477784400214a460023b847c9f83c0140b1a047d9f83c01a4f140024ff4c8719047a8b199f84201002848d0d9f83c01002189f84211a9f8401100b1a0474af29f3cc0f2460c0120002100220023a6e74cf6dd70c0f24500804701282fd1082089f84401032089f84501102089f84601002089f84701b22089f84801062089f8490189f84a01462089f84b01432089f84c01012089f84d01b9f840014df6090c070a09f5a27289f84e8189f84f01c0f2470c012009210d2389f850716fe701b0bde8f08300bf80b582b04ff0050ccdf800c0fff734ff02b080bd2de9f04f83b04468002c00f0c1828368002b00f0bd8204eb030b4ff000090027002614e046f68053c2f207031b6845f69077c0f201073b44c6f838310ceb0a0300275b451c464ff0000680f0a182a04618f9013b03f07f05bd40002b46ea050610d406f00703012b16dc0bb3012b40f08f82abeb0803082bc0f08a8204f10903dee700bfd84580f08382182f07f107074446dcd97ce200bf022b3ad0052b40f07782abeb0803042bc0f07282631dc7e7d84580f06d8294f90130002b04f10203bed55b4580f0648294f90230b3f1ff3f04f10303b4dc5b4580f05a8294f90330b3f1ff3f04f10403aadc5b4580f0508294f90430b3f1ff3f04f10503a0dc5b4580f0468294f90530002b00f14182a31d96e7d84580f03c8294f9013004f1020c002b03f07f0a1ed5dc4580f0318294f90270e31c07f07f05b7f1ff3f4aeac51a02dde0469c460ee05b4580f0218294f9037004f1040c07f07f05b7f1ff3f4aea853a33dd9846abeb0c039a4500f21082f308672b1dd0652b7ff460afbaf1060ffff45caf9cf80030462b7ff457af98f80230432b7ff452af98f80330012b7ff44daf4ff2a844c2f229040290cde9002132e0044660460e4651461746654600f01bfcac4631463a46204637e7dc4580f0df8194f90470631d07f07f05b7f1ff3f4aea455aaddc5b4580f0d28194f90570002f00f1cd8104f1060c4aea077ab1e748f2c7313046c0f24501bff32f8f8847dde900210298ac462768bff35f8f2668bff35f8f33466ff39603b3f1005f07d133684ef66c65ccf2ff05ab4200f0bc804ff43770654600f07dfbdde9002106460298ac46002e3ff4f1ae4ff62453cff6ff7300bff4183d3384f8dc9284f8dd9284f8de9284f8df9284f8e09284f8e19284f8e29284f8e39284f8e49284f8e59284f8e69284f8e79284f8e89284f8e99284f8ea9284f8eb9284f8ec9284f8ed9284f8ee9284f8ef9284f8f09284f8f19284f8f29284f8f39284f8f49284f8f59284f8f69284f8f79284f8f89284f8f99284f8fa9284f8fb9284f8fc9284f8fd9284f8fe9284f8ff9284f8009384f8019384f8029384f8039384f8049384f8059384f8069384f8079384f8089384f8099384f80a9384f80b9384f80c9384f80d9384f80e9384f80f9384f8109384f8119384f8129384f8139384f8149384f8159384f8169384f8179384f8189382d14ef66c63ccf2ff0333600123b3724ff6ff734ff2a844b383f38333847384b384f38433857385b385f38533867386b386f38633877387c2f2290454e8003fbb427ff42fafbff35f8f00bf44e8006323b154e8003fbb42f8d023e798f8043098f8057098f80650032b47ea052433dd052b54dc042b74d0052b7ff431aed6f868313bb146f68057c2f207073f68db1b002b14dcd6f86c3186f866917bb10c4648f2c73180461846c0f24501c6f86c91174665468847ac4621463a46404646f68053c2f207031b6845f69077c0f201073b44c6f8683103e6012b3ff4f5ad022b00f08380032b7ff4fbad174688466546fff7fefa03460298ac4641463a46002b3ff4eead96f84231002b3ff4e9ad304641f28831a6f8404105f04ef847e0062b4ad0072b7ff4dcad80464cf23330c0f24a0016460f466446804703465d1ea446394632464046012d3ff6caad981eb0fa80f04009fff7c8fba446394632464046bee5174688466546fff7c2fa03460298ac4641463a46002b3ff4b2ad96f84231002b3ff4adadb6f84031a3427ff4a8add6f83c3186f84291002ba6f840913ff49fad42f68d411846c0f2440188470298ac4641463a4693e5d6f86c31c6f86891002b86f866913ff48bad0f4648f2c73104461846c0f24501c6f86c91164665468847ac463946324640e696f84231c6f83891002b3ff474ad0446d6f83c0165468846174686f84291a6f8409120b142f68d41c0f2440188474af29f360120002100220023c0f24606b04720463a464146ac4655e54df60923c0f2490303b0bde8f04f18477fb50646002806d1fff750fa002807d19de80f00064645f25b1cc0f24f0c60477fbd00bf2de9f04182b04df609061d4614460929c0f247064cd180460f46f22d10d8a22160196155062141700b21817045f64251c0f20001033079440b22fbf73df80e35204629464ff4807200f038f80546ff208df8040044f25220c0f20100009006f5bd50804798b147f2a620c2f2070000880122c1b264298df8032008d80721b0f5807f38bf03218df803108df80400f82d0cd8d221601961550621417005218170033069460522fbf707f808353946404622462b46b04702b0bde8f081f0b587b00c464ff2a841c2f229010d68bff35f8f29466ff39601b1f1005f52d129684ef66c63ccf2ff0399424bd14d218df8041043218df8051001218df8061095f8701195f871318df807108df8083095f87511b5f878318df80b108df80c30190ab5f87a318df80d10190a8df80f1095f8761195f8737195f874618df80e3095f877318df810104cf6dd71c0f245018df809708df80a608df81130064617468847d5f87c3101468df81210190a8df81410190c3a4630468df813308df81510190ea02328e04d218df8041043218df8051001218df80610002100238df807108df808108df809108df80a108df80b108df80c108df80d108df80e108df80f108df810108df811108df812108df813108df814108df815108df816108df817300023111b8df8183028bf18290cd3c222011902550620487015208870c81c01a91522faf75bff1834204607b0f0bd00bf2de9f04f81b04ff2a840c2f229000468bff35f8f20466ff39600b0f1005f0dd120684ef66c63ccf2ff03984206d194f8700118b1002a18bf002902d101b0bde8f08f94f877010028f8d0d4f880010028f4d046f68059c2f20709d9f80030c01a0128ebdb94f87101012802d14ff0010b06e094f873b1bbf1010f18bf4ff0020b94f876510020eb078846adf80200adf8000013d0bbf1020f10d194f8750168b96b464bf2f1270df10201c0f25a07404615461a46b8472a4694f876511646b2f5c86f28bf4ff4c86606f1150a5046174600f050f80028b1d0b7f5c86f88bf45f08005d9f80010d4f87c2153230271120a42710a0a8171c2710a0c090e03704d234172a02143700123c17200218370c570027280f80ab0017394f87511bdf802204173bdf800108373c173090a0174110a8174310a017500f115014274c6740746084641463246faf7b1fe4df66d22c0f24702384651469047d4f87c0148f2c7310130c4f87c01c0f245013846884701b0bde8f08fb0b54ff2ac44c2f22904216846f23f52c5f28802b2eb510f48f283314cf67e25c0f24501caf2101518bf25608847002804bf691c2160b0bd10b301684ef66c62ccf2ff0291421bd190f87711c1b1d0f88011b1b146f68052c2f207021368cb1a012b0edb1268d0f88401002808bf7047891a42f64d42c0f2440208bf01211047704710b5002143f2c942c0f8801180f87711c0f25902002044f24361904748f65354c0f25a04a04704f1bc00bde81040004700bf2de9f04f81b00429c0f0f7800c46014600784d2840f0f1804878432840f0ed808878012840f0e9804ef66c684ff2a847ccf2ff08c2f229074ff6ff7600254ff0010b8a4607e048f2c731c0f24501bff32f8f88475146d7f80090bff35f8f3868bff35f8f02466ff39602b2f1005f03d10268424500f0ac804ff43770fff766ff002800f0ba804ff624525146cff6ff7283183d3283f8dc5283f8dd5283f8de5283f8df5283f8e05283f8e15283f8e25283f8e35283f8e45283f8e55283f8e65283f8e75283f8e85283f8e95283f8ea5283f8eb5283f8ec5283f8ed5283f8ee5283f8ef5283f8f05283f8f15283f8f25283f8f35283f8f45283f8f55283f8f65283f8f75283f8f85283f8f95283f8fa5283f8fb5283f8fc5283f8fd5283f8fe5283f8ff5283f8005383f8015383f8025383f8035383f8045383f8055383f8065383f8075383f8085383f8095383f80a5383f80b5383f80c5383f80d5383f80e5383f80f5383f8105383f8115383f8125383f8135383f8145383f8155383f8165383f8175383f8185382d1c0f8008080f80ab08683c683068446848684c684068546858685c685068646868686c6860687468757e8002f4a457ff445afbff35f8f47e8000222b157e8002f4a45f8d03ae7ca78022a04dc012a0dd0022a79d00ce0032a0dd0042a08d190f8701129b101b0bde8f04faae00d2c06d201b0bde8f08f044600f045f963e090f87721aab1002143f2c94280f87711c0f259020446002044f24361904748f65355c0f25a05a84705f1bc008047204651460a790446012a88bf002280f871214a7902f00303012b4ff0010298bf134680f873318f79012f88bf002780f87471cf79022f88bf002780f875710f7a4e7a47ea0627502f98bf5027b7f5f07f28bf4ff4f077a0f878718f7ace7a47ea062741f28836b74238bf3e46a0f87a61097b80f8702101f0030180f8761103f0010101eb530180f872110021c0f87c1100f009f8204600f03ef8204601b0bde8f04f6ae000bfb0b5044690f87601800758bfb0bd94f8710148f6a3450128c0f25a0507d105f1b000804705f58b71002088470ee005f5b670804794f87101012801d1002004e094f87301013818bf0120a8474ff6a122cff6ff7243f271337a44c0f25903002044f243619847012084f87701b0bd00bf70b5044646f68050c2f20700006894f8771145f69075c0f2010500292844c4f8800108bf70bdd4f8840142f66536c0f2440658b94ff6f930cff6ff707844002122460023b047c4f8840150b106f594718847d4f8840106f1e8022946bde87040104770bd70b5044600f5c475082084f88801032084f88901102084f88a01c22084f88c01062084f88d014d2084f88f01432084f89001012084f8910194f8700194f8711184f8920184f8931194f87501b4f8781184f8960184f89711080ab4f87a1184f89801080a84f89a0194f8760194f8732194f8743184f8991194f8771184f89b014cf6dd700026c0f2450084f88b6184f8942184f8953184f89c118047d4f87c1184f89d01080a84f89f01080c84f8a001080e84f8a101a02084f8a36115264df6090c84f89e1184f8a201c0f2470c012009212a461c2384f88e61bde87040604770b54ff2a840c2f229000468bff35f8f20466ff39600b0f1005f33d120684ef66c61ccf2ff01884218bf70bd94f877010025c4f8805188b143f2c942c0f25902002044f2436184f87751904748f65356c0f25a06b04706f1bc008047d4f8840184f8705170b142f68d45c0f24405a847d4f8840105f166018847002804bf0020c4f8840170bd00bf2de9f04182b04ff2a841c2f229010c68bff35f8f21466ff39601b1f1005f75d121684ef66c62ccf2ff0291426ed194f8a81179b394f8aa01c0070ad0d4f8680178b346f68051c2f207010968401a002827dd46f2d835c2f2070555f8040c002854d04ff27717c0f24b0747f62938002607f5437101a8c0f24b0801968847a8b1032084f8ab612860b4f8ac01c04702b0bde8f081d4f8b411c1b302b0bde8f0410847204602b0bde8f04133e001984ef6ed56c0f24b06a861b04706f5af708047e861b847012084f8ab0103202860b4f8ac01c047d4f8bc01a0b10199d4f8b821b4f8ae71531a38bf8b1abb420ad2b4f8b01159b146f68052c2f207021268101a884203d32046022100f06ef802b0bde8f08100bfb0b590f8a841002c42d043f60852c2f2000211880829114622d0114631f8083f082b1dd0114631f8103f082b18d0114631f8183f082b13d0114631f8203f082b0ed0114631f8283f082b09d0114631f8303f082b04d032f8381f0829114614d14a68b2f5870f10d36ff35602012a0cd14a684ff66f63cff6ff737b449a4204d1d0f8b421002a18bf4a60002180f8a81190f8a911b1b1002180f8a91144f68241c2f20701097869b946f2d431c2f20701096839b148f26111c0f24b010546042088472846002c08bfb0bd0321bde8b04000e000bfb0b588b004464cf6dd70c0f245000d468047012840f08f8008208df8010003208df8020010208df8030000208df80400ca208df8050006208df8060018208df8070046f2f030c2f2070050f81c2c94f8a811002a18bf0122002944f68141c2f207014b7818bf0232002b94f8ab3118bf0432002b4ff0410318bf08328df808304c238df8093001238df80a308df80b508df80c2050f8182c4df609058df80d200268c0f24705130a8df80e208df80f30130c120e8df810308df811204268130a8df812208df81330130c120e8df814308df8152002698df81620120a8df8172009788df8181081688df819106821c2f2000109688df81a10090a8df81b1046f68051c2f207010a68130a8df81c208df81d30130c120e8df81e308df81f2000680df10102c4f8b80108680921c4f8bc0101201f23a84708b0b0bd00bf2de9f04f83b0022902d24ff0ff35fee0cde901100120cff680704ef66c644ff2a8464ff6245bccf2ff04c2f229064ff6ff77851ccff6ff7b4ff000084ff0010907e000bf48f2c731c0f24501bff32f8f8847d6f800a0bff35f8f3068bff35f8f00ea0501b1f1005f03d10168a14200f0a7804ff43770fff74bfb0028c5d0594642183d3182f8dc8282f8dd8282f8de8282f8df8282f8e08282f8e18282f8e28282f8e38282f8e48282f8e58282f8e68282f8e78282f8e88282f8e98282f8ea8282f8eb8282f8ec8282f8ed8282f8ee8282f8ef8282f8f08282f8f18282f8f28282f8f38282f8f48282f8f58282f8f68282f8f78282f8f88282f8f98282f8fa8282f8fb8282f8fc8282f8fd8282f8fe8282f8ff8282f8008382f8018382f8028382f8038382f8048382f8058382f8068382f8078382f8088382f8098382f80a8382f80b8382f80c8382f80d8382f80e8382f80f8382f8108382f8118382f8128382f8138382f8148382f8158382f8168382f8178382f8188382d1046080f80a908783c783078447848784c784078547858785c785078647868786c7860787478756e8001f51457ff44dafbff35f8f00bf46e8000121b156e8001f5145f8d041e704464cf6dd70c0f24500804701281dd1029d6978022916d00129204607d000297ff413af00210025fff76cfe0fe0019f41f28831022f0ed14ff4fa730022012741f2883624e02046fff7f2fd0025284603b0bde8f08faa78052f11d3eb782e79072f43ea062310d395f805c0ae79092f4cea0627e4d3ee792d7a46ea052607e041f288364ff4fa7301e041f288360127642b98bf64238b4228bf0b4690f8a81180f8aa21a0f8ac31a0f8ae71a0f8b06171b146f2d431c2f207010968002954d001210446fff71efe0025c4f8bc51bee743f60852c2f2000211880829114622d0114631f8083f082b1dd0114631f8103f082b18d0114631f8183f082b13d0114631f8203f082b0ed0114631f8283f082b09d0114631f8303f082b04d032f8381f0829114632d14a686ff00105b2f5870ffff48daf0123cff680731a40012a7ff486af4b684ff6cd12cff6ff727a44934214bfc0f8b431d0f8b431002b3ff477af4a60012180f8a811a3e748f2ef01c0f24b010420884720b105462046fff758fd65e70121204684f8a91199e76ff001055de700bf334600f005b800bf334600f037b800bf2de9f04182b042f2d7281e4614460d460746c0f24608fef771fa002e18bf002808d108f1160338462946224602b0bde8f041184746f26870c2f207000068c0470028eed00068e028ebd130784bf6d32601900027c0f24e0600200021002209230097b047012002b0bde8f0812de9f04182b042f2d7281e4614460d460746c0f24608fef73bfa002e18bf002808d108f1160338462946224602b0bde8f041184746f26870c2f207000068c0470028eed00068e028ebd130784bf6d32601900027c0f24e060020002100220a230097b047012002b0bde8f08110b582b00446fef70dfa0146002c4ff0000018bf002901d102b010bd46f26870c2f20700006842f2d721c0f24601884790b10068e0284ff00000edd121784bf6d32c0191c0f24e0c002100220b230090e047012002b010bd002002b010bd00bf08b53046fff7ccff002805d002b044f6e970c0f24400004748f68b43c0f24603984708bd012818bf002900d170478968002908bf704710b582b00a794b798c79c97942ea032242ea044242ea0161062910d14ef22151c0f24501044688470146204639b144f6e100c0f2440080470146204619b102b0bde810407047fef7a2f9014620460029f5d046f26870c2f20700006842f2d721c0f246018847014620460029e7d00968e029e4d14bf6d32e4ff0000cc0f24e0e0020002100220c23cdf804c0cdf800c0f0472046d3e710b5059c4ff23710c0f2460080472146fff7a2ff10bd00bf2de9f04f8bb0044600284ff0ff3000f031830d46002900f02d83217801f07f070a2f0edd102f27dc0b2f00f08482102f40f02482204629460bb0bde8f04ffff71fbd052f00f03081072f00f016830a2f40f01482022dc0f00d834ef66c6b4ff2a847ccf2ff0bc2f229074ff6ff764ff0000a4ff0010858e0112f00f0f682122f40f0fc81b5f1010b01f0728004f1010a00230021abeb03000628c0f0b1860aeb0304207962799d1d40ea0222abeb050082424ff0ff3000f2dd821af803306778a678e47843ea072343ea064343ea0463b3f5802f00f2ce82c3f580239a4200f2c982002a02eb050318bf01215b45d1d3002901f03d80fef7f3f8002800f080864ef66c674ff2a845ccf2ff07c2f229054ff6ff764ff0000800f02fbc48f2c731c0f24501bff32f8f8847d7f80090bff35f8f38680321cff680710140b1f1005fbff35f8f03d10168594500f0a2834ff43770fff71df8002800f052864ff62451cff6ff7142183d3182f8dca282f8dda282f8dea282f8dfa282f8e0a282f8e1a282f8e2a282f8e3a282f8e4a282f8e5a282f8e6a282f8e7a282f8e8a282f8e9a282f8eaa282f8eba282f8eca282f8eda282f8eea282f8efa282f8f0a282f8f1a282f8f2a282f8f3a282f8f4a282f8f5a282f8f6a282f8f7a282f8f8a282f8f9a282f8faa282f8fba282f8fca282f8fda282f8fea282f8ffa282f800a382f801a382f802a382f803a382f804a382f805a382f806a382f807a382f808a382f809a382f80aa382f80ba382f80ca382f80da382f80ea382f80fa382f810a382f811a382f812a382f813a382f814a382f815a382f816a382f817a382f818a382d1c0f800b080f80a808683c683068446848684c684068546858685c685068646868686c6860687468757e8001f49457ff446afbff35f8f47e80001002900f0fa8257e8001f4945f6d039e74ef66c664ff2a847ccf2ff06c2f229074ff6ff7b4ff000084ff00109022d2cbf6078ff20059006e048f2c731c0f24501bff32f8f8847d7f800a0bff35f8f38680321cff680710140b1f1005fbff35f8f03d10168b14200f091824ff43770fef743ff002800f0d9844ff62451cff6ff7142183d3182f8dc8282f8dd8282f8de8282f8df8282f8e08282f8e18282f8e28282f8e38282f8e48282f8e58282f8e68282f8e78282f8e88282f8e98282f8ea8282f8eb8282f8ec8282f8ed8282f8ee8282f8ef8282f8f08282f8f18282f8f28282f8f38282f8f48282f8f58282f8f68282f8f78282f8f88282f8f98282f8fa8282f8fb8282f8fc8282f8fd8282f8fe8282f8ff8282f8008382f8018382f8028382f8038382f8048382f8058382f8068382f8078382f8088382f8098382f80a8382f80b8382f80c8382f80d8382f80e8382f80f8382f8108382f8118382f8128382f8138382f8148382f8158382f8168382f8178382f8188382d1066080f80a90a0f81cb0a0f81eb0a0f820b0a0f822b0a0f824b0a0f826b0a0f828b0a0f82ab0a0f82cb0a0f82eb0a0f830b0a0f832b0a0f834b0a0f836b0a0f838b0a0f83ab057e8001f51457ff437afbff35f8f00bf47e80001002900f0d98157e8001f5145f6d029e70f2f9b4600f0f481a7f11300012840f2ef81092f00f05d83082f40f0d583002a4ff0ff3000f0e880022dc0f0e58094f80190b9f1000f00f0ad8402264ff0010848f2482ab21caa4200f29c84a019a15d407851ea002100f095848e18ae4200f29184a05cde4600f07f07153fffb2fd2f16d8c0b20f280ed9a0f1830cbcf10c0f4ff0ff3000f2b88008fa0cf741f249031f4205d1b0e008fa00f717ea0a0febd0a01800227346fff76dfd002840f06a84b9f10109c6d100f06dbc4ff2a846c2f229063468bff35f8f20466ff39600b0f1005f40f00f8620684ef66c67ccf2ff07b8424ff0000040f08780c4f8680184f8660184f86401d4f86c11c4f8600184f8650139b148f2c732c4f86c01c0f2450208469047d4f87802002818bf03f08ef90021c4f87812206c40f2030942f68d48cff68079c0f24408a4f8441040b1c047206c08f166018847002804bf0020206446f67560c0f2510080473568bff35f8f05ea0900b0f1005f2bd12868b84228d195f877014ff0000ac5f880a188b143f2c942c0f25902002044f2436185f877a1904748f6535bc0f25a0bd8470bf1bc008047d5f8840185f870a150b1c047d5f8840108f166018847002804bf0020c5f884013068bff35f8f00ea0901b1f1005f40f029850168b94240f0258590f8a811002900f01a85fff705f900f01cbd022d08bf112900f02b810bb0bde8f08f4ef66c6a4ff2a847ccf2ff0ac2f229074ff6ff764ff0000b4ff0010806e048f2c731c0f24501bff32f8f8847d7f80090bff35f8f38680321cff680710140b1f1005fbff35f8f03d10168514500f05e834ff43770fef75ffd002800f056834ff62451cff6ff7142183d3182f8dcb282f8ddb282f8deb282f8dfb282f8e0b282f8e1b282f8e2b282f8e3b282f8e4b282f8e5b282f8e6b282f8e7b282f8e8b282f8e9b282f8eab282f8ebb282f8ecb282f8edb282f8eeb282f8efb282f8f0b282f8f1b282f8f2b282f8f3b282f8f4b282f8f5b282f8f6b282f8f7b282f8f8b282f8f9b282f8fab282f8fbb282f8fcb282f8fdb282f8feb282f8ffb282f800b382f801b382f802b382f803b382f804b382f805b382f806b382f807b382f808b382f809b382f80ab382f80bb382f80cb382f80db382f80eb382f80fb382f810b382f811b382f812b382f813b382f814b382f815b382f816b382f817b382f818b382d1c0f800a080f80a808683c683068446848684c684068546858685c685068646868686c6860687468757e8001f49457ff446afbff35f8f47e80001002900f0b68257e8001f4945f6d039e790f84410059f61b1016c39b142f68d42c0f244020646084690473046002180f844100121002f40f04082032dc0f03d82a078082800f28a8446f67561c0f251019631884700f082bc164600f0a9fc002800f0c482611c142fa5f1010200f0b782132f5b4640f0b78200f0eefdb5e26678002e00f04581022e00f2b08240f03d84062dc0f0ab82a178e2782379677941ea022143ea072232290691079280f02784322100f029bc6078002840f097824cf6dd70c0f24500804701284ff000007ff4c7aecde9070040f20830c0f210000690ff208df8280044f25220c0f2010009904ef6a970c0f24700804798b147f2a620c2f2070000880122c1b264298df8272008d80721b0f5807f38bf03218df827108df8280040f2d260adf81c00052006ac8df81e00e01d09a90522f9f7bbfa4df60f17c0f247070120092122460c23b8470bb0bde8f08f48f2c7314846c0f24501bff32f8f88472c68bff35f8fd5f800900320cff6807000ea0900b0f1005fbff35f8f04d1d9f80000b84200f03b824ff43770fef7f3fb002800f0288281464ff62450cff6ff7000bf09eb00013d3081f8dc8281f8dd8281f8de8281f8df8281f8e08281f8e18281f8e28281f8e38281f8e48281f8e58281f8e68281f8e78281f8e88281f8e98281f8ea8281f8eb8281f8ec8281f8ed8281f8ee8281f8ef8281f8f08281f8f18281f8f28281f8f38281f8f48281f8f58281f8f68281f8f78281f8f88281f8f98281f8fa8281f8fb8281f8fc8281f8fd8281f8fe8281f8ff8281f8008381f8018381f8028381f8038381f8048381f8058381f8068381f8078381f8088381f8098381f80a8381f80b8381f80c8381f80d8381f80e8381f80f8381f8108381f8118381f8128381f8138381f8148381f8158381f8168381f8178381f8188381d10120c9f8007089f80a00a9f81c60a9f81e60a9f82060a9f82260a9f82460a9f82660a9f82860a9f82a60a9f82c60a9f82e60a9f83060a9f83260a9f83460a9f83660a9f83860a9f83a6055e8000fa0427ff42fafbff35f8f45e80090002800f07f8155e8000fa042f6d022e7002480f843414cf6dd70c0f2450080470146204601297ff49bad4df25f50c0f255000bb0bde8f04f004708064ff0210158bf11218d42c0f05181002804f101060ad54cf6dd70c0f24500154680472a46022818bf04f111063079717950ea01244ff0ff301ebfb179f37951ea03253ff46fad317b737b41ea03218c427ff468adb17bf37b41ea03218d427ff461ad3078717840ea012804eb0800b0f5207f4ff0ff303ff655adb178f37841ea0327e919b1f5f07f3ff64cad317a737a41ea032904eb0901b1f5207f3ff642adb17af37a41ea0326a919b1f5f07f3ff639ad924600f0defa002800f0f98041463a464b46cde90145009602f0adf9dbf800100f2909d80bebc1020131a2f80690168154819581cbf80010baf1000f40f0e78095e2f81e18bf0120bb1f18bf012318424ff0ff307ff40dad032dfff40aad032f00f0b281062f7ff404ad00200021164602f0edfa00f0a5fa002800f0c0800246601c691e4ff4f0774ff4a073009702f01efc002800f0b380dbf800100f2900f2b3800bebc1020023d38013814ff4207353814ff4f07301319381cbf80010a3e0059f00210020002f3ff4c0ad012f19d1052d17d3a378581e06284ff000003ff6c8ace17803293ff6c4ac2279002a3ff4c0ac46f67560c0f2510000f59a771846b84734e2022f05d146f67560c0f2510080472ce2032f40f01381072dc0f01081a078e278217940ea02206579a67901284ff0010498bf204644f62062904228bf104646f67562c0f2510202f5e272642928bf6421904746f2a070c2f207000068002800f0048245ea0621012988bf0c4642f68d41c0f24401a1f1400221469047f5e10020022d2cbf6178ff21002800f0ee81024602294ff0000025d0012920d000297ff466ac4cf67e21caf21011907610837960108150609683d683168456849684d684168556859685d685168656869686d6861687568782f83c000bb0bde8f08f01209072c2e190720bb0bde8f08f5b4600f0ecfe01e001f067fb20b14ff0ff300bb0bde8f08f002e00f0b081584601f0a7ffabe1d9f86c0100286ed14ff48020fef7b4f90028e9d000210022831881544032b2f5802f59709970d970197159719971d971197259729972d972197359739973d973197459749974d974197559759975d975197659769976d976197759779977d97783f8201083f8211083f8221083f8231083f8241083f8251083f8261083f8271083f8281083f8291083f82a1083f82b1083f82c1083f82d1083f82e1083f82f1083f8301083f8311083f8321083f8331083f8341083f8351083f8361083f8371083f8381083f8391083f83a1083f83b1083f83c1083f83d1083f83e1083f83f109ad1c9f86c0100210aeb010006794579437846ea0525d9f86c611af8012087788c1d06eb0321c078114401eb074101eb00600aeb04012a46f8f7caff291959454ff00000e0d3fff799bb3a1f80460020b2fa82f2022d88bf012052091040084001284ff000007ff489ab4cf6cd42e91eccf6cc42a578a1fb0212b5eb920f88bf95082f4608f14603302d28bf3027e11c07eb870204461846f8f79aff002d88f8447088f8454000f0b480d8f8400038b94046f9f7f7fb0028c8f8400000f0fc8042f68d41c0f24401a1f1400201219047d2e0080600f1d480082dfff415af07214ff0050c0123e71897f802804ff0ff30b8f1000f3ff442abfe78002e3ff43eab14f8039005914fea880101eb8903b3f5207f04913ff632ab97f801a0770007eb4a03b3f5f07f3ff629ab04eb0c0014f80c104078039241ea002081b2012002f00bf900f0c3f800283ff4deae05990aeb8a020c4400ebc2104fea4803691a00eb49022046009702f037fa00283ff4ccaedbf800100f290dd84fea89020bebc106f280049a4fea4a03013133817281b781cbf80010039900297ff4beae6ce090f8a911002918bffef7e7fb94f84301002684f8436158b14cf6dd70c0f245008047012804d14df25f50c0f255008047d4f83c0194f84251c4f8386184f84261a4f8406150b1c047d4f83c0108f166018847002804bf0020c4f83c010120a072ddb34af29f37c0f246070021002200230024b84720460bb0bde8f08fb1f5fa6f02d94ff4fa6106910121044680f843114cf6dd70c0f24500804701281dd14df25f55c0f25505a5f188008047022e08bf002801d058b910e048f2d31206a9c0f24b020220904740b10646a8473046002184f843110bb0bde8f08f00200bb0bde8f08f0c2dfff441aee078e17988427ff43cae2079217a88427ff437ae4cf6dd70c0f24500164680470523022808bf01230b214ff0090c324616e746f675600024c0f2510088f844408047a3e700bf2de9f04f81b04ef66c6b4ff2a8454ff6245848f2c73accf2ff0bc2f229054ff6ff76cff6ff7800274ff00109c0f2450a03e000bfbff32f8fd0472c68bff35f8f2868bff35f8f01466ff39601b1f1005f03d10168594500f0a9804ff43770fdf7b5ff002800f01a81414600bf42183d3182f8dc7282f8dd7282f8de7282f8df7282f8e07282f8e17282f8e27282f8e37282f8e47282f8e57282f8e67282f8e77282f8e87282f8e97282f8ea7282f8eb7282f8ec7282f8ed7282f8ee7282f8ef7282f8f07282f8f17282f8f27282f8f37282f8f47282f8f57282f8f67282f8f77282f8f87282f8f97282f8fa7282f8fb7282f8fc7282f8fd7282f8fe7282f8ff7282f8007382f8017382f8027382f8037382f8047382f8057382f8067382f8077382f8087382f8097382f80a7382f80b7382f80c7382f80d7382f80e7382f80f7382f8107382f8117382f8127382f8137382f8147382f8157382f8167382f8177382f8187382d1c0f800b080f80a908683c683068446848684c684068546858685c685068646868686c6860687468755e8001fa1427ff44eafbff35f8f45e8000121b155e8001fa142f8d043e7d0f87812002974d104464ff4163002f0a5fa014600284ff0000069d0002200bf8b1888544032b2f5163f58709870d870187158719871d871187258729872d872187358739873d873187458749874d874187558759875d875187658769876d876187758779877d87783f8200083f8210083f8220083f8230083f8240083f8250083f8260083f8270083f8280083f8290083f82a0083f82b0083f82c0083f82d0083f82e0083f82f0083f8300083f8310083f8320083f8330083f8340083f8350083f8360083f8370083f8380083f8390083f83a0083f83b0083f83c0083f83d0083f83e0083f83f009ad1c4f8781200e00021084601b0bde8f08f00bf092a1cbf4ff0ff3070472de9f04f8db08a4683460693fcf72dff002800f015824ef66c684ff2a847ccf2ff08c2f229074ff6ff740026012507e000bf48f2c731c0f24501bff32f8f8847d7f80090bff35f8f3868bff35f8f01466ff39601b1f1005f03d10168414500f0ad804ff43770fdf758fe002800f0a5804ff62451cff6ff7100bf42183d3182f8dc6282f8dd6282f8de6282f8df6282f8e06282f8e16282f8e26282f8e36282f8e46282f8e56282f8e66282f8e76282f8e86282f8e96282f8ea6282f8eb6282f8ec6282f8ed6282f8ee6282f8ef6282f8f06282f8f16282f8f26282f8f36282f8f46282f8f56282f8f66282f8f76282f8f86282f8f96282f8fa6282f8fb6282f8fc6282f8fd6282f8fe6282f8ff6282f8006382f8016382f8026382f8036382f8046382f8056382f8066382f8076382f8086382f8096382f80a6382f80b6382f80c6382f80d6382f80e6382f80f6382f8106382f8116382f8126382f8136382f8146382f8156382f8166382f8176382f8186382d1c0f8008085728483c483048444848484c484048544858485c485048644868486c4860487448757e8001f49457ff447afbff35f8f00bf47e8000129b157e8001f4945f8d03be70020002800f03f819af800109af801209af802309af8037041ea022141ea034141ea07624ff6fe77c0f20307ba424ff0ff3100f28982d0f86c310846002b00f02481995c4ff0ff30002900f01e81134493f80190b9f1000f00f0178109fb01f09d1c4ff0000c4ff0000368b3a7f101089e18be4200f007819e462b441c78240904d00126a0421bd2fde000bf464500f0fa805c781cb10226a04211d2f3e00524cff6fc743444042cc0f0ed809c78db7854ea032400f0e7800426a042c0f0e380001b06eb0e03d3d19af804009af8052098469af806309af807609af80870cdf8009040ea022943ea0626b8060f2307f00f0403eae07000fb04f389204343db0a8df824300e2317f0200f08bf4ff00f0c08bf012304fb03f300fb03f34fead3238df825304ff00d0308bf022304fb03f300fb03f34fead3238df826304ff00c0308bf032304fb03f300fb03f34fead3238df827304ff00b0308bf042304fb03f300fb03f34fead3238df828304ff00a0308bf052304fb03f300fb03f34fead3238df829304ff0090308bf062304fb03f300fb03f34fead3238df82a304ff0080308bf072304fb03f300fb03f34fead3238df82b304ff0070308bf082304fb03f300fb03f34fead3238df82c304ff0060308bf092304fb03f300fb03f34fead3238df82d304ff0050308bf0a2304fb03f300fb03f34fead3238df82e304ff0040308bf0b2304fb03f300fb03f34fead3238df82f304ff0030308bf0c2304fb03f300fb03f34fead3238df830304ff0020308bf0d2304fb03f300fb03f34fead3238df831304ff0010308bf0e2363434343db0a8df832300cfb04f358434ff0010ec00ab8f1000fcdf814808df8330000f06f8107f010008eea1010002403904ff0000804950ce04ff0ff300db0bde8f08fdde90704049d04440598844280f05881285d0894020901d0012313e0059a171b012f00f04d812b195a780ab1022309e0042fc0f045819f78db7857ea032200f03f810423079310f00f0309a810f803a018bf012303984fea0a1e40ea030c12f00300474600f08080b8fbf1f300259f19b7f1ff3fc8bf012505ea0c05012d1dd103fb11834b44dd09042d17d87d090e2d14d807eb87050beb85155f08ec5ddb076ff00f03019408bf0f230290504608bf7046019c234003430298eb55012808f1010751d0b7fbf1f300249d19b5f1ff3fc8bf012404ea0c04012c1ad103fb11734b44dc09042c14d86c090e2c11d805eb85040beb84145d08db070290605d6ff00f03574604bf0f237746034002983b436355022808f1020726d0b7fbf1f300259c19b4f1ff3fc8bf012505ea0c05012d18d103fb11734b44dd09042d12d865090e2d0fd804eb84040beb84145d08db07605d6ff00f03574604bf0f23774603403b43635508f10307531e032b904405d246e700bf0437b8453ff442afb7fbf1f40025a319b3f1ff3fc8bf012505ea0c05012d18d104fb11744c44e509042d12d85d090e2d0fd803eb83030beb831365085a5de4076ff00f04504604bf0f2470462240104358557c1cb4fbf1f50020ab19b3f1ff3fc8bf012000ea0c00012819d105fb114000eb0904e009042812d858090e280fd803eb83000beb80106208835ce4076ff00f04554604bf0f24754623402b438354bc1cb4fbf1f50020ab19b3f1ff3fc8bf012000ea0c00012819d105fb114000eb0904e009042812d858090e280fd803eb83000beb80106208835ce4076ff00f04554604bf0f24754623402b438354fc1cb4fbf1f50020ab19b3f1ff3fc8bf012000ea0c0001287ff47baf05fb114000eb0904e00904283ff673af58090e283ff66faf03eb83000beb80106208835ce4076ff00f04554604bf0f24754623402b4383545de708460db0bde8f08f09eb01000099b0f5207f06eb0103a8bf4ff42070b3f5f07fa8bf4ff4f0730699484588bfb34203d800200db0bde8f08f0f680f2ff8d89a1ba0eb090001ebc7035881781ca3f806901e819a810860ebe70a2a3cbf4ff0ff3070472de9f04f95b017468a4605461c46fcf77afb002800f0f9809af8096006f10a0087424ff0ff3040f0f2809af800109af801209af802309af8037041ea022141ea034141ea07624ff68061c0f203018a4200f2dd8010960e95cde90c429af808004ef66c644ff2a8454ff62456ccf2ff04c2f229054ff6ff77cff6ff764ff0000b4ff001080f9007e000bf48f2c731c0f24501bff32f8f8847d5f80090bff35f8f2868bff35f8f01466ff39601b1f1005f03d10168a14200f0ad804ff43770fdf77afa002800f0e681314642183d3182f8dcb282f8ddb282f8deb282f8dfb282f8e0b282f8e1b282f8e2b282f8e3b282f8e4b282f8e5b282f8e6b282f8e7b282f8e8b282f8e9b282f8eab282f8ebb282f8ecb282f8edb282f8eeb282f8efb282f8f0b282f8f1b282f8f2b282f8f3b282f8f4b282f8f5b282f8f6b282f8f7b282f8f8b282f8f9b282f8fab282f8fbb282f8fcb282f8fdb282f8feb282f8ffb282f800b382f801b382f802b382f803b382f804b382f805b382f806b382f807b382f808b382f809b382f80ab382f80bb382f80cb382f80db382f80eb382f80fb382f810b382f811b382f812b382f813b382f814b382f815b382f816b382f817b382f818b382d1046080f80a808783c783078447848784c784078547858785c785078647868786c7860787478755e8001f49457ff44bafbff35f8f00bf45e8000149b155e8001f4945f8d03fe74ff0ff3015b0bde8f08fd0f86c91109eb9f1000f00f039810f9c0f23a10604f00f0203eae171514389235943c90a8df844100e219af804c09af805709af806e09af8075014f0200f08bf012102fb01f103fb01f14fead1218df845104ff00d0108bf022102fb01f103fb01f14fead1218df846104ff00c0108bf032102fb01f103fb01f14fead1218df847104ff00b0108bf042102fb01f103fb01f14fead1218df848104ff00a0108bf052102fb01f103fb01f14fead1218df849104ff0090108bf062102fb01f103fb01f14fead1218df84a104ff0080108bf072102fb01f103fb01f14fead1218df84b104ff0070108bf082102fb01f103fb01f14fead1218df84c104ff0060108bf092102fb01f103fb01f14fead1218df84d104ff0050108bf0a2102fb01f103fb01f14fead1218df84e104ff0040108bf0b2102fb01f103fb01f14fead1218df84f104ff0030108bf0c2102fb01f103fb01f14fead1218df850104ff0020108bf0d2102fb01f103fb01f14fead1218df851104ff0010108bf0e2102fb01f103fb01f14fead1218df852104ff0000108bf0f21514359430024c90a002e8df853106ad00d994ff6fe7449440af10a0a4cea07284eea052b4ff0000cc0f203040d9104e010990cf1010c8c455ed01af80c104a1e1f2af5d34ab2202a4bdb0d9a02eb810111f8802c11f87f3c11f87e7c11f87d1c42ea032242ea074242ea0165a54238d819f805104ff0ff34a9b309eb050253788bb34ff6fe7402f1020e03fb01f60023c0f2030406e000bf0121be4221d3f61b0b44c5d05a19a2421bd00eeb03010f783f09f1d1671eba4213d04f781fb10221be42ecd20de00527cff6fc773a44042a07d38a78c97852ea012702d00421be42ddd24ff0ff34204615b0bde8f08f4ff0ff3015b0bde8f08f0c990122063100910f99002601f0100182ea1111cde9071a1af806101f2908d84144109f0b3901360024be428846f3d1dde7d0f86c214ff0ff34002ad7d00d9b03eb810111f8803c11f87f7c11f87e5c11f87d1c43ea072343ea054343ea01614ff6fe73c0f203039942c0d812f801e0bef1000fbbd053185f78002fb7d007fb0ef2ddf83890002acde9027600f0ac819d1c00244ff6fe736618c0f203039e42a3d02f193b781b0901d0012718e04ff6fe73c0f20303013b9e4296d07b780bb102270de00523cff6fc733344042bfff48cafbb78ff7853ea07233ff486af04279a42fff482afd21a3c44d3d1002c00f07b81002100220f91cde9054509e0dde90a12059c0a44ddf820a0069da24280f06b81a95c0b920e0901d0012212e0a71a012f00f06181ab185e780eb1022209e0042fc0f059819f78db7857ea032600f0538104220a9211f00f0111aa525c18bf0121079b0f9c19434fea021a16f00305a446099600f08c80b4fbfef7002607fb1e434344b3f1ff3fc8bf01260e40012e1fd117eb0b071cd4de09042e19d87e090e2e16d807eb870709eb871c5e081cf80670db076ff00f03019708bf0f230495154608bf5546019f3b402b43049d0cf80630012d04f1010c5ad0bcfbfef6002706fb1ec34344b3f1ff3fc8bf01270f40012f1fd116eb0b071cd4de09042e19d87e090e2e16d807eb870709eb871c5e081cf80670db076ff00f03019708bf0f230495154608bf5546019f3b402b43049d0cf80630022d04f1020c29d0bcfbfef5002705fb1ec34344b3f1ff3fc8bf01270f40012f1ad115eb0b0717d4de09042e14d87e090e2e11d807eb870709eb87175e08db0717f806c06ff00f03154604bf0f23554603ea0c032b43bb5504f1030c099d6b1e032b2c440f9407d237e700bf0f9b0cf1040c63453ff431afbcfbfef5002605fb1ec34344b3f1ff3fc8bf01260e40012e1bd115eb0b0518d4de09042e15d86e090e2e12d805eb850509eb85155e08db07af5d6ff00f03914604bf0f23d1463b4043ea0903ddf83890ab550cf10103b3fbfef5002605fb1e334344b3f1ff3fc8bf01260e40012e18d115eb0b0515d4de09042e12d86e090e2e0fd805eb850509eb85155e08db07af5d6ff00f03144604bf0f2354463b402343ab550cf10203b3fbfef5002405fb1e334344b3f1ff3fc8bf01240c40012c18d115eb0b0515d4dc09042c12d86c090e2c0fd805eb850409eb84145d08db07665d6ff00f03174604bf0f23574633403b4363550cf10303b3fbfef5002405fb1e334344b3f1ff3fc8bf01240c40012c7ff471af15eb0b053ff56dafdc09042c3ff669af6c090e2c3ff665af05eb850409eb84145d08db07665d6ff00f03174604bf0f23574633403b43635553e7029a08eb0e010beb0203b1f5207f0d4628eae872a8bf4ff42075b3f5f07fa8bf4ff4f07395421edd039e109f5b457ff606aeddf830e0def800400f2c3ff6ffada3eb0b0c009ba5eb020803ebc40523f83420621ca5f802b0a5f80480a5f806c0cef80020ebe5039e109fe8e5062a3cbf4ff0ff3070472de9f04fadf2944d9a46154688460f90fbf7fbfe002800f0d68098f80510881d854240f0298446f6ac10c2f20700d0f800b0bbf1000f00f01f849bf80c009bf80d209bf80e309bf80f7040ea022040ea034040ea0769a9f1810010f1800f4ff0ff30c0f0b2809bf810209bf811309bf8137042ea03229bf8123042ea034242ea07620692813a12f5817f40f29e800029cdf828b000f09d8008f1060b002426aa4ff4e01c00270ae000bf05f1004042f8240001378f4204f1010480f08e801bf80750681e1e28f0d968b21f2801dd012075e0a5f1c2000beb07061d28a1eb07000fd8012800f0c88396f9010010f1410f00f3c28300f03f0365f38a1302201d465de005f0f003e02b24d10328c0f0b48396f9013013f1410f00f3ae8396f9020010f1410f00f3a883e02ddeb202d1a02ec0f0a283ed2d02d19f2e00f29d832b039bb206f03f0643ea861300f03f001d18032034e004284ff0ff3036d3a5f1f50313f1050f31d396f9013013f1410f2cdc96f9020010f1410f00f37e8396f9036016f1410f00f37883f02ddbb202d1902bc0f07283f42d02d18f2b00f26d830cea854e03f03f054eea053300f03f0043ea801006f03f0326aac518042000bf074442f8245076e74ff0ff300df2944dbde8f08f0021012007915ee0002c57d0a4f1010bcdf86090cdf810a000250df1780a5f46914608e026aaab4505f1010509f10409a7f1010739d052f825100029f3d400202b4687421dd009eb80067268b2f1ff3f18dc5a1c934514d0b268b2f1ff3f11dc9a1c93450dd0f268b2f1ff3f0adcda1c934506d032690433002a00f10400e0d400e000220a9853461aae009601f0ecf8002800f008831a980028c3d046f2a1415046c0f24e018847bce7ddf810a0ddf828b0ddf860900020079404e00020ddf828b00790012098f804400f21a20604f00f0501eae271694389225143c90a8df8681001260e2198f800c098f801e098f8023098f8037014f0200f08bf0e2608bf012105fb01f102fb01f14fead1218df869104ff00d0108bf022105fb01f102fb01f14fead1218df86a104ff00c0108bf032105fb01f102fb01f14fead1218df86b104ff00b0108bf042105fb01f102fb01f14fead1218df86c104ff00a0108bf052105fb01f102fb01f14fead1218df86d104ff0090108bf062105fb01f102fb01f14fead1218df86e104ff0080108bf072105fb01f102fb01f14fead1218df86f104ff0070108bf082105fb01f102fb01f14fead1218df870104ff0060108bf092105fb01f102fb01f14fead1218df871104ff0050108bf0a2105fb01f102fb01f14fead1218df872104ff0040108bf0b2105fb01f102fb01f14fead1218df873104ff0030108bf0c2105fb01f102fb01f14fead1218df874104ff0020108bf0d2105fb01f102fb01f14fead1218df8751006fb05f102fb01f14fead1218df876104ff0000108bf0f2169435143c90a00284ff000008df877107ff4cdae43ea0720079a484403904cea0e290af10600571e00260df198080190cdf810a0029718e000bf46f2a1411ea8c0f24e0188479df87c009df87d10dde90ab9029fdde9072640ea01200df1980801369642814400f0ff8158f82610b1f1ff3f1edd33469f421fd008eb83004268b2f1ff3f1adc0133bb4216d08268b2f1ff3f13dc0133bb420fd0c268b2f1ff3f0cdc0133bb4208d002690133002ae2d404e001f01f000b38d2e7002258461eab19ad009500f0abff002800f0c781199900290d9100f0ba819df880209df881309df87e009df87f1052ea03259df8822040ea01279df8833010979df884704fea024208969df8856042ea0362069b4fea074747ea06672b4403eb2743039fcdf82c90a7eb030609eb22491aaf149500f05e810902109b014400f0030809f101004ff0010c099009f102000ceb530305900d980c934b1e0e930b9b0130121415900ceb510003eb020e9a1acde91180a1eb08001890d0074ff0000a17904feace70169013960ae014980af1010a824512981599139e0144159100f029810aeb06014b090e2befd810980028ecd00e9801eb810103280f984ff0000600eb811e80f0848011980028ded0dde90c105feac67c0afb01084fea560018f8000000f00f03c1b208bf0b09b3fa83f0400910ea141f14d106eb0901c80904280fd848081ef80020fb5c02f00f0b02f0f0021a431aafc90708bf4bea03120ef8002011980128b1d0701c400818f80000bcf1000fc1b24fea111308bf00f00f03d8b2b0fa80f0400910ea141f14d109983118c80904280fd848081ef80020fb5c02f00f0b02f0f0021a431aafc90708bf4bea03120ef80020119802283ff486afb01c400818f80000bcf1000f00f00f01c2b208bf1109b1fa81f0400910ea141f7ff474af05983318d80904283ff66eaf58081ef80020795c02f00f0602f0f0020a43db0708bf46ea01120ef800205de7ddf8548007e000bf18980436b04208f102083ff471af18f8011c0023c9b2102938bf012313ea141f09eb060c16d14feadc13042b12d84fea5c0309091ef80320795c02f00f0b02f0f0020a431aaf5feac97008bf4bea01120ef8032018f8010c00f00f01b1fa81f0400910ea141f15d10cf10103d809042810d858081ef80020795c02f00f03179d43ea011302f0f002002d08bf42ea01030ef8003098f80000c1b210294ff0000038bf012010ea141f15d10cf10203d809042810d8080959081ef80120385c02f00f0302f0f002169d0243002d08bf43ea00120ef8012098f8000000f00f01b1fa81f0400910ea141f8ad10cf10303d80904283ff685af58081ef80020795c02f00f03179d43ea011302f0f002002d08bf42ea01030ef8003072e700bf109809eb00011498b1f5207f06eb000229eae970a8bf4ff42071b2f5f07fa8bf4ff4f072ddf810a081427ff70fae26eae6739a427ff70aaedaf800700f2f3ff605ae019dd21a091a05ebc70625f83700781c7380b180f280caf80000f6e59df87c009df87d10079a40ea012001e64ff0ff300df2944dbde8f08f00200df2944dbde8f08f2de9f04f83b04ef66c654ff2a8464ff6245948f2c73bccf2ff05c2f229064ff6ff77cff6ff7900244ff0010ac0f2450b029002e0bff32f8fd847d6f80080bff35f8f3068bff35f8f01466ff39601b1f1005f03d10168a94200f0a8804ff43770fcf7e4f9002800f0d280494642183d3182f8dc4282f8dd4282f8de4282f8df4282f8e04282f8e14282f8e24282f8e34282f8e44282f8e54282f8e64282f8e74282f8e84282f8e94282f8ea4282f8eb4282f8ec4282f8ed4282f8ee4282f8ef4282f8f04282f8f14282f8f24282f8f34282f8f44282f8f54282f8f64282f8f74282f8f84282f8f94282f8fa4282f8fb4282f8fc4282f8fd4282f8fe4282f8ff4282f8004382f8014382f8024382f8034382f8044382f8054382f8064382f8074382f8084382f8094382f80a4382f80b4382f80c4382f80d4382f80e4382f80f4382f8104382f8114382f8124382f8134382f8144382f8154382f8164382f8174382f8184382d1056080f80aa08783c783078447848784c784078547858785c785078647868786c7860787478756e8001f41457ff44fafbff35f8f00bf46e8000121b156e8001f4145f8d043e70446fef757f9002c18bf002805d102990120487103b0bde8f08fc4f8600101254ff4f07084f8645101904ff4207049f683570090c0f2470700200021002200230026b84740b184f864610298c4f86061457103b0bde8f08f0298057103b0bde8f08f0024cde700bf2de9f04f87b0dde91065924643ea0102ddf848b02a43d20722d14fea550800eb510900eb5304abf1010700252846564588bf384600eb0a01304401eb810100eb800009eb811104eb80104246f6f7ccff013f781c05f10105e8d107b0bde8f08f4ff6fc722a4005f0030406926a1e002701920494cde902a005e000bf059f039801375f45e9d0fa435645059788bf0beb020707eb0a0202eb820200eb821cba1902eb8202042d00eb821e4ff00008c0f09c80ddf8049000bf40468b4288bf484600eb010200eb03044fea52001cf800706ff0010088ea000608f1010088bfa8196ff0020686ea080608f1020b88bf05eb060b6ff0030686ea080608f1030a4feac27288bf05eb060a07f00f06002a4fea540208bf3e091ef80270e40707f00f0407f0f007374408bf44ea06170ef80270421854081cf804401844d20704f00f064fea500208bf26091ef80240c00704f00f0004f0f004344408bf40ea06140beb01000ef8024042081cf802200beb0304c00702f00f064fea540008bf16091ef80020e40702f00f0402f0f002324408bf44ea06120ef800200aeb010042081cf802200aeb0304c00702f00f064fea540008bf16091ef80020e40702f00f0402f0f002324408bf44ea06120ef80020069808f104088045a9f104097ff46dafddf808a0109eddf848b0049c002c3ff446af6fea080047468b4288bf2f18781842081f441cf80220c0074fea57091ef8090002f00f0408bf140900f00f0200f0f0002044ff0708bf42ea0410049c0ef80900012c3ff423af08f10102a5eb08098b4288bfa9f102025418670802eb030ae4074fea5a041cf807701ef8042007f00f0002f00f0b02f0f00208bf380902445feaca77ddf808a008bf4bea00120498109eddf848b00ef80420049c02283ff4f6ae08f102008b4288bfa9f10300421854081cf8047000eb030cd2074fea5c021ef8020007f00f0400f00f0800f0f00008bf3c0920445feacc7708bf48ea0410049c0ef80200d2e600bf2de9f04f83b04ef66c664ff2a8474ff6245a48f2c738ccf2ff06c2f229074ff6ff74cff6ff7a00254ff0010bc0f24508cde9010103e000bfbff32f8fc047d7f80090bff35f8f3868bff35f8f01466ff39601b1f1005f03d10168b14200f0a8804ff43770fbf76cff002800f00581514642183d3182f8dc5282f8dd5282f8de5282f8df5282f8e05282f8e15282f8e25282f8e35282f8e45282f8e55282f8e65282f8e75282f8e85282f8e95282f8ea5282f8eb5282f8ec5282f8ed5282f8ee5282f8ef5282f8f05282f8f15282f8f25282f8f35282f8f45282f8f55282f8f65282f8f75282f8f85282f8f95282f8fa5282f8fb5282f8fc5282f8fd5282f8fe5282f8ff5282f8005382f8015382f8025382f8035382f8045382f8055382f8065382f8075382f8085382f8095382f80a5382f80b5382f80c5382f80d5382f80e5382f80f5382f8105382f8115382f8125382f8135382f8145382f8155382f8165382f8175382f8185382d1066080f80ab08483c483048444848484c484048544858485c485048644868486c4860487448757e8001f49457ff44fafbff35f8f00bf47e8000121b157e8001f4945f8d043e7019a029b01210172b2b3014631f81c2f9a422cd0c28b9a4229d0028c9a4226d0428c9a4223d0828c9a4220d0c28c9a421dd0028d9a421ad0428d9a4217d0828d9a4214d0c28d9a4211d0028e9a420ed0428e9a420bd0828e9a4208d0c28e9a4205d0028f9a4202d0428f9a4208d10121817603b0bde8f08f417203b0bde8f08f427a72b98288029b9a1a13b2b3f1ff3f05dd92b2022a24bf0122427601e00122027600224272029ac38882809a4284bf029ac28090f83c20029b21f81230511c01f00f0180f83c1003b0bde8f08f00bf2de9f04f89b0129f029003fb07f000294fea400b069300f0d58100200890029807924ff0010a4ff000084ff0000e002400264ff0000c0022009107e04ff0000c03244e4601328a4200f0c181bcf1000f40f0bb8110f80290022cefd0012c15d0ddf81cc0129b002c554640f095805fea191409f00f070596089700f09b80a34580f0a1804ff0010c002499e1ddf81cc0129bb9f1000f00f08980cb45c0f0828008980392069a5546abeb090b00eb001700010596cdf810b0019016e010f80810089e01f0f001314300f8081008f10108a9f101090125904524bf4ff000080ef1010eb9f1000f00f062819e4580f05a810eeb8e00002d0ceb8010dfd0a2eb0801b1eb590f88bf4fea590169b38c0800eb080b1cd000220bf10106a2eb840a6ff0030c00bf06eb0c020cf1040c0aeb0c040434d770177157719771f3d10cf10406dde9062c129b11f0030404d10ce0002611f0030408d0012c0bf8067004d05e44022c777018bfb770a9eb4109b9f1000f88440dd09045aed210f80810019c01f00f012143a9f10109002500f80810a8e74ff000099fe700bf56ea09260ed0b34580f088804ff0010c00244be74ff0000c022447e74ff0000c012401e14ff0010c002400263ee708980392069aabeb040b00eb00170001cdf810b0019015e000bf1af80800089900f0f00008440af8080008f10108013c0125904524bf4ff000080ef1010e002c00f0d2809e4580f0ca800eeb8e00002d0ceb801ae1d0a2eb0800b0eb540f88bf600880b381080aeb08091ed00022ab4609f10106a2eb81016ff0030c00bf06eb0c020cf1040c01eb0c050435d770177157719771f3d10cf10401dde9062c129b5d4610f0030604d10de0002110f0030609d0012e09f8017005d04944022e4f7018bf8f7000bfa4eb400480446cb19045afd21af80800019900f00f000843013c00250af80800aae700bf0024a1e708980392069aabeb060b314600eb00170001cdf810b00190059613e01af80800089e00f0f00030430af8080008f1010801390125904524bf4ff000080ef1010e00295ad09e4553d20eeb8e00002d0ceb801ae3d0a2eb0800b0eb510f88bf480880b384080aeb08091ed00022ab4609f10106a2eb84046ff0030c00bf06eb0c020cf1040c04eb0c050435d770177157719771f3d10cf10406dde9062c129b5d4610f0030404d10de0002610f0030409d0012c09f8067005d04e44022c777018bfb77000bfa1eb4001804479b19045b1d21af80800019c00f00f002043013900250af808000029add107e000bf0021a1e7aa464ff0010c002403e0aa4600244ff0000c0df1080b00999be80508059e3fe60120012106e04ff0010cb4fa84f08cf001014009bbfa8bf252091140084009b0bde8f08f014640f258304cf20732c2f20000c0f248021047b0b54ff2ac44c2f229040146206846f23f52c5f28802b2eb500f40f258304cf2e9124cf67e25c2f20000c0f24802caf2101518bf25609047002804bf691c2160b0bd00bf2de9f04188b046f24f461c46c0f24e0613460a46ddf83880002706f1ae05214627706770a770e77027716771a771e77127726772a772e77227736773a773e77327746774a774e77427756775a775e77527766776a776e77627776777a777e777a8470028c8f800705cd020786178a278e3780843104318434ff0010008d0e179a27911431ebf617a227a51ea020102d108b0bde8f081a07b14284ff00000f7d1217d8df8040041f0010121758df805008df806008df807008df808008df809008df80a008df80b008df80c008df80d008df80e008df80f008df810008df811008df812008df813008df814008df815008df816008df817008df818008df819008df81a008df81b008df81c008df81d008df81e008df81f0001a92046b047c8f8000018b1012008b0bde8f08106f1520120468847d8f80000002818bf012008b0bde8f081f0b500294ff6ff7e00f0af80012903d10022c90775d1a8e021f00102c2f1000c6ff0010241f221038418a578e7788eea05252cb26e0036b203ead43484ea450503ead6366c0086ea450624b275002db203ead43484ea460603ead535740085ea460624b275002db203ead43484ea460603ead535740085ea460624b275002db203ead43484ea460603ead53585ea460686ea07273eb27d002db203ead63686ea470703ead5357e0085ea470736b27d002db203ead63686ea470703ead5357e0085ea470736b27d002db203ead63686ea470703ead5357e0085ea470736b27d002db203ead636023286ea470703ead5360ceb0205023586ea470e95d10232c90733d0805c41f221038eea002001b2420012b203ead13181ea400003ead232410082ea400009b2420012b203ead13181ea400003ead232410082ea400009b2420012b203ead13181ea400003ead232410082ea400009b2420012b203ead13181ea400003ead23181ea400e1ffa8ef0f0bd2de9f04fcbb00646c07c8b468df80600b08954998df80700000a8df808008df80a10080af1898df80b00080a17468df80d000020012b8df805308df809b08df80c108df80e008df80f008df810008df811008df812008df813008df814008df815008df816008df817008df818008df819008df81a008df81b008df81c008df81d008df81e008df81f008df820008df821008df822004cd1307e96f81780a0f1090144f62510c2f29240a1fb0002891a02eb510100970df10500b8eb910f88bf4fea9108c8ebc80706f11a0400f1010a00f10509093021463a46f6f713f906f1210506f1280029460722f6f70bf9284621460722f6f706f920465146032207f10905f6f7fff806f11d0049460422f6f7f9f8f07d02289cbf0130f075009fbb450cd0b8f1240f13d94ff0ff304bb0bde8f08fbb454ff00905f07509d14df22d77abb20df10502c0f247070120f02115e002200df12304aab28df82300a01c0df105018df82470f6f7cdf8a81c4af28d5782b2c0f24607f02021460023b8474bb0bde8f08f2ab1a2fb0103002b1cbf0020704702fb01f0b7e50846abe570b50446d0f83c0142f665360d46c0f2440668b94af2d550cff6ff707844002122460023b0470028c4f83c0108bf70bd06f594718847d4f83c0106f1e8022946bde87040104700bf2de9f04f81b0934612788ab1022300bf0beb030717f8012c62b11bf8032062b17a784ab1ba780433002af1d1023b04e0002205e0013b00e0013303eb4302520042eae272931c02f1010c01eb810203f0030e23f0030a00eb8213a3f5a0784ff0ff3906e009f10109b9f10d0f08f5a0786bd009eb010202eb8202bcf1030f00eb821605d24ff0ff34bef1000f2ed1e9e70024474604e000bfa24507f1020721d0621cd209042a03d83a7802f0f0023a70a21cd209042a03d87a7802f00f027a70e21cd209042a03d87a7802f0f0027a700434e209042adfd86208b55c05f00f05b554d9e7013cbef1000fbbd0a21cd509042d08d85208b55ce7076ff00f0708bf0f273d40b554bef1010fabd0e21cd509042d09d85208b55ce7074ff00f0708bf6ff00f073d40b554bef1020f9ad0221dd509042d96d85208e407b55c6ff00f0408bf0f242c40b4548ce79bf80010cdf800b0002900f0ce80022041f2410a41f2420b41f2430808e0009a063012f8011f03330029009200f0bd80a1f17f0717f15f0ff1d340f65c42c0f2000201eb41017a4402eb81014ff20014a1f5c079cff6ff7402e014f52074ded0494619f9027bc509042d09d8b7f1ff3f06dc1a1992f8016f46f0f00682f8016f5ffa87fe5fea4e6208d5042d06d81a1992f8017f47f00f0782f8017f5fea8e620ad540f27d22904206d81a1992f8027f47f0f00782f8027f5feace6209d5b0f51f7f06d81a1992f8027f47f00f0782f8027f5fea0e724fea900c09d5bcf19e0f06d81a1992f8036f46f0f00682f8036f5fea4e720ad540f27a22904206d81a1992f8037f47f00f0782f8037f91f90110042d09d8b1f1ff3f06dc1a1912f80a7047f0f00702f80a70c9b24a0608d5042d06d81a1912f80a7047f00f0702f80a708a060ad540f27d22904206d81a1912f80b7047f0f00702f80b70ca0609d5b0f51f7f06d81a1912f80b7047f00f0702f80b700a0709d5bcf19e0f06d81a1912f8087047f0f00702f8087049077ff565af40f27a2188423ff660af191911f8082042f00f0201f8082057e701b0bde8f08f00bf2de9f04f81b0134681464a1c00f08f808e0a4ff0000b19f80b20002a00f0888109eb0b077a78002a00f00a81ba78002a00f00981fa78002a00f008813a79002a00f007817a79002a00f00681ba79002a00f00581fa79002a00f004813a7a002a00f003817a7a002a00f00281ba7a002a00f00181fa7a002a00f000813a7b002a00f0ff807a7b002a00f0fe80ba7b002a00f0fd80fa7b002a00f0fc803a7c002a00f0fb807a7c002a00f0fa80ba7c002a00f0fb80fa7c002a00f0fc803a7d002a00f0fd807a7d002a00f0fe80ba7d002a00f0ff80fa7d002a00f000813a7e002a00f001817a7e002a00f00281ba7e002a00f00381fa7e002a00f004813a7f002a00f005817a7f002a00f00681ba7f002a00f00781fa7f002a00f008810bf1200bbbf1600f7ff477af4ff0600b00e1002119f80120002a00f0af8109eb01056a78002a00f0b080aa78002a00f0b180ea78002a00f0b2802a79002a00f0b3806a79002a00f0b480aa79002a00f0b580ea79002a00f0b6802a7a002a00f0b7806a7a002a00f0b880aa7a002a00f0b980ea7a002a00f0ba802a7b002a00f0bb806a7b002a00f0bc80aa7b002a00f0bd80ea7b002a00f050812a7c002a00f04e816a7c002a00f04c81aa7c002a00f04a81ea7c002a00f048812a7d002a00f046816a7d002a00f04481aa7d002a00f04281ea7d002a00f040812a7e002a00f03e816a7e002a00f03c81aa7e002a00f03a81ea7e002a00f038812a7f002a00f036816a7f002a00f03481aa7f002a00f03281ea7f002a00f03081203160297ff479af32e10bf1010b74e00bf1020b71e00bf1030b6ee00bf1040b6be00bf1050b68e00bf1060b65e00bf1070b62e00bf1080b5fe00bf1090b5ce00bf10a0b59e00bf10b0b56e00bf10c0b53e00bf10d0b50e00bf10e0b4de00bf10f0b4ae00bf1100b47e00bf1110b44e00131f6e00bf1120b3fe00231f1e00bf1130b3ae00331ece00bf1140b35e00431e7e00bf1150b30e00531e2e00bf1160b2be00631dde00bf1170b26e00731d8e00bf1180b21e00831d3e00bf1190b1ce00931cee00bf11a0b17e00a31c9e00bf11b0b12e00b31c4e00bf11c0b0de00c31bfe00bf11d0b08e00d31bae00bf11e0b03e00e31b5e00bf11f0bb1f5205f4ff0010100931fd364234ff47a7442f2107700bf01eb81025200b6fbf2f50a2d11d301fb03f2b6fbf2f50a2d0bd301fb04f2b6fbf2f50a2d05d37943b6fbf1f2092ae7d800e011465846bbf15f0f98bf5f20c0f1000c1ceb0b0a53d0b6fbf1f74cf6cd4207f13003ccf6cc4209f80b300a29a1fb023547d31af1010342d007fb11674fead508b7fbf8fe48f21f520ef1300309eb0b06c5f2eb1273706429a1fb023434d31af102032cd00efb18776409b7fbf4f544f6d35205f13003c1f26202b370b1f57a7fa1fb022323d31af1030218d005fb14729b0941f25975b2fbf3f7cdf2b715a1fb055407f13005f57007fb132642f210720bf1040b91424fea5431a9d209e0834607e00bf1010b04e00bf1020b01e00bf1030b0020009b09f80b002de00f311ee010311ce011311ae0123118e0133116e0143114e0153112e0163110e017310ee018310ce019310ae01a3108e01b3106e01c3104e01d3102e01e3100e01f315f2904d849444ff03f020a7003d1002189f85f1001e000204870002119f80100002800f0a18009eb0105687800285ed0a87800285dd0e87800285cd0287900285bd0687900285ad0a879002859d0e879002858d0287a002857d0687a002856d0a87a002855d0e87a002854d0287b002853d0687b002852d0a87b002851d0e87b002850d0287c00284fd0687c00284ed0a87c00284dd0e87c00284cd0287d00284bd0687d00284ad0a87d002849d0e87d002848d0287e002847d0687e002846d0a87e002845d0e87e002844d0287f002843d0687f002842d0a87f002841d0e87f002840d0203160297ff498af44e001313ae0023138e0033136e0043134e0053132e0063130e007312ee008312ce009312ae00a3128e00b3126e00c3124e00d3122e00e3120e00f311ee010311ce011311ae0123118e0133116e0143114e0153112e0163110e017310ee018310ce019310ae01a3108e01b3106e01c3104e01d3102e01e3100e01f315f2905d849444ff02f00087040f09580002089f85f00581c00f094809d0a4ff0000e19f80e00002800f08d8109eb0e067078002800f00f81b078002800f00e81f078002800f00d813079002800f00c817079002800f00b81b079002800f00a81f079002800f00981307a002800f00881707a002800f00781b07a002800f00681f07a002800f00581307b002800f00481707b002800f00381b07b002800f00281f07b002800f00181307c002800f00081707c002800f0ff80b07c002800f00081f07c002800f00181307d002800f00281707d002800f00381b07d002800f00481f07d002800f00581307e002800f00681707e002800f00781b07e002800f00881f07e002800f00981307f002800f00a81707f002800f00b81b07f002800f00c81f07f002800f00d810ef1200ebef1600f7ff477af4ff0600e05e100204870581c7ff46caf002119f80100002800f0aa8109eb01025078002800f0b0809078002800f0b180d078002800f0b2801079002800f0b3805079002800f0b4809079002800f0b580d079002800f0b680107a002800f0b780507a002800f0b880907a002800f0b980d07a002800f0ba80107b002800f0bb80507b002800f0bc80907b002800f0bd80d07b002800f04b81107c002800f04981507c002800f04781907c002800f04581d07c002800f04381107d002800f04181507d002800f03f81907d002800f03d81d07d002800f03b81107e002800f03981507e002800f03781907e002800f03581d07e002800f03381107f002800f03181507f002800f02f81907f002800f02d81d07f002800f02b81203160297ff479af2de10ef1010e74e00ef1020e71e00ef1030e6ee00ef1040e6be00ef1050e68e00ef1060e65e00ef1070e62e00ef1080e5fe00ef1090e5ce00ef10a0e59e00ef10b0e56e00ef10c0e53e00ef10d0e50e00ef10e0e4de00ef10f0e4ae00ef1100e47e00ef1110e44e00131f1e00ef1120e3fe00231ece00ef1130e3ae00331e7e00ef1140e35e00431e2e00ef1150e30e00531dde00ef1160e2be00631d8e00ef1170e26e00731d3e00ef1180e21e00831cee00ef1190e1ce00931c9e00ef11a0e17e00a31c4e00ef11b0e12e00b31bfe00ef11c0e0de00c31bae00ef11d0e08e00d31b5e00ef11e0e03e00e31b0e00ef11f0e0122b3f5205f1ed364234ff47a7442f2107602eb82004100b5fbf1f00a2811d302fb03f1b5fbf1f00a280bd302fb04f1b5fbf1f00a2805d37243b5fbf2f00928e7d800e00a46f046bef15f0f98bf4ff05f08c8f1000c42f2107a1ceb0e074dd0b5fbf2f30a2a03f1300009f80e004cf6cd40ccf6cc40a2fb000641d3781c3dd003fb1253f608b3fbf6f409eb0e0504f13000687048f21f50c5f2eb10642aa2fb000130d3b81c29d004fb16334e09b3fbf6f4b2f57a7f04f13000a87044f6d350c1f26200a2fb000120d3f81c16d004fb1630890941f25974b0fbf1f3cdf2b714a2fb044603f13004ec7003fb11050ef1040e52454fea5632afd209e0c64607e00ef1010e04e00ef1020e01e00ef1030e002009f80e0001b0bde8f08f0f311ee010311ce011311ae0123118e0133116e0143114e0153112e0163110e017310ee018310ce019310ae01a3108e01b3106e01c3104e01d3102e01e3100e01f315f2904d849444ff03f00087005d1002089f85f0001b0bde8f08f0020487001b0bde8f08f434d01ffff0000000000000052420100ff00000008031000000000000000000046616365636c61772f31340000000000000000000000000000002020202020002020000000505050000000000000000000005050f85050f85050000000002070a8a07028a8702000000048a85010202854480000000020505020689090680000002020200000000000000000000010204040404020100000000040201010101020400000000000005020f82050000000000000002020f82020000000000000000000000020204000000000000000f800000000000000000000000000202000000000080810102020404000000000708898a8c88888700000000020602020202020700000000070888808102040f8000000007088083008088870000000000818284888f8080800000000f88080f00808887000000000708080f08888887000000000f808081010202020000000007088887088888870000000007088888878080870000000000000202000002020000000000000202000002020400000000008102040201008000000000000f80000f8000000000000004020100810204000000000708888102000202000000000708898a8a89880780000000070888888f888888800000000f08888f0888888f000000000708880808080887000000000e0908888888890e000000000f88080f0808080f800000000f88080f0808080800000000070888080b888887000000000888888f888888888000000007020202020202070000000003810101010909060000000008890a0c0c0a090880000000080808080808080f80000000088d8a8a888888888000000008888c8a89888888800000000708888888888887000000000f0888888f080808000000000708888888888a87008000000f0888888f0a0908800000000708880700808887000000000f8202020202020200000000088888888888888700000000088888850505020200000000088888888a8a8d88800000000888850202050888800000000888850502020202000000000f8081020408080f8000000007040404040404070000000004040202010100808000000007010101010101070000000205088000000000000000000000000000000000000f80040200000000000000000000000000000700878888878000000008080f088888888f00000000000007088808088700000000008087888888888780000000000007088f8808078000000001820702020202020000000000000788888888878087000008080f08888888888000000202000602020202070000000080800180808080808483000004040485060605048000000006020202020202070000000000000f0a8a8a8a8a8000000000000f08888888888000000000000708888888870000000000000f088888888f0808000000000788888888878080800000000b8c0808080800000000000007880700808f00000000020207020202020180000000000008888888888780000000000008888505020200000000000008888a8a8a870000000000000885020205088000000000000888888888878087000000000f810204080f800000000182020402020201800000000202020202020202000000000601010081010106000000048a8900000000000000000", "desc": "append injected blobs to main-app payload" }, { "offset": 779114, "old": "846a3800", - "new": "7c1b3900", + "new": "c81b3900", "desc": "main-app subheader payload size (ps)" }, { "offset": 152, "old": "046b3800", - "new": "fc1b3900", + "new": "481c3900", "desc": "main-app TOC entry size (ps + 128)" }, { "offset": 779234, "old": "846a3804", - "new": "7c1b3904", + "new": "c81b3904", "desc": "main-app preamble length (low 24 bits)" }, { "offset": 779238, "old": "85c355a2", - "new": "a1afb7e4", + "new": "5ba18044", "desc": "[5] ota/s200_firmware_ota.bin preamble crc32" }, { "offset": 156, "old": "ed292ee4", - "new": "b1adc0d0", + "new": "c88dcd16", "desc": "[5] ota/s200_firmware_ota.bin component crc32c (TOC)" }, { "offset": 779118, "old": "ed292ee4", - "new": "b1adc0d0", + "new": "c88dcd16", "desc": "[5] ota/s200_firmware_ota.bin component crc32c (subheader)" } ] From b71fdde099623847e9cdd75a7d239cca65c23058 Mon Sep 17 00:00:00 2001 From: James Babcock Date: Fri, 18 Sep 2026 19:10:50 -0700 Subject: [PATCH 15/99] Add unicode test pages to the Developer app --- CHANGELOG | 1 + app/apps/developer/developer-app.ts | 4 + app/apps/developer/unicode-test.ts | 283 ++++++++++++++++++++++++++++ 3 files changed, 288 insertions(+) create mode 100644 app/apps/developer/unicode-test.ts diff --git a/CHANGELOG b/CHANGELOG index 2ab4edad..37d8432b 100644 --- a/CHANGELOG +++ b/CHANGELOG @@ -8,6 +8,7 @@ * Optimize bluetooth message transport * Short-the-long gesture from screen off activates the glanceboard * Glanceboard has a 2x3 layout option +* Compass no longer discards calibration when off ## 0.7.0 - 2026-09-12 diff --git a/app/apps/developer/developer-app.ts b/app/apps/developer/developer-app.ts index c81d0945..397442bf 100644 --- a/app/apps/developer/developer-app.ts +++ b/app/apps/developer/developer-app.ts @@ -6,6 +6,7 @@ import { BandwidthBenchmarkLayer } from "./bandwidth-benchmark"; import { LightSensorDemoLayer } from "./light-sensor-demo"; import { ResourceUsageLayer } from "./resource-usage"; import { LoadAppFromQrLayer, LoadAppFromUrlLayer } from "./load-app"; +import { unicodeTestMenu } from "./unicode-test"; import { type AppContext } from "../app-definition"; import { getDefaultSmallFont } from "../../graphics/ui-fonts"; import { appViewportSize } from "../../ui/shell/geometry"; @@ -81,6 +82,9 @@ function debugTestsMenu(): MenuLayer { ctx.stack.push(new BandwidthBenchmarkLayer(ctx.actions.requestRender)); }, }, + submenuItem("Unicode test", (ctx) => { + ctx.stack.push(unicodeTestMenu(MENU_LAYOUT)); + }), ], MENU_LAYOUT, ); diff --git a/app/apps/developer/unicode-test.ts b/app/apps/developer/unicode-test.ts new file mode 100644 index 00000000..35c3ff37 --- /dev/null +++ b/app/apps/developer/unicode-test.ts @@ -0,0 +1,283 @@ +import { wrapText, truncateText } from "../../graphics/textwrap"; +import { fontSelectionLabel, getDefaultSmallFont, getUiFontSelection } from "../../graphics/ui-fonts"; +import { GrayImage, type UiFont } from "../../graphics/image"; +import { type InputEvent } from "../../ui/gestures"; +import { Layer, type LayerContext } from "../../ui/layers"; +import { MenuLayer, type MenuLayout } from "../../ui/menu"; + +/** + * Unicode test: sample texts chosen to exercise text-rendering features that + * need special support beyond one-glyph-per-codepoint left-to-right layout. + * Each sample is rendered with the user's configured UI font so gaps (tofu, + * unshaped Arabic, misplaced combining marks, reversed RTL runs, missing CJK + * coverage) show up the way they would in real app content. + * + * Every sample lists what it exercises so a tester knows what "correct" looks + * like without reading this file. + */ +export type UnicodeSample = { + /** Menu label: the language, with the feature in parentheses. */ + label: string; + /** What a correct rendering has to get right, shown under the title. */ + exercises: string; + /** The text itself; paragraphs separated by "\n". */ + text: string; +}; + +// Sentences are mostly Article 1 of the Universal Declaration of Human Rights +// (the same passage in every language, so a tester who knows one can compare +// line lengths and shapes across scripts), plus a pangram or two. +export const UNICODE_SAMPLES: readonly UnicodeSample[] = [ + { + label: "English (ligatures)", + exercises: "fi/fl/ff pairs stay separate glyphs; kerning (AV, To, Wa)", + text: + "All human beings are born free and equal in dignity and rights. They are endowed with reason and conscience and should act towards one another in a spirit of brotherhood.\n" + + "Ligature pairs: office affluent waffle fjord shuffle difficult\n" + + "Kerning pairs: AVATAR Toward Wavy LTA. Yo Te Ty\n" + + "The quick brown fox jumps over the lazy dog. 0123456789", + }, + { + label: "French (precomposed accents)", + exercises: "é è ê ç œ æ ù as single precomposed codepoints", + text: + "Tous les êtres humains naissent libres et égaux en dignité et en droits. Ils sont doués de raison et de conscience et doivent agir les uns envers les autres dans un esprit de fraternité.\n" + + "Portez ce vieux whisky au juge blond qui fume. Œuvre, cœur, æther, à côté, où, naïve, Noël.", + }, + { + label: "German / Polish / Turkish", + exercises: "ß ä ö ü; ą ę ł ń ś ź ż; dotted İ and dotless ı", + text: + "Falsches Üben von Xylophonmusik quält jeden größeren Zwerg. Straße, Fußgänger, Ärger, Öl, Übung.\n" + + "Pchnąć w tę łódź jeża lub ośm skrzyń fig. Zażółć gęślą jaźń.\n" + + "Pijamalı hasta yağız şoföre çabucak güvendi. İstanbul, ılık, Iğdır, iyi.", + }, + { + label: "Vietnamese (stacked marks)", + exercises: "tone mark above a vowel that already has a diacritic (ấ ệ ở ữ)", + text: + "Tất cả mọi người sinh ra đều được tự do và bình đẳng về nhân phẩm và quyền lợi. Mọi con người đều được tạo hóa ban cho lý trí và lương tâm và cần phải đối xử với nhau trong tình bằng hữu.\n" + + "Tiếng Việt: Hà Nội, Huế, Đà Nẵng, Sài Gòn. ấ ầ ẩ ẫ ậ ế ề ể ễ ệ ố ồ ổ ỗ ộ ớ ờ ở ỡ ợ ứ ừ ử ữ ự", + }, + { + label: "Combining marks (decomposed)", + exercises: "base letter + separate combining accent must overlay, not advance", + text: + // Written with explicit combining codepoints (no String.normalize, so + // the sample is the same on every JS engine). + "Decomposed: café naïve résumé Việt Nam Saõ Paulo\n" + + "Precomposed: café naïve résumé Việt Nam São Paulo\n" + + "Both lines should look identical.\n" + + "Stacked: à́̂ ë̄ ô̧ ñ́ ů̈\n" + + "Marks with no base: ́ ̈ ̧ (should attach to nothing, or a dotted circle)", + }, + { + label: "Greek", + exercises: "Greek alphabet with tonos/dialytika; final sigma ς vs σ", + text: + "Όλοι οι άνθρωποι γεννιούνται ελεύθεροι και ίσοι στην αξιοπρέπεια και τα δικαιώματα. Είναι προικισμένοι με λογική και συνείδηση, και οφείλουν να συμπεριφέρονται μεταξύ τους με πνεύμα αδελφοσύνης.\n" + + "Ξεσκεπάζω την ψυχοφθόρα βδελυγμία. ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩ αβγδεζηθικλμνξοπρσςτυφχψω", + }, + { + label: "Russian (Cyrillic)", + exercises: "Cyrillic coverage incl. й ё ъ ь; italic-free shapes", + text: + "Все люди рождаются свободными и равными в своем достоинстве и правах. Они наделены разумом и совестью и должны поступать в отношении друг друга в духе братства.\n" + + "Съешь же ещё этих мягких французских булок, да выпей чаю. АБВГДЕЁЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЫЬЭЮЯ", + }, + { + label: "Arabic (RTL, joining)", + exercises: "right-to-left; letters take initial/medial/final forms; lam-alef لا ligature", + text: + "يولد جميع الناس أحرارًا متساوين في الكرامة والحقوق. وقد وهبوا عقلاً وضميرًا وعليهم أن يعامل بعضهم بعضًا بروح الإخاء.\n" + + "السلام عليكم. العربية لغة جميلة.\n" + + "Arabic-Indic digits: ٠١٢٣٤٥٦٧٨٩ and Persian: پ چ ژ گ", + }, + { + label: "Hebrew (RTL, niqqud)", + exercises: "right-to-left; vowel points (niqqud) below/inside letters; final forms ך ם ן ף ץ", + text: + "כל בני אדם נולדו בני חורין ושווים בערכם ובזכויותיהם. כולם חוננו בתבונה ובמצפון, לפיכך חובה עליהם לנהוג איש ברעהו ברוח של אחוה.\n" + + "With niqqud: שָׁלוֹם עוֹלָם. בְּרֵאשִׁית בָּרָא אֱלֹהִים\n" + + "Final forms: מלך שלום דין סוף ארץ", + }, + { + label: "Bidirectional (mixed)", + exercises: "RTL runs inside LTR lines and vice versa; numbers and punctuation keep their side", + text: + "The Hebrew word שלום means peace, and the Arabic word سلام means the same.\n" + + "Price: 120 ש\"ח (about $32) — call 555-1234.\n" + + "מספר הטלפון שלי הוא 052-1234567, ואני גר ב-Tel Aviv.\n" + + "أعيش في London منذ 5 سنوات.\n" + + "Nested: he said \"مرحبا (hello) بكم\" and left.", + }, + { + label: "Hindi (Devanagari)", + exercises: "conjuncts (क्ष त्र ज्ञ), vowel sign ि drawn BEFORE its consonant, headline bar", + text: + "सभी मनुष्यों को गौरव और अधिकारों के मामले में जन्मजात स्वतन्त्रता और समानता प्राप्त है। उन्हें बुद्धि और अन्तरात्मा की देन प्राप्त है और परस्पर उन्हें भाईचारे के भाव से बर्ताव करना चाहिए।\n" + + "Reordering: कि (ka + i) की (ka + ii) दिल्ली हिन्दी\n" + + "Conjuncts: क्ष त्र ज्ञ द्ध श्र प्र स्त्री", + }, + { + label: "Thai (no spaces, stacked)", + exercises: "no inter-word spaces (wrap by syllable); vowels and tone marks stack above/below", + text: + "มนุษย์ทั้งหลายเกิดมามีอิสระและเสมอภาคกันในเกียรติศักดิ์และสิทธิ ต่างมีเหตุผลและมโนธรรม และควรปฏิบัติต่อกันด้วยเจตนารมณ์แห่งภราดรภาพ\n" + + "สวัสดีครับ ภาษาไทย กรุงเทพมหานคร\n" + + "Stacked marks: ปั้น ที่ กี้ น้ำ ป์ ฐ์", + }, + { + label: "Chinese (Simplified)", + exercises: "CJK coverage; full-width punctuation ,。;wrapping between any two characters", + text: + "人人生而自由,在尊严和权利上一律平等。他们赋有理性和良心,并应以兄弟关系的精神相对待。\n" + + "你好,世界!中文测试。繁體:臺灣、香港、澳門。\n" + + "Mixed: 我有 3 个 apples 和 2 个 oranges。", + }, + { + label: "Japanese (kana + kanji)", + exercises: "hiragana, katakana, kanji, half-width katakana カタカナ, long vowel mark ー", + text: + "すべての人間は、生れながらにして自由であり、かつ、尊厳と権利とについて平等である。人間は、理性と良心とを授けられており、互いに同胞の精神をもって行動しなければならない。\n" + + "いろはにほへと ちりぬるを。コンピューター、テレビ、ゲーム。\n" + + "半角カナ: コンピューター 全角英数: ABC123", + }, + { + label: "Korean (Hangul)", + exercises: "precomposed syllables; conjoining jamo (ㅎㅏㄴ) should compose to 한", + text: + "모든 인간은 태어날 때부터 자유로우며 그 존엄과 권리에 있어 동등하다. 인간은 천부적으로 이성과 양심을 부여받았으며 서로 형제애의 정신으로 행동하여야 한다.\n" + + "안녕하세요, 세계! 한국어 테스트.\n" + + "Jamo: 한 (= 한) Compatibility jamo: ㅎ ㅏ ㄴ", + }, + { + label: "Emoji (ZWJ, modifiers)", + exercises: "color emoji as monochrome; skin-tone modifiers, ZWJ families, flag pairs, VS16 render as ONE glyph", + text: + "Basic: 😀 👍 ❤ ☀ ★\n" + + "Variation selector: ❤️ ☀️ ✈️ (same as above but VS16)\n" + + "Skin tone: 👍🏻 👍🏽 👍🏿 👋🏾\n" + + "ZWJ: 👨‍👩‍👧‍👦 👩‍💻 🏳️‍🌈\n" + + "Flags: 🇯🇵 🇺🇸 🇩🇪 🇧🇷\n" + + "Keycaps: 1️⃣ #️⃣", + }, + { + label: "Symbols & misc", + exercises: "math, arrows, box drawing, currency, non-BMP (astral) codepoints", + text: + "Math: ∑ ∫ √ ∞ ≠ ≤ ≥ ± × ÷ π θ λ\n" + + "Arrows: ← ↑ → ↓ ↔ ⇒ ⇔\n" + + "Box: ┌─┬─┐ │ │ │ ├─┼─┤ └─┴─┘ ▲▼● ░▒▓█\n" + + "Currency: $ € £ ¥ ₹ ₩ ₪ ¢\n" + + "Astral: 𝔘𝔫𝔦𝔠𝔬𝔡𝔢 𝕳𝖊𝖑𝖑𝖔 𐐀𐐁 🜁🜂\n" + + "Zero-width: a​b (ZWSP) c‍d (ZWJ) e⁠f (WJ) should read as ab cd ef", + }, +]; + +const MARGIN_X = 18; +const TITLE_Y = 8; +const FOOTER_MARGIN = 20; +const BODY_GAP = 6; + +/** + * Shows one Unicode sample wrapped to the page, with the feature under test + * under the title and the current font in the footer. Scroll pages through + * the text; double-click goes back to the language list. + */ +export class UnicodeSampleLayer implements Layer { + private lines: string[] | null = null; + private wrappedForWidth = 0; + private wrappedWithFont = 0; + private firstLine = 0; + private bodyLineCount = 1; + + constructor(private readonly sample: UnicodeSample) {} + + paint(ctx: LayerContext): GrayImage { + const font = getDefaultSmallFont(); + const { width, height } = ctx.stack.getBaseSize(); + const image = new GrayImage(width, height, 0); + const textWidth = width - 2 * MARGIN_X; + + image.drawText(font, MARGIN_X, TITLE_Y, truncateText(font, this.sample.label, textWidth), 220); + const noteY = TITLE_Y + font.lineHeight; + const noteLines = wrapText(font, this.sample.exercises, textWidth); + for (let i = 0; i < noteLines.length; i++) { + image.drawText(font, MARGIN_X, noteY + i * font.lineHeight, noteLines[i]!, 120); + } + + const bodyY = noteY + noteLines.length * font.lineHeight + BODY_GAP; + const footerY = height - FOOTER_MARGIN; + this.bodyLineCount = Math.max(1, Math.floor((footerY - bodyY) / font.lineHeight)); + + const lines = this.getLines(font, textWidth); + this.clampScroll(lines.length); + const visible = lines.slice(this.firstLine, this.firstLine + this.bodyLineCount); + for (let i = 0; i < visible.length; i++) { + image.drawText(font, MARGIN_X, bodyY + i * font.lineHeight, visible[i]!, 235); + } + + const page = Math.floor(this.firstLine / this.pageStep()) + 1; + image.drawText(font, MARGIN_X, footerY, `Page ${page}/${this.pageCount(lines.length)}`, 110); + const fontLabel = fontSelectionLabel(getUiFontSelection()); + image.drawText(font, width - MARGIN_X - font.measureText(fontLabel), footerY, fontLabel, 110); + return image; + } + + handleInput(event: InputEvent, ctx: LayerContext): void { + switch (event.type) { + case "scroll-down": + this.firstLine += this.pageStep(); + return; + case "scroll-up": + this.firstLine = Math.max(0, this.firstLine - this.pageStep()); + return; + case "double-click": + ctx.stack.pop(); + return; + } + } + + private pageStep(): number { + return Math.max(1, this.bodyLineCount - 1); + } + + private clampScroll(lineCount: number): void { + if (lineCount <= this.bodyLineCount) { + this.firstLine = 0; + return; + } + const lastPageStart = (this.pageCount(lineCount) - 1) * this.pageStep(); + this.firstLine = Math.max(0, Math.min(lastPageStart, this.firstLine)); + } + + private pageCount(lineCount: number): number { + if (lineCount <= this.bodyLineCount) return 1; + return Math.ceil((lineCount - this.bodyLineCount) / this.pageStep()) + 1; + } + + private getLines(font: UiFont, width: number): string[] { + if (this.lines === null || this.wrappedForWidth !== width || this.wrappedWithFont !== font.fingerprintId) { + // breakLongWords: CJK and Thai have no spaces to wrap at. + this.lines = wrapText(font, this.sample.text, width, { breakLongWords: true }); + this.wrappedForWidth = width; + this.wrappedWithFont = font.fingerprintId; + } + return this.lines; + } +} + +/** The language list; selecting a row opens its sample. */ +export function unicodeTestMenu(layout: MenuLayout): MenuLayer { + return new MenuLayer( + "Unicode test", + UNICODE_SAMPLES.map((sample) => ({ + label: sample.label, + onSelect: (ctx) => { + ctx.stack.push(new UnicodeSampleLayer(sample)); + }, + })), + layout, + ); +} From 1e1c3f799dda3b1938a6b2584a17108bfcd7de10 Mon Sep 17 00:00:00 2001 From: James Babcock Date: Fri, 18 Sep 2026 19:35:50 -0700 Subject: [PATCH 16/99] Introduce Kotlin --- App_Resources/Android/before-plugins.gradle | 5 +- .../java/com/faceclaw/shared/KotlinBridge.kt | 21 ++++++++ app/app.ts | 5 ++ app/native/kotlin-bridge.ts | 49 +++++++++++++++++++ 4 files changed, 78 insertions(+), 2 deletions(-) create mode 100644 App_Resources/Android/src/main/java/com/faceclaw/shared/KotlinBridge.kt create mode 100644 app/native/kotlin-bridge.ts diff --git a/App_Resources/Android/before-plugins.gradle b/App_Resources/Android/before-plugins.gradle index 9faffb81..f643993d 100644 --- a/App_Resources/Android/before-plugins.gradle +++ b/App_Resources/Android/before-plugins.gradle @@ -10,6 +10,7 @@ project.ext { // androidXTransition = "1.4.1" // androidXViewPager = "1.0.0" - // useKotlin = true - // kotlinVersion = "1.6.0" + // NativeScript 9 already applies kotlin-android. Pin its current compiler + // for our .kt sources; no separate Kotlin installation is required. + kotlinVersion = "2.2.20" } diff --git a/App_Resources/Android/src/main/java/com/faceclaw/shared/KotlinBridge.kt b/App_Resources/Android/src/main/java/com/faceclaw/shared/KotlinBridge.kt new file mode 100644 index 00000000..809537dd --- /dev/null +++ b/App_Resources/Android/src/main/java/com/faceclaw/shared/KotlinBridge.kt @@ -0,0 +1,21 @@ +package com.faceclaw.shared + +/** NativeScript implements this Kotlin-owned contract in TypeScript. */ +interface KotlinBridgeListener { + fun transform(message: String): String +} + +/** + * First step toward commonMain: only portable Kotlin, with no Android/JVM APIs. + * Calls and callbacks are synchronous on the caller's thread. The listener is + * used only during roundTrip and is never retained. + */ +class KotlinBridge { + fun greet(name: String): String = "Hello, $name, from Kotlin" + + fun roundTrip(message: String, listener: KotlinBridgeListener): String { + val reply = listener.transform("Kotlin received: $message") + // Consume the TypeScript return value, then return it across the bridge. + return "Kotlin received callback: $reply" + } +} diff --git a/app/app.ts b/app/app.ts index 7a2f44f9..22a27f87 100644 --- a/app/app.ts +++ b/app/app.ts @@ -8,6 +8,11 @@ import { Application } from '@nativescript/core' import { registerShareIntentHandler } from './native/share-intents' import { installNativeUserAgent } from './util/http' import { registerPhoneRotation } from './native/phone-rotation' +import { runKotlinBridgeSmokeTest } from './native/kotlin-bridge' + +declare const __DEV__: boolean; + +if (__DEV__) runKotlinBridgeSmokeTest() installNativeUserAgent() registerShareIntentHandler() diff --git a/app/native/kotlin-bridge.ts b/app/native/kotlin-bridge.ts new file mode 100644 index 00000000..6baa866e --- /dev/null +++ b/app/native/kotlin-bridge.ts @@ -0,0 +1,49 @@ +import { isAndroid } from "@nativescript/core"; + +// Handwritten declarations for this small native surface. NativeScript builds +// the runtime metadata from Kotlin's compiled classes, not these declarations. +declare namespace com.faceclaw.shared { + class KotlinBridge extends java.lang.Object { + constructor(); + greet(name: string): string; + roundTrip(message: string, listener: KotlinBridgeListener): string; + } + class KotlinBridgeListener extends java.lang.Object { + constructor(implementation: { transform(message: string): string }); + } +} + +/** Exercise the real native metadata and both directions of return values. */ +export function runKotlinBridgeSmokeTest(): void { + if (!isAndroid) return; + + try { + const bridge = new com.faceclaw.shared.KotlinBridge(); + const greeting = bridge.greet("Faceclaw"); + const message = "Faceclaw \u2194 Kotlin \ud83d\udc53"; + let callbackCount = 0; + let callbackMessage = ""; + // Keep the proxy in scope through the synchronous native call. Do not + // throw from the callback; validate after returning across the boundary. + const listener = new com.faceclaw.shared.KotlinBridgeListener({ + transform(value: string): string { + callbackCount++; + callbackMessage = value; + return `TypeScript received: ${value}`; + }, + }); + const reply = bridge.roundTrip(message, listener); + if (greeting !== "Hello, Faceclaw, from Kotlin" + || callbackCount !== 1 + || callbackMessage !== `Kotlin received: ${message}` + || reply !== `Kotlin received callback: TypeScript received: Kotlin received: ${message}`) { + throw new Error(`Unexpected Kotlin bridge result: ${JSON.stringify({ + greeting, callbackCount, callbackMessage, reply, + })}`); + } + console.log("FACECLAW_KOTLIN_BRIDGE_PASS " + reply); + } catch (error) { + // Diagnostics must not prevent the rest of the app from launching. + console.error("FACECLAW_KOTLIN_BRIDGE_FAIL " + error); + } +} From bc8e80c53357ce7444c24019edd09bd41c374d02 Mon Sep 17 00:00:00 2001 From: James Babcock Date: Fri, 18 Sep 2026 19:59:13 -0700 Subject: [PATCH 17/99] Kotlin on iOS --- .gitignore | 17 +++++++- App_Resources/Android/before-plugins.gradle | 6 +-- .../java/com/faceclaw/shared/KotlinBridge.kt | 21 --------- App_Resources/iOS/build.xcconfig | 3 ++ app/bootstrap.ios.ts | 4 ++ app/native/kotlin-bridge.ts | 43 +++++++------------ app/native/kotlin-platform.android.ts | 31 +++++++++++++ app/native/kotlin-platform.d.ts | 11 +++++ app/native/kotlin-platform.ios.ts | 42 ++++++++++++++++++ package-lock.json | 17 ++++++-- package.json | 6 ++- scripts/ios.sh | 5 +++ 12 files changed, 149 insertions(+), 57 deletions(-) delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/shared/KotlinBridge.kt create mode 100644 app/native/kotlin-platform.android.ts create mode 100644 app/native/kotlin-platform.d.ts create mode 100644 app/native/kotlin-platform.ios.ts diff --git a/.gitignore b/.gitignore index 6d3aefcb..9efee48b 100644 --- a/.gitignore +++ b/.gitignore @@ -1,5 +1,8 @@ # NativeScript -hooks/ +hooks/* +!hooks/before-prepare/ +hooks/before-prepare/* +!hooks/before-prepare/faceclaw-kotlin.js node_modules/ platforms/ @@ -44,3 +47,15 @@ faceclaw_settings.ios.json # Developer configs build_paths.sh **/xcuserdata/ + +# Kotlin build outputs and staged NativeScript artifacts +native/kotlin/.gradle/ +native/kotlin/.kotlin/ +native/kotlin/build/ +native/kotlin/shared/build/ +native/kotlin/local.properties +native/kotlin/plugin/platforms/android/*.aar +native/kotlin/plugin/platforms/ios/ +!native/kotlin/plugin/platforms/ +!native/kotlin/plugin/platforms/android/ +!native/kotlin/plugin/platforms/android/include.gradle diff --git a/App_Resources/Android/before-plugins.gradle b/App_Resources/Android/before-plugins.gradle index f643993d..8ebcb235 100644 --- a/App_Resources/Android/before-plugins.gradle +++ b/App_Resources/Android/before-plugins.gradle @@ -10,7 +10,7 @@ project.ext { // androidXTransition = "1.4.1" // androidXViewPager = "1.0.0" - // NativeScript 9 already applies kotlin-android. Pin its current compiler - // for our .kt sources; no separate Kotlin installation is required. - kotlinVersion = "2.2.20" + // Keep the host compiler/runtime compatible with native/kotlin/build.gradle.kts. + // NativeScript 9 already applies kotlin-android. + kotlinVersion = "2.4.20" } diff --git a/App_Resources/Android/src/main/java/com/faceclaw/shared/KotlinBridge.kt b/App_Resources/Android/src/main/java/com/faceclaw/shared/KotlinBridge.kt deleted file mode 100644 index 809537dd..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/shared/KotlinBridge.kt +++ /dev/null @@ -1,21 +0,0 @@ -package com.faceclaw.shared - -/** NativeScript implements this Kotlin-owned contract in TypeScript. */ -interface KotlinBridgeListener { - fun transform(message: String): String -} - -/** - * First step toward commonMain: only portable Kotlin, with no Android/JVM APIs. - * Calls and callbacks are synchronous on the caller's thread. The listener is - * used only during roundTrip and is never retained. - */ -class KotlinBridge { - fun greet(name: String): String = "Hello, $name, from Kotlin" - - fun roundTrip(message: String, listener: KotlinBridgeListener): String { - val reply = listener.transform("Kotlin received: $message") - // Consume the TypeScript return value, then return it across the bridge. - return "Kotlin received callback: $reply" - } -} diff --git a/App_Resources/iOS/build.xcconfig b/App_Resources/iOS/build.xcconfig index 950bebe4..15e50f3e 100644 --- a/App_Resources/iOS/build.xcconfig +++ b/App_Resources/iOS/build.xcconfig @@ -8,3 +8,6 @@ OTHER_LDFLAGS = $(inherited) -framework CoreBluetooth -framework CoreText -frame ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; HEADER_SEARCH_PATHS = $(inherited) "$(SRCROOT)/../../App_Resources/iOS/src/lc3" + +// FaceclawKit ships arm64 device and Apple-silicon simulator slices. +EXCLUDED_ARCHS[sdk=iphonesimulator*] = x86_64; diff --git a/app/bootstrap.ios.ts b/app/bootstrap.ios.ts index 1878ffce..599004a1 100644 --- a/app/bootstrap.ios.ts +++ b/app/bootstrap.ios.ts @@ -1,5 +1,9 @@ import { Application } from '@nativescript/core' +import { runKotlinBridgeSmokeTest } from './native/kotlin-bridge' declare const FaceclawConfigPort: any +declare const __DEV__: boolean; + +if (__DEV__) runKotlinBridgeSmokeTest() // Apply transferred preferences before settings getters or app workers load. FaceclawConfigPort.processPendingRequest() diff --git a/app/native/kotlin-bridge.ts b/app/native/kotlin-bridge.ts index 6baa866e..6b463807 100644 --- a/app/native/kotlin-bridge.ts +++ b/app/native/kotlin-bridge.ts @@ -1,47 +1,36 @@ import { isAndroid } from "@nativescript/core"; - -// Handwritten declarations for this small native surface. NativeScript builds -// the runtime metadata from Kotlin's compiled classes, not these declarations. -declare namespace com.faceclaw.shared { - class KotlinBridge extends java.lang.Object { - constructor(); - greet(name: string): string; - roundTrip(message: string, listener: KotlinBridgeListener): string; - } - class KotlinBridgeListener extends java.lang.Object { - constructor(implementation: { transform(message: string): string }); - } -} +import { createKotlinBridge } from "./kotlin-platform"; /** Exercise the real native metadata and both directions of return values. */ export function runKotlinBridgeSmokeTest(): void { - if (!isAndroid) return; - try { - const bridge = new com.faceclaw.shared.KotlinBridge(); + const bridge = createKotlinBridge(); + const platform = bridge.platform(); + const thread = bridge.threadName(); + const callerOnMain = bridge.isMainThread(); const greeting = bridge.greet("Faceclaw"); const message = "Faceclaw \u2194 Kotlin \ud83d\udc53"; let callbackCount = 0; let callbackMessage = ""; - // Keep the proxy in scope through the synchronous native call. Do not - // throw from the callback; validate after returning across the boundary. - const listener = new com.faceclaw.shared.KotlinBridgeListener({ - transform(value: string): string { - callbackCount++; - callbackMessage = value; - return `TypeScript received: ${value}`; - }, + let callbackOnMain = false; + // Validate after returning; never throw from a native callback. + const reply = bridge.roundTrip(message, (value: string): string => { + callbackCount++; + callbackMessage = value; + callbackOnMain = bridge.isMainThread(); + return `TypeScript received: ${value}`; }); - const reply = bridge.roundTrip(message, listener); if (greeting !== "Hello, Faceclaw, from Kotlin" + || platform !== (isAndroid ? "Android" : "iOS") + || !thread || !callerOnMain || !callbackOnMain || callbackCount !== 1 || callbackMessage !== `Kotlin received: ${message}` || reply !== `Kotlin received callback: TypeScript received: Kotlin received: ${message}`) { throw new Error(`Unexpected Kotlin bridge result: ${JSON.stringify({ - greeting, callbackCount, callbackMessage, reply, + platform, thread, callerOnMain, callbackOnMain, greeting, callbackCount, callbackMessage, reply, })}`); } - console.log("FACECLAW_KOTLIN_BRIDGE_PASS " + reply); + console.log("FACECLAW_KOTLIN_BRIDGE_PASS " + JSON.stringify({ platform, thread, reply })); } catch (error) { // Diagnostics must not prevent the rest of the app from launching. console.error("FACECLAW_KOTLIN_BRIDGE_FAIL " + error); diff --git a/app/native/kotlin-platform.android.ts b/app/native/kotlin-platform.android.ts new file mode 100644 index 00000000..7ca6ba1c --- /dev/null +++ b/app/native/kotlin-platform.android.ts @@ -0,0 +1,31 @@ +import type { KotlinBridge } from './kotlin-platform'; + +// Handwritten declarations for the small native surface, checked against the +// compiled API. NativeScript runtime metadata is generated from the AAR. +declare namespace com.faceclaw.shared { + class KotlinBridge extends java.lang.Object { + constructor(); + platform(): string; + threadName(): string; + isMainThread(): boolean; + greet(name: string): string; + roundTrip(message: string, listener: KotlinBridgeListener): string; + } + class KotlinBridgeListener extends java.lang.Object { + constructor(implementation: { transform(message: string): string }); + } +} + +export function createKotlinBridge(): KotlinBridge { + const bridge = new com.faceclaw.shared.KotlinBridge(); + return { + platform: () => bridge.platform(), + threadName: () => bridge.threadName(), + isMainThread: () => bridge.isMainThread(), + greet: name => bridge.greet(name), + roundTrip(message, transform) { + const listener = new com.faceclaw.shared.KotlinBridgeListener({ transform }); + return bridge.roundTrip(message, listener); + }, + }; +} diff --git a/app/native/kotlin-platform.d.ts b/app/native/kotlin-platform.d.ts new file mode 100644 index 00000000..0322448c --- /dev/null +++ b/app/native/kotlin-platform.d.ts @@ -0,0 +1,11 @@ +/** Exported native API normalized across Java interfaces and Obj-C protocols. */ +export interface KotlinBridge { + platform(): string; + threadName(): string; + isMainThread(): boolean; + greet(name: string): string; + /** Synchronous callback; must not throw across the native boundary. */ + roundTrip(message: string, transform: (message: string) => string): string; +} + +export function createKotlinBridge(): KotlinBridge; diff --git a/app/native/kotlin-platform.ios.ts b/app/native/kotlin-platform.ios.ts new file mode 100644 index 00000000..24e4ea2c --- /dev/null +++ b/app/native/kotlin-platform.ios.ts @@ -0,0 +1,42 @@ +import type { KotlinBridge } from './kotlin-platform'; + +// Handwritten declarations matching FaceclawKit's Objective-C header. +declare class FaceclawKitKotlinBridge extends NSObject { + static alloc(): FaceclawKitKotlinBridge; + init(): this; + platform(): string; + threadName(): string; + isMainThread(): boolean; + greetName(name: string): string; + roundTripMessageListener(message: string, listener: FaceclawKitKotlinBridgeListener): string; +} +interface FaceclawKitKotlinBridgeListener { + transformMessage(message: string): string; +} +declare const FaceclawKitKotlinBridgeListener: { + prototype: FaceclawKitKotlinBridgeListener; +}; + +@NativeClass() +class KotlinCallback extends NSObject implements FaceclawKitKotlinBridgeListener { + static ObjCProtocols = [FaceclawKitKotlinBridgeListener]; + transform!: (message: string) => string; + + transformMessage(message: string): string { return this.transform(message); } +} + +export function createKotlinBridge(): KotlinBridge { + const bridge = FaceclawKitKotlinBridge.alloc().init(); + return { + platform: () => bridge.platform(), + threadName: () => bridge.threadName(), + isMainThread: () => bridge.isMainThread(), + greet: name => bridge.greetName(name), + roundTrip(message, transform) { + const listener = KotlinCallback.new() as KotlinCallback; + listener.transform = transform; + // Kotlin uses this listener synchronously and never retains it. + return bridge.roundTripMessageListener(message, listener); + }, + }; +} diff --git a/package-lock.json b/package-lock.json index 677da298..8446d8ae 100644 --- a/package-lock.json +++ b/package-lock.json @@ -9,6 +9,7 @@ "version": "1.0.0", "dependencies": { "@evenrealities/pretext": "^0.1.4", + "@faceclaw/kotlin": "file:native/kotlin/plugin", "@nativescript/core": "~9.0.0", "@nativescript/theme": "^3.1.0", "@xterm/headless": "^6.0.0", @@ -19,13 +20,17 @@ "upng-js": "^2.1.0" }, "devDependencies": { - "@nativescript/android": "9.0.4", + "@nativescript/android": "9.1.1", "@nativescript/ios": "9.0.3", "@nativescript/types": "~9.0.0", "@nativescript/webpack": "~5.0.25", "typescript": "~5.4.0" } }, + "native/kotlin/plugin": { + "name": "@faceclaw/kotlin", + "version": "0.1.0" + }, "node_modules/@babel/code-frame": { "version": "7.29.0", "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.29.0.tgz", @@ -412,6 +417,10 @@ "integrity": "sha512-gSZk/uxIhZW3geOM5bP1IS0s1sg7cA7KLLpBDgH9T1+ZNHMIFTMcgQN1qw4+/Xi/rcxsDsWZ7UZndIS/s4fRcA==", "license": "MIT" }, + "node_modules/@faceclaw/kotlin": { + "resolved": "native/kotlin/plugin", + "link": true + }, "node_modules/@jridgewell/gen-mapping": { "version": "0.3.13", "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.13.tgz", @@ -474,9 +483,9 @@ } }, "node_modules/@nativescript/android": { - "version": "9.0.4", - "resolved": "https://registry.npmjs.org/@nativescript/android/-/android-9.0.4.tgz", - "integrity": "sha512-htfv7Ku/M6Tq6fQjhV0nSwxa9agNYEs9x4zBdOW8mRye5CZS7xTJq83MffYkItrtN/jJeeaxiSAgu0F+L4oHgA==", + "version": "9.1.1", + "resolved": "https://registry.npmjs.org/@nativescript/android/-/android-9.1.1.tgz", + "integrity": "sha512-oDWfVnQtgQ0ctbfFWSugqGEZnYVjls82FqlO5UbA9HNwTNqdP4gqWwqHR80WKQngrbxlRHYDIuYv5S9kQfKhcw==", "dev": true }, "node_modules/@nativescript/core": { diff --git a/package.json b/package.json index 210a9ed8..a9779a9a 100644 --- a/package.json +++ b/package.json @@ -4,6 +4,9 @@ "version": "1.0.0", "private": false, "scripts": { + "native:android": "node scripts/kotlin-build.cjs android", + "native:ios": "node scripts/kotlin-build.cjs ios", + "test:kotlin": "cd native/kotlin && ./gradlew :shared:testAndroidHostTest :shared:iosSimulatorArm64Test", "build:ios": "scripts/ios.sh build ios --for-device", "run:ios": "scripts/ios.sh run ios", "prepare:ios": "scripts/ios.sh prepare ios", @@ -16,6 +19,7 @@ }, "dependencies": { "@evenrealities/pretext": "^0.1.4", + "@faceclaw/kotlin": "file:native/kotlin/plugin", "@nativescript/core": "~9.0.0", "@nativescript/theme": "^3.1.0", "@xterm/headless": "^6.0.0", @@ -26,7 +30,7 @@ "upng-js": "^2.1.0" }, "devDependencies": { - "@nativescript/android": "9.0.4", + "@nativescript/android": "9.1.1", "@nativescript/ios": "9.0.3", "@nativescript/types": "~9.0.0", "@nativescript/webpack": "~5.0.25", diff --git a/scripts/ios.sh b/scripts/ios.sh index 3ebb3f65..e86bc302 100755 --- a/scripts/ios.sh +++ b/scripts/ios.sh @@ -2,6 +2,11 @@ set -euo pipefail cd "$(dirname "$0")/.." +# Kotlin/Native also needs the JDK; share the existing local build environment. +if [[ -f build_paths.sh ]]; then + source ./build_paths.sh +fi + # Prefer Homebrew Ruby over the older macOS system Ruby when available. for ruby_bin in /opt/homebrew/opt/ruby/bin /usr/local/opt/ruby/bin; do if [[ -x "$ruby_bin/ruby" ]]; then From c0f8f7e9c297a646b3166931ed4948c9cb0a75cb Mon Sep 17 00:00:00 2001 From: James Babcock Date: Fri, 18 Sep 2026 20:43:24 -0700 Subject: [PATCH 18/99] Move Kotlin shared code --- App_Resources/Android/app.gradle | 18 ++++++++++++++++++ .../com/faceclaw/shared/KotlinBridge.kt | 2 +- 2 files changed, 19 insertions(+), 1 deletion(-) rename {App_Resources/Android/src/main/java => native/kotlin/shared/src/commonMain/kotlin}/com/faceclaw/shared/KotlinBridge.kt (89%) diff --git a/App_Resources/Android/app.gradle b/App_Resources/Android/app.gradle index 0e24319a..03846d58 100644 --- a/App_Resources/Android/app.gradle +++ b/App_Resources/Android/app.gradle @@ -255,6 +255,10 @@ def faceclawVersionCode = { return parts[0] * 10000 + parts[1] * 100 + parts[2] }() +// ios-port packages commonMain in an AAR. Keeping this conditional lets the +// source relocation merge there without compiling the shared classes twice. +def faceclawDependencies = new groovy.json.JsonSlurper().parse(file("$rootDir/../../package.json")).dependencies ?: [:] + android { compileSdkVersion 35 buildToolsVersion "35" @@ -262,6 +266,11 @@ android { sourceSets.main { jniLibs.srcDirs += ["$projectDir/src/main/jniLibs"] + // Keep portable Kotlin at the same path as ios-port's KMP commonMain. + // main compiles it directly with the existing Android Kotlin plugin. + if (!faceclawDependencies.containsKey("@faceclaw/kotlin")) { + java.srcDirs += ["$rootDir/../../native/kotlin/shared/src/commonMain/kotlin"] + } } defaultConfig { @@ -288,6 +297,15 @@ android { } } +// NativeScript can retain deleted App_Resources sources in its generated +// project. Remove the former copy before Kotlin compilation after this move. +def removeLegacyKotlinBridgeSource = tasks.register("removeLegacyKotlinBridgeSource", Delete) { + delete file("$projectDir/src/main/java/com/faceclaw/shared/KotlinBridge.kt") +} +tasks.matching { it.name.startsWith("compile") && it.name.endsWith("Kotlin") }.configureEach { + dependsOn removeLegacyKotlinBridgeSource +} + tasks.matching { it.name == "preBuild" }.configureEach { dependsOn tasks.named("prepareFaceclawNativeLibs") dependsOn tasks.named("prepareFaceclawLlama") diff --git a/App_Resources/Android/src/main/java/com/faceclaw/shared/KotlinBridge.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/shared/KotlinBridge.kt similarity index 89% rename from App_Resources/Android/src/main/java/com/faceclaw/shared/KotlinBridge.kt rename to native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/shared/KotlinBridge.kt index 809537dd..66f1ebfe 100644 --- a/App_Resources/Android/src/main/java/com/faceclaw/shared/KotlinBridge.kt +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/shared/KotlinBridge.kt @@ -6,7 +6,7 @@ interface KotlinBridgeListener { } /** - * First step toward commonMain: only portable Kotlin, with no Android/JVM APIs. + * Portable Kotlin at the same commonMain source path used by ios-port. * Calls and callbacks are synchronous on the caller's thread. The listener is * used only during roundTrip and is never retained. */ From 410fd5840b7b3b416770a36a3a06f4fee4f8a61d Mon Sep 17 00:00:00 2001 From: James Babcock Date: Fri, 18 Sep 2026 22:46:08 -0700 Subject: [PATCH 19/99] Refactor a bunch of Java to Kotlin, making it usable in an iOS port --- .gitignore | 15 +- App_Resources/Android/app.gradle | 19 +- App_Resources/Android/before-plugins.gradle | 4 +- .../com/faceclaw/app/AndroidNoiseEffects.java | 59 + .../faceclaw/app/FaceclawAlarmListener.java | 6 - .../app/FaceclawAmbientLightListener.java | 10 - .../app/FaceclawAudioPacketListener.java | 5 - .../faceclaw/app/FaceclawBleCommunicator.java | 18 +- .../app/FaceclawBleCommunicatorListener.java | 15 - .../com/faceclaw/app/FaceclawBleListener.java | 6 - .../com/faceclaw/app/FaceclawBleManager.java | 2 +- .../app/FaceclawCaptionEngineListener.java | 17 - .../faceclaw/app/FaceclawCompassListener.java | 7 - .../app/FaceclawDeviceDiscoveryListener.java | 18 - .../faceclaw/app/FaceclawDeviceInfoProbe.java | 4 +- .../faceclaw/app/FaceclawEvenHubListener.java | 18 - .../faceclaw/app/FaceclawFirmwareFlasher.java | 2 +- .../app/FaceclawFirmwareFlasherListener.java | 24 - .../faceclaw/app/FaceclawFirmwareUtil.java | 57 - .../app/FaceclawFlashPromptCommunicator.java | 2 +- .../app/FaceclawFlashPromptListener.java | 23 - .../com/faceclaw/app/FaceclawImuListener.java | 10 - .../faceclaw/app/FaceclawLlamaListener.java | 16 - .../app/FaceclawLocationListener.java | 8 - .../app/FaceclawLocationTrackerListener.java | 13 - .../app/FaceclawMediaBrowserListener.java | 10 - .../app/FaceclawMediaControllerListener.java | 23 - .../app/FaceclawMicStatusListener.java | 10 - .../app/FaceclawModelDownloaderListener.java | 11 - .../faceclaw/app/FaceclawNoiseSuppressor.java | 266 --- .../app/FaceclawNotificationListener.java | 5 - .../app/FaceclawPreviewCompositor.java | 3 +- .../app/FaceclawQrScannerListener.java | 10 - .../app/FaceclawRingEventDecoder.java | 126 -- .../app/FaceclawSettingsListener.java | 6 - .../app/FaceclawVoiceControllerListener.java | 47 - .../com/faceclaw/app/FaceclawWavRecorder.java | 100 -- .../faceclaw/app/FaceclawWearListener.java | 19 - .../app/FaceclawWebSocketListener.java | 9 - .../java/com/faceclaw/app/FwGlyphAtlas.java | 83 - .../com/faceclaw/app/GifScreenRecorder.java | 269 +-- .../java/com/faceclaw/app/GlyphAtlas.java | 267 --- .../java/com/faceclaw/app/ImageAtlas.java | 115 -- .../java/com/faceclaw/app/LvglFontFile.java | 229 --- .../java/com/faceclaw/app/ScreenshotUtil.java | 81 +- .../com/faceclaw/app/SurfaceCompositor.java | 509 ------ .../app/g2protocol/BleImageOptimizer.java | 555 ------- .../faceclaw/app/g2protocol/BleMagicPool.java | 69 - .../faceclaw/app/g2protocol/BleProtocol.java | 1240 -------------- .../app/g2protocol/CfwMessageWindow.java | 38 - .../faceclaw/app/g2protocol/CfwTransport.java | 141 -- .../app/g2protocol/ConnectionOptions.java | 75 - .../com/faceclaw/app/g2protocol/G2Event.java | 116 -- .../app/g2protocol/MessageBuilder.java | 281 ---- .../app/g2protocol/OutboundMessage.java | 71 - .../app/g2protocol/TextureCacheState.java | 179 -- .../app/g2protocol/TexturePlanner.java | 721 -------- .../java/com/faceclaw/app/util/BmpUtil.java | 133 -- .../faceclaw/app/util/CollectionUtils.java | 26 - app/graphics/glyph-wire.ts | 8 +- app/native/kotlin-bridge.ts | 2 + app/native/kotlin-protocol-smoke.ts | 20 + hooks/before-prepare/faceclaw-kotlin.js | 8 + native/kotlin/README.md | 79 + native/kotlin/android-java-boundaries.json | 136 ++ native/kotlin/build.gradle.kts | 4 + native/kotlin/migrated-java-sources.json | 198 +++ native/kotlin/plugin/index.js | 1 + native/kotlin/plugin/package.json | 7 + native/kotlin/settings.gradle.kts | 4 + native/kotlin/shared/build.gradle.kts | 25 + .../com/faceclaw/app/AndroidByteReader.kt | 20 + .../com/faceclaw/app/FaceclawFirmwareUtil.kt | 31 + .../com/faceclaw/app/FaceclawWavRecorder.kt | 72 + .../faceclaw/app/PlatformServices.android.kt | 41 + .../app/g2protocol/AndroidProtocolPlatform.kt | 48 + .../faceclaw/shared/PlatformInfo.android.kt | 11 + .../com/faceclaw/app/PlatformServices.kt | 10 + .../app/audio/FaceclawNoiseSuppressor.kt | 263 +++ .../app/callbacks/FaceclawAlarmListener.kt | 6 + .../callbacks/FaceclawAmbientLightListener.kt | 10 + .../callbacks/FaceclawAudioPacketListener.kt | 5 + .../FaceclawBleCommunicatorListener.kt | 37 + .../app/callbacks/FaceclawBleListener.kt | 7 + .../FaceclawCaptionEngineListener.kt | 22 + .../app/callbacks/FaceclawCompassListener.kt | 14 + .../FaceclawDeviceDiscoveryListener.kt | 17 + .../FaceclawDeviceInfoProbeListener.kt | 12 +- .../app/callbacks/FaceclawEvenHubListener.kt | 18 + .../FaceclawFirmwareFlasherListener.kt | 30 + .../callbacks/FaceclawFlashPromptListener.kt | 25 + .../app/callbacks/FaceclawImuListener.kt | 9 + .../app/callbacks/FaceclawLlamaListener.kt | 16 + .../app/callbacks/FaceclawLocationListener.kt | 13 + .../FaceclawLocationTrackerListener.kt | 19 + .../callbacks/FaceclawMediaBrowserListener.kt | 10 + .../FaceclawMediaControllerListener.kt | 23 + .../callbacks/FaceclawMicStatusListener.kt | 10 + .../FaceclawModelDownloaderListener.kt | 11 + .../callbacks/FaceclawNotificationListener.kt | 5 + .../callbacks/FaceclawQrScannerListener.kt | 10 + .../app/callbacks/FaceclawSettingsListener.kt | 6 + .../app/callbacks/FaceclawSseListener.kt | 15 +- .../FaceclawVoiceControllerListener.kt | 44 + .../app/callbacks/FaceclawWearListener.kt | 17 + .../callbacks/FaceclawWebSocketListener.kt | 12 + .../app/g2protocol/BleImageOptimizer.kt | 735 ++++++++ .../faceclaw/app/g2protocol/BleMagicPool.kt | 43 + .../faceclaw/app/g2protocol/BleProtocol.kt | 1480 +++++++++++++++++ .../app/g2protocol/CfwMessageWindow.kt | 44 + .../faceclaw/app/g2protocol/CfwTransport.kt | 190 +++ .../app/g2protocol/ConnectionOptions.kt | 78 + .../g2protocol/FaceclawRingEventDecoder.kt | 145 ++ .../com/faceclaw/app/g2protocol/G2Event.kt | 141 ++ .../faceclaw/app/g2protocol/MessageBuilder.kt | 292 ++++ .../app/g2protocol/MessageReceiver.kt | 127 ++ .../app/g2protocol/OutboundMessage.kt | 68 + .../app/g2protocol/ProtocolPlatform.kt | 46 + .../app/g2protocol/TextureCacheState.kt | 191 +++ .../faceclaw/app/g2protocol/TexturePlanner.kt | 987 +++++++++++ .../com/faceclaw/app/graphics/FwGlyphAtlas.kt | 89 + .../com/faceclaw/app/graphics/GlyphAtlas.kt | 325 ++++ .../com/faceclaw/app/graphics/ImageAtlas.kt | 134 ++ .../com/faceclaw/app/graphics/LvglFontFile.kt | 250 +++ .../app/graphics/SharedGifScreenRecorder.kt | 270 +++ .../app/graphics/SharedScreenshots.kt | 55 + .../app/graphics/SurfaceCompositor.kt | 702 ++++++++ .../com/faceclaw/app/util/BinaryEncoding.kt | 45 + .../kotlin/com/faceclaw/app/util/BmpUtil.kt | 150 ++ .../com/faceclaw/app/util/ByteReader.kt | 43 + .../kotlin/com/faceclaw/app/util/ByteSink.kt | 44 + .../com/faceclaw/app/util/CollectionUtils.kt | 31 + .../com/faceclaw/shared/KotlinBridge.kt | 20 +- .../kotlin/com/faceclaw/app/IosNativeApi.kt | 264 +++ .../com/faceclaw/app/PlatformServices.ios.kt | 72 + .../app/g2protocol/IosProtocolPlatform.kt | 129 ++ .../com/faceclaw/shared/PlatformInfo.ios.kt | 13 + package-lock.json | 17 +- package.json | 7 +- scripts/kotlin-build.cjs | 73 + scripts/test-kotlin.sh | 8 + tests/README.md | 18 +- tests/compass-protocol.test.cjs | 19 - tests/compass-texture-cache.test.cjs | 2 +- tests/faceclaw-gesture-event.test.cjs | 19 - tests/kotlin-build.test.cjs | 43 + tests/kotlin/build.gradle.kts | 40 + tests/kotlin/settings.gradle.kts | 3 + .../faceclaw/app}/CompassProtocolTest.java | 0 .../app}/FaceclawGestureEventTest.java | 0 .../app}/RingBatteryProtocolTest.java | 0 .../app}/TextureCacheProtocolTest.java | 0 .../com/faceclaw/app/AndroidProtocolTest.kt | 117 ++ .../com/faceclaw/app/JavaCompatibilityTest.kt | 27 + .../com/faceclaw/app/AudioRecordingTest.kt | 44 + .../kotlin/com/faceclaw/app/FontTest.kt | 22 + .../kotlin/com/faceclaw/app/ProtocolTest.kt | 283 ++++ .../com/faceclaw/app/SharedGraphicsTest.kt | 136 ++ .../com/faceclaw/app/IosNativeApiTest.kt | 38 + .../com/faceclaw/app/IosProtocolTest.kt | 81 + tests/ring-battery-protocol.test.cjs | 19 - tests/texture-cache-protocol.test.cjs | 23 - 162 files changed, 9650 insertions(+), 6224 deletions(-) create mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/AndroidNoiseEffects.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawAlarmListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawAmbientLightListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawAudioPacketListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleCommunicatorListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawCaptionEngineListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawCompassListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawDeviceDiscoveryListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawEvenHubListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFirmwareFlasherListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFirmwareUtil.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFlashPromptListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawImuListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawLlamaListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawLocationListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawLocationTrackerListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawMediaBrowserListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawMediaControllerListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawMicStatusListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawModelDownloaderListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawNoiseSuppressor.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawNotificationListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawQrScannerListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawRingEventDecoder.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawSettingsListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawVoiceControllerListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawWavRecorder.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawWearListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawWebSocketListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FwGlyphAtlas.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/GlyphAtlas.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/ImageAtlas.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/LvglFontFile.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/SurfaceCompositor.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/BleImageOptimizer.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/BleMagicPool.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/BleProtocol.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/CfwMessageWindow.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/CfwTransport.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/ConnectionOptions.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/G2Event.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/MessageBuilder.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/OutboundMessage.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/TextureCacheState.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/TexturePlanner.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/util/BmpUtil.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/util/CollectionUtils.java create mode 100644 app/native/kotlin-protocol-smoke.ts create mode 100644 hooks/before-prepare/faceclaw-kotlin.js create mode 100644 native/kotlin/README.md create mode 100644 native/kotlin/android-java-boundaries.json create mode 100644 native/kotlin/build.gradle.kts create mode 100644 native/kotlin/migrated-java-sources.json create mode 100644 native/kotlin/plugin/index.js create mode 100644 native/kotlin/plugin/package.json create mode 100644 native/kotlin/settings.gradle.kts create mode 100644 native/kotlin/shared/build.gradle.kts create mode 100644 native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/AndroidByteReader.kt create mode 100644 native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/FaceclawFirmwareUtil.kt create mode 100644 native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/FaceclawWavRecorder.kt create mode 100644 native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/PlatformServices.android.kt create mode 100644 native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/g2protocol/AndroidProtocolPlatform.kt create mode 100644 native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/shared/PlatformInfo.android.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/PlatformServices.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/audio/FaceclawNoiseSuppressor.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawAlarmListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawAmbientLightListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawAudioPacketListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawBleCommunicatorListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawBleListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawCaptionEngineListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawCompassListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawDeviceDiscoveryListener.kt rename App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawDeviceInfoProbeListener.java => native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawDeviceInfoProbeListener.kt (52%) create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawEvenHubListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawFirmwareFlasherListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawFlashPromptListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawImuListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawLlamaListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawLocationListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawLocationTrackerListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawMediaBrowserListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawMediaControllerListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawMicStatusListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawModelDownloaderListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawNotificationListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawQrScannerListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawSettingsListener.kt rename App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawSseListener.java => native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawSseListener.kt (65%) create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawVoiceControllerListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawWearListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawWebSocketListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/BleImageOptimizer.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/BleMagicPool.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/BleProtocol.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/CfwMessageWindow.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/CfwTransport.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/ConnectionOptions.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/FaceclawRingEventDecoder.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/G2Event.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/MessageBuilder.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/MessageReceiver.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/OutboundMessage.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/ProtocolPlatform.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/TextureCacheState.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/TexturePlanner.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/FwGlyphAtlas.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/GlyphAtlas.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/ImageAtlas.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/LvglFontFile.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/SharedGifScreenRecorder.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/SharedScreenshots.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/SurfaceCompositor.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/BinaryEncoding.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/BmpUtil.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/ByteReader.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/ByteSink.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/CollectionUtils.kt create mode 100644 native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/app/IosNativeApi.kt create mode 100644 native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/app/PlatformServices.ios.kt create mode 100644 native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/app/g2protocol/IosProtocolPlatform.kt create mode 100644 native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/shared/PlatformInfo.ios.kt create mode 100644 scripts/kotlin-build.cjs create mode 100644 scripts/test-kotlin.sh delete mode 100644 tests/compass-protocol.test.cjs delete mode 100644 tests/faceclaw-gesture-event.test.cjs create mode 100644 tests/kotlin-build.test.cjs create mode 100644 tests/kotlin/build.gradle.kts create mode 100644 tests/kotlin/settings.gradle.kts rename tests/{fixtures => kotlin/src/androidHostTest/java/com/faceclaw/app}/CompassProtocolTest.java (100%) rename tests/{fixtures => kotlin/src/androidHostTest/java/com/faceclaw/app}/FaceclawGestureEventTest.java (100%) rename tests/{fixtures => kotlin/src/androidHostTest/java/com/faceclaw/app}/RingBatteryProtocolTest.java (100%) rename tests/{fixtures => kotlin/src/androidHostTest/java/com/faceclaw/app}/TextureCacheProtocolTest.java (100%) create mode 100644 tests/kotlin/src/androidHostTest/kotlin/com/faceclaw/app/AndroidProtocolTest.kt create mode 100644 tests/kotlin/src/androidHostTest/kotlin/com/faceclaw/app/JavaCompatibilityTest.kt create mode 100644 tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/AudioRecordingTest.kt create mode 100644 tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/FontTest.kt create mode 100644 tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/ProtocolTest.kt create mode 100644 tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/SharedGraphicsTest.kt create mode 100644 tests/kotlin/src/iosTest/kotlin/com/faceclaw/app/IosNativeApiTest.kt create mode 100644 tests/kotlin/src/iosTest/kotlin/com/faceclaw/app/IosProtocolTest.kt delete mode 100644 tests/ring-battery-protocol.test.cjs delete mode 100644 tests/texture-cache-protocol.test.cjs diff --git a/.gitignore b/.gitignore index 5f98a77a..141651cc 100644 --- a/.gitignore +++ b/.gitignore @@ -1,5 +1,5 @@ # NativeScript -hooks/ +hooks/* node_modules/ platforms/ @@ -15,6 +15,18 @@ yarn-error.log* # npm test compile output (tests/tsconfig.json outDir) .test-build/ +tests/kotlin/.gradle/ +tests/kotlin/.kotlin/ +tests/kotlin/build/ +native/kotlin/.gradle/ +native/kotlin/.kotlin/ +native/kotlin/build/ +native/kotlin/shared/build/ +native/kotlin/plugin/platforms/android/*.aar +native/kotlin/plugin/platforms/ios/ +!hooks/before-prepare/ +hooks/before-prepare/* +!hooks/before-prepare/faceclaw-kotlin.js # General .DS_Store @@ -42,4 +54,3 @@ faceclaw_settings.xml # Developer configs build_paths.sh - diff --git a/App_Resources/Android/app.gradle b/App_Resources/Android/app.gradle index 03846d58..832823ad 100644 --- a/App_Resources/Android/app.gradle +++ b/App_Resources/Android/app.gradle @@ -255,10 +255,6 @@ def faceclawVersionCode = { return parts[0] * 10000 + parts[1] * 100 + parts[2] }() -// ios-port packages commonMain in an AAR. Keeping this conditional lets the -// source relocation merge there without compiling the shared classes twice. -def faceclawDependencies = new groovy.json.JsonSlurper().parse(file("$rootDir/../../package.json")).dependencies ?: [:] - android { compileSdkVersion 35 buildToolsVersion "35" @@ -266,11 +262,7 @@ android { sourceSets.main { jniLibs.srcDirs += ["$projectDir/src/main/jniLibs"] - // Keep portable Kotlin at the same path as ios-port's KMP commonMain. - // main compiles it directly with the existing Android Kotlin plugin. - if (!faceclawDependencies.containsKey("@faceclaw/kotlin")) { - java.srcDirs += ["$rootDir/../../native/kotlin/shared/src/commonMain/kotlin"] - } + // Shared Kotlin is packaged by the local @faceclaw/kotlin plugin. } defaultConfig { @@ -301,12 +293,21 @@ android { // project. Remove the former copy before Kotlin compilation after this move. def removeLegacyKotlinBridgeSource = tasks.register("removeLegacyKotlinBridgeSource", Delete) { delete file("$projectDir/src/main/java/com/faceclaw/shared/KotlinBridge.kt") + // Explicit, reviewed source moves: never infer deletions from class names. + def migrations = new groovy.json.JsonSlurper().parse(file("$rootDir/../../native/kotlin/migrated-java-sources.json")) + migrations.each { migration -> + if (!file("$rootDir/../../native/kotlin/${migration.kotlin}").isFile()) { + throw new GradleException("Missing Kotlin replacement: ${migration.kotlin}") + } + delete file("$projectDir/src/main/java/${migration.java}") + } } tasks.matching { it.name.startsWith("compile") && it.name.endsWith("Kotlin") }.configureEach { dependsOn removeLegacyKotlinBridgeSource } tasks.matching { it.name == "preBuild" }.configureEach { + dependsOn removeLegacyKotlinBridgeSource dependsOn tasks.named("prepareFaceclawNativeLibs") dependsOn tasks.named("prepareFaceclawLlama") } diff --git a/App_Resources/Android/before-plugins.gradle b/App_Resources/Android/before-plugins.gradle index f643993d..da763a5b 100644 --- a/App_Resources/Android/before-plugins.gradle +++ b/App_Resources/Android/before-plugins.gradle @@ -10,7 +10,7 @@ project.ext { // androidXTransition = "1.4.1" // androidXViewPager = "1.0.0" - // NativeScript 9 already applies kotlin-android. Pin its current compiler + // NativeScript 9 already applies kotlin-android. Match the shared KMP compiler // for our .kt sources; no separate Kotlin installation is required. - kotlinVersion = "2.2.20" + kotlinVersion = "2.4.20" } diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/AndroidNoiseEffects.java b/App_Resources/Android/src/main/java/com/faceclaw/app/AndroidNoiseEffects.java new file mode 100644 index 00000000..72757990 --- /dev/null +++ b/App_Resources/Android/src/main/java/com/faceclaw/app/AndroidNoiseEffects.java @@ -0,0 +1,59 @@ +package com.faceclaw.app; + +import android.media.audiofx.*; +import java.util.ArrayList; + +/** Android AudioRecord effect attachment; PCM processing lives in shared Kotlin. */ +public final class AndroidNoiseEffects { + /** Whether this Android build ships the built-in capture noise suppressor. */ + public static boolean platformSuppressorAvailable() { + try { + return NoiseSuppressor.isAvailable(); + } catch (Throwable t) { + return false; + } + } + + /** Short engine name for the UI. */ + public static String engineDescription() { + return "spectral (phone DSP)"; + } + + /** + * Attach the platform's built-in capture-effect chain (NoiseSuppressor, + * AcousticEchoCanceler, AutomaticGainControl — whichever this Android + * build provides) to a phone AudioRecord session. Only applicable when the + * phone itself captures the audio; the BLE glasses stream must go through + * {@link #process(byte[])} instead. The caller keeps the returned effects + * for the life of the recording and release()s them with it. + */ + public static AudioEffect[] attachPlatformEffects(int audioSessionId) { + ArrayList effects = new ArrayList<>(); + try { + if (NoiseSuppressor.isAvailable()) { + NoiseSuppressor ns = NoiseSuppressor.create(audioSessionId); + if (ns != null) { + ns.setEnabled(true); + effects.add(ns); + } + } + if (AcousticEchoCanceler.isAvailable()) { + AcousticEchoCanceler aec = AcousticEchoCanceler.create(audioSessionId); + if (aec != null) { + aec.setEnabled(true); + effects.add(aec); + } + } + if (AutomaticGainControl.isAvailable()) { + AutomaticGainControl agc = AutomaticGainControl.create(audioSessionId); + if (agc != null) { + agc.setEnabled(true); + effects.add(agc); + } + } + } catch (Throwable t) { + // A missing effect just means this tier is unavailable. + } + return effects.toArray(new AudioEffect[0]); + } +} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawAlarmListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawAlarmListener.java deleted file mode 100644 index 4d9008f0..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawAlarmListener.java +++ /dev/null @@ -1,6 +0,0 @@ -package com.faceclaw.app; - -/** Phone-side alarm actions (dismiss / snooze), delivered to the JS engine; implemented in JS. */ -public interface FaceclawAlarmListener { - void onPhoneAction(long id, String action, int minutes); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawAmbientLightListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawAmbientLightListener.java deleted file mode 100644 index bc6bc272..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawAmbientLightListener.java +++ /dev/null @@ -1,10 +0,0 @@ -package com.faceclaw.app; - -public interface FaceclawAmbientLightListener { - /** - * A CFW ambient-light report (settings-channel field 105) from the master - * temple. body is the raw 24-byte ['A','L',ver,reason,...] record; it is - * decoded on the TS side (app/native/ambient-light.ts). - */ - void onAmbientLight(byte[] body); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawAudioPacketListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawAudioPacketListener.java deleted file mode 100644 index 16aa0702..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawAudioPacketListener.java +++ /dev/null @@ -1,5 +0,0 @@ -package com.faceclaw.app; - -public interface FaceclawAudioPacketListener { - void onAudioPacket(byte[] data, String arm, long arrivalMs); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleCommunicator.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleCommunicator.java index 0d38e59a..7b5436da 100644 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleCommunicator.java +++ b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleCommunicator.java @@ -154,7 +154,7 @@ public class FaceclawBleCommunicator implements FaceclawBleListener, Runnable { private int lastAudioControlAckMagic = 0; private ConnectionOptions connectionOptions = new ConnectionOptions(); - private final BleMagicPool magicPool = new BleMagicPool(); + private final BleMagicPool magicPool = new BleMagicPool(AndroidProtocolPlatform.INSTANCE); private MessageBuilder messageBuilder = new MessageBuilder(magicPool); private int nextTransportSeq = 0x40; private int nextMapSessionId = 0; @@ -267,7 +267,7 @@ public class FaceclawBleCommunicator implements FaceclawBleListener, Runnable { private final TextureCacheState textureCache = new TextureCacheState(); private final ArrayDeque pendingMessages = new ArrayDeque<>(); - private final CfwTransport[] cfwTransports = { new CfwTransport(), new CfwTransport() }; + private final CfwTransport[] cfwTransports = { new CfwTransport(AndroidProtocolPlatform.INSTANCE), new CfwTransport(AndroidProtocolPlatform.INSTANCE) }; private final ArrayDeque inFlightMessages = new ArrayDeque<>(); private OutboundMessage prewrittenMessage; private List prewrittenFrames = Collections.emptyList(); @@ -360,6 +360,7 @@ public class FaceclawBleCommunicator implements FaceclawBleListener, Runnable { activeInstance = null; } disconnect(); + for (CfwTransport transport : cfwTransports) transport.close(); if (phoneLockReceiverRegistered) { phoneLockReceiverRegistered = false; appContext.unregisterReceiver(phoneLockReceiver); @@ -1231,7 +1232,8 @@ public class FaceclawBleCommunicator implements FaceclawBleListener, Runnable { + (glyphs == null ? " (no glyph draws)" : "")); FrameTimings.getInstance().spanStart(frameId, "composite"); SurfaceCompositor.Composite composite = compositor.applyAndComposite( - surfaceId, pixels8bpp, rectX, rectY, rectWidth, rectHeight, contentFingerprint, glyphs); + surfaceId, new AndroidByteReader(pixels8bpp), rectX, rectY, rectWidth, rectHeight, contentFingerprint, + glyphs == null ? null : new AndroidByteReader(glyphs)); FrameTimings.getInstance().spanEnd(frameId, "composite"); // Pack the composited 8bpp buffer down to the headerless 4bpp frame // format the wire planners consume; BMP framing is added later only for @@ -2622,7 +2624,7 @@ public class FaceclawBleCommunicator implements FaceclawBleListener, Runnable { writeAddress, BleProtocol.WRITE_CHAR_UUID, frames, - ConnectionOptions.WRITE_TYPE, + AndroidProtocolPlatform.writeType(ConnectionOptions.WRITE_MODE), ConnectionOptions.WRITE_TIMEOUT_MS ); @@ -2669,7 +2671,7 @@ public class FaceclawBleCommunicator implements FaceclawBleListener, Runnable { writeAddress, BleProtocol.WRITE_CHAR_UUID, prefixFrames, - ConnectionOptions.WRITE_TYPE, + AndroidProtocolPlatform.writeType(ConnectionOptions.WRITE_MODE), ConnectionOptions.WRITE_TIMEOUT_MS ); if (!result) { @@ -2705,7 +2707,7 @@ public class FaceclawBleCommunicator implements FaceclawBleListener, Runnable { writeAddress, BleProtocol.WRITE_CHAR_UUID, Collections.singletonList(finalFrame), - ConnectionOptions.WRITE_TYPE, + AndroidProtocolPlatform.writeType(ConnectionOptions.WRITE_MODE), ConnectionOptions.WRITE_TIMEOUT_MS ); } @@ -3433,7 +3435,7 @@ public class FaceclawBleCommunicator implements FaceclawBleListener, Runnable { if (operation == BleProtocol.FACECLAW_WAKE_OP_ACQUIRE) { lastFaceclawWakeLeaseQueuedAtMs = SystemClock.elapsedRealtime(); } - Runnable onSent = () -> { + MessageCallback onSent = () -> { if (faceclawWakeControlGeneration == generation) { faceclawWakeControlSentCount += 1; } @@ -3489,7 +3491,7 @@ public class FaceclawBleCommunicator implements FaceclawBleListener, Runnable { if (operation == BleProtocol.FACECLAW_FB_OP_ACQUIRE) { lastFaceclawFramebufferLeaseQueuedAtMs = SystemClock.elapsedRealtime(); } - Runnable onSent = () -> { + MessageCallback onSent = () -> { if (faceclawFramebufferControlGeneration == generation) { faceclawFramebufferControlSentCount += 1; } diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleCommunicatorListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleCommunicatorListener.java deleted file mode 100644 index 8a6ed3d0..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleCommunicatorListener.java +++ /dev/null @@ -1,15 +0,0 @@ -package com.faceclaw.app; - -public interface FaceclawBleCommunicatorListener { - void onLog(String line); - void onStateChange(String phase, String status); - void onRingEvent(String kind, String containerName, int eventType, int eventSource, int systemExitReasonCode, int frameId); - void onBatteryState(int headsetBattery, int headsetCharging, int ringBattery, int ringCharging); - void onSilentMode(boolean silent); - void onWearState(boolean wearing); - void onPhoneLockState(boolean locked); - void onEvenAppConflict(String message); - void onFrameMetrics(int paintMs, int transmitMs, int tileCount); - void onFrameFinished(int frameId, String outcome); - void onFirmwareInfo(String leftVersion, String rightVersion, String extension); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleListener.java deleted file mode 100644 index 2a64c2fd..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleListener.java +++ /dev/null @@ -1,6 +0,0 @@ -package com.faceclaw.app; - -public interface FaceclawBleListener { - void onNotification(String address, String characteristicUuid, byte[] data); - void onConnectionStateChange(String address, boolean connected); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleManager.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleManager.java index b8ecc1df..7531a50e 100644 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleManager.java +++ b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleManager.java @@ -268,7 +268,7 @@ public class FaceclawBleManager { return false; } - BluetoothGattDescriptor descriptor = characteristic.getDescriptor(BleProtocol.CCCD_UUID); + BluetoothGattDescriptor descriptor = characteristic.getDescriptor(java.util.UUID.fromString(BleProtocol.CCCD_UUID)); if (descriptor == null) { descriptorLatches.remove(address); return true; diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawCaptionEngineListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawCaptionEngineListener.java deleted file mode 100644 index 24b58a85..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawCaptionEngineListener.java +++ /dev/null @@ -1,17 +0,0 @@ -package com.faceclaw.app; - -public interface FaceclawCaptionEngineListener { - /** - * One finished utterance. text may be empty when no ASR model is loaded - * or recognition produced nothing; embedding is the L2-normalized - * voice-print or null when the speaker model is unavailable or the - * utterance was too short. startMs/endMs are on the engine's sample - * clock (milliseconds of audio since start()). - */ - void onUtterance(String text, float[] embedding, long startMs, long endMs, double peakRms); - - /** A speech onset was detected; the utterance is now being collected. */ - void onSpeechStart(long startMs); - - void onStatus(String status); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawCompassListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawCompassListener.java deleted file mode 100644 index 1d6bb06e..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawCompassListener.java +++ /dev/null @@ -1,7 +0,0 @@ -package com.faceclaw.app; - -/** Receives stock compass heading and calibration notifications on the thread that subscribed. */ -public interface FaceclawCompassListener { - void onCompassEvent(int command, int headingDegrees, int magneticAccuracy, int magneticAnomalies, - int orientationSource, int diagnosticFlags, long sampleTimeMs); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawDeviceDiscoveryListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawDeviceDiscoveryListener.java deleted file mode 100644 index 922e7adb..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawDeviceDiscoveryListener.java +++ /dev/null @@ -1,18 +0,0 @@ -package com.faceclaw.app; - -/** Callbacks from FaceclawDeviceDiscovery's live scan to the TypeScript layer. */ -public interface FaceclawDeviceDiscoveryListener { - /** - * One advertisement (or one bonded device) as a JSON object: - * {address, name, manufacturerData (hex, company id included), rssi|null, - * txPower|null, connectable|null, bonded, source, seenAtMs}. - * Protocol decoding happens in TypeScript (see app/g2/even-advertisement.ts). - */ - void onAdvertisement(String json); - - /** The platform refused to start or continue the scan. */ - void onScanFailed(int errorCode, String message); - - /** Diagnostic line for the pairing log. */ - void onLog(String line); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawDeviceInfoProbe.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawDeviceInfoProbe.java index c4ad3efe..7e7e5991 100644 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawDeviceInfoProbe.java +++ b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawDeviceInfoProbe.java @@ -362,7 +362,7 @@ public class FaceclawDeviceInfoProbe implements FaceclawBleListener { boolean written; try { written = bleManager.writeFrames( - address, BleProtocol.WRITE_CHAR_UUID, frames, ConnectionOptions.WRITE_TYPE, ConnectionOptions.WRITE_TIMEOUT_MS); + address, BleProtocol.WRITE_CHAR_UUID, frames, AndroidProtocolPlatform.writeType(ConnectionOptions.WRITE_MODE), ConnectionOptions.WRITE_TIMEOUT_MS); } catch (IllegalStateException e) { // "Not connected" — the link went away underneath us. written = false; @@ -475,7 +475,7 @@ public class FaceclawDeviceInfoProbe implements FaceclawBleListener { address, sid, flag, magic, seq, payload.length)); List frames = BleProtocol.framePb(payload, sid, flag, seq); boolean written = bleManager.writeFrames( - address, BleProtocol.WRITE_CHAR_UUID, frames, ConnectionOptions.WRITE_TYPE, ConnectionOptions.WRITE_TIMEOUT_MS); + address, BleProtocol.WRITE_CHAR_UUID, frames, AndroidProtocolPlatform.writeType(ConnectionOptions.WRITE_MODE), ConnectionOptions.WRITE_TIMEOUT_MS); if (!written) { emitLog("tx write FAILED sid=0x" + Integer.toHexString(sid)); synchronized (lock) { diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawEvenHubListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawEvenHubListener.java deleted file mode 100644 index 56ff2d61..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawEvenHubListener.java +++ /dev/null @@ -1,18 +0,0 @@ -package com.faceclaw.app; - -/** - * Callbacks from a hosted EvenHub app's WebView to the TypeScript host. - * All methods are delivered on the Android main thread (NativeScript's JS - * thread), regardless of which WebView-internal thread produced them. - */ -public interface FaceclawEvenHubListener { - /** - * The app invoked window.flutter_inappwebview.callHandler(handlerName, ...args). - * argsJson is the JSON-encoded argument array; callId identifies the - * promise to resolve via window.__fcResolve(callId, ok, value). - */ - void onEvenAppMessage(String handlerName, String argsJson, int callId); - - /** The WebView finished loading the app's page. */ - void onPageFinished(String url); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFirmwareFlasher.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFirmwareFlasher.java index 84d66a4f..3a941ac6 100644 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFirmwareFlasher.java +++ b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFirmwareFlasher.java @@ -301,7 +301,7 @@ public class FaceclawFirmwareFlasher implements FaceclawBleListener { private boolean writeOta(String address, String writeChar, int sid, byte[] payload, int seq) { List frames = BleProtocol.framePb(payload, sid, FLAG_OTA, seq); return bleManager.writeFrames( - address, writeChar, frames, ConnectionOptions.WRITE_TYPE, ConnectionOptions.WRITE_TIMEOUT_MS); + address, writeChar, frames, AndroidProtocolPlatform.writeType(ConnectionOptions.WRITE_MODE), ConnectionOptions.WRITE_TIMEOUT_MS); } private int waitAck(int wantOp, int timeoutMs) throws TimeoutException { diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFirmwareFlasherListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFirmwareFlasherListener.java deleted file mode 100644 index 2cd24e20..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFirmwareFlasherListener.java +++ /dev/null @@ -1,24 +0,0 @@ -package com.faceclaw.app; - -/** Callbacks from FaceclawFirmwareFlasher to the TypeScript layer. */ -public interface FaceclawFirmwareFlasherListener { - void onLog(String line); - - /** - * Fine-grained progress for the UI bar. `lens` is "left"/"right"; - * component/block indices are 1-based against their counts. `bytesSent` / - * `bytesTotal` cover the whole lens image, so a bar driven by them moves - * evenly even though the components differ wildly in size. - */ - void onProgress(String lens, int componentIndex, int componentCount, int blockIndex, int blockCount, - long bytesSent, long bytesTotal); - - /** - * Coarse lifecycle. `state` is one of: validating, connecting, flashing, - * rebooting, done, error. `detail` carries the lens name or a message. - */ - void onState(String state, String detail); - - /** Terminal callback: success or failure, with an explanatory message. */ - void onComplete(boolean success, String detail); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFirmwareUtil.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFirmwareUtil.java deleted file mode 100644 index 32ce5dc1..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFirmwareUtil.java +++ /dev/null @@ -1,57 +0,0 @@ -package com.faceclaw.app; - -import java.io.FileOutputStream; -import java.io.IOException; -import java.nio.ByteBuffer; -import java.nio.channels.FileChannel; -import java.security.MessageDigest; -import java.security.NoSuchAlgorithmException; - -/** - * Native helpers for the on-device custom-firmware build: SHA-256 hashing and - * binary file writing. Both take a java.nio.ByteBuffer so NativeScript can - * marshal a JS ArrayBuffer straight across without a per-element copy of the - * ~4 MB firmware image (and with no overload ambiguity). Also home of the one - * shared byte→hex encoder for com.faceclaw.app. - */ -public final class FaceclawFirmwareUtil { - private FaceclawFirmwareUtil() {} - - /** Lowercase hex of the bytes. The TS-side decoder is case-insensitive. */ - public static String bytesToHex(byte[] bytes) { - if (bytes == null || bytes.length == 0) { - return ""; - } - StringBuilder sb = new StringBuilder(bytes.length * 2); - for (byte b : bytes) { - int v = b & 0xff; - sb.append(Character.forDigit(v >>> 4, 16)); - sb.append(Character.forDigit(v & 0x0f, 16)); - } - return sb.toString(); - } - - /** Lowercase hex SHA-256 of the buffer's remaining bytes. */ - public static String sha256Hex(ByteBuffer data) { - try { - MessageDigest md = MessageDigest.getInstance("SHA-256"); - md.update(data.duplicate()); - return bytesToHex(md.digest()); - } catch (NoSuchAlgorithmException e) { - throw new RuntimeException("SHA-256 unavailable", e); - } - } - - /** Write the buffer's remaining bytes to `path`, overwriting any existing file. */ - public static void writeFile(String path, ByteBuffer data) { - try (FileOutputStream fos = new FileOutputStream(path); - FileChannel channel = fos.getChannel()) { - ByteBuffer view = data.duplicate(); - while (view.hasRemaining()) { - channel.write(view); - } - } catch (IOException e) { - throw new RuntimeException("firmware write failed: " + e.getMessage(), e); - } - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFlashPromptCommunicator.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFlashPromptCommunicator.java index 239e290f..ef342706 100644 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFlashPromptCommunicator.java +++ b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFlashPromptCommunicator.java @@ -362,7 +362,7 @@ public class FaceclawFlashPromptCommunicator implements FaceclawBleListener { address, BleProtocol.WRITE_CHAR_UUID, frames, - ConnectionOptions.WRITE_TYPE, + AndroidProtocolPlatform.writeType(ConnectionOptions.WRITE_MODE), ConnectionOptions.WRITE_TIMEOUT_MS); } diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFlashPromptListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFlashPromptListener.java deleted file mode 100644 index a7ac2da3..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFlashPromptListener.java +++ /dev/null @@ -1,23 +0,0 @@ -package com.faceclaw.app; - -/** Callbacks from FaceclawFlashPromptCommunicator to the TypeScript layer. */ -public interface FaceclawFlashPromptListener { - void onLog(String line); - - /** - * Lifecycle updates. `state` is one of: connecting, connected, prompting, - * battery, result, cancelled, timeout, disconnected, error. `detail` carries the - * "approved"/"declined" text for result, or an error/explanation message. - */ - void onState(String state, String detail); - - /** - * Battery percent of each arm, read after the user approved (or right - * after auth when the prompt is skipped); -1 when an arm didn't answer. - * Always fires before onResult(true). - */ - void onBattery(int rightPercent, int leftPercent); - - /** Fires once the user picks a menu row (or, with skipPrompt, once the battery is read): true = flash, false = cancel. */ - void onResult(boolean approved); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawImuListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawImuListener.java deleted file mode 100644 index 2be8bb81..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawImuListener.java +++ /dev/null @@ -1,10 +0,0 @@ -package com.faceclaw.app; - -/** - * Receives IMU (accelerometer) readings decoded from the glasses' sys-event - * stream. Registered on FaceclawBleCommunicator via addImuListener; callbacks - * are delivered on the Android main thread. - */ -public interface FaceclawImuListener { - void onImuData(double x, double y, double z, int eventSource); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawLlamaListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawLlamaListener.java deleted file mode 100644 index f5419b84..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawLlamaListener.java +++ /dev/null @@ -1,16 +0,0 @@ -package com.faceclaw.app; - -/** - * Callbacks for one on-phone LLM generation. Like the other bridge listeners, - * implementations are typically created on the NativeScript JS thread and - * FaceclawLlamaRunner posts these callbacks back to that thread's Looper. - */ -public interface FaceclawLlamaListener { - /** A piece of generated text (may be a partial word). */ - void onToken(String piece); - - /** Generation finished: "stop" (EOG), "length", or "cancelled". */ - void onDone(String stopReason); - - void onError(String message); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawLocationListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawLocationListener.java deleted file mode 100644 index 84aead80..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawLocationListener.java +++ /dev/null @@ -1,8 +0,0 @@ -package com.faceclaw.app; - -/** One-shot Android location callbacks for the TypeScript Weather bridge. */ -public interface FaceclawLocationListener { - void onLocation(double latitude, double longitude, float accuracyMeters, long timestampMs); - - void onError(String message); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawLocationTrackerListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawLocationTrackerListener.java deleted file mode 100644 index ff0fd1aa..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawLocationTrackerListener.java +++ /dev/null @@ -1,13 +0,0 @@ -package com.faceclaw.app; - -/** Continuous location callbacks for the TypeScript navigation bridge. */ -public interface FaceclawLocationTrackerListener { - /** - * A new fix. bearingDeg/speedMps are -1 when the fix doesn't carry them - * (common when stationary); accuracyMeters is -1 when unknown. - */ - void onLocation(double latitude, double longitude, float accuracyMeters, - float bearingDeg, float speedMps, long timestampMs); - - void onError(String message); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawMediaBrowserListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawMediaBrowserListener.java deleted file mode 100644 index d25c6758..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawMediaBrowserListener.java +++ /dev/null @@ -1,10 +0,0 @@ -package com.faceclaw.app; - -public interface FaceclawMediaBrowserListener { - void onConnectResult(int requestId, boolean connected, String rootId, String error); - - void onBrowseResult(int requestId, String childrenJson, String error); - - /** The service connection dropped after connecting (player crashed or was killed). */ - void onDisconnected(); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawMediaControllerListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawMediaControllerListener.java deleted file mode 100644 index 75909f0e..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawMediaControllerListener.java +++ /dev/null @@ -1,23 +0,0 @@ -package com.faceclaw.app; - -public interface FaceclawMediaControllerListener { - /** All observed session owners, before filtering or choosing the active player. */ - void onSessionAppsChanged(String appsJson); - - void onStateChange( - String playbackState, - String packageName, - String appName, - String title, - String artist, - String album, - long positionMs, - long durationMs, - float playbackSpeed, - boolean canPlayPause, - boolean canSkipNext, - boolean canSkipPrevious, - boolean accessEnabled, - String status - ); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawMicStatusListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawMicStatusListener.java deleted file mode 100644 index e739ea34..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawMicStatusListener.java +++ /dev/null @@ -1,10 +0,0 @@ -package com.faceclaw.app; - -public interface FaceclawMicStatusListener { - /** - * A CFW mic_control field-104 status record from one temple. body is the - * raw 21-byte ['M','C',ver,...] record (decoded on the TS side); arm is - * "L" or "R" for the temple's own BLE link, "?" if unmatched. - */ - void onMicStatus(byte[] body, String arm); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawModelDownloaderListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawModelDownloaderListener.java deleted file mode 100644 index 90bf9380..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawModelDownloaderListener.java +++ /dev/null @@ -1,11 +0,0 @@ -package com.faceclaw.app; - -/** Progress callbacks for FaceclawModelDownloader, posted to the creating thread's Looper. */ -public interface FaceclawModelDownloaderListener { - void onProgress(long bytesDownloaded, long totalBytes); - - /** The file is fully downloaded, verified, and moved to its final path. */ - void onDone(String path); - - void onError(String message); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawNoiseSuppressor.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawNoiseSuppressor.java deleted file mode 100644 index 5d9514dc..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawNoiseSuppressor.java +++ /dev/null @@ -1,266 +0,0 @@ -package com.faceclaw.app; - -import android.media.audiofx.AcousticEchoCanceler; -import android.media.audiofx.AudioEffect; -import android.media.audiofx.AutomaticGainControl; -import android.media.audiofx.NoiseSuppressor; - -import java.util.ArrayList; -import java.util.Arrays; - -/** - * Phone-side noise suppression for the microphone stream. - * - * Android's built-in noise cancellation (the {@link NoiseSuppressor} capture - * effect) only attaches to AudioRecord sessions on the phone's own microphones. Faceclaw's audio - * arrives as raw PCM over BLE from the glasses, which that effect chain never - * sees, so this class picks the best engine that can actually reach the - * samples: - * - * - Audio captured by the phone itself: {@link #attachPlatformEffects(int)} - * enables the device's built-in NS/AEC/AGC chain (hardware or OEM software, - * whatever the Android build ships) on the AudioRecord session. - * - Audio from the glasses (the normal case): {@link #process(byte[])} runs a - * WebRTC-NS-family spectral suppressor here on the phone — 16 ms sqrt-Hann - * frames at 50% overlap, per-bin asymmetric noise-floor tracking, and an - * over-subtracted Wiener gain with a residual floor so speech never pumps - * in and out of silence. - */ -public final class FaceclawNoiseSuppressor { - - private static final int FFT_SIZE = 256; - private static final int HOP = FFT_SIZE / 2; - private static final float OVERSUBTRACTION = 1.6f; - /** About -16 dB of residual: keeps the noise bed natural instead of gated. */ - private static final float GAIN_FLOOR = 0.15f; - private static final float GAIN_SMOOTHING = 0.6f; - /** Frames of pure noise-floor learning after start/reset (~100 ms). */ - private static final int NOISE_WARMUP_FRAMES = 12; - - private final int sampleRate; - private final float[] window = new float[FFT_SIZE]; - private final float[] history = new float[FFT_SIZE]; - private final float[] overlap = new float[HOP]; - private final float[] noise = new float[FFT_SIZE / 2 + 1]; - private final float[] gain = new float[FFT_SIZE / 2 + 1]; - private final float[] re = new float[FFT_SIZE]; - private final float[] im = new float[FFT_SIZE]; - private final short[] pending = new short[HOP]; - private int pendingCount = 0; - private int warmupFrames = 0; - - public FaceclawNoiseSuppressor(int sampleRate) { - this.sampleRate = sampleRate; - // sqrt-Hann (sine) analysis+synthesis windows: exact COLA at 50% overlap. - for (int i = 0; i < FFT_SIZE; i++) { - window[i] = (float) Math.sin(Math.PI * (i + 0.5) / FFT_SIZE); - } - reset(); - } - - public int getSampleRate() { - return sampleRate; - } - - /** Forget the learned noise floor (e.g. after the suppressor was toggled off). */ - public void reset() { - Arrays.fill(history, 0f); - Arrays.fill(overlap, 0f); - Arrays.fill(noise, 0f); - Arrays.fill(gain, 1f); - pendingCount = 0; - warmupFrames = 0; - } - - /** - * Suppress noise in 16-bit little-endian mono PCM. Streaming: input not - * filling a whole 8 ms hop is carried into the next call, so the output - * may be up to one hop shorter than the input (and longer on a later - * call); total latency is one hop. - */ - public byte[] process(byte[] pcm16le) { - if (pcm16le == null || pcm16le.length < 2) { - return pcm16le; - } - int sampleCount = pcm16le.length / 2; - int hops = (pendingCount + sampleCount) / HOP; - byte[] out = new byte[hops * HOP * 2]; - int outPos = 0; - int inPos = 0; - while (inPos < sampleCount) { - int take = Math.min(HOP - pendingCount, sampleCount - inPos); - for (int i = 0; i < take; i++) { - int lo = pcm16le[(inPos + i) * 2] & 0xff; - int hi = pcm16le[(inPos + i) * 2 + 1]; - pending[pendingCount + i] = (short) ((hi << 8) | lo); - } - pendingCount += take; - inPos += take; - if (pendingCount == HOP) { - outPos = processHop(out, outPos); - pendingCount = 0; - } - } - return out; - } - - private int processHop(byte[] out, int outPos) { - System.arraycopy(history, HOP, history, 0, FFT_SIZE - HOP); - for (int i = 0; i < HOP; i++) { - history[FFT_SIZE - HOP + i] = pending[i] / 32768f; - } - for (int i = 0; i < FFT_SIZE; i++) { - re[i] = history[i] * window[i]; - im[i] = 0f; - } - fft(re, im, false); - - boolean warming = warmupFrames < NOISE_WARMUP_FRAMES; - if (warming) { - warmupFrames++; - } - for (int b = 0; b <= FFT_SIZE / 2; b++) { - float power = re[b] * re[b] + im[b] * im[b]; - if (warming) { - noise[b] = warmupFrames == 1 ? power : noise[b] + (power - noise[b]) / warmupFrames; - } else if (power < noise[b]) { - // Track the floor down quickly; drift up slowly so speech - // energy never gets learned as noise. - noise[b] += (power - noise[b]) * 0.2f; - } else { - noise[b] = Math.min(power, noise[b] * 1.006f + 1e-10f); - } - float clean = power - OVERSUBTRACTION * noise[b]; - float g = clean > 0f ? clean / power : 0f; - if (g < GAIN_FLOOR) { - g = GAIN_FLOOR; - } - g = GAIN_SMOOTHING * gain[b] + (1f - GAIN_SMOOTHING) * g; - gain[b] = g; - re[b] *= g; - im[b] *= g; - if (b > 0 && b < FFT_SIZE / 2) { - re[FFT_SIZE - b] *= g; - im[FFT_SIZE - b] *= g; - } - } - - fft(re, im, true); - for (int i = 0; i < HOP; i++) { - float value = (overlap[i] + re[i] * window[i]) * 32767f; - int sample = Math.round(value); - if (sample > 32767) { - sample = 32767; - } - if (sample < -32768) { - sample = -32768; - } - out[outPos + i * 2] = (byte) (sample & 0xff); - out[outPos + i * 2 + 1] = (byte) ((sample >> 8) & 0xff); - } - for (int i = 0; i < HOP; i++) { - overlap[i] = re[HOP + i] * window[HOP + i]; - } - return outPos + HOP * 2; - } - - /** In-place iterative radix-2 FFT (inverse includes the 1/N scale). */ - private static void fft(float[] re, float[] im, boolean inverse) { - int n = re.length; - for (int i = 1, j = 0; i < n; i++) { - int bit = n >> 1; - for (; (j & bit) != 0; bit >>= 1) { - j ^= bit; - } - j ^= bit; - if (i < j) { - float t = re[i]; - re[i] = re[j]; - re[j] = t; - t = im[i]; - im[i] = im[j]; - im[j] = t; - } - } - for (int len = 2; len <= n; len <<= 1) { - double ang = 2 * Math.PI / len * (inverse ? 1 : -1); - float wRe = (float) Math.cos(ang); - float wIm = (float) Math.sin(ang); - for (int i = 0; i < n; i += len) { - float curRe = 1f; - float curIm = 0f; - for (int k = 0; k < len / 2; k++) { - int a = i + k; - int b = a + len / 2; - float xr = re[b] * curRe - im[b] * curIm; - float xi = re[b] * curIm + im[b] * curRe; - re[b] = re[a] - xr; - im[b] = im[a] - xi; - re[a] += xr; - im[a] += xi; - float nextRe = curRe * wRe - curIm * wIm; - curIm = curRe * wIm + curIm * wRe; - curRe = nextRe; - } - } - } - if (inverse) { - for (int i = 0; i < n; i++) { - re[i] /= n; - im[i] /= n; - } - } - } - - /** Whether this Android build ships the built-in capture noise suppressor. */ - public static boolean platformSuppressorAvailable() { - try { - return NoiseSuppressor.isAvailable(); - } catch (Throwable t) { - return false; - } - } - - /** Short engine name for the UI. */ - public static String engineDescription() { - return "spectral (phone DSP)"; - } - - /** - * Attach the platform's built-in capture-effect chain (NoiseSuppressor, - * AcousticEchoCanceler, AutomaticGainControl — whichever this Android - * build provides) to a phone AudioRecord session. Only applicable when the - * phone itself captures the audio; the BLE glasses stream must go through - * {@link #process(byte[])} instead. The caller keeps the returned effects - * for the life of the recording and release()s them with it. - */ - public static AudioEffect[] attachPlatformEffects(int audioSessionId) { - ArrayList effects = new ArrayList<>(); - try { - if (NoiseSuppressor.isAvailable()) { - NoiseSuppressor ns = NoiseSuppressor.create(audioSessionId); - if (ns != null) { - ns.setEnabled(true); - effects.add(ns); - } - } - if (AcousticEchoCanceler.isAvailable()) { - AcousticEchoCanceler aec = AcousticEchoCanceler.create(audioSessionId); - if (aec != null) { - aec.setEnabled(true); - effects.add(aec); - } - } - if (AutomaticGainControl.isAvailable()) { - AutomaticGainControl agc = AutomaticGainControl.create(audioSessionId); - if (agc != null) { - agc.setEnabled(true); - effects.add(agc); - } - } - } catch (Throwable t) { - // A missing effect just means this tier is unavailable. - } - return effects.toArray(new AudioEffect[0]); - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawNotificationListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawNotificationListener.java deleted file mode 100644 index 5dd6687a..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawNotificationListener.java +++ /dev/null @@ -1,5 +0,0 @@ -package com.faceclaw.app; - -public interface FaceclawNotificationListener { - void onNotificationPosted(String key); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawPreviewCompositor.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawPreviewCompositor.java index e0aaae58..b95f9061 100644 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawPreviewCompositor.java +++ b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawPreviewCompositor.java @@ -105,7 +105,8 @@ public final class FaceclawPreviewCompositor { java.nio.ByteBuffer glyphs ) { compositor.applyAndComposite( - surfaceId, pixels8bpp, rectX, rectY, rectWidth, rectHeight, contentFingerprint, glyphs); + surfaceId, new AndroidByteReader(pixels8bpp), rectX, rectY, rectWidth, rectHeight, contentFingerprint, + glyphs == null ? null : new AndroidByteReader(glyphs)); FrameTimings.getInstance().finishFrame(frameId, "composited (preview-only, no glasses)"); Runnable listener = frameListener; if (listener != null) { diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawQrScannerListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawQrScannerListener.java deleted file mode 100644 index b255991e..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawQrScannerListener.java +++ /dev/null @@ -1,10 +0,0 @@ -package com.faceclaw.app; - -/** Callbacks for one FaceclawQrScanner.scan; exactly one method fires. */ -public interface FaceclawQrScannerListener { - void onResult(String text); - - void onCancelled(); - - void onError(String message); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawRingEventDecoder.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawRingEventDecoder.java deleted file mode 100644 index 9cdc44f0..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawRingEventDecoder.java +++ /dev/null @@ -1,126 +0,0 @@ -package com.faceclaw.app; - -import java.util.Locale; - -final class FaceclawRingEventDecoder { - private FaceclawRingEventDecoder() { - } - - static DirectRingEvent decode(byte[] raw) { - if (raw == null || raw.length == 0) { - return null; - } - - DirectRingEvent chargerGesture = decodeChargerGesture(raw); - if (chargerGesture != null) { - return chargerGesture; - } - - return decodeDirectGesture(raw); - } - - private static DirectRingEvent decodeChargerGesture(byte[] raw) { - if (raw.length != 11) { - return null; - } - if (u8(raw[0]) != 0x00 || u8(raw[1]) != 0x09 || u8(raw[2]) != 0x61 || u8(raw[3]) != 0x00) { - return null; - } - - int code = u8(raw[4]); - int param = u8(raw[5]) | (u8(raw[6]) << 8); - long tick = (u8(raw[7]) | (u8(raw[8]) << 8) | (u8(raw[9]) << 16) | (u8(raw[10]) << 24)) & 0xffffffffL; - String detail = String.format(Locale.US, "code=0x%02x(%s) param=0x%04x tick=%d", code, chargerCodeName(code), param, tick); - - switch (code) { - case 0x00: - return event(BleProtocol.EVENT_RING_LONG_PRESS, "LONG_PRESS", detail); - case 0x01: - return event(BleProtocol.EVENT_CLICK, "TAP", detail); - case 0x02: - return event(BleProtocol.EVENT_DOUBLE_CLICK, "DOUBLE_TAP", detail); - case 0x04: - return event(BleProtocol.EVENT_SCROLL_TOP, "SWIPE_UP", detail); - case 0x05: - return event(BleProtocol.EVENT_SCROLL_BOTTOM, "SWIPE_DOWN", detail); - case 0x08: - return event(BleProtocol.EVENT_RING_LONG_PRESS_RELEASE, "LONG_PRESS_RELEASE", detail); - default: - return null; - } - } - - private static DirectRingEvent decodeDirectGesture(byte[] raw) { - if (raw.length != 3 || u8(raw[0]) != 0xff) { - return null; - } - - int type = u8(raw[1]); - int param = u8(raw[2]); - String detail = String.format(Locale.US, "type=0x%02x param=0x%02x", type, param); - - if (type == 0x03 && param == 0x20) { - return event(BleProtocol.EVENT_RING_LONG_PRESS, "HOLD", detail); - } - if (type == 0x04 && param == 0x01) { - return event(BleProtocol.EVENT_CLICK, "TAP_SINGLE", detail); - } - if (type == 0x04 && param == 0x02) { - return event(BleProtocol.EVENT_DOUBLE_CLICK, "TAP_DOUBLE", detail); - } - if (type == 0x05) { - if (param <= 0x01) { - return event(BleProtocol.EVENT_SCROLL_BOTTOM, "SWIPE_FORWARD", detail); - } - return event(BleProtocol.EVENT_SCROLL_TOP, "SWIPE_BACKWARD", detail); - } - - return null; - } - - private static DirectRingEvent event(int eventType, String label, String detail) { - G2Event event = new G2Event( - "sys-event", - "", - eventType, - BleProtocol.EVENT_SOURCE_RING, - 0 - ); - return new DirectRingEvent(event, label, detail); - } - - private static String chargerCodeName(int code) { - switch (code) { - case 0x00: - return "LONG_PRESS"; - case 0x01: - return "TAP"; - case 0x02: - return "DOUBLE_TAP"; - case 0x04: - return "SWIPE_UP"; - case 0x05: - return "SWIPE_DOWN"; - case 0x08: - return "LONG_PRESS_RELEASE"; - default: - return "unknown"; - } - } - - private static int u8(byte value) { - return value & 0xff; - } - - static final class DirectRingEvent { - final G2Event event; - final String label; - final String detail; - - DirectRingEvent(G2Event event, String label, String detail) { - this.event = event; - this.label = label; - this.detail = detail; - } - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawSettingsListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawSettingsListener.java deleted file mode 100644 index a34bd7ab..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawSettingsListener.java +++ /dev/null @@ -1,6 +0,0 @@ -package com.faceclaw.app; - -/** Change-notification callback for FaceclawSettings; implemented in JS. */ -public interface FaceclawSettingsListener { - void onSettingChanged(String key); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawVoiceControllerListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawVoiceControllerListener.java deleted file mode 100644 index 95c5826f..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawVoiceControllerListener.java +++ /dev/null @@ -1,47 +0,0 @@ -package com.faceclaw.app; - -public interface FaceclawVoiceControllerListener { - void onStatus(String status); - - /** - * Best transcript of the current utterance so far. REPLACE semantics: text - * is the complete transcript, not a delta — display it verbatim, replacing - * any previous partial. isFinal marks the end of the utterance. - */ - void onTranscript(String text, boolean isFinal); - - /** Capture has finished, after the final transcript or a startup/recognition error. */ - void onStopped(int captureId); - - /** - * Decoded microphone audio: 16 kHz mono signed 16-bit little-endian PCM. - * Emitted in every mode so raw-PCM consumers (levels, recording, captions) - * keep working while the onboard recognizer owns the transcript. - */ - void onPcm(byte[] pcm16le); - - /** - * Per-packet DSP metadata the glasses firmware appends to each 50 ms audio - * packet, computed on the raw stereo capture before its mono downmix: the - * direction-of-arrival in signed degrees (0 = straight ahead, positive to - * the wearer's right) and a signal-strength ratio that serves as a - * confidence/energy proxy for the angle. - */ - void onFrameMeta(int angleDegrees, int ssr); - - /** - * The speaker stopped, in a hands-free session that has no button release - * to end it. Only fires when endpointing was enabled for the session; see - * FaceclawVoiceController.setEndpointing. - */ - void onSpeechEnd(); - - /** - * Result of speaker verification against the enrolled wearer voice-print, - * emitted once per capture session just before the final transcript. - * Only fires when verification was configured for the session; fails - * open (isWearer=true) when the utterance was too short to verify or the - * speaker model could not be loaded. - */ - void onSpeakerVerified(boolean isWearer, float similarity); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawWavRecorder.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawWavRecorder.java deleted file mode 100644 index ed08d388..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawWavRecorder.java +++ /dev/null @@ -1,100 +0,0 @@ -package com.faceclaw.app; - -import android.util.Log; - -import java.io.File; -import java.io.IOException; -import java.io.RandomAccessFile; -import java.nio.ByteBuffer; -import java.nio.ByteOrder; -import java.nio.charset.StandardCharsets; - -/** - * Streaming WAV writer for conversation recordings: the header is written up - * front with zero sizes and patched on finish, so a crash mid-session leaves - * a recoverable file (data length can be derived from the file size). - */ -public class FaceclawWavRecorder { - private static final String TAG = "FaceclawWavRecorder"; - - private final String path; - private final int sampleRate; - private final int channels; - private RandomAccessFile file; - private long dataBytes; - - public FaceclawWavRecorder(String path, int sampleRate, int channels) throws IOException { - this.path = path; - this.sampleRate = sampleRate; - this.channels = channels; - File parent = new File(path).getParentFile(); - if (parent != null && !parent.exists() && !parent.mkdirs()) { - throw new IOException("could not create " + parent); - } - file = new RandomAccessFile(path, "rw"); - file.setLength(0); - file.write(buildHeader(0)); - } - - public synchronized void append(byte[] pcm16le) { - if (file == null || pcm16le == null || pcm16le.length == 0) { - return; - } - try { - file.write(pcm16le); - dataBytes += pcm16le.length; - } catch (IOException e) { - Log.w(TAG, "append failed", e); - } - } - - public synchronized long getDurationMs() { - return dataBytes * 1000L / (sampleRate * channels * 2L); - } - - public String getPath() { - return path; - } - - /** Patch the header and close. Returns the PCM byte count (0 = empty). */ - public synchronized long finish() { - RandomAccessFile current = file; - file = null; - if (current == null) { - return dataBytes; - } - try { - current.seek(0); - current.write(buildHeader((int) Math.min(dataBytes, Integer.MAX_VALUE))); - current.close(); - } catch (IOException e) { - Log.w(TAG, "finish failed", e); - } - return dataBytes; - } - - /** Delete the (finished or abandoned) recording. */ - public synchronized void discard() { - finish(); - new File(path).delete(); - } - - private byte[] buildHeader(int pcmBytes) { - int byteRate = sampleRate * channels * 2; - ByteBuffer b = ByteBuffer.allocate(44).order(ByteOrder.LITTLE_ENDIAN); - b.put("RIFF".getBytes(StandardCharsets.US_ASCII)); - b.putInt(36 + pcmBytes); - b.put("WAVE".getBytes(StandardCharsets.US_ASCII)); - b.put("fmt ".getBytes(StandardCharsets.US_ASCII)); - b.putInt(16); - b.putShort((short) 1); - b.putShort((short) channels); - b.putInt(sampleRate); - b.putInt(byteRate); - b.putShort((short) (channels * 2)); - b.putShort((short) 16); - b.put("data".getBytes(StandardCharsets.US_ASCII)); - b.putInt(pcmBytes); - return b.array(); - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawWearListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawWearListener.java deleted file mode 100644 index 590c87d6..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawWearListener.java +++ /dev/null @@ -1,19 +0,0 @@ -package com.faceclaw.app; - -/** - * Callbacks from the Android Wear (Wear OS) bridge; implemented in JS. Every - * call is delivered on the thread that registered the listener (see - * FaceclawWearBridge.setListener). - */ -public interface FaceclawWearListener { - /** - * A message from the watch app. `path` is the Data Layer message path - * (e.g. "/faceclaw/input"); `json` is the UTF-8 payload (always a JSON - * object, "{}" when the watch sent none); `nodeId` identifies the watch - * so a reply can be addressed to it. - */ - void onMessage(String path, String json, String nodeId); - - /** The set of reachable watches running the Faceclaw watch app changed. */ - void onWatchConnection(boolean reachable, String watchName); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawWebSocketListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawWebSocketListener.java deleted file mode 100644 index f8e8733f..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawWebSocketListener.java +++ /dev/null @@ -1,9 +0,0 @@ -package com.faceclaw.app; - -/** Callbacks for FaceclawWebSocket, delivered on the Android main thread. */ -public interface FaceclawWebSocketListener { - void onOpen(); - void onTextMessage(String message); - void onClosed(int code, String reason); - void onFailure(String message); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FwGlyphAtlas.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FwGlyphAtlas.java deleted file mode 100644 index c6535c0c..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FwGlyphAtlas.java +++ /dev/null @@ -1,83 +0,0 @@ -package com.faceclaw.app; - -import java.nio.ByteBuffer; -import java.nio.ByteOrder; -import java.util.HashMap; -import java.util.Map; - -/** - * Process-wide registry of the glasses' builtin 20 px font's glyph rasters, - * fed from the TS side (EvenHubFont's extracted firmware font data). Unlike - * GlyphAtlas/ImageAtlas entries, these are never uploaded: the firmware - * already owns the font, and mode 15 draws it directly. The planner needs - * the rasters purely phone-side — for the "would this draw land correctly" - * check against the composite and for punching drawn ink out of delta rects. - * - * Placement model matches the firmware's mode-15 math: a glyph draws at - * (penX + ofsX, lineY + inkTop) where inkTop already folds in the root - * font's line height and baseline. The TS side only registers glyphs whose - * on-glasses rendering it predicts exactly (native-table glyphs; baseline- - * shifted fallback symbols stay baked). - */ -public final class FwGlyphAtlas { - private FwGlyphAtlas() {} - - public static final class Entry { - /** Draw x = pen x + ofsX. */ - public final int ofsX; - /** First raster row relative to the run's line-top y. */ - public final int inkTop; - public final int boxW; - public final int boxH; - /** 4bpp rows, stride ceil(boxW/2), high nibble = left pixel. */ - final byte[] nibbles; - - Entry(int ofsX, int inkTop, int boxW, int boxH, byte[] nibbles) { - this.ofsX = ofsX; - this.inkTop = inkTop; - this.boxW = boxW; - this.boxH = boxH; - this.nibbles = nibbles; - } - - /** The 4bpp source value at (col, row); the draw skips 0 (transparent). */ - public int nibbleAt(int col, int row) { - int b = nibbles[row * ((boxW + 1) >> 1) + (col >> 1)] & 0xff; - return (col & 1) != 0 ? (b & 0x0f) : (b >> 4); - } - } - - private static final Object lock = new Object(); - private static final Map entries = new HashMap<>(); - - /** - * Register glyph rasters. Little-endian buffer of records: - * [cp u32][ofsX s16][inkTop s16][boxW u8][boxH u8] - * [boxH x ceil(boxW/2) nibble bytes] - * Re-registration of a codepoint is ignored (the builtin font is fixed). - */ - public static void register(ByteBuffer buffer) { - if (buffer == null) return; - ByteBuffer in = buffer.order(ByteOrder.LITTLE_ENDIAN); - synchronized (lock) { - while (in.remaining() >= 10) { - int cp = in.getInt(); - int ofsX = in.getShort(); - int inkTop = in.getShort(); - int boxW = in.get() & 0xff; - int boxH = in.get() & 0xff; - byte[] nibbles = new byte[((boxW + 1) >> 1) * boxH]; - in.get(nibbles); - if (boxW > 0 && boxH > 0 && !entries.containsKey(cp)) { - entries.put(cp, new Entry(ofsX, inkTop, boxW, boxH, nibbles)); - } - } - } - } - - public static Entry get(int cp) { - synchronized (lock) { - return entries.get(cp); - } - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/GifScreenRecorder.java b/App_Resources/Android/src/main/java/com/faceclaw/app/GifScreenRecorder.java index cfba7631..1346b07e 100644 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/GifScreenRecorder.java +++ b/App_Resources/Android/src/main/java/com/faceclaw/app/GifScreenRecorder.java @@ -1,273 +1,26 @@ package com.faceclaw.app; import android.content.Context; - -import java.io.BufferedOutputStream; -import java.io.ByteArrayOutputStream; import java.io.File; import java.io.FileOutputStream; import java.io.IOException; -import java.io.OutputStream; -import java.util.ArrayList; -import java.util.Arrays; -import java.util.HashMap; -import java.util.List; -import java.util.zip.DataFormatException; -import java.util.zip.Inflater; -/** - * Accumulates composited screen frames and saves them as a looping animated - * GIF with a 16-entry grayscale palette. Stored frames are deflate-compressed - * (a typical UI frame shrinks from 166KB of indices to a few KB) so long - * recordings stay affordable in memory; consecutive identical frames are - * deduplicated, with the elapsed time folded into the next frame's delay. - */ +/** Android storage adapter for the shared GIF recorder. */ public final class GifScreenRecorder { - /** Backstop against unbounded growth if a recording is left running. */ - private static final int MAX_FRAMES = 3600; - /** Displayed duration of the final frame, which has no successor. */ - private static final int LAST_FRAME_DELAY_CS = 100; - /** Below this, GIF renderers historically clamp or ignore the delay. */ - private static final int MIN_FRAME_DELAY_CS = 2; + private final SharedGifScreenRecorder recorder = new SharedGifScreenRecorder(); - private static final class Frame { - final byte[] deflatedIndices; - final long timestampMs; - - Frame(byte[] deflatedIndices, long timestampMs) { - this.deflatedIndices = deflatedIndices; - this.timestampMs = timestampMs; - } + public void addFrame(byte[] gray, int width, int height, long timestampMs) { + recorder.addFrame(gray, width, height, timestampMs); } - private final List frames = new ArrayList<>(); - /** Undeflated copy of the newest frame, kept for duplicate detection. */ - private byte[] lastIndices; - private int width; - private int height; - private boolean overflowed; + public boolean isOverflowed() { return recorder.isOverflowed(); } - /** - * Append the current screen. gray is 8bpp; only the top nibble (the - * display's native depth, and the palette index) is kept. - */ - public synchronized void addFrame(byte[] gray, int width, int height, long timestampMs) { - if (gray == null || width <= 0 || height <= 0 || gray.length < width * height) { - return; - } - if (frames.isEmpty()) { - this.width = width; - this.height = height; - } else if (width != this.width || height != this.height) { - return; - } - byte[] indices = new byte[width * height]; - for (int i = 0; i < indices.length; i++) { - indices[i] = (byte) ((gray[i] & 0xff) >>> 4); - } - if (lastIndices != null && Arrays.equals(indices, lastIndices)) { - return; - } - if (frames.size() >= MAX_FRAMES) { - overflowed = true; - return; - } - frames.add(new Frame(ScreenshotUtil.zlibDeflate(indices), timestampMs)); - lastIndices = indices; - } - - /** True if frames were dropped because the recording hit MAX_FRAMES. */ - public synchronized boolean isOverflowed() { - return overflowed; - } - - /** - * Encode the recording as an animated GIF in the screenshots directory. - * Returns the absolute path, or "" if no frames were captured. - */ - public synchronized String save(Context context) throws IOException { - if (frames.isEmpty()) { - return ""; - } - File file = new File(ScreenshotUtil.ensureScreenshotsDir(context), "recording-" + ScreenshotUtil.timestamp() + ".gif"); - try (OutputStream out = new BufferedOutputStream(new FileOutputStream(file))) { - writeGif(out); - } + public String save(Context context) throws IOException { + byte[] gif = recorder.encode(); + if (gif.length == 0) return ""; + File file = new File(ScreenshotUtil.ensureScreenshotsDir(context), + "recording-" + ScreenshotUtil.timestamp() + ".gif"); + try (FileOutputStream out = new FileOutputStream(file)) { out.write(gif); } return file.getAbsolutePath(); } - - private void writeGif(OutputStream out) throws IOException { - out.write('G'); - out.write('I'); - out.write('F'); - out.write('8'); - out.write('9'); - out.write('a'); - // Logical screen descriptor: global color table present, 8 bits of - // color resolution, 2^(3+1)=16 palette entries. - writeShortLE(out, width); - writeShortLE(out, height); - out.write(0x80 | 0x70 | 0x03); - out.write(0); // background color index - out.write(0); // pixel aspect ratio - for (int i = 0; i < 16; i++) { - int v = i * 17; - out.write(v); - out.write(v); - out.write(v); - } - // Netscape application extension: loop forever. - out.write(0x21); - out.write(0xff); - out.write(11); - out.write("NETSCAPE2.0".getBytes("US-ASCII")); - out.write(3); - out.write(1); - writeShortLE(out, 0); - out.write(0); - - for (int i = 0; i < frames.size(); i++) { - Frame frame = frames.get(i); - // Each frame displays until the next one was captured; the last - // frame has no successor, so give it a nominal one-second hold. - int delayCs = LAST_FRAME_DELAY_CS; - if (i + 1 < frames.size()) { - long deltaMs = frames.get(i + 1).timestampMs - frame.timestampMs; - delayCs = (int) Math.max(MIN_FRAME_DELAY_CS, Math.min(0xffff, Math.round(deltaMs / 10.0))); - } - // Graphic control extension: no disposal, no transparency. - out.write(0x21); - out.write(0xf9); - out.write(4); - out.write(0x04); // disposal method 1 (do not dispose) - writeShortLE(out, delayCs); - out.write(0); // transparent color index (unused) - out.write(0); - // Image descriptor: full frame, no local color table. - out.write(0x2c); - writeShortLE(out, 0); - writeShortLE(out, 0); - writeShortLE(out, width); - writeShortLE(out, height); - out.write(0); - writeLzwImageData(out, inflate(frame.deflatedIndices, width * height)); - } - out.write(0x3b); // trailer - } - - private static byte[] inflate(byte[] deflated, int size) throws IOException { - Inflater inflater = new Inflater(); - inflater.setInput(deflated); - byte[] data = new byte[size]; - try { - int offset = 0; - while (offset < size && !inflater.finished()) { - int n = inflater.inflate(data, offset, size - offset); - if (n == 0) break; - offset += n; - } - if (offset != size) { - throw new IOException("recorded frame truncated: " + offset + " of " + size); - } - } catch (DataFormatException e) { - throw new IOException("recorded frame corrupt", e); - } finally { - inflater.end(); - } - return data; - } - - /** GIF LZW compression of a 4-bit index stream (minimum code size 4). */ - private static void writeLzwImageData(OutputStream out, byte[] indices) throws IOException { - final int minCodeSize = 4; - out.write(minCodeSize); - SubBlockBitWriter writer = new SubBlockBitWriter(out); - final int clearCode = 1 << minCodeSize; - final int eoiCode = clearCode + 1; - int codeSize = minCodeSize + 1; - int nextCode = eoiCode + 1; - HashMap table = new HashMap<>(); - writer.writeCode(clearCode, codeSize); - int prefix = indices[0] & 0xff; - for (int i = 1; i < indices.length; i++) { - int k = indices[i] & 0xff; - int key = (prefix << 8) | k; - Integer code = table.get(key); - if (code != null) { - prefix = code; - continue; - } - writer.writeCode(prefix, codeSize); - if (nextCode == 0x1000) { - writer.writeCode(clearCode, codeSize); - table.clear(); - codeSize = minCodeSize + 1; - nextCode = eoiCode + 1; - } else { - if (nextCode >= (1 << codeSize)) { - codeSize++; - } - table.put(key, nextCode++); - } - prefix = k; - } - writer.writeCode(prefix, codeSize); - writer.writeCode(eoiCode, codeSize); - writer.finish(); - } - - /** - * Packs LZW codes LSB-first into bytes and the bytes into the 255-byte - * data sub-blocks GIF image data is carried in. - */ - private static final class SubBlockBitWriter { - private final OutputStream out; - private final byte[] block = new byte[255]; - private int blockLength; - private int bitBuffer; - private int bitCount; - - SubBlockBitWriter(OutputStream out) { - this.out = out; - } - - void writeCode(int code, int codeSize) throws IOException { - bitBuffer |= code << bitCount; - bitCount += codeSize; - while (bitCount >= 8) { - writeByte(bitBuffer & 0xff); - bitBuffer >>>= 8; - bitCount -= 8; - } - } - - void finish() throws IOException { - if (bitCount > 0) { - writeByte(bitBuffer & 0xff); - bitBuffer = 0; - bitCount = 0; - } - flushBlock(); - out.write(0); // block terminator - } - - private void writeByte(int b) throws IOException { - block[blockLength++] = (byte) b; - if (blockLength == 255) { - flushBlock(); - } - } - - private void flushBlock() throws IOException { - if (blockLength == 0) return; - out.write(blockLength); - out.write(block, 0, blockLength); - blockLength = 0; - } - } - - private static void writeShortLE(OutputStream out, int value) throws IOException { - out.write(value & 0xff); - out.write((value >>> 8) & 0xff); - } } diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/GlyphAtlas.java b/App_Resources/Android/src/main/java/com/faceclaw/app/GlyphAtlas.java deleted file mode 100644 index c075c230..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/GlyphAtlas.java +++ /dev/null @@ -1,267 +0,0 @@ -package com.faceclaw.app; - -import java.nio.ByteBuffer; -import java.nio.ByteOrder; -import java.nio.charset.StandardCharsets; -import java.util.HashMap; -import java.util.Map; - -/** - * Process-wide registry of glyph rasters, fed from the TS side so glyph - * identity survives to the BLE encoder (see notes/texture-cache-display-list- - * design.md). A frame's glyph list references entries here by (fontId, - * encoding); the texture-cache planner uses the raster three ways: - * - * - as the ink mask for the "would this draw land correctly" check against - * the composited frame, - * - to punch the ink pixels out of the baked delta rect it replaces, - * - pre-encoded as the CFW cached-image bytes ([w][h][4bpp RLE]) uploaded - * via mode 12 and drawn via mode 14 with a top-color LUT. 1bpp (BDF) - * glyphs store ink at 15 so the LUT maps them to exactly the requested - * level; AA (TTF) glyphs store true coverage nibbles the LUT scales. - * - * Fonts are identified by a stable string key (the embedded font name), NOT a - * per-JS-context counter: worker threads register independently and must agree - * on ids. Glyph rasters are immutable once registered; re-registration of the - * same (fontId, encoding) is ignored. - * - * Cell model: a cached glyph image is bbxWidth x cellHeight (the font's line - * height), with the ink rows at inkTop — so every glyph of a line is drawn at - * the same y (the line top), which is what lets one mode-14 string carry a - * whole run. The horizontal bearing (bbxX) is applied phone-side when - * computing the draw x. Vertical padding is nearly free: it RLE-encodes to a - * couple of tokens. - */ -public final class GlyphAtlas { - private GlyphAtlas() {} - - public static final class Glyph { - /** Cached image width in pixels (the glyph's tight bbox width). */ - public final int width; - /** Cached image height in pixels (the font's line height). */ - public final int cellHeight; - /** First row of ink within the cell. */ - public final int inkTop; - /** Number of ink rows. */ - public final int inkHeight; - /** Horizontal bearing: draw x = pen x + bbxX. */ - public final int bbxX; - /** 1bpp ink rows (inkHeight entries), bit (rowBitWidth-1-col) = ink; null for AA glyphs. */ - final int[] rows; - final int rowBitWidth; - /** AA coverage, width*inkHeight nibble values 0..15; null for 1bpp glyphs. */ - final byte[] coverage; - /** CFW cached-image bytes: [w][cellHeight][RLE(w*cellHeight px)]. */ - public final byte[] cachedBytes; - - Glyph(int width, int cellHeight, int inkTop, int inkHeight, int bbxX, - int[] rows, byte[] coverage) { - this.width = width; - this.cellHeight = cellHeight; - this.inkTop = inkTop; - this.inkHeight = inkHeight; - this.bbxX = bbxX; - this.rows = rows; - this.coverage = coverage; - this.rowBitWidth = ((width + 7) >> 3) << 3; - this.cachedBytes = encodeCachedImage(); - } - - /** - * The cell pixel's 4bpp source value at (col, row), row cell-relative. - * 1bpp glyphs are stored at 15 so the draw-time LUT (source*top/15) - * maps them to exactly the requested top color; AA glyphs carry their - * true coverage level. - */ - public int nibbleAt(int col, int row) { - if (col < 0 || col >= width) return 0; - int inkRow = row - inkTop; - if (inkRow < 0 || inkRow >= inkHeight) return 0; - if (coverage != null) return coverage[inkRow * width + col]; - return ((rows[inkRow] >>> (rowBitWidth - 1 - col)) & 1) != 0 ? 15 : 0; - } - - /** Whether the cell pixel at (col, row) has any ink (row is cell-relative). */ - public boolean inkAt(int col, int row) { - return nibbleAt(col, row) != 0; - } - - /** - * The firmware cached-image encoding: [width][height][RLE tokens] - * covering exactly width*cellHeight pixels (no row padding), each - * pixel's stored color being its nibbleAt value. - */ - private byte[] encodeCachedImage() { - int total = width * cellHeight; - // Worst case one token per pixel (1 byte each) + 2 header bytes. - byte[] out = new byte[2 + total]; - out[0] = (byte) width; - out[1] = (byte) cellHeight; - int o = 2; - int i = 0; - while (i < total) { - int color = nibbleAt(i % width, i / width); - int j = i + 1; - while (j < total && nibbleAt(j % width, j / width) == color) j++; - int run = j - i; - while (run > 0) { - int c = Math.min(run, 0xffff); - if (c <= 15) { - out[o++] = (byte) ((c << 4) | color); - } else if (c <= 255) { - // Worst case can exceed the sizing above only via escape - // forms, which occur for runs >= 16 (net win); safe. - out[o++] = (byte) color; - out[o++] = (byte) c; - } else { - out[o++] = (byte) color; - out[o++] = 0; - out[o++] = (byte) (c & 0xff); - out[o++] = (byte) (c >> 8); - } - run -= c; - } - i = j; - } - byte[] trimmed = new byte[o]; - System.arraycopy(out, 0, trimmed, 0, o); - return trimmed; - } - } - - private static final Object lock = new Object(); - private static final Map fontIds = new HashMap<>(); - private static final Map glyphs = new HashMap<>(); - private static int nextFontId = 1; - - /** Stable id for a font key; assigns one on first use. */ - public static int fontId(String key) { - synchronized (lock) { - Integer id = fontIds.get(key); - if (id == null) { - id = nextFontId++; - fontIds.put(key, id); - } - return id; - } - } - - public static Glyph get(int fontId, int encoding) { - synchronized (lock) { - return glyphs.get(key(fontId, encoding)); - } - } - - private static long key(int fontId, int encoding) { - return ((long) fontId << 32) | (encoding & 0xffffffffL); - } - - /** - * Register a batch of glyph rasters. Little-endian buffer, a sequence of - * font groups: - * [keyLen u8][key utf8][cellHeight u8][count u16] - * each followed by count glyph records: - * [encoding u32][bbxX s8][inkTop u8][width u8][inkHeight u8] - * [inkHeight x rows u32] (bit (ceil(width/8)*8 - 1 - col) = ink) - * Records for an already-registered (font, encoding) are skipped (glyph - * rasters are immutable for a given font key). Malformed buffers throw: - * they indicate a phone-side marshalling bug, never device state. - */ - public static void register(ByteBuffer buffer) { - if (buffer == null) return; - ByteBuffer in = buffer.order(ByteOrder.LITTLE_ENDIAN); - synchronized (lock) { - while (in.remaining() > 0) { - int keyLen = in.get() & 0xff; - byte[] keyBytes = new byte[keyLen]; - in.get(keyBytes); - String fontKey = new String(keyBytes, StandardCharsets.UTF_8); - int cellHeight = in.get() & 0xff; - int count = in.getShort() & 0xffff; - Integer idBoxed = fontIds.get(fontKey); - int id; - if (idBoxed == null) { - id = nextFontId++; - fontIds.put(fontKey, id); - } else { - id = idBoxed; - } - for (int g = 0; g < count; g++) { - int encoding = in.getInt(); - int bbxX = in.get(); - int inkTop = in.get() & 0xff; - int width = in.get() & 0xff; - int inkHeight = in.get() & 0xff; - int[] rows = new int[inkHeight]; - for (int r = 0; r < inkHeight; r++) { - rows[r] = in.getInt(); - } - long k = key(id, encoding); - if (!glyphs.containsKey(k) && width > 0 && cellHeight > 0 - && inkTop + inkHeight <= cellHeight) { - glyphs.put(k, new Glyph(width, cellHeight, inkTop, inkHeight, bbxX, - rows, null)); - } - } - } - } - } - - /** - * Register a batch of antialiased (4bpp) glyph rasters, e.g. TTF renders. - * Same font-group framing as register(), but each glyph record carries - * packed coverage instead of 1bpp rows: - * [encoding u32][bbxX s8][inkTop u8][width u8][inkHeight u8] - * [inkHeight x ceil(width/2) packed bytes, high nibble = left pixel] - * Nibble values are the final 4bpp source levels (the draw-time LUT - * scales them by the top color). Already-registered (font, encoding) - * records are skipped, as in register(). - */ - public static void registerAa(ByteBuffer buffer) { - if (buffer == null) return; - ByteBuffer in = buffer.order(ByteOrder.LITTLE_ENDIAN); - synchronized (lock) { - while (in.remaining() > 0) { - int keyLen = in.get() & 0xff; - byte[] keyBytes = new byte[keyLen]; - in.get(keyBytes); - String fontKey = new String(keyBytes, StandardCharsets.UTF_8); - int cellHeight = in.get() & 0xff; - int count = in.getShort() & 0xffff; - Integer idBoxed = fontIds.get(fontKey); - int id; - if (idBoxed == null) { - id = nextFontId++; - fontIds.put(fontKey, id); - } else { - id = idBoxed; - } - for (int g = 0; g < count; g++) { - int encoding = in.getInt(); - int bbxX = in.get(); - int inkTop = in.get() & 0xff; - int width = in.get() & 0xff; - int inkHeight = in.get() & 0xff; - int stride = (width + 1) >> 1; - byte[] coverage = new byte[width * inkHeight]; - for (int r = 0; r < inkHeight; r++) { - for (int b = 0; b < stride; b++) { - int packed = in.get() & 0xff; - int col = b * 2; - coverage[r * width + col] = (byte) (packed >> 4); - if (col + 1 < width) { - coverage[r * width + col + 1] = (byte) (packed & 0x0f); - } - } - } - long k = key(id, encoding); - if (!glyphs.containsKey(k) && width > 0 && cellHeight > 0 - && inkTop + inkHeight <= cellHeight) { - glyphs.put(k, new Glyph(width, cellHeight, inkTop, inkHeight, bbxX, - null, coverage)); - } - } - } - } - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/ImageAtlas.java b/App_Resources/Android/src/main/java/com/faceclaw/app/ImageAtlas.java deleted file mode 100644 index 206bae6b..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/ImageAtlas.java +++ /dev/null @@ -1,115 +0,0 @@ -package com.faceclaw.app; - -import java.nio.ByteBuffer; -import java.util.ArrayList; -import java.util.HashMap; -import java.util.List; -import java.util.Map; - -/** - * Process-wide registry of icon/image rasters for the texture-cache pipeline, - * the image counterpart of GlyphAtlas. Entries are content-addressed: the TS - * side keys each image by a hash of its dimensions and pixels, so the same - * icon registered from any thread or rendered at any time dedupes to one - * entry, and an icon whose content changes is simply a new entry. - * - * Unlike glyphs (1-bit ink recolored at draw time), images keep their exact - * 4bpp values: the cached bytes quantize the registered 8bpp pixels with the - * same GRAY_TO_NIBBLE table the composite is packed with, and the planner - * draws them via mode 13 with an identity LUT (top color 15) and the - * transparent bit — the draw writes exactly the nonzero-nibble pixels, which - * is what the eligibility check and hole punching are defined over. - */ -public final class ImageAtlas { - private ImageAtlas() {} - - public static final class Entry { - public final int width; - public final int height; - /** One 4bpp value per pixel, row-major. */ - final byte[] nibbles; - /** CFW cached-image bytes: [w][h][RLE(w*h pixels)]. */ - public final byte[] cachedBytes; - - Entry(int width, int height, byte[] nibbles) { - this.width = width; - this.height = height; - this.nibbles = nibbles; - this.cachedBytes = encodeCachedImage(); - } - - /** The 4bpp value the mode-13 draw would write at (col, row); 0 = skipped. */ - public int nibbleAt(int col, int row) { - return nibbles[row * width + col] & 0xff; - } - - private byte[] encodeCachedImage() { - int total = width * height; - byte[] out = new byte[2 + total]; - out[0] = (byte) width; - out[1] = (byte) height; - int o = 2; - int i = 0; - while (i < total) { - int color = nibbles[i] & 0xff; - int j = i + 1; - while (j < total && (nibbles[j] & 0xff) == color) j++; - int run = j - i; - while (run > 0) { - int c = Math.min(run, 0xffff); - if (c <= 15) { - out[o++] = (byte) ((c << 4) | color); - } else if (c <= 255) { - out[o++] = (byte) color; - out[o++] = (byte) c; - } else { - out[o++] = (byte) color; - out[o++] = 0; - out[o++] = (byte) (c & 0xff); - out[o++] = (byte) (c >> 8); - } - run -= c; - } - i = j; - } - byte[] trimmed = new byte[o]; - System.arraycopy(out, 0, trimmed, 0, o); - return trimmed; - } - } - - private static final Object lock = new Object(); - private static final Map ids = new HashMap<>(); - private static final List entries = new ArrayList<>(); - - /** - * Register an image (8bpp grayscale pixels, width*height bytes, row-major) - * under a content key, returning its id — or the existing id when the key - * is already registered (the pixels are then ignored: same key means same - * content). Ids are positive and stable for the process lifetime. - */ - public static int ensure(String key, int width, int height, ByteBuffer pixels8bpp) { - if (key == null || width <= 0 || width > 255 || height <= 0 || height > 255 - || pixels8bpp == null || pixels8bpp.remaining() < width * height) { - throw new IllegalArgumentException("bad image registration " + width + "x" + height); - } - synchronized (lock) { - Integer existing = ids.get(key); - if (existing != null) return existing; - byte[] nibbles = new byte[width * height]; - for (int i = 0; i < nibbles.length; i++) { - nibbles[i] = (byte) BmpUtil.nibbleForGray(pixels8bpp.get(i) & 0xff); - } - entries.add(new Entry(width, height, nibbles)); - int id = entries.size(); // ids start at 1 - ids.put(key, id); - return id; - } - } - - public static Entry get(int id) { - synchronized (lock) { - return id >= 1 && id <= entries.size() ? entries.get(id - 1) : null; - } - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/LvglFontFile.java b/App_Resources/Android/src/main/java/com/faceclaw/app/LvglFontFile.java deleted file mode 100644 index d728cc6b..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/LvglFontFile.java +++ /dev/null @@ -1,229 +0,0 @@ -package com.faceclaw.app; - -import android.util.Log; - -import java.io.File; -import java.io.IOException; -import java.io.RandomAccessFile; -import java.nio.ByteBuffer; -import java.nio.ByteOrder; -import java.util.HashMap; -import java.util.LinkedHashMap; -import java.util.Map; - -/** - * Reader for the serialized LVGL font image in the G2's CJK flash partition. - * Faceclaw bundles that font because it is Source Han Sans SC Light under the - * SIL OFL. Proprietary fonts embedded in the main firmware never pass through - * this class and are instead extracted on the user's phone during CFW install. - */ -public final class LvglFontFile { - private static final String TAG = "LvglFontFile"; - private static final int MAPPED_BASE = 0x80100000; - private static final int FONT_CACHE_SIZE = 2; - - private static final Map fontCache = - new LinkedHashMap(FONT_CACHE_SIZE, 0.75f, true) { - @Override - protected boolean removeEldestEntry(Map.Entry eldest) { - return size() > FONT_CACHE_SIZE; - } - }; - - private LvglFontFile() {} - - /** - * Returns [lineHeight, baseline] or an empty array when the font is invalid. - * The baseline is measured down from the top of the line. - */ - public static byte[] getMetrics(String path) { - FontData font = load(path); - if (font == null) return new byte[0]; - return new byte[] { (byte) font.lineHeight, (byte) font.baseline }; - } - - /** - * Returns one packed glyph: - * u16 boxW, u16 boxH, i16 ofsX, i16 ofsY, then aligned 4bpp bitmap bytes. - * Returns an empty array when the code point is not mapped. - */ - public static byte[] getGlyph(String path, int codePoint) { - FontData font = load(path); - if (font == null) return new byte[0]; - Integer glyphId = font.codePointToGlyph.get(codePoint); - if (glyphId == null || glyphId <= 0) return new byte[0]; - try { - int descriptor = font.glyphDescriptors + glyphId * 16; - int bitmapIndex = font.u32(descriptor); - int boxWidth = font.u16(descriptor + 8); - int boxHeight = font.u16(descriptor + 10); - int offsetX = font.i16(descriptor + 12); - int offsetY = font.i16(descriptor + 14); - int stride = boxWidth / 2 + 1; - int bitmapLength = boxWidth > 0 && boxHeight > 0 ? stride * boxHeight : 0; - font.check(font.glyphBitmaps + bitmapIndex, bitmapLength); - - byte[] result = new byte[8 + bitmapLength]; - putU16(result, 0, boxWidth); - putU16(result, 2, boxHeight); - putU16(result, 4, offsetX); - putU16(result, 6, offsetY); - System.arraycopy(font.bytes, font.glyphBitmaps + bitmapIndex, result, 8, bitmapLength); - return result; - } catch (RuntimeException e) { - Log.w(TAG, "invalid glyph U+" + Integer.toHexString(codePoint) + " in " + path, e); - return new byte[0]; - } - } - - private static synchronized FontData load(String path) { - if (path == null || path.isEmpty()) return null; - FontData cached = fontCache.get(path); - if (cached != null) return cached; - try { - FontData font = FontData.read(path); - fontCache.put(path, font); - return font; - } catch (IOException | RuntimeException e) { - Log.w(TAG, "could not load LVGL font " + path, e); - return null; - } - } - - private static void putU16(byte[] destination, int offset, int value) { - destination[offset] = (byte) (value & 0xff); - destination[offset + 1] = (byte) ((value >>> 8) & 0xff); - } - - private static final class FontData { - final byte[] bytes; - final ByteBuffer view; - final int lineHeight; - final int baseline; - final int glyphBitmaps; - final int glyphDescriptors; - final Map codePointToGlyph; - - private FontData(byte[] bytes) { - this.bytes = bytes; - this.view = ByteBuffer.wrap(bytes).order(ByteOrder.LITTLE_ENDIAN); - if (bytes.length < 0x40 || bytes[0] != 'Z' || bytes[1] != 'Z' || bytes[2] != 'Z' || bytes[3] != 'Z') { - throw new IllegalArgumentException("missing ZZZZ font header"); - } - - lineHeight = u16(0x38); - int baseLine = u16(0x3a); - baseline = lineHeight - baseLine; - - int descriptor = pointerOffset(u32(0x34)); - glyphBitmaps = pointerOffset(u32(descriptor)); - glyphDescriptors = pointerOffset(u32(descriptor + 4)); - int cmaps = pointerOffset(u32(descriptor + 8)); - int packed = u16(descriptor + 18); - int cmapCount = packed & 0x1ff; - int bitsPerPixel = (packed >>> 9) & 0xf; - int bitmapFormat = (packed >>> 14) & 0x3; - if (lineHeight <= 0 || baseline < 0 || cmapCount <= 0 || - bitsPerPixel != 4 || bitmapFormat != 3) { - throw new IllegalArgumentException("unsupported LVGL font metadata"); - } - - codePointToGlyph = new HashMap<>(); - for (int index = 0; index < cmapCount; index++) { - readCmap(cmaps + index * 20); - } - } - - static FontData read(String path) throws IOException { - File file = new File(path); - if (!file.isFile() || !file.canRead() || file.length() > Integer.MAX_VALUE) { - throw new IOException("font is not a readable file"); - } - byte[] bytes = new byte[(int) file.length()]; - try (RandomAccessFile input = new RandomAccessFile(file, "r")) { - input.readFully(bytes); - } - return new FontData(bytes); - } - - void readCmap(int address) { - int rangeStart = u32(address); - int rangeLength = u16(address + 4); - int glyphIdStart = u16(address + 6); - int unicodeListPointer = u32(address + 8); - int glyphIdOffsetsPointer = u32(address + 12); - int listLength = u16(address + 16); - int type = u8(address + 18); - - if (type == 2) { - for (int relative = 0; relative < rangeLength; relative++) { - codePointToGlyph.put(rangeStart + relative, glyphIdStart + relative); - } - return; - } - - if (type == 0) { - int offsets = pointerOffset(glyphIdOffsetsPointer); - for (int relative = 0; relative < rangeLength; relative++) { - int offset = u8(offsets + relative); - if (relative != 0 && offset == 0) continue; - codePointToGlyph.put(rangeStart + relative, glyphIdStart + offset); - } - return; - } - - if (type == 3 || type == 1) { - int unicodeList = pointerOffset(unicodeListPointer); - int offsets = glyphIdOffsetsPointer == 0 ? -1 : pointerOffset(glyphIdOffsetsPointer); - for (int index = 0; index < listLength; index++) { - int relative = u16(unicodeList + index * 2); - int offset = index; - if (offsets >= 0) { - offset = type == 1 ? u16(offsets + index * 2) : u8(offsets + index); - if (index != 0 && offset == 0) continue; - } - codePointToGlyph.put(rangeStart + relative, glyphIdStart + offset); - } - return; - } - - throw new IllegalArgumentException("unknown cmap type " + type); - } - - int u8(int offset) { - check(offset, 1); - return bytes[offset] & 0xff; - } - - int u16(int offset) { - check(offset, 2); - return view.getShort(offset) & 0xffff; - } - - int i16(int offset) { - check(offset, 2); - return view.getShort(offset); - } - - int u32(int offset) { - check(offset, 4); - return view.getInt(offset); - } - - int pointerOffset(int pointer) { - long unsignedPointer = pointer & 0xffffffffL; - long offset = unsignedPointer - (MAPPED_BASE & 0xffffffffL); - if (offset < 0 || offset > Integer.MAX_VALUE) { - throw new IllegalArgumentException("font pointer is outside the mapped partition"); - } - check((int) offset, 1); - return (int) offset; - } - - void check(int offset, int length) { - if (offset < 0 || length < 0 || (long) offset + length > bytes.length) { - throw new IllegalArgumentException("font range is out of bounds"); - } - } - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/ScreenshotUtil.java b/App_Resources/Android/src/main/java/com/faceclaw/app/ScreenshotUtil.java index 9ffdcd1b..313abece 100644 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/ScreenshotUtil.java +++ b/App_Resources/Android/src/main/java/com/faceclaw/app/ScreenshotUtil.java @@ -2,15 +2,12 @@ package com.faceclaw.app; import android.content.Context; -import java.io.ByteArrayOutputStream; import java.io.File; import java.io.FileOutputStream; import java.io.IOException; import java.text.SimpleDateFormat; import java.util.Date; import java.util.Locale; -import java.util.zip.CRC32; -import java.util.zip.Deflater; /** * Saves screenshots of the composited screen as 4-bit grayscale PNGs (the @@ -25,7 +22,7 @@ public final class ScreenshotUtil { if (gray == null || width <= 0 || height <= 0 || gray.length < width * height) { throw new IllegalArgumentException("invalid screenshot buffer"); } - byte[] png = encode4BitGrayPng(gray, width, height); + byte[] png = SharedScreenshots.encode4BitGrayPng(gray, width, height); File file = new File(ensureScreenshotsDir(context), "screen-" + timestamp() + ".png"); try (FileOutputStream out = new FileOutputStream(file)) { out.write(png); @@ -45,80 +42,4 @@ public final class ScreenshotUtil { return new SimpleDateFormat("yyyyMMdd-HHmmss-SSS", Locale.US).format(new Date()); } - /** - * Encode an 8bpp grayscale buffer as a bit-depth-4 grayscale PNG, keeping - * the top nibble of each pixel (the same quantization the wire format uses). - */ - static byte[] encode4BitGrayPng(byte[] gray, int width, int height) { - // Raw scanlines: one filter byte (0 = None) then two pixels per byte, - // leftmost pixel in the high nibble. - int rowBytes = (width + 1) / 2; - byte[] raw = new byte[height * (1 + rowBytes)]; - int p = 0; - for (int y = 0; y < height; y++) { - raw[p++] = 0; - int row = y * width; - for (int x = 0; x < width; x += 2) { - int hi = (gray[row + x] & 0xff) >>> 4; - int lo = (x + 1 < width) ? (gray[row + x + 1] & 0xff) >>> 4 : 0; - raw[p++] = (byte) ((hi << 4) | lo); - } - } - - ByteArrayOutputStream out = new ByteArrayOutputStream(); - out.write(0x89); - out.write('P'); - out.write('N'); - out.write('G'); - out.write(0x0d); - out.write(0x0a); - out.write(0x1a); - out.write(0x0a); - - ByteArrayOutputStream ihdr = new ByteArrayOutputStream(); - writeIntBE(ihdr, width); - writeIntBE(ihdr, height); - ihdr.write(4); // bit depth - ihdr.write(0); // color type: grayscale - ihdr.write(0); // compression - ihdr.write(0); // filter - ihdr.write(0); // interlace - writeChunk(out, "IHDR", ihdr.toByteArray()); - writeChunk(out, "IDAT", zlibDeflate(raw)); - writeChunk(out, "IEND", new byte[0]); - return out.toByteArray(); - } - - static byte[] zlibDeflate(byte[] data) { - Deflater deflater = new Deflater(); - deflater.setInput(data); - deflater.finish(); - ByteArrayOutputStream out = new ByteArrayOutputStream(Math.max(64, data.length / 8)); - byte[] buffer = new byte[8192]; - while (!deflater.finished()) { - out.write(buffer, 0, deflater.deflate(buffer)); - } - deflater.end(); - return out.toByteArray(); - } - - private static void writeChunk(ByteArrayOutputStream out, String type, byte[] data) { - writeIntBE(out, data.length); - CRC32 crc = new CRC32(); - for (int i = 0; i < 4; i++) { - int b = type.charAt(i); - out.write(b); - crc.update(b); - } - out.write(data, 0, data.length); - crc.update(data); - writeIntBE(out, (int) crc.getValue()); - } - - private static void writeIntBE(ByteArrayOutputStream out, int value) { - out.write((value >>> 24) & 0xff); - out.write((value >>> 16) & 0xff); - out.write((value >>> 8) & 0xff); - out.write(value & 0xff); - } } diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/SurfaceCompositor.java b/App_Resources/Android/src/main/java/com/faceclaw/app/SurfaceCompositor.java deleted file mode 100644 index 1a86e8cb..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/SurfaceCompositor.java +++ /dev/null @@ -1,509 +0,0 @@ -package com.faceclaw.app; - -import java.nio.ByteBuffer; -import java.util.ArrayList; -import java.util.Comparator; -import java.util.HashMap; -import java.util.List; -import java.util.Map; - -/** - * Retained-surface compositor: the phone-side model of what is on the glasses - * screen. - * - * Each surface is an 8bpp grayscale buffer retained at its last-submitted - * contents, positioned on the screen with a z-order and a transparency mode. - * Sources on the TS side (today the dashboard; later the shell and per-app - * worker threads) submit updates to their surface, and the compositor - * recombines the retained surfaces into a full-screen frame that feeds the - * existing dedupe/compress/transmit pipeline. Because every surface is - * retained, a full screen frame can be regenerated at any time (frame drops, - * reconnects, previews, screenshots) without asking sources to repaint. - * - * Surface format contract (mirrored by the TS side): - * - Pixels are 8bpp grayscale, row-major, one byte per pixel. The wire - * pipeline quantizes to 4bpp downstream, so the low nibble is not visible. - * - TRANSPARENCY_COLOR_KEY surfaces treat pixel value 0 as fully transparent - * and value 1 as black. Quantization collapses 1 into the same 4bpp level - * as 0, so reserving 0 costs no visible shade; painters of color-key - * surfaces must clamp intentional black to 1. - * - An update may cover any rect of its surface; the rest is retained. The - * update buffer holds exactly rectWidth*rectHeight bytes, row-major. - * - Surfaces composite in ascending z-order onto a black (0) background. - * - Surface geometry changes take effect when the next frame composites; - * they do not trigger a recomposite by themselves. - * - * Thread safety: all methods are safe to call from any thread. Apply and - * composite happen atomically under an internal lock, and each composite - * carries a monotonic sequence number so callers can detect when a composite - * was superseded by a concurrent one before being acted on. - */ -public final class SurfaceCompositor { - public static final int TRANSPARENCY_OPAQUE = 0; - public static final int TRANSPARENCY_COLOR_KEY = 1; - - /** - * One deferred draw (a text glyph or an icon image) within a frame, in - * screen coordinates. The draw's pixels are already baked into the - * composited gray buffer (the TS side bakes before submitting); this - * record preserves the draw's identity so the texture-cache planner can - * replay it as an on-glasses cached draw instead of image bytes. - * - * Glyphs: x/y are the pen position and line top; the raster (and its - * bearing/cell placement) comes from GlyphAtlas under (fontId, encoding). - * Images: x/y are the blit's top-left; the raster comes from ImageAtlas - * under imageId. - */ - public static final class ScreenDraw { - public static final int KIND_GLYPH = 0; - public static final int KIND_IMAGE = 1; - /** A firmware-builtin-font text run (CFW mode 15). */ - public static final int KIND_FWTEXT = 2; - - public final int kind; - /** Glyph draws only. */ - public final int fontId; - /** Glyph draws only. */ - public final int encoding; - /** Image draws only. */ - public final int imageId; - public final int x; - public final int y; - /** Glyph and fw-text draws: 8-bit brightness. */ - public final int value; - /** Fw-text runs only: member codepoints, in text order. */ - public final int[] fwCps; - /** Fw-text runs only: member pen offsets relative to x. */ - public final int[] fwDx; - /** Fw-text runs only: whether each member has visible pixels. */ - public final boolean[] fwInk; - - ScreenDraw(int kind, int fontId, int encoding, int imageId, int x, int y, int value, - int[] fwCps, int[] fwDx, boolean[] fwInk) { - this.kind = kind; - this.fontId = fontId; - this.encoding = encoding; - this.imageId = imageId; - this.x = x; - this.y = y; - this.value = value; - this.fwCps = fwCps; - this.fwDx = fwDx; - this.fwInk = fwInk; - } - - static ScreenDraw glyph(int fontId, int encoding, int penX, int lineY, int value) { - return new ScreenDraw(KIND_GLYPH, fontId, encoding, 0, penX, lineY, value, null, null, null); - } - - static ScreenDraw image(int imageId, int x, int y) { - return new ScreenDraw(KIND_IMAGE, 0, 0, imageId, x, y, 0, null, null, null); - } - - static ScreenDraw fwText(int x, int y, int value, int[] cps, int[] dx, boolean[] ink) { - return new ScreenDraw(KIND_FWTEXT, 0, 0, 0, x, y, value, cps, dx, ink); - } - } - - private static final ScreenDraw[] NO_DRAWS = new ScreenDraw[0]; - - /** One composited full-screen frame plus the metadata the pipeline needs. */ - public static final class Composite { - /** Full-screen 8bpp grayscale pixels, screenWidth*screenHeight bytes. */ - public final byte[] gray; - public final int width; - public final int height; - /** - * Stable identifier of screen content, combining every surface's - * geometry and content fingerprint; equal fingerprints mean equal - * composited pixels. - */ - public final String fingerprint; - /** Monotonic: a Composite with a higher seq contains strictly newer state. */ - public final long seq; - /** - * Screen-space deferred draws of every visible surface, in composite - * order (surface z ascending, then each surface's draw order). Their - * pixels are already baked into gray. - */ - public final ScreenDraw[] draws; - - Composite(byte[] gray, int width, int height, String fingerprint, long seq, ScreenDraw[] draws) { - this.gray = gray; - this.width = width; - this.height = height; - this.fingerprint = fingerprint; - this.seq = seq; - this.draws = draws == null ? NO_DRAWS : draws; - } - } - - private static final class Surface { - final String id; - int x; - int y; - int width; - int height; - int zOrder; - int transparency; - boolean visible = true; - byte[] pixels; - String fingerprint = ""; - /** Surface-local deferred draws of the retained content (already baked into pixels). */ - ScreenDraw[] draws = NO_DRAWS; - - Surface(String id) { - this.id = id; - } - } - - private final Object lock = new Object(); - private int screenWidth; - private int screenHeight; - private boolean blanked; - /** See setUnderlayDim: surfaces with zOrder below this are dimmed by underlayDim/256. */ - private int underlayDimBelowZOrder = Integer.MIN_VALUE; - private int underlayDim = 256; - private final Map surfaces = new HashMap<>(); - private long nextCompositeSeq = 1; - - /** Set the output frame size. Must be called before any surface work. */ - public void configureScreen(int width, int height) { - if (width <= 0 || height <= 0) { - throw new IllegalArgumentException("bad screen size " + width + "x" + height); - } - synchronized (lock) { - this.screenWidth = width; - this.screenHeight = height; - } - } - - /** - * Create a surface or update an existing one's geometry. A resize discards - * the surface's retained pixels (reset to 0). - */ - public void configureSurface(String id, int x, int y, int width, int height, int zOrder, int transparency) { - if (id == null || id.isEmpty()) { - throw new IllegalArgumentException("surface id must be non-empty"); - } - if (width <= 0 || height <= 0) { - throw new IllegalArgumentException("bad surface size " + width + "x" + height + " for " + id); - } - if (transparency != TRANSPARENCY_OPAQUE && transparency != TRANSPARENCY_COLOR_KEY) { - throw new IllegalArgumentException("bad transparency mode " + transparency + " for " + id); - } - synchronized (lock) { - requireScreenConfiguredLocked(); - Surface surface = surfaces.get(id); - if (surface == null) { - surface = new Surface(id); - surfaces.put(id, surface); - } - if (surface.pixels == null || surface.width != width || surface.height != height) { - surface.pixels = new byte[width * height]; - surface.fingerprint = ""; - surface.draws = NO_DRAWS; - } - surface.x = x; - surface.y = y; - surface.width = width; - surface.height = height; - surface.zOrder = zOrder; - surface.transparency = transparency; - } - } - - public void removeSurface(String id) { - synchronized (lock) { - surfaces.remove(id); - } - } - - /** - * Dim every surface whose zOrder is below belowZOrder to factor256/256 of - * its brightness (256 = no dimming): how a shell overlay that dims what it - * covers (the TS Layer.dimUnderneath) reaches the window surfaces beneath - * the shell surface, which the shell's own layer stack cannot paint. - * Visible pixels stay at least 1 (the color-key black); glyph and - * firmware-text draws keep their cached-draw form with a dimmed value; - * image draws leave the composite's draw list (their pixels, already - * baked into the surface, dim as raster). Takes effect when the next - * frame composites. - */ - public void setUnderlayDim(int belowZOrder, int factor256) { - synchronized (lock) { - underlayDimBelowZOrder = belowZOrder; - underlayDim = Math.max(0, Math.min(256, factor256)); - } - } - - /** The dim factor (256 = none) that applies to a surface. */ - private int dimForLocked(Surface surface) { - return surface.zOrder < underlayDimBelowZOrder ? underlayDim : 256; - } - - private static int dimValue(int value, int dim) { - return Math.max(1, (value * dim + 128) >> 8); - } - - /** - * Hidden surfaces keep their retained pixels and accept updates, but are - * excluded from the composite and its fingerprint (used for background - * windows). Takes effect when the next frame composites. - */ - public void setSurfaceVisible(String id, boolean visible) { - synchronized (lock) { - Surface surface = surfaces.get(id); - if (surface == null) { - throw new IllegalArgumentException("unknown surface " + id); - } - surface.visible = visible; - } - } - - /** - * While blanked (screen off), composites are all-zero regardless of - * surface content; retained state is untouched, so unblanking restores - * the screen without asking sources to repaint. - */ - public void setBlanked(boolean blanked) { - synchronized (lock) { - this.blanked = blanked; - } - } - - /** - * Apply an update to one surface and composite the whole screen, as one - * atomic step. The update covers the rect (rectX, rectY, rectWidth, - * rectHeight) in surface-local coordinates; pixels must hold exactly - * rectWidth*rectHeight bytes. contentFingerprint identifies the surface's - * full content after this update. - */ - public Composite applyAndComposite( - String surfaceId, - ByteBuffer pixels, - int rectX, - int rectY, - int rectWidth, - int rectHeight, - String contentFingerprint - ) { - return applyAndComposite(surfaceId, pixels, rectX, rectY, rectWidth, rectHeight, - contentFingerprint, null); - } - - /** - * As above, with the frame's deferred draws: a little-endian buffer of - * tagged records - * [0][fontId u16][encoding u32][penX s16][lineY s16][value u8] (glyph) - * [1][imageId u32][x s16][y s16] (image) - * in surface-local coordinates and draw order. The list describes the - * surface's FULL retained content and replaces the previous list, so it is - * only meaningful for full-surface updates (which is what every submitter - * sends); pass null to clear. Draw pixels must already be baked into pixels. - */ - public Composite applyAndComposite( - String surfaceId, - ByteBuffer pixels, - int rectX, - int rectY, - int rectWidth, - int rectHeight, - String contentFingerprint, - ByteBuffer glyphs - ) { - ScreenDraw[] parsed = parseDraws(glyphs); - synchronized (lock) { - requireScreenConfiguredLocked(); - Surface surface = surfaces.get(surfaceId); - if (surface == null) { - throw new IllegalArgumentException("unknown surface " + surfaceId); - } - if (rectX < 0 || rectY < 0 || rectWidth <= 0 || rectHeight <= 0 - || rectX + rectWidth > surface.width || rectY + rectHeight > surface.height) { - throw new IllegalArgumentException("update rect " + rectWidth + "x" + rectHeight - + "+" + rectX + "+" + rectY + " outside surface " + surfaceId - + " (" + surface.width + "x" + surface.height + ")"); - } - int expectedBytes = rectWidth * rectHeight; - if (pixels == null || pixels.remaining() != expectedBytes) { - throw new IllegalArgumentException("update buffer for " + surfaceId + " has " - + (pixels == null ? 0 : pixels.remaining()) + " bytes, expected " + expectedBytes); - } - for (int row = 0; row < rectHeight; row++) { - int dstOffset = (rectY + row) * surface.width + rectX; - pixels.get(surface.pixels, dstOffset, rectWidth); - } - surface.fingerprint = contentFingerprint == null ? "" : contentFingerprint; - surface.draws = parsed; - return compositeLocked(); - } - } - - private static ScreenDraw[] parseDraws(ByteBuffer draws) { - if (draws == null || draws.remaining() < 1) { - return NO_DRAWS; - } - ByteBuffer in = draws.order(java.nio.ByteOrder.LITTLE_ENDIAN); - List out = new ArrayList<>(); - while (in.remaining() >= 1) { - int kind = in.get() & 0xff; - if (kind == ScreenDraw.KIND_GLYPH && in.remaining() >= 11) { - int fontId = in.getShort() & 0xffff; - int encoding = in.getInt(); - int penX = in.getShort(); - int lineY = in.getShort(); - int value = in.get() & 0xff; - out.add(ScreenDraw.glyph(fontId, encoding, penX, lineY, value)); - } else if (kind == ScreenDraw.KIND_IMAGE && in.remaining() >= 8) { - int imageId = in.getInt(); - int x = in.getShort(); - int y = in.getShort(); - out.add(ScreenDraw.image(imageId, x, y)); - } else if (kind == ScreenDraw.KIND_FWTEXT && in.remaining() >= 6) { - int x = in.getShort(); - int y = in.getShort(); - int value = in.get() & 0xff; - int count = in.get() & 0xff; - if (in.remaining() < count * 7) { - break; // malformed tail: keep what parsed cleanly - } - int[] cps = new int[count]; - int[] dx = new int[count]; - boolean[] ink = new boolean[count]; - for (int i = 0; i < count; i++) { - cps[i] = in.getInt(); - dx[i] = in.getShort(); - ink[i] = in.get() != 0; - } - out.add(ScreenDraw.fwText(x, y, value, cps, dx, ink)); - } else { - break; // malformed tail: keep what parsed cleanly - } - } - return out.toArray(new ScreenDraw[0]); - } - - /** Composite the current retained state without applying an update. */ - public Composite composite() { - synchronized (lock) { - requireScreenConfiguredLocked(); - return compositeLocked(); - } - } - - /** - * Current composited pixels for the phone-side preview / screenshot, or - * null before the screen is configured. Does not consume a sequence - * number (it is never stored as the desired frame). - */ - public Composite previewComposite() { - synchronized (lock) { - if (screenWidth <= 0 || screenHeight <= 0) { - return null; - } - byte[] gray = buildGrayLocked(); - return new Composite(gray, screenWidth, screenHeight, "preview", 0, NO_DRAWS); - } - } - - private byte[] buildGrayLocked() { - byte[] gray = new byte[screenWidth * screenHeight]; - if (blanked) { - return gray; - } - List ordered = new ArrayList<>(surfaces.values()); - ordered.sort(Comparator - .comparingInt((Surface s) -> s.zOrder) - .thenComparing(s -> s.id)); - for (Surface surface : ordered) { - if (surface.visible) { - blendLocked(gray, surface); - } - } - return gray; - } - - private Composite compositeLocked() { - byte[] gray = new byte[screenWidth * screenHeight]; - if (blanked) { - return new Composite(gray, screenWidth, screenHeight, - "blanked:" + screenWidth + "x" + screenHeight, nextCompositeSeq++, NO_DRAWS); - } - List ordered = new ArrayList<>(surfaces.values()); - ordered.sort(Comparator - .comparingInt((Surface s) -> s.zOrder) - .thenComparing(s -> s.id)); - StringBuilder fingerprint = new StringBuilder(); - fingerprint.append(screenWidth).append('x').append(screenHeight); - List draws = new ArrayList<>(); - for (Surface surface : ordered) { - if (!surface.visible) continue; - blendLocked(gray, surface); - int dim = dimForLocked(surface); - for (ScreenDraw draw : surface.draws) { - if (dim < 256 && draw.kind == ScreenDraw.KIND_IMAGE) continue; - int value = dim < 256 ? dimValue(draw.value, dim) : draw.value; - draws.add(new ScreenDraw(draw.kind, draw.fontId, draw.encoding, draw.imageId, - draw.x + surface.x, draw.y + surface.y, value, - draw.fwCps, draw.fwDx, draw.fwInk)); - } - fingerprint.append('|').append(surface.id) - .append('@').append(surface.x).append(',').append(surface.y) - .append('+').append(surface.width).append('x').append(surface.height) - .append('#').append(surface.zOrder) - .append(':').append(surface.transparency) - .append(':').append(surface.fingerprint); - if (dim < 256) { - fingerprint.append(":dim").append(dim); - } - } - return new Composite(gray, screenWidth, screenHeight, fingerprint.toString(), nextCompositeSeq++, - draws.toArray(new ScreenDraw[0])); - } - - private void blendLocked(byte[] gray, Surface surface) { - // Clip the surface rect to the screen. - int srcX = Math.max(0, -surface.x); - int srcY = Math.max(0, -surface.y); - int dstX = Math.max(0, surface.x); - int dstY = Math.max(0, surface.y); - int copyWidth = Math.min(surface.width - srcX, screenWidth - dstX); - int copyHeight = Math.min(surface.height - srcY, screenHeight - dstY); - if (copyWidth <= 0 || copyHeight <= 0) { - return; - } - int dim = dimForLocked(surface); - for (int row = 0; row < copyHeight; row++) { - int srcOffset = (srcY + row) * surface.width + srcX; - int dstOffset = (dstY + row) * screenWidth + dstX; - if (dim < 256) { - // Dimmed: opaque or color-keyed, 0 stays 0 (black / transparent) - // and everything visible scales, never below 1. - for (int col = 0; col < copyWidth; col++) { - int value = surface.pixels[srcOffset + col] & 0xff; - if (value != 0) { - gray[dstOffset + col] = (byte) dimValue(value, dim); - } else if (surface.transparency == TRANSPARENCY_OPAQUE) { - gray[dstOffset + col] = 0; - } - } - } else if (surface.transparency == TRANSPARENCY_OPAQUE) { - System.arraycopy(surface.pixels, srcOffset, gray, dstOffset, copyWidth); - } else { - for (int col = 0; col < copyWidth; col++) { - byte value = surface.pixels[srcOffset + col]; - if (value != 0) { - gray[dstOffset + col] = value; - } - } - } - } - } - - private void requireScreenConfiguredLocked() { - if (screenWidth <= 0 || screenHeight <= 0) { - throw new IllegalStateException("configureScreen must be called first"); - } - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/BleImageOptimizer.java b/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/BleImageOptimizer.java deleted file mode 100644 index b9336cee..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/BleImageOptimizer.java +++ /dev/null @@ -1,555 +0,0 @@ -package com.faceclaw.app; - -import java.util.ArrayList; -import java.util.Arrays; -import java.util.Collections; -import java.util.List; -import android.util.Log; - -public final class BleImageOptimizer { - private BleImageOptimizer() {} - private static final String TAG = "BleImageOptimizer"; - - /** - * Split an image into fragments (packets), taking advantage of the fact that each packet can declare - * a logical size longer than its byte payload to get free trailing zero-padding. - * - * Each fragment's logical size stays within maxFragmentSize, while trailing zeros inside that span can - * be omitted from the payload. - */ - public static List planImageFragments(byte[] bmp, int maxFragmentSize) { - return planImageFragments(bmp, maxFragmentSize, false); - } - - public static List planImageFragments( - byte[] bmp, - int maxFragmentSize, - boolean reserveFinalByte - ) { - if (bmp == null || bmp.length == 0) { - return Collections.singletonList(new BleProtocol.ImageFragment(0, new byte[0], 0)); - } - if (maxFragmentSize <= 0) { - throw new IllegalArgumentException("maxFragmentSize must be positive"); - } - - final int bulkLength = reserveFinalByte ? bmp.length - 1 : bmp.length; - final int fragmentCount = ((bulkLength + maxFragmentSize - 1) / maxFragmentSize) - + (bulkLength < bmp.length ? 1 : 0); - final List fragments = new ArrayList<>(fragmentCount); - for (int index = 0; index * maxFragmentSize < bulkLength; index++) { - int start = index * maxFragmentSize; - int end = Math.min(start + maxFragmentSize, bulkLength); - fragments.add(buildFragment(index, bmp, start, end)); - } - if (bulkLength < bmp.length) { - fragments.add(new BleProtocol.ImageFragment( - fragments.size(), - Arrays.copyOfRange(bmp, bulkLength, bmp.length), - bmp.length - bulkLength - )); - } - Log.i(TAG, "planImageFragments: fragments=" + fragments.size() + ", bmp.length=" + bmp.length + ", maxFragmentSize=" + maxFragmentSize); - return fragments; - } - - private static BleProtocol.ImageFragment buildFragment(int index, byte[] bmp, int start, int end) { - int dataEnd = end; - while (dataEnd > start && bmp[dataEnd - 1] == 0) { - dataEnd -= 1; - } - if (dataEnd == start) { - return new BleProtocol.ImageFragment(index, new byte[0], end - start); - } - return new BleProtocol.ImageFragment( - index, - Arrays.copyOfRange(bmp, start, dataEnd), - end - start - ); - } - - public static final class TileImagePlan { - final int tileIndex; - final BleProtocol.ImageTileOptions tile; - // Headerless packed 4bpp frame (top-down, stride ceil(width/2)), kept for - // the displayed-tile dedup cache. Frames are immutable by convention: - // producers always allocate a fresh buffer, so no defensive copy here. - public final byte[] packed; - public final int width; - public final int height; - final byte[] payload; // bytes actually streamed: mode-6 rle(4bpp) - final int sessionId; - List fragments = Collections.emptyList(); - - TileImagePlan(int tileIndex, BleProtocol.ImageTileOptions tile, byte[] packed, int width, int height, int sessionId) { - this.tileIndex = tileIndex; - this.tile = tile; - this.packed = packed == null ? new byte[0] : packed; - this.width = width; - this.height = height; - this.payload = maybeCompress(this.packed, width, height); - this.sessionId = sessionId; - } - - /** - * Plan with an explicit wire payload (e.g. a mode-3 incremental update). - * packed must still be the FULL new frame: it feeds the displayed-frame - * dedup cache, which after an applied incremental equals the full frame. - */ - TileImagePlan(int tileIndex, BleProtocol.ImageTileOptions tile, byte[] packed, int width, int height, int sessionId, byte[] payloadOverride) { - this.tileIndex = tileIndex; - this.tile = tile; - this.packed = packed == null ? new byte[0] : packed; - this.width = width; - this.height = height; - this.payload = payloadOverride; - this.sessionId = sessionId; - } - } - - /** - * Build a mode-3 bounding-box incremental payload, or null when a full - * update should be sent instead (frames not comparable, or the changed - * region spans the whole screen). Wire format: - * [3][left/4][top/2][width/4][height/2][fid_lo][fid_hi][rle(headerless 4bpp region)] - * The region is top-down rows of the NEW frame, stride width/2 bytes. The - * box is aligned so left/width are multiples of 4 pixels and top/height - * multiples of 2 rows, letting each coordinate fit one byte and avoiding - * 4bpp byte-boundary corner cases. Identical frames yield null too; the - * caller's dedup check should normally catch that first. - * - * frameId is a little-endian uint16 the CFW uses to detect reordered, - * skipped or duplicated deltas (its diagnostic overlay); the caller advances - * it by 1 per emitted delta so consecutive deltas are consecutive. - */ - /** - * A mode-3 incremental payload plus diagnostics about how tightly the - * bounding box fit the actual change. {@code changedBytes} is how many - * packed bytes actually differ; {@code boxBytes} is how many the box sends. - * A large box with few changed bytes / multiple clusters means distant - * small edits were merged into one oversized box (which can spill past the - * fragment size into an extra serialized BLE message). - */ - public static final class IncrementalPlan { - public final byte[] payload; - public final int changedBytes; - public final int boxBytes; - public final int clusterCount; - - IncrementalPlan(byte[] payload, int changedBytes, int boxBytes, int clusterCount) { - this.payload = payload; - this.changedBytes = changedBytes; - this.boxBytes = boxBytes; - this.clusterCount = clusterCount; - } - } - - public static IncrementalPlan buildIncrementalImagePayload(byte[] previous, byte[] next, int width, int height, int frameId) { - int stride = (width + 1) >> 1; - if (width <= 0 || height <= 0 || previous == null || next == null - || previous.length != stride * height || next.length != stride * height) { - return null; - } - - // Full diff scan in packed-byte coordinates (1 byte = 2 pixels): the - // changed bounding box plus diagnostics (total changed bytes, and how - // many disjoint horizontal column-clusters the change splits into). - int minByteX = stride; - int maxByteX = -1; - int minY = height; - int maxY = -1; - int changedBytes = 0; - boolean[] columnChanged = new boolean[stride]; - for (int y = 0; y < height; y++) { - int rowOffset = y * stride; - for (int x = 0; x < stride; x++) { - if (previous[rowOffset + x] != next[rowOffset + x]) { - changedBytes++; - columnChanged[x] = true; - if (x < minByteX) minByteX = x; - if (x > maxByteX) maxByteX = x; - if (y < minY) minY = y; - maxY = y; - } - } - } - if (maxY < 0) { - return null; // identical - } - int clusterCount = 0; - boolean inCluster = false; - for (int x = minByteX; x <= maxByteX; x++) { - if (columnChanged[x]) { - if (!inCluster) clusterCount++; - inCluster = true; - } else { - inCluster = false; - } - } - - // Pixel-space box, aligned: left/width to multiples of 4, top/height to - // multiples of 2, clamped to the frame. - int left = (minByteX * 2) & ~3; - int rightExclusive = Math.min(width, (((maxByteX + 1) * 2) + 3) & ~3); - int top = minY & ~1; - int bottomExclusive = Math.min(height, (maxY + 2) & ~1); - int boxWidth = rightExclusive - left; - int boxHeight = bottomExclusive - top; - if (boxWidth >= width && boxHeight >= height) { - return null; // whole screen changed; full update is strictly better - } - - byte[] out = encodeMode3Rect(next, stride, left, top, boxWidth, boxHeight, frameId); - return new IncrementalPlan(out, changedBytes, (boxWidth >> 1) * boxHeight, clusterCount); - } - - /** - * The aligned changed bounding box between two same-size packed frames, or - * null when they are identical: pixel-space {left, top, width, height} with - * left/width multiples of 4 and top/height multiples of 2 (mode-3 header - * quantization). Exposed so the texture-cache planner can reuse the exact - * rect geometry the single-bbox path would send. - */ - public static int[] computeChangedBox(byte[] previous, byte[] next, int width, int height) { - int stride = (width + 1) >> 1; - if (width <= 0 || height <= 0 || previous == null || next == null - || previous.length != stride * height || next.length != stride * height) { - return null; - } - int minByteX = stride; - int maxByteX = -1; - int minY = height; - int maxY = -1; - for (int y = 0; y < height; y++) { - int rowOffset = y * stride; - for (int x = 0; x < stride; x++) { - if (previous[rowOffset + x] != next[rowOffset + x]) { - if (x < minByteX) minByteX = x; - if (x > maxByteX) maxByteX = x; - if (y < minY) minY = y; - maxY = y; - } - } - } - if (maxY < 0) { - return null; - } - int left = (minByteX * 2) & ~3; - int rightExclusive = Math.min(width, (((maxByteX + 1) * 2) + 3) & ~3); - int top = minY & ~1; - int bottomExclusive = Math.min(height, (maxY + 2) & ~1); - return new int[]{left, top, rightExclusive - left, bottomExclusive - top}; - } - - /** - * The multi-rect split of the changed region (see computeSplitRects), or null - * when it is one region / too fragmented / the frames aren't comparable. - * Exposed for the texture-cache planner. - */ - public static List computeChangedRects(byte[] previous, byte[] next, int width, int height, int maxRects) { - int stride = (width + 1) >> 1; - if (width <= 0 || height <= 0 || previous == null || next == null - || previous.length != stride * height || next.length != stride * height) { - return null; - } - List rects = computeSplitRects(previous, next, stride, width, height, maxRects); - return (rects == null || rects.size() < 2) ? null : rects; - } - - /** - * Encode one CFW mode-3 rectangle delta: - * [3][left/4][top/2][width/4][height/2][fid_lo][fid_hi][rle(box pixels)] - * left/width must be multiples of 4 (=> left>>1, width>>1 are whole bytes), top/ - * height multiples of 2. The box pixels are top-down rows of `next` (4bpp packed, - * width>>1 bytes/row), run-length encoded before deflate. Shared by the single-bbox - * path, each rect of a mode-8 multi-rect batch, and the texture-cache planner. - */ - static byte[] encodeMode3Rect(byte[] next, int stride, int left, int top, - int boxWidth, int boxHeight, int fid) { - int regionStride = boxWidth >> 1; - byte[] region = new byte[regionStride * boxHeight]; - for (int y = 0; y < boxHeight; y++) { - System.arraycopy(next, (top + y) * stride + (left >> 1), region, y * regionStride, regionStride); - } - byte[] compressed = rleEncode(region); - byte[] out = new byte[7 + compressed.length]; - out[0] = 3; - out[1] = (byte) (left / 4); - out[2] = (byte) (top / 2); - out[3] = (byte) (boxWidth / 4); - out[4] = (byte) (boxHeight / 2); - out[5] = (byte) (fid & 0xff); // fid_lo - out[6] = (byte) ((fid >> 8) & 0xff); // fid_hi - System.arraycopy(compressed, 0, out, 7, compressed.length); - return out; - } - - /** A full repaint in independently decodable commands below the uint16 record limit. */ - static List encodeFullFrameBands(byte[] packed, int width, int height, int firstFid) { - if (width <= 0 || width > 640 || (width & 3) != 0 || height <= 0 || height > 480 - || (height & 1) != 0 || packed.length != width * height / 2) { - throw new IllegalArgumentException("unsupported custom framebuffer dimensions"); - } - List commands = new ArrayList<>(); - int fid = firstFid; - for (int top = 0; top < height; top += 64) { - commands.add(encodeMode3Rect(packed, width / 2, 0, top, width, - Math.min(64, height - top), fid)); - fid = fid >= 0xfffe ? 1 : fid + 1; - } - return commands; - } - - /** - * A CFW mode-8 multi-segment payload (`[8][count]` then per-rect - * `[len16][mode-3 submsg]`) carrying several tight rectangle deltas instead of - * one bounding box, plus diagnostics. Each rect is applied to the firmware - * shadow with the panel push deferred, then presented once. Used when the change - * splits into regions whose bounding box wastes bytes (distant edits, or a sparse - * box); the caller falls back to the single-rect path when this returns null or - * isn't smaller. - */ - public static final class MultiRectPlan { - public final byte[] payload; - public final int rectCount; - public final int coveredBytes; // sum of rect region bytes, pre-compression - public final int nextFid; // fid to resume from (rectCount consumed) - - MultiRectPlan(byte[] payload, int rectCount, int coveredBytes, int nextFid) { - this.payload = payload; - this.rectCount = rectCount; - this.coveredBytes = coveredBytes; - this.nextFid = nextFid; - } - } - - // Break-even tuning for the rect splitter. Splitting adds ~15 fixed bytes per - // rect (seglen + mode-3 header + fid), so only split across gaps big enough to pay for that. - // Gaps are in the changed-mask's native units: whole 4bpp bytes (2px) for - // columns, rows for the vertical bands. Kept above the 4px/2px box alignment so - // aligned rects never overlap. - private static final int MULTI_RECT_V_GAP_ROWS = 4; - private static final int MULTI_RECT_H_GAP_BYTES = 6; - - /** - * Build a mode-8 multi-rect payload for the change between two same-size 4bpp - * frames, assigning consecutive frame ids starting at fidStart (each rect needs a - * distinct fid — the CFW skips duplicate fids). Returns null when the change is a - * single region (use the single-rect path), when it fragments past maxRects, or - * when the frames aren't comparable. - */ - public static MultiRectPlan buildMultiRectImagePayload(byte[] previous, byte[] next, int width, int height, int fidStart, int maxRects) { - int stride = (width + 1) >> 1; - if (width <= 0 || height <= 0 || previous == null || next == null - || previous.length != stride * height || next.length != stride * height) { - return null; - } - - List rects = computeSplitRects(previous, next, stride, width, height, maxRects); - if (rects == null || rects.size() < 2) { - return null; // single region (or too fragmented): caller uses the bbox path - } - - List subs = new ArrayList<>(rects.size()); - int coveredBytes = 0; - int fid = fidStart; - int total = 2; // [8][count] - for (int[] r : rects) { - byte[] sub = encodeMode3Rect(next, stride, r[0], r[1], r[2], r[3], fid); - subs.add(sub); - coveredBytes += (r[2] >> 1) * r[3]; - total += 2 + sub.length; // len16 + submsg - fid = (fid >= 0xfffe) ? 1 : fid + 1; - } - - byte[] out = new byte[total]; - out[0] = 8; - out[1] = (byte) rects.size(); - int pos = 2; - for (byte[] sub : subs) { - out[pos] = (byte) (sub.length & 0xff); - out[pos + 1] = (byte) ((sub.length >> 8) & 0xff); - pos += 2; - System.arraycopy(sub, 0, out, pos, sub.length); - pos += sub.length; - } - return new MultiRectPlan(out, rects.size(), coveredBytes, fid); - } - - /** - * Split the changed region between two packed 4bpp frames into a small set of - * aligned rectangles that together cover every changed pixel: maximal vertical - * bands of changed rows (merging gaps < V_GAP), each split into horizontal column - * clusters (merging gaps < H_GAP), with each cluster's rows tightened to where it - * actually changes. Rects are pixel-space {left,top,width,height}, left/width - * aligned to 4px and top/height to 2px. Returns null if there's no change or the - * split exceeds maxRects (caller falls back to a single bounding box). - */ - private static List computeSplitRects(byte[] previous, byte[] next, int stride, int width, int height, int maxRects) { - boolean[] rowChanged = new boolean[height]; - boolean anyChange = false; - for (int y = 0; y < height; y++) { - int off = y * stride; - for (int x = 0; x < stride; x++) { - if (previous[off + x] != next[off + x]) { - rowChanged[y] = true; - anyChange = true; - break; - } - } - } - if (!anyChange) { - return null; - } - - List rects = new ArrayList<>(); - boolean[] col = new boolean[stride]; - int y = 0; - while (y < height) { - if (!rowChanged[y]) { y++; continue; } - // Extend a vertical band across changed rows, hopping unchanged gaps < V_GAP. - int bandTop = y; - int bandBot = y; - int cur = y + 1; - while (cur < height) { - if (rowChanged[cur]) { bandBot = cur; cur++; continue; } - int g = cur; - while (g < height && !rowChanged[g]) g++; - if (g < height && (g - cur) < MULTI_RECT_V_GAP_ROWS) { cur = g; } else break; - } - - // Columns changed anywhere in the band. - Arrays.fill(col, false); - for (int yy = bandTop; yy <= bandBot; yy++) { - if (!rowChanged[yy]) continue; - int off = yy * stride; - for (int x = 0; x < stride; x++) { - if (previous[off + x] != next[off + x]) col[x] = true; - } - } - - // Split the band into horizontal clusters, hopping column gaps < H_GAP. - int x = 0; - while (x < stride) { - if (!col[x]) { x++; continue; } - int cL = x; - int cR = x; - int cx = x + 1; - while (cx < stride) { - if (col[cx]) { cR = cx; cx++; continue; } - int g = cx; - while (g < stride && !col[g]) g++; - if (g < stride && (g - cx) < MULTI_RECT_H_GAP_BYTES) { cx = g; } else break; - } - - // Tighten this cluster's rows to those that change within [cL,cR]. - int tTop = height; - int tBot = -1; - for (int yy = bandTop; yy <= bandBot; yy++) { - if (!rowChanged[yy]) continue; - int off = yy * stride; - for (int xx = cL; xx <= cR; xx++) { - if (previous[off + xx] != next[off + xx]) { - if (yy < tTop) tTop = yy; - tBot = yy; - break; - } - } - } - if (tBot >= 0) { - int left = (cL * 2) & ~3; - int rightExclusive = Math.min(width, (((cR + 1) * 2) + 3) & ~3); - int top = tTop & ~1; - int bottomExclusive = Math.min(height, (tBot + 2) & ~1); - rects.add(new int[]{left, top, rightExclusive - left, bottomExclusive - top}); - if (rects.size() > maxRects) { - return null; // too fragmented: a single bounding box is simpler - } - } - x = cR + 1; - } - y = bandBot + 1; - } - return rects; - } - - /** - * Run-length encode headerless 4bpp pixels for CFW load_image_z mode 6. - * Wire format: [6][rle(4bpp pixels)]. Always use mode 6: the logical - * image can be larger than its EvenHub carrier, so a raw BMP fallback would - * carry dimensions the legacy container loader cannot accept. - */ - static byte[] maybeCompress(byte[] packed, int width, int height) { - if (packed == null || packed.length == 0) { - return packed; - } - byte[] z = rleEncode(packed); - byte[] out = new byte[z.length + 1]; - out[0] = 6; - System.arraycopy(z, 0, out, 1, z.length); - return out; - } - - /** - * Run-length encode packed 4bpp pixels for CFW modes 3 and 6, whose payload is - * RLE tokens; deflate belongs to the transport. Runs are over the pixel NIBBLES of - * {@code pix} in wire order (high nibble = left pixel), including the pad nibble - * that ends each row at odd widths — i.e. {@code pix} read as 2*length nibbles. - * One token is: - *
-     *   [cnt4|color4]                 cnt 1..15
-     *   [0|color4][cnt8]              cnt 1..255
-     *   [0|color4][0][cntLo][cntHi]   cnt 1..65535, little-endian
-     * 
- * with the low nibble always the color; runs longer than 65535 split across - * tokens. Worst case (every nibble its own run) is exactly one byte per nibble, - * which is what the buffer is sized for. - */ - static byte[] rleEncode(byte[] pix) { - int n = pix.length * 2; - byte[] out = new byte[n]; - int o = 0; - int i = 0; - while (i < n) { - int v = nibbleAt(pix, i); - int j = i + 1; - while (j < n && nibbleAt(pix, j) == v) j++; - int run = j - i; - while (run > 0) { - int c = Math.min(run, 0xffff); - if (c <= 15) { - out[o++] = (byte) ((c << 4) | v); - } else if (c <= 255) { - out[o++] = (byte) v; // high nibble 0 = escape to an 8-bit count - out[o++] = (byte) c; - } else { - out[o++] = (byte) v; - out[o++] = 0; // 8-bit count 0 = escape to a 16-bit count - out[o++] = (byte) (c & 0xff); - out[o++] = (byte) (c >> 8); - } - run -= c; - } - i = j; - } - return Arrays.copyOf(out, o); - } - - private static int nibbleAt(byte[] pix, int i) { - int b = pix[i >> 1] & 0xff; - return (i & 1) != 0 ? (b & 0x0f) : (b >> 4); - } - - public static final class ImageUpdateStats { - final int paintMs; - final int tileCount; - final int frameId; - long firstWriteStartedAtMs; - - ImageUpdateStats(int paintMs, int tileCount, int frameId) { - this.paintMs = Math.max(0, paintMs); - this.tileCount = tileCount; - this.frameId = frameId; - } - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/BleMagicPool.java b/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/BleMagicPool.java deleted file mode 100644 index bd6afd79..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/BleMagicPool.java +++ /dev/null @@ -1,69 +0,0 @@ -package com.faceclaw.app; -import java.util.ArrayDeque; -import java.util.HashMap; -import java.util.Map; -import android.os.SystemClock; - -/** - * Protobuf messages contain a 1-byte identifier that is used to identify - * which message is referred to in ACK messages. We keep track of which - * identifiers are in use for inflight messages, with some metadata about - * what the message was. We allocate identifiers with an LRU policy so that - * if we release a message's identifier because it timed out, we can still - * detect late ACKs if it hasn't been reused yet. - */ -public final class BleMagicPool { - static final int MIN_MAGIC = 100; - static final int MAX_MAGIC = 255; - - private final ArrayDeque available = new ArrayDeque<>(); - private final boolean[] allocated = new boolean[256]; - private final Map releaseRecords = new HashMap<>(); - - BleMagicPool() { - for (int magic = MIN_MAGIC; magic <= MAX_MAGIC; magic++) { - available.addLast(magic); - } - } - - synchronized int allocate() { - Integer magic = available.pollFirst(); - if (magic == null) { - throw new IllegalStateException("no BLE magic values available"); - } - allocated[magic] = true; - return magic; - } - - synchronized void release(int sid, int magic, String label, String reason) { - if (magic < MIN_MAGIC || magic > MAX_MAGIC) { - return; - } - releaseRecords.put(key(sid, magic), new ReleaseRecord(label, reason, SystemClock.elapsedRealtime())); - if (!allocated[magic]) { - return; - } - allocated[magic] = false; - available.addLast(magic); - } - - synchronized ReleaseRecord getReleaseRecord(int sid, int magic) { - return releaseRecords.get(key(sid, magic)); - } - - private static String key(int sid, int magic) { - return sid + ":" + magic; - } - - public static final class ReleaseRecord { - final String label; - final String reason; - final long releasedAtMs; - - ReleaseRecord(String label, String reason, long releasedAtMs) { - this.label = label == null ? "" : label; - this.reason = reason == null ? "" : reason; - this.releasedAtMs = releasedAtMs; - } - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/BleProtocol.java b/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/BleProtocol.java deleted file mode 100644 index 6031f24d..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/BleProtocol.java +++ /dev/null @@ -1,1240 +0,0 @@ -package com.faceclaw.app; - -import java.io.ByteArrayOutputStream; -import java.nio.charset.StandardCharsets; -import java.util.ArrayList; -import java.util.Arrays; -import java.util.List; -import java.util.UUID; - -/** - * BleProtocol: Functions for generating and parsing messages when speaking to - * the Even Realities G2. Does _not_ include code for actually sending anything; - * for that, see FaceclawBleCommunicator. - * - * Most message formats are protobufs. For schemas, check g2-kit-unofficial. - */ -public class BleProtocol { - public static final String WRITE_CHAR_UUID = "00002760-08c2-11e1-9073-0e8ac72e5401"; - public static final String NOTIFY_CHAR_UUID = "00002760-08c2-11e1-9073-0e8ac72e5402"; - // Firmware-data service (svc ...e1001): the OTA transfer channel, distinct - // from the EvenHub write/notify chars above (which the flasher reuses only - // for the keepalive heartbeat). - public static final String OTA_DATA_WRITE_UUID = "00002760-08c2-11e1-9073-0e8ac72e0001"; - public static final String OTA_DATA_NOTIFY_UUID = "00002760-08c2-11e1-9073-0e8ac72e0002"; - public static final String RENDER_NOTIFY_UUID = "00002760-08c2-11e1-9073-0e8ac72e6402"; - public static final String R1_PHONE_NOTIFY_CHAR_UUID = "bae80011-4f05-4503-8e65-3af1f7329d1f"; - public static final String R1_NOTIFY_CHAR_UUID = "bae80013-4f05-4503-8e65-3af1f7329d1f"; - - public static final int PRELUDE_ACK_SID = 0x01; - public static final int PRELUDE_ACK_MAGIC = 156; - /** - * DEVICE_SETTINGS security-auth channel. Firmware 2.2.9 enforces completing - * this exchange shortly after a GATT connection opens (a ~30 s deadline - * closes unauthenticated links) and gates query responses on it; the - * message itself exists back to the 2.2.4 era, so sending it is safe on all - * stock versions. See ../notes/ble-connections-2.2.9.md. - */ - public static final int SID_SECURITY_AUTH = 0x80; - public static final int FLAG_SECURITY_AUTH = 0x00; - private static final int SECURITY_AUTH_CMD = 4; - public static final int SID_APP_LAUNCH = 0x01; - public static final int SID_EVENHUB = 0xe0; - public static final int SID_UI_SETTING = 0x09; - public static final int SID_STATE_CHANGE = 0x0d; - public static final int SID_ONBOARDING = 0x10; - /** G2SettingPackage.commandId for device-initiated pushes (vs. 2 = app read). */ - public static final int SETTINGS_CMD_DEVICE_SEND_TO_APP = 3; - // Private Faceclaw/CFW wake-takeover protocol. Both payloads are unknown - // protobuf fields to stock implementations, so they are safely ignored. - public static final int FACECLAW_WAKE_CONTROL_FIELD = 101; - public static final int FACECLAW_WAKE_EVENT_FIELD = 102; - /** - * CFW mic_control: host writes an ['M','C',ver,op,...] record as settings - * field 103; each temple - * reports a 21-byte ['M','C',ver,...] status as field 104, both appended - * to settings read responses and as standalone commandId=3 pushes. - */ - public static final int FACECLAW_MIC_CONTROL_FIELD = 103; - public static final int FACECLAW_MIC_STATUS_FIELD = 104; - /** - * CFW als_sensor: ambient-light reports on settings-channel field 105, 24-byte ['A','L',ver,reason,...] records from - * the master temple (decoded in app/native/ambient-light.ts). - */ - public static final int FACECLAW_ALS_REPORT_FIELD = 105; - public static final int FACECLAW_WAKE_OP_ACQUIRE = 1; - public static final int FACECLAW_WAKE_OP_RELEASE = 2; - public static final int FACECLAW_WAKE_OP_CLAIM = 3; - public static final int FACECLAW_WAKE_OP_READY = 4; - public static final int FACECLAW_FB_OP_ACQUIRE = 5; - public static final int FACECLAW_FB_OP_RELEASE = 6; - public static final int FACECLAW_WEAR_OP_QUERY = 7; - public static final int CFW_IMAGE_MODE_CLEANUP = 11; - private static final int FACECLAW_WAKE_EVENT = 1; - // Field-102 deferred wake from the IMU head-up (Faceclaw firmware revision - // 3+); same nonce handshake as the double-tap wake event 1. - public static final int FACECLAW_WAKE_EVENT_HEAD_UP = 5; - // Field-102 idle-gesture events (Faceclaw firmware revision 2+): gestures the - // stock display thread drops while no app is on screen, forwarded while the - // wake lease is held. Their last two bytes are the raw touch source and 0. - public static final int FACECLAW_GESTURE_EVENT_TAP = 2; - public static final int FACECLAW_GESTURE_EVENT_LONG_PRESS = 3; - public static final int FACECLAW_GESTURE_EVENT_LONG_PRESS_RELEASE = 4; - // The display thread's raw touch sources, as the firmware reports them. - private static final int FACECLAW_RAW_SOURCE_LEFT_TEMPLE = 0; - private static final int FACECLAW_RAW_SOURCE_RIGHT_TEMPLE = 1; - private static final int FACECLAW_RAW_SOURCE_RING = 4; - private static final int FACECLAW_WAKE_PROTOCOL_VERSION = 1; - // UI_FOREGROUND_EVEN_AI_ID: the stock "Even AI" assistant app. It is a - // FOREGROUND app, whereas EvenHub (and therefore faceclaw) is the - // BACKGROUND app -- which is why an Even AI launch draws over us. - // Payload is g2.even_ai.EvenAIDataPackage (see - // g2-kit-unofficial/ble/gen/even_ai_pb.ts). - public static final int SID_EVEN_AI = 0x07; - public static final int SID_NAVIGATION = 0x08; - public static final int NAV_CMD_COMPASS_CHANGED = 15; - public static final int NAV_CMD_COMPASS_CALIBRATION_STARTED = 16; - public static final int NAV_CMD_COMPASS_CALIBRATION_COMPLETE = 17; - // eEvenAICommandId - public static final int EVEN_AI_CMD_CTRL = 1; - // eEvenAIStatus, carried in EvenAIDataPackage.ctrl.status (field 3, sub 1). - // WAKE_UP is the on-glasses "Hey Even" wakeword firing; ENTER is a manual - // entry (touch/double-tap), so the two are distinguishable. - public static final int EVEN_AI_STATUS_WAKE_UP = 1; - public static final int EVEN_AI_STATUS_ENTER = 2; - public static final int EVEN_AI_STATUS_EXIT = 3; - public static final int FLAG_REQUEST = 0x20; - public static final int FLAG_NOTIFY = 0x01; - public static final int FLAG_NOTIFY_ALT = 0x06; - public static final int CMD_AUDIO_CONTROL = 15; - // EvenHub_Cmd_List.APP_REQUEST_OPEN_IMU_PACKET; the accelerometer stream is - // gated behind this control message (ImuCtrl, field 22 of the main ctx). - public static final int CMD_OPEN_IMU = 19; - - public static final int EVENT_CLICK = 0; - public static final int EVENT_SCROLL_TOP = 1; - public static final int EVENT_SCROLL_BOTTOM = 2; - public static final int EVENT_DOUBLE_CLICK = 3; - public static final int EVENT_FOREGROUND_ENTER = 4; - public static final int EVENT_FOREGROUND_EXIT = 5; - public static final int EVENT_ABNORMAL_EXIT = 6; - public static final int EVENT_SYSTEM_EXIT = 7; - public static final int EVENT_IMU_DATA_REPORT = 8; - public static final int EVENT_RING_LONG_PRESS = 9; - public static final int EVENT_RING_LONG_PRESS_RELEASE = 10; - // CFW extension: G2 2.2.9 tap-then-hold gesture forwarded to the phone. - public static final int EVENT_SHORT_THEN_LONG_PRESS = 11; - // CFW extension (firmware revision 3+): the IMU head-up, forwarded as a - // sys-event while an EvenHub page is on screen (soft sleep). - public static final int EVENT_HEAD_UP = 12; - - public static final int EVENT_SOURCE_GLASSES_R = 1; - public static final int EVENT_SOURCE_RING = 2; - public static final int EVENT_SOURCE_GLASSES_L = 3; - - public static final UUID CCCD_UUID = UUID.fromString("00002902-0000-1000-8000-00805f9b34fb"); - - // App-launch message. Protobuf contents come from a capture (done in g2-kit-unofficial) - // so the actual meaning of most fields isn't known. The standard protobuf - // wire format still lets us identify field numbers, wire types, and lengths. - public static final byte[] PRELUDE_F5872_PAYLOAD = buildPreludeF5872Payload(); - public static final byte[] PRELUDE_F5872 = - framePb(PRELUDE_F5872_PAYLOAD, SID_APP_LAUNCH, FLAG_REQUEST, 0x92).getFirst(); - - private static byte[] buildPreludeF5872Payload() { - byte[] field4 = encodeMessageField(3, - encodeMessageField(2, - encodeMessageField(2, concat(CollectionUtils.listOf( - encodeVarintField(1, 0), - encodeVarintField(2, 0) - ))) - ) - ); - return concat(CollectionUtils.listOf( - encodeVarintField(1, 2), // known app-launch type/Cmd - encodeVarintField(2, PRELUDE_ACK_MAGIC), - encodeMessageField(4, field4) - )); - } - - public static List framePb(byte[] pb, int sid, int flag, int seq) { - int chunkSize = 232; - byte[] crc = crcBytesLe(pb); - int totalWithCrc = pb.length + 2; - int totalFrags = Math.max(1, (int) Math.ceil(totalWithCrc / (double) chunkSize)); - List frames = new ArrayList<>(totalFrags); - byte[] payload = Arrays.copyOf(pb, totalWithCrc); - payload[pb.length] = crc[0]; - payload[pb.length + 1] = crc[1]; - for (int i = 0; i < totalFrags; i++) { - int offset = i * chunkSize; - byte[] chunk = Arrays.copyOfRange(payload, offset, Math.min(offset + chunkSize, payload.length)); - byte[] frame = new byte[8 + chunk.length]; - frame[0] = (byte) 0xaa; - frame[1] = 0x21; - frame[2] = (byte) (seq & 0xff); - frame[3] = (byte) (chunk.length & 0xff); - frame[4] = (byte) (totalFrags & 0xff); - frame[5] = (byte) ((i + 1) & 0xff); - frame[6] = (byte) (sid & 0xff); - frame[7] = (byte) (flag & 0xff); - System.arraycopy(chunk, 0, frame, 8, chunk.length); - frames.add(frame); - } - return frames; - } - - - /** Retain the text container for forwarded inputs, without an image container. */ - public static byte[] buildCreateInputPage(int magic) { - List innerParts = new ArrayList<>(); - innerParts.add(encodeVarintField(1, 1)); - innerParts.add(encodeMessageField(3, encodeTextObject("dashboard", 1, 0, 0, 576, 288, " ", true))); - innerParts.add(encodeVarintField(5, 10000)); - byte[] inner = concat(innerParts); - return wrapEvenHub(0, magic, 3, inner); - } - - public static byte[] buildDashboardTextUpgrade(int magic) { - List inner = new ArrayList<>(); - inner.add(encodeVarintField(1, 1)); - inner.add(encodeStringField(2, "dashboard")); - inner.add(encodeVarintField(3, 0)); - inner.add(encodeVarintField(4, 1)); - inner.add(encodeStringField(5, " ")); - return wrapEvenHub(5, magic, 9, concat(inner)); - } - - public static byte[] buildImageRawData(ImageTileOptions tile, int sessionId, int totalSize, ImageFragment fragment, int magic) { - List inner = new ArrayList<>(); - inner.add(encodeVarintField(1, tile.containerId)); - inner.add(encodeStringField(2, tile.name)); - //inner.add(encodeVarintField(3, sessionId)); - inner.add(encodeVarintField(3, tile.containerId)); - inner.add(encodeVarintField(4, totalSize)); - // CompressMode stays 0: the CFW's zlib path is detected from the buffer's - // zlib header at BMP-load time, and frag_write must copy our deflated bytes - // VERBATIM (CompressMode!=0 would route them through the 1bpp expander). - inner.add(encodeVarintField(5, 0)); //compression - inner.add(encodeVarintField(6, fragment.index)); - inner.add(encodeVarintField(7, fragment.size)); - inner.add(encodeBytesField(8, fragment.data)); - return wrapEvenHub(3, magic, 5, concat(inner)); - } - - public static byte[] buildHeartbeat(int magic) { - return wrapEvenHub(12, magic, 14, encodeVarintField(1, 0)); - } - - /** - * Cmd=0 CreateStartUpPage carrying a text container (the message) plus a - * list container (the selectable rows) in one page. Uses stock-firmware-safe - * geometry (each container within the stock ~280x130 container-size cap; the - * CFW is what lifts that to 576x288), so this works before flashing. The - * selected row comes back as an async list event — see parseListSelection. - */ - public static byte[] buildCreatePromptPage( - int magic, - String textName, - int textContainerId, - String warningText, - String listName, - int listContainerId, - String[] items - ) { - List inner = new ArrayList<>(); - inner.add(encodeVarintField(1, 2)); // ContainerTotalNum: 1 text + 1 list - inner.add(encodeMessageField(2, encodeListObject(listName, listContainerId, 0, 150, 280, 120, items, true))); - inner.add(encodeMessageField(3, encodeTextObject(textName, textContainerId, 0, 0, 280, 130, warningText, false))); - inner.add(encodeVarintField(5, 10000)); // widgetId - return wrapEvenHub(0, magic, 3, concat(inner)); - } - - public static byte[] encodeListObject( - String name, - int containerId, - int x, - int y, - int width, - int height, - String[] items, - boolean captureEvents - ) { - List parts = new ArrayList<>(); - parts.add(encodeVarintField(1, x)); - parts.add(encodeVarintField(2, y)); - parts.add(encodeVarintField(3, width)); - parts.add(encodeVarintField(4, height)); - parts.add(encodeVarintField(9, containerId)); - parts.add(encodeStringField(10, name)); - parts.add(encodeMessageField(11, encodeListItemContainer(items))); - if (captureEvents) { - parts.add(encodeVarintField(12, 1)); - } - return concat(parts); - } - - private static byte[] encodeListItemContainer(String[] items) { - List parts = new ArrayList<>(); - parts.add(encodeVarintField(1, items.length)); // ItemCount - parts.add(encodeVarintField(3, 1)); // IsItemSelectBorderEn - for (String item : items) { - parts.add(encodeStringField(4, item)); // repeated ItemName - } - return concat(parts); - } - - /** - * Decode a list-selection async event (sid=0xe0, flag=0x01/0x06). Returns - * null if the frame is not a list event. `itemIndex` is 0-based into the - * ItemName array the list was built with; `eventType` is EVENT_CLICK for a - * confirmed selection (scroll/highlight changes arrive with other types). - */ - public static ListSelection parseListSelection(ParsedFrame frame) { - byte[] pb = stripTrailingCrc(frame.pb); - byte[] deviceEvent = readFieldBytes(pb, 13); - if (deviceEvent == null) { - return null; - } - byte[] listEvent = readFieldBytes(deviceEvent, 1); - if (listEvent == null) { - return null; - } - return new ListSelection( - readStringFieldValue(listEvent, 2), - readStringFieldValue(listEvent, 3), - readVarintFieldValue(listEvent, 4, -1), - readVarintFieldValue(listEvent, 5, EVENT_CLICK) - ); - } - - public static byte[] buildAudioControl(int magic, boolean enable) { - return wrapEvenHub(CMD_AUDIO_CONTROL, magic, 18, encodeVarintField(1, enable ? 1 : 0)); - } - - public static byte[] buildShutdown(int magic, int exitMode) { - return wrapEvenHub(9, magic, 11, encodeVarintField(1, exitMode)); - } - - /** - * IMU control (ImuCtrl = field 22 of the main ctx). IMU_CtrlCmd carries - * IMUReportEn (field 1) and reportFrq (field 2). reportFrq is only - * meaningful when enabling; on disable we send just the enable flag. - */ - public static byte[] buildImuControl(int magic, boolean enable, int reportFrq) { - List inner = new ArrayList<>(); - inner.add(encodeVarintField(1, enable ? 1 : 0)); - if (enable && reportFrq > 0) { - inner.add(encodeVarintField(2, reportFrq)); - } - return wrapEvenHub(CMD_OPEN_IMU, magic, 22, concat(inner)); - } - - /** - * Set the lens brightness: G2SettingPackage{commandId=1 (DeviceReceiveInfo), - * deviceReceiveInfoFromApp(3){deviceReceiveBrightness(1){autoAdjust(1), - * brightnessLevel(2)}}} on sid 0x09. brightnessLevel is 0-100 (nonlinear; - * 0 is dim-but-visible, not off). When autoAdjust is set the ambient-light - * sensor drives brightness, so the level field is omitted; otherwise the - * level is always encoded (explicit zero included) so brightnessLevel=0 - * reaches the wire. - */ - public static byte[] buildSetBrightness(int magic, boolean autoAdjust, int brightnessLevel) { - List brightness = new ArrayList<>(); - brightness.add(encodeVarintField(1, autoAdjust ? 1 : 0)); - if (!autoAdjust) { - brightness.add(encodeVarintField(2, brightnessLevel)); - } - return concat(CollectionUtils.listOf( - encodeVarintField(1, 1), - encodeVarintField(2, magic), - encodeMessageField(3, encodeMessageField(1, concat(brightness))) - )); - } - - /** Enable the firmware's wear detector (DeviceReceiveInfoFromAPP field 5). */ - public static byte[] buildSetWearDetection(int magic, boolean enabled) { - byte[] wear = encodeVarintField(1, enabled ? 1 : 0); - return concat(CollectionUtils.listOf( - encodeVarintField(1, 1), - encodeVarintField(2, magic), - encodeMessageField(3, encodeMessageField(5, wear)) - )); - } - - /** - * The application authentication request: DEVICE_SETTINGS/AUTHENTICATION(4) - * on sid 0x80, flag 0x00. Carries no key material — it arms the firmware's - * "security auth" flag; the firmware sends the success notification once - * the flag is set AND the BLE link is encrypted (SMP pairing/bond - * restoration, handled by the OS below GATT, possibly after a pairing - * prompt). Protobuf: f1=4 (command), f2=magic, f3={f1=1, f2=4}. - */ - public static byte[] buildAuthenticationRequest(int magic) { - byte[] auth = concat(CollectionUtils.listOf( - encodeVarintField(1, 1), - encodeVarintField(2, SECURITY_AUTH_CMD) - )); - return concat(CollectionUtils.listOf( - encodeVarintField(1, SECURITY_AUTH_CMD), - encodeVarintField(2, magic), - encodeMessageField(3, auth) - )); - } - - /** - * True when `pb` (trailing CRC still attached) is the success notification - * for the authentication request sent with `magic`: command 4, the same - * magic, and an EMPTY field-3 result message (`1a 00` — the omitted result - * code defaults to zero). A GATT write completing is NOT success; only this - * notification is. - */ - public static boolean isAuthenticationSuccess(byte[] pb, int magic) { - if (pb == null) { - return false; - } - byte[] root = stripTrailingCrc(pb); - if (readVarintFieldValue(root, 1, -1) != SECURITY_AUTH_CMD) { - return false; - } - if (readVarintFieldValue(root, 2, -1) != magic) { - return false; - } - byte[] result = readFieldBytes(root, 3); - return result != null && result.length == 0; - } - - public static byte[] buildSettingsQuery(int magic) { - byte[] request = encodeVarintField(1, 1); - return concat(CollectionUtils.listOf( - encodeVarintField(1, 2), - encodeVarintField(2, magic), - encodeMessageField(4, request) - )); - } - - /** - * Build the CFW-only wake lease control package. Magic zero deliberately - * makes this fire-and-forget: the firmware consumes field 101 before its - * stock nanopb decoder discards the unknown field. - */ - public static byte[] buildFaceclawWakeControl(int operation, int nonce) { - byte[] control = new byte[] { - 'F', - 'C', - (byte) FACECLAW_WAKE_PROTOCOL_VERSION, - (byte) operation, - (byte) (nonce & 0xff), - (byte) ((nonce >>> 8) & 0xff) - }; - return concat(CollectionUtils.listOf( - encodeVarintField(1, 1), - encodeVarintField(2, 0), - encodeBytesField(FACECLAW_WAKE_CONTROL_FIELD, control) - )); - } - - /** - * Wrap an already-encoded ['M','C',ver,op,...] mic-control record as a - * settings write carrying CFW field 103. Magic zero makes it - * fire-and-forget like the wake lease: the firmware consumes the field - * before its stock nanopb decoder discards the unknown tag, and the - * "ack" is the field-104 status notify that follows. - */ - public static byte[] buildFaceclawMicControl(byte[] record) { - return concat(CollectionUtils.listOf( - encodeVarintField(1, 1), - encodeVarintField(2, 0), - encodeBytesField(FACECLAW_MIC_CONTROL_FIELD, record) - )); - } - - /** - * Extract the CFW mic status record (field 104) from a settings frame, or - * null when absent. The 21-byte body layout is decoded on the TS side; - * here we only validate the 'M','C',version prelude. - */ - public static byte[] parseFaceclawMicStatus(byte[] pb) { - if (pb == null) { - return null; - } - byte[] body = readFieldBytes(stripTrailingCrc(pb), FACECLAW_MIC_STATUS_FIELD); - if (body == null - || body.length < 3 - || body[0] != 'M' - || body[1] != 'C') { - return null; - } - return body; - } - - /** - * Return the raw CFW ambient-light report from a sid-0x09 frame, or null - * when this is an ordinary settings frame. Only the 'A','L',version prelude - * is validated here; the fields are decoded on the TS side. - */ - public static byte[] parseFaceclawAlsReport(byte[] pb) { - if (pb == null) { - return null; - } - byte[] body = readFieldBytes(stripTrailingCrc(pb), FACECLAW_ALS_REPORT_FIELD); - if (body == null - || body.length < 24 - || body[0] != 'A' - || body[1] != 'L' - || (body[2] & 0xff) != 1) { - return null; - } - return body; - } - - /** Field 106: RB/version 1/flags/percentage, from the CFW ring-battery cache. */ - public static RingBatterySnapshot parseRingBattery(byte[] pb) { - if (pb == null) return null; - byte[] body = readFieldBytes(stripTrailingCrc(pb), 106); - if (body == null || body.length != 5 || body[0] != 'R' || body[1] != 'B' - || body[2] != 1) return null; - int flags = body[3] & 0xff; - int level = body[4] & 0xff; - if ((flags & ~7) != 0) return null; - if ((flags & 2) != 0) { - if ((flags & 1) == 0 || level > 100) return null; - return new RingBatterySnapshot(level, (flags & 4) != 0 ? 1 : 0); - } - if (level != 255 || (flags & 4) != 0) return null; - return new RingBatterySnapshot(-1, -1); - } - - public static final class RingBatterySnapshot { - final int battery; - final int charging; - RingBatterySnapshot(int battery, int charging) { - this.battery = battery; - this.charging = charging; - } - } - - /** - * Return the uint16 wake nonce from a CFW field-102 deferred-wake - * notification (double tap or head-up), or -1 when this is an ordinary - * settings frame (idle-gesture events included). - */ - public static int parseFaceclawWakeEvent(byte[] pb) { - byte[] event = faceclawWakeEventBytes(pb); - return event == null ? -1 : (event[4] & 0xff) | ((event[5] & 0xff) << 8); - } - - /** - * Which gesture a CFW deferred-wake notification reports: 1 (double tap) - * or FACECLAW_WAKE_EVENT_HEAD_UP; -1 when the frame is not a wake event. - */ - public static int parseFaceclawWakeEventCode(byte[] pb) { - byte[] event = faceclawWakeEventBytes(pb); - return event == null ? -1 : (event[3] & 0xff); - } - - private static byte[] faceclawWakeEventBytes(byte[] pb) { - if (pb == null) { - return null; - } - byte[] event = readFieldBytes(stripTrailingCrc(pb), FACECLAW_WAKE_EVENT_FIELD); - if (event == null - || event.length != 6 - || event[0] != 'F' - || event[1] != 'C' - || (event[2] & 0xff) != FACECLAW_WAKE_PROTOCOL_VERSION) { - return null; - } - int code = event[3] & 0xff; - return code == FACECLAW_WAKE_EVENT || code == FACECLAW_WAKE_EVENT_HEAD_UP ? event : null; - } - - /** An idle gesture from a CFW field-102 notification, in EvenHub sys-event terms. */ - public static final class FaceclawGestureEvent { - public final int eventType; - public final int eventSource; - - FaceclawGestureEvent(int eventType, int eventSource) { - this.eventType = eventType; - this.eventSource = eventSource; - } - } - - /** - * Decode a CFW field-102 idle-gesture event (tap, long press, release - * while no app is on screen) into the EvenHub sys-event type and source - * the same gesture would carry from a live page, or null when the frame - * is not one (ordinary settings frames and the double-tap wake event - * included). - */ - public static FaceclawGestureEvent parseFaceclawGestureEvent(byte[] pb) { - if (pb == null) { - return null; - } - byte[] event = readFieldBytes(stripTrailingCrc(pb), FACECLAW_WAKE_EVENT_FIELD); - if (event == null - || event.length != 6 - || event[0] != 'F' - || event[1] != 'C' - || (event[2] & 0xff) != FACECLAW_WAKE_PROTOCOL_VERSION) { - return null; - } - int eventType; - switch (event[3] & 0xff) { - case FACECLAW_GESTURE_EVENT_TAP: - eventType = EVENT_CLICK; - break; - case FACECLAW_GESTURE_EVENT_LONG_PRESS: - eventType = EVENT_RING_LONG_PRESS; - break; - case FACECLAW_GESTURE_EVENT_LONG_PRESS_RELEASE: - eventType = EVENT_RING_LONG_PRESS_RELEASE; - break; - default: - return null; - } - int eventSource; - switch (event[4] & 0xff) { - case FACECLAW_RAW_SOURCE_LEFT_TEMPLE: - eventSource = EVENT_SOURCE_GLASSES_L; - break; - case FACECLAW_RAW_SOURCE_RIGHT_TEMPLE: - eventSource = EVENT_SOURCE_GLASSES_R; - break; - case FACECLAW_RAW_SOURCE_RING: - eventSource = EVENT_SOURCE_RING; - break; - default: - eventSource = 0; - break; - } - return new FaceclawGestureEvent(eventType, eventSource); - } - - /** - * Decode OnboardingDataPackage EVENT/GLS_WEAR_STATUS. Unlike most async - * G2 traffic, stock firmware sends this event with flag 0x00, so callers - * must recognize it by sid and protobuf shape rather than notify flag. - * Returns 0/1, or -1 when the frame is not a wear event. - */ - public static int parseWearState(ParsedFrame frame) { - if (frame == null || !frame.ok || frame.sid != SID_ONBOARDING) { - return -1; - } - byte[] root = stripTrailingCrc(frame.pb); - if (readVarintFieldValue(root, 1, -1) != 3) { - return -1; - } - byte[] event = readFieldBytes(root, 5); - if (event == null || readVarintFieldValue(event, 1, -1) != 1) { - return -1; - } - int wearStatus = readVarintFieldValue(event, 2, -1); - return wearStatus == 0 || wearStatus == 1 ? wearStatus : -1; - } - - public static BatterySnapshot parseSettingsBattery(byte[] pb) { - byte[] root = stripTrailingCrc(pb); - byte[] request = readFieldBytes(root, 4); - if (request == null) { - return null; - } - int battery = readVarintFieldValue(request, 12, -1); - int charging = readVarintFieldValue(request, 13, -1); - int silentMode = readVarintFieldValue(request, 14, -1); - if (battery < 0) { - return null; - } - return new BatterySnapshot(battery, charging, silentMode); - } - - /** - * Silent mode from an unsolicited settings push. The wearer toggles silent - * mode by long-pressing both touchpads at once; the firmware then sends - * G2SettingPackage{commandId=3 (DeviceSendToAPP), deviceSendInfoToApp(5){ - * silentModeSwitch(2)}} on sid 0x09, with a magic it picked itself, so this - * arrives outside the request/ack flow. - * - * Returns -1 when the frame is not such a push. Ordinary settings-read acks - * (the battery poll) carry commandId=2 and deviceReceiveRequestFromApp in - * field 4, so they never match and stay on the normal ack path. - */ - public static int parseSilentModePush(byte[] pb) { - if (pb == null) { - return -1; - } - byte[] root = stripTrailingCrc(pb); - if (readVarintFieldValue(root, 1, -1) != SETTINGS_CMD_DEVICE_SEND_TO_APP) { - return -1; - } - byte[] info = readFieldBytes(root, 5); - if (info == null) { - return -1; - } - return readVarintFieldValue(info, 2, -1); - } - - /** - * Firmware versions and the firmware-extension string from a settings - * READ ack. Versions are fields 5/6 of the deviceReceiveRequestFromApp - * submessage (field 4); Faceclaw's custom firmware additionally appends - * top-level field 100 with its revision ("Faceclaw/"; older builds sent - * "EVENCFW/ "), which stock firmware never sends. Returns null - * when the ack carries none of it. Compatibility is judged on the TS side - * (app/g2/firmware-compat.ts); Java only needs to know whether the firmware - * is ours at all. - */ - public static FirmwareInfo parseSettingsFirmwareInfo(byte[] pb) { - byte[] root = stripTrailingCrc(pb); - byte[] request = readFieldBytes(root, 4); - if (request == null) { - return null; - } - String leftVersion = readStringFieldValue(request, 5); - String rightVersion = readStringFieldValue(request, 6); - String extension = readStringFieldValue(root, 100); - if (leftVersion.isEmpty() && rightVersion.isEmpty() && extension.isEmpty()) { - return null; - } - return new FirmwareInfo(leftVersion, rightVersion, extension); - } - - public static byte[] wrapEvenHub(int cmd, int magic, int innerFieldNumber, byte[] inner) { - List parts = new ArrayList<>(); - parts.add(encodeVarintField(1, cmd)); - parts.add(encodeVarintField(2, magic)); - parts.add(encodeMessageField(innerFieldNumber, inner)); - return concat(parts); - } - - public static byte[] encodeTextObject(String name, int containerId, int x, int y, int width, int height, String text, boolean captureEvents) { - List parts = new ArrayList<>(); - parts.add(encodeVarintField(1, x)); - parts.add(encodeVarintField(2, y)); - parts.add(encodeVarintField(3, width)); - parts.add(encodeVarintField(4, height)); - parts.add(encodeVarintField(9, containerId)); - parts.add(encodeStringField(10, name)); - if (captureEvents) { - parts.add(encodeVarintField(11, 1)); - } - parts.add(encodeStringField(12, text)); - return concat(parts); - } - - public static byte[] encodeImageObject(ImageTileOptions tile) { - List parts = new ArrayList<>(); - parts.add(encodeVarintField(1, tile.x)); - parts.add(encodeVarintField(2, tile.y)); - parts.add(encodeVarintField(3, tile.width)); - parts.add(encodeVarintField(4, tile.height)); - parts.add(encodeVarintField(5, tile.containerId)); - parts.add(encodeStringField(6, tile.name)); - return concat(parts); - } - - private static byte[] concat(List parts) { - ByteArrayOutputStream out = new ByteArrayOutputStream(); - for (byte[] part : parts) { - if (part != null && part.length > 0) { - out.write(part, 0, part.length); - } - } - return out.toByteArray(); - } - - private static byte[] encodeVarintField(int fieldNumber, int value) { - return concat(CollectionUtils.listOf(encodeKey(fieldNumber, 0), encodeVarint(value))); - } - - private static byte[] encodeStringField(int fieldNumber, String value) { - byte[] bytes = value == null ? new byte[0] : value.getBytes(StandardCharsets.UTF_8); - return concat(CollectionUtils.listOf(encodeKey(fieldNumber, 2), encodeVarint(bytes.length), bytes)); - } - - private static byte[] encodeBytesField(int fieldNumber, byte[] value) { - byte[] bytes = value == null ? new byte[0] : value; - return concat(CollectionUtils.listOf(encodeKey(fieldNumber, 2), encodeVarint(bytes.length), bytes)); - } - - private static byte[] encodeMessageField(int fieldNumber, byte[] value) { - byte[] bytes = value == null ? new byte[0] : value; - return concat(CollectionUtils.listOf(encodeKey(fieldNumber, 2), encodeVarint(bytes.length), bytes)); - } - - private static byte[] encodeKey(int fieldNumber, int wireType) { - return encodeVarint((fieldNumber << 3) | wireType); - } - - private static byte[] encodeVarint(int value) { - ByteArrayOutputStream out = new ByteArrayOutputStream(); - int v = value >>> 0; - while (v >= 0x80) { - out.write((v & 0x7f) | 0x80); - v >>>= 7; - } - out.write(v); - return out.toByteArray(); - } - - private static byte[] crcBytesLe(byte[] data) { - int crc = 0xffff; - for (byte b : data) { - crc ^= (b & 0xff) << 8; - for (int i = 0; i < 8; i++) { - if ((crc & 0x8000) != 0) { - crc = ((crc << 1) ^ 0x1021) & 0xffff; - } else { - crc = (crc << 1) & 0xffff; - } - } - } - return new byte[] {(byte) (crc & 0xff), (byte) ((crc >>> 8) & 0xff)}; - } - - - /** - * Split one notification value into individual `aa21`/`aa12` envelope - * frames. A value normally holds exactly one frame, but the firmware can - * pack several (each self-describing via the length byte at offset 3), and - * a frame that only reads the first would silently drop the rest. A value - * that does not start with an envelope, or a trailing partial frame - * (truncated by the stack — observed on a Samsung tablet for values over - * 64 bytes), is returned as-is so the caller can log it. - */ - public static List splitFrames(byte[] value) { - List out = new ArrayList<>(); - if (value == null || value.length == 0) { - return out; - } - int offset = 0; - while (offset + 8 <= value.length - && value[offset] == (byte) 0xaa - && (value[offset + 1] == 0x21 || value[offset + 1] == 0x12)) { - int len = value[offset + 3] & 0xff; - int end = Math.min(value.length, offset + 8 + len); - out.add(Arrays.copyOfRange(value, offset, end)); - offset = end; - } - if (offset < value.length) { - out.add(Arrays.copyOfRange(value, offset, value.length)); - } - return out; - } - - public static ParsedFrame parseFrame(byte[] buf) { - if (buf == null || buf.length < 10 || buf[0] != (byte) 0xaa || (buf[1] != 0x21 && buf[1] != 0x12)) { - return new ParsedFrame(false, 0, 0, new byte[0], -1, -1); - } - int sid = buf[6] & 0xff; - int flag = buf[7] & 0xff; - int len = buf[3] & 0xff; - int end = Math.min(buf.length, 8 + len); - byte[] pb = Arrays.copyOfRange(buf, 8, end); - - int msgType = -1; - int msgSeq = -1; - int offset = 0; - for (int i = 0; i < 8 && offset < pb.length; i++) { - VarintResult key = readVarint(pb, offset); - if (key == null) { - break; - } - offset = key.next; - int tag = key.value >> 3; - int wire = key.value & 7; - if (wire == 0) { - VarintResult value = readVarint(pb, offset); - if (value == null) { - break; - } - if (tag == 1) { - msgType = value.value; - } else if (tag == 2) { - msgSeq = value.value; - } - offset = value.next; - } else if (wire == 2) { - VarintResult length = readVarint(pb, offset); - if (length == null) { - break; - } - offset = length.next + length.value; - } else { - break; - } - if (msgType >= 0 && msgSeq >= 0) { - break; - } - } - return new ParsedFrame(true, sid, flag, pb, msgType, msgSeq); - } - - public static byte[] stripTrailingCrc(byte[] pb) { - if (pb == null || pb.length < 2) { - return pb == null ? new byte[0] : pb; - } - return Arrays.copyOf(pb, pb.length - 2); - } - - /** Decode the stock firmware's compass navigation notifications (sid 0x08). */ - public static CompassEvent parseCompassEvent(ParsedFrame frame) { - if (frame == null - || !frame.ok - || frame.sid != SID_NAVIGATION - || (frame.flag != FLAG_NOTIFY && frame.flag != FLAG_NOTIFY_ALT)) { - return null; - } - byte[] root = stripTrailingCrc(frame.pb); - int command = readVarintFieldValue(root, 1, -1); - if (command == NAV_CMD_COMPASS_CHANGED) { - byte[] compass = readFieldBytes(root, 10); - if (compass == null) return null; - int heading = readVarintFieldValue(compass, 1, -1); - if (heading < 0 || heading >= 360) return null; - byte[] diagnostic = readFieldBytes(root, 100); - if (diagnostic != null && diagnostic.length == 12 - && diagnostic[0] == 'C' && diagnostic[1] == 'M' && diagnostic[2] == 1 - && diagnostic[7] == 0 - && ((diagnostic[3] & 0xff) <= 3 || diagnostic[3] == (byte) 255) - && ((diagnostic[4] & 0xff) <= 2 || diagnostic[4] == (byte) 255) - && (diagnostic[5] & 0xff) <= 3) { - long sampleTimeMs = 0; - for (int i = 0; i < 4; i++) sampleTimeMs |= (long) (diagnostic[8 + i] & 0xff) << (8 * i); - return new CompassEvent(command, heading, - diagnostic[3] == (byte) 255 ? -1 : diagnostic[3] & 0xff, - diagnostic[4] == (byte) 255 ? -1 : diagnostic[4] & 0xff, - diagnostic[5] & 0xff, diagnostic[6] & 0xff, sampleTimeMs); - } - // Stock/older CFW and unknown extensions still supply usable headings. - return new CompassEvent(command, heading); - } - if (command == NAV_CMD_COMPASS_CALIBRATION_STARTED - || command == NAV_CMD_COMPASS_CALIBRATION_COMPLETE) { - return new CompassEvent(command, -1); - } - return null; - } - - /** - * Display wake notification observed after a ring or right-arm double tap - * while no EvenHub page is running: - * - * sid=0x0d, flag=notify, payload f1=1, f3={f1=1} - * - * Other state-change shapes (wear, charging, head-up, etc.) are deliberately - * excluded. The caller additionally gates this on an intentional EvenHub - * suspension, so normal state traffic cannot become application input. - */ - public static boolean isDisplayWakeStateChange(ParsedFrame frame) { - if (frame == null - || !frame.ok - || frame.sid != SID_STATE_CHANGE - || (frame.flag != FLAG_NOTIFY && frame.flag != FLAG_NOTIFY_ALT)) { - return false; - } - byte[] root = stripTrailingCrc(frame.pb); - if (readVarintFieldValue(root, 1, -1) != 1) { - return false; - } - byte[] state = readFieldBytes(root, 3); - return state != null - && state.length == 2 - && readVarintFieldValue(state, 1, -1) == 1; - } - - public static byte[] readFieldBytes(byte[] pb, int fieldNumber) { - int offset = 0; - while (offset < pb.length) { - VarintResult key = readVarint(pb, offset); - if (key == null) { - return null; - } - offset = key.next; - int field = key.value >> 3; - int wire = key.value & 0x07; - if (wire == 0) { - VarintResult value = readVarint(pb, offset); - if (value == null) { - return null; - } - offset = value.next; - continue; - } - if (wire == 1) { - offset += 8; - continue; - } - if (wire == 5) { - offset += 4; - continue; - } - if (wire != 2) { - return null; - } - VarintResult length = readVarint(pb, offset); - if (length == null) { - return null; - } - offset = length.next; - int end = offset + length.value; - if (end > pb.length) { - return null; - } - byte[] bytes = Arrays.copyOfRange(pb, offset, end); - offset = end; - if (field == fieldNumber) { - return bytes; - } - } - return null; - } - - public static int readVarintFieldValue(byte[] pb, int fieldNumber, int defaultValue) { - int offset = 0; - while (offset < pb.length) { - VarintResult key = readVarint(pb, offset); - if (key == null) { - return defaultValue; - } - offset = key.next; - int field = key.value >> 3; - int wire = key.value & 0x07; - if (wire == 0) { - VarintResult value = readVarint(pb, offset); - if (value == null) { - return defaultValue; - } - offset = value.next; - if (field == fieldNumber) { - return value.value; - } - continue; - } - if (wire == 1) { - offset += 8; - continue; - } - if (wire == 5) { - offset += 4; - continue; - } - if (wire != 2) { - return defaultValue; - } - VarintResult length = readVarint(pb, offset); - if (length == null) { - return defaultValue; - } - offset = length.next + length.value; - } - return defaultValue; - } - - /** - * Read a `float` (protobuf wire type 5, little-endian fixed32) field. The - * g2-kit proto declares IMU_Report_Data's x/y/z as `double`, but the - * firmware actually sends them as fixed32 floats (confirmed from captures). - * Returns defaultValue if absent. - */ - public static float readFloatFieldValue(byte[] pb, int fieldNumber, float defaultValue) { - int offset = 0; - while (offset < pb.length) { - VarintResult key = readVarint(pb, offset); - if (key == null) { - return defaultValue; - } - offset = key.next; - int field = key.value >> 3; - int wire = key.value & 0x07; - if (wire == 0) { - VarintResult value = readVarint(pb, offset); - if (value == null) { - return defaultValue; - } - offset = value.next; - } else if (wire == 1) { - offset += 8; - } else if (wire == 5) { - if (offset + 4 > pb.length) { - return defaultValue; - } - if (field == fieldNumber) { - int bits = 0; - for (int i = 0; i < 4; i++) { - bits |= (pb[offset + i] & 0xff) << (8 * i); - } - return Float.intBitsToFloat(bits); - } - offset += 4; - } else if (wire == 2) { - VarintResult length = readVarint(pb, offset); - if (length == null) { - return defaultValue; - } - offset = length.next + length.value; - } else { - return defaultValue; - } - } - return defaultValue; - } - - public static String readStringFieldValue(byte[] pb, int fieldNumber) { - byte[] bytes = readFieldBytes(pb, fieldNumber); - if (bytes == null) { - return ""; - } - return new String(bytes, StandardCharsets.UTF_8); - } - - public static VarintResult readVarint(byte[] pb, int offset) { - int value = 0; - int shift = 0; - int cursor = offset; - while (cursor < pb.length) { - int b = pb[cursor++] & 0xff; - value |= (b & 0x7f) << shift; - if ((b & 0x80) == 0) { - return new VarintResult(value, cursor); - } - shift += 7; - } - return null; - } - - - public static final class ParsedFrame { - final boolean ok; - final int sid; - final int flag; - final byte[] pb; - final int msgType; - final int msgSeq; - - ParsedFrame(boolean ok, int sid, int flag, byte[] pb, int msgType, int msgSeq) { - this.ok = ok; - this.sid = sid; - this.flag = flag; - this.pb = pb; - this.msgType = msgType; - this.msgSeq = msgSeq; - } - } - - private static final class VarintResult { - final int value; - final int next; - - VarintResult(int value, int next) { - this.value = value; - this.next = next; - } - } - - public static final class ListSelection { - public final String containerName; - public final String itemName; - public final int itemIndex; - public final int eventType; - - ListSelection(String containerName, String itemName, int itemIndex, int eventType) { - this.containerName = containerName == null ? "" : containerName; - this.itemName = itemName == null ? "" : itemName; - this.itemIndex = itemIndex; - this.eventType = eventType; - } - } - - public static final class CompassEvent { - public final int command; - public final int headingDegrees; - /** -1 means unavailable; source: 0 unknown, 1 GRV, 2 GMRV, 3 RV. */ - public final int magneticAccuracy, magneticAnomalies, orientationSource, diagnosticFlags; - public final long sampleTimeMs; - - CompassEvent(int command, int headingDegrees) { - this(command, headingDegrees, -1, -1, -1, -1, -1); - } - - CompassEvent(int command, int headingDegrees, int magneticAccuracy, int magneticAnomalies, - int orientationSource, int diagnosticFlags, long sampleTimeMs) { - this.command = command; - this.headingDegrees = headingDegrees; - this.magneticAccuracy = magneticAccuracy; - this.magneticAnomalies = magneticAnomalies; - this.orientationSource = orientationSource; - this.diagnosticFlags = diagnosticFlags; - this.sampleTimeMs = sampleTimeMs; - } - } - - public static final class ImageTileOptions { - final String name; - final int containerId; - final int x; - final int y; - final int width; - final int height; - - ImageTileOptions(String name, int containerId, int x, int y, int width, int height) { - this.name = name; - this.containerId = containerId; - this.x = x; - this.y = y; - this.width = width; - this.height = height; - } - } - - public static final class ImageFragment { - final int index; - final byte[] data; - final int size; - - ImageFragment(int index, byte[] data, int size) { - this.index = index; - this.data = data; - this.size = size; - } - } - - public static final class BatterySnapshot { - final int battery; - final int charging; - /** 1 = silent mode on, 0 = off, -1 = the ack didn't carry the field. */ - final int silentMode; - - BatterySnapshot(int battery, int charging, int silentMode) { - this.battery = battery; - this.charging = charging; - this.silentMode = silentMode; - } - } - - public static final class FirmwareInfo { - /** Prefix of the firmware-extension string on Faceclaw's custom firmware. */ - public static final String FACECLAW_EXTENSION_PREFIX = "Faceclaw/"; - - final String leftVersion; - final String rightVersion; - /** Raw field-100 string ("" on stock firmware). */ - final String extension; - - FirmwareInfo(String leftVersion, String rightVersion, String extension) { - this.leftVersion = leftVersion; - this.rightVersion = rightVersion; - this.extension = extension == null ? "" : extension; - } - - /** - * True when the glasses run Faceclaw's custom firmware (any revision). - * Whether the revision is the one this app needs is decided on the TS - * side, which disconnects on a mismatch; this only guards the private - * modes against stock or third-party firmware in the meantime. - */ - public boolean isFaceclawFirmware() { - return extension.trim().startsWith(FACECLAW_EXTENSION_PREFIX); - } - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/CfwMessageWindow.java b/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/CfwMessageWindow.java deleted file mode 100644 index c342b066..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/CfwMessageWindow.java +++ /dev/null @@ -1,38 +0,0 @@ -package com.faceclaw.app; - -import java.util.ArrayList; -import java.util.List; - -/** Ordered completion and go-back-N recovery for the custom-message window. */ -final class CfwMessageWindow { - // Flappy capture: p99 ACK 63ms, max 77ms. Leave room for full-frame - // processing while recovering a lost reply well before the stock timeout. - static final int ACK_TIMEOUT_MS = 500; - static final int MAX_RETRIES = 3; - - private CfwMessageWindow() {} - - static OutboundMessage acknowledgedHead(Iterable messages) { - for (OutboundMessage message : messages) { - if (message.sid != CfwTransport.SID) continue; - return !message.cfwRetryPending && message.cfwAckLenses == CfwTransport.BOTH ? message : null; - } - return null; - } - - static List replayWindow(Iterable messages, long nowMs) { - List replay = new ArrayList<>(); - boolean failed = false; - for (OutboundMessage message : messages) { - if (message.sid != CfwTransport.SID) continue; - failed |= message.cfwRetryPending || (message.cfwAckLenses != CfwTransport.BOTH - && message.ackDeadlineAtMs > 0 && message.ackDeadlineAtMs <= nowMs); - replay.add(message); - } - // A lost ACK, first fragment, or NACK can leave an older attempt - // unresolved. Replaying only the named failure strands that older - // attempt at the head until its timeout. Rewind the unresolved window. - if (!failed) replay.clear(); - return replay; - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/CfwTransport.java b/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/CfwTransport.java deleted file mode 100644 index e921b3fb..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/CfwTransport.java +++ /dev/null @@ -1,141 +0,0 @@ -package com.faceclaw.app; - -import java.io.ByteArrayOutputStream; -import java.util.zip.Deflater; -import java.util.ArrayList; -import java.util.List; - -/** Faceclaw/10 records: clear flags, wire length and decoded CRC; persistent zlib body. */ -public final class CfwTransport { - public static final int SID = 0xf0; - public static final int BOTH = 3; - public static final int MAX_MESSAGE = 65535; - public static final int COMPRESSED = 4, RESET_CONTEXT = 8; - private final Deflater deflater = new Deflater(); - private boolean resetPending = true; - private int previousLenses; - - public CfwTransport() {} - - public synchronized void reset() { - deflater.reset(); - resetPending = true; - previousLenses = 0; - } - - /** Compress only when writing, in exactly the order seen by the receiver. */ - public synchronized List encode(byte[] message, int streamId, int lenses, int mtu) { - validate(message, streamId, lenses, mtu); - if (previousLenses != lenses) reset(); - boolean reset = resetPending; - deflater.setInput(message); - ByteArrayOutputStream out = new ByteArrayOutputStream(); - byte[] chunk = new byte[4096]; - int count; - do { - count = deflater.deflate(chunk, 0, chunk.length, Deflater.SYNC_FLUSH); - out.write(chunk, 0, count); - } while (count == chunk.length); - byte[] body = out.toByteArray(); - int flags = lenses | COMPRESSED | (reset ? RESET_CONTEXT : 0); - if (body.length == 0) flags &= ~COMPRESSED; // repeated empty sync flush - if (body.length > MAX_MESSAGE) { - // Incompressible maximum-size records still fit as raw records. - // The attempted deflate advanced history: reset both ends before reuse. - reset(); - body = message; - flags = lenses | RESET_CONTEXT; - } else { - resetPending = false; - previousLenses = lenses; - } - return frameRecord(body, crc(message), streamId, flags, mtu); - } - - private static void validate(byte[] message, int streamId, int lenses, int mtu) { - if (message == null || message.length > MAX_MESSAGE || streamId < 0 || streamId > 255 - || lenses < 1 || lenses > BOTH || mtu < 23 || mtu > 517) - throw new IllegalArgumentException("invalid CFW stream parameters"); - } - - /** One logical command per stream for now. Packets are bounded by actual ATT MTU. */ - public static List frame(byte[] message, int streamId, int lenses, int mtu) { - validate(message, streamId, lenses, mtu); - return frameRecord(message, crc(message), streamId, lenses | RESET_CONTEXT, mtu); - } - - private static List frameRecord(byte[] body, int checksum, int streamId, int flags, int mtu) { - int lenses = flags & BOTH; - int capacity = Math.min(252, mtu - 14); - byte[] stream = new byte[body.length + 5]; - stream[0] = (byte) flags; - stream[1] = (byte) body.length; - stream[2] = (byte) (body.length >>> 8); - stream[3] = (byte) checksum; - stream[4] = (byte) (checksum >>> 8); - System.arraycopy(body, 0, stream, 5, body.length); - List packets = new ArrayList<>(); - for (int offset = 0, index = 0; offset < stream.length; offset += capacity, index++) { - int count = Math.min(capacity, stream.length - offset); - byte[] packet = new byte[count + 11]; - packet[0] = (byte) 0xaa; - packet[1] = 0x21; - packet[2] = (byte) (streamId + index); - packet[3] = (byte) (count + 3); - packet[4] = packet[5] = 1; - packet[6] = (byte) SID; - packet[8] = (byte) (lenses | (offset == 0 ? 0x80 : 0) - | (offset + count == stream.length ? 0x40 : 0)); - System.arraycopy(stream, offset, packet, 9, count); - int crc = crc(packet, 8, count + 1); - packet[packet.length - 2] = (byte) crc; - packet[packet.length - 1] = (byte) (crc >>> 8); - packets.add(packet); - } - return packets; - } - - public static int crc(byte[] data) { return crc(data, 0, data.length); } - private static int crc(byte[] data, int offset, int count) { - int crc = 0xffff; - for (int i = offset; i < offset + count; i++) { - crc ^= (data[i] & 255) << 8; - for (int bit = 0; bit < 8; bit++) - crc = ((crc << 1) ^ ((crc & 0x8000) != 0 ? 0x1021 : 0)) & 65535; - } - return crc; - } - private static int u16(byte[] data, int offset) { - return (data[offset] & 255) | ((data[offset + 1] & 255) << 8); - } - public static Ack parseAck(byte[] packet) { - Ack[] acks = parseAcks(packet); - return acks == null ? null : acks[0]; - } - /** Primary ACK followed by up to three explicit preceding successes from - * the same processing lens. Validate the entire packet before applying any. */ - public static Ack[] parseAcks(byte[] packet) { - if (packet == null || packet.length < 19 || packet.length > 40 - || (packet.length - 19) % 7 != 0 || (packet[0] & 255) != 0xaa - || packet[1] != 0x12 || (packet[3] & 255) != packet.length - 8 || packet[4] != 1 || packet[5] != 1 - || (packet[6] & 255) != SID || packet[7] != 0 || (packet[8] != 1 && packet[8] != 3) - || (packet[12] != 1 && packet[12] != 2) - || (packet[8] == 3 && packet.length != 19) - || crc(packet, 8, packet.length - 10) != u16(packet, packet.length - 2)) return null; - Ack[] acks = new Ack[1 + (packet.length - 19) / 7]; - acks[0] = new Ack(packet[8] == 3, packet[9] & 255, u16(packet, 10), packet[12], u16(packet, 13), u16(packet, 15)); - for (int i = 1, offset = 17; i < acks.length; i++, offset += 7) - acks[i] = new Ack(false, packet[offset] & 255, u16(packet, offset + 1), - packet[12], u16(packet, offset + 3), u16(packet, offset + 5)); - return acks; - } - public static final class Ack { - public final boolean nack; - public final int streamId, messageId, lens, size, checksum; - Ack(boolean nack, int streamId, int messageId, int lens, int size, int checksum) { - this.nack = nack; - this.streamId = streamId; this.messageId = messageId; this.lens = lens; - this.size = size; this.checksum = checksum; - } - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/ConnectionOptions.java b/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/ConnectionOptions.java deleted file mode 100644 index a358dba9..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/ConnectionOptions.java +++ /dev/null @@ -1,75 +0,0 @@ -package com.faceclaw.app; -import android.bluetooth.BluetoothGattCharacteristic; - -public class ConnectionOptions { - public static final int WRITE_TYPE = BluetoothGattCharacteristic.WRITE_TYPE_NO_RESPONSE; - public static final int DESIRED_MTU = 512; - - public static final int CONNECT_TIMEOUT_MS = 5_000; - public static final int SERVICES_TIMEOUT_MS = 5_000; - public static final int DESCRIPTOR_TIMEOUT_MS = 5_000; - public static final int RING_DESIRED_MTU = 247; - public static final int RING_RECONNECT_DELAY_MS = 2_000; - public static final int WRITE_TIMEOUT_MS = 2_000; - public static final int PRELUDE_TIMEOUT_MS = 2_000; - // Application security-auth exchange (sid 0x80). The success notification - // only arrives once the BLE link is encrypted, which on a first-time - // connection means SMP pairing — possibly with an OS dialog the user has - // to accept — so the stock-firmware paths wait generously. - public static final int SECURITY_AUTH_TIMEOUT_MS = 30_000; - // The main communicator's wait is soft (it proceeds on timeout so firmware - // that never answers can't stall every reconnect), so it is kept short. - public static final int SECURITY_AUTH_SOFT_TIMEOUT_MS = 6_000; - public static final int ACK_TIMEOUT_MS = 3_500; - public static final int HEARTBEAT_FAILURE_DEADLINE_MS = 10_000; - public static final int HEARTBEAT_READY_MS = 4_000; - public static final int HEARTBEAT_URGENT_MS = 6_000; - public static final int BATTERY_REFRESH_INTERVAL_MS = 5 * 60_000; - public static final int BATTERY_INPUT_QUIET_MS = 5_000; - // Poll cadence while in charging mode; also bounds how quickly we notice - // the glasses coming back out of the case. - public static final int CHARGING_BATTERY_POLL_MS = 30_000; - public static final int IMAGE_FRAGMENT_SIZE = 3800; - public static final int IMAGE_RETRY_DELAY_MS = 2_000; - public static final int MAX_CONSECUTIVE_ACK_TIMEOUTS = 8; - public static final int EVEN_APP_WRITE_FAILURE_WINDOW_MS = 15_000; - public static final int IDLE_SLEEP_MS = 100; - public static final int RECONNECT_DELAY_MS = 2_000; - - final boolean sendImagesToLeft = true; - final boolean skipSessionIds = true; - // Max messages in flight (awaiting ack) at once — full pipelining. >1 lets a - // frame be sent before the previous frame's ack returns, hiding the BLE ack - // round-trip that otherwise serialized every update. Requires firmware that - // accepts pipelined image messages (the CFW snapshot/deferred FIFO). At 1 the - // communicator behaves exactly as before (serial sends + last-packet prewrite). - final int WINDOW_SIZE = 3; - // Send changed-region (mode 3 bounding box) updates instead of full frames - // when the previous frame is known to be displayed. Requires firmware with - // the experimental bbox-incremental mode. Disabled: the firmware-side - // display buffer is not always the previous frame (occasionally two frames - // back, apparently display-driver buffer swapping), so partial updates - // composite onto stale content per-lens. Re-enable once the firmware - // guarantees the compositing base. - final boolean INCREMENTAL_FRAMES = true; - - // Send several tight rectangle deltas as one CFW mode-8 multi-segment message - // instead of a single bounding box, when the change splits into regions whose - // bounding box wastes bytes (distant edits, or a sparse box). Requires firmware - // with mode-8 multi-rect support; needs INCREMENTAL_FRAMES (same seeded shadow). - // Falls back to the single bounding box whenever multi-rect isn't smaller. - final boolean MULTI_RECT_FRAMES = true; - // Cap on rects per batch. Each rect consumes a distinct CFW frame id, and the - // firmware's duplicate-fid ring holds 16, so keep several batches of history - // within it. Above this the split is abandoned for a single bounding box. - public static final int MULTI_RECT_MAX_RECTS = 6; - // Don't bother splitting when the single bounding box already compresses this - // small (one tight rect); only attempt multi-rect above it or when the box - // spans multiple horizontal clusters. - public static final int MULTI_RECT_MIN_PAYLOAD = 900; - - // Ship text as on-glasses cached-glyph draws (CFW modes 12/14) instead of - // pixels, punching glyph ink out of the baked deltas (see TexturePlanner). - // Also gated at runtime on the firmware advertising texcache12 + texstr14. - final boolean TEXTURE_CACHE_FRAMES = true; -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/G2Event.java b/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/G2Event.java deleted file mode 100644 index 7d5c57bb..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/G2Event.java +++ /dev/null @@ -1,116 +0,0 @@ -package com.faceclaw.app; - -public final class G2Event { - final String kind; - final String containerName; - final int eventType; - final int eventSource; - final int systemExitReasonCode; - // IMU_Report_Data (Sys_ItemEvent.IMUData), populated when the firmware - // attaches an accelerometer reading to a sys-event. - final boolean hasImu; - final double imuX; - final double imuY; - final double imuZ; - - public G2Event(String kind, String containerName, int eventType, int eventSource, int systemExitReasonCode) { - this(kind, containerName, eventType, eventSource, systemExitReasonCode, false, 0, 0, 0); - } - - public G2Event(String kind, String containerName, int eventType, int eventSource, int systemExitReasonCode, - boolean hasImu, double imuX, double imuY, double imuZ) { - this.kind = kind; - this.containerName = containerName; - this.eventType = eventType; - this.eventSource = eventSource; - this.systemExitReasonCode = systemExitReasonCode; - this.hasImu = hasImu; - this.imuX = imuX; - this.imuY = imuY; - this.imuZ = imuZ; - } - - public static G2Event decode(BleProtocol.ParsedFrame frame) { - byte[] pb = BleProtocol.stripTrailingCrc(frame.pb); - - // sid 0x07 is the stock Even AI app, not EvenHub, so it carries an - // EvenAIDataPackage rather than the device-event wrapper below. - // EvenAIDataPackage { command_id = 1, magic_random = 2, ctrl = 3 }, - // EvenAIControl { status = 1 }. The event we care about is - // command_id=CTRL with status=WAKE_UP, which the firmware emits when the - // on-glasses "Hey Even" wakeword fires. - if (frame.sid == BleProtocol.SID_EVEN_AI) { - int commandId = BleProtocol.readVarintFieldValue(pb, 1, -1); - if (commandId != BleProtocol.EVEN_AI_CMD_CTRL) { - return null; - } - byte[] ctrl = BleProtocol.readFieldBytes(pb, 3); - if (ctrl == null) { - return null; - } - int status = BleProtocol.readVarintFieldValue(ctrl, 1, -1); - if (status < 0) { - return null; - } - return new G2Event("even-ai", "", status, 0, 0); - } - - byte[] deviceEvent = BleProtocol.readFieldBytes(pb, 13); - if (deviceEvent == null) { - return null; - } - - byte[] listEvent = BleProtocol.readFieldBytes(deviceEvent, 1); - if (listEvent != null) { - return new G2Event( - "list-click", - BleProtocol.readStringFieldValue(listEvent, 2), - BleProtocol.readVarintFieldValue(listEvent, 5, BleProtocol.EVENT_CLICK), - 0, - 0 - ); - } - - byte[] textEvent = BleProtocol.readFieldBytes(deviceEvent, 2); - if (textEvent != null) { - return new G2Event( - "text-click", - BleProtocol.readStringFieldValue(textEvent, 2), - BleProtocol.readVarintFieldValue(textEvent, 3, BleProtocol.EVENT_CLICK), - 0, - 0 - ); - } - - byte[] sysEvent = BleProtocol.readFieldBytes(deviceEvent, 3); - if (sysEvent != null) { - int eventType = BleProtocol.readVarintFieldValue(sysEvent, 1, BleProtocol.EVENT_CLICK); - int eventSource = BleProtocol.readVarintFieldValue(sysEvent, 2, 0); - int exitReason = BleProtocol.readVarintFieldValue(sysEvent, 4, 0); - // IMUData (field 3) is IMU_Report_Data { double x=1, y=2, z=3 }. It - // may accompany any sys-event, or arrive as a standalone - // IMU_DATA_REPORT sample. - byte[] imu = BleProtocol.readFieldBytes(sysEvent, 3); - if (imu != null) { - double x = BleProtocol.readFloatFieldValue(imu, 1, 0); - double y = BleProtocol.readFloatFieldValue(imu, 2, 0); - double z = BleProtocol.readFloatFieldValue(imu, 3, 0); - return new G2Event("sys-event", "", eventType, eventSource, exitReason, true, x, y, z); - } - return new G2Event("sys-event", "", eventType, eventSource, exitReason); - } - return null; - } - - private static String hex(byte[] data) { - if (data == null) { - return "null"; - } - StringBuilder sb = new StringBuilder(data.length * 2); - for (byte b : data) { - sb.append(String.format("%02x", b & 0xff)); - } - return sb.toString(); - } - -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/MessageBuilder.java b/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/MessageBuilder.java deleted file mode 100644 index 8377dcc4..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/MessageBuilder.java +++ /dev/null @@ -1,281 +0,0 @@ -package com.faceclaw.app; - -public class MessageBuilder { - private static final int ACK_TIMEOUT_MS = 3_500; - private static final int HEARTBEAT_TIMEOUT_MS = 1_500; - - private BleMagicPool magicPool; - - public MessageBuilder(BleMagicPool magicPool) { - this.magicPool = magicPool; - } - - public OutboundMessage prelude() { - return new OutboundMessage( - "prelude", "prelude", - BleProtocol.PRELUDE_ACK_SID, - BleProtocol.FLAG_REQUEST, - BleProtocol.PRELUDE_ACK_MAGIC, - BleProtocol.PRELUDE_F5872_PAYLOAD, - ACK_TIMEOUT_MS, - -1, - false - ); - } - - /** The per-connection sid-0x80 security-auth request (one per arm). */ - public OutboundMessage securityAuth(boolean leftArm) { - int magic = magicPool.allocate(); - return new OutboundMessage( - "security-auth", - "security auth " + (leftArm ? "L" : "R"), - BleProtocol.SID_SECURITY_AUTH, - BleProtocol.FLAG_SECURITY_AUTH, - magic, - BleProtocol.buildAuthenticationRequest(magic), - ConnectionOptions.SECURITY_AUTH_SOFT_TIMEOUT_MS, - -1, - leftArm - ); - } - - public OutboundMessage shutdown(int exitMode) { - int magic = magicPool.allocate(); - return new OutboundMessage( - "shutdown", - "shutdown mode=" + exitMode, - BleProtocol.SID_EVENHUB, - BleProtocol.FLAG_REQUEST, - magic, - BleProtocol.buildShutdown(magic, exitMode), - ACK_TIMEOUT_MS, - -1, - false - ); - } - - public OutboundMessage imagePayload( - BleProtocol.ImageTileOptions tile, - int sessionId, - byte[] payload, - String label, - boolean leftArm - ) { - return imagePayload("sound", tile, sessionId, payload, label, leftArm); - } - - public OutboundMessage imagePayload( - String kind, - BleProtocol.ImageTileOptions tile, - int sessionId, - byte[] payload, - String label, - boolean leftArm - ) { - // Keep these arguments for source compatibility with existing callers; - // the private command no longer carries a tile, session, or image header. - return customMessage(kind, payload, label, -1, leftArm); - } - - public OutboundMessage customMessage(String kind, byte[] payload, String label, - int tileIndex, boolean leftArm) { - if (payload == null || payload.length > CfwTransport.MAX_MESSAGE) - throw new IllegalArgumentException("CFW message exceeds uint16 length"); - int streamId = magicPool.allocate(); - return new OutboundMessage(kind, label, CfwTransport.SID, 0, streamId, payload, - CfwMessageWindow.ACK_TIMEOUT_MS, tileIndex, leftArm); - } - - public OutboundMessage cfwCleanup( - BleProtocol.ImageTileOptions tile, - int sessionId, - boolean leftArm - ) { - byte[] payload = new byte[] { (byte) BleProtocol.CFW_IMAGE_MODE_CLEANUP }; - return imagePayload( - "cfw-cleanup", - tile, - sessionId, - payload, - "CFW cleanup", - leftArm - ); - } - - public OutboundMessage enableOrDisableMic(boolean enable) { - int magic = magicPool.allocate(); - return new OutboundMessage( - "audio-control", - enable ? "G2 mic enable" : "G2 mic disable", - BleProtocol.SID_EVENHUB, - BleProtocol.FLAG_REQUEST, - magic, - BleProtocol.buildAudioControl(magic, enable), - ACK_TIMEOUT_MS, - -1, - false - ); - } - - public OutboundMessage enableOrDisableImu(boolean enable, int reportFrq) { - int magic = magicPool.allocate(); - return new OutboundMessage( - "imu-control", - enable ? "IMU enable" : "IMU disable", - BleProtocol.SID_EVENHUB, - BleProtocol.FLAG_REQUEST, - magic, - BleProtocol.buildImuControl(magic, enable, reportFrq), - ACK_TIMEOUT_MS, - -1, - false - ); - } - - public OutboundMessage setBrightness(boolean autoAdjust, int brightnessLevel) { - int magic = magicPool.allocate(); - return new OutboundMessage( - "brightness-control", - autoAdjust ? "brightness auto" : "brightness level=" + brightnessLevel, - BleProtocol.SID_UI_SETTING, - BleProtocol.FLAG_REQUEST, - magic, - BleProtocol.buildSetBrightness(magic, autoAdjust, brightnessLevel), - ACK_TIMEOUT_MS, - -1, - false - ); - } - - public OutboundMessage setWearDetection(boolean enabled) { - int magic = magicPool.allocate(); - return new OutboundMessage( - "wear-detection-control", - "wear detection " + (enabled ? "enable" : "disable"), - BleProtocol.SID_UI_SETTING, - BleProtocol.FLAG_REQUEST, - magic, - BleProtocol.buildSetWearDetection(magic, enabled), - ACK_TIMEOUT_MS, - -1, - false - ); - } - - public OutboundMessage createLayout() { - int magic = magicPool.allocate(); - return new OutboundMessage( - "create-layout", - "create-layout", - BleProtocol.SID_EVENHUB, - BleProtocol.FLAG_REQUEST, - magic, - BleProtocol.buildCreateInputPage(magic), - ACK_TIMEOUT_MS, - -1, - false - ); - } - - public OutboundMessage startupTextProbe() { - int magic = magicPool.allocate(); - return new OutboundMessage( - "startup-text-probe", - "startup text probe", - BleProtocol.SID_EVENHUB, - BleProtocol.FLAG_REQUEST, - magic, - BleProtocol.buildDashboardTextUpgrade(magic), - ACK_TIMEOUT_MS, - -1, - false - ); - } - - public OutboundMessage heartbeat() { - int magic = magicPool.allocate(); - return new OutboundMessage( - "heartbeat", - "heartbeat", - BleProtocol.SID_EVENHUB, - BleProtocol.FLAG_REQUEST, - magic, - BleProtocol.buildHeartbeat(magic), - HEARTBEAT_TIMEOUT_MS, - -1, - false - ); - } - - public OutboundMessage batteryQuery() { - int magic = magicPool.allocate(); - return new OutboundMessage( - "battery", - "battery", - BleProtocol.SID_UI_SETTING, - BleProtocol.FLAG_REQUEST, - magic, - BleProtocol.buildSettingsQuery(magic), - ACK_TIMEOUT_MS, - -1, - false - ); - } - - public OutboundMessage faceclawWakeControl(int operation, int nonce, boolean leftArm) { - return new OutboundMessage( - "wake-lease-control", - "wake lease op=" + operation + " nonce=" + nonce + (leftArm ? " L" : " R"), - BleProtocol.SID_UI_SETTING, - BleProtocol.FLAG_REQUEST, - 0, - BleProtocol.buildFaceclawWakeControl(operation, nonce), - ACK_TIMEOUT_MS, - -1, - leftArm - ); - } - - public OutboundMessage faceclawFramebufferControl(int operation, boolean leftArm) { - return new OutboundMessage( - "framebuffer-lease-control", - "framebuffer lease op=" + operation + (leftArm ? " L" : " R"), - BleProtocol.SID_UI_SETTING, - BleProtocol.FLAG_REQUEST, - 0, - BleProtocol.buildFaceclawWakeControl(operation, 0), - ACK_TIMEOUT_MS, - -1, - leftArm - ); - } - - /** CFW mic_control write (settings field 103) targeted at one temple. */ - public OutboundMessage faceclawMicControl(byte[] record, String label, boolean leftArm) { - return new OutboundMessage( - "mic-control", - "mic control " + label + (leftArm ? " L" : " R"), - BleProtocol.SID_UI_SETTING, - BleProtocol.FLAG_REQUEST, - 0, - BleProtocol.buildFaceclawMicControl(record), - ACK_TIMEOUT_MS, - -1, - leftArm - ); - } - - public OutboundMessage faceclawWearQuery(boolean leftArm) { - return new OutboundMessage( - "wear-query-control", - "wear state query" + (leftArm ? " L" : " R"), - BleProtocol.SID_UI_SETTING, - BleProtocol.FLAG_REQUEST, - 0, - BleProtocol.buildFaceclawWakeControl(BleProtocol.FACECLAW_WEAR_OP_QUERY, 0), - ACK_TIMEOUT_MS, - -1, - leftArm - ); - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/OutboundMessage.java b/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/OutboundMessage.java deleted file mode 100644 index bfdcd5cf..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/OutboundMessage.java +++ /dev/null @@ -1,71 +0,0 @@ -package com.faceclaw.app; -import java.util.Arrays; - -public final class OutboundMessage { - final String kind; - final String label; - final int sid; - final int flag; - int magic; - final byte[] message; - final int ackTimeoutMs; - final int tileIndex; - final boolean isLeftArmMessage; - - int cfwAckLenses, cfwRetries; - boolean cfwRetryPending; - final int cfwChecksum; - - int imageUpdateId; - int imageMessageNumber; - int imageMessageCount; - long sentAtMs; - long writeStartedAtMs; - long ackDeadlineAtMs; - byte[] ackPayload = new byte[0]; - Runnable onSent; - Runnable onAck; - Runnable onTimeout; - - OutboundMessage(String kind, String label, int sid, int flag, int magic, byte[] message, int ackTimeoutMs, int tileIndex, boolean isLeftArmMessage) { - this.kind = kind; - this.label = label; - this.sid = sid; - this.flag = flag; - this.magic = magic; - this.message = message == null ? new byte[0] : Arrays.copyOf(message, message.length); - this.cfwChecksum = sid == CfwTransport.SID ? CfwTransport.crc(this.message) : 0; - this.ackTimeoutMs = ackTimeoutMs; - this.tileIndex = tileIndex; - this.isLeftArmMessage = isLeftArmMessage; - } - - /** NACK names this attempt's stream/message sequence, even without a decoded size. */ - boolean acceptCfwAck(CfwTransport.Ack ack) { - if (ack == null || sid != CfwTransport.SID || magic != ack.streamId - || ack.messageId != 0 || (ack.lens != 1 && ack.lens != 2)) return false; - if (ack.nack) { - cfwRetryPending = true; - return false; - } - if (message.length != ack.size || cfwChecksum != ack.checksum) return false; - cfwAckLenses |= ack.lens; - return !cfwRetryPending && cfwAckLenses == CfwTransport.BOTH; - } - - /** Replace an attempt atomically under the communicator lock. */ - void prepareCfwReplay(int streamId) { - magic = streamId; - ++cfwRetries; - cfwAckLenses = 0; - cfwRetryPending = false; - ackDeadlineAtMs = 0; - ackPayload = new byte[0]; - } - - void setImageUpdatePosition(int updateId, int messageNumber, int messageCount) { - this.imageUpdateId = updateId; - this.imageMessageNumber = messageNumber; - this.imageMessageCount = messageCount; - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/TextureCacheState.java b/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/TextureCacheState.java deleted file mode 100644 index 23cebc1d..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/TextureCacheState.java +++ /dev/null @@ -1,179 +0,0 @@ -package com.faceclaw.app; - -import java.io.ByteArrayOutputStream; -import java.util.ArrayList; -import java.util.HashMap; -import java.util.List; -import java.util.Map; - -/** - * Phone-side model of the CFW's flat 256 KiB texture cache (zlib_glue mode 18). - * The firmware holds only bytes; every structural decision — where font - * tables and glyph images live, what is resident, when to start over — is - * made here. Layout per font: a 96-entry uint32 offset table (chars 32..127) - * whose entries are written lazily as each glyph is uploaded; glyph images - * are the GlyphAtlas cached bytes ([w][h][4bpp RLE]). - * - * Allocation is a bump pointer with reset-on-full: the realistic working set - * (a few fonts' tables plus ~hundreds of glyphs at tens of bytes each) is far - * below 256 KiB, so eviction sophistication buys nothing. After a reset the - * firmware cache still holds stale bytes; that is safe because a draw only - * ever references (font table entry, glyph image) pairs uploaded in the - * current generation — stale table entries are never named in a mode-20 - * string. - * - * Upload entries accumulate as complete [offset u32][len u16][data] records - * and drain into one or more standalone mode-18 payloads, each independently - * valid, enqueued ahead of the image message that references them (the - * transport is FIFO, so no ack round-trip is needed before use). - * - * Not thread-safe by itself: the communicator calls it under its own lock. - */ -public final class TextureCacheState { - public static final int CACHE_SIZE = 262144; - private static final int FONT_TABLE_BYTES = 96 * 4; - - private int allocEnd = 0; - private final Map fontTableOffsets = new HashMap<>(); - private final Map glyphOffsets = new HashMap<>(); - private final Map imageOffsets = new HashMap<>(); - private final List pendingEntries = new ArrayList<>(); - private int pendingBytes = 0; - private int generation = 0; - - /** - * Forget everything: the on-glasses cache is gone (session teardown, lease - * loss) or no longer trustworthy (upload timeout), or we ran out of space. - * Glyphs and images re-upload lazily on next use. - */ - public void reset() { - allocEnd = 0; - fontTableOffsets.clear(); - glyphOffsets.clear(); - imageOffsets.clear(); - pendingEntries.clear(); - pendingBytes = 0; - generation++; - } - - /** Bumped by every reset; lets a planner detect a mid-plan reset. */ - public int generation() { - return generation; - } - - /** - * Bytes currently allocated out of CACHE_SIZE, for logging/tuning (a - * sudden drop in the frame log means a reset-on-full re-upload cycle — - * the signal that the 256 KiB budget is being outgrown). - */ - public int usedBytes() { - return allocEnd; - } - - /** The font's 96-entry table offset in the cache, or -1 when it exists but this glyph can't fit. */ - public int fontTableOffset(int fontId) { - Integer existing = fontTableOffsets.get(fontId); - return existing == null ? -1 : existing; - } - - /** - * Ensure a glyph image (and its font table slot) is resident, queuing the - * mode-18 upload entries for anything newly placed. Returns the glyph's - * image offset, or -1 when the cache is full (caller resets and retries) - * or the encoding is outside the mode-20 table (32..127). - */ - public int ensureGlyph(int fontId, int encoding, GlyphAtlas.Glyph glyph) { - if (glyph == null || encoding < 32 || encoding > 127) return -1; - long key = ((long) fontId << 32) | (encoding & 0xffffffffL); - Integer existing = glyphOffsets.get(key); - if (existing != null) return existing; - - Integer table = fontTableOffsets.get(fontId); - int need = glyph.cachedBytes.length + (table == null ? FONT_TABLE_BYTES : 0); - if (allocEnd + need > CACHE_SIZE) return -1; - - if (table == null) { - table = allocEnd; - allocEnd += FONT_TABLE_BYTES; - fontTableOffsets.put(fontId, table); - // No upload for the table itself: entries are written per glyph, - // and only uploaded entries are ever referenced by a draw. - } - int offset = allocEnd; - allocEnd += glyph.cachedBytes.length; - glyphOffsets.put(key, offset); - - addEntry(offset, glyph.cachedBytes); - addEntry(table + 4 * (encoding - 32), - new byte[]{(byte) offset, (byte) (offset >> 8), - (byte) (offset >> 16), (byte) (offset >> 24)}); - return offset; - } - - /** - * Ensure an ImageAtlas entry is resident (mode-19 draws reference it by - * raw cache offset; no table involved). Returns the image offset, or -1 - * when the cache is full (caller resets and retries). - */ - public int ensureImage(int imageId, ImageAtlas.Entry image) { - if (image == null) return -1; - Integer existing = imageOffsets.get(imageId); - if (existing != null) return existing; - if (allocEnd + image.cachedBytes.length > CACHE_SIZE) return -1; - int offset = allocEnd; - allocEnd += image.cachedBytes.length; - imageOffsets.put(imageId, offset); - addEntry(offset, image.cachedBytes); - return offset; - } - - private void addEntry(int offset, byte[] data) { - byte[] entry = new byte[6 + data.length]; - entry[0] = (byte) (offset & 0xff); - entry[1] = (byte) ((offset >> 8) & 0xff); - entry[2] = (byte) ((offset >> 16) & 0xff); - entry[3] = (byte) ((offset >> 24) & 0xff); - entry[4] = (byte) (data.length & 0xff); - entry[5] = (byte) ((data.length >> 8) & 0xff); - System.arraycopy(data, 0, entry, 6, data.length); - pendingEntries.add(entry); - pendingBytes += entry.length; - } - - public boolean hasPendingUploads() { - return !pendingEntries.isEmpty(); - } - - /** Total queued upload bytes (entry framing included), for logging. */ - public int pendingUploadBytes() { - return pendingBytes; - } - - /** - * Drain the queued entries into complete mode-18 payloads ([18][entries]), - * each at most maxPayloadBytes so a payload fits one BLE image message - * without fragmentation. A single entry larger than the cap still gets its - * own payload (the transport can fragment it). - */ - public List drainUploadPayloads(int maxPayloadBytes) { - List payloads = new ArrayList<>(); - ByteArrayOutputStream current = null; - for (byte[] entry : pendingEntries) { - if (current != null && current.size() + entry.length > maxPayloadBytes) { - payloads.add(current.toByteArray()); - current = null; - } - if (current == null) { - current = new ByteArrayOutputStream(Math.min(maxPayloadBytes, 4 + entry.length)); - current.write(18); - } - current.write(entry, 0, entry.length); - } - if (current != null) { - payloads.add(current.toByteArray()); - } - pendingEntries.clear(); - pendingBytes = 0; - return payloads; - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/TexturePlanner.java b/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/TexturePlanner.java deleted file mode 100644 index ac700cc2..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/TexturePlanner.java +++ /dev/null @@ -1,721 +0,0 @@ -package com.faceclaw.app; - -import java.util.ArrayList; -import java.util.Collections; -import java.util.Comparator; -import java.util.List; - -/** - * Plans a screen update that ships text and icons as on-glasses cached draws - * instead of pixels (CFW modes 18/19/20; see g2flash/patches/zlib_glue.c and - * texture_cache.c). - * - * Approach: dirty rects come from comparing the fully composited old and new - * frames, exactly as the plain incremental path does. For each deferred draw - * (glyph or image) whose pixels intersect a sent rect, check that every pixel - * the on-glasses draw would write lands correct — i.e. the new composite's - * 4bpp value at each in-panel nonzero-source pixel equals what the draw - * produces (this one check subsumes plane occlusion, surface - * occlusion/clipping, and draw-on-draw overlap). A draw that passes and is - * (or can be made) resident in the texture cache is replayed on-glasses: its - * written pixels are punched to 0 in the delta rect content — which is what - * makes text and icons nearly free to compress — and re-emitted as a mode-20 - * string or mode-19 image sub-message in the same atomic mode-8 batch, so - * the shadow after apply equals the full composite exactly. Everything else - * stays baked. - * - * Fallback shape: when nothing qualifies, plan() returns null and the caller - * uses the plain single-bbox/multi-rect/full-frame paths unchanged. - */ -public final class TexturePlanner { - private TexturePlanner() {} - - /** Cap on mode-20 string sub-messages (mode-8 count is a u8). */ - private static final int MAX_GLYPH_RUNS = 180; - /** - * Soft cap on cached-glyph selection per update, before run grouping. - * Sized above a full-screen 6x12 terminal repaint (~4,240 cells) so dense - * screens draw everything; the run budget is the real bound. - */ - private static final int MAX_SELECTED_GLYPHS = 4600; - /** Cap on mode-19 image sub-messages per update. */ - private static final int MAX_IMAGE_DRAWS = 60; - /** Cap on mode-15 builtin-font string sub-messages per update. */ - private static final int MAX_FWTEXT_RUNS = 80; - /** Mode-18 payload size that fits one BLE image message comfortably. */ - private static final int UPLOAD_PAYLOAD_MAX = 3600; - /** Max x-adjust control bytes between two glyphs before starting a new run. */ - private static final int MAX_ADJUST_BYTES = 4; - /** Options: identity LUT (top 15) + transparent, for mode-19 image draws. */ - private static final int IMAGE_DRAW_OPTIONS = 0x1f; - - public static final class Result { - /** Complete image payload: a mode-8 batch of rect deltas + cached draws. */ - public final byte[] payload; - /** Mode-18 upload payloads to enqueue BEFORE the image message. */ - public final List uploads; - /** Next mode-3 frame id (deltas consumed some). */ - public final int nextFid; - public final int rectCount; - public final int drawnGlyphs; - public final int runCount; - public final int drawnImages; - public final int fwGlyphs; - public final int fwRuns; - public final int bakedCandidates; - public final int uploadBytes; - public final boolean fullFrame; - /** - * Where the planning time went, in ms. This runs on the send thread, - * directly in the input-to-display path, so the split is reported in - * the frame log: rects = finding the changed region, match = checking - * each draw against the composite, cache = residency/uploads plus run - * building, punch = clearing replayed draws out of a copy of the - * frame, encode = compressing the leftover pixels. - */ - public int rectsMs; - public int matchMs; - public int cacheMs; - public int punchMs; - public int encodeMs; - - Result(byte[] payload, List uploads, int nextFid, int rectCount, - int drawnGlyphs, int runCount, int drawnImages, int fwGlyphs, int fwRuns, - int bakedCandidates, int uploadBytes, boolean fullFrame) { - this.payload = payload; - this.uploads = uploads; - this.nextFid = nextFid; - this.rectCount = rectCount; - this.drawnGlyphs = drawnGlyphs; - this.runCount = runCount; - this.drawnImages = drawnImages; - this.fwGlyphs = fwGlyphs; - this.fwRuns = fwRuns; - this.bakedCandidates = bakedCandidates; - this.uploadBytes = uploadBytes; - this.fullFrame = fullFrame; - } - } - - /** One draw selected for on-glasses replay. */ - private static final class Selected { - final SurfaceCompositor.ScreenDraw draw; - final GlyphAtlas.Glyph glyphAtlas; // glyph draws - final ImageAtlas.Entry imageAtlas; // image draws - final int gx; // screen x of the cached image (pen + bearing / blit left) - final int top; // glyph draws: 4bpp top color - - Selected(SurfaceCompositor.ScreenDraw draw, GlyphAtlas.Glyph glyphAtlas, - ImageAtlas.Entry imageAtlas, int gx, int top) { - this.draw = draw; - this.glyphAtlas = glyphAtlas; - this.imageAtlas = imageAtlas; - this.gx = gx; - this.top = top; - } - } - - /** - * Plan a cached-draw update. previous is the delta base (the frame the - * shadow currently holds), or null/mismatched for a full-frame keyframe. - * Returns null when the plain paths should run instead (no replayable - * draws, or identical frames). - */ - public static Result plan( - byte[] previous, byte[] next, int width, int height, - SurfaceCompositor.ScreenDraw[] draws, - TextureCacheState cache, int fidStart, - boolean allowMultiRect, int maxRects) { - if (next == null || draws == null || draws.length == 0 || width <= 0 || height <= 0) { - return null; - } - int stride = (width + 1) >> 1; - if (next.length != stride * height) { - return null; - } - long planStartedAtMs = android.os.SystemClock.elapsedRealtime(); - - // Rect geometry, matching what the plain paths would send. - boolean fullFrame = previous == null || previous.length != next.length; - List rects; - if (!fullFrame) { - int[] box = BleImageOptimizer.computeChangedBox(previous, next, width, height); - if (box == null) { - return null; // identical frames; caller's dedup normally catches this - } - if (box[2] >= width && box[3] >= height) { - fullFrame = true; - rects = Collections.singletonList(new int[]{0, 0, width, height}); - } else { - List split = allowMultiRect - ? BleImageOptimizer.computeChangedRects(previous, next, width, height, maxRects) - : null; - rects = split != null ? split : Collections.singletonList(box); - } - } else { - rects = Collections.singletonList(new int[]{0, 0, width, height}); - } - - long matchStartedAtMs = android.os.SystemClock.elapsedRealtime(); - - // Candidates: draws whose written pixels intersect a sent rect, are - // representable on the wire, and land correct against the composite. - List selected = new ArrayList<>(); - int bakedCandidates = 0; - int selectedImages = 0; - // Builtin-font (mode 15) runs: no cache residency, no uploads — the - // firmware owns the font. Processed first because it has no cache - // side effects; the counters feed the shared stats. - List fwSubs = new ArrayList<>(); - List fwPunches = new ArrayList<>(); - int fwGlyphCount = 0; - int fwBaked = 0; - for (SurfaceCompositor.ScreenDraw draw : draws) { - if (draw.kind != SurfaceCompositor.ScreenDraw.KIND_FWTEXT) continue; - fwBaked += planFwRun(draw, rects, next, stride, width, height, fwSubs, fwPunches); - } - fwGlyphCount = fwPunches.size(); - bakedCandidates += fwBaked; - for (SurfaceCompositor.ScreenDraw draw : draws) { - if (draw.kind == SurfaceCompositor.ScreenDraw.KIND_GLYPH) { - GlyphAtlas.Glyph atlas = GlyphAtlas.get(draw.fontId, draw.encoding); - if (atlas == null) continue; // unregistered: stays baked, not a "candidate" - int gx = draw.x + atlas.bbxX; - int inkTop = draw.y + atlas.inkTop; - if (!intersectsAny(rects, gx, inkTop, atlas.width, atlas.inkHeight)) { - continue; - } - if (draw.encoding < 32 || draw.encoding > 127 - || gx < 0 || draw.y < 0 || gx > 0xffff || draw.y > 0xffff) { - bakedCandidates++; - continue; - } - int top = BmpUtil.nibbleForGray(draw.value); - if (!glyphMatchesComposite(next, stride, width, height, atlas, gx, draw.y, top)) { - bakedCandidates++; - continue; - } - if (selected.size() >= MAX_SELECTED_GLYPHS) { - bakedCandidates++; - continue; - } - selected.add(new Selected(draw, atlas, null, gx, top)); - } else { - ImageAtlas.Entry atlas = ImageAtlas.get(draw.imageId); - if (atlas == null) continue; - if (!intersectsAny(rects, draw.x, draw.y, atlas.width, atlas.height)) { - continue; - } - if (draw.x < 0 || draw.y < 0 || draw.x > 0xffff || draw.y > 0xffff - || selectedImages >= MAX_IMAGE_DRAWS) { - bakedCandidates++; - continue; - } - if (!imageMatchesComposite(next, stride, width, height, atlas, draw.x, draw.y)) { - bakedCandidates++; - continue; - } - selected.add(new Selected(draw, null, atlas, draw.x, 0)); - selectedImages++; - } - } - if (selected.isEmpty() && fwSubs.isEmpty()) { - return null; - } - long cacheStartedAtMs = android.os.SystemClock.elapsedRealtime(); - - // Residency: ensure every selected draw is in the cache, retrying once - // after a reset when the bump allocator fills. A draw that still fails - // falls back to baked. IMPORTANT: once ensure* has run, every bail-out - // to the plain path must cache.reset() — ensure* marked entries - // resident and queued uploads that only a returned Result would - // enqueue. (Fw-text needs no residency, so a fw-only plan skips this.) - List drawable = selected.isEmpty() - ? Collections.emptyList() - : ensureResident(cache, selected); - bakedCandidates += selected.size() - drawable.size(); - - // Group glyphs into mode-20 runs; leftover-budget glyphs bake. - List glyphDrawable = new ArrayList<>(); - List imageDrawable = new ArrayList<>(); - for (Selected sel : drawable) { - if (sel.glyphAtlas != null) glyphDrawable.add(sel); - else imageDrawable.add(sel); - } - List runs = new ArrayList<>(); - List drawnGlyphs = buildRuns(cache, glyphDrawable, runs); - bakedCandidates += glyphDrawable.size() - drawnGlyphs.size(); - List drawn = new ArrayList<>(drawnGlyphs); - drawn.addAll(imageDrawable); - if ((drawn.isEmpty() && fwSubs.isEmpty()) - || rects.size() + runs.size() + imageDrawable.size() + fwSubs.size() > 255) { - if (!selected.isEmpty()) { - cache.reset(); - } - return null; - } - - // Punch the drawn pixels out of a copy of the composite, then encode - // the rect deltas from the punched content. - long punchStartedAtMs = android.os.SystemClock.elapsedRealtime(); - byte[] punched = next.clone(); - for (Selected sel : drawn) { - punch(punched, stride, width, height, sel); - } - for (FwPunch fw : fwPunches) { - punchFw(punched, stride, width, height, fw); - } - - long encodeStartedAtMs = android.os.SystemClock.elapsedRealtime(); - List subs = new ArrayList<>(); - int fid = fidStart; - if (fullFrame) { - subs.add(BleImageOptimizer.maybeCompress(punched, width, height)); - } else { - for (int[] r : rects) { - subs.add(BleImageOptimizer.encodeMode3Rect(punched, stride, r[0], r[1], r[2], r[3], fid)); - fid = (fid >= 0xfffe) ? 1 : fid + 1; - } - } - for (Selected sel : imageDrawable) { - subs.add(encodeImageDraw(cache, sel)); - } - subs.addAll(runs); - subs.addAll(fwSubs); - byte[] payload = assembleMode8(subs); - - int uploadBytes = cache.pendingUploadBytes(); - List uploads = cache.drainUploadPayloads(UPLOAD_PAYLOAD_MAX); - Result result = new Result(payload, uploads, fid, rects.size(), drawnGlyphs.size(), runs.size(), - imageDrawable.size(), fwGlyphCount, fwSubs.size(), - bakedCandidates, uploadBytes, fullFrame); - long doneAtMs = android.os.SystemClock.elapsedRealtime(); - result.rectsMs = (int) (matchStartedAtMs - planStartedAtMs); - result.matchMs = (int) (cacheStartedAtMs - matchStartedAtMs); - result.cacheMs = (int) (punchStartedAtMs - cacheStartedAtMs); - result.punchMs = (int) (encodeStartedAtMs - punchStartedAtMs); - result.encodeMs = (int) (doneAtMs - encodeStartedAtMs); - return result; - } - - /** One punch task for an emitted firmware-font glyph. */ - private static final class FwPunch { - final FwGlyphAtlas.Entry entry; - final int gx; - final int gy; - - FwPunch(FwGlyphAtlas.Entry entry, int gx, int gy) { - this.entry = entry; - this.gx = gx; - this.gy = gy; - } - } - - /** - * Plan one firmware-font run (mode 15): classify every member, and when - * any correct ink member intersects a sent rect, emit sub-messages over - * the maximal correct stretches. A stretch never spans an incorrect - * member — the sub-message boundary restarts the firmware's advance walk - * at an explicit pen x, so occluded or unknown glyphs simply stay baked - * without disturbing their neighbors' positions. Emitted ink members are - * queued for punching. Returns how many ink members stay baked. - */ - private static int planFwRun( - SurfaceCompositor.ScreenDraw draw, List rects, - byte[] next, int stride, int width, int height, - List outSubs, List outPunches) { - int n = draw.fwCps.length; - if (n == 0 || draw.y < 0 || draw.y > 0xffff) { - return countInk(draw); - } - int top = BmpUtil.nibbleForGray(draw.value); - boolean[] ok = new boolean[n]; - FwGlyphAtlas.Entry[] entries = new FwGlyphAtlas.Entry[n]; - boolean relevant = false; - int baked = 0; - for (int i = 0; i < n; i++) { - if (!draw.fwInk[i]) { - ok[i] = true; // inkless connector (space): draws nothing - continue; - } - FwGlyphAtlas.Entry entry = FwGlyphAtlas.get(draw.fwCps[i]); - if (entry == null) { - baked++; - continue; - } - int gx = draw.x + draw.fwDx[i] + entry.ofsX; - int gy = draw.y + entry.inkTop; - if (!fwGlyphMatchesComposite(next, stride, width, height, entry, gx, gy, top)) { - baked++; - continue; - } - ok[i] = true; - entries[i] = entry; - if (intersectsAny(rects, gx, gy, entry.boxW, entry.boxH)) { - relevant = true; - } - } - if (!relevant) { - return 0; // nothing in a sent rect: leave the run's pixels alone - } - - int i = 0; - while (i < n && outSubs.size() < MAX_FWTEXT_RUNS) { - while (i < n && !(ok[i] && draw.fwInk[i])) i++; - if (i >= n) break; - int startX = draw.x + draw.fwDx[i]; - if (startX < 0 || startX > 0xffff) { - baked++; - i++; - continue; - } - // Extend across correct members while the UTF-8 payload fits, - // tracking the last ink member so trailing connectors trim away. - int j = i; - int lastInk = -1; - int bytesToLastInk = 0; - int bytesSoFar = 0; - while (j < n && ok[j]) { - int encodedLength = utf8Length(draw.fwCps[j]); - if (bytesSoFar + encodedLength > 255) break; - bytesSoFar += encodedLength; - if (draw.fwInk[j]) { - lastInk = j; - bytesToLastInk = bytesSoFar; - } - j++; - } - if (lastInk < i) { // a single over-long codepoint; not realistic - baked++; - i++; - continue; - } - byte[] sub = new byte[7 + bytesToLastInk]; - sub[0] = 15; - sub[1] = (byte) (startX & 0xff); - sub[2] = (byte) ((startX >> 8) & 0xff); - sub[3] = (byte) (draw.y & 0xff); - sub[4] = (byte) ((draw.y >> 8) & 0xff); - sub[5] = (byte) (top | 0x10); // top color + transparent - sub[6] = (byte) bytesToLastInk; - int pos = 7; - for (int k = i; k <= lastInk; k++) { - byte[] encoded = new StringBuilder().appendCodePoint(draw.fwCps[k]) - .toString().getBytes(java.nio.charset.StandardCharsets.UTF_8); - System.arraycopy(encoded, 0, sub, pos, encoded.length); - pos += encoded.length; - } - outSubs.add(sub); - for (int k = i; k <= lastInk; k++) { - if (draw.fwInk[k]) { - outPunches.add(new FwPunch(entries[k], - draw.x + draw.fwDx[k] + entries[k].ofsX, - draw.y + entries[k].inkTop)); - } - } - i = lastInk + 1; - } - return baked; - } - - private static int utf8Length(int cp) { - if (cp < 0x80) return 1; - if (cp < 0x800) return 2; - if (cp < 0x10000) return 3; - return 4; - } - - private static int countInk(SurfaceCompositor.ScreenDraw draw) { - int count = 0; - for (boolean ink : draw.fwInk) { - if (ink) count++; - } - return count; - } - - /** - * Whether every in-panel nonzero pixel of the builtin-font glyph lands - * correct: the composite's 4bpp value must equal the firmware's LUT - * output src*top/15 (integer division — a general LUT check, since these - * glyphs are anti-aliased). - */ - private static boolean fwGlyphMatchesComposite(byte[] packed, int stride, int width, int height, - FwGlyphAtlas.Entry entry, int gx, int gy, int top) { - for (int row = 0; row < entry.boxH; row++) { - int y = gy + row; - if (y < 0 || y >= height) continue; - for (int col = 0; col < entry.boxW; col++) { - int source = entry.nibbleAt(col, row); - if (source == 0) continue; - int x = gx + col; - if (x < 0 || x >= width) continue; - if (nibbleAt(packed, stride, x, y) != (source * top) / 15) { - return false; - } - } - } - return true; - } - - private static void punchFw(byte[] packed, int stride, int width, int height, FwPunch fw) { - for (int row = 0; row < fw.entry.boxH; row++) { - int y = fw.gy + row; - if (y < 0 || y >= height) continue; - for (int col = 0; col < fw.entry.boxW; col++) { - if (fw.entry.nibbleAt(col, row) == 0) continue; - punchPixel(packed, stride, width, fw.gx + col, y); - } - } - } - - private static boolean intersectsAny(List rects, int x, int y, int w, int h) { - if (w <= 0 || h <= 0) return false; - for (int[] r : rects) { - if (x < r[0] + r[2] && x + w > r[0] && y < r[1] + r[3] && y + h > r[1]) { - return true; - } - } - return false; - } - - /** - * Whether every in-panel ink pixel of the glyph lands correct in the - * packed new frame: the composite's 4bpp value must equal the firmware's - * LUT output source*top/15 (integer). For 1bpp glyphs (source 15) this is - * exactly `== top`; AA glyphs get the general check. Ink outside the - * panel is clipped by the firmware and irrelevant. - */ - private static boolean glyphMatchesComposite(byte[] packed, int stride, int width, int height, - GlyphAtlas.Glyph atlas, int gx, int lineY, int top) { - for (int row = atlas.inkTop; row < atlas.inkTop + atlas.inkHeight; row++) { - int y = lineY + row; - if (y < 0 || y >= height) continue; - for (int col = 0; col < atlas.width; col++) { - int source = atlas.nibbleAt(col, row); - if (source == 0) continue; - int x = gx + col; - if (x < 0 || x >= width) continue; - if (nibbleAt(packed, stride, x, y) != (source * top) / 15) { - return false; - } - } - } - return true; - } - - /** - * Whether every in-panel nonzero pixel of the cached image equals the - * packed new frame — the mode-19 transparent draw writes exactly those. - */ - private static boolean imageMatchesComposite(byte[] packed, int stride, int width, int height, - ImageAtlas.Entry atlas, int left, int top) { - for (int row = 0; row < atlas.height; row++) { - int y = top + row; - if (y < 0 || y >= height) continue; - for (int col = 0; col < atlas.width; col++) { - int source = atlas.nibbleAt(col, row); - if (source == 0) continue; - int x = left + col; - if (x < 0 || x >= width) continue; - if (nibbleAt(packed, stride, x, y) != source) { - return false; - } - } - } - return true; - } - - private static int nibbleAt(byte[] packed, int stride, int x, int y) { - int b = packed[y * stride + (x >> 1)] & 0xff; - return (x & 1) != 0 ? (b & 0x0f) : (b >> 4); - } - - private static void punch(byte[] packed, int stride, int width, int height, Selected sel) { - if (sel.glyphAtlas != null) { - GlyphAtlas.Glyph atlas = sel.glyphAtlas; - for (int row = atlas.inkTop; row < atlas.inkTop + atlas.inkHeight; row++) { - int y = sel.draw.y + row; - if (y < 0 || y >= height) continue; - for (int col = 0; col < atlas.width; col++) { - if (!atlas.inkAt(col, row)) continue; - punchPixel(packed, stride, width, sel.gx + col, y); - } - } - } else { - ImageAtlas.Entry atlas = sel.imageAtlas; - for (int row = 0; row < atlas.height; row++) { - int y = sel.draw.y + row; - if (y < 0 || y >= height) continue; - for (int col = 0; col < atlas.width; col++) { - if (atlas.nibbleAt(col, row) == 0) continue; - punchPixel(packed, stride, width, sel.gx + col, y); - } - } - } - } - - private static void punchPixel(byte[] packed, int stride, int width, int x, int y) { - if (x < 0 || x >= width) return; - int index = y * stride + (x >> 1); - if ((x & 1) != 0) { - packed[index] = (byte) (packed[index] & 0xf0); - } else { - packed[index] = (byte) (packed[index] & 0x0f); - } - } - - /** - * Ensure residency for all of `selected`, resetting the cache once if the - * allocator fills mid-plan (a reset invalidates offsets handed out earlier - * in the same pass, so the whole pass reruns). Returns the draws that are - * resident afterwards. - */ - private static List ensureResident(TextureCacheState cache, List selected) { - for (int attempt = 0; attempt < 2; attempt++) { - List resident = new ArrayList<>(selected.size()); - boolean full = false; - for (Selected sel : selected) { - int offset = sel.glyphAtlas != null - ? cache.ensureGlyph(sel.draw.fontId, sel.draw.encoding, sel.glyphAtlas) - : cache.ensureImage(sel.draw.imageId, sel.imageAtlas); - if (offset >= 0) { - resident.add(sel); - } else { - full = true; - } - } - if (!full || attempt == 1) { - return resident; - } - cache.reset(); - } - return Collections.emptyList(); // unreachable - } - - /** Mode-19 cached-image draw: [19][offset u32][x u16][y u16][options u8]. */ - private static byte[] encodeImageDraw(TextureCacheState cache, Selected sel) { - int offset = cache.ensureImage(sel.draw.imageId, sel.imageAtlas); // resident: returns the offset - byte[] sub = new byte[10]; - sub[0] = 19; - sub[1] = (byte) (offset & 0xff); - sub[2] = (byte) ((offset >> 8) & 0xff); - sub[3] = (byte) ((offset >> 16) & 0xff); - sub[4] = (byte) ((offset >> 24) & 0xff); - sub[5] = (byte) (sel.draw.x & 0xff); - sub[6] = (byte) ((sel.draw.x >> 8) & 0xff); - sub[7] = (byte) (sel.draw.y & 0xff); - sub[8] = (byte) ((sel.draw.y >> 8) & 0xff); - sub[9] = (byte) IMAGE_DRAW_OPTIONS; - return sub; - } - - /** - * Group selected glyphs into mode-20 string sub-messages: - * [20][fontTable u32][x u16][y u16][options u8][strlen u8][string] - * One run per (font, line y, top color) span; within a run, control bytes - * 1..31 adjust x by -10..+20 to hit each glyph's exact position, and each - * glyph advances x by its cached width. Order across runs is free: every - * drawn glyph's ink equals the composite, so overlaps write equal values. - * Returns the glyphs actually emitted (run budget can drop stragglers). - */ - private static List buildRuns(TextureCacheState cache, List drawable, List outRuns) { - List sorted = new ArrayList<>(drawable); - sorted.sort(Comparator - .comparingInt((Selected s) -> s.draw.fontId) - .thenComparingInt(s -> s.draw.y) - .thenComparingInt(s -> s.top) - .thenComparingInt(s -> s.gx)); - - List drawn = new ArrayList<>(sorted.size()); - int i = 0; - while (i < sorted.size() && outRuns.size() < MAX_GLYPH_RUNS) { - Selected first = sorted.get(i); - int fontTable = cache.fontTableOffset(first.draw.fontId); - if (fontTable < 0) { // shouldn't happen: residency ensured above - i++; - continue; - } - java.io.ByteArrayOutputStream string = new java.io.ByteArrayOutputStream(); - List runGlyphs = new ArrayList<>(); - int cursor = first.gx; // the run's wire x starts exactly at the first glyph - int j = i; - while (j < sorted.size()) { - Selected sel = sorted.get(j); - if (sel.draw.fontId != first.draw.fontId - || sel.draw.y != first.draw.y - || sel.top != first.top) { - break; - } - int delta = sel.gx - cursor; - int adjustBytes = adjustByteCount(delta); - if (adjustBytes > MAX_ADJUST_BYTES && j > i) { - break; // far gap: cheaper to start a fresh run - } - if (string.size() + adjustBytes + 1 > 255) { - break; // strlen is a u8 - } - emitAdjust(string, delta); - string.write(sel.draw.encoding); - runGlyphs.add(sel); - cursor = sel.gx + sel.glyphAtlas.width; - j++; - } - if (!runGlyphs.isEmpty()) { - byte[] stringBytes = string.toByteArray(); - byte[] run = new byte[11 + stringBytes.length]; - run[0] = 20; - run[1] = (byte) (fontTable & 0xff); - run[2] = (byte) ((fontTable >> 8) & 0xff); - run[3] = (byte) ((fontTable >> 16) & 0xff); - run[4] = (byte) ((fontTable >> 24) & 0xff); - run[5] = (byte) (first.gx & 0xff); - run[6] = (byte) ((first.gx >> 8) & 0xff); - run[7] = (byte) (first.draw.y & 0xff); - run[8] = (byte) ((first.draw.y >> 8) & 0xff); - run[9] = (byte) (first.top | 0x10); // top color + transparent - run[10] = (byte) stringBytes.length; - System.arraycopy(stringBytes, 0, run, 11, stringBytes.length); - outRuns.add(run); - drawn.addAll(runGlyphs); - i = j; - } else { - i++; - } - } - return drawn; - } - - /** How many 1..31 control bytes are needed to move the cursor by delta. */ - private static int adjustByteCount(int delta) { - if (delta == 0) return 0; - return delta > 0 ? (delta + 19) / 20 : (-delta + 9) / 10; - } - - private static void emitAdjust(java.io.ByteArrayOutputStream out, int delta) { - while (delta != 0) { - int step = delta > 0 ? Math.min(delta, 20) : Math.max(delta, -10); - out.write(step + 11); // byte 1..31 adjusts x by (byte - 11) - delta -= step; - } - } - - /** [8][count]([len u16][sub])* — one atomic present for deltas + draws. */ - private static byte[] assembleMode8(List subs) { - int total = 2; - for (byte[] sub : subs) { - total += 2 + sub.length; - } - byte[] out = new byte[total]; - out[0] = 8; - out[1] = (byte) subs.size(); - int pos = 2; - for (byte[] sub : subs) { - out[pos] = (byte) (sub.length & 0xff); - out[pos + 1] = (byte) ((sub.length >> 8) & 0xff); - pos += 2; - System.arraycopy(sub, 0, out, pos, sub.length); - pos += sub.length; - } - return out; - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/util/BmpUtil.java b/App_Resources/Android/src/main/java/com/faceclaw/app/util/BmpUtil.java deleted file mode 100644 index 23898347..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/util/BmpUtil.java +++ /dev/null @@ -1,133 +0,0 @@ -package com.faceclaw.app; -import java.util.Arrays; - -public class BmpUtil { - public static byte[] copyTileBmp(byte[] bmp) { - if (bmp == null || bmp.length == 0) { - return new byte[0]; - } - return Arrays.copyOf(bmp, bmp.length); - } - - // Quantize an 8-bit gray value to a 4-bit nibble. Truncate rather than round - // up at the bottom: the shell's color-key convention paints intentional - // black as 1 (0 being transparent), which must land on nibble 0, not a - // faintly-visible level 1. - private static final byte[] GRAY_TO_NIBBLE = new byte[256]; - static { - for (int v = 1; v < 256; v++) { - GRAY_TO_NIBBLE[v] = (byte) Math.min(15, (v + 8) >> 4); - } - } - - /** - * The 4bpp level an 8-bit gray value packs to. Public so the texture-cache - * planner computes a glyph draw's top color with the exact quantization - * the composited frame was packed with. - */ - public static int nibbleForGray(int gray) { - return GRAY_TO_NIBBLE[gray & 0xff] & 0xff; - } - - /** - * Pack a full-resolution 8bpp grayscale buffer (row-major, top-to-bottom, - * one byte per pixel) into the headerless 4bpp wire format used by CFW - * load_image_z modes 3/6/8: top-down rows, stride ceil(width/2), high - * nibble = left pixel. This is the canonical in-memory frame format; BMP - * framing (needed only when an uncompressed full frame goes on the wire) - * is added on demand by build4bppBmpFromPacked. - */ - public static byte[] pack4bppFromGray8(byte[] gray8, int width, int height) { - if (width <= 0 || height <= 0) { - return new byte[0]; - } - int stride = (width + 1) >> 1; - byte[] out = new byte[stride * height]; - if (gray8 == null || gray8.length < width * height) { - return out; // short buffer: treat missing pixels as black - } - int pairs = width >> 1; - int src = 0; - int dst = 0; - for (int y = 0; y < height; y++) { - for (int i = 0; i < pairs; i++) { - out[dst++] = (byte) ((GRAY_TO_NIBBLE[gray8[src] & 0xff] << 4) - | GRAY_TO_NIBBLE[gray8[src + 1] & 0xff]); - src += 2; - } - if ((width & 1) != 0) { - out[dst++] = (byte) (GRAY_TO_NIBBLE[gray8[src++] & 0xff] << 4); - } - } - return out; - } - - /** - * Wrap a packed 4bpp frame in BMP framing (BITMAPINFOHEADER + 16-entry gray - * palette, bottom-up rows padded to a 4-byte stride). Only the full-frame - * fallback used when mode-6 compression does not shrink the frame still - * speaks BMP on the wire; everything else uses the headerless packed format - * directly. - */ - public static byte[] build4bppBmpFromPacked(byte[] packed, int width, int height) { - int packedStride = (width + 1) >> 1; - if (width <= 0 || height <= 0 - || packed == null || packed.length < packedStride * height) { - return new byte[0]; - } - int rowStride = (packedStride + 3) & ~3; - int pixelDataSize = rowStride * height; - - int fileHeaderSize = 14; - int dibHeaderSize = 40; - int paletteSize = 16 * 4; - int pixelOffset = fileHeaderSize + dibHeaderSize + paletteSize; - int fileSize = pixelOffset + pixelDataSize; - - byte[] buf = new byte[fileSize]; - buf[0] = 0x42; // 'B' - buf[1] = 0x4d; // 'M' - putUint32Le(buf, 2, fileSize); - putUint32Le(buf, 10, pixelOffset); - putUint32Le(buf, 14, dibHeaderSize); - putInt32Le(buf, 18, width); - putInt32Le(buf, 22, height); - putUint16Le(buf, 26, 1); // planes - putUint16Le(buf, 28, 4); // bits per pixel - putUint32Le(buf, 30, 0); // compression (BI_RGB) - putUint32Le(buf, 34, pixelDataSize); - putUint32Le(buf, 46, 16); // palette entry count - - for (int i = 0; i < 16; i++) { - int v = i * 17; - int base = fileHeaderSize + dibHeaderSize + i * 4; - buf[base] = (byte) v; - buf[base + 1] = (byte) v; - buf[base + 2] = (byte) v; - buf[base + 3] = 0; - } - - for (int bmpRow = 0; bmpRow < height; bmpRow++) { - int srcY = height - 1 - bmpRow; // BMP rows run bottom-up - System.arraycopy(packed, srcY * packedStride, - buf, pixelOffset + bmpRow * rowStride, packedStride); - } - return buf; - } - - private static void putUint16Le(byte[] buf, int offset, int value) { - buf[offset] = (byte) (value & 0xff); - buf[offset + 1] = (byte) ((value >>> 8) & 0xff); - } - - private static void putUint32Le(byte[] buf, int offset, int value) { - buf[offset] = (byte) (value & 0xff); - buf[offset + 1] = (byte) ((value >>> 8) & 0xff); - buf[offset + 2] = (byte) ((value >>> 16) & 0xff); - buf[offset + 3] = (byte) ((value >>> 24) & 0xff); - } - - private static void putInt32Le(byte[] buf, int offset, int value) { - putUint32Le(buf, offset, value); - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/util/CollectionUtils.java b/App_Resources/Android/src/main/java/com/faceclaw/app/util/CollectionUtils.java deleted file mode 100644 index c99e29ea..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/util/CollectionUtils.java +++ /dev/null @@ -1,26 +0,0 @@ -package com.faceclaw.app; -import java.util.ArrayList; -import java.util.List; - -public class CollectionUtils { - public static List singletonList(byte[] value) { - List list = new ArrayList<>(1); - list.add(value); - return list; - } - - public static List listOf(byte[] a, byte[] b) { - List list = new ArrayList<>(2); - list.add(a); - list.add(b); - return list; - } - - public static List listOf(byte[] a, byte[] b, byte[] c) { - List list = new ArrayList<>(3); - list.add(a); - list.add(b); - list.add(c); - return list; - } -} diff --git a/app/graphics/glyph-wire.ts b/app/graphics/glyph-wire.ts index 3842c499..adbf533f 100644 --- a/app/graphics/glyph-wire.ts +++ b/app/graphics/glyph-wire.ts @@ -116,7 +116,7 @@ function prepareFwTextRun(placed: PlacedFwText): boolean { bytes.set(entry.data.nibbles, offset + 10); offset += 10 + entry.data.nibbles.length; } - com.faceclaw.app.FwGlyphAtlas.register(buffer); + com.faceclaw.app.FwGlyphAtlas.register(new com.faceclaw.app.AndroidByteReader(buffer)); } return true; } @@ -130,7 +130,7 @@ function imageId(placed: PlacedImage): number | null { let id: number | null = null; if (source.width > 0 && source.width <= 255 && source.height > 0 && source.height <= 255) { const key = `img:${source.width}x${source.height}:${source.contentHash32().toString(16)}`; - id = com.faceclaw.app.ImageAtlas.ensure(key, source.width, source.height, source.pixels.buffer); + id = com.faceclaw.app.ImageAtlas.ensure(key, source.width, source.height, new com.faceclaw.app.AndroidByteReader(source.pixels.buffer)); if (!(typeof id === "number") || id <= 0) id = null; } imageIds.set(source, id); @@ -184,9 +184,9 @@ export function prepareFrameDraws(draws: readonly DeferredDraw[]): ArrayBuffer | } if (registration) { const plainBuffer = buildRegistrationBuffer(registration); - if (plainBuffer) com.faceclaw.app.GlyphAtlas.register(plainBuffer); + if (plainBuffer) com.faceclaw.app.GlyphAtlas.register(new com.faceclaw.app.AndroidByteReader(plainBuffer)); const aaBuffer = buildAaRegistrationBuffer(registration); - if (aaBuffer) com.faceclaw.app.GlyphAtlas.registerAa(aaBuffer); + if (aaBuffer) com.faceclaw.app.GlyphAtlas.registerAa(new com.faceclaw.app.AndroidByteReader(aaBuffer)); } if (bytes === 0) return null; diff --git a/app/native/kotlin-bridge.ts b/app/native/kotlin-bridge.ts index 6baa866e..3799d832 100644 --- a/app/native/kotlin-bridge.ts +++ b/app/native/kotlin-bridge.ts @@ -1,3 +1,4 @@ +import { runKotlinProtocolSmokeTest } from './kotlin-protocol-smoke'; import { isAndroid } from "@nativescript/core"; // Handwritten declarations for this small native surface. NativeScript builds @@ -18,6 +19,7 @@ export function runKotlinBridgeSmokeTest(): void { if (!isAndroid) return; try { + runKotlinProtocolSmokeTest(); const bridge = new com.faceclaw.shared.KotlinBridge(); const greeting = bridge.greet("Faceclaw"); const message = "Faceclaw \u2194 Kotlin \ud83d\udc53"; diff --git a/app/native/kotlin-protocol-smoke.ts b/app/native/kotlin-protocol-smoke.ts new file mode 100644 index 00000000..a99cc1e2 --- /dev/null +++ b/app/native/kotlin-protocol-smoke.ts @@ -0,0 +1,20 @@ +declare const com: any + +/** Development-only checks of NativeScript metadata and bulk ByteBuffer crossings. */ +export function runKotlinProtocolSmokeTest(): void { + const native = com.faceclaw.app + const hex = (data: any) => Array.from({ length: data.length }, (_, i) => (data[i] & 255).toString(16).padStart(2, '0')).join('') + const assert = (condition: boolean, what: string) => { if (!condition) throw new Error(`Kotlin protocol bridge: ${what}`) } + const auth = native.BleProtocol.buildAuthenticationRequest(101) + assert(hex(auth) === '080410651a0408011004', 'authentication') + const compositor = new native.SurfaceCompositor() + compositor.configureScreen(3, 2) + compositor.configureSurface('test', 0, 0, 3, 2, 0, 0) + const pixels = new Uint8Array([0, 16, 255, 32, 48, 64]) + compositor.submitSurface('test', new native.AndroidByteReader(pixels.buffer), 0, 0, 3, 2, '1') + assert(hex(compositor.composite().gray) === '0010ff203040', 'composition/ByteBuffer') + assert(hex(native.BmpUtil.pack4bppFromGray8(compositor.composite().gray, 3, 2)) === '01f02340', 'packing') + const id = native.ImageAtlas.ensure('kotlin-smoke', 3, 2, new native.AndroidByteReader(pixels.buffer)) + assert(id > 0 && native.ImageAtlas.get(id).width === 3, 'image atlas/reused buffer') + console.log('FACECLAW_KOTLIN_PROTOCOL_PASS Android') +} diff --git a/hooks/before-prepare/faceclaw-kotlin.js b/hooks/before-prepare/faceclaw-kotlin.js new file mode 100644 index 00000000..435b315f --- /dev/null +++ b/hooks/before-prepare/faceclaw-kotlin.js @@ -0,0 +1,8 @@ +const { buildKotlin, checkAndroidRuntime } = require('../../scripts/kotlin-build.cjs'); + +module.exports = function (hookArgs) { + // NativeScript parses hooks with an older JavaScript parser; avoid optional chaining. + const { platform, release } = hookArgs.prepareData; + if (platform === 'android') checkAndroidRuntime(); + return buildKotlin(platform, release ? 'release' : 'debug'); +}; diff --git a/native/kotlin/README.md b/native/kotlin/README.md new file mode 100644 index 00000000..441b6639 --- /dev/null +++ b/native/kotlin/README.md @@ -0,0 +1,79 @@ +# Shared Kotlin + +Both `main` and `ios-port` build the same Kotlin Multiplatform sources in +`native/kotlin/shared/src`. NativeScript's `before-prepare` hook builds an AAR +for Android or a static `FaceclawKit.xcframework` for iOS, then stages it in the +local `@faceclaw/kotlin` plugin. Generated binaries and Gradle caches are ignored. + +- `commonMain/kotlin`: wire protocol, fragmentation/reassembly, event decoding, + image/RLE/texture planning, retained surface composition, glyph/image atlases, + LVGL font parsing, spectral noise suppression, PNG/GIF/WAV encodings and + callback interfaces. +- `androidMain/kotlin`: monotonic clock, reentrant locks, JVM zlib and file I/O, + zero-copy `ByteBuffer` readers, firmware hashing/file writes and WAV file storage. +- `iosMain/kotlin`: monotonic clock, recursive locks, native zlib and POSIX file + reads, plus `NSData` facades for NativeScript's Objective-C bridge. + +The `com.faceclaw.app` package, `@JvmStatic` methods and `@JvmField` properties +preserve existing Java/NativeScript callers. Android's `java.nio.ByteBuffer` +entry points for atlases/composition now take `AndroidByteReader`, keeping the +bulk buffer crossing without putting Java APIs in common code. iOS uses +`IosByteReader` and `NSData`; binary bridges avoid per-element JS/native calls. + +## Platform boundaries + +`ProtocolPlatform` supplies clocks, locks and persistent deflaters. `expect` / +`actual` functions select default platform services at compilation. Stateful +transports and caches retain reentrant locking; callbacks still run on their +caller's thread. The migration does not introduce implicit UI-thread dispatch. +`OutboundMessage` and `CfwMessageWindow` require their owner's synchronization. + +`CfwTransport` uses ordered `SYNC_FLUSH` records with one persistent compression +context. Lens changes and replay resets reset that context. Owners can close it +explicitly; iOS also cleans up abandoned native allocations. GATT write modes +are mapped by platform adapters. + +`migrated-java-sources.json` lists each removed Java source and its Kotlin +replacement. Android's build removes precisely those stale generated copies +before compilation. `android-java-boundaries.json` inventories every retained +Java file and its Android API boundary: services/receivers, GATT, media, +WebView, SQLite, rendering, networking and JNI. The sherpa-onnx Java classes +remain the vendored Android JNI ABI. PNG/GIF adapters retain only Android +storage responsibilities; their codecs are shared. + +On `ios-port`, platform adapters route the existing TypeScript session and UI +logic through shared Kotlin for protocol builders, CRC/framing/reassembly, +event decoding, CFW compression/ACKs, changed-image regions, surface composition, +and LVGL glyphs. The original pure TypeScript implementations remain as Node +test references; NativeScript selects the `.ios.ts` native adapters. Features +not yet present in the iOS app can use the shared audio/recording and texture +classes without another Java port. + +## Build and validation + +Requires JDK 21, Android SDK 35 and the existing `wear/gradlew` wrapper. iOS +additionally requires macOS, Xcode and an arm64 simulator. Configure paths in +`build_paths.sh`. Both production and tests use Kotlin 2.4.20 and Android KMP +plugin 8.13.2. + +```sh +npm ci +# Once when upgrading an existing generated Android platform to runtime 9.1.1: +npx nativescript platform clean android +npm run test:kotlin +npm run test:kotlin:ios +./build.sh +# In ios-port: +./scripts/ios.sh build ios --emulator +``` + +`tests/kotlin` compiles production sources directly. Common tests run on JVM +and iOS: wire vectors, framing/corruption/expiry, streaming compression, replay, +composition, PNG pixels, font glyphs, and Java SHA-256 golden outputs for DSP +and GIF. Android additionally runs the existing Java protocol fixtures and +concurrency checks; iOS exercises `NSData` and compositor adapters. Debug app +startup checks real NativeScript metadata and bidirectional callbacks, logging +`FACECLAW_KOTLIN_BRIDGE_PASS` and `FACECLAW_KOTLIN_PROTOCOL_PASS`. + +These checks require no BLE hardware. Physical glasses/ring behavior still +needs device testing, particularly sustained rendering and microphone traffic. diff --git a/native/kotlin/android-java-boundaries.json b/native/kotlin/android-java-boundaries.json new file mode 100644 index 00000000..9bef130a --- /dev/null +++ b/native/kotlin/android-java-boundaries.json @@ -0,0 +1,136 @@ +[ + { + "reason": "BluetoothGatt, BluetoothLeScanner, Android callback threads", + "files": [ + "com/faceclaw/app/FaceclawBleCommunicator.java", + "com/faceclaw/app/FaceclawBleManager.java", + "com/faceclaw/app/FaceclawDeviceDiscovery.java", + "com/faceclaw/app/FaceclawDeviceInfoProbe.java", + "com/faceclaw/app/FaceclawFirmwareFlasher.java", + "com/faceclaw/app/FaceclawFlashPromptCommunicator.java" + ] + }, + { + "reason": "AlarmManager, PendingIntent, Android activities/services/receivers", + "files": [ + "com/faceclaw/app/FaceclawAlarmActivity.java", + "com/faceclaw/app/FaceclawAlarmReceiver.java", + "com/faceclaw/app/FaceclawAlarmRescheduleReceiver.java", + "com/faceclaw/app/FaceclawAlarmService.java", + "com/faceclaw/app/FaceclawAlarms.java", + "com/faceclaw/app/FaceclawForegroundService.java" + ] + }, + { + "reason": "Android providers, sensors, permissions and preferences", + "files": [ + "com/faceclaw/app/FaceclawCalendarProvider.java", + "com/faceclaw/app/FaceclawLocationProvider.java", + "com/faceclaw/app/FaceclawLocationTracker.java", + "com/faceclaw/app/FaceclawSettings.java", + "com/faceclaw/app/FaceclawSettingsPortReceiver.java", + "com/faceclaw/app/FaceclawResourceUsage.java" + ] + }, + { + "reason": "Android MediaSession, notifications, status icons and wearable services", + "files": [ + "com/faceclaw/app/FaceclawMediaBrowser.java", + "com/faceclaw/app/FaceclawMediaController.java", + "com/faceclaw/app/FaceclawMediaNotificationListenerService.java", + "com/faceclaw/app/FaceclawSystemStatusIconProvider.java", + "com/faceclaw/app/FaceclawWearBridge.java", + "com/faceclaw/app/FaceclawWearListenerService.java" + ] + }, + { + "reason": "Android WebView/JavascriptInterface, package manager and intent integration", + "files": [ + "com/faceclaw/app/FaceclawEvenAppDetector.java", + "com/faceclaw/app/FaceclawEvenHubDocumentStart.java", + "com/faceclaw/app/FaceclawEvenHubJsBridge.java", + "com/faceclaw/app/FaceclawEvenHubWebView.java", + "com/faceclaw/app/FaceclawEvenHubWebViewClient.java", + "com/faceclaw/app/FaceclawEvenHubWebViewHost.java" + ] + }, + { + "reason": "Android AudioRecord/AudioTrack/MediaCodec, Handler delivery and JNI speech/model engines", + "files": [ + "com/faceclaw/app/AndroidNoiseEffects.java", + "com/faceclaw/app/FaceclawAudioTranscoder.java", + "com/faceclaw/app/FaceclawCaptionEngine.java", + "com/faceclaw/app/FaceclawDiarizer.java", + "com/faceclaw/app/FaceclawLc3Decoder.java", + "com/faceclaw/app/FaceclawLlamaRunner.java", + "com/faceclaw/app/FaceclawSpeakerId.java", + "com/faceclaw/app/FaceclawVoiceController.java" + ] + }, + { + "reason": "Android SQLite persistence and cursor/content APIs", + "files": [ + "com/faceclaw/app/FaceclawConversationStore.java" + ] + }, + { + "reason": "Android OkHttp backend, Handler/Log delivery, download lifecycle", + "files": [ + "com/faceclaw/app/FaceclawHttp.java", + "com/faceclaw/app/FaceclawModelDownloader.java", + "com/faceclaw/app/FaceclawSseRequest.java", + "com/faceclaw/app/FaceclawWebSocket.java" + ] + }, + { + "reason": "Android Bitmap/Canvas/Paint/typeface, SVG rasterization and camera scanning", + "files": [ + "com/faceclaw/app/FontFileRenderer.java", + "com/faceclaw/app/IconRenderer.java", + "com/faceclaw/app/ImageFileLoader.java", + "com/faceclaw/app/PreviewBitmapUtil.java", + "com/faceclaw/app/FaceclawQrScanner.java" + ] + }, + { + "reason": "Android preview/UI delivery and app-scoped export paths; codecs/composition are shared", + "files": [ + "com/faceclaw/app/FaceclawPreviewCompositor.java", + "com/faceclaw/app/GifScreenRecorder.java", + "com/faceclaw/app/ScreenshotUtil.java" + ] + }, + { + "reason": "Android elapsedRealtime, worker wait/notify and Context-backed trace export", + "files": [ + "com/faceclaw/app/FrameTimings.java", + "com/faceclaw/app/util/InterruptibleSleep.java" + ] + }, + { + "reason": "Vendored sherpa-onnx JNI ABI: Java classes/fields are consumed by the Android native library; iOS uses its native engine APIs.", + "files": [ + "com/k2fsa/sherpa/onnx/FastClusteringConfig.java", + "com/k2fsa/sherpa/onnx/FeatureConfig.java", + "com/k2fsa/sherpa/onnx/HomophoneReplacerConfig.java", + "com/k2fsa/sherpa/onnx/OfflineModelConfig.java", + "com/k2fsa/sherpa/onnx/OfflineMoonshineModelConfig.java", + "com/k2fsa/sherpa/onnx/OfflineRecognizer.java", + "com/k2fsa/sherpa/onnx/OfflineRecognizerConfig.java", + "com/k2fsa/sherpa/onnx/OfflineRecognizerResult.java", + "com/k2fsa/sherpa/onnx/OfflineSpeakerDiarization.java", + "com/k2fsa/sherpa/onnx/OfflineSpeakerDiarizationCallback.java", + "com/k2fsa/sherpa/onnx/OfflineSpeakerDiarizationConfig.java", + "com/k2fsa/sherpa/onnx/OfflineSpeakerDiarizationSegment.java", + "com/k2fsa/sherpa/onnx/OfflineSpeakerSegmentationModelConfig.java", + "com/k2fsa/sherpa/onnx/OfflineSpeakerSegmentationPyannoteModelConfig.java", + "com/k2fsa/sherpa/onnx/OfflineStream.java", + "com/k2fsa/sherpa/onnx/OfflineWhisperModelConfig.java", + "com/k2fsa/sherpa/onnx/OnlineStream.java", + "com/k2fsa/sherpa/onnx/QnnConfig.java", + "com/k2fsa/sherpa/onnx/SpeakerEmbeddingExtractor.java", + "com/k2fsa/sherpa/onnx/SpeakerEmbeddingExtractorConfig.java", + "com/k2fsa/sherpa/onnx/SpeakerEmbeddingManager.java" + ] + } +] diff --git a/native/kotlin/build.gradle.kts b/native/kotlin/build.gradle.kts new file mode 100644 index 00000000..fca20d61 --- /dev/null +++ b/native/kotlin/build.gradle.kts @@ -0,0 +1,4 @@ +plugins { + kotlin("multiplatform") version "2.4.20" apply false + id("com.android.kotlin.multiplatform.library") version "8.13.2" apply false +} diff --git a/native/kotlin/migrated-java-sources.json b/native/kotlin/migrated-java-sources.json new file mode 100644 index 00000000..2342cdf2 --- /dev/null +++ b/native/kotlin/migrated-java-sources.json @@ -0,0 +1,198 @@ +[ + { + "java": "com/faceclaw/app/LvglFontFile.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/graphics/LvglFontFile.kt" + }, + { + "java": "com/faceclaw/app/FaceclawAlarmListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawAlarmListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawAmbientLightListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawAmbientLightListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawAudioPacketListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawAudioPacketListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawBleCommunicatorListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawBleCommunicatorListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawBleListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawBleListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawCaptionEngineListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawCaptionEngineListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawCompassListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawCompassListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawDeviceDiscoveryListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawDeviceDiscoveryListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawDeviceInfoProbeListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawDeviceInfoProbeListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawEvenHubListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawEvenHubListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawFirmwareFlasherListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawFirmwareFlasherListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawFlashPromptListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawFlashPromptListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawImuListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawImuListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawLlamaListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawLlamaListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawLocationListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawLocationListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawLocationTrackerListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawLocationTrackerListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawMediaBrowserListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawMediaBrowserListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawMediaControllerListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawMediaControllerListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawMicStatusListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawMicStatusListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawModelDownloaderListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawModelDownloaderListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawNoiseSuppressor.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/audio/FaceclawNoiseSuppressor.kt" + }, + { + "java": "com/faceclaw/app/FaceclawNotificationListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawNotificationListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawQrScannerListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawQrScannerListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawRingEventDecoder.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/FaceclawRingEventDecoder.kt" + }, + { + "java": "com/faceclaw/app/FaceclawSettingsListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawSettingsListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawSseListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawSseListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawVoiceControllerListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawVoiceControllerListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawWearListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawWearListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawWebSocketListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawWebSocketListener.kt" + }, + { + "java": "com/faceclaw/app/FwGlyphAtlas.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/graphics/FwGlyphAtlas.kt" + }, + { + "java": "com/faceclaw/app/g2protocol/BleImageOptimizer.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/BleImageOptimizer.kt" + }, + { + "java": "com/faceclaw/app/g2protocol/BleMagicPool.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/BleMagicPool.kt" + }, + { + "java": "com/faceclaw/app/g2protocol/BleProtocol.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/BleProtocol.kt" + }, + { + "java": "com/faceclaw/app/g2protocol/CfwMessageWindow.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/CfwMessageWindow.kt" + }, + { + "java": "com/faceclaw/app/g2protocol/CfwTransport.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/CfwTransport.kt" + }, + { + "java": "com/faceclaw/app/g2protocol/ConnectionOptions.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/ConnectionOptions.kt" + }, + { + "java": "com/faceclaw/app/g2protocol/G2Event.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/G2Event.kt" + }, + { + "java": "com/faceclaw/app/g2protocol/MessageBuilder.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/MessageBuilder.kt" + }, + { + "java": "com/faceclaw/app/g2protocol/OutboundMessage.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/OutboundMessage.kt" + }, + { + "java": "com/faceclaw/app/g2protocol/TextureCacheState.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/TextureCacheState.kt" + }, + { + "java": "com/faceclaw/app/g2protocol/TexturePlanner.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/TexturePlanner.kt" + }, + { + "java": "com/faceclaw/app/GlyphAtlas.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/graphics/GlyphAtlas.kt" + }, + { + "java": "com/faceclaw/app/ImageAtlas.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/graphics/ImageAtlas.kt" + }, + { + "java": "com/faceclaw/app/SurfaceCompositor.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/graphics/SurfaceCompositor.kt" + }, + { + "java": "com/faceclaw/app/util/BmpUtil.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/util/BmpUtil.kt" + }, + { + "java": "com/faceclaw/app/util/CollectionUtils.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/util/CollectionUtils.kt" + }, + { + "java": "com/faceclaw/app/FaceclawFirmwareUtil.java", + "kotlin": "shared/src/androidMain/kotlin/com/faceclaw/app/FaceclawFirmwareUtil.kt" + }, + { + "java": "com/faceclaw/app/FaceclawWavRecorder.java", + "kotlin": "shared/src/androidMain/kotlin/com/faceclaw/app/FaceclawWavRecorder.kt" + } +] diff --git a/native/kotlin/plugin/index.js b/native/kotlin/plugin/index.js new file mode 100644 index 00000000..6e600195 --- /dev/null +++ b/native/kotlin/plugin/index.js @@ -0,0 +1 @@ +// Native APIs are exposed by NativeScript's platform metadata. diff --git a/native/kotlin/plugin/package.json b/native/kotlin/plugin/package.json new file mode 100644 index 00000000..0ed01162 --- /dev/null +++ b/native/kotlin/plugin/package.json @@ -0,0 +1,7 @@ +{ + "name": "@faceclaw/kotlin", + "version": "0.1.0", + "private": true, + "main": "index.js", + "nativescript": { "platforms": { "android": "9.1.1", "ios": "9.0.3" } } +} diff --git a/native/kotlin/settings.gradle.kts b/native/kotlin/settings.gradle.kts new file mode 100644 index 00000000..b1c53109 --- /dev/null +++ b/native/kotlin/settings.gradle.kts @@ -0,0 +1,4 @@ +pluginManagement { repositories { google(); mavenCentral(); gradlePluginPortal() } } +dependencyResolutionManagement { repositories { google(); mavenCentral() } } +rootProject.name = "FaceclawKotlin" +include(":shared") diff --git a/native/kotlin/shared/build.gradle.kts b/native/kotlin/shared/build.gradle.kts new file mode 100644 index 00000000..cdcf1f87 --- /dev/null +++ b/native/kotlin/shared/build.gradle.kts @@ -0,0 +1,25 @@ +import org.jetbrains.kotlin.gradle.dsl.JvmTarget +import org.jetbrains.kotlin.gradle.plugin.mpp.apple.XCFramework + +plugins { + kotlin("multiplatform") + id("com.android.kotlin.multiplatform.library") +} +kotlin { + android { + namespace = "com.faceclaw.shared" + compileSdk = 35 + minSdk = 24 + compilerOptions { jvmTarget.set(JvmTarget.JVM_17) } + withHostTestBuilder {}.configure {} + } + val framework = XCFramework("FaceclawKit") + listOf(iosArm64(), iosSimulatorArm64()).forEach { target -> + target.binaries.framework { + baseName = "FaceclawKit" + isStatic = true + binaryOption("bundleId", "com.faceclaw.shared") + framework.add(this) + } + } +} diff --git a/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/AndroidByteReader.kt b/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/AndroidByteReader.kt new file mode 100644 index 00000000..cd9e6710 --- /dev/null +++ b/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/AndroidByteReader.kt @@ -0,0 +1,20 @@ +package com.faceclaw.app + +import java.nio.ByteBuffer + +/** NativeScript's ArrayBuffer-backed ByteBuffer stays on the JVM side. */ +class AndroidByteReader(buffer: ByteBuffer) : ByteReader() { + // NativeScript can reuse the same ByteBuffer for an ArrayBuffer. Reading one + // frame must not advance the cursor used by a later atlas/preview crossing. + private val buffer = buffer.duplicate() + override fun remaining(): Int = buffer.remaining() + + override fun get(): Byte = buffer.get() + + override fun get(index: Int): Byte = buffer.get(index) + + override fun get(bytes: ByteArray, offset: Int, length: Int): ByteReader { + buffer.get(bytes, offset, length) + return this + } +} diff --git a/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/FaceclawFirmwareUtil.kt b/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/FaceclawFirmwareUtil.kt new file mode 100644 index 00000000..79b5f3a1 --- /dev/null +++ b/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/FaceclawFirmwareUtil.kt @@ -0,0 +1,31 @@ +package com.faceclaw.app + +import java.io.FileOutputStream +import java.nio.ByteBuffer +import java.security.MessageDigest + +/** Android's bulk ByteBuffer boundary avoids per-byte NativeScript crossings. */ +object FaceclawFirmwareUtil { + @JvmStatic fun bytesToHex(bytes: ByteArray?): String = BinaryEncoding.bytesToHex(bytes) + + @JvmStatic + fun sha256Hex(data: ByteBuffer): String { + val digest = MessageDigest.getInstance("SHA-256") + digest.update(data.duplicate()) + return bytesToHex(digest.digest()) + } + + @JvmStatic + fun writeFile(path: String, data: ByteBuffer) { + try { + FileOutputStream(path).use { file -> + file.channel.use { channel -> + val view = data.duplicate() + while (view.hasRemaining()) channel.write(view) + } + } + } catch (e: java.io.IOException) { + throw RuntimeException("firmware write failed: ${e.message}", e) + } + } +} diff --git a/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/FaceclawWavRecorder.kt b/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/FaceclawWavRecorder.kt new file mode 100644 index 00000000..8e0d8482 --- /dev/null +++ b/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/FaceclawWavRecorder.kt @@ -0,0 +1,72 @@ +package com.faceclaw.app + +import android.util.Log +import java.io.File +import java.io.IOException +import java.io.RandomAccessFile + +/** Android streaming file adapter; the PCM/WAV format is shared Kotlin. */ +class FaceclawWavRecorder +@Throws(IOException::class) +constructor( + private val path: String, + private val sampleRate: Int, + private val channels: Int, +) { + private var file: RandomAccessFile? + private var dataBytes = 0L + + init { + val parent = File(path).parentFile + if (parent != null && !parent.exists() && !parent.mkdirs()) + throw IOException("could not create $parent") + file = + RandomAccessFile(path, "rw").also { + it.setLength(0) + it.write(BinaryEncoding.wavHeader(0, sampleRate, channels)) + } + } + + @Synchronized + fun append(pcm16le: ByteArray?) { + val current = file ?: return + if (pcm16le == null || pcm16le.isEmpty()) return + try { + current.write(pcm16le) + dataBytes += pcm16le.size + } catch (e: IOException) { + Log.w("FaceclawWavRecorder", "append failed", e) + } + } + + @Synchronized fun getDurationMs(): Long = dataBytes * 1000L / (sampleRate * channels * 2L) + + fun getPath(): String = path + + @Synchronized + fun finish(): Long { + val current = file ?: return dataBytes + file = null + try { + current.use { + it.seek(0) + it.write( + BinaryEncoding.wavHeader( + minOf(dataBytes, Int.MAX_VALUE.toLong()).toInt(), + sampleRate, + channels, + ) + ) + } + } catch (e: IOException) { + Log.w("FaceclawWavRecorder", "finish failed", e) + } + return dataBytes + } + + @Synchronized + fun discard() { + finish() + File(path).delete() + } +} diff --git a/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/PlatformServices.android.kt b/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/PlatformServices.android.kt new file mode 100644 index 00000000..9aa0f905 --- /dev/null +++ b/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/PlatformServices.android.kt @@ -0,0 +1,41 @@ +package com.faceclaw.app + +internal actual fun protocolPlatform(): ProtocolPlatform = AndroidProtocolPlatform + +internal actual fun readFileData(path: String): ByteArray { + val file = java.io.File(path) + require(file.isFile && file.canRead() && file.length() <= Int.MAX_VALUE) + return file.readBytes() +} + +internal actual fun deflateData(bytes: ByteArray): ByteArray { + val encoder = java.util.zip.Deflater() + try { + encoder.setInput(bytes) + encoder.finish() + val out = ByteSink() + val buffer = ByteArray(8192) + while (!encoder.finished()) out.write(buffer, 0, encoder.deflate(buffer)) + return out.toByteArray() + } finally { + encoder.end() + } +} + +internal actual fun inflateData(bytes: ByteArray, size: Int): ByteArray { + val decoder = java.util.zip.Inflater() + try { + decoder.setInput(bytes) + val result = ByteArray(size) + var offset = 0 + while (offset < size && !decoder.finished()) { + val count = decoder.inflate(result, offset, size - offset) + if (count == 0) break + offset += count + } + check(offset == size) { "recorded frame truncated: $offset of $size" } + return result + } finally { + decoder.end() + } +} diff --git a/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/g2protocol/AndroidProtocolPlatform.kt b/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/g2protocol/AndroidProtocolPlatform.kt new file mode 100644 index 00000000..b5667e1d --- /dev/null +++ b/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/g2protocol/AndroidProtocolPlatform.kt @@ -0,0 +1,48 @@ +package com.faceclaw.app + +import android.bluetooth.BluetoothGattCharacteristic +import android.os.SystemClock +import java.io.ByteArrayOutputStream +import java.util.concurrent.locks.ReentrantLock +import java.util.zip.Deflater + +object AndroidProtocolPlatform : ProtocolPlatform { + override fun elapsedRealtimeMs(): Long = SystemClock.elapsedRealtime() + + override fun createLock(): ProtocolLock = + object : ProtocolLock { + private val lock = ReentrantLock() + + override fun lock() = lock.lock() + + override fun unlock() = lock.unlock() + } + + override fun createDeflater(): ProtocolDeflater = AndroidDeflater() + + @JvmStatic + fun writeType(mode: GattWriteMode): Int = + when (mode) { + GattWriteMode.WITH_RESPONSE -> BluetoothGattCharacteristic.WRITE_TYPE_DEFAULT + GattWriteMode.WITHOUT_RESPONSE -> BluetoothGattCharacteristic.WRITE_TYPE_NO_RESPONSE + } +} + +private class AndroidDeflater : ProtocolDeflater { + private val deflater = Deflater() + + override fun reset() = deflater.reset() + + override fun syncFlush(message: ByteArray): ByteArray { + deflater.setInput(message) + val out = ByteArrayOutputStream() + val chunk = ByteArray(4096) + do { + val count = deflater.deflate(chunk, 0, chunk.size, Deflater.SYNC_FLUSH) + out.write(chunk, 0, count) + } while (count == chunk.size) + return out.toByteArray() + } + + override fun close() = deflater.end() +} diff --git a/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/shared/PlatformInfo.android.kt b/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/shared/PlatformInfo.android.kt new file mode 100644 index 00000000..08e3fbdd --- /dev/null +++ b/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/shared/PlatformInfo.android.kt @@ -0,0 +1,11 @@ +package com.faceclaw.shared + +import android.os.Looper + +internal actual object PlatformInfo { + actual val name: String = "Android" + + actual fun threadName(): String = Thread.currentThread().name + + actual fun isMainThread(): Boolean = Looper.myLooper() == Looper.getMainLooper() +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/PlatformServices.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/PlatformServices.kt new file mode 100644 index 00000000..9d0f0dca --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/PlatformServices.kt @@ -0,0 +1,10 @@ +package com.faceclaw.app + +/** Platform selection happens at compilation; protocol algorithms stay shared. */ +internal expect fun protocolPlatform(): ProtocolPlatform + +internal expect fun deflateData(bytes: ByteArray): ByteArray + +internal expect fun inflateData(bytes: ByteArray, size: Int): ByteArray + +internal expect fun readFileData(path: String): ByteArray diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/audio/FaceclawNoiseSuppressor.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/audio/FaceclawNoiseSuppressor.kt new file mode 100644 index 00000000..db247853 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/audio/FaceclawNoiseSuppressor.kt @@ -0,0 +1,263 @@ +package com.faceclaw.app + +import kotlin.math.roundToInt + +/** + * Spectral suppression for PCM from glasses microphones: 16 ms sqrt-Hann frames at 50% overlap, + * asymmetric noise-floor tracking and a smoothed Wiener gain. Android capture-session effects live + * in AndroidNoiseEffects. This processor has no platform dependencies and must be owned by a single + * audio worker. + */ +class FaceclawNoiseSuppressor { + companion object { + private const val FFT_SIZE: Int = 256 + + private val HOP: Int = (FFT_SIZE / 2) + + private val OVERSUBTRACTION: Float = 1.6f + + /** About -16 dB of residual: keeps the noise bed natural instead of gated. */ + private val GAIN_FLOOR: Float = 0.15f + + private val GAIN_SMOOTHING: Float = 0.6f + + /** Frames of pure noise-floor learning after start/reset (~100 ms). */ + private const val NOISE_WARMUP_FRAMES: Int = 12 + + /** In-place iterative radix-2 FFT (inverse includes the 1/N scale). */ + private fun fft(re: FloatArray, im: FloatArray, inverse: Boolean): Unit { + var n: Int = re.size + run { + var i: Int = 1 + var j: Int = 0 + while ((i < n)) { + var bit: Int = (n shr 1) + run { + while (((j and bit) != 0)) { + j = (j xor bit) + bit = (bit shr 1) + } + } + j = (j xor bit) + if ((i < j)) { + var t: Float = re[i] + re[i] = re[j] + re[j] = t + t = im[i] + im[i] = im[j] + im[j] = t + } + i++ + } + } + run { + var len: Int = 2 + while ((len <= n)) { + var ang: Double = (((2 * kotlin.math.PI) / len) * (if (inverse) 1 else -1)) + var wRe: Float = (kotlin.math.cos(ang)).toFloat() + var wIm: Float = (kotlin.math.sin(ang)).toFloat() + run { + var i: Int = 0 + while ((i < n)) { + var curRe: Float = 1f + var curIm: Float = 0f + run { + var k: Int = 0 + while ((k < (len / 2))) { + var a: Int = (i + k) + var b: Int = (a + (len / 2)) + var xr: Float = ((re[b] * curRe) - (im[b] * curIm)) + var xi: Float = ((re[b] * curIm) + (im[b] * curRe)) + re[b] = (re[a] - xr) + im[b] = (im[a] - xi) + re[a] += xr + im[a] += xi + var nextRe: Float = ((curRe * wRe) - (curIm * wIm)) + curIm = ((curRe * wIm) + (curIm * wRe)) + curRe = nextRe + k++ + } + } + i += len + } + } + len = (len shl 1) + } + } + if (inverse) { + run { + var i: Int = 0 + while ((i < n)) { + re[i] /= n + im[i] /= n + i++ + } + } + } + } + } + + private val sampleRate: Int + + private val window: FloatArray = FloatArray(FFT_SIZE) + + private val history: FloatArray = FloatArray(FFT_SIZE) + + private val overlap: FloatArray = FloatArray(HOP) + + private val noise: FloatArray = FloatArray(((FFT_SIZE / 2) + 1)) + + private val gain: FloatArray = FloatArray(((FFT_SIZE / 2) + 1)) + + private val re: FloatArray = FloatArray(FFT_SIZE) + + private val im: FloatArray = FloatArray(FFT_SIZE) + + private val pending: ShortArray = ShortArray(HOP) + + private var pendingCount: Int = 0 + + private var warmupFrames: Int = 0 + + constructor(sampleRate: Int) { + this.sampleRate = sampleRate + run { + var i: Int = 0 + while ((i < FFT_SIZE)) { + window[i] = (kotlin.math.sin(((kotlin.math.PI * (i + 0.5)) / FFT_SIZE))).toFloat() + i++ + } + } + reset() + } + + fun getSampleRate(): Int { + return sampleRate + } + + /** Forget the learned noise floor (e.g. after the suppressor was toggled off). */ + fun reset(): Unit { + history.fill(0f) + overlap.fill(0f) + noise.fill(0f) + gain.fill(1f) + pendingCount = 0 + warmupFrames = 0 + } + + /** + * Suppress noise in 16-bit little-endian mono PCM. Streaming: input not filling a whole 8 ms + * hop is carried into the next call, so the output may be up to one hop shorter than the input + * (and longer on a later call); total latency is one hop. + */ + fun process(pcm16le: ByteArray?): ByteArray? { + if (((pcm16le == null) || (pcm16le.size < 2))) { + return pcm16le + } + var sampleCount: Int = (pcm16le.size / 2) + var hops: Int = ((pendingCount + sampleCount) / HOP) + var out: ByteArray = ByteArray(((hops * HOP) * 2)) + var outPos: Int = 0 + var inPos: Int = 0 + while ((inPos < sampleCount)) { + var take: Int = minOf((HOP - pendingCount), (sampleCount - inPos)) + run { + var i: Int = 0 + while ((i < take)) { + var lo: Int = (pcm16le[((inPos + i) * 2)] and 0xff) + var hi: Int = pcm16le[(((inPos + i) * 2) + 1)].toInt() + pending[(pendingCount + i)] = (((hi shl 8) or lo)).toShort() + i++ + } + } + pendingCount += take + inPos += take + if ((pendingCount == HOP)) { + outPos = processHop(out, outPos) + pendingCount = 0 + } + } + return out + } + + private fun processHop(out: ByteArray, outPos: Int): Int { + var outPos = outPos + history.copyInto(history, 0, HOP, HOP + (FFT_SIZE - HOP)) + run { + var i: Int = 0 + while ((i < HOP)) { + history[((FFT_SIZE - HOP) + i)] = (pending[i] / 32768f) + i++ + } + } + run { + var i: Int = 0 + while ((i < FFT_SIZE)) { + re[i] = (history[i] * window[i]) + im[i] = 0f + i++ + } + } + fft(re, im, false) + var warming: Boolean = (warmupFrames < NOISE_WARMUP_FRAMES) + if (warming) { + warmupFrames++ + } + run { + var b: Int = 0 + while ((b <= (FFT_SIZE / 2))) { + var power: Float = ((re[b] * re[b]) + (im[b] * im[b])) + if (warming) { + noise[b] = + (if ((warmupFrames == 1)) power + else (noise[b] + ((power - noise[b]) / warmupFrames))) + } else { + if ((power < noise[b])) { + noise[b] += ((power - noise[b]) * 0.2f) + } else { + noise[b] = minOf(power, ((noise[b] * 1.006f) + 1e-10f)) + } + } + var clean: Float = (power - (OVERSUBTRACTION * noise[b])) + var g: Float = (if ((clean > 0f)) (clean / power) else 0f) + if ((g < GAIN_FLOOR)) { + g = GAIN_FLOOR + } + g = ((GAIN_SMOOTHING * gain[b]) + ((1f - GAIN_SMOOTHING) * g)) + gain[b] = g + re[b] *= g + im[b] *= g + if (((b > 0) && (b < (FFT_SIZE / 2)))) { + re[(FFT_SIZE - b)] *= g + im[(FFT_SIZE - b)] *= g + } + b++ + } + } + fft(re, im, true) + run { + var i: Int = 0 + while ((i < HOP)) { + var value: Float = ((overlap[i] + (re[i] * window[i])) * 32767f) + var sample: Int = value.roundToInt() + if ((sample > 32767)) { + sample = 32767 + } + if ((sample < -32768)) { + sample = -32768 + } + out[(outPos + (i * 2))] = ((sample and 0xff)).toByte() + out[((outPos + (i * 2)) + 1)] = (((sample shr 8) and 0xff)).toByte() + i++ + } + } + run { + var i: Int = 0 + while ((i < HOP)) { + overlap[i] = (re[(HOP + i)] * window[(HOP + i)]) + i++ + } + } + return (outPos + (HOP * 2)) + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawAlarmListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawAlarmListener.kt new file mode 100644 index 00000000..63bcd1c4 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawAlarmListener.kt @@ -0,0 +1,6 @@ +package com.faceclaw.app + +/** Phone-side alarm actions (dismiss / snooze), delivered to the JS engine; implemented in JS. */ +interface FaceclawAlarmListener { + fun onPhoneAction(id: Long, action: String?, minutes: Int): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawAmbientLightListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawAmbientLightListener.kt new file mode 100644 index 00000000..edf3cddd --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawAmbientLightListener.kt @@ -0,0 +1,10 @@ +package com.faceclaw.app + +interface FaceclawAmbientLightListener { + /** + * A CFW ambient-light report (settings-channel field 105) from the master temple. body is the + * raw 24-byte ['A','L',ver,reason,...] record; it is decoded on the TS side + * (app/native/ambient-light.ts). + */ + fun onAmbientLight(body: ByteArray?): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawAudioPacketListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawAudioPacketListener.kt new file mode 100644 index 00000000..fb5364eb --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawAudioPacketListener.kt @@ -0,0 +1,5 @@ +package com.faceclaw.app + +interface FaceclawAudioPacketListener { + fun onAudioPacket(data: ByteArray?, arm: String?, arrivalMs: Long): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawBleCommunicatorListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawBleCommunicatorListener.kt new file mode 100644 index 00000000..59a79b07 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawBleCommunicatorListener.kt @@ -0,0 +1,37 @@ +package com.faceclaw.app + +interface FaceclawBleCommunicatorListener { + fun onLog(line: String?): Unit + + fun onStateChange(phase: String?, status: String?): Unit + + fun onRingEvent( + kind: String?, + containerName: String?, + eventType: Int, + eventSource: Int, + systemExitReasonCode: Int, + frameId: Int, + ): Unit + + fun onBatteryState( + headsetBattery: Int, + headsetCharging: Int, + ringBattery: Int, + ringCharging: Int, + ): Unit + + fun onSilentMode(silent: Boolean): Unit + + fun onWearState(wearing: Boolean): Unit + + fun onPhoneLockState(locked: Boolean): Unit + + fun onEvenAppConflict(message: String?): Unit + + fun onFrameMetrics(paintMs: Int, transmitMs: Int, tileCount: Int): Unit + + fun onFrameFinished(frameId: Int, outcome: String?): Unit + + fun onFirmwareInfo(leftVersion: String?, rightVersion: String?, extension: String?): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawBleListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawBleListener.kt new file mode 100644 index 00000000..ed676588 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawBleListener.kt @@ -0,0 +1,7 @@ +package com.faceclaw.app + +interface FaceclawBleListener { + fun onNotification(address: String?, characteristicUuid: String?, data: ByteArray?): Unit + + fun onConnectionStateChange(address: String?, connected: Boolean): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawCaptionEngineListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawCaptionEngineListener.kt new file mode 100644 index 00000000..857492de --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawCaptionEngineListener.kt @@ -0,0 +1,22 @@ +package com.faceclaw.app + +interface FaceclawCaptionEngineListener { + /** + * One finished utterance. text may be empty when no ASR model is loaded or recognition produced + * nothing; embedding is the L2-normalized voice-print or null when the speaker model is + * unavailable or the utterance was too short. startMs/endMs are on the engine's sample clock + * (milliseconds of audio since start()). + */ + fun onUtterance( + text: String?, + embedding: FloatArray?, + startMs: Long, + endMs: Long, + peakRms: Double, + ): Unit + + /** A speech onset was detected; the utterance is now being collected. */ + fun onSpeechStart(startMs: Long): Unit + + fun onStatus(status: String?): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawCompassListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawCompassListener.kt new file mode 100644 index 00000000..b9f3b3d2 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawCompassListener.kt @@ -0,0 +1,14 @@ +package com.faceclaw.app + +/** Receives stock compass heading and calibration notifications on the thread that subscribed. */ +interface FaceclawCompassListener { + fun onCompassEvent( + command: Int, + headingDegrees: Int, + magneticAccuracy: Int, + magneticAnomalies: Int, + orientationSource: Int, + diagnosticFlags: Int, + sampleTimeMs: Long, + ): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawDeviceDiscoveryListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawDeviceDiscoveryListener.kt new file mode 100644 index 00000000..b2a6137f --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawDeviceDiscoveryListener.kt @@ -0,0 +1,17 @@ +package com.faceclaw.app + +/** Callbacks from FaceclawDeviceDiscovery's live scan to the TypeScript layer. */ +interface FaceclawDeviceDiscoveryListener { + /** + * One advertisement (or one bonded device) as a JSON object: {address, name, manufacturerData + * (hex, company id included), rssi|null, txPower|null, connectable|null, bonded, source, + * seenAtMs}. Protocol decoding happens in TypeScript (see app/g2/even-advertisement.ts). + */ + fun onAdvertisement(json: String?): Unit + + /** The platform refused to start or continue the scan. */ + fun onScanFailed(errorCode: Int, message: String?): Unit + + /** Diagnostic line for the pairing log. */ + fun onLog(line: String?): Unit +} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawDeviceInfoProbeListener.java b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawDeviceInfoProbeListener.kt similarity index 52% rename from App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawDeviceInfoProbeListener.java rename to native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawDeviceInfoProbeListener.kt index fe02f55d..19ec10ad 100644 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawDeviceInfoProbeListener.java +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawDeviceInfoProbeListener.kt @@ -1,15 +1,15 @@ -package com.faceclaw.app; +package com.faceclaw.app /** Callbacks from FaceclawDeviceInfoProbe to the TypeScript layer. */ -public interface FaceclawDeviceInfoProbeListener { - void onLog(String line); +interface FaceclawDeviceInfoProbeListener { + fun onLog(line: String?): Unit /** Lifecycle: connecting/authenticating for each arm, then querying. */ - void onState(String state, String detail); + fun onState(state: String?, detail: String?): Unit /** Terminal success: firmware versions and the firmware-extension string (empty on stock). */ - void onResult(String leftVersion, String rightVersion, String extension); + fun onResult(leftVersion: String?, rightVersion: String?, extension: String?): Unit /** Terminal failure (couldn't connect or read the version). */ - void onError(String message); + fun onError(message: String?): Unit } diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawEvenHubListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawEvenHubListener.kt new file mode 100644 index 00000000..a1b3ee97 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawEvenHubListener.kt @@ -0,0 +1,18 @@ +package com.faceclaw.app + +/** + * Callbacks from a hosted EvenHub app's WebView to the TypeScript host. All methods are delivered + * on the Android main thread (NativeScript's JS thread), regardless of which WebView-internal + * thread produced them. + */ +interface FaceclawEvenHubListener { + /** + * The app invoked window.flutter_inappwebview.callHandler(handlerName, ...args). argsJson is + * the JSON-encoded argument array; callId identifies the promise to resolve via + * window.__fcResolve(callId, ok, value). + */ + fun onEvenAppMessage(handlerName: String?, argsJson: String?, callId: Int): Unit + + /** The WebView finished loading the app's page. */ + fun onPageFinished(url: String?): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawFirmwareFlasherListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawFirmwareFlasherListener.kt new file mode 100644 index 00000000..a918fc37 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawFirmwareFlasherListener.kt @@ -0,0 +1,30 @@ +package com.faceclaw.app + +/** Callbacks from FaceclawFirmwareFlasher to the TypeScript layer. */ +interface FaceclawFirmwareFlasherListener { + fun onLog(line: String?): Unit + + /** + * Fine-grained progress for the UI bar. `lens` is "left"/"right"; component/block indices are + * 1-based against their counts. `bytesSent` / `bytesTotal` cover the whole lens image, so a bar + * driven by them moves evenly even though the components differ wildly in size. + */ + fun onProgress( + lens: String?, + componentIndex: Int, + componentCount: Int, + blockIndex: Int, + blockCount: Int, + bytesSent: Long, + bytesTotal: Long, + ): Unit + + /** + * Coarse lifecycle. `state` is one of: validating, connecting, flashing, rebooting, done, + * error. `detail` carries the lens name or a message. + */ + fun onState(state: String?, detail: String?): Unit + + /** Terminal callback: success or failure, with an explanatory message. */ + fun onComplete(success: Boolean, detail: String?): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawFlashPromptListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawFlashPromptListener.kt new file mode 100644 index 00000000..04dc0531 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawFlashPromptListener.kt @@ -0,0 +1,25 @@ +package com.faceclaw.app + +/** Callbacks from FaceclawFlashPromptCommunicator to the TypeScript layer. */ +interface FaceclawFlashPromptListener { + fun onLog(line: String?): Unit + + /** + * Lifecycle updates. `state` is one of: connecting, connected, prompting, battery, result, + * cancelled, timeout, disconnected, error. `detail` carries the "approved"/"declined" text for + * result, or an error/explanation message. + */ + fun onState(state: String?, detail: String?): Unit + + /** + * Battery percent of each arm, read after the user approved (or right after auth when the + * prompt is skipped); -1 when an arm didn't answer. Always fires before onResult(true). + */ + fun onBattery(rightPercent: Int, leftPercent: Int): Unit + + /** + * Fires once the user picks a menu row (or, with skipPrompt, once the battery is read): true = + * flash, false = cancel. + */ + fun onResult(approved: Boolean): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawImuListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawImuListener.kt new file mode 100644 index 00000000..3dd17667 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawImuListener.kt @@ -0,0 +1,9 @@ +package com.faceclaw.app + +/** + * Receives IMU (accelerometer) readings decoded from the glasses' sys-event stream. Registered on + * FaceclawBleCommunicator via addImuListener; callbacks are delivered on the Android main thread. + */ +interface FaceclawImuListener { + fun onImuData(x: Double, y: Double, z: Double, eventSource: Int): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawLlamaListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawLlamaListener.kt new file mode 100644 index 00000000..31027dd7 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawLlamaListener.kt @@ -0,0 +1,16 @@ +package com.faceclaw.app + +/** + * Callbacks for one on-phone LLM generation. Like the other bridge listeners, implementations are + * typically created on the NativeScript JS thread and FaceclawLlamaRunner posts these callbacks + * back to that thread's Looper. + */ +interface FaceclawLlamaListener { + /** A piece of generated text (may be a partial word). */ + fun onToken(piece: String?): Unit + + /** Generation finished: "stop" (EOG), "length", or "cancelled". */ + fun onDone(stopReason: String?): Unit + + fun onError(message: String?): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawLocationListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawLocationListener.kt new file mode 100644 index 00000000..f74ac723 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawLocationListener.kt @@ -0,0 +1,13 @@ +package com.faceclaw.app + +/** One-shot Android location callbacks for the TypeScript Weather bridge. */ +interface FaceclawLocationListener { + fun onLocation( + latitude: Double, + longitude: Double, + accuracyMeters: Float, + timestampMs: Long, + ): Unit + + fun onError(message: String?): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawLocationTrackerListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawLocationTrackerListener.kt new file mode 100644 index 00000000..488dc09a --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawLocationTrackerListener.kt @@ -0,0 +1,19 @@ +package com.faceclaw.app + +/** Continuous location callbacks for the TypeScript navigation bridge. */ +interface FaceclawLocationTrackerListener { + /** + * A new fix. bearingDeg/speedMps are -1 when the fix doesn't carry them (common when + * stationary); accuracyMeters is -1 when unknown. + */ + fun onLocation( + latitude: Double, + longitude: Double, + accuracyMeters: Float, + bearingDeg: Float, + speedMps: Float, + timestampMs: Long, + ): Unit + + fun onError(message: String?): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawMediaBrowserListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawMediaBrowserListener.kt new file mode 100644 index 00000000..f71b6b2d --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawMediaBrowserListener.kt @@ -0,0 +1,10 @@ +package com.faceclaw.app + +interface FaceclawMediaBrowserListener { + fun onConnectResult(requestId: Int, connected: Boolean, rootId: String?, error: String?): Unit + + fun onBrowseResult(requestId: Int, childrenJson: String?, error: String?): Unit + + /** The service connection dropped after connecting (player crashed or was killed). */ + fun onDisconnected(): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawMediaControllerListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawMediaControllerListener.kt new file mode 100644 index 00000000..8b887dae --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawMediaControllerListener.kt @@ -0,0 +1,23 @@ +package com.faceclaw.app + +interface FaceclawMediaControllerListener { + /** All observed session owners, before filtering or choosing the active player. */ + fun onSessionAppsChanged(appsJson: String?): Unit + + fun onStateChange( + playbackState: String?, + packageName: String?, + appName: String?, + title: String?, + artist: String?, + album: String?, + positionMs: Long, + durationMs: Long, + playbackSpeed: Float, + canPlayPause: Boolean, + canSkipNext: Boolean, + canSkipPrevious: Boolean, + accessEnabled: Boolean, + status: String?, + ): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawMicStatusListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawMicStatusListener.kt new file mode 100644 index 00000000..da9cd687 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawMicStatusListener.kt @@ -0,0 +1,10 @@ +package com.faceclaw.app + +interface FaceclawMicStatusListener { + /** + * A CFW mic_control field-104 status record from one temple. body is the raw 21-byte + * ['M','C',ver,...] record (decoded on the TS side); arm is "L" or "R" for the temple's own BLE + * link, "?" if unmatched. + */ + fun onMicStatus(body: ByteArray?, arm: String?): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawModelDownloaderListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawModelDownloaderListener.kt new file mode 100644 index 00000000..f2811569 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawModelDownloaderListener.kt @@ -0,0 +1,11 @@ +package com.faceclaw.app + +/** Progress callbacks for FaceclawModelDownloader, posted to the creating thread's Looper. */ +interface FaceclawModelDownloaderListener { + fun onProgress(bytesDownloaded: Long, totalBytes: Long): Unit + + /** The file is fully downloaded, verified, and moved to its final path. */ + fun onDone(path: String?): Unit + + fun onError(message: String?): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawNotificationListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawNotificationListener.kt new file mode 100644 index 00000000..35cf0523 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawNotificationListener.kt @@ -0,0 +1,5 @@ +package com.faceclaw.app + +interface FaceclawNotificationListener { + fun onNotificationPosted(key: String?): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawQrScannerListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawQrScannerListener.kt new file mode 100644 index 00000000..60a2f29d --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawQrScannerListener.kt @@ -0,0 +1,10 @@ +package com.faceclaw.app + +/** Callbacks for one FaceclawQrScanner.scan; exactly one method fires. */ +interface FaceclawQrScannerListener { + fun onResult(text: String?): Unit + + fun onCancelled(): Unit + + fun onError(message: String?): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawSettingsListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawSettingsListener.kt new file mode 100644 index 00000000..d453a8ac --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawSettingsListener.kt @@ -0,0 +1,6 @@ +package com.faceclaw.app + +/** Change-notification callback for FaceclawSettings; implemented in JS. */ +interface FaceclawSettingsListener { + fun onSettingChanged(key: String?): Unit +} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawSseListener.java b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawSseListener.kt similarity index 65% rename from App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawSseListener.java rename to native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawSseListener.kt index 8780d601..fde0d60a 100644 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawSseListener.java +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawSseListener.kt @@ -1,13 +1,16 @@ -package com.faceclaw.app; +package com.faceclaw.app /** Callbacks for FaceclawSseRequest, delivered on the constructing thread's Looper. */ -public interface FaceclawSseListener { +interface FaceclawSseListener { /** One line of a successful (2xx) streaming response body, without the newline. */ - void onLine(String line); + fun onLine(line: String?): Unit + /** The server answered with a non-2xx status; body is the full error body. */ - void onHttpError(int code, String body); + fun onHttpError(code: Int, body: String?): Unit + /** The 2xx response body ended normally. */ - void onComplete(); + fun onComplete(): Unit + /** Network-level failure (connect, TLS, mid-stream drop). Not called after cancel(). */ - void onFailure(String message); + fun onFailure(message: String?): Unit } diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawVoiceControllerListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawVoiceControllerListener.kt new file mode 100644 index 00000000..e3b4fd75 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawVoiceControllerListener.kt @@ -0,0 +1,44 @@ +package com.faceclaw.app + +interface FaceclawVoiceControllerListener { + fun onStatus(status: String?): Unit + + /** + * Best transcript of the current utterance so far. REPLACE semantics: text is the complete + * transcript, not a delta — display it verbatim, replacing any previous partial. isFinal marks + * the end of the utterance. + */ + fun onTranscript(text: String?, isFinal: Boolean): Unit + + /** Capture has finished, after the final transcript or a startup/recognition error. */ + fun onStopped(captureId: Int): Unit + + /** + * Decoded microphone audio: 16 kHz mono signed 16-bit little-endian PCM. Emitted in every mode + * so raw-PCM consumers (levels, recording, captions) keep working while the onboard recognizer + * owns the transcript. + */ + fun onPcm(pcm16le: ByteArray?): Unit + + /** + * Per-packet DSP metadata the glasses firmware appends to each 50 ms audio packet, computed on + * the raw stereo capture before its mono downmix: the direction-of-arrival in signed degrees (0 + * = straight ahead, positive to the wearer's right) and a signal-strength ratio that serves as + * a confidence/energy proxy for the angle. + */ + fun onFrameMeta(angleDegrees: Int, ssr: Int): Unit + + /** + * The speaker stopped, in a hands-free session that has no button release to end it. Only fires + * when endpointing was enabled for the session; see FaceclawVoiceController.setEndpointing. + */ + fun onSpeechEnd(): Unit + + /** + * Result of speaker verification against the enrolled wearer voice-print, emitted once per + * capture session just before the final transcript. Only fires when verification was configured + * for the session; fails open (isWearer=true) when the utterance was too short to verify or the + * speaker model could not be loaded. + */ + fun onSpeakerVerified(isWearer: Boolean, similarity: Float): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawWearListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawWearListener.kt new file mode 100644 index 00000000..420865ee --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawWearListener.kt @@ -0,0 +1,17 @@ +package com.faceclaw.app + +/** + * Callbacks from the Android Wear (Wear OS) bridge; implemented in JS. Every call is delivered on + * the thread that registered the listener (see FaceclawWearBridge.setListener). + */ +interface FaceclawWearListener { + /** + * A message from the watch app. `path` is the Data Layer message path (e.g. "/faceclaw/input"); + * `json` is the UTF-8 payload (always a JSON object, "{}" when the watch sent none); `nodeId` + * identifies the watch so a reply can be addressed to it. + */ + fun onMessage(path: String?, json: String?, nodeId: String?): Unit + + /** The set of reachable watches running the Faceclaw watch app changed. */ + fun onWatchConnection(reachable: Boolean, watchName: String?): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawWebSocketListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawWebSocketListener.kt new file mode 100644 index 00000000..b613f7e1 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawWebSocketListener.kt @@ -0,0 +1,12 @@ +package com.faceclaw.app + +/** Callbacks for FaceclawWebSocket, delivered on the Android main thread. */ +interface FaceclawWebSocketListener { + fun onOpen(): Unit + + fun onTextMessage(message: String?): Unit + + fun onClosed(code: Int, reason: String?): Unit + + fun onFailure(message: String?): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/BleImageOptimizer.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/BleImageOptimizer.kt new file mode 100644 index 00000000..c2fa50a0 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/BleImageOptimizer.kt @@ -0,0 +1,735 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmField +import kotlin.jvm.JvmStatic + +class BleImageOptimizer { + companion object { + private const val TAG: String = "BleImageOptimizer" + + /** + * Split an image into fragments (packets), taking advantage of the fact that each packet + * can declare a logical size longer than its byte payload to get free trailing + * zero-padding. + * + * Each fragment's logical size stays within maxFragmentSize, while trailing zeros inside + * that span can be omitted from the payload. + */ + @JvmStatic + fun planImageFragments( + bmp: ByteArray, + maxFragmentSize: Int, + ): MutableList { + return planImageFragments(bmp, maxFragmentSize, false) + } + + @JvmStatic + fun planImageFragments( + bmp: ByteArray?, + maxFragmentSize: Int, + reserveFinalByte: Boolean, + ): MutableList { + if (((bmp == null) || (bmp.size == 0))) { + return mutableListOf(BleProtocol.ImageFragment(0, ByteArray(0), 0)) + } + if ((maxFragmentSize <= 0)) { + throw IllegalArgumentException("maxFragmentSize must be positive") + } + val bulkLength: Int = (if (reserveFinalByte) (bmp.size - 1) else bmp.size) + val fragmentCount: Int = + ((((bulkLength + maxFragmentSize) - 1) / maxFragmentSize) + + (if ((bulkLength < bmp.size)) 1 else 0)) + val fragments: MutableList = ArrayList(fragmentCount) + run { + var index: Int = 0 + while (((index * maxFragmentSize) < bulkLength)) { + var start: Int = (index * maxFragmentSize) + var end: Int = minOf((start + maxFragmentSize), bulkLength) + fragments.add(buildFragment(index, bmp, start, end)) + index++ + } + } + if ((bulkLength < bmp.size)) { + fragments.add( + BleProtocol.ImageFragment( + fragments.size, + bmp.copyOfRange(bulkLength, bmp.size), + (bmp.size - bulkLength), + ) + ) + } + + return fragments + } + + private fun buildFragment( + index: Int, + bmp: ByteArray, + start: Int, + end: Int, + ): BleProtocol.ImageFragment { + var dataEnd: Int = end + while (((dataEnd > start) && (bmp[(dataEnd - 1)].toInt() == 0))) { + dataEnd -= 1 + } + if ((dataEnd == start)) { + return BleProtocol.ImageFragment(index, ByteArray(0), (end - start)) + } + return BleProtocol.ImageFragment(index, bmp.copyOfRange(start, dataEnd), (end - start)) + } + + @JvmStatic + fun buildIncrementalImagePayload( + previous: ByteArray?, + next: ByteArray?, + width: Int, + height: Int, + frameId: Int, + ): IncrementalPlan? { + var stride: Int = ((width + 1) shr 1) + if ( + ((((((width <= 0) || (height <= 0)) || (previous == null)) || (next == null)) || + (previous.size != (stride * height))) || (next.size != (stride * height))) + ) { + return null + } + var minByteX: Int = stride + var maxByteX: Int = -1 + var minY: Int = height + var maxY: Int = -1 + var changedBytes: Int = 0 + var columnChanged: BooleanArray = BooleanArray(stride) + run { + var y: Int = 0 + while ((y < height)) { + var rowOffset: Int = (y * stride) + run { + var x: Int = 0 + while ((x < stride)) { + if ((previous[(rowOffset + x)] != next[(rowOffset + x)])) { + changedBytes++ + columnChanged[x] = true + if ((x < minByteX)) { + minByteX = x + } + if ((x > maxByteX)) { + maxByteX = x + } + if ((y < minY)) { + minY = y + } + maxY = y + } + x++ + } + } + y++ + } + } + if ((maxY < 0)) { + return null + } + var clusterCount: Int = 0 + var inCluster: Boolean = false + run { + var x: Int = minByteX + while ((x <= maxByteX)) { + if (columnChanged[x]) { + if (!inCluster) { + clusterCount++ + } + inCluster = true + } else { + inCluster = false + } + x++ + } + } + var left: Int = ((minByteX * 2) and 3.inv()) + var rightExclusive: Int = minOf(width, ((((maxByteX + 1) * 2) + 3) and 3.inv())) + var top: Int = (minY and 1.inv()) + var bottomExclusive: Int = minOf(height, ((maxY + 2) and 1.inv())) + var boxWidth: Int = (rightExclusive - left) + var boxHeight: Int = (bottomExclusive - top) + if (((boxWidth >= width) && (boxHeight >= height))) { + return null + } + var out: ByteArray = + encodeMode3Rect(next, stride, left, top, boxWidth, boxHeight, frameId) + return IncrementalPlan(out, changedBytes, ((boxWidth shr 1) * boxHeight), clusterCount) + } + + /** + * The aligned changed bounding box between two same-size packed frames, or null when they + * are identical: pixel-space {left, top, width, height} with left/width multiples of 4 and + * top/height multiples of 2 (mode-3 header quantization). Exposed so the texture-cache + * planner can reuse the exact rect geometry the single-bbox path would send. + */ + @JvmStatic + fun computeChangedBox( + previous: ByteArray?, + next: ByteArray?, + width: Int, + height: Int, + ): IntArray? { + var stride: Int = ((width + 1) shr 1) + if ( + ((((((width <= 0) || (height <= 0)) || (previous == null)) || (next == null)) || + (previous.size != (stride * height))) || (next.size != (stride * height))) + ) { + return null + } + var minByteX: Int = stride + var maxByteX: Int = -1 + var minY: Int = height + var maxY: Int = -1 + run { + var y: Int = 0 + while ((y < height)) { + var rowOffset: Int = (y * stride) + run { + var x: Int = 0 + while ((x < stride)) { + if ((previous[(rowOffset + x)] != next[(rowOffset + x)])) { + if ((x < minByteX)) { + minByteX = x + } + if ((x > maxByteX)) { + maxByteX = x + } + if ((y < minY)) { + minY = y + } + maxY = y + } + x++ + } + } + y++ + } + } + if ((maxY < 0)) { + return null + } + var left: Int = ((minByteX * 2) and 3.inv()) + var rightExclusive: Int = minOf(width, ((((maxByteX + 1) * 2) + 3) and 3.inv())) + var top: Int = (minY and 1.inv()) + var bottomExclusive: Int = minOf(height, ((maxY + 2) and 1.inv())) + return intArrayOf(left, top, (rightExclusive - left), (bottomExclusive - top)) + } + + /** + * The multi-rect split of the changed region (see computeSplitRects), or null when it is + * one region / too fragmented / the frames aren't comparable. Exposed for the texture-cache + * planner. + */ + @JvmStatic + fun computeChangedRects( + previous: ByteArray?, + next: ByteArray?, + width: Int, + height: Int, + maxRects: Int, + ): MutableList? { + var stride: Int = ((width + 1) shr 1) + if ( + ((((((width <= 0) || (height <= 0)) || (previous == null)) || (next == null)) || + (previous.size != (stride * height))) || (next.size != (stride * height))) + ) { + return null + } + var rects: MutableList? = + computeSplitRects(previous, next, stride, width, height, maxRects) + return (if (((rects == null) || (rects.size < 2))) null else rects) + } + + /** + * Encode one CFW mode-3 rectangle delta: + * [3][left/4][top/2][width/4][height/2][fid_lo][fid_hi][rle(box pixels)] left/width must be + * multiples of 4 (=> left>>1, width>>1 are whole bytes), top/ height multiples of 2. The + * box pixels are top-down rows of `next` (4bpp packed, width>>1 bytes/row), run-length + * encoded before deflate. Shared by the single-bbox path, each rect of a mode-8 multi-rect + * batch, and the texture-cache planner. + */ + @JvmStatic + fun encodeMode3Rect( + next: ByteArray, + stride: Int, + left: Int, + top: Int, + boxWidth: Int, + boxHeight: Int, + fid: Int, + ): ByteArray { + var regionStride: Int = (boxWidth shr 1) + var region: ByteArray = ByteArray((regionStride * boxHeight)) + run { + var y: Int = 0 + while ((y < boxHeight)) { + next.copyInto( + region, + (y * regionStride), + (((top + y) * stride) + (left shr 1)), + (((top + y) * stride) + (left shr 1)) + regionStride, + ) + y++ + } + } + var compressed: ByteArray = rleEncode(region) + var out: ByteArray = ByteArray((7 + compressed.size)) + out[0] = 3 + out[1] = ((left / 4)).toByte() + out[2] = ((top / 2)).toByte() + out[3] = ((boxWidth / 4)).toByte() + out[4] = ((boxHeight / 2)).toByte() + out[5] = ((fid and 0xff)).toByte() + out[6] = (((fid shr 8) and 0xff)).toByte() + compressed.copyInto(out, 7, 0, 0 + compressed.size) + return out + } + + /** A full repaint in independently decodable commands below the uint16 record limit. */ + @JvmStatic + fun encodeFullFrameBands( + packed: ByteArray, + width: Int, + height: Int, + firstFid: Int, + ): MutableList { + if ( + (((((((width <= 0) || (width > 640)) || ((width and 3) != 0)) || (height <= 0)) || + (height > 480)) || ((height and 1) != 0)) || + (packed.size != ((width * height) / 2))) + ) { + throw IllegalArgumentException("unsupported custom framebuffer dimensions") + } + var commands: MutableList = ArrayList() + var fid: Int = firstFid + run { + var top: Int = 0 + while ((top < height)) { + commands.add( + encodeMode3Rect( + packed, + (width / 2), + 0, + top, + width, + minOf(64, (height - top)), + fid, + ) + ) + fid = (if ((fid >= 0xfffe)) 1 else (fid + 1)) + top += 64 + } + } + return commands + } + + private const val MULTI_RECT_V_GAP_ROWS: Int = 4 + + private const val MULTI_RECT_H_GAP_BYTES: Int = 6 + + /** + * Build a mode-8 multi-rect payload for the change between two same-size 4bpp frames, + * assigning consecutive frame ids starting at fidStart (each rect needs a distinct fid — + * the CFW skips duplicate fids). Returns null when the change is a single region (use the + * single-rect path), when it fragments past maxRects, or when the frames aren't comparable. + */ + @JvmStatic + fun buildMultiRectImagePayload( + previous: ByteArray?, + next: ByteArray?, + width: Int, + height: Int, + fidStart: Int, + maxRects: Int, + ): MultiRectPlan? { + var stride: Int = ((width + 1) shr 1) + if ( + ((((((width <= 0) || (height <= 0)) || (previous == null)) || (next == null)) || + (previous.size != (stride * height))) || (next.size != (stride * height))) + ) { + return null + } + var rects: MutableList? = + computeSplitRects(previous, next, stride, width, height, maxRects) + if (((rects == null) || (rects.size < 2))) { + return null + } + var subs: MutableList = ArrayList(rects.size) + var coveredBytes: Int = 0 + var fid: Int = fidStart + var total: Int = 2 + for (r in rects) { + var sub: ByteArray = encodeMode3Rect(next, stride, r[0], r[1], r[2], r[3], fid) + subs.add(sub) + coveredBytes += ((r[2] shr 1) * r[3]) + total += (2 + sub.size) + fid = (if ((fid >= 0xfffe)) 1 else (fid + 1)) + } + var out: ByteArray = ByteArray(total) + out[0] = 8 + out[1] = (rects.size).toByte() + var pos: Int = 2 + for (sub in subs) { + out[pos] = ((sub.size and 0xff)).toByte() + out[(pos + 1)] = (((sub.size shr 8) and 0xff)).toByte() + pos += 2 + sub.copyInto(out, pos, 0, 0 + sub.size) + pos += sub.size + } + return MultiRectPlan(out, rects.size, coveredBytes, fid) + } + + /** + * Split the changed region between two packed 4bpp frames into a small set of aligned + * rectangles that together cover every changed pixel: maximal vertical bands of changed + * rows (merging gaps < V_GAP), each split into horizontal column clusters (merging gaps < + * H_GAP), with each cluster's rows tightened to where it actually changes. Rects are + * pixel-space {left,top,width,height}, left/width aligned to 4px and top/height to 2px. + * Returns null if there's no change or the split exceeds maxRects (caller falls back to a + * single bounding box). + */ + private fun computeSplitRects( + previous: ByteArray, + next: ByteArray, + stride: Int, + width: Int, + height: Int, + maxRects: Int, + ): MutableList? { + var rowChanged: BooleanArray = BooleanArray(height) + var anyChange: Boolean = false + run { + var y: Int = 0 + while ((y < height)) { + var off: Int = (y * stride) + run { + var x: Int = 0 + while ((x < stride)) { + if ((previous[(off + x)] != next[(off + x)])) { + rowChanged[y] = true + anyChange = true + break + } + x++ + } + } + y++ + } + } + if (!anyChange) { + return null + } + var rects: MutableList = ArrayList() + var col: BooleanArray = BooleanArray(stride) + var y: Int = 0 + while ((y < height)) { + if (!rowChanged[y]) { + y++ + continue + } + var bandTop: Int = y + var bandBot: Int = y + var cur: Int = (y + 1) + while ((cur < height)) { + if (rowChanged[cur]) { + bandBot = cur + cur++ + continue + } + var g: Int = cur + while (((g < height) && !rowChanged[g])) { + g++ + } + if (((g < height) && ((g - cur) < MULTI_RECT_V_GAP_ROWS))) { + cur = g + } else { + break + } + } + col.fill(false) + run { + var yy: Int = bandTop + while ((yy <= bandBot)) { + if (!rowChanged[yy]) { + yy++ + continue + } + var off: Int = (yy * stride) + run { + var x: Int = 0 + while ((x < stride)) { + if ((previous[(off + x)] != next[(off + x)])) { + col[x] = true + } + x++ + } + } + yy++ + } + } + var x: Int = 0 + while ((x < stride)) { + if (!col[x]) { + x++ + continue + } + var cL: Int = x + var cR: Int = x + var cx: Int = (x + 1) + while ((cx < stride)) { + if (col[cx]) { + cR = cx + cx++ + continue + } + var g: Int = cx + while (((g < stride) && !col[g])) { + g++ + } + if (((g < stride) && ((g - cx) < MULTI_RECT_H_GAP_BYTES))) { + cx = g + } else { + break + } + } + var tTop: Int = height + var tBot: Int = -1 + run { + var yy: Int = bandTop + while ((yy <= bandBot)) { + if (!rowChanged[yy]) { + yy++ + continue + } + var off: Int = (yy * stride) + run { + var xx: Int = cL + while ((xx <= cR)) { + if ((previous[(off + xx)] != next[(off + xx)])) { + if ((yy < tTop)) { + tTop = yy + } + tBot = yy + break + } + xx++ + } + } + yy++ + } + } + if ((tBot >= 0)) { + var left: Int = ((cL * 2) and 3.inv()) + var rightExclusive: Int = minOf(width, ((((cR + 1) * 2) + 3) and 3.inv())) + var top: Int = (tTop and 1.inv()) + var bottomExclusive: Int = minOf(height, ((tBot + 2) and 1.inv())) + rects.add( + intArrayOf(left, top, (rightExclusive - left), (bottomExclusive - top)) + ) + if ((rects.size > maxRects)) { + return null + } + } + x = (cR + 1) + } + y = (bandBot + 1) + } + return rects + } + + /** + * Run-length encode headerless 4bpp pixels for CFW load_image_z mode 6. Wire format: + * [6][rle(4bpp pixels)]. Always use mode 6: the logical image can be larger than its + * EvenHub carrier, so a raw BMP fallback would carry dimensions the legacy container loader + * cannot accept. + */ + @JvmStatic + fun maybeCompress(packed: ByteArray?, width: Int, height: Int): ByteArray { + if (((packed == null) || (packed.size == 0))) { + return packed ?: ByteArray(0) + } + var z: ByteArray = rleEncode(packed) + var out: ByteArray = ByteArray((z.size + 1)) + out[0] = 6 + z.copyInto(out, 1, 0, 0 + z.size) + return out + } + + /** + * Run-length encode packed 4bpp pixels for CFW modes 3 and 6, whose payload is RLE tokens; + * deflate belongs to the transport. Runs are over the pixel NIBBLES of {@code pix} in wire + * order (high nibble = left pixel), including the pad nibble that ends each row at odd + * widths — i.e. {@code pix} read as 2*length nibbles. One token is: + *
+         *   [cnt4|color4]                 cnt 1..15
+         *   [0|color4][cnt8]              cnt 1..255
+         *   [0|color4][0][cntLo][cntHi]   cnt 1..65535, little-endian
+         * 
+ * with the low nibble always the color; runs longer than 65535 split across tokens. Worst + * case (every nibble its own run) is exactly one byte per nibble, which is what the buffer + * is sized for. + */ + @JvmStatic + fun rleEncode(pix: ByteArray): ByteArray { + var n: Int = (pix.size * 2) + var out: ByteArray = ByteArray(n) + var o: Int = 0 + var i: Int = 0 + while ((i < n)) { + var v: Int = nibbleAt(pix, i) + var j: Int = (i + 1) + while (((j < n) && (nibbleAt(pix, j) == v))) { + j++ + } + var run: Int = (j - i) + while ((run > 0)) { + var c: Int = minOf(run, 0xffff) + if ((c <= 15)) { + out[o++] = (((c shl 4) or v)).toByte() + } else { + if ((c <= 255)) { + out[o++] = (v).toByte() + out[o++] = (c).toByte() + } else { + out[o++] = (v).toByte() + out[o++] = 0 + out[o++] = ((c and 0xff)).toByte() + out[o++] = ((c shr 8)).toByte() + } + } + run -= c + } + i = j + } + return out.copyOf(o) + } + + private fun nibbleAt(pix: ByteArray, i: Int): Int { + var b: Int = (pix[(i shr 1)] and 0xff) + return (if (((i and 1) != 0)) (b and 0x0f) else (b shr 4)) + } + } + + constructor() {} + + class TileImagePlan { + @JvmField val tileIndex: Int + + @JvmField val tile: BleProtocol.ImageTileOptions + + @JvmField val packed: ByteArray? + + @JvmField val width: Int + + @JvmField val height: Int + + @JvmField val payload: ByteArray + + @JvmField val sessionId: Int + + @JvmField var fragments: MutableList = mutableListOf() + + constructor( + tileIndex: Int, + tile: BleProtocol.ImageTileOptions, + packed: ByteArray?, + width: Int, + height: Int, + sessionId: Int, + ) { + this.tileIndex = tileIndex + this.tile = tile + this.packed = (if ((packed == null)) ByteArray(0) else packed) + this.width = width + this.height = height + this.payload = maybeCompress(this.packed, width, height) + this.sessionId = sessionId + } + + constructor( + tileIndex: Int, + tile: BleProtocol.ImageTileOptions, + packed: ByteArray?, + width: Int, + height: Int, + sessionId: Int, + payloadOverride: ByteArray, + ) { + this.tileIndex = tileIndex + this.tile = tile + this.packed = (if ((packed == null)) ByteArray(0) else packed) + this.width = width + this.height = height + this.payload = payloadOverride + this.sessionId = sessionId + } + } + + /** + * A mode-3 incremental payload plus diagnostics about how tightly the bounding box fit the + * actual change. {@code changedBytes} is how many packed bytes actually differ; {@code + * boxBytes} is how many the box sends. A large box with few changed bytes / multiple clusters + * means distant small edits were merged into one oversized box (which can spill past the + * fragment size into an extra serialized BLE message). + */ + class IncrementalPlan { + @JvmField val payload: ByteArray + + @JvmField val changedBytes: Int + + @JvmField val boxBytes: Int + + @JvmField val clusterCount: Int + + constructor(payload: ByteArray, changedBytes: Int, boxBytes: Int, clusterCount: Int) { + this.payload = payload + this.changedBytes = changedBytes + this.boxBytes = boxBytes + this.clusterCount = clusterCount + } + } + + /** + * A CFW mode-8 multi-segment payload (`[8][count]` then per-rect `[len16][mode-3 submsg]`) + * carrying several tight rectangle deltas instead of one bounding box, plus diagnostics. Each + * rect is applied to the firmware shadow with the panel push deferred, then presented once. + * Used when the change splits into regions whose bounding box wastes bytes (distant edits, or a + * sparse box); the caller falls back to the single-rect path when this returns null or isn't + * smaller. + */ + class MultiRectPlan { + @JvmField val payload: ByteArray + + @JvmField val rectCount: Int + + @JvmField val coveredBytes: Int + + @JvmField val nextFid: Int + + constructor(payload: ByteArray, rectCount: Int, coveredBytes: Int, nextFid: Int) { + this.payload = payload + this.rectCount = rectCount + this.coveredBytes = coveredBytes + this.nextFid = nextFid + } + } + + class ImageUpdateStats { + @JvmField val paintMs: Int + + @JvmField val tileCount: Int + + @JvmField val frameId: Int + + @JvmField var firstWriteStartedAtMs: Long = 0L + + constructor(paintMs: Int, tileCount: Int, frameId: Int) { + this.paintMs = maxOf(0, paintMs) + this.tileCount = tileCount + this.frameId = frameId + } + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/BleMagicPool.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/BleMagicPool.kt new file mode 100644 index 00000000..354ff1c1 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/BleMagicPool.kt @@ -0,0 +1,43 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmField + +/** + * Allocates one-byte message identifiers in LRU order. Release records survive reuse so the + * communicator can diagnose late ACKs after a timeout. + */ +class BleMagicPool(private val platform: ProtocolPlatform) { + companion object { + const val MIN_MAGIC = 100 + const val MAX_MAGIC = 255 + } + + private val lock = platform.createLock() + private val available = ArrayDeque((MIN_MAGIC..MAX_MAGIC).toList()) + private val allocated = BooleanArray(256) + private val releaseRecords = mutableMapOf() + + fun allocate(): Int = lock.withLock { + check(available.isNotEmpty()) { "no BLE magic values available" } + val magic = available.removeFirst() + allocated[magic] = true + magic + } + + fun release(sid: Int, magic: Int, label: String?, reason: String?) = lock.withLock { + if (magic !in MIN_MAGIC..MAX_MAGIC) return@withLock + releaseRecords["$sid:$magic"] = ReleaseRecord(label, reason, platform.elapsedRealtimeMs()) + if (!allocated[magic]) return@withLock + allocated[magic] = false + available.addLast(magic) + } + + fun getReleaseRecord(sid: Int, magic: Int): ReleaseRecord? = lock.withLock { + releaseRecords["$sid:$magic"] + } + + class ReleaseRecord(label: String?, reason: String?, @JvmField val releasedAtMs: Long) { + @JvmField val label: String = label ?: "" + @JvmField val reason: String = reason ?: "" + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/BleProtocol.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/BleProtocol.kt new file mode 100644 index 00000000..4227cdb5 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/BleProtocol.kt @@ -0,0 +1,1480 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmField +import kotlin.jvm.JvmOverloads +import kotlin.jvm.JvmStatic + +/** + * BleProtocol: Functions for generating and parsing messages when speaking to the Even Realities + * G2. Does _not_ include code for actually sending anything; for that, see FaceclawBleCommunicator. + * + * Most message formats are protobufs. For schemas, check g2-kit-unofficial. + */ +class BleProtocol { + companion object { + const val WRITE_CHAR_UUID: String = "00002760-08c2-11e1-9073-0e8ac72e5401" + + const val NOTIFY_CHAR_UUID: String = "00002760-08c2-11e1-9073-0e8ac72e5402" + + const val OTA_DATA_WRITE_UUID: String = "00002760-08c2-11e1-9073-0e8ac72e0001" + + const val OTA_DATA_NOTIFY_UUID: String = "00002760-08c2-11e1-9073-0e8ac72e0002" + + const val RENDER_NOTIFY_UUID: String = "00002760-08c2-11e1-9073-0e8ac72e6402" + + const val R1_PHONE_NOTIFY_CHAR_UUID: String = "bae80011-4f05-4503-8e65-3af1f7329d1f" + + const val R1_NOTIFY_CHAR_UUID: String = "bae80013-4f05-4503-8e65-3af1f7329d1f" + + const val PRELUDE_ACK_SID: Int = 0x01 + + const val PRELUDE_ACK_MAGIC: Int = 156 + + /** + * DEVICE_SETTINGS security-auth channel. Firmware 2.2.9 enforces completing this exchange + * shortly after a GATT connection opens (a ~30 s deadline closes unauthenticated links) and + * gates query responses on it; the message itself exists back to the 2.2.4 era, so sending + * it is safe on all stock versions. See ../notes/ble-connections-2.2.9.md. + */ + const val SID_SECURITY_AUTH: Int = 0x80 + + const val FLAG_SECURITY_AUTH: Int = 0x00 + + private const val SECURITY_AUTH_CMD: Int = 4 + + const val SID_APP_LAUNCH: Int = 0x01 + + const val SID_EVENHUB: Int = 0xe0 + + const val SID_UI_SETTING: Int = 0x09 + + const val SID_STATE_CHANGE: Int = 0x0 + + const val SID_ONBOARDING: Int = 0x10 + + /** G2SettingPackage.commandId for device-initiated pushes (vs. 2 = app read). */ + const val SETTINGS_CMD_DEVICE_SEND_TO_APP: Int = 3 + + const val FACECLAW_WAKE_CONTROL_FIELD: Int = 101 + + const val FACECLAW_WAKE_EVENT_FIELD: Int = 102 + + /** + * CFW mic_control: host writes an [77.toByte(),67.toByte(),ver,op,...] record as settings + * field 103; each temple reports a 21-byte [77.toByte(),67.toByte(),ver,...] status as + * field 104, both appended to settings read responses and as standalone commandId=3 pushes. + */ + const val FACECLAW_MIC_CONTROL_FIELD: Int = 103 + + const val FACECLAW_MIC_STATUS_FIELD: Int = 104 + + /** + * CFW als_sensor: ambient-light reports on settings-channel field 105, 24-byte + * [65.toByte(),76.toByte(),ver,reason,...] records from the master temple (decoded in + * app/native/ambient-light.ts). + */ + const val FACECLAW_ALS_REPORT_FIELD: Int = 105 + + const val FACECLAW_WAKE_OP_ACQUIRE: Int = 1 + + const val FACECLAW_WAKE_OP_RELEASE: Int = 2 + + const val FACECLAW_WAKE_OP_CLAIM: Int = 3 + + const val FACECLAW_WAKE_OP_READY: Int = 4 + + const val FACECLAW_FB_OP_ACQUIRE: Int = 5 + + const val FACECLAW_FB_OP_RELEASE: Int = 6 + + const val FACECLAW_WEAR_OP_QUERY: Int = 7 + + const val CFW_IMAGE_MODE_CLEANUP: Int = 11 + + private const val FACECLAW_WAKE_EVENT: Int = 1 + + const val FACECLAW_WAKE_EVENT_HEAD_UP: Int = 5 + + const val FACECLAW_GESTURE_EVENT_TAP: Int = 2 + + const val FACECLAW_GESTURE_EVENT_LONG_PRESS: Int = 3 + + const val FACECLAW_GESTURE_EVENT_LONG_PRESS_RELEASE: Int = 4 + + private const val FACECLAW_RAW_SOURCE_LEFT_TEMPLE: Int = 0 + + private const val FACECLAW_RAW_SOURCE_RIGHT_TEMPLE: Int = 1 + + private const val FACECLAW_RAW_SOURCE_RING: Int = 4 + + private const val FACECLAW_WAKE_PROTOCOL_VERSION: Int = 1 + + const val SID_EVEN_AI: Int = 0x07 + + const val SID_NAVIGATION: Int = 0x08 + + const val NAV_CMD_COMPASS_CHANGED: Int = 15 + + const val NAV_CMD_COMPASS_CALIBRATION_STARTED: Int = 16 + + const val NAV_CMD_COMPASS_CALIBRATION_COMPLETE: Int = 17 + + const val EVEN_AI_CMD_CTRL: Int = 1 + + const val EVEN_AI_STATUS_WAKE_UP: Int = 1 + + const val EVEN_AI_STATUS_ENTER: Int = 2 + + const val EVEN_AI_STATUS_EXIT: Int = 3 + + const val FLAG_REQUEST: Int = 0x20 + + const val FLAG_NOTIFY: Int = 0x01 + + const val FLAG_NOTIFY_ALT: Int = 0x06 + + const val CMD_AUDIO_CONTROL: Int = 15 + + const val CMD_OPEN_IMU: Int = 19 + + const val EVENT_CLICK: Int = 0 + + const val EVENT_SCROLL_TOP: Int = 1 + + const val EVENT_SCROLL_BOTTOM: Int = 2 + + const val EVENT_DOUBLE_CLICK: Int = 3 + + const val EVENT_FOREGROUND_ENTER: Int = 4 + + const val EVENT_FOREGROUND_EXIT: Int = 5 + + const val EVENT_ABNORMAL_EXIT: Int = 6 + + const val EVENT_SYSTEM_EXIT: Int = 7 + + const val EVENT_IMU_DATA_REPORT: Int = 8 + + const val EVENT_RING_LONG_PRESS: Int = 9 + + const val EVENT_RING_LONG_PRESS_RELEASE: Int = 10 + + const val EVENT_SHORT_THEN_LONG_PRESS: Int = 11 + + const val EVENT_HEAD_UP: Int = 12 + + const val EVENT_SOURCE_GLASSES_R: Int = 1 + + const val EVENT_SOURCE_RING: Int = 2 + + const val EVENT_SOURCE_GLASSES_L: Int = 3 + + const val CCCD_UUID: String = "00002902-0000-1000-8000-00805f9b34fb" + + @JvmField val PRELUDE_F5872_PAYLOAD: ByteArray = buildPreludeF5872Payload() + + @JvmField + val PRELUDE_F5872: ByteArray = + framePb(PRELUDE_F5872_PAYLOAD, SID_APP_LAUNCH, FLAG_REQUEST, 0x92).first() + + private fun buildPreludeF5872Payload(): ByteArray { + var field4: ByteArray = + encodeMessageField( + 3, + encodeMessageField( + 2, + encodeMessageField( + 2, + concat( + CollectionUtils.listOf( + encodeVarintField(1, 0), + encodeVarintField(2, 0), + ) + ), + ), + ), + ) + return concat( + CollectionUtils.listOf( + encodeVarintField(1, 2), + encodeVarintField(2, PRELUDE_ACK_MAGIC), + encodeMessageField(4, field4), + ) + ) + } + + @JvmStatic + @JvmOverloads + fun framePb( + pb: ByteArray, + sid: Int, + flag: Int, + seq: Int, + maxWrite: Int = 240, + ): MutableList { + val chunkSize = minOf(232, maxWrite - 8) + require(chunkSize >= 12) { "Negotiated BLE write size is too small" } + var crc: ByteArray = crcBytesLe(pb) + var totalWithCrc: Int = (pb.size + 2) + var totalFrags: Int = + maxOf(1, (kotlin.math.ceil((totalWithCrc / (chunkSize).toDouble()))).toInt()) + require(totalFrags <= 255) { "Protocol message exceeds the fragment limit" } + var frames: MutableList = ArrayList(totalFrags) + var payload: ByteArray = pb.copyOf(totalWithCrc) + payload[pb.size] = crc[0] + payload[(pb.size + 1)] = crc[1] + run { + var i: Int = 0 + while ((i < totalFrags)) { + var offset: Int = (i * chunkSize) + var chunk: ByteArray = + payload.copyOfRange(offset, minOf((offset + chunkSize), payload.size)) + var frame: ByteArray = ByteArray((8 + chunk.size)) + frame[0] = (0xaa).toByte() + frame[1] = 0x21 + frame[2] = ((seq and 0xff)).toByte() + frame[3] = ((chunk.size and 0xff)).toByte() + frame[4] = ((totalFrags and 0xff)).toByte() + frame[5] = (((i + 1) and 0xff)).toByte() + frame[6] = ((sid and 0xff)).toByte() + frame[7] = ((flag and 0xff)).toByte() + chunk.copyInto(frame, 8, 0, 0 + chunk.size) + frames.add(frame) + i++ + } + } + return frames + } + + /** Retain the text container for forwarded inputs, without an image container. */ + @JvmStatic + fun buildCreateInputPage(magic: Int): ByteArray { + var innerParts: MutableList = ArrayList() + innerParts.add(encodeVarintField(1, 1)) + innerParts.add( + encodeMessageField(3, encodeTextObject("dashboard", 1, 0, 0, 576, 288, " ", true)) + ) + innerParts.add(encodeVarintField(5, 10000)) + var inner: ByteArray = concat(innerParts) + return wrapEvenHub(0, magic, 3, inner) + } + + @JvmStatic + fun buildDashboardTextUpgrade(magic: Int): ByteArray { + var inner: MutableList = ArrayList() + inner.add(encodeVarintField(1, 1)) + inner.add(encodeStringField(2, "dashboard")) + inner.add(encodeVarintField(3, 0)) + inner.add(encodeVarintField(4, 1)) + inner.add(encodeStringField(5, " ")) + return wrapEvenHub(5, magic, 9, concat(inner)) + } + + @JvmStatic + fun buildImageRawData( + tile: ImageTileOptions, + sessionId: Int, + totalSize: Int, + fragment: ImageFragment, + magic: Int, + ): ByteArray { + var inner: MutableList = ArrayList() + inner.add(encodeVarintField(1, tile.containerId)) + inner.add(encodeStringField(2, tile.name)) + inner.add(encodeVarintField(3, tile.containerId)) + inner.add(encodeVarintField(4, totalSize)) + inner.add(encodeVarintField(5, 0)) + inner.add(encodeVarintField(6, fragment.index)) + inner.add(encodeVarintField(7, fragment.size)) + inner.add(encodeBytesField(8, fragment.data)) + return wrapEvenHub(3, magic, 5, concat(inner)) + } + + @JvmStatic + fun buildHeartbeat(magic: Int): ByteArray { + return wrapEvenHub(12, magic, 14, encodeVarintField(1, 0)) + } + + /** + * Cmd=0 CreateStartUpPage carrying a text container (the message) plus a list container + * (the selectable rows) in one page. Uses stock-firmware-safe geometry (each container + * within the stock ~280x130 container-size cap; the CFW is what lifts that to 576x288), so + * this works before flashing. The selected row comes back as an async list event — see + * parseListSelection. + */ + @JvmStatic + fun buildCreatePromptPage( + magic: Int, + textName: String, + textContainerId: Int, + warningText: String, + listName: String, + listContainerId: Int, + items: Array, + ): ByteArray { + var inner: MutableList = ArrayList() + inner.add(encodeVarintField(1, 2)) + inner.add( + encodeMessageField( + 2, + encodeListObject(listName, listContainerId, 0, 150, 280, 120, items, true), + ) + ) + inner.add( + encodeMessageField( + 3, + encodeTextObject(textName, textContainerId, 0, 0, 280, 130, warningText, false), + ) + ) + inner.add(encodeVarintField(5, 10000)) + return wrapEvenHub(0, magic, 3, concat(inner)) + } + + @JvmStatic + fun encodeListObject( + name: String, + containerId: Int, + x: Int, + y: Int, + width: Int, + height: Int, + items: Array, + captureEvents: Boolean, + ): ByteArray { + var parts: MutableList = ArrayList() + parts.add(encodeVarintField(1, x)) + parts.add(encodeVarintField(2, y)) + parts.add(encodeVarintField(3, width)) + parts.add(encodeVarintField(4, height)) + parts.add(encodeVarintField(9, containerId)) + parts.add(encodeStringField(10, name)) + parts.add(encodeMessageField(11, encodeListItemContainer(items))) + if (captureEvents) { + parts.add(encodeVarintField(12, 1)) + } + return concat(parts) + } + + private fun encodeListItemContainer(items: Array): ByteArray { + var parts: MutableList = ArrayList() + parts.add(encodeVarintField(1, items.size)) + parts.add(encodeVarintField(3, 1)) + for (item in items) { + parts.add(encodeStringField(4, item)) + } + return concat(parts) + } + + /** + * Decode a list-selection async event (sid=0xe0, flag=0x01/0x06). Returns null if the frame + * is not a list event. `itemIndex` is 0-based into the ItemName array the list was built + * with; `eventType` is EVENT_CLICK for a confirmed selection (scroll/highlight changes + * arrive with other types). + */ + @JvmStatic + fun parseListSelection(frame: ParsedFrame): ListSelection? { + var pb: ByteArray = stripTrailingCrc(frame.pb) + var deviceEvent: ByteArray? = readFieldBytes(pb, 13) + if ((deviceEvent == null)) { + return null + } + var listEvent: ByteArray? = readFieldBytes(deviceEvent, 1) + if ((listEvent == null)) { + return null + } + return ListSelection( + readStringFieldValue(listEvent, 2), + readStringFieldValue(listEvent, 3), + readVarintFieldValue(listEvent, 4, -1), + readVarintFieldValue(listEvent, 5, EVENT_CLICK), + ) + } + + @JvmStatic + fun buildAudioControl(magic: Int, enable: Boolean): ByteArray { + return wrapEvenHub( + CMD_AUDIO_CONTROL, + magic, + 18, + encodeVarintField(1, (if (enable) 1 else 0)), + ) + } + + @JvmStatic + fun buildShutdown(magic: Int, exitMode: Int): ByteArray { + return wrapEvenHub(9, magic, 11, encodeVarintField(1, exitMode)) + } + + /** + * IMU control (ImuCtrl = field 22 of the main ctx). IMU_CtrlCmd carries IMUReportEn + * (field 1) and reportFrq (field 2). reportFrq is only meaningful when enabling; on disable + * we send just the enable flag. + */ + @JvmStatic + fun buildImuControl(magic: Int, enable: Boolean, reportFrq: Int): ByteArray { + var inner: MutableList = ArrayList() + inner.add(encodeVarintField(1, (if (enable) 1 else 0))) + if ((enable && (reportFrq > 0))) { + inner.add(encodeVarintField(2, reportFrq)) + } + return wrapEvenHub(CMD_OPEN_IMU, magic, 22, concat(inner)) + } + + /** + * Set the lens brightness: G2SettingPackage{commandId=1 (DeviceReceiveInfo), + * deviceReceiveInfoFromApp(3){deviceReceiveBrightness(1){autoAdjust(1), + * brightnessLevel(2)}}} on sid 0x09. brightnessLevel is 0-100 (nonlinear; 0 is + * dim-but-visible, not off). When autoAdjust is set the ambient-light sensor drives + * brightness, so the level field is omitted; otherwise the level is always encoded + * (explicit zero included) so brightnessLevel=0 reaches the wire. + */ + @JvmStatic + fun buildSetBrightness(magic: Int, autoAdjust: Boolean, brightnessLevel: Int): ByteArray { + var brightness: MutableList = ArrayList() + brightness.add(encodeVarintField(1, (if (autoAdjust) 1 else 0))) + if (!autoAdjust) { + brightness.add(encodeVarintField(2, brightnessLevel)) + } + return concat( + CollectionUtils.listOf( + encodeVarintField(1, 1), + encodeVarintField(2, magic), + encodeMessageField(3, encodeMessageField(1, concat(brightness))), + ) + ) + } + + /** Enable the firmware's wear detector (DeviceReceiveInfoFromAPP field 5). */ + @JvmStatic + fun buildSetWearDetection(magic: Int, enabled: Boolean): ByteArray { + var wear: ByteArray = encodeVarintField(1, (if (enabled) 1 else 0)) + return concat( + CollectionUtils.listOf( + encodeVarintField(1, 1), + encodeVarintField(2, magic), + encodeMessageField(3, encodeMessageField(5, wear)), + ) + ) + } + + /** + * The application authentication request: DEVICE_SETTINGS/AUTHENTICATION(4) on sid 0x80, + * flag 0x00. Carries no key material — it arms the firmware's "security auth" flag; the + * firmware sends the success notification once the flag is set AND the BLE link is + * encrypted (SMP pairing/bond restoration, handled by the OS below GATT, possibly after a + * pairing prompt). Protobuf: f1=4 (command), f2=magic, f3={f1=1, f2=4}. + */ + @JvmStatic + fun buildAuthenticationRequest(magic: Int): ByteArray { + var auth: ByteArray = + concat( + CollectionUtils.listOf( + encodeVarintField(1, 1), + encodeVarintField(2, SECURITY_AUTH_CMD), + ) + ) + return concat( + CollectionUtils.listOf( + encodeVarintField(1, SECURITY_AUTH_CMD), + encodeVarintField(2, magic), + encodeMessageField(3, auth), + ) + ) + } + + /** + * True when `pb` (trailing CRC still attached) is the success notification for the + * authentication request sent with `magic`: command 4, the same magic, and an EMPTY field-3 + * result message (`1a 00` — the omitted result code defaults to zero). A GATT write + * completing is NOT success; only this notification is. + */ + @JvmStatic + fun isAuthenticationSuccess(pb: ByteArray?, magic: Int): Boolean { + if ((pb == null)) { + return false + } + var root: ByteArray = stripTrailingCrc(pb) + if ((readVarintFieldValue(root, 1, -1) != SECURITY_AUTH_CMD)) { + return false + } + if ((readVarintFieldValue(root, 2, -1) != magic)) { + return false + } + var result: ByteArray? = readFieldBytes(root, 3) + return ((result != null) && (result.size == 0)) + } + + @JvmStatic + fun buildSettingsQuery(magic: Int): ByteArray { + var request: ByteArray = encodeVarintField(1, 1) + return concat( + CollectionUtils.listOf( + encodeVarintField(1, 2), + encodeVarintField(2, magic), + encodeMessageField(4, request), + ) + ) + } + + /** + * Build the CFW-only wake lease control package. Magic zero deliberately makes this + * fire-and-forget: the firmware consumes field 101 before its stock nanopb decoder discards + * the unknown field. + */ + @JvmStatic + fun buildFaceclawWakeControl(operation: Int, nonce: Int): ByteArray { + var control: ByteArray = + byteArrayOf( + 70.toByte(), + 67.toByte(), + (FACECLAW_WAKE_PROTOCOL_VERSION).toByte(), + (operation).toByte(), + ((nonce and 0xff)).toByte(), + (((nonce ushr 8) and 0xff)).toByte(), + ) + return concat( + CollectionUtils.listOf( + encodeVarintField(1, 1), + encodeVarintField(2, 0), + encodeBytesField(FACECLAW_WAKE_CONTROL_FIELD, control), + ) + ) + } + + /** + * Wrap an already-encoded [77.toByte(),67.toByte(),ver,op,...] mic-control record as a + * settings write carrying CFW field 103. Magic zero makes it fire-and-forget like the wake + * lease: the firmware consumes the field before its stock nanopb decoder discards the + * unknown tag, and the "ack" is the field-104 status notify that follows. + */ + @JvmStatic + fun buildFaceclawMicControl(record: ByteArray): ByteArray { + return concat( + CollectionUtils.listOf( + encodeVarintField(1, 1), + encodeVarintField(2, 0), + encodeBytesField(FACECLAW_MIC_CONTROL_FIELD, record), + ) + ) + } + + /** + * Extract the CFW mic status record (field 104) from a settings frame, or null when absent. + * The 21-byte body layout is decoded on the TS side; here we only validate the + * 77.toByte(),67.toByte(),version prelude. + */ + @JvmStatic + fun parseFaceclawMicStatus(pb: ByteArray?): ByteArray? { + if ((pb == null)) { + return null + } + var body: ByteArray? = readFieldBytes(stripTrailingCrc(pb), FACECLAW_MIC_STATUS_FIELD) + if ( + ((((body == null) || (body.size < 3)) || (body[0].toInt() != 77)) || + (body[1].toInt() != 67)) + ) { + return null + } + return body + } + + /** + * Return the raw CFW ambient-light report from a sid-0x09 frame, or null when this is an + * ordinary settings frame. Only the 65.toByte(),76.toByte(),version prelude is validated + * here; the fields are decoded on the TS side. + */ + @JvmStatic + fun parseFaceclawAlsReport(pb: ByteArray?): ByteArray? { + if ((pb == null)) { + return null + } + var body: ByteArray? = readFieldBytes(stripTrailingCrc(pb), FACECLAW_ALS_REPORT_FIELD) + if ( + (((((body == null) || (body.size < 24)) || (body[0].toInt() != 65)) || + (body[1].toInt() != 76)) || ((body[2] and 0xff) != 1)) + ) { + return null + } + return body + } + + /** Field 106: RB/version 1/flags/percentage, from the CFW ring-battery cache. */ + @JvmStatic + fun parseRingBattery(pb: ByteArray?): RingBatterySnapshot? { + if ((pb == null)) { + return null + } + var body: ByteArray? = readFieldBytes(stripTrailingCrc(pb), 106) + if ( + (((((body == null) || (body.size != 5)) || (body[0].toInt() != 82)) || + (body[1].toInt() != 66)) || (body[2].toInt() != 1)) + ) { + return null + } + var flags: Int = (body[3] and 0xff) + var level: Int = (body[4] and 0xff) + if (((flags and 7.inv()) != 0)) { + return null + } + if (((flags and 2) != 0)) { + if ((((flags and 1) == 0) || (level > 100))) { + return null + } + return RingBatterySnapshot(level, (if (((flags and 4) != 0)) 1 else 0)) + } + if (((level != 255) || ((flags and 4) != 0))) { + return null + } + return RingBatterySnapshot(-1, -1) + } + + /** + * Return the uint16 wake nonce from a CFW field-102 deferred-wake notification (double tap + * or head-up), or -1 when this is an ordinary settings frame (idle-gesture events + * included). + */ + @JvmStatic + fun parseFaceclawWakeEvent(pb: ByteArray): Int { + var event: ByteArray? = faceclawWakeEventBytes(pb) + return (if ((event == null)) -1 + else ((event[4] and 0xff) or ((event[5] and 0xff) shl 8))) + } + + /** + * Which gesture a CFW deferred-wake notification reports: 1 (double tap) or + * FACECLAW_WAKE_EVENT_HEAD_UP; -1 when the frame is not a wake event. + */ + @JvmStatic + fun parseFaceclawWakeEventCode(pb: ByteArray): Int { + var event: ByteArray? = faceclawWakeEventBytes(pb) + return (if ((event == null)) -1 else (event[3] and 0xff)) + } + + private fun faceclawWakeEventBytes(pb: ByteArray?): ByteArray? { + if ((pb == null)) { + return null + } + var event: ByteArray? = readFieldBytes(stripTrailingCrc(pb), FACECLAW_WAKE_EVENT_FIELD) + if ( + (((((event == null) || (event.size != 6)) || (event[0].toInt() != 70)) || + (event[1].toInt() != 67)) || + ((event[2] and 0xff) != FACECLAW_WAKE_PROTOCOL_VERSION)) + ) { + return null + } + var code: Int = (event[3] and 0xff) + return (if (((code == FACECLAW_WAKE_EVENT) || (code == FACECLAW_WAKE_EVENT_HEAD_UP))) + event + else null) + } + + /** + * Decode a CFW field-102 idle-gesture event (tap, long press, release while no app is on + * screen) into the EvenHub sys-event type and source the same gesture would carry from a + * live page, or null when the frame is not one (ordinary settings frames and the double-tap + * wake event included). + */ + @JvmStatic + fun parseFaceclawGestureEvent(pb: ByteArray?): FaceclawGestureEvent? { + if ((pb == null)) { + return null + } + var event: ByteArray? = readFieldBytes(stripTrailingCrc(pb), FACECLAW_WAKE_EVENT_FIELD) + if ( + (((((event == null) || (event.size != 6)) || (event[0].toInt() != 70)) || + (event[1].toInt() != 67)) || + ((event[2] and 0xff) != FACECLAW_WAKE_PROTOCOL_VERSION)) + ) { + return null + } + var eventType: Int + when ((event[3] and 0xff)) { + FACECLAW_GESTURE_EVENT_TAP -> { + eventType = EVENT_CLICK + } + FACECLAW_GESTURE_EVENT_LONG_PRESS -> { + eventType = EVENT_RING_LONG_PRESS + } + FACECLAW_GESTURE_EVENT_LONG_PRESS_RELEASE -> { + eventType = EVENT_RING_LONG_PRESS_RELEASE + } + else -> { + return null + } + } + var eventSource: Int + when ((event[4] and 0xff)) { + FACECLAW_RAW_SOURCE_LEFT_TEMPLE -> { + eventSource = EVENT_SOURCE_GLASSES_L + } + FACECLAW_RAW_SOURCE_RIGHT_TEMPLE -> { + eventSource = EVENT_SOURCE_GLASSES_R + } + FACECLAW_RAW_SOURCE_RING -> { + eventSource = EVENT_SOURCE_RING + } + else -> { + eventSource = 0 + } + } + return FaceclawGestureEvent(eventType, eventSource) + } + + /** + * Decode OnboardingDataPackage EVENT/GLS_WEAR_STATUS. Unlike most async G2 traffic, stock + * firmware sends this event with flag 0x00, so callers must recognize it by sid and + * protobuf shape rather than notify flag. Returns 0/1, or -1 when the frame is not a wear + * event. + */ + @JvmStatic + fun parseWearState(frame: ParsedFrame?): Int { + if ((((frame == null) || !frame.ok) || (frame.sid != SID_ONBOARDING))) { + return -1 + } + var root: ByteArray = stripTrailingCrc(frame.pb) + if ((readVarintFieldValue(root, 1, -1) != 3)) { + return -1 + } + var event: ByteArray? = readFieldBytes(root, 5) + if (((event == null) || (readVarintFieldValue(event, 1, -1) != 1))) { + return -1 + } + var wearStatus: Int = readVarintFieldValue(event, 2, -1) + return (if (((wearStatus == 0) || (wearStatus == 1))) wearStatus else -1) + } + + @JvmStatic + fun parseSettingsBattery(pb: ByteArray): BatterySnapshot? { + var root: ByteArray = stripTrailingCrc(pb) + var request: ByteArray? = readFieldBytes(root, 4) + if ((request == null)) { + return null + } + var battery: Int = readVarintFieldValue(request, 12, -1) + var charging: Int = readVarintFieldValue(request, 13, -1) + var silentMode: Int = readVarintFieldValue(request, 14, -1) + if ((battery < 0)) { + return null + } + return BatterySnapshot(battery, charging, silentMode) + } + + /** + * Silent mode from an unsolicited settings push. The wearer toggles silent mode by + * long-pressing both touchpads at once; the firmware then sends + * G2SettingPackage{commandId=3 (DeviceSendToAPP), deviceSendInfoToApp(5){ + * silentModeSwitch(2)}} on sid 0x09, with a magic it picked itself, so this arrives outside + * the request/ack flow. + * + * Returns -1 when the frame is not such a push. Ordinary settings-read acks (the battery + * poll) carry commandId=2 and deviceReceiveRequestFromApp in field 4, so they never match + * and stay on the normal ack path. + */ + @JvmStatic + fun parseSilentModePush(pb: ByteArray?): Int { + if ((pb == null)) { + return -1 + } + var root: ByteArray = stripTrailingCrc(pb) + if ((readVarintFieldValue(root, 1, -1) != SETTINGS_CMD_DEVICE_SEND_TO_APP)) { + return -1 + } + var info: ByteArray? = readFieldBytes(root, 5) + if ((info == null)) { + return -1 + } + return readVarintFieldValue(info, 2, -1) + } + + /** + * Firmware versions and the firmware-extension string from a settings READ ack. Versions + * are fields 5/6 of the deviceReceiveRequestFromApp submessage (field 4); Faceclaw's custom + * firmware additionally appends top-level field 100 with its revision ("Faceclaw/"; + * older builds sent "EVENCFW/ "), which stock firmware never sends. Returns + * null when the ack carries none of it. Compatibility is judged on the TS side + * (app/g2/firmware-compat.ts); Java only needs to know whether the firmware is ours at all. + */ + @JvmStatic + fun parseSettingsFirmwareInfo(pb: ByteArray): FirmwareInfo? { + var root: ByteArray = stripTrailingCrc(pb) + var request: ByteArray? = readFieldBytes(root, 4) + if ((request == null)) { + return null + } + var leftVersion: String = readStringFieldValue(request, 5) + var rightVersion: String = readStringFieldValue(request, 6) + var extension: String = readStringFieldValue(root, 100) + if (((leftVersion.isEmpty() && rightVersion.isEmpty()) && extension.isEmpty())) { + return null + } + return FirmwareInfo(leftVersion, rightVersion, extension) + } + + @JvmStatic + fun wrapEvenHub(cmd: Int, magic: Int, innerFieldNumber: Int, inner: ByteArray): ByteArray { + var parts: MutableList = ArrayList() + parts.add(encodeVarintField(1, cmd)) + parts.add(encodeVarintField(2, magic)) + parts.add(encodeMessageField(innerFieldNumber, inner)) + return concat(parts) + } + + @JvmStatic + fun encodeTextObject( + name: String, + containerId: Int, + x: Int, + y: Int, + width: Int, + height: Int, + text: String, + captureEvents: Boolean, + ): ByteArray { + var parts: MutableList = ArrayList() + parts.add(encodeVarintField(1, x)) + parts.add(encodeVarintField(2, y)) + parts.add(encodeVarintField(3, width)) + parts.add(encodeVarintField(4, height)) + parts.add(encodeVarintField(9, containerId)) + parts.add(encodeStringField(10, name)) + if (captureEvents) { + parts.add(encodeVarintField(11, 1)) + } + parts.add(encodeStringField(12, text)) + return concat(parts) + } + + @JvmStatic + fun encodeImageObject(tile: ImageTileOptions): ByteArray { + var parts: MutableList = ArrayList() + parts.add(encodeVarintField(1, tile.x)) + parts.add(encodeVarintField(2, tile.y)) + parts.add(encodeVarintField(3, tile.width)) + parts.add(encodeVarintField(4, tile.height)) + parts.add(encodeVarintField(5, tile.containerId)) + parts.add(encodeStringField(6, tile.name)) + return concat(parts) + } + + private fun concat(parts: MutableList): ByteArray { + var out: ByteSink = ByteSink() + for (part in parts) { + if (((part != null) && (part.size > 0))) { + out.write(part, 0, part.size) + } + } + return out.toByteArray() + } + + internal fun encodeVarintField(fieldNumber: Int, value: Int): ByteArray { + return concat(CollectionUtils.listOf(encodeKey(fieldNumber, 0), encodeVarint(value))) + } + + private fun encodeStringField(fieldNumber: Int, value: String?): ByteArray { + var bytes: ByteArray = + (if ((value == null)) ByteArray(0) else value.encodeToByteArray()) + return concat( + CollectionUtils.listOf(encodeKey(fieldNumber, 2), encodeVarint(bytes.size), bytes) + ) + } + + internal fun encodeBytesField(fieldNumber: Int, value: ByteArray?): ByteArray { + var bytes: ByteArray = (if ((value == null)) ByteArray(0) else value) + return concat( + CollectionUtils.listOf(encodeKey(fieldNumber, 2), encodeVarint(bytes.size), bytes) + ) + } + + private fun encodeMessageField(fieldNumber: Int, value: ByteArray?): ByteArray { + var bytes: ByteArray = (if ((value == null)) ByteArray(0) else value) + return concat( + CollectionUtils.listOf(encodeKey(fieldNumber, 2), encodeVarint(bytes.size), bytes) + ) + } + + private fun encodeKey(fieldNumber: Int, wireType: Int): ByteArray { + return encodeVarint(((fieldNumber shl 3) or wireType)) + } + + private fun encodeVarint(value: Int): ByteArray { + var out: ByteSink = ByteSink() + var v: Int = (value ushr 0) + while ((v >= 0x80)) { + out.write(((v and 0x7f) or 0x80)) + v = (v ushr 7) + } + out.write(v) + return out.toByteArray() + } + + private fun crcBytesLe(data: ByteArray): ByteArray { + var crc: Int = 0xffff + for (b in data) { + crc = (crc xor ((b and 0xff) shl 8)) + run { + var i: Int = 0 + while ((i < 8)) { + if (((crc and 0x8000) != 0)) { + crc = (((crc shl 1) xor 0x1021) and 0xffff) + } else { + crc = ((crc shl 1) and 0xffff) + } + i++ + } + } + } + return byteArrayOf(((crc and 0xff)).toByte(), (((crc ushr 8) and 0xff)).toByte()) + } + + /** + * Split one notification value into individual `aa21`/`aa12` envelope frames. A value + * normally holds exactly one frame, but the firmware can pack several (each self-describing + * via the length byte at offset 3), and a frame that only reads the first would silently + * drop the rest. A value that does not start with an envelope, or a trailing partial frame + * (truncated by the stack — observed on a Samsung tablet for values over 64 bytes), is + * returned as-is so the caller can log it. + */ + @JvmStatic + fun splitFrames(value: ByteArray?): MutableList { + var out: MutableList = ArrayList() + if (((value == null) || (value.size == 0))) { + return out + } + var offset: Int = 0 + while ( + ((((offset + 8) <= value.size) && (value[offset] == (0xaa).toByte())) && + ((value[(offset + 1)].toInt() == 0x21) || + (value[(offset + 1)].toInt() == 0x12))) + ) { + var len: Int = (value[(offset + 3)] and 0xff) + var end: Int = minOf(value.size, ((offset + 8) + len)) + out.add(value.copyOfRange(offset, end)) + offset = end + } + if ((offset < value.size)) { + out.add(value.copyOfRange(offset, value.size)) + } + return out + } + + @JvmStatic + fun parseFrame(buf: ByteArray?): ParsedFrame { + if ( + ((((buf == null) || (buf.size < 10)) || (buf[0] != (0xaa).toByte())) || + ((buf[1].toInt() != 0x21) && (buf[1].toInt() != 0x12))) + ) { + return ParsedFrame(false, 0, 0, ByteArray(0), -1, -1) + } + var sid: Int = (buf[6] and 0xff) + var flag: Int = (buf[7] and 0xff) + var len: Int = (buf[3] and 0xff) + var end: Int = minOf(buf.size, (8 + len)) + var pb: ByteArray = buf.copyOfRange(8, end) + var msgType: Int = -1 + var msgSeq: Int = -1 + var offset: Int = 0 + run { + var i: Int = 0 + while (((i < 8) && (offset < pb.size))) { + var key: VarintResult? = readVarint(pb, offset) + if ((key == null)) { + break + } + offset = key.next + var tag: Int = (key.value shr 3) + var wire: Int = (key.value and 7) + if ((wire == 0)) { + var value: VarintResult? = readVarint(pb, offset) + if ((value == null)) { + break + } + if ((tag == 1)) { + msgType = value.value + } else { + if ((tag == 2)) { + msgSeq = value.value + } + } + offset = value.next + } else { + if ((wire == 2)) { + var length: VarintResult? = readVarint(pb, offset) + if ((length == null)) { + break + } + offset = (length.next + length.value) + } else { + break + } + } + if (((msgType >= 0) && (msgSeq >= 0))) { + break + } + i++ + } + } + return ParsedFrame(true, sid, flag, pb, msgType, msgSeq) + } + + @JvmStatic + fun stripTrailingCrc(pb: ByteArray?): ByteArray { + if (((pb == null) || (pb.size < 2))) { + return (if ((pb == null)) ByteArray(0) else pb) + } + return pb.copyOf((pb.size - 2)) + } + + /** Decode the stock firmware's compass navigation notifications (sid 0x08). */ + @JvmStatic + fun parseCompassEvent(frame: ParsedFrame?): CompassEvent? { + if ( + ((((frame == null) || !frame.ok) || (frame.sid != SID_NAVIGATION)) || + ((frame.flag != FLAG_NOTIFY) && (frame.flag != FLAG_NOTIFY_ALT))) + ) { + return null + } + var root: ByteArray = stripTrailingCrc(frame.pb) + var command: Int = readVarintFieldValue(root, 1, -1) + if ((command == NAV_CMD_COMPASS_CHANGED)) { + var compass: ByteArray? = readFieldBytes(root, 10) + if ((compass == null)) { + return null + } + var heading: Int = readVarintFieldValue(compass, 1, -1) + if (((heading < 0) || (heading >= 360))) { + return null + } + var diagnostic: ByteArray? = readFieldBytes(root, 100) + if ( + (((((((((diagnostic != null) && (diagnostic.size == 12)) && + (diagnostic[0].toInt() == 67)) && (diagnostic[1].toInt() == 77)) && + (diagnostic[2].toInt() == 1)) && (diagnostic[7].toInt() == 0)) && + (((diagnostic[3] and 0xff) <= 3) || (diagnostic[3] == (255).toByte()))) && + (((diagnostic[4] and 0xff) <= 2) || (diagnostic[4] == (255).toByte()))) && + ((diagnostic[5] and 0xff) <= 3)) + ) { + var sampleTimeMs: Long = 0 + run { + var i: Int = 0 + while ((i < 4)) { + sampleTimeMs = + (sampleTimeMs or + (((diagnostic[(8 + i)] and 0xff)).toLong() shl (8 * i))) + i++ + } + } + return CompassEvent( + command, + heading, + (if ((diagnostic[3] == (255).toByte())) -1 else (diagnostic[3] and 0xff)), + (if ((diagnostic[4] == (255).toByte())) -1 else (diagnostic[4] and 0xff)), + (diagnostic[5] and 0xff), + (diagnostic[6] and 0xff), + sampleTimeMs, + ) + } + return CompassEvent(command, heading) + } + if ( + ((command == NAV_CMD_COMPASS_CALIBRATION_STARTED) || + (command == NAV_CMD_COMPASS_CALIBRATION_COMPLETE)) + ) { + return CompassEvent(command, -1) + } + return null + } + + /** + * Display wake notification observed after a ring or right-arm double tap while no EvenHub + * page is running: + * + * sid=0x0d, flag=notify, payload f1=1, f3={f1=1} + * + * Other state-change shapes (wear, charging, head-up, etc.) are deliberately excluded. The + * caller additionally gates this on an intentional EvenHub suspension, so normal state + * traffic cannot become application input. + */ + @JvmStatic + fun isDisplayWakeStateChange(frame: ParsedFrame?): Boolean { + if ( + ((((frame == null) || !frame.ok) || (frame.sid != SID_STATE_CHANGE)) || + ((frame.flag != FLAG_NOTIFY) && (frame.flag != FLAG_NOTIFY_ALT))) + ) { + return false + } + var root: ByteArray = stripTrailingCrc(frame.pb) + if ((readVarintFieldValue(root, 1, -1) != 1)) { + return false + } + var state: ByteArray? = readFieldBytes(root, 3) + return (((state != null) && (state.size == 2)) && + (readVarintFieldValue(state, 1, -1) == 1)) + } + + @JvmStatic + fun readFieldBytes(pb: ByteArray, fieldNumber: Int): ByteArray? { + var offset: Int = 0 + while ((offset < pb.size)) { + var key: VarintResult? = readVarint(pb, offset) + if ((key == null)) { + return null + } + offset = key.next + var field: Int = (key.value shr 3) + var wire: Int = (key.value and 0x07) + if ((wire == 0)) { + var value: VarintResult? = readVarint(pb, offset) + if ((value == null)) { + return null + } + offset = value.next + continue + } + if ((wire == 1)) { + offset += 8 + continue + } + if ((wire == 5)) { + offset += 4 + continue + } + if ((wire != 2)) { + return null + } + var length: VarintResult? = readVarint(pb, offset) + if ((length == null)) { + return null + } + offset = length.next + var end: Int = (offset + length.value) + if ((end > pb.size)) { + return null + } + var bytes: ByteArray = pb.copyOfRange(offset, end) + offset = end + if ((field == fieldNumber)) { + return bytes + } + } + return null + } + + @JvmStatic + fun readVarintFieldValue(pb: ByteArray, fieldNumber: Int, defaultValue: Int): Int { + var offset: Int = 0 + while ((offset < pb.size)) { + var key: VarintResult? = readVarint(pb, offset) + if ((key == null)) { + return defaultValue + } + offset = key.next + var field: Int = (key.value shr 3) + var wire: Int = (key.value and 0x07) + if ((wire == 0)) { + var value: VarintResult? = readVarint(pb, offset) + if ((value == null)) { + return defaultValue + } + offset = value.next + if ((field == fieldNumber)) { + return value.value + } + continue + } + if ((wire == 1)) { + offset += 8 + continue + } + if ((wire == 5)) { + offset += 4 + continue + } + if ((wire != 2)) { + return defaultValue + } + var length: VarintResult? = readVarint(pb, offset) + if ((length == null)) { + return defaultValue + } + offset = (length.next + length.value) + } + return defaultValue + } + + /** + * Read a `float` (protobuf wire type 5, little-endian fixed32) field. The g2-kit proto + * declares IMU_Report_Data's x/y/z as `double`, but the firmware actually sends them as + * fixed32 floats (confirmed from captures). Returns defaultValue if absent. + */ + @JvmStatic + fun readFloatFieldValue(pb: ByteArray, fieldNumber: Int, defaultValue: Float): Float { + var offset: Int = 0 + while ((offset < pb.size)) { + var key: VarintResult? = readVarint(pb, offset) + if ((key == null)) { + return defaultValue + } + offset = key.next + var field: Int = (key.value shr 3) + var wire: Int = (key.value and 0x07) + if ((wire == 0)) { + var value: VarintResult? = readVarint(pb, offset) + if ((value == null)) { + return defaultValue + } + offset = value.next + } else { + if ((wire == 1)) { + offset += 8 + } else { + if ((wire == 5)) { + if (((offset + 4) > pb.size)) { + return defaultValue + } + if ((field == fieldNumber)) { + var bits: Int = 0 + run { + var i: Int = 0 + while ((i < 4)) { + bits = (bits or ((pb[(offset + i)] and 0xff) shl (8 * i))) + i++ + } + } + return Float.fromBits(bits) + } + offset += 4 + } else { + if ((wire == 2)) { + var length: VarintResult? = readVarint(pb, offset) + if ((length == null)) { + return defaultValue + } + offset = (length.next + length.value) + } else { + return defaultValue + } + } + } + } + } + return defaultValue + } + + @JvmStatic + fun readStringFieldValue(pb: ByteArray, fieldNumber: Int): String { + var bytes: ByteArray? = readFieldBytes(pb, fieldNumber) + if ((bytes == null)) { + return "" + } + return bytes.decodeToString() + } + + @JvmStatic + fun readVarint(pb: ByteArray, offset: Int): VarintResult? { + var value: Int = 0 + var shift: Int = 0 + var cursor: Int = offset + while ((cursor < pb.size)) { + var b: Int = (pb[cursor++] and 0xff) + value = (value or ((b and 0x7f) shl shift)) + if (((b and 0x80) == 0)) { + return VarintResult(value, cursor) + } + shift += 7 + } + return null + } + } + + class RingBatterySnapshot { + @JvmField val battery: Int + + @JvmField val charging: Int + + constructor(battery: Int, charging: Int) { + this.battery = battery + this.charging = charging + } + } + + /** An idle gesture from a CFW field-102 notification, in EvenHub sys-event terms. */ + class FaceclawGestureEvent { + @JvmField val eventType: Int + + @JvmField val eventSource: Int + + constructor(eventType: Int, eventSource: Int) { + this.eventType = eventType + this.eventSource = eventSource + } + } + + class ParsedFrame { + @JvmField val ok: Boolean + + @JvmField val sid: Int + + @JvmField val flag: Int + + @JvmField val pb: ByteArray + + @JvmField val msgType: Int + + @JvmField val msgSeq: Int + + constructor(ok: Boolean, sid: Int, flag: Int, pb: ByteArray, msgType: Int, msgSeq: Int) { + this.ok = ok + this.sid = sid + this.flag = flag + this.pb = pb + this.msgType = msgType + this.msgSeq = msgSeq + } + } + + class VarintResult { + @JvmField val value: Int + + @JvmField val next: Int + + constructor(value: Int, next: Int) { + this.value = value + this.next = next + } + } + + class ListSelection { + @JvmField val containerName: String? + + @JvmField val itemName: String? + + @JvmField val itemIndex: Int + + @JvmField val eventType: Int + + constructor(containerName: String?, itemName: String?, itemIndex: Int, eventType: Int) { + this.containerName = (if ((containerName == null)) "" else containerName) + this.itemName = (if ((itemName == null)) "" else itemName) + this.itemIndex = itemIndex + this.eventType = eventType + } + } + + class CompassEvent { + @JvmField val command: Int + + @JvmField val headingDegrees: Int + + /** -1 means unavailable; source: 0 unknown, 1 GRV, 2 GMRV, 3 RV. */ + @JvmField val magneticAccuracy: Int + @JvmField val magneticAnomalies: Int + @JvmField val orientationSource: Int + @JvmField val diagnosticFlags: Int + + @JvmField val sampleTimeMs: Long + + constructor( + command: Int, + headingDegrees: Int, + ) : this(command, headingDegrees, -1, -1, -1, -1, -1) {} + + constructor( + command: Int, + headingDegrees: Int, + magneticAccuracy: Int, + magneticAnomalies: Int, + orientationSource: Int, + diagnosticFlags: Int, + sampleTimeMs: Long, + ) { + this.command = command + this.headingDegrees = headingDegrees + this.magneticAccuracy = magneticAccuracy + this.magneticAnomalies = magneticAnomalies + this.orientationSource = orientationSource + this.diagnosticFlags = diagnosticFlags + this.sampleTimeMs = sampleTimeMs + } + } + + class ImageTileOptions { + @JvmField val name: String + + @JvmField val containerId: Int + + @JvmField val x: Int + + @JvmField val y: Int + + @JvmField val width: Int + + @JvmField val height: Int + + constructor(name: String, containerId: Int, x: Int, y: Int, width: Int, height: Int) { + this.name = name + this.containerId = containerId + this.x = x + this.y = y + this.width = width + this.height = height + } + } + + class ImageFragment { + @JvmField val index: Int + + @JvmField val data: ByteArray + + @JvmField val size: Int + + constructor(index: Int, data: ByteArray, size: Int) { + this.index = index + this.data = data + this.size = size + } + } + + class BatterySnapshot { + @JvmField val battery: Int + + @JvmField val charging: Int + + /** 1 = silent mode on, 0 = off, -1 = the ack didn't carry the field. */ + @JvmField val silentMode: Int + + constructor(battery: Int, charging: Int, silentMode: Int) { + this.battery = battery + this.charging = charging + this.silentMode = silentMode + } + } + + class FirmwareInfo { + companion object { + /** Prefix of the firmware-extension string on Faceclaw's custom firmware. */ + const val FACECLAW_EXTENSION_PREFIX: String = "Faceclaw/" + } + + @JvmField val leftVersion: String + + @JvmField val rightVersion: String + + /** Raw field-100 string ("" on stock firmware). */ + @JvmField val extension: String + + constructor(leftVersion: String, rightVersion: String, extension: String?) { + this.leftVersion = leftVersion + this.rightVersion = rightVersion + this.extension = (if ((extension == null)) "" else extension) + } + + /** + * True when the glasses run Faceclaw's custom firmware (any revision). Whether the revision + * is the one this app needs is decided on the TS side, which disconnects on a mismatch; + * this only guards the private modes against stock or third-party firmware in the meantime. + */ + fun isFaceclawFirmware(): Boolean { + return extension.trim().startsWith(FACECLAW_EXTENSION_PREFIX) + } + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/CfwMessageWindow.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/CfwMessageWindow.kt new file mode 100644 index 00000000..74868596 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/CfwMessageWindow.kt @@ -0,0 +1,44 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmStatic + +/** Ordered completion and go-back-N recovery for the custom-message window. */ +class CfwMessageWindow private constructor() { + companion object { + // Flappy capture: p99 ACK 63ms, max 77ms. Allow full-frame processing + // while recovering a lost reply well before the stock timeout. + const val ACK_TIMEOUT_MS = 500 + const val MAX_RETRIES = 3 + + @JvmStatic + fun acknowledgedHead(messages: Iterable): OutboundMessage? { + for (message in messages) { + if (message.sid != CfwTransport.SID) continue + return if (!message.cfwRetryPending && message.cfwAckLenses == CfwTransport.BOTH) + message + else null + } + return null + } + + @JvmStatic + fun replayWindow(messages: Iterable, nowMs: Long): List { + val replay = mutableListOf() + var failed = false + for (message in messages) { + if (message.sid != CfwTransport.SID) continue + failed = + failed || + message.cfwRetryPending || + (message.cfwAckLenses != CfwTransport.BOTH && + message.ackDeadlineAtMs > 0 && + message.ackDeadlineAtMs <= nowMs) + replay.add(message) + } + // Replaying only the named failure can strand an older unresolved + // attempt at the head. Rewind the entire unresolved custom window. + if (!failed) replay.clear() + return replay + } + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/CfwTransport.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/CfwTransport.kt new file mode 100644 index 00000000..0ce887fd --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/CfwTransport.kt @@ -0,0 +1,190 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmField +import kotlin.jvm.JvmStatic + +/** Faceclaw/10 records: clear flags, wire length and decoded CRC; persistent zlib body. */ +class CfwTransport(private val platform: ProtocolPlatform) { + private val lock = platform.createLock() + private var deflater: ProtocolDeflater? = null + private var resetPending = true + private var previousLenses = 0 + + fun reset() = lock.withLock { + deflater?.reset() + resetPending = true + previousLenses = 0 + } + + /** Release native compression resources. A later encode starts a fresh stream. */ + fun close() = lock.withLock { + deflater?.close() + deflater = null + resetPending = true + previousLenses = 0 + } + + /** Compress only when writing, in exactly the order seen by the receiver. */ + fun encode(message: ByteArray?, streamId: Int, lenses: Int, mtu: Int): List = + lock.withLock { + validate(message, streamId, lenses, mtu) + val input = message!! + if (previousLenses != lenses) reset() + val reset = resetPending + val encoder = deflater ?: platform.createDeflater().also { deflater = it } + var body = encoder.syncFlush(input) + var flags = lenses or COMPRESSED or (if (reset) RESET_CONTEXT else 0) + if (body.isEmpty()) flags = flags and COMPRESSED.inv() // repeated empty sync flush + if (body.size > MAX_MESSAGE) { + // The attempted deflate advanced history: reset both ends before reuse. + reset() + body = input + flags = lenses or RESET_CONTEXT + } else { + resetPending = false + previousLenses = lenses + } + frameRecord(body, crc(input), streamId, flags, mtu) + } + + companion object { + const val SID = 0xf0 + const val BOTH = 3 + const val MAX_MESSAGE = 65535 + const val COMPRESSED = 4 + const val RESET_CONTEXT = 8 + + private fun validate(message: ByteArray?, streamId: Int, lenses: Int, mtu: Int) { + require( + message != null && + message.size <= MAX_MESSAGE && + streamId in 0..255 && + lenses in 1..BOTH && + mtu in 23..517 + ) { + "invalid CFW stream parameters" + } + } + + /** One logical command per stream. Packets are bounded by actual ATT MTU. */ + @JvmStatic + fun frame(message: ByteArray?, streamId: Int, lenses: Int, mtu: Int): List { + validate(message, streamId, lenses, mtu) + return frameRecord(message!!, crc(message), streamId, lenses or RESET_CONTEXT, mtu) + } + + private fun frameRecord( + body: ByteArray, + checksum: Int, + streamId: Int, + flags: Int, + mtu: Int, + ): List { + val lenses = flags and BOTH + val capacity = minOf(252, mtu - 14) + val stream = ByteArray(body.size + 5) + stream[0] = flags.toByte() + stream[1] = body.size.toByte() + stream[2] = (body.size ushr 8).toByte() + stream[3] = checksum.toByte() + stream[4] = (checksum ushr 8).toByte() + body.copyInto(stream, 5) + val packets = mutableListOf() + for (offset in stream.indices step capacity) { + val count = minOf(capacity, stream.size - offset) + val packet = ByteArray(count + 11) + packet[0] = 0xaa.toByte() + packet[1] = 0x21 + packet[2] = (streamId + packets.size).toByte() + packet[3] = (count + 3).toByte() + packet[4] = 1 + packet[5] = 1 + packet[6] = SID.toByte() + packet[8] = + (lenses or + (if (offset == 0) 0x80 else 0) or + (if (offset + count == stream.size) 0x40 else 0)) + .toByte() + stream.copyInto(packet, 9, offset, offset + count) + val crc = crc(packet, 8, count + 1) + packet[packet.size - 2] = crc.toByte() + packet[packet.size - 1] = (crc ushr 8).toByte() + packets.add(packet) + } + return packets + } + + @JvmStatic fun crc(data: ByteArray): Int = crc(data, 0, data.size) + + private fun crc(data: ByteArray, offset: Int, count: Int): Int { + var crc = 0xffff + for (i in offset until offset + count) { + crc = crc xor ((data[i].toInt() and 255) shl 8) + repeat(8) { + crc = ((crc shl 1) xor (if (crc and 0x8000 != 0) 0x1021 else 0)) and 65535 + } + } + return crc + } + + private fun u16(data: ByteArray, offset: Int): Int = + (data[offset].toInt() and 255) or ((data[offset + 1].toInt() and 255) shl 8) + + @JvmStatic fun parseAck(packet: ByteArray?): Ack? = parseAcks(packet)?.first() + + /** + * Validate the entire primary ACK and up to three preceding successes before applying any. + */ + @JvmStatic + fun parseAcks(packet: ByteArray?): Array? { + if ( + packet == null || + packet.size !in 19..40 || + (packet.size - 19) % 7 != 0 || + packet[0].toInt() and 255 != 0xaa || + packet[1].toInt() != 0x12 || + packet[3].toInt() and 255 != packet.size - 8 || + packet[4].toInt() != 1 || + packet[5].toInt() != 1 || + packet[6].toInt() and 255 != SID || + packet[7].toInt() != 0 || + (packet[8].toInt() != 1 && packet[8].toInt() != 3) || + (packet[12].toInt() != 1 && packet[12].toInt() != 2) || + (packet[8].toInt() == 3 && packet.size != 19) || + crc(packet, 8, packet.size - 10) != u16(packet, packet.size - 2) + ) + return null + return Array(1 + (packet.size - 19) / 7) { i -> + if (i == 0) + Ack( + packet[8].toInt() == 3, + packet[9].toInt() and 255, + u16(packet, 10), + packet[12].toInt(), + u16(packet, 13), + u16(packet, 15), + ) + else { + val offset = 17 + (i - 1) * 7 + Ack( + false, + packet[offset].toInt() and 255, + u16(packet, offset + 1), + packet[12].toInt(), + u16(packet, offset + 3), + u16(packet, offset + 5), + ) + } + } + } + } + + class Ack( + @JvmField val nack: Boolean, + @JvmField val streamId: Int, + @JvmField val messageId: Int, + @JvmField val lens: Int, + @JvmField val size: Int, + @JvmField val checksum: Int, + ) +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/ConnectionOptions.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/ConnectionOptions.kt new file mode 100644 index 00000000..caba97a1 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/ConnectionOptions.kt @@ -0,0 +1,78 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmField + +class ConnectionOptions { + companion object { + @JvmField val WRITE_MODE = GattWriteMode.WITHOUT_RESPONSE + const val DESIRED_MTU = 512 + + const val CONNECT_TIMEOUT_MS = 5_000 + const val SERVICES_TIMEOUT_MS = 5_000 + const val DESCRIPTOR_TIMEOUT_MS = 5_000 + const val RING_DESIRED_MTU = 247 + const val RING_RECONNECT_DELAY_MS = 2_000 + const val WRITE_TIMEOUT_MS = 2_000 + const val PRELUDE_TIMEOUT_MS = 2_000 + // Application security-auth exchange (sid 0x80). The success notification + // only arrives once the BLE link is encrypted, which on a first-time + // connection means SMP pairing — possibly with an OS dialog the user has + // to accept — so the stock-firmware paths wait generously. + const val SECURITY_AUTH_TIMEOUT_MS = 30_000 + // The main communicator's wait is soft (it proceeds on timeout so firmware + // that never answers can't stall every reconnect), so it is kept short. + const val SECURITY_AUTH_SOFT_TIMEOUT_MS = 6_000 + const val ACK_TIMEOUT_MS = 3_500 + const val HEARTBEAT_FAILURE_DEADLINE_MS = 10_000 + const val HEARTBEAT_READY_MS = 4_000 + const val HEARTBEAT_URGENT_MS = 6_000 + const val BATTERY_REFRESH_INTERVAL_MS = 5 * 60_000 + const val BATTERY_INPUT_QUIET_MS = 5_000 + // Poll cadence while in charging mode; also bounds how quickly we notice + // the glasses coming back out of the case. + const val CHARGING_BATTERY_POLL_MS = 30_000 + const val IMAGE_FRAGMENT_SIZE = 3800 + const val IMAGE_RETRY_DELAY_MS = 2_000 + const val MAX_CONSECUTIVE_ACK_TIMEOUTS = 8 + const val EVEN_APP_WRITE_FAILURE_WINDOW_MS = 15_000 + const val IDLE_SLEEP_MS = 100 + const val RECONNECT_DELAY_MS = 2_000 + // Cap on rects per batch. Each rect consumes a distinct CFW frame id, and the + // firmware's duplicate-fid ring holds 16, so keep several batches of history + // within it. Above this the split is abandoned for a single bounding box. + const val MULTI_RECT_MAX_RECTS = 6 + // Don't bother splitting when the single bounding box already compresses this + // small (one tight rect); only attempt multi-rect above it or when the box + // spans multiple horizontal clusters. + const val MULTI_RECT_MIN_PAYLOAD = 900 + } + + @JvmField val sendImagesToLeft = true + @JvmField val skipSessionIds = true + // Max messages in flight (awaiting ack) at once — full pipelining. >1 lets a + // frame be sent before the previous frame's ack returns, hiding the BLE ack + // round-trip that otherwise serialized every update. Requires firmware that + // accepts pipelined image messages (the CFW snapshot/deferred FIFO). At 1 the + // communicator behaves exactly as before (serial sends + last-packet prewrite). + @JvmField val WINDOW_SIZE = 3 + // Send changed-region (mode 3 bounding box) updates instead of full frames + // when the previous frame is known to be displayed. Requires firmware with + // the experimental bbox-incremental mode. Disabled: the firmware-side + // display buffer is not always the previous frame (occasionally two frames + // back, apparently display-driver buffer swapping), so partial updates + // composite onto stale content per-lens. Re-enable once the firmware + // guarantees the compositing base. + @JvmField val INCREMENTAL_FRAMES = true + + // Send several tight rectangle deltas as one CFW mode-8 multi-segment message + // instead of a single bounding box, when the change splits into regions whose + // bounding box wastes bytes (distant edits, or a sparse box). Requires firmware + // with mode-8 multi-rect support; needs INCREMENTAL_FRAMES (same seeded shadow). + // Falls back to the single bounding box whenever multi-rect isn't smaller. + @JvmField val MULTI_RECT_FRAMES = true + + // Ship text as on-glasses cached-glyph draws (CFW modes 12/14) instead of + // pixels, punching glyph ink out of the baked deltas (see TexturePlanner). + // Also gated at runtime on the firmware advertising texcache12 + texstr14. + @JvmField val TEXTURE_CACHE_FRAMES = true +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/FaceclawRingEventDecoder.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/FaceclawRingEventDecoder.kt new file mode 100644 index 00000000..651f18a9 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/FaceclawRingEventDecoder.kt @@ -0,0 +1,145 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmField +import kotlin.jvm.JvmStatic + +class FaceclawRingEventDecoder { + companion object { + @JvmStatic + fun decode(raw: ByteArray?): DirectRingEvent? { + if (((raw == null) || (raw.size == 0))) { + return null + } + var chargerGesture: DirectRingEvent? = decodeChargerGesture(raw) + if ((chargerGesture != null)) { + return chargerGesture + } + return decodeDirectGesture(raw) + } + + private fun decodeChargerGesture(raw: ByteArray): DirectRingEvent? { + if ((raw.size != 11)) { + return null + } + if ( + ((((u8(raw[0]) != 0x00) || (u8(raw[1]) != 0x09)) || (u8(raw[2]) != 0x61)) || + (u8(raw[3]) != 0x00)) + ) { + return null + } + var code: Int = u8(raw[4]) + var param: Int = (u8(raw[5]) or (u8(raw[6]) shl 8)) + var tick: Long = + ((((u8(raw[7]) or (u8(raw[8]) shl 8)) or (u8(raw[9]) shl 16)) or + (u8(raw[10]) shl 24)) + .toLong() and 0xffffffffL) + var detail: String = + "code=0x${code.toString(16).padStart(2, '0')}(${chargerCodeName(code)}) param=0x${param.toString(16).padStart(4, '0')} tick=$tick" + when (code) { + 0x00 -> { + return event(BleProtocol.EVENT_RING_LONG_PRESS, "LONG_PRESS", detail) + } + 0x01 -> { + return event(BleProtocol.EVENT_CLICK, "TAP", detail) + } + 0x02 -> { + return event(BleProtocol.EVENT_DOUBLE_CLICK, "DOUBLE_TAP", detail) + } + 0x04 -> { + return event(BleProtocol.EVENT_SCROLL_TOP, "SWIPE_UP", detail) + } + 0x05 -> { + return event(BleProtocol.EVENT_SCROLL_BOTTOM, "SWIPE_DOWN", detail) + } + 0x08 -> { + return event( + BleProtocol.EVENT_RING_LONG_PRESS_RELEASE, + "LONG_PRESS_RELEASE", + detail, + ) + } + else -> { + return null + } + } + } + + private fun decodeDirectGesture(raw: ByteArray): DirectRingEvent? { + if (((raw.size != 3) || (u8(raw[0]) != 0xff))) { + return null + } + var type: Int = u8(raw[1]) + var param: Int = u8(raw[2]) + var detail: String = + "type=0x${type.toString(16).padStart(2, '0')} param=0x${param.toString(16).padStart(2, '0')}" + if (((type == 0x03) && (param == 0x20))) { + return event(BleProtocol.EVENT_RING_LONG_PRESS, "HOLD", detail) + } + if (((type == 0x04) && (param == 0x01))) { + return event(BleProtocol.EVENT_CLICK, "TAP_SINGLE", detail) + } + if (((type == 0x04) && (param == 0x02))) { + return event(BleProtocol.EVENT_DOUBLE_CLICK, "TAP_DOUBLE", detail) + } + if ((type == 0x05)) { + if ((param <= 0x01)) { + return event(BleProtocol.EVENT_SCROLL_BOTTOM, "SWIPE_FORWARD", detail) + } + return event(BleProtocol.EVENT_SCROLL_TOP, "SWIPE_BACKWARD", detail) + } + return null + } + + private fun event(eventType: Int, label: String, detail: String): DirectRingEvent { + var event: G2Event = + G2Event("sys-event", "", eventType, BleProtocol.EVENT_SOURCE_RING, 0) + return DirectRingEvent(event, label, detail) + } + + private fun chargerCodeName(code: Int): String { + when (code) { + 0x00 -> { + return "LONG_PRESS" + } + 0x01 -> { + return "TAP" + } + 0x02 -> { + return "DOUBLE_TAP" + } + 0x04 -> { + return "SWIPE_UP" + } + 0x05 -> { + return "SWIPE_DOWN" + } + 0x08 -> { + return "LONG_PRESS_RELEASE" + } + else -> { + return "unknown" + } + } + } + + private fun u8(value: Byte): Int { + return (value and 0xff) + } + } + + constructor() {} + + class DirectRingEvent { + @JvmField val event: G2Event + + @JvmField val label: String + + @JvmField val detail: String + + constructor(event: G2Event, label: String, detail: String) { + this.event = event + this.label = label + this.detail = detail + } + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/G2Event.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/G2Event.kt new file mode 100644 index 00000000..0bc9ee9c --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/G2Event.kt @@ -0,0 +1,141 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmField +import kotlin.jvm.JvmStatic + +class G2Event { + companion object { + @JvmStatic + fun decode(frame: BleProtocol.ParsedFrame): G2Event? { + return decodePayload(frame.sid, BleProtocol.stripTrailingCrc(frame.pb)) + } + + /** Decode an already validated payload, without the envelope's trailing CRC. */ + @JvmStatic + fun decodePayload(sid: Int, pb: ByteArray): G2Event? { + if ((sid == BleProtocol.SID_EVEN_AI)) { + var commandId: Int = BleProtocol.readVarintFieldValue(pb, 1, -1) + if ((commandId != BleProtocol.EVEN_AI_CMD_CTRL)) { + return null + } + var ctrl: ByteArray? = BleProtocol.readFieldBytes(pb, 3) + if ((ctrl == null)) { + return null + } + var status: Int = BleProtocol.readVarintFieldValue(ctrl, 1, -1) + if ((status < 0)) { + return null + } + return G2Event("even-ai", "", status, 0, 0) + } + var deviceEvent: ByteArray? = BleProtocol.readFieldBytes(pb, 13) + if ((deviceEvent == null)) { + return null + } + var listEvent: ByteArray? = BleProtocol.readFieldBytes(deviceEvent, 1) + if ((listEvent != null)) { + return G2Event( + "list-click", + BleProtocol.readStringFieldValue(listEvent, 2), + BleProtocol.readVarintFieldValue(listEvent, 5, BleProtocol.EVENT_CLICK), + 0, + 0, + ) + } + var textEvent: ByteArray? = BleProtocol.readFieldBytes(deviceEvent, 2) + if ((textEvent != null)) { + return G2Event( + "text-click", + BleProtocol.readStringFieldValue(textEvent, 2), + BleProtocol.readVarintFieldValue(textEvent, 3, BleProtocol.EVENT_CLICK), + 0, + 0, + ) + } + var sysEvent: ByteArray? = BleProtocol.readFieldBytes(deviceEvent, 3) + if ((sysEvent != null)) { + var eventType: Int = + BleProtocol.readVarintFieldValue(sysEvent, 1, BleProtocol.EVENT_CLICK) + var eventSource: Int = BleProtocol.readVarintFieldValue(sysEvent, 2, 0) + var exitReason: Int = BleProtocol.readVarintFieldValue(sysEvent, 4, 0) + var imu: ByteArray? = BleProtocol.readFieldBytes(sysEvent, 3) + if ((imu != null)) { + var x: Double = BleProtocol.readFloatFieldValue(imu, 1, 0f).toDouble() + var y: Double = BleProtocol.readFloatFieldValue(imu, 2, 0f).toDouble() + var z: Double = BleProtocol.readFloatFieldValue(imu, 3, 0f).toDouble() + return G2Event( + "sys-event", + "", + eventType, + eventSource, + exitReason, + true, + x, + y, + z, + ) + } + return G2Event("sys-event", "", eventType, eventSource, exitReason) + } + return null + } + } + + @JvmField val kind: String + + @JvmField val containerName: String + + @JvmField val eventType: Int + + @JvmField val eventSource: Int + + @JvmField val systemExitReasonCode: Int + + @JvmField val hasImu: Boolean + + @JvmField val imuX: Double + + @JvmField val imuY: Double + + @JvmField val imuZ: Double + + constructor( + kind: String, + containerName: String, + eventType: Int, + eventSource: Int, + systemExitReasonCode: Int, + ) : this( + kind, + containerName, + eventType, + eventSource, + systemExitReasonCode, + false, + 0.0, + 0.0, + 0.0, + ) {} + + constructor( + kind: String, + containerName: String, + eventType: Int, + eventSource: Int, + systemExitReasonCode: Int, + hasImu: Boolean, + imuX: Double, + imuY: Double, + imuZ: Double, + ) { + this.kind = kind + this.containerName = containerName + this.eventType = eventType + this.eventSource = eventSource + this.systemExitReasonCode = systemExitReasonCode + this.hasImu = hasImu + this.imuX = imuX + this.imuY = imuY + this.imuZ = imuZ + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/MessageBuilder.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/MessageBuilder.kt new file mode 100644 index 00000000..218c7d4c --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/MessageBuilder.kt @@ -0,0 +1,292 @@ +package com.faceclaw.app + +class MessageBuilder { + companion object { + private const val ACK_TIMEOUT_MS: Int = 3_500 + + private const val HEARTBEAT_TIMEOUT_MS: Int = 1_500 + } + + private var magicPool: BleMagicPool + + constructor(magicPool: BleMagicPool) { + this.magicPool = magicPool + } + + fun prelude(): OutboundMessage { + return OutboundMessage( + "prelude", + "prelude", + BleProtocol.PRELUDE_ACK_SID, + BleProtocol.FLAG_REQUEST, + BleProtocol.PRELUDE_ACK_MAGIC, + BleProtocol.PRELUDE_F5872_PAYLOAD, + ACK_TIMEOUT_MS, + -1, + false, + ) + } + + /** The per-connection sid-0x80 security-auth request (one per arm). */ + fun securityAuth(leftArm: Boolean): OutboundMessage { + var magic: Int = magicPool.allocate() + return OutboundMessage( + "security-auth", + ("security auth " + (if (leftArm) "L" else "R")), + BleProtocol.SID_SECURITY_AUTH, + BleProtocol.FLAG_SECURITY_AUTH, + magic, + BleProtocol.buildAuthenticationRequest(magic), + ConnectionOptions.SECURITY_AUTH_SOFT_TIMEOUT_MS, + -1, + leftArm, + ) + } + + fun shutdown(exitMode: Int): OutboundMessage { + var magic: Int = magicPool.allocate() + return OutboundMessage( + "shutdown", + ("shutdown mode=" + exitMode), + BleProtocol.SID_EVENHUB, + BleProtocol.FLAG_REQUEST, + magic, + BleProtocol.buildShutdown(magic, exitMode), + ACK_TIMEOUT_MS, + -1, + false, + ) + } + + fun imagePayload( + tile: BleProtocol.ImageTileOptions, + sessionId: Int, + payload: ByteArray, + label: String, + leftArm: Boolean, + ): OutboundMessage { + return imagePayload("sound", tile, sessionId, payload, label, leftArm) + } + + fun imagePayload( + kind: String, + tile: BleProtocol.ImageTileOptions, + sessionId: Int, + payload: ByteArray, + label: String, + leftArm: Boolean, + ): OutboundMessage { + return customMessage(kind, payload, label, -1, leftArm) + } + + fun customMessage( + kind: String, + payload: ByteArray?, + label: String, + tileIndex: Int, + leftArm: Boolean, + ): OutboundMessage { + if (((payload == null) || (payload.size > CfwTransport.MAX_MESSAGE))) { + throw IllegalArgumentException("CFW message exceeds uint16 length") + } + var streamId: Int = magicPool.allocate() + return OutboundMessage( + kind, + label, + CfwTransport.SID, + 0, + streamId, + payload, + CfwMessageWindow.ACK_TIMEOUT_MS, + tileIndex, + leftArm, + ) + } + + fun cfwCleanup( + tile: BleProtocol.ImageTileOptions, + sessionId: Int, + leftArm: Boolean, + ): OutboundMessage { + var payload: ByteArray = byteArrayOf((BleProtocol.CFW_IMAGE_MODE_CLEANUP).toByte()) + return imagePayload("cfw-cleanup", tile, sessionId, payload, "CFW cleanup", leftArm) + } + + fun enableOrDisableMic(enable: Boolean): OutboundMessage { + var magic: Int = magicPool.allocate() + return OutboundMessage( + "audio-control", + (if (enable) "G2 mic enable" else "G2 mic disable"), + BleProtocol.SID_EVENHUB, + BleProtocol.FLAG_REQUEST, + magic, + BleProtocol.buildAudioControl(magic, enable), + ACK_TIMEOUT_MS, + -1, + false, + ) + } + + fun enableOrDisableImu(enable: Boolean, reportFrq: Int): OutboundMessage { + var magic: Int = magicPool.allocate() + return OutboundMessage( + "imu-control", + (if (enable) "IMU enable" else "IMU disable"), + BleProtocol.SID_EVENHUB, + BleProtocol.FLAG_REQUEST, + magic, + BleProtocol.buildImuControl(magic, enable, reportFrq), + ACK_TIMEOUT_MS, + -1, + false, + ) + } + + fun setBrightness(autoAdjust: Boolean, brightnessLevel: Int): OutboundMessage { + var magic: Int = magicPool.allocate() + return OutboundMessage( + "brightness-control", + (if (autoAdjust) "brightness auto" else ("brightness level=" + brightnessLevel)), + BleProtocol.SID_UI_SETTING, + BleProtocol.FLAG_REQUEST, + magic, + BleProtocol.buildSetBrightness(magic, autoAdjust, brightnessLevel), + ACK_TIMEOUT_MS, + -1, + false, + ) + } + + fun setWearDetection(enabled: Boolean): OutboundMessage { + var magic: Int = magicPool.allocate() + return OutboundMessage( + "wear-detection-control", + ("wear detection " + (if (enabled) "enable" else "disable")), + BleProtocol.SID_UI_SETTING, + BleProtocol.FLAG_REQUEST, + magic, + BleProtocol.buildSetWearDetection(magic, enabled), + ACK_TIMEOUT_MS, + -1, + false, + ) + } + + fun createLayout(): OutboundMessage { + var magic: Int = magicPool.allocate() + return OutboundMessage( + "create-layout", + "create-layout", + BleProtocol.SID_EVENHUB, + BleProtocol.FLAG_REQUEST, + magic, + BleProtocol.buildCreateInputPage(magic), + ACK_TIMEOUT_MS, + -1, + false, + ) + } + + fun startupTextProbe(): OutboundMessage { + var magic: Int = magicPool.allocate() + return OutboundMessage( + "startup-text-probe", + "startup text probe", + BleProtocol.SID_EVENHUB, + BleProtocol.FLAG_REQUEST, + magic, + BleProtocol.buildDashboardTextUpgrade(magic), + ACK_TIMEOUT_MS, + -1, + false, + ) + } + + fun heartbeat(): OutboundMessage { + var magic: Int = magicPool.allocate() + return OutboundMessage( + "heartbeat", + "heartbeat", + BleProtocol.SID_EVENHUB, + BleProtocol.FLAG_REQUEST, + magic, + BleProtocol.buildHeartbeat(magic), + HEARTBEAT_TIMEOUT_MS, + -1, + false, + ) + } + + fun batteryQuery(): OutboundMessage { + var magic: Int = magicPool.allocate() + return OutboundMessage( + "battery", + "battery", + BleProtocol.SID_UI_SETTING, + BleProtocol.FLAG_REQUEST, + magic, + BleProtocol.buildSettingsQuery(magic), + ACK_TIMEOUT_MS, + -1, + false, + ) + } + + fun faceclawWakeControl(operation: Int, nonce: Int, leftArm: Boolean): OutboundMessage { + return OutboundMessage( + "wake-lease-control", + (((("wake lease op=" + operation) + " nonce=") + nonce) + + (if (leftArm) " L" else " R")), + BleProtocol.SID_UI_SETTING, + BleProtocol.FLAG_REQUEST, + 0, + BleProtocol.buildFaceclawWakeControl(operation, nonce), + ACK_TIMEOUT_MS, + -1, + leftArm, + ) + } + + fun faceclawFramebufferControl(operation: Int, leftArm: Boolean): OutboundMessage { + return OutboundMessage( + "framebuffer-lease-control", + (("framebuffer lease op=" + operation) + (if (leftArm) " L" else " R")), + BleProtocol.SID_UI_SETTING, + BleProtocol.FLAG_REQUEST, + 0, + BleProtocol.buildFaceclawWakeControl(operation, 0), + ACK_TIMEOUT_MS, + -1, + leftArm, + ) + } + + /** CFW mic_control write (settings field 103) targeted at one temple. */ + fun faceclawMicControl(record: ByteArray, label: String, leftArm: Boolean): OutboundMessage { + return OutboundMessage( + "mic-control", + (("mic control " + label) + (if (leftArm) " L" else " R")), + BleProtocol.SID_UI_SETTING, + BleProtocol.FLAG_REQUEST, + 0, + BleProtocol.buildFaceclawMicControl(record), + ACK_TIMEOUT_MS, + -1, + leftArm, + ) + } + + fun faceclawWearQuery(leftArm: Boolean): OutboundMessage { + return OutboundMessage( + "wear-query-control", + ("wear state query" + (if (leftArm) " L" else " R")), + BleProtocol.SID_UI_SETTING, + BleProtocol.FLAG_REQUEST, + 0, + BleProtocol.buildFaceclawWakeControl(BleProtocol.FACECLAW_WEAR_OP_QUERY, 0), + ACK_TIMEOUT_MS, + -1, + leftArm, + ) + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/MessageReceiver.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/MessageReceiver.kt new file mode 100644 index 00000000..6761dfa8 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/MessageReceiver.kt @@ -0,0 +1,127 @@ +package com.faceclaw.app + +/** Split/coalesced notifications and protobuf fragments, isolated per BLE link and sequence. */ +class MessageReceiver { + class Message( + val sid: Int, + val flag: Int, + val payload: ByteArray, + val command: Int, + val magic: Int, + val packet: ByteArray? = null, + ) + + private class Partial(val total: Int, var seen: Long) { + val chunks = mutableListOf() + var size = 0 + } + + private val lock = protocolPlatform().createLock() + private val streams = mutableMapOf() + private val messages = mutableMapOf() + + fun clear() = lock.withLock { + streams.clear() + messages.clear() + } + + fun receive(link: String, data: ByteArray, now: Long): List = lock.withLock { + messages.entries.removeAll { now - it.value.seen > 5000 } + val stream = (streams[link] ?: ByteArray(0)) + data + val output = mutableListOf() + var offset = 0 + while (stream.size - offset >= 8) { + fun u8(index: Int) = stream[offset + index].toInt() and 255 + if (u8(0) != 0xaa || u8(1) !in intArrayOf(0x21, 0x12)) { + offset++ + continue + } + val length = u8(3) + if (stream.size - offset < length + 8) break + val count = u8(4) + val index = u8(5) + val sid = u8(6) + val flag = u8(7) + val key = "$link:${u8(2)}:$sid:$flag" + val packet = stream.copyOfRange(offset, offset + length + 8) + val chunk = packet.copyOfRange(8, packet.size) + offset += length + 8 + if (sid == CfwTransport.SID) { + output.add(Message(sid, flag, chunk, -1, -1, packet)) + continue + } + if (count == 0 || index == 0 || index > count) { + messages.remove(key) + continue + } + if (index == 1) messages[key] = Partial(count, now) + val partial = messages[key] + if (partial == null || partial.total != count || partial.chunks.size + 1 != index) { + messages.remove(key) + continue + } + partial.chunks.add(chunk) + partial.size += chunk.size + partial.seen = now + if (partial.size > 65536) { + messages.remove(key) + continue + } + if (index != count) continue + messages.remove(key) + val bytes = ByteSink(partial.size) + partial.chunks.forEach { bytes.write(it) } + val complete = bytes.toByteArray() + if (complete.size < 2) continue + val payload = complete.copyOf(complete.size - 2) + val checksum = + (complete[complete.size - 2].toInt() and 255) or + ((complete.last().toInt() and 255) shl 8) + if (CfwTransport.crc(payload) != checksum || !validProtobuf(payload)) continue + output.add( + Message( + sid, + flag, + payload, + BleProtocol.readVarintFieldValue(payload, 1, -1), + BleProtocol.readVarintFieldValue(payload, 2, -1), + ) + ) + } + streams[link] = stream.copyOfRange(offset, stream.size) + output + } + + private fun validProtobuf(data: ByteArray): Boolean { + var offset = 0 + fun varint(): Int? { + var value = 0 + for (i in 0..4) { + if (offset == data.size) return null + val byte = data[offset++].toInt() and 255 + if (i == 4 && byte > 15) return null + value = value or ((byte and 127) shl (i * 7)) + if (byte and 128 == 0) return value + } + return null + } + while (offset < data.size) { + val key = varint() ?: return false + if (key ushr 3 == 0) return false + if (key and 7 == 0) { + varint() ?: return false + continue + } + val length = + when (key and 7) { + 1 -> 8 + 5 -> 4 + 2 -> varint() ?: return false + else -> return false + } + if (length < 0 || length > data.size - offset) return false + offset += length + } + return true + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/OutboundMessage.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/OutboundMessage.kt new file mode 100644 index 00000000..43ee91db --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/OutboundMessage.kt @@ -0,0 +1,68 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmField + +/** Mutable attempt state, owned by the communicator and guarded by its lock. */ +class OutboundMessage( + @JvmField val kind: String?, + @JvmField val label: String?, + @JvmField val sid: Int, + @JvmField val flag: Int, + @JvmField var magic: Int, + message: ByteArray?, + @JvmField val ackTimeoutMs: Int, + @JvmField val tileIndex: Int, + @JvmField val isLeftArmMessage: Boolean, +) { + @JvmField val message: ByteArray = message?.copyOf() ?: ByteArray(0) + @JvmField + val cfwChecksum: Int = if (sid == CfwTransport.SID) CfwTransport.crc(this.message) else 0 + @JvmField var cfwAckLenses = 0 + @JvmField var cfwRetries = 0 + @JvmField var cfwRetryPending = false + @JvmField var imageUpdateId = 0 + @JvmField var imageMessageNumber = 0 + @JvmField var imageMessageCount = 0 + @JvmField var sentAtMs = 0L + @JvmField var writeStartedAtMs = 0L + @JvmField var ackDeadlineAtMs = 0L + @JvmField var ackPayload = ByteArray(0) + @JvmField var onSent: MessageCallback? = null + @JvmField var onAck: MessageCallback? = null + @JvmField var onTimeout: MessageCallback? = null + + /** NACK names this attempt's sequence, even without a decoded size. */ + fun acceptCfwAck(ack: CfwTransport.Ack?): Boolean { + if ( + ack == null || + sid != CfwTransport.SID || + magic != ack.streamId || + ack.messageId != 0 || + (ack.lens != 1 && ack.lens != 2) + ) + return false + if (ack.nack) { + cfwRetryPending = true + return false + } + if (message.size != ack.size || cfwChecksum != ack.checksum) return false + cfwAckLenses = cfwAckLenses or ack.lens + return !cfwRetryPending && cfwAckLenses == CfwTransport.BOTH + } + + /** Replace an attempt atomically under the communicator lock. */ + fun prepareCfwReplay(streamId: Int) { + magic = streamId + cfwRetries++ + cfwAckLenses = 0 + cfwRetryPending = false + ackDeadlineAtMs = 0 + ackPayload = ByteArray(0) + } + + fun setImageUpdatePosition(updateId: Int, messageNumber: Int, messageCount: Int) { + imageUpdateId = updateId + imageMessageNumber = messageNumber + imageMessageCount = messageCount + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/ProtocolPlatform.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/ProtocolPlatform.kt new file mode 100644 index 00000000..ab7691f0 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/ProtocolPlatform.kt @@ -0,0 +1,46 @@ +package com.faceclaw.app + +/** OS services used by the protocol state machines; supplied by their owner. */ +interface ProtocolPlatform { + /** Monotonic milliseconds since boot, including time spent asleep. */ + fun elapsedRealtimeMs(): Long + + fun createLock(): ProtocolLock + + fun createDeflater(): ProtocolDeflater +} + +/** Must be reentrant: transport encoding can reset its history under the lock. */ +interface ProtocolLock { + fun lock() + + fun unlock() +} + +/** Persistent zlib stream. Each write completes a SYNC_FLUSH, not a new stream. */ +interface ProtocolDeflater { + fun reset() + + fun syncFlush(message: ByteArray): ByteArray + + fun close() +} + +internal inline fun ProtocolLock.withLock(action: () -> T): T { + lock() + try { + return action() + } finally { + unlock() + } +} + +enum class GattWriteMode { + WITH_RESPONSE, + WITHOUT_RESPONSE, +} + +/** Keeps message callbacks independent of java.lang.Runnable. */ +fun interface MessageCallback { + fun run() +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/TextureCacheState.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/TextureCacheState.kt new file mode 100644 index 00000000..623ff165 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/TextureCacheState.kt @@ -0,0 +1,191 @@ +package com.faceclaw.app + +/** + * Phone-side model of the CFW's flat 256 KiB texture cache (zlib_glue mode 18). The firmware holds + * only bytes; every structural decision — where font tables and glyph images live, what is + * resident, when to start over — is made here. Layout per font: a 96-entry uint32 offset table + * (chars 32..127) whose entries are written lazily as each glyph is uploaded; glyph images are the + * GlyphAtlas cached bytes ([w][h][4bpp RLE]). + * + * Allocation is a bump pointer with reset-on-full: the realistic working set (a few fonts' tables + * plus ~hundreds of glyphs at tens of bytes each) is far below 256 KiB, so eviction sophistication + * buys nothing. After a reset the firmware cache still holds stale bytes; that is safe because a + * draw only ever references (font table entry, glyph image) pairs uploaded in the current + * generation — stale table entries are never named in a mode-20 string. + * + * Upload entries accumulate as complete [offset u32][len u16][data] records and drain into one or + * more standalone mode-18 payloads, each independently valid, enqueued ahead of the image message + * that references them (the transport is FIFO, so no ack round-trip is needed before use). + * + * Not thread-safe by itself: the communicator calls it under its own lock. + */ +class TextureCacheState { + companion object { + const val CACHE_SIZE: Int = 262144 + + private val FONT_TABLE_BYTES: Int = (96 * 4) + } + + private var allocEnd: Int = 0 + + private val fontTableOffsets: MutableMap = HashMap() + + private val glyphOffsets: MutableMap = HashMap() + + private val imageOffsets: MutableMap = HashMap() + + private val pendingEntries: MutableList = ArrayList() + + private var pendingBytes: Int = 0 + + private var generation: Int = 0 + + /** + * Forget everything: the on-glasses cache is gone (session teardown, lease loss) or no longer + * trustworthy (upload timeout), or we ran out of space. Glyphs and images re-upload lazily on + * next use. + */ + fun reset(): Unit { + allocEnd = 0 + fontTableOffsets.clear() + glyphOffsets.clear() + imageOffsets.clear() + pendingEntries.clear() + pendingBytes = 0 + generation++ + } + + /** Bumped by every reset; lets a planner detect a mid-plan reset. */ + fun generation(): Int { + return generation + } + + /** + * Bytes currently allocated out of CACHE_SIZE, for logging/tuning (a sudden drop in the frame + * log means a reset-on-full re-upload cycle — the signal that the 256 KiB budget is being + * outgrown). + */ + fun usedBytes(): Int { + return allocEnd + } + + /** + * The font's 96-entry table offset in the cache, or -1 when it exists but this glyph can't fit. + */ + fun fontTableOffset(fontId: Int): Int { + var existing: Int? = fontTableOffsets.get(fontId) + return (if ((existing == null)) -1 else existing) + } + + /** + * Ensure a glyph image (and its font table slot) is resident, queuing the mode-18 upload + * entries for anything newly placed. Returns the glyph's image offset, or -1 when the cache is + * full (caller resets and retries) or the encoding is outside the mode-20 table (32..127). + */ + fun ensureGlyph(fontId: Int, encoding: Int, glyph: GlyphAtlas.Glyph?): Int { + if ((((glyph == null) || (encoding < 32)) || (encoding > 127))) { + return -1 + } + var key: Long = (((fontId).toLong() shl 32) or (encoding.toLong() and 0xffffffffL)) + var existing: Int? = glyphOffsets.get(key) + if ((existing != null)) { + return existing + } + var table: Int? = fontTableOffsets.get(fontId) + var need: Int = (glyph.cachedBytes.size + (if ((table == null)) FONT_TABLE_BYTES else 0)) + if (((allocEnd + need) > CACHE_SIZE)) { + return -1 + } + if ((table == null)) { + table = allocEnd + allocEnd += FONT_TABLE_BYTES + fontTableOffsets.put(fontId, table) + } + var offset: Int = allocEnd + allocEnd += glyph.cachedBytes.size + glyphOffsets.put(key, offset) + addEntry(offset, glyph.cachedBytes) + addEntry( + (table + (4 * (encoding - 32))), + byteArrayOf( + (offset).toByte(), + ((offset shr 8)).toByte(), + ((offset shr 16)).toByte(), + ((offset shr 24)).toByte(), + ), + ) + return offset + } + + /** + * Ensure an ImageAtlas entry is resident (mode-19 draws reference it by raw cache offset; no + * table involved). Returns the image offset, or -1 when the cache is full (caller resets and + * retries). + */ + fun ensureImage(imageId: Int, image: ImageAtlas.Entry?): Int { + if ((image == null)) { + return -1 + } + var existing: Int? = imageOffsets.get(imageId) + if ((existing != null)) { + return existing + } + if (((allocEnd + image.cachedBytes.size) > CACHE_SIZE)) { + return -1 + } + var offset: Int = allocEnd + allocEnd += image.cachedBytes.size + imageOffsets.put(imageId, offset) + addEntry(offset, image.cachedBytes) + return offset + } + + private fun addEntry(offset: Int, data: ByteArray): Unit { + var entry: ByteArray = ByteArray((6 + data.size)) + entry[0] = ((offset and 0xff)).toByte() + entry[1] = (((offset shr 8) and 0xff)).toByte() + entry[2] = (((offset shr 16) and 0xff)).toByte() + entry[3] = (((offset shr 24) and 0xff)).toByte() + entry[4] = ((data.size and 0xff)).toByte() + entry[5] = (((data.size shr 8) and 0xff)).toByte() + data.copyInto(entry, 6, 0, 0 + data.size) + pendingEntries.add(entry) + pendingBytes += entry.size + } + + fun hasPendingUploads(): Boolean { + return !pendingEntries.isEmpty() + } + + /** Total queued upload bytes (entry framing included), for logging. */ + fun pendingUploadBytes(): Int { + return pendingBytes + } + + /** + * Drain the queued entries into complete mode-18 payloads ([18][entries]), each at most + * maxPayloadBytes so a payload fits one BLE image message without fragmentation. A single entry + * larger than the cap still gets its own payload (the transport can fragment it). + */ + fun drainUploadPayloads(maxPayloadBytes: Int): MutableList { + var payloads: MutableList = ArrayList() + var current: ByteSink? = null + for (entry in pendingEntries) { + if (((current != null) && ((current.size() + entry.size) > maxPayloadBytes))) { + payloads.add(current.toByteArray()) + current = null + } + if ((current == null)) { + current = ByteSink(minOf(maxPayloadBytes, (4 + entry.size))) + current.write(18) + } + current.write(entry, 0, entry.size) + } + if ((current != null)) { + payloads.add(current.toByteArray()) + } + pendingEntries.clear() + pendingBytes = 0 + return payloads + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/TexturePlanner.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/TexturePlanner.kt new file mode 100644 index 00000000..6effc438 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/TexturePlanner.kt @@ -0,0 +1,987 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmField +import kotlin.jvm.JvmStatic + +/** + * Plans a screen update that ships text and icons as on-glasses cached draws instead of pixels (CFW + * modes 18/19/20; see g2flash/patches/zlib_glue.c and texture_cache.c). + * + * Approach: dirty rects come from comparing the fully composited old and new frames, exactly as the + * plain incremental path does. For each deferred draw (glyph or image) whose pixels intersect a + * sent rect, check that every pixel the on-glasses draw would write lands correct — i.e. the new + * composite's 4bpp value at each in-panel nonzero-source pixel equals what the draw produces (this + * one check subsumes plane occlusion, surface occlusion/clipping, and draw-on-draw overlap). A draw + * that passes and is (or can be made) resident in the texture cache is replayed on-glasses: its + * written pixels are punched to 0 in the delta rect content — which is what makes text and icons + * nearly free to compress — and re-emitted as a mode-20 string or mode-19 image sub-message in the + * same atomic mode-8 batch, so the shadow after apply equals the full composite exactly. Everything + * else stays baked. + * + * Fallback shape: when nothing qualifies, plan() returns null and the caller uses the plain + * single-bbox/multi-rect/full-frame paths unchanged. + */ +class TexturePlanner { + companion object { + /** Cap on mode-20 string sub-messages (mode-8 count is a u8). */ + private const val MAX_GLYPH_RUNS: Int = 180 + + /** + * Soft cap on cached-glyph selection per update, before run grouping. Sized above a + * full-screen 6x12 terminal repaint (~4,240 cells) so dense screens draw everything; the + * run budget is the real bound. + */ + private const val MAX_SELECTED_GLYPHS: Int = 4600 + + /** Cap on mode-19 image sub-messages per update. */ + private const val MAX_IMAGE_DRAWS: Int = 60 + + /** Cap on mode-15 builtin-font string sub-messages per update. */ + private const val MAX_FWTEXT_RUNS: Int = 80 + + /** Mode-18 payload size that fits one BLE image message comfortably. */ + private const val UPLOAD_PAYLOAD_MAX: Int = 3600 + + /** Max x-adjust control bytes between two glyphs before starting a new run. */ + private const val MAX_ADJUST_BYTES: Int = 4 + + /** Options: identity LUT (top 15) + transparent, for mode-19 image draws. */ + private const val IMAGE_DRAW_OPTIONS: Int = 0x1f + + /** + * Plan a cached-draw update. previous is the delta base (the frame the shadow currently + * holds), or null/mismatched for a full-frame keyframe. Returns null when the plain paths + * should run instead (no replayable draws, or identical frames). + */ + @JvmStatic + fun plan( + previous: ByteArray?, + next: ByteArray?, + width: Int, + height: Int, + draws: Array?, + cache: TextureCacheState, + fidStart: Int, + allowMultiRect: Boolean, + maxRects: Int, + ): Result? { + if ( + (((((next == null) || (draws == null)) || (draws.size == 0)) || (width <= 0)) || + (height <= 0)) + ) { + return null + } + var stride: Int = ((width + 1) shr 1) + if ((next.size != (stride * height))) { + return null + } + var planStartedAtMs: Long = protocolPlatform().elapsedRealtimeMs() + var fullFrame: Boolean = ((previous == null) || (previous.size != next.size)) + var rects: MutableList + if (!fullFrame) { + var box: IntArray? = + BleImageOptimizer.computeChangedBox(previous, next, width, height) + if ((box == null)) { + return null + } + if (((box[2] >= width) && (box[3] >= height))) { + fullFrame = true + rects = mutableListOf(intArrayOf(0, 0, width, height)) + } else { + var split: MutableList? = + (if (allowMultiRect) + BleImageOptimizer.computeChangedRects( + previous, + next, + width, + height, + maxRects, + ) + else null) + rects = (if ((split != null)) split else mutableListOf(box)) + } + } else { + rects = mutableListOf(intArrayOf(0, 0, width, height)) + } + var matchStartedAtMs: Long = protocolPlatform().elapsedRealtimeMs() + var selected: MutableList = ArrayList() + var bakedCandidates: Int = 0 + var selectedImages: Int = 0 + var fwSubs: MutableList = ArrayList() + var fwPunches: MutableList = ArrayList() + var fwGlyphCount: Int = 0 + var fwBaked: Int = 0 + for (draw in draws) { + if ((draw.kind != SurfaceCompositor.ScreenDraw.KIND_FWTEXT)) { + continue + } + fwBaked += planFwRun(draw, rects, next, stride, width, height, fwSubs, fwPunches) + } + fwGlyphCount = fwPunches.size + bakedCandidates += fwBaked + for (draw in draws) { + if ((draw.kind == SurfaceCompositor.ScreenDraw.KIND_GLYPH)) { + var atlas: GlyphAtlas.Glyph? = GlyphAtlas.get(draw.fontId, draw.encoding) + if ((atlas == null)) { + continue + } + var gx: Int = (draw.x + atlas.bbxX) + var inkTop: Int = (draw.y + atlas.inkTop) + if (!intersectsAny(rects, gx, inkTop, atlas.width, atlas.inkHeight)) { + continue + } + if ( + ((((((draw.encoding < 32) || (draw.encoding > 127)) || (gx < 0)) || + (draw.y < 0)) || (gx > 0xffff)) || (draw.y > 0xffff)) + ) { + bakedCandidates++ + continue + } + var top: Int = BmpUtil.nibbleForGray(draw.value) + if ( + !glyphMatchesComposite(next, stride, width, height, atlas, gx, draw.y, top) + ) { + bakedCandidates++ + continue + } + if ((selected.size >= MAX_SELECTED_GLYPHS)) { + bakedCandidates++ + continue + } + selected.add(Selected(draw, atlas, null, gx, top)) + } else { + var atlas: ImageAtlas.Entry? = ImageAtlas.get(draw.imageId) + if ((atlas == null)) { + continue + } + if (!intersectsAny(rects, draw.x, draw.y, atlas.width, atlas.height)) { + continue + } + if ( + (((((draw.x < 0) || (draw.y < 0)) || (draw.x > 0xffff)) || + (draw.y > 0xffff)) || (selectedImages >= MAX_IMAGE_DRAWS)) + ) { + bakedCandidates++ + continue + } + if ( + !imageMatchesComposite(next, stride, width, height, atlas, draw.x, draw.y) + ) { + bakedCandidates++ + continue + } + selected.add(Selected(draw, null, atlas, draw.x, 0)) + selectedImages++ + } + } + if ((selected.isEmpty() && fwSubs.isEmpty())) { + return null + } + var cacheStartedAtMs: Long = protocolPlatform().elapsedRealtimeMs() + var drawable: MutableList = + (if (selected.isEmpty()) mutableListOf() else ensureResident(cache, selected)) + bakedCandidates += (selected.size - drawable.size) + var glyphDrawable: MutableList = ArrayList() + var imageDrawable: MutableList = ArrayList() + for (sel in drawable) { + if ((sel.glyphAtlas != null)) { + glyphDrawable.add(sel) + } else { + imageDrawable.add(sel) + } + } + var runs: MutableList = ArrayList() + var drawnGlyphs: MutableList = buildRuns(cache, glyphDrawable, runs) + bakedCandidates += (glyphDrawable.size - drawnGlyphs.size) + var drawn: MutableList = ArrayList(drawnGlyphs) + drawn.addAll(imageDrawable) + if ( + ((drawn.isEmpty() && fwSubs.isEmpty()) || + ((((rects.size + runs.size) + imageDrawable.size) + fwSubs.size) > 255)) + ) { + if (!selected.isEmpty()) { + cache.reset() + } + return null + } + var punchStartedAtMs: Long = protocolPlatform().elapsedRealtimeMs() + var punched: ByteArray = next.copyOf() + for (sel in drawn) { + punch(punched, stride, width, height, sel) + } + for (fw in fwPunches) { + punchFw(punched, stride, width, height, fw) + } + var encodeStartedAtMs: Long = protocolPlatform().elapsedRealtimeMs() + var subs: MutableList = ArrayList() + var fid: Int = fidStart + if (fullFrame) { + subs.add(BleImageOptimizer.maybeCompress(punched, width, height)) + } else { + for (r in rects) { + subs.add( + BleImageOptimizer.encodeMode3Rect( + punched, + stride, + r[0], + r[1], + r[2], + r[3], + fid, + ) + ) + fid = (if ((fid >= 0xfffe)) 1 else (fid + 1)) + } + } + for (sel in imageDrawable) { + subs.add(encodeImageDraw(cache, sel)) + } + subs.addAll(runs) + subs.addAll(fwSubs) + var payload: ByteArray = assembleMode8(subs) + var uploadBytes: Int = cache.pendingUploadBytes() + var uploads: MutableList = cache.drainUploadPayloads(UPLOAD_PAYLOAD_MAX) + var result: Result = + Result( + payload, + uploads, + fid, + rects.size, + drawnGlyphs.size, + runs.size, + imageDrawable.size, + fwGlyphCount, + fwSubs.size, + bakedCandidates, + uploadBytes, + fullFrame, + ) + var doneAtMs: Long = protocolPlatform().elapsedRealtimeMs() + result.rectsMs = ((matchStartedAtMs - planStartedAtMs)).toInt() + result.matchMs = ((cacheStartedAtMs - matchStartedAtMs)).toInt() + result.cacheMs = ((punchStartedAtMs - cacheStartedAtMs)).toInt() + result.punchMs = ((encodeStartedAtMs - punchStartedAtMs)).toInt() + result.encodeMs = ((doneAtMs - encodeStartedAtMs)).toInt() + return result + } + + /** + * Plan one firmware-font run (mode 15): classify every member, and when any correct ink + * member intersects a sent rect, emit sub-messages over the maximal correct stretches. A + * stretch never spans an incorrect member — the sub-message boundary restarts the + * firmware's advance walk at an explicit pen x, so occluded or unknown glyphs simply stay + * baked without disturbing their neighbors' positions. Emitted ink members are queued for + * punching. Returns how many ink members stay baked. + */ + private fun planFwRun( + draw: SurfaceCompositor.ScreenDraw, + rects: MutableList, + next: ByteArray, + stride: Int, + width: Int, + height: Int, + outSubs: MutableList, + outPunches: MutableList, + ): Int { + var n: Int = draw.fwCps!!.size + if ((((n == 0) || (draw.y < 0)) || (draw.y > 0xffff))) { + return countInk(draw) + } + var top: Int = BmpUtil.nibbleForGray(draw.value) + var ok: BooleanArray = BooleanArray(n) + var entries: Array = arrayOfNulls(n) + var relevant: Boolean = false + var baked: Int = 0 + run { + var i: Int = 0 + while ((i < n)) { + if (!draw.fwInk!![i]) { + ok[i] = true + i++ + continue + } + var entry: FwGlyphAtlas.Entry? = FwGlyphAtlas.get(draw.fwCps!![i]) + if ((entry == null)) { + baked++ + i++ + continue + } + var gx: Int = ((draw.x + draw.fwDx!![i]) + entry.ofsX) + var gy: Int = (draw.y + entry.inkTop) + if (!fwGlyphMatchesComposite(next, stride, width, height, entry, gx, gy, top)) { + baked++ + i++ + continue + } + ok[i] = true + entries[i] = entry + if (intersectsAny(rects, gx, gy, entry.boxW, entry.boxH)) { + relevant = true + } + i++ + } + } + if (!relevant) { + return 0 + } + var i: Int = 0 + while (((i < n) && (outSubs.size < MAX_FWTEXT_RUNS))) { + while (((i < n) && !(ok[i] && draw.fwInk!![i]))) { + i++ + } + if ((i >= n)) { + break + } + var startX: Int = (draw.x + draw.fwDx!![i]) + if (((startX < 0) || (startX > 0xffff))) { + baked++ + i++ + continue + } + var j: Int = i + var lastInk: Int = -1 + var bytesToLastInk: Int = 0 + var bytesSoFar: Int = 0 + while (((j < n) && ok[j])) { + var encodedLength: Int = utf8Length(draw.fwCps!![j]) + if (((bytesSoFar + encodedLength) > 255)) { + break + } + bytesSoFar += encodedLength + if (draw.fwInk!![j]) { + lastInk = j + bytesToLastInk = bytesSoFar + } + j++ + } + if ((lastInk < i)) { + baked++ + i++ + continue + } + var sub: ByteArray = ByteArray((7 + bytesToLastInk)) + sub[0] = 15 + sub[1] = ((startX and 0xff)).toByte() + sub[2] = (((startX shr 8) and 0xff)).toByte() + sub[3] = ((draw.y and 0xff)).toByte() + sub[4] = (((draw.y shr 8) and 0xff)).toByte() + sub[5] = ((top or 0x10)).toByte() + sub[6] = (bytesToLastInk).toByte() + var pos: Int = 7 + run { + var k: Int = i + while ((k <= lastInk)) { + var encoded: ByteArray = codePointUtf8(draw.fwCps!![k]) + encoded.copyInto(sub, pos, 0, 0 + encoded.size) + pos += encoded.size + k++ + } + } + outSubs.add(sub) + run { + var k: Int = i + while ((k <= lastInk)) { + if (draw.fwInk!![k]) { + outPunches.add( + FwPunch( + entries[k]!!, + ((draw.x + draw.fwDx!![k]) + entries[k]!!.ofsX), + (draw.y + entries[k]!!.inkTop), + ) + ) + } + k++ + } + } + i = (lastInk + 1) + } + return baked + } + + private fun utf8Length(cp: Int): Int { + if ((cp < 0x80)) { + return 1 + } + if ((cp < 0x800)) { + return 2 + } + if ((cp < 0x10000)) { + return 3 + } + return 4 + } + + private fun countInk(draw: SurfaceCompositor.ScreenDraw): Int { + var count: Int = 0 + for (ink in draw.fwInk!!) { + if (ink) { + count++ + } + } + return count + } + + /** + * Whether every in-panel nonzero pixel of the builtin-font glyph lands correct: the + * composite's 4bpp value must equal the firmware's LUT output src*top/15 (integer division + * — a general LUT check, since these glyphs are anti-aliased). + */ + private fun fwGlyphMatchesComposite( + packed: ByteArray, + stride: Int, + width: Int, + height: Int, + entry: FwGlyphAtlas.Entry, + gx: Int, + gy: Int, + top: Int, + ): Boolean { + run { + var row: Int = 0 + while ((row < entry.boxH)) { + var y: Int = (gy + row) + if (((y < 0) || (y >= height))) { + row++ + continue + } + run { + var col: Int = 0 + while ((col < entry.boxW)) { + var source: Int = entry.nibbleAt(col, row) + if ((source == 0)) { + col++ + continue + } + var x: Int = (gx + col) + if (((x < 0) || (x >= width))) { + col++ + continue + } + if ((nibbleAt(packed, stride, x, y) != ((source * top) / 15))) { + return false + } + col++ + } + } + row++ + } + } + return true + } + + private fun punchFw( + packed: ByteArray, + stride: Int, + width: Int, + height: Int, + fw: FwPunch, + ): Unit { + run { + var row: Int = 0 + while ((row < fw.entry.boxH)) { + var y: Int = (fw.gy + row) + if (((y < 0) || (y >= height))) { + row++ + continue + } + run { + var col: Int = 0 + while ((col < fw.entry.boxW)) { + if ((fw.entry.nibbleAt(col, row) == 0)) { + col++ + continue + } + punchPixel(packed, stride, width, (fw.gx + col), y) + col++ + } + } + row++ + } + } + } + + private fun intersectsAny( + rects: MutableList, + x: Int, + y: Int, + w: Int, + h: Int, + ): Boolean { + if (((w <= 0) || (h <= 0))) { + return false + } + for (r in rects) { + if ( + ((((x < (r[0] + r[2])) && ((x + w) > r[0])) && (y < (r[1] + r[3]))) && + ((y + h) > r[1])) + ) { + return true + } + } + return false + } + + /** + * Whether every in-panel ink pixel of the glyph lands correct in the packed new frame: the + * composite's 4bpp value must equal the firmware's LUT output source*top/15 (integer). For + * 1bpp glyphs (source 15) this is exactly `== top`; AA glyphs get the general check. Ink + * outside the panel is clipped by the firmware and irrelevant. + */ + private fun glyphMatchesComposite( + packed: ByteArray, + stride: Int, + width: Int, + height: Int, + atlas: GlyphAtlas.Glyph, + gx: Int, + lineY: Int, + top: Int, + ): Boolean { + run { + var row: Int = atlas.inkTop + while ((row < (atlas.inkTop + atlas.inkHeight))) { + var y: Int = (lineY + row) + if (((y < 0) || (y >= height))) { + row++ + continue + } + run { + var col: Int = 0 + while ((col < atlas.width)) { + var source: Int = atlas.nibbleAt(col, row) + if ((source == 0)) { + col++ + continue + } + var x: Int = (gx + col) + if (((x < 0) || (x >= width))) { + col++ + continue + } + if ((nibbleAt(packed, stride, x, y) != ((source * top) / 15))) { + return false + } + col++ + } + } + row++ + } + } + return true + } + + /** + * Whether every in-panel nonzero pixel of the cached image equals the packed new frame — + * the mode-19 transparent draw writes exactly those. + */ + private fun imageMatchesComposite( + packed: ByteArray, + stride: Int, + width: Int, + height: Int, + atlas: ImageAtlas.Entry, + left: Int, + top: Int, + ): Boolean { + run { + var row: Int = 0 + while ((row < atlas.height)) { + var y: Int = (top + row) + if (((y < 0) || (y >= height))) { + row++ + continue + } + run { + var col: Int = 0 + while ((col < atlas.width)) { + var source: Int = atlas.nibbleAt(col, row) + if ((source == 0)) { + col++ + continue + } + var x: Int = (left + col) + if (((x < 0) || (x >= width))) { + col++ + continue + } + if ((nibbleAt(packed, stride, x, y) != source)) { + return false + } + col++ + } + } + row++ + } + } + return true + } + + private fun nibbleAt(packed: ByteArray, stride: Int, x: Int, y: Int): Int { + var b: Int = (packed[((y * stride) + (x shr 1))] and 0xff) + return (if (((x and 1) != 0)) (b and 0x0f) else (b shr 4)) + } + + private fun punch( + packed: ByteArray, + stride: Int, + width: Int, + height: Int, + sel: Selected, + ): Unit { + if ((sel.glyphAtlas != null)) { + var atlas: GlyphAtlas.Glyph = sel.glyphAtlas + run { + var row: Int = atlas.inkTop + while ((row < (atlas.inkTop + atlas.inkHeight))) { + var y: Int = (sel.draw.y + row) + if (((y < 0) || (y >= height))) { + row++ + continue + } + run { + var col: Int = 0 + while ((col < atlas.width)) { + if (!atlas.inkAt(col, row)) { + col++ + continue + } + punchPixel(packed, stride, width, (sel.gx + col), y) + col++ + } + } + row++ + } + } + } else { + var atlas: ImageAtlas.Entry = sel.imageAtlas!! + run { + var row: Int = 0 + while ((row < atlas.height)) { + var y: Int = (sel.draw.y + row) + if (((y < 0) || (y >= height))) { + row++ + continue + } + run { + var col: Int = 0 + while ((col < atlas.width)) { + if ((atlas.nibbleAt(col, row) == 0)) { + col++ + continue + } + punchPixel(packed, stride, width, (sel.gx + col), y) + col++ + } + } + row++ + } + } + } + } + + private fun punchPixel(packed: ByteArray, stride: Int, width: Int, x: Int, y: Int): Unit { + if (((x < 0) || (x >= width))) { + return + } + var index: Int = ((y * stride) + (x shr 1)) + if (((x and 1) != 0)) { + packed[index] = ((packed[index] and 0xf0)).toByte() + } else { + packed[index] = ((packed[index] and 0x0f)).toByte() + } + } + + /** + * Ensure residency for all of `selected`, resetting the cache once if the allocator fills + * mid-plan (a reset invalidates offsets handed out earlier in the same pass, so the whole + * pass reruns). Returns the draws that are resident afterwards. + */ + private fun ensureResident( + cache: TextureCacheState, + selected: MutableList, + ): MutableList { + run { + var attempt: Int = 0 + while ((attempt < 2)) { + var resident: MutableList = ArrayList(selected.size) + var full: Boolean = false + for (sel in selected) { + var offset: Int = + (if ((sel.glyphAtlas != null)) + cache.ensureGlyph( + sel.draw.fontId, + sel.draw.encoding, + sel.glyphAtlas, + ) + else cache.ensureImage(sel.draw.imageId, sel.imageAtlas)) + if ((offset >= 0)) { + resident.add(sel) + } else { + full = true + } + } + if ((!full || (attempt == 1))) { + return resident + } + cache.reset() + attempt++ + } + } + return mutableListOf() + } + + /** Mode-19 cached-image draw: [19][offset u32][x u16][y u16][options u8]. */ + @JvmStatic + private fun encodeImageDraw(cache: TextureCacheState, sel: Selected): ByteArray { + var offset: Int = cache.ensureImage(sel.draw.imageId, sel.imageAtlas) + var sub: ByteArray = ByteArray(10) + sub[0] = 19 + sub[1] = ((offset and 0xff)).toByte() + sub[2] = (((offset shr 8) and 0xff)).toByte() + sub[3] = (((offset shr 16) and 0xff)).toByte() + sub[4] = (((offset shr 24) and 0xff)).toByte() + sub[5] = ((sel.draw.x and 0xff)).toByte() + sub[6] = (((sel.draw.x shr 8) and 0xff)).toByte() + sub[7] = ((sel.draw.y and 0xff)).toByte() + sub[8] = (((sel.draw.y shr 8) and 0xff)).toByte() + sub[9] = (IMAGE_DRAW_OPTIONS).toByte() + return sub + } + + /** + * Group selected glyphs into mode-20 string sub-messages: [20][fontTable u32][x u16][y + * u16][options u8][strlen u8][string] One run per (font, line y, top color) span; within a + * run, control bytes 1..31 adjust x by -10..+20 to hit each glyph's exact position, and + * each glyph advances x by its cached width. Order across runs is free: every drawn glyph's + * ink equals the composite, so overlaps write equal values. Returns the glyphs actually + * emitted (run budget can drop stragglers). + */ + @JvmStatic + private fun buildRuns( + cache: TextureCacheState, + drawable: MutableList, + outRuns: MutableList, + ): MutableList { + var sorted: MutableList = ArrayList(drawable) + sorted.sortWith( + compareBy { it.draw.fontId } + .thenBy { it.draw.y } + .thenBy { it.top } + .thenBy { it.gx } + ) + var drawn: MutableList = ArrayList(sorted.size) + var i: Int = 0 + while (((i < sorted.size) && (outRuns.size < MAX_GLYPH_RUNS))) { + var first: Selected = sorted.get(i) + var fontTable: Int = cache.fontTableOffset(first.draw.fontId) + if ((fontTable < 0)) { + i++ + continue + } + var string: ByteSink = ByteSink() + var runGlyphs: MutableList = ArrayList() + var cursor: Int = first.gx + var j: Int = i + while ((j < sorted.size)) { + var sel: Selected = sorted.get(j) + if ( + (((sel.draw.fontId != first.draw.fontId) || (sel.draw.y != first.draw.y)) || + (sel.top != first.top)) + ) { + break + } + var delta: Int = (sel.gx - cursor) + var adjustBytes: Int = adjustByteCount(delta) + if (((adjustBytes > MAX_ADJUST_BYTES) && (j > i))) { + break + } + if ((((string.size() + adjustBytes) + 1) > 255)) { + break + } + emitAdjust(string, delta) + string.write(sel.draw.encoding) + runGlyphs.add(sel) + cursor = (sel.gx + sel.glyphAtlas!!.width) + j++ + } + if (!runGlyphs.isEmpty()) { + var stringBytes: ByteArray = string.toByteArray() + var run: ByteArray = ByteArray((11 + stringBytes.size)) + run[0] = 20 + run[1] = ((fontTable and 0xff)).toByte() + run[2] = (((fontTable shr 8) and 0xff)).toByte() + run[3] = (((fontTable shr 16) and 0xff)).toByte() + run[4] = (((fontTable shr 24) and 0xff)).toByte() + run[5] = ((first.gx and 0xff)).toByte() + run[6] = (((first.gx shr 8) and 0xff)).toByte() + run[7] = ((first.draw.y and 0xff)).toByte() + run[8] = (((first.draw.y shr 8) and 0xff)).toByte() + run[9] = ((first.top or 0x10)).toByte() + run[10] = (stringBytes.size).toByte() + stringBytes.copyInto(run, 11, 0, 0 + stringBytes.size) + outRuns.add(run) + drawn.addAll(runGlyphs) + i = j + } else { + i++ + } + } + return drawn + } + + /** How many 1..31 control bytes are needed to move the cursor by delta. */ + private fun adjustByteCount(delta: Int): Int { + if ((delta == 0)) { + return 0 + } + return (if ((delta > 0)) ((delta + 19) / 20) else ((-delta + 9) / 10)) + } + + private fun emitAdjust(out: ByteSink, delta: Int): Unit { + var delta = delta + while ((delta != 0)) { + var step: Int = (if ((delta > 0)) minOf(delta, 20) else maxOf(delta, -10)) + out.write((step + 11)) + delta -= step + } + } + + /** [8][count]([len u16][sub])* — one atomic present for deltas + draws. */ + private fun assembleMode8(subs: MutableList): ByteArray { + var total: Int = 2 + for (sub in subs) { + total += (2 + sub.size) + } + var out: ByteArray = ByteArray(total) + out[0] = 8 + out[1] = (subs.size).toByte() + var pos: Int = 2 + for (sub in subs) { + out[pos] = ((sub.size and 0xff)).toByte() + out[(pos + 1)] = (((sub.size shr 8) and 0xff)).toByte() + pos += 2 + sub.copyInto(out, pos, 0, 0 + sub.size) + pos += sub.size + } + return out + } + } + + constructor() {} + + class Result { + /** Complete image payload: a mode-8 batch of rect deltas + cached draws. */ + @JvmField val payload: ByteArray + + /** Mode-18 upload payloads to enqueue BEFORE the image message. */ + @JvmField val uploads: MutableList + + /** Next mode-3 frame id (deltas consumed some). */ + @JvmField val nextFid: Int + + @JvmField val rectCount: Int + + @JvmField val drawnGlyphs: Int + + @JvmField val runCount: Int + + @JvmField val drawnImages: Int + + @JvmField val fwGlyphs: Int + + @JvmField val fwRuns: Int + + @JvmField val bakedCandidates: Int + + @JvmField val uploadBytes: Int + + @JvmField val fullFrame: Boolean + + /** + * Where the planning time went, in ms. This runs on the send thread, directly in the + * input-to-display path, so the split is reported in the frame log: rects = finding the + * changed region, match = checking each draw against the composite, cache = + * residency/uploads plus run building, punch = clearing replayed draws out of a copy of the + * frame, encode = compressing the leftover pixels. + */ + @JvmField var rectsMs: Int = 0 + + @JvmField var matchMs: Int = 0 + + @JvmField var cacheMs: Int = 0 + + @JvmField var punchMs: Int = 0 + + @JvmField var encodeMs: Int = 0 + + constructor( + payload: ByteArray, + uploads: MutableList, + nextFid: Int, + rectCount: Int, + drawnGlyphs: Int, + runCount: Int, + drawnImages: Int, + fwGlyphs: Int, + fwRuns: Int, + bakedCandidates: Int, + uploadBytes: Int, + fullFrame: Boolean, + ) { + this.payload = payload + this.uploads = uploads + this.nextFid = nextFid + this.rectCount = rectCount + this.drawnGlyphs = drawnGlyphs + this.runCount = runCount + this.drawnImages = drawnImages + this.fwGlyphs = fwGlyphs + this.fwRuns = fwRuns + this.bakedCandidates = bakedCandidates + this.uploadBytes = uploadBytes + this.fullFrame = fullFrame + } + } + + /** One draw selected for on-glasses replay. */ + private class Selected { + @JvmField val draw: SurfaceCompositor.ScreenDraw + + @JvmField val glyphAtlas: GlyphAtlas.Glyph? + + @JvmField val imageAtlas: ImageAtlas.Entry? + + @JvmField val gx: Int + + @JvmField val top: Int + + constructor( + draw: SurfaceCompositor.ScreenDraw, + glyphAtlas: GlyphAtlas.Glyph?, + imageAtlas: ImageAtlas.Entry?, + gx: Int, + top: Int, + ) { + this.draw = draw + this.glyphAtlas = glyphAtlas + this.imageAtlas = imageAtlas + this.gx = gx + this.top = top + } + } + + /** One punch task for an emitted firmware-font glyph. */ + private class FwPunch { + @JvmField val entry: FwGlyphAtlas.Entry + + @JvmField val gx: Int + + @JvmField val gy: Int + + constructor(entry: FwGlyphAtlas.Entry, gx: Int, gy: Int) { + this.entry = entry + this.gx = gx + this.gy = gy + } + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/FwGlyphAtlas.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/FwGlyphAtlas.kt new file mode 100644 index 00000000..ce972e08 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/FwGlyphAtlas.kt @@ -0,0 +1,89 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmField +import kotlin.jvm.JvmStatic + +/** + * Process-wide registry of the glasses' builtin 20 px font's glyph rasters, fed from the TS side + * (EvenHubFont's extracted firmware font data). Unlike GlyphAtlas/ImageAtlas entries, these are + * never uploaded: the firmware already owns the font, and mode 15 draws it directly. The planner + * needs the rasters purely phone-side — for the "would this draw land correctly" check against the + * composite and for punching drawn ink out of delta rects. + * + * Placement model matches the firmware's mode-15 math: a glyph draws at (penX + ofsX, lineY + + * inkTop) where inkTop already folds in the root font's line height and baseline. The TS side only + * registers glyphs whose on-glasses rendering it predicts exactly (native-table glyphs; baseline- + * shifted fallback symbols stay baked). + */ +class FwGlyphAtlas { + companion object { + private val lock = protocolPlatform().createLock() + + private val entries: MutableMap = HashMap() + + /** + * Register glyph rasters. Little-endian buffer of records: [cp u32][ofsX s16][inkTop + * s16][boxW u8][boxH u8] [boxH x ceil(boxW/2) nibble bytes] Re-registration of a codepoint + * is ignored (the builtin font is fixed). + */ + @JvmStatic + fun register(buffer: ByteReader?): Unit { + if ((buffer == null)) { + return + } + val cursor: ByteReader = buffer + lock.withLock { + while ((cursor.remaining() >= 10)) { + var cp: Int = cursor.getInt() + var ofsX: Int = cursor.getShort().toInt() + var inkTop: Int = cursor.getShort().toInt() + var boxW: Int = (cursor.get() and 0xff) + var boxH: Int = (cursor.get() and 0xff) + var nibbles: ByteArray = ByteArray((((boxW + 1) shr 1) * boxH)) + cursor.get(nibbles) + if ((((boxW > 0) && (boxH > 0)) && !entries.containsKey(cp))) { + entries.put(cp, Entry(ofsX, inkTop, boxW, boxH, nibbles)) + } + } + } + } + + @JvmStatic + fun get(cp: Int): Entry? { + lock.withLock { + return entries.get(cp) + } + } + } + + constructor() {} + + class Entry { + /** Draw x = pen x + ofsX. */ + @JvmField val ofsX: Int + + /** First raster row relative to the run's line-top y. */ + @JvmField val inkTop: Int + + @JvmField val boxW: Int + + @JvmField val boxH: Int + + /** 4bpp rows, stride ceil(boxW/2), high nibble = left pixel. */ + @JvmField val nibbles: ByteArray + + constructor(ofsX: Int, inkTop: Int, boxW: Int, boxH: Int, nibbles: ByteArray) { + this.ofsX = ofsX + this.inkTop = inkTop + this.boxW = boxW + this.boxH = boxH + this.nibbles = nibbles + } + + /** The 4bpp source value at (col, row); the draw skips 0 (transparent). */ + fun nibbleAt(col: Int, row: Int): Int { + var b: Int = (nibbles[((row * ((boxW + 1) shr 1)) + (col shr 1))] and 0xff) + return (if (((col and 1) != 0)) (b and 0x0f) else (b shr 4)) + } + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/GlyphAtlas.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/GlyphAtlas.kt new file mode 100644 index 00000000..97450875 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/GlyphAtlas.kt @@ -0,0 +1,325 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmField +import kotlin.jvm.JvmStatic + +/** + * Process-wide registry of glyph rasters, fed from the TS side so glyph identity survives to the + * BLE encoder (see notes/texture-cache-display-list- design.md). A frame's glyph list references + * entries here by (fontId, encoding); the texture-cache planner uses the raster three ways: + * + * - as the ink mask for the "would this draw land correctly" check against the composited frame, + * - to punch the ink pixels out of the baked delta rect it replaces, + * - pre-encoded as the CFW cached-image bytes ([w][h][4bpp RLE]) uploaded via mode 12 and drawn via + * mode 14 with a top-color LUT. 1bpp (BDF) glyphs store ink at 15 so the LUT maps them to exactly + * the requested level; AA (TTF) glyphs store true coverage nibbles the LUT scales. + * + * Fonts are identified by a stable string key (the embedded font name), NOT a per-JS-context + * counter: worker threads register independently and must agree on ids. Glyph rasters are immutable + * once registered; re-registration of the same (fontId, encoding) is ignored. + * + * Cell model: a cached glyph image is bbxWidth x cellHeight (the font's line height), with the ink + * rows at inkTop — so every glyph of a line is drawn at the same y (the line top), which is what + * lets one mode-14 string carry a whole run. The horizontal bearing (bbxX) is applied phone-side + * when computing the draw x. Vertical padding is nearly free: it RLE-encodes to a couple of tokens. + */ +class GlyphAtlas { + companion object { + private val lock = protocolPlatform().createLock() + + private val fontIds: MutableMap = HashMap() + + private val glyphs: MutableMap = HashMap() + + private var nextFontId: Int = 1 + + /** Stable id for a font key; assigns one on first use. */ + @JvmStatic + fun fontId(key: String): Int { + lock.withLock { + var id: Int? = fontIds.get(key) + if ((id == null)) { + id = nextFontId++ + fontIds.put(key, id) + } + return id + } + } + + @JvmStatic + fun get(fontId: Int, encoding: Int): Glyph? { + lock.withLock { + return glyphs.get(key(fontId, encoding)) + } + } + + private fun key(fontId: Int, encoding: Int): Long { + return (((fontId).toLong() shl 32) or (encoding.toLong() and 0xffffffffL)) + } + + /** + * Register a batch of glyph rasters. Little-endian buffer, a sequence of font groups: + * [keyLen u8][key utf8][cellHeight u8][count u16] each followed by count glyph records: + * [encoding u32][bbxX s8][inkTop u8][width u8][inkHeight u8] [inkHeight x rows u32] (bit + * (ceil(width/8)*8 - 1 - col) = ink) Records for an already-registered (font, encoding) are + * skipped (glyph rasters are immutable for a given font key). Malformed buffers throw: they + * indicate a phone-side marshalling bug, never device state. + */ + @JvmStatic + fun register(buffer: ByteReader?): Unit { + if ((buffer == null)) { + return + } + val cursor: ByteReader = buffer + lock.withLock { + while ((cursor.remaining() > 0)) { + var keyLen: Int = (cursor.get() and 0xff) + var keyBytes: ByteArray = ByteArray(keyLen) + cursor.get(keyBytes) + var fontKey: String = keyBytes.decodeToString() + var cellHeight: Int = (cursor.get() and 0xff) + var count: Int = (cursor.getShort().toInt() and 0xffff) + var idBoxed: Int? = fontIds.get(fontKey) + var id: Int = 0 + if ((idBoxed == null)) { + id = nextFontId++ + fontIds.put(fontKey, id) + } else { + id = idBoxed + } + run { + var g: Int = 0 + while ((g < count)) { + var encoding: Int = cursor.getInt() + val bbxX: Int = cursor.get().toInt() + var inkTop: Int = (cursor.get() and 0xff) + var width: Int = (cursor.get() and 0xff) + var inkHeight: Int = (cursor.get() and 0xff) + val rows: IntArray = IntArray(inkHeight) + run { + var r: Int = 0 + while ((r < inkHeight)) { + rows[r] = cursor.getInt() + r++ + } + } + var k: Long = key(id, encoding) + if ( + (((!glyphs.containsKey(k) && (width > 0)) && (cellHeight > 0)) && + ((inkTop + inkHeight) <= cellHeight)) + ) { + glyphs.put( + k, + Glyph(width, cellHeight, inkTop, inkHeight, bbxX, rows, null), + ) + } + g++ + } + } + } + } + } + + /** + * Register a batch of antialiased (4bpp) glyph rasters, e.g. TTF renders. Same font-group + * framing as register(), but each glyph record carries packed coverage instead of 1bpp + * rows: [encoding u32][bbxX s8][inkTop u8][width u8][inkHeight u8] + * [inkHeight x ceil(width/2) packed bytes, high nibble = left pixel] Nibble values are the + * final 4bpp source levels (the draw-time LUT scales them by the top color). + * Already-registered (font, encoding) records are skipped, as in register(). + */ + @JvmStatic + fun registerAa(buffer: ByteReader?): Unit { + if ((buffer == null)) { + return + } + val cursor: ByteReader = buffer + lock.withLock { + while ((cursor.remaining() > 0)) { + var keyLen: Int = (cursor.get() and 0xff) + var keyBytes: ByteArray = ByteArray(keyLen) + cursor.get(keyBytes) + var fontKey: String = keyBytes.decodeToString() + var cellHeight: Int = (cursor.get() and 0xff) + var count: Int = (cursor.getShort().toInt() and 0xffff) + var idBoxed: Int? = fontIds.get(fontKey) + var id: Int = 0 + if ((idBoxed == null)) { + id = nextFontId++ + fontIds.put(fontKey, id) + } else { + id = idBoxed + } + run { + var g: Int = 0 + while ((g < count)) { + var encoding: Int = cursor.getInt() + val bbxX: Int = cursor.get().toInt() + var inkTop: Int = (cursor.get() and 0xff) + var width: Int = (cursor.get() and 0xff) + var inkHeight: Int = (cursor.get() and 0xff) + var stride: Int = ((width + 1) shr 1) + var coverage: ByteArray = ByteArray((width * inkHeight)) + run { + var r: Int = 0 + while ((r < inkHeight)) { + run { + var b: Int = 0 + while ((b < stride)) { + var packed: Int = (cursor.get() and 0xff) + var col: Int = (b * 2) + coverage[((r * width) + col)] = + ((packed shr 4)).toByte() + if (((col + 1) < width)) { + coverage[(((r * width) + col) + 1)] = + ((packed and 0x0f)).toByte() + } + b++ + } + } + r++ + } + } + var k: Long = key(id, encoding) + if ( + (((!glyphs.containsKey(k) && (width > 0)) && (cellHeight > 0)) && + ((inkTop + inkHeight) <= cellHeight)) + ) { + glyphs.put( + k, + Glyph( + width, + cellHeight, + inkTop, + inkHeight, + bbxX, + null, + coverage, + ), + ) + } + g++ + } + } + } + } + } + } + + constructor() {} + + class Glyph { + /** Cached image width in pixels (the glyph's tight bbox width). */ + @JvmField val width: Int + + /** Cached image height in pixels (the font's line height). */ + @JvmField val cellHeight: Int + + /** First row of ink within the cell. */ + @JvmField val inkTop: Int + + /** Number of ink rows. */ + @JvmField val inkHeight: Int + + /** Horizontal bearing: draw x = pen x + bbxX. */ + @JvmField val bbxX: Int + + /** 1bpp ink rows (inkHeight entries), bit (rowBitWidth-1-col) = ink; null for AA glyphs. */ + @JvmField val rows: IntArray? + + @JvmField val rowBitWidth: Int + + /** AA coverage, width*inkHeight nibble values 0..15; null for 1bpp glyphs. */ + @JvmField val coverage: ByteArray? + + /** CFW cached-image bytes: [w][cellHeight][RLE(w*cellHeight px)]. */ + @JvmField val cachedBytes: ByteArray + + constructor( + width: Int, + cellHeight: Int, + inkTop: Int, + inkHeight: Int, + bbxX: Int, + rows: IntArray?, + coverage: ByteArray?, + ) { + this.width = width + this.cellHeight = cellHeight + this.inkTop = inkTop + this.inkHeight = inkHeight + this.bbxX = bbxX + this.rows = rows + this.coverage = coverage + this.rowBitWidth = (((width + 7) shr 3) shl 3) + this.cachedBytes = encodeCachedImage() + } + + /** + * The cell pixel's 4bpp source value at (col, row), row cell-relative. 1bpp glyphs are + * stored at 15 so the draw-time LUT (source*top/15) maps them to exactly the requested top + * color; AA glyphs carry their true coverage level. + */ + fun nibbleAt(col: Int, row: Int): Int { + if (((col < 0) || (col >= width))) { + return 0 + } + var inkRow: Int = (row - inkTop) + if (((inkRow < 0) || (inkRow >= inkHeight))) { + return 0 + } + if ((coverage != null)) { + return coverage[((inkRow * width) + col)].toInt() + } + return (if ((((rows!![inkRow] ushr ((rowBitWidth - 1) - col)) and 1) != 0)) 15 else 0) + } + + /** Whether the cell pixel at (col, row) has any ink (row is cell-relative). */ + fun inkAt(col: Int, row: Int): Boolean { + return (nibbleAt(col, row) != 0) + } + + /** + * The firmware cached-image encoding: [width][height][RLE tokens] covering exactly + * width*cellHeight pixels (no row padding), each pixel's stored color being its nibbleAt + * value. + */ + private fun encodeCachedImage(): ByteArray { + var total: Int = (width * cellHeight) + var out: ByteArray = ByteArray((2 + total)) + out[0] = (width).toByte() + out[1] = (cellHeight).toByte() + var o: Int = 2 + var i: Int = 0 + while ((i < total)) { + var color: Int = nibbleAt((i % width), (i / width)) + var j: Int = (i + 1) + while (((j < total) && (nibbleAt((j % width), (j / width)) == color))) { + j++ + } + var run: Int = (j - i) + while ((run > 0)) { + var c: Int = minOf(run, 0xffff) + if ((c <= 15)) { + out[o++] = (((c shl 4) or color)).toByte() + } else { + if ((c <= 255)) { + out[o++] = (color).toByte() + out[o++] = (c).toByte() + } else { + out[o++] = (color).toByte() + out[o++] = 0 + out[o++] = ((c and 0xff)).toByte() + out[o++] = ((c shr 8)).toByte() + } + } + run -= c + } + i = j + } + var trimmed: ByteArray = ByteArray(o) + out.copyInto(trimmed, 0, 0, 0 + o) + return trimmed + } + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/ImageAtlas.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/ImageAtlas.kt new file mode 100644 index 00000000..01af3217 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/ImageAtlas.kt @@ -0,0 +1,134 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmField +import kotlin.jvm.JvmStatic + +/** + * Process-wide registry of icon/image rasters for the texture-cache pipeline, the image counterpart + * of GlyphAtlas. Entries are content-addressed: the TS side keys each image by a hash of its + * dimensions and pixels, so the same icon registered from any thread or rendered at any time + * dedupes to one entry, and an icon whose content changes is simply a new entry. + * + * Unlike glyphs (1-bit ink recolored at draw time), images keep their exact 4bpp values: the cached + * bytes quantize the registered 8bpp pixels with the same GRAY_TO_NIBBLE table the composite is + * packed with, and the planner draws them via mode 13 with an identity LUT (top color 15) and the + * transparent bit — the draw writes exactly the nonzero-nibble pixels, which is what the + * eligibility check and hole punching are defined over. + */ +class ImageAtlas { + companion object { + private val lock = protocolPlatform().createLock() + + private val ids: MutableMap = HashMap() + + private val entries: MutableList = ArrayList() + + /** + * Register an image (8bpp grayscale pixels, width*height bytes, row-major) under a content + * key, returning its id — or the existing id when the key is already registered (the pixels + * are then ignored: same key means same content). Ids are positive and stable for the + * process lifetime. + */ + @JvmStatic + fun ensure(key: String?, width: Int, height: Int, pixels8bpp: ByteReader?): Int { + if ( + (((((((key == null) || (width <= 0)) || (width > 255)) || (height <= 0)) || + (height > 255)) || (pixels8bpp == null)) || + (pixels8bpp.remaining() < (width * height))) + ) { + throw IllegalArgumentException( + ((("bad image registration " + width) + "x") + height) + ) + } + lock.withLock { + var existing: Int? = ids.get(key) + if ((existing != null)) { + return existing + } + var nibbles: ByteArray = ByteArray((width * height)) + run { + var i: Int = 0 + while ((i < nibbles.size)) { + nibbles[i] = (BmpUtil.nibbleForGray((pixels8bpp.get(i) and 0xff))).toByte() + i++ + } + } + entries.add(Entry(width, height, nibbles)) + var id: Int = entries.size + ids.put(key, id) + return id + } + } + + @JvmStatic + fun get(id: Int): Entry? { + lock.withLock { + return (if (((id >= 1) && (id <= entries.size))) entries.get((id - 1)) else null) + } + } + } + + constructor() {} + + class Entry { + @JvmField val width: Int + + @JvmField val height: Int + + /** One 4bpp value per pixel, row-major. */ + @JvmField val nibbles: ByteArray + + /** CFW cached-image bytes: [w][h][RLE(w*h pixels)]. */ + @JvmField val cachedBytes: ByteArray + + constructor(width: Int, height: Int, nibbles: ByteArray) { + this.width = width + this.height = height + this.nibbles = nibbles + this.cachedBytes = encodeCachedImage() + } + + /** The 4bpp value the mode-13 draw would write at (col, row); 0 = skipped. */ + fun nibbleAt(col: Int, row: Int): Int { + return (nibbles[((row * width) + col)] and 0xff) + } + + private fun encodeCachedImage(): ByteArray { + var total: Int = (width * height) + var out: ByteArray = ByteArray((2 + total)) + out[0] = (width).toByte() + out[1] = (height).toByte() + var o: Int = 2 + var i: Int = 0 + while ((i < total)) { + var color: Int = (nibbles[i] and 0xff) + var j: Int = (i + 1) + while (((j < total) && ((nibbles[j] and 0xff) == color))) { + j++ + } + var run: Int = (j - i) + while ((run > 0)) { + var c: Int = minOf(run, 0xffff) + if ((c <= 15)) { + out[o++] = (((c shl 4) or color)).toByte() + } else { + if ((c <= 255)) { + out[o++] = (color).toByte() + out[o++] = (c).toByte() + } else { + out[o++] = (color).toByte() + out[o++] = 0 + out[o++] = ((c and 0xff)).toByte() + out[o++] = ((c shr 8)).toByte() + } + } + run -= c + } + i = j + } + var trimmed: ByteArray = ByteArray(o) + out.copyInto(trimmed, 0, 0, 0 + o) + return trimmed + } + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/LvglFontFile.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/LvglFontFile.kt new file mode 100644 index 00000000..cffb1817 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/LvglFontFile.kt @@ -0,0 +1,250 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmField +import kotlin.jvm.JvmStatic + +/** + * Reader for the serialized LVGL font image in the G2's CJK flash partition. Faceclaw bundles that + * font because it is Source Han Sans SC Light under the SIL OFL. Proprietary fonts embedded in the + * main firmware never pass through this class and are instead extracted on the user's phone during + * CFW install. + */ +class LvglFontFile { + companion object { + private val lock = protocolPlatform().createLock() + + private fun load(path: String?): FontData? = lock.withLock { + if (path.isNullOrEmpty()) return null + val cached = fontCache.remove(path) + if (cached != null) { + fontCache[path] = cached + return cached + } + try { + val font = FontData(readFileData(path)) + fontCache[path] = font + while (fontCache.size > FONT_CACHE_SIZE) fontCache.remove(fontCache.keys.first()) + font + } catch (_: Exception) { + null + } + } + + private const val TAG: String = "LvglFontFile" + + private const val MAPPED_BASE: Int = -2146435072 + + private const val FONT_CACHE_SIZE: Int = 2 + + private val fontCache: MutableMap = LinkedHashMap() + + /** + * Returns [lineHeight, baseline] or an empty array when the font is invalid. The baseline + * is measured down from the top of the line. + */ + @JvmStatic + fun getMetrics(path: String): ByteArray { + var font: FontData? = load(path) + if ((font == null)) { + return ByteArray(0) + } + return byteArrayOf((font.lineHeight).toByte(), (font.baseline).toByte()) + } + + /** + * Returns one packed glyph: u16 boxW, u16 boxH, i16 ofsX, i16 ofsY, then aligned 4bpp + * bitmap bytes. Returns an empty array when the code point is not mapped. + */ + @JvmStatic + fun getGlyph(path: String, codePoint: Int): ByteArray { + var font: FontData? = load(path) + if ((font == null)) { + return ByteArray(0) + } + var glyphId: Int? = font.codePointToGlyph.get(codePoint) + if (((glyphId == null) || (glyphId <= 0))) { + return ByteArray(0) + } + try { + var descriptor: Int = (font.glyphDescriptors + (glyphId * 16)) + var bitmapIndex: Int = font.u32(descriptor) + var boxWidth: Int = font.u16((descriptor + 8)) + var boxHeight: Int = font.u16((descriptor + 10)) + var offsetX: Int = font.i16((descriptor + 12)) + var offsetY: Int = font.i16((descriptor + 14)) + var stride: Int = ((boxWidth / 2) + 1) + var bitmapLength: Int = + (if (((boxWidth > 0) && (boxHeight > 0))) (stride * boxHeight) else 0) + font.check((font.glyphBitmaps + bitmapIndex), bitmapLength) + var result: ByteArray = ByteArray((8 + bitmapLength)) + putU16(result, 0, boxWidth) + putU16(result, 2, boxHeight) + putU16(result, 4, offsetX) + putU16(result, 6, offsetY) + font.bytes.copyInto( + result, + 8, + (font.glyphBitmaps + bitmapIndex), + (font.glyphBitmaps + bitmapIndex) + bitmapLength, + ) + return result + } catch (e: RuntimeException) { + + return ByteArray(0) + } + } + + private fun putU16(destination: ByteArray, offset: Int, value: Int): Unit { + destination[offset] = ((value and 0xff)).toByte() + destination[(offset + 1)] = (((value ushr 8) and 0xff)).toByte() + } + } + + constructor() {} + + private class FontData { + @JvmField val bytes: ByteArray + + @JvmField val lineHeight: Int + + @JvmField val baseline: Int + + @JvmField val glyphBitmaps: Int + + @JvmField val glyphDescriptors: Int + + @JvmField val codePointToGlyph: MutableMap + + constructor(bytes: ByteArray) { + this.bytes = bytes + if ( + (((((bytes.size < 0x40) || (bytes[0].toInt() != 90)) || (bytes[1].toInt() != 90)) || + (bytes[2].toInt() != 90)) || (bytes[3].toInt() != 90)) + ) { + throw IllegalArgumentException("missing ZZZZ font header") + } + lineHeight = u16(0x38) + var baseLine: Int = u16(0x3a) + baseline = (lineHeight - baseLine) + var descriptor: Int = pointerOffset(u32(0x34)) + glyphBitmaps = pointerOffset(u32(descriptor)) + glyphDescriptors = pointerOffset(u32((descriptor + 4))) + var cmaps: Int = pointerOffset(u32((descriptor + 8))) + var packed: Int = u16((descriptor + 18)) + var cmapCount: Int = (packed and 0x1ff) + var bitsPerPixel: Int = ((packed ushr 9) and 0xf) + var bitmapFormat: Int = ((packed ushr 14) and 0x3) + if ( + (((((lineHeight <= 0) || (baseline < 0)) || (cmapCount <= 0)) || + (bitsPerPixel != 4)) || (bitmapFormat != 3)) + ) { + throw IllegalArgumentException("unsupported LVGL font metadata") + } + codePointToGlyph = HashMap() + run { + var index: Int = 0 + while ((index < cmapCount)) { + readCmap((cmaps + (index * 20))) + index++ + } + } + } + + fun readCmap(address: Int): Unit { + var rangeStart: Int = u32(address) + var rangeLength: Int = u16((address + 4)) + var glyphIdStart: Int = u16((address + 6)) + var unicodeListPointer: Int = u32((address + 8)) + var glyphIdOffsetsPointer: Int = u32((address + 12)) + var listLength: Int = u16((address + 16)) + var type: Int = u8((address + 18)) + if ((type == 2)) { + run { + var relative: Int = 0 + while ((relative < rangeLength)) { + codePointToGlyph.put((rangeStart + relative), (glyphIdStart + relative)) + relative++ + } + } + return + } + if ((type == 0)) { + var offsets: Int = pointerOffset(glyphIdOffsetsPointer) + run { + var relative: Int = 0 + while ((relative < rangeLength)) { + var offset: Int = u8((offsets + relative)) + if (((relative != 0) && (offset == 0))) { + relative++ + continue + } + codePointToGlyph.put((rangeStart + relative), (glyphIdStart + offset)) + relative++ + } + } + return + } + if (((type == 3) || (type == 1))) { + var unicodeList: Int = pointerOffset(unicodeListPointer) + var offsets: Int = + (if ((glyphIdOffsetsPointer == 0)) -1 else pointerOffset(glyphIdOffsetsPointer)) + run { + var index: Int = 0 + while ((index < listLength)) { + var relative: Int = u16((unicodeList + (index * 2))) + var offset: Int = index + if ((offsets >= 0)) { + offset = + (if ((type == 1)) u16((offsets + (index * 2))) + else u8((offsets + index))) + if (((index != 0) && (offset == 0))) { + index++ + continue + } + } + codePointToGlyph.put((rangeStart + relative), (glyphIdStart + offset)) + index++ + } + } + return + } + throw IllegalArgumentException(("unknown cmap type " + type)) + } + + fun u8(offset: Int): Int { + check(offset, 1) + return (bytes[offset] and 0xff) + } + + fun u16(offset: Int): Int { + check(offset, 2) + return ((bytes[offset].toInt() and 255) or ((bytes[offset + 1].toInt() and 255) shl 8)) + } + + fun i16(offset: Int): Int { + check(offset, 2) + return u16(offset).toShort().toInt() + } + + fun u32(offset: Int): Int { + check(offset, 4) + return u16(offset) or (u16(offset + 2) shl 16) + } + + fun pointerOffset(pointer: Int): Int { + var unsignedPointer: Long = (pointer.toLong() and 0xffffffffL) + var offset: Long = (unsignedPointer - (MAPPED_BASE.toLong() and 0xffffffffL)) + if (((offset < 0) || (offset > Int.MAX_VALUE))) { + throw IllegalArgumentException("font pointer is outside the mapped partition") + } + check((offset).toInt(), 1) + return (offset).toInt() + } + + fun check(offset: Int, length: Int): Unit { + if ((((offset < 0) || (length < 0)) || (((offset).toLong() + length) > bytes.size))) { + throw IllegalArgumentException("font range is out of bounds") + } + } + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/SharedGifScreenRecorder.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/SharedGifScreenRecorder.kt new file mode 100644 index 00000000..c47d8d84 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/SharedGifScreenRecorder.kt @@ -0,0 +1,270 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmField +import kotlin.math.roundToLong + +/** + * Accumulates composited screen frames and saves them as a looping animated GIF with a 16-entry + * grayscale palette. Stored frames are deflate-compressed (a typical UI frame shrinks from 166KB of + * indices to a few KB) so long recordings stay affordable in memory; consecutive identical frames + * are deduplicated, with the elapsed time folded into the next frame's delay. + */ +class SharedGifScreenRecorder { + private val lock = protocolPlatform().createLock() + + fun encode(): ByteArray = lock.withLock { + if (frames.isEmpty()) return ByteArray(0) + val out = ByteSink() + writeGif(out) + out.toByteArray() + } + + companion object { + /** Backstop against unbounded growth if a recording is left running. */ + private const val MAX_FRAMES: Int = 3600 + + /** Displayed duration of the final frame, which has no successor. */ + private const val LAST_FRAME_DELAY_CS: Int = 100 + + /** Below this, GIF renderers historically clamp or ignore the delay. */ + private const val MIN_FRAME_DELAY_CS: Int = 2 + + /** GIF LZW compression of a 4-bit index stream (minimum code size 4). */ + private fun writeLzwImageData(out: ByteSink, indices: ByteArray): Unit { + val minCodeSize: Int = 4 + out.write(minCodeSize) + var writer: SubBlockBitWriter = SubBlockBitWriter(out) + val clearCode: Int = (1 shl minCodeSize) + val eoiCode: Int = (clearCode + 1) + var codeSize: Int = (minCodeSize + 1) + var nextCode: Int = (eoiCode + 1) + var table: HashMap = HashMap() + writer.writeCode(clearCode, codeSize) + var prefix: Int = (indices[0] and 0xff) + run { + var i: Int = 1 + while ((i < indices.size)) { + var k: Int = (indices[i] and 0xff) + var key: Int = ((prefix shl 8) or k) + var code: Int? = table.get(key) + if ((code != null)) { + prefix = code + i++ + continue + } + writer.writeCode(prefix, codeSize) + if ((nextCode == 0x1000)) { + writer.writeCode(clearCode, codeSize) + table.clear() + codeSize = (minCodeSize + 1) + nextCode = (eoiCode + 1) + } else { + if ((nextCode >= (1 shl codeSize))) { + codeSize++ + } + table.put(key, nextCode++) + } + prefix = k + i++ + } + } + writer.writeCode(prefix, codeSize) + writer.writeCode(eoiCode, codeSize) + writer.finish() + } + + private fun writeShortLE(out: ByteSink, value: Int): Unit { + out.write((value and 0xff)) + out.write(((value ushr 8) and 0xff)) + } + } + + private class Frame { + @JvmField val deflatedIndices: ByteArray + + @JvmField val timestampMs: Long + + constructor(deflatedIndices: ByteArray, timestampMs: Long) { + this.deflatedIndices = deflatedIndices + this.timestampMs = timestampMs + } + } + + private val frames: MutableList = ArrayList() + + /** Undeflated copy of the newest frame, kept for duplicate detection. */ + private var lastIndices: ByteArray? = null + + private var width: Int = 0 + + private var height: Int = 0 + + private var overflowed: Boolean = false + + /** + * Append the current screen. gray is 8bpp; only the top nibble (the display's native depth, and + * the palette index) is kept. + */ + fun addFrame(gray: ByteArray?, width: Int, height: Int, timestampMs: Long): Unit { + lock.withLock { + if ( + ((((gray == null) || (width <= 0)) || (height <= 0)) || + (gray.size < (width * height))) + ) { + return + } + if (frames.isEmpty()) { + this.width = width + this.height = height + } else { + if (((width != this.width) || (height != this.height))) { + return + } + } + var indices: ByteArray = ByteArray((width * height)) + run { + var i: Int = 0 + while ((i < indices.size)) { + indices[i] = (((gray[i] and 0xff) ushr 4)).toByte() + i++ + } + } + if (((lastIndices != null) && indices.contentEquals(lastIndices))) { + return + } + if ((frames.size >= MAX_FRAMES)) { + overflowed = true + return + } + frames.add(Frame(deflateData(indices), timestampMs)) + lastIndices = indices + } + } + + /** True if frames were dropped because the recording hit MAX_FRAMES. */ + fun isOverflowed(): Boolean { + lock.withLock { + return overflowed + } + } + + private fun writeGif(out: ByteSink): Unit { + out.write('G') + out.write('I') + out.write('F') + out.write('8') + out.write('9') + out.write('a') + writeShortLE(out, width) + writeShortLE(out, height) + out.write(((0x80 or 0x70) or 0x03)) + out.write(0) + out.write(0) + run { + var i: Int = 0 + while ((i < 16)) { + var v: Int = (i * 17) + out.write(v) + out.write(v) + out.write(v) + i++ + } + } + out.write(0x21) + out.write(0xff) + out.write(11) + out.write("NETSCAPE2.0".encodeToByteArray()) + out.write(3) + out.write(1) + writeShortLE(out, 0) + out.write(0) + run { + var i: Int = 0 + while ((i < frames.size)) { + val frame: Frame = frames.get(i) + var delayCs: Int = LAST_FRAME_DELAY_CS + if (((i + 1) < frames.size)) { + var deltaMs: Long = (frames.get((i + 1)).timestampMs - frame.timestampMs) + delayCs = + (maxOf( + MIN_FRAME_DELAY_CS.toLong(), + minOf(0xffffL, (deltaMs / 10.0).roundToLong()), + )) + .toInt() + } + out.write(0x21) + out.write(0xf9) + out.write(4) + out.write(0x04) + writeShortLE(out, delayCs) + out.write(0) + out.write(0) + out.write(0x2c) + writeShortLE(out, 0) + writeShortLE(out, 0) + writeShortLE(out, width) + writeShortLE(out, height) + out.write(0) + writeLzwImageData(out, inflateData(frame.deflatedIndices, (width * height))) + i++ + } + } + out.write(0x3b) + } + + /** + * Packs LZW codes LSB-first into bytes and the bytes into the 255-byte data sub-blocks GIF + * image data is carried in. + */ + private class SubBlockBitWriter { + private val out: ByteSink + + private val block: ByteArray = ByteArray(255) + + private var blockLength: Int = 0 + + private var bitBuffer: Int = 0 + + private var bitCount: Int = 0 + + constructor(out: ByteSink) { + this.out = out + } + + fun writeCode(code: Int, codeSize: Int): Unit { + bitBuffer = (bitBuffer or (code shl bitCount)) + bitCount += codeSize + while ((bitCount >= 8)) { + writeByte((bitBuffer and 0xff)) + bitBuffer = (bitBuffer ushr 8) + bitCount -= 8 + } + } + + fun finish(): Unit { + if ((bitCount > 0)) { + writeByte((bitBuffer and 0xff)) + bitBuffer = 0 + bitCount = 0 + } + flushBlock() + out.write(0) + } + + private fun writeByte(b: Int): Unit { + block[blockLength++] = (b).toByte() + if ((blockLength == 255)) { + flushBlock() + } + } + + private fun flushBlock(): Unit { + if ((blockLength == 0)) { + return + } + out.write(blockLength) + out.write(block, 0, blockLength) + blockLength = 0 + } + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/SharedScreenshots.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/SharedScreenshots.kt new file mode 100644 index 00000000..b0043485 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/SharedScreenshots.kt @@ -0,0 +1,55 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmStatic + +/** Screen export codecs; filesystem destinations belong to platform adapters. */ +class SharedScreenshots private constructor() { + companion object { + @JvmStatic + fun encode4BitGrayPng(gray: ByteArray, width: Int, height: Int): ByteArray { + require(width > 0 && height > 0 && gray.size >= width * height) + val rowBytes = (width + 1) / 2 + val raw = ByteArray(height * (1 + rowBytes)) + var offset = 0 + for (y in 0 until height) { + raw[offset++] = 0 // PNG filter: None + for (x in 0 until width step 2) { + val hi = (gray[y * width + x].toInt() and 255) ushr 4 + val lo = + if (x + 1 < width) (gray[y * width + x + 1].toInt() and 255) ushr 4 else 0 + raw[offset++] = ((hi shl 4) or lo).toByte() + } + } + val out = ByteSink() + out.write(byteArrayOf(0x89.toByte(), 80, 78, 71, 13, 10, 26, 10)) + val header = ByteSink() + writeInt(header, width) + writeInt(header, height) + header.write(byteArrayOf(4, 0, 0, 0, 0)) + writeChunk(out, "IHDR", header.toByteArray()) + writeChunk(out, "IDAT", deflateData(raw)) + writeChunk(out, "IEND", ByteArray(0)) + return out.toByteArray() + } + + private fun writeChunk(out: ByteSink, type: String, data: ByteArray) { + writeInt(out, data.size) + val name = type.encodeToByteArray() + out.write(name) + out.write(data) + var crc = -1 + for (bytes in arrayOf(name, data)) for (byte in bytes) { + crc = crc xor (byte.toInt() and 255) + repeat(8) { crc = (crc ushr 1) xor (if (crc and 1 != 0) 0xedb88320.toInt() else 0) } + } + writeInt(out, crc.inv()) + } + + private fun writeInt(out: ByteSink, value: Int) { + out.write(value ushr 24) + out.write(value ushr 16) + out.write(value ushr 8) + out.write(value) + } + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/SurfaceCompositor.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/SurfaceCompositor.kt new file mode 100644 index 00000000..78c59e86 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/SurfaceCompositor.kt @@ -0,0 +1,702 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmField +import kotlin.jvm.JvmStatic + +/** + * Retained-surface compositor: the phone-side model of what is on the glasses screen. + * + * Each surface is an 8bpp grayscale buffer retained at its last-submitted contents, positioned on + * the screen with a z-order and a transparency mode. Sources on the TS side (today the dashboard; + * later the shell and per-app worker threads) submit updates to their surface, and the compositor + * recombines the retained surfaces into a full-screen frame that feeds the existing + * dedupe/compress/transmit pipeline. Because every surface is retained, a full screen frame can be + * regenerated at any time (frame drops, reconnects, previews, screenshots) without asking sources + * to repaint. + * + * Surface format contract (mirrored by the TS side): + * - Pixels are 8bpp grayscale, row-major, one byte per pixel. The wire pipeline quantizes to 4bpp + * downstream, so the low nibble is not visible. + * - TRANSPARENCY_COLOR_KEY surfaces treat pixel value 0 as fully transparent and value 1 as black. + * Quantization collapses 1 into the same 4bpp level as 0, so reserving 0 costs no visible shade; + * painters of color-key surfaces must clamp intentional black to 1. + * - An update may cover any rect of its surface; the rest is retained. The update buffer holds + * exactly rectWidth*rectHeight bytes, row-major. + * - Surfaces composite in ascending z-order onto a black (0) background. + * - Surface geometry changes take effect when the next frame composites; they do not trigger a + * recomposite by themselves. + * + * Thread safety: all methods are safe to call from any thread. Apply and composite happen + * atomically under an internal lock, and each composite carries a monotonic sequence number so + * callers can detect when a composite was superseded by a concurrent one before being acted on. + */ +class SurfaceCompositor { + companion object { + const val TRANSPARENCY_OPAQUE: Int = 0 + + const val TRANSPARENCY_COLOR_KEY: Int = 1 + + private val NO_DRAWS: Array = emptyArray() + + private fun dimValue(value: Int, dim: Int): Int { + return maxOf(1, (((value * dim) + 128) shr 8)) + } + + private fun parseDraws(draws: ByteReader?): Array { + if (((draws == null) || (draws.remaining() < 1))) { + return NO_DRAWS + } + val cursor: ByteReader = draws + var out: MutableList = ArrayList() + while ((cursor.remaining() >= 1)) { + var kind: Int = (cursor.get() and 0xff) + if (((kind == ScreenDraw.KIND_GLYPH) && (cursor.remaining() >= 11))) { + var fontId: Int = (cursor.getShort().toInt() and 0xffff) + var encoding: Int = cursor.getInt() + var penX: Int = cursor.getShort().toInt() + var lineY: Int = cursor.getShort().toInt() + var value: Int = (cursor.get() and 0xff) + out.add(ScreenDraw.glyph(fontId, encoding, penX, lineY, value)) + } else { + if (((kind == ScreenDraw.KIND_IMAGE) && (cursor.remaining() >= 8))) { + var imageId: Int = cursor.getInt() + var x: Int = cursor.getShort().toInt() + var y: Int = cursor.getShort().toInt() + out.add(ScreenDraw.image(imageId, x, y)) + } else { + if (((kind == ScreenDraw.KIND_FWTEXT) && (cursor.remaining() >= 6))) { + var x: Int = cursor.getShort().toInt() + var y: Int = cursor.getShort().toInt() + var value: Int = (cursor.get() and 0xff) + var count: Int = (cursor.get() and 0xff) + if ((cursor.remaining() < (count * 7))) { + break + } + var cps: IntArray = IntArray(count) + var dx: IntArray = IntArray(count) + var ink: BooleanArray = BooleanArray(count) + run { + var i: Int = 0 + while ((i < count)) { + cps[i] = cursor.getInt() + dx[i] = cursor.getShort().toInt() + ink[i] = (cursor.get().toInt() != 0) + i++ + } + } + out.add(ScreenDraw.fwText(x, y, value, cps, dx, ink)) + } else { + break + } + } + } + } + return out.toTypedArray() + } + } + + /** + * One deferred draw (a text glyph or an icon image) within a frame, in screen coordinates. The + * draw's pixels are already baked into the composited gray buffer (the TS side bakes before + * submitting); this record preserves the draw's identity so the texture-cache planner can + * replay it as an on-glasses cached draw instead of image bytes. + * + * Glyphs: x/y are the pen position and line top; the raster (and its bearing/cell placement) + * comes from GlyphAtlas under (fontId, encoding). Images: x/y are the blit's top-left; the + * raster comes from ImageAtlas under imageId. + */ + class ScreenDraw { + companion object { + const val KIND_GLYPH: Int = 0 + + const val KIND_IMAGE: Int = 1 + + /** A firmware-builtin-font text run (CFW mode 15). */ + const val KIND_FWTEXT: Int = 2 + + @JvmStatic + fun glyph(fontId: Int, encoding: Int, penX: Int, lineY: Int, value: Int): ScreenDraw { + return ScreenDraw( + KIND_GLYPH, + fontId, + encoding, + 0, + penX, + lineY, + value, + null, + null, + null, + ) + } + + @JvmStatic + fun image(imageId: Int, x: Int, y: Int): ScreenDraw { + return ScreenDraw(KIND_IMAGE, 0, 0, imageId, x, y, 0, null, null, null) + } + + @JvmStatic + fun fwText( + x: Int, + y: Int, + value: Int, + cps: IntArray, + dx: IntArray, + ink: BooleanArray, + ): ScreenDraw { + return ScreenDraw(KIND_FWTEXT, 0, 0, 0, x, y, value, cps, dx, ink) + } + } + + @JvmField val kind: Int + + /** Glyph draws only. */ + @JvmField val fontId: Int + + /** Glyph draws only. */ + @JvmField val encoding: Int + + /** Image draws only. */ + @JvmField val imageId: Int + + @JvmField val x: Int + + @JvmField val y: Int + + /** Glyph and fw-text draws: 8-bit brightness. */ + @JvmField val value: Int + + /** Fw-text runs only: member codepoints, in text order. */ + @JvmField val fwCps: IntArray? + + /** Fw-text runs only: member pen offsets relative to x. */ + @JvmField val fwDx: IntArray? + + /** Fw-text runs only: whether each member has visible pixels. */ + @JvmField val fwInk: BooleanArray? + + constructor( + kind: Int, + fontId: Int, + encoding: Int, + imageId: Int, + x: Int, + y: Int, + value: Int, + fwCps: IntArray?, + fwDx: IntArray?, + fwInk: BooleanArray?, + ) { + this.kind = kind + this.fontId = fontId + this.encoding = encoding + this.imageId = imageId + this.x = x + this.y = y + this.value = value + this.fwCps = fwCps + this.fwDx = fwDx + this.fwInk = fwInk + } + } + + /** One composited full-screen frame plus the metadata the pipeline needs. */ + class Composite { + /** Full-screen 8bpp grayscale pixels, screenWidth*screenHeight bytes. */ + @JvmField val gray: ByteArray + + @JvmField val width: Int + + @JvmField val height: Int + + /** + * Stable identifier of screen content, combining every surface's geometry and content + * fingerprint; equal fingerprints mean equal composited pixels. + */ + @JvmField val fingerprint: String + + /** Monotonic: a Composite with a higher seq contains strictly newer state. */ + @JvmField val seq: Long + + /** + * Screen-space deferred draws of every visible surface, in composite order (surface z + * ascending, then each surface's draw order). Their pixels are already baked into gray. + */ + @JvmField val draws: Array? + + constructor( + gray: ByteArray, + width: Int, + height: Int, + fingerprint: String, + seq: Long, + draws: Array?, + ) { + this.gray = gray + this.width = width + this.height = height + this.fingerprint = fingerprint + this.seq = seq + this.draws = (if ((draws == null)) NO_DRAWS else draws) + } + } + + private class Surface { + @JvmField val id: String + + @JvmField var x: Int = 0 + + @JvmField var y: Int = 0 + + @JvmField var width: Int = 0 + + @JvmField var height: Int = 0 + + @JvmField var zOrder: Int = 0 + + @JvmField var transparency: Int = 0 + + @JvmField var visible: Boolean = true + + @JvmField var pixels: ByteArray = ByteArray(0) + + @JvmField var fingerprint: String = "" + + /** Surface-local deferred draws of the retained content (already baked into pixels). */ + @JvmField var draws: Array = NO_DRAWS + + constructor(id: String) { + this.id = id + } + } + + private val lock = protocolPlatform().createLock() + + private var screenWidth: Int = 0 + + private var screenHeight: Int = 0 + + private var blanked: Boolean = false + + /** See setUnderlayDim: surfaces with zOrder below this are dimmed by underlayDim/256. */ + private var underlayDimBelowZOrder: Int = Int.MIN_VALUE + + private var underlayDim: Int = 256 + + private val surfaces: MutableMap = HashMap() + + private var nextCompositeSeq: Long = 1 + + /** Set the output frame size. Must be called before any surface work. */ + fun configureScreen(width: Int, height: Int): Unit { + if (((width <= 0) || (height <= 0))) { + throw IllegalArgumentException(((("bad screen size " + width) + "x") + height)) + } + lock.withLock { + this.screenWidth = width + this.screenHeight = height + } + } + + /** + * Create a surface or update an existing one's geometry. A resize discards the surface's + * retained pixels (reset to 0). + */ + fun configureSurface( + id: String?, + x: Int, + y: Int, + width: Int, + height: Int, + zOrder: Int, + transparency: Int, + ): Unit { + if (((id == null) || id.isEmpty())) { + throw IllegalArgumentException("surface id must be non-empty") + } + if (((width <= 0) || (height <= 0))) { + throw IllegalArgumentException( + ((((("bad surface size " + width) + "x") + height) + " for ") + id) + ) + } + if (((transparency != TRANSPARENCY_OPAQUE) && (transparency != TRANSPARENCY_COLOR_KEY))) { + throw IllegalArgumentException( + ((("bad transparency mode " + transparency) + " for ") + id) + ) + } + lock.withLock { + requireScreenConfiguredLocked() + var surface: Surface? = surfaces.get(id) + if ((surface == null)) { + surface = Surface(id) + surfaces.put(id, surface) + } + if ( + (((surface.pixels == null) || (surface.width != width)) || + (surface.height != height)) + ) { + surface.pixels = ByteArray((width * height)) + surface.fingerprint = "" + surface.draws = NO_DRAWS + } + surface.x = x + surface.y = y + surface.width = width + surface.height = height + surface.zOrder = zOrder + surface.transparency = transparency + } + } + + fun removeSurface(id: String): Unit { + lock.withLock { + surfaces.remove(id) + } + } + + /** + * Dim every surface whose zOrder is below belowZOrder to factor256/256 of its brightness (256 = + * no dimming): how a shell overlay that dims what it covers (the TS Layer.dimUnderneath) + * reaches the window surfaces beneath the shell surface, which the shell's own layer stack + * cannot paint. Visible pixels stay at least 1 (the color-key black); glyph and firmware-text + * draws keep their cached-draw form with a dimmed value; image draws leave the composite's draw + * list (their pixels, already baked into the surface, dim as raster). Takes effect when the + * next frame composites. + */ + fun setUnderlayDim(belowZOrder: Int, factor256: Int): Unit { + lock.withLock { + underlayDimBelowZOrder = belowZOrder + underlayDim = maxOf(0, minOf(256, factor256)) + } + } + + /** The dim factor (256 = none) that applies to a surface. */ + private fun dimForLocked(surface: Surface): Int { + return (if ((surface.zOrder < underlayDimBelowZOrder)) underlayDim else 256) + } + + /** + * Hidden surfaces keep their retained pixels and accept updates, but are excluded from the + * composite and its fingerprint (used for background windows). Takes effect when the next frame + * composites. + */ + fun setSurfaceVisible(id: String, visible: Boolean): Unit { + lock.withLock { + var surface: Surface? = surfaces.get(id) + if ((surface == null)) { + throw IllegalArgumentException(("unknown surface " + id)) + } + surface.visible = visible + } + } + + /** + * While blanked (screen off), composites are all-zero regardless of surface content; retained + * state is untouched, so unblanking restores the screen without asking sources to repaint. + */ + fun setBlanked(blanked: Boolean): Unit { + lock.withLock { + this.blanked = blanked + } + } + + /** + * Apply an update to one surface and composite the whole screen, as one atomic step. The update + * covers the rect (rectX, rectY, rectWidth, rectHeight) in surface-local coordinates; pixels + * must hold exactly rectWidth*rectHeight bytes. contentFingerprint identifies the surface's + * full content after this update. + */ + fun applyAndComposite( + surfaceId: String, + pixels: ByteReader, + rectX: Int, + rectY: Int, + rectWidth: Int, + rectHeight: Int, + contentFingerprint: String, + ): Composite { + return applyAndComposite( + surfaceId, + pixels, + rectX, + rectY, + rectWidth, + rectHeight, + contentFingerprint, + null, + ) + } + + /** + * As above, with the frame's deferred draws: a little-endian buffer of tagged records + * [0][fontId u16][encoding u32][penX s16][lineY s16][value u8] (glyph) [1][imageId u32][x + * s16][y s16] (image) in surface-local coordinates and draw order. The list describes the + * surface's FULL retained content and replaces the previous list, so it is only meaningful for + * full-surface updates (which is what every submitter sends); pass null to clear. Draw pixels + * must already be baked into pixels. + */ + fun applyAndComposite( + surfaceId: String, + pixels: ByteReader?, + rectX: Int, + rectY: Int, + rectWidth: Int, + rectHeight: Int, + contentFingerprint: String?, + glyphs: ByteReader?, + ): Composite = + updateSurface( + surfaceId, + pixels, + rectX, + rectY, + rectWidth, + rectHeight, + contentFingerprint, + glyphs, + true, + )!! + + /** Retain pixels without recompositing; iOS coalesces updates before its frame callback. */ + fun submitSurface( + surfaceId: String, + pixels: ByteReader, + rectX: Int, + rectY: Int, + rectWidth: Int, + rectHeight: Int, + fingerprint: String, + ) { + updateSurface( + surfaceId, + pixels, + rectX, + rectY, + rectWidth, + rectHeight, + fingerprint, + null, + false, + ) + } + + private fun updateSurface( + surfaceId: String, + pixels: ByteReader?, + rectX: Int, + rectY: Int, + rectWidth: Int, + rectHeight: Int, + contentFingerprint: String?, + glyphs: ByteReader?, + composeAfter: Boolean, + ): Composite? { + var parsed: Array = parseDraws(glyphs) + lock.withLock { + requireScreenConfiguredLocked() + var surface: Surface? = surfaces.get(surfaceId) + if ((surface == null)) { + throw IllegalArgumentException(("unknown surface " + surfaceId)) + } + if ( + ((((((rectX < 0) || (rectY < 0)) || (rectWidth <= 0)) || (rectHeight <= 0)) || + ((rectX + rectWidth) > surface.width)) || + ((rectY + rectHeight) > surface.height)) + ) { + throw IllegalArgumentException( + (((((((((((((("update rect " + rectWidth) + "x") + rectHeight) + "+") + rectX) + + "+") + rectY) + " outside surface ") + surfaceId) + " (") + surface.width) + + "x") + surface.height) + ")") + ) + } + var expectedBytes: Int = (rectWidth * rectHeight) + if (((pixels == null) || (pixels.remaining() != expectedBytes))) { + throw IllegalArgumentException( + ((((("update buffer for " + surfaceId) + " has ") + + (if ((pixels == null)) 0 else pixels.remaining())) + " bytes, expected ") + + expectedBytes) + ) + } + run { + var row: Int = 0 + while ((row < rectHeight)) { + var dstOffset: Int = (((rectY + row) * surface.width) + rectX) + pixels.get(surface.pixels, dstOffset, rectWidth) + row++ + } + } + surface.fingerprint = (if ((contentFingerprint == null)) "" else contentFingerprint) + surface.draws = parsed + return if (composeAfter) compositeLocked() else null + } + } + + /** Composite the current retained state without applying an update. */ + fun composite(): Composite { + lock.withLock { + requireScreenConfiguredLocked() + return compositeLocked() + } + } + + /** + * Current composited pixels for the phone-side preview / screenshot, or null before the screen + * is configured. Does not consume a sequence number (it is never stored as the desired frame). + */ + fun previewComposite(): Composite? { + lock.withLock { + if (((screenWidth <= 0) || (screenHeight <= 0))) { + return null + } + var gray: ByteArray = buildGrayLocked() + return Composite(gray, screenWidth, screenHeight, "preview", 0, NO_DRAWS) + } + } + + private fun buildGrayLocked(): ByteArray { + var gray: ByteArray = ByteArray((screenWidth * screenHeight)) + if (blanked) { + return gray + } + var ordered: MutableList = ArrayList(surfaces.values) + ordered.sortWith(compareBy { it.zOrder }.thenBy { it.id }) + for (surface in ordered) { + if (surface.visible) { + blendLocked(gray, surface) + } + } + return gray + } + + private fun compositeLocked(): Composite { + var gray: ByteArray = ByteArray((screenWidth * screenHeight)) + if (blanked) { + return Composite( + gray, + screenWidth, + screenHeight, + ((("blanked:" + screenWidth) + "x") + screenHeight), + nextCompositeSeq++, + NO_DRAWS, + ) + } + var ordered: MutableList = ArrayList(surfaces.values) + ordered.sortWith(compareBy { it.zOrder }.thenBy { it.id }) + var fingerprint: StringBuilder = StringBuilder() + fingerprint.append(screenWidth).append('x').append(screenHeight) + var draws: MutableList = ArrayList() + for (surface in ordered) { + if (!surface.visible) { + continue + } + blendLocked(gray, surface) + var dim: Int = dimForLocked(surface) + for (draw in surface.draws) { + if (((dim < 256) && (draw.kind == ScreenDraw.KIND_IMAGE))) { + continue + } + var value: Int = (if ((dim < 256)) dimValue(draw.value, dim) else draw.value) + draws.add( + ScreenDraw( + draw.kind, + draw.fontId, + draw.encoding, + draw.imageId, + (draw.x + surface.x), + (draw.y + surface.y), + value, + draw.fwCps, + draw.fwDx, + draw.fwInk, + ) + ) + } + fingerprint + .append('|') + .append(surface.id) + .append('@') + .append(surface.x) + .append(',') + .append(surface.y) + .append('+') + .append(surface.width) + .append('x') + .append(surface.height) + .append('#') + .append(surface.zOrder) + .append(':') + .append(surface.transparency) + .append(':') + .append(surface.fingerprint) + if ((dim < 256)) { + fingerprint.append(":dim").append(dim) + } + } + return Composite( + gray, + screenWidth, + screenHeight, + fingerprint.toString(), + nextCompositeSeq++, + draws.toTypedArray(), + ) + } + + private fun blendLocked(gray: ByteArray, surface: Surface): Unit { + var srcX: Int = maxOf(0, -surface.x) + var srcY: Int = maxOf(0, -surface.y) + var dstX: Int = maxOf(0, surface.x) + var dstY: Int = maxOf(0, surface.y) + var copyWidth: Int = minOf((surface.width - srcX), (screenWidth - dstX)) + var copyHeight: Int = minOf((surface.height - srcY), (screenHeight - dstY)) + if (((copyWidth <= 0) || (copyHeight <= 0))) { + return + } + var dim: Int = dimForLocked(surface) + run { + var row: Int = 0 + while ((row < copyHeight)) { + var srcOffset: Int = (((srcY + row) * surface.width) + srcX) + var dstOffset: Int = (((dstY + row) * screenWidth) + dstX) + if ((dim < 256)) { + run { + var col: Int = 0 + while ((col < copyWidth)) { + var value: Int = (surface.pixels[(srcOffset + col)] and 0xff) + if ((value.toInt() != 0)) { + gray[(dstOffset + col)] = (dimValue(value, dim)).toByte() + } else { + if ((surface.transparency == TRANSPARENCY_OPAQUE)) { + gray[(dstOffset + col)] = 0 + } + } + col++ + } + } + } else { + if ((surface.transparency == TRANSPARENCY_OPAQUE)) { + surface.pixels.copyInto(gray, dstOffset, srcOffset, srcOffset + copyWidth) + } else { + run { + var col: Int = 0 + while ((col < copyWidth)) { + var value: Byte = surface.pixels[(srcOffset + col)] + if ((value.toInt() != 0)) { + gray[(dstOffset + col)] = value + } + col++ + } + } + } + } + row++ + } + } + } + + private fun requireScreenConfiguredLocked(): Unit { + if (((screenWidth <= 0) || (screenHeight <= 0))) { + throw IllegalStateException("configureScreen must be called first") + } + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/BinaryEncoding.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/BinaryEncoding.kt new file mode 100644 index 00000000..9a7c1f77 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/BinaryEncoding.kt @@ -0,0 +1,45 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmStatic + +/** Binary encodings shared by firmware downloads and audio recordings. */ +object BinaryEncoding { + @JvmStatic + fun bytesToHex(bytes: ByteArray?): String { + if (bytes == null) return "" + val digits = "0123456789abcdef" + return buildString(bytes.size * 2) { + for (byte in bytes) { + val value = byte.toInt() and 255 + append(digits[value ushr 4]) + append(digits[value and 15]) + } + } + } + + @JvmStatic + fun wavHeader(pcmBytes: Int, sampleRate: Int, channels: Int): ByteArray { + val out = ByteSink(44) + fun u16(value: Int) { + out.write(value) + out.write(value ushr 8) + } + fun u32(value: Int) { + u16(value) + u16(value ushr 16) + } + out.write("RIFF".encodeToByteArray()) + u32(36 + pcmBytes) + out.write("WAVEfmt ".encodeToByteArray()) + u32(16) + u16(1) + u16(channels) + u32(sampleRate) + u32(sampleRate * channels * 2) + u16(channels * 2) + u16(16) + out.write("data".encodeToByteArray()) + u32(pcmBytes) + return out.toByteArray() + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/BmpUtil.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/BmpUtil.kt new file mode 100644 index 00000000..b68046cf --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/BmpUtil.kt @@ -0,0 +1,150 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmStatic + +class BmpUtil { + companion object { + @JvmStatic + fun copyTileBmp(bmp: ByteArray?): ByteArray { + if (((bmp == null) || (bmp.size == 0))) { + return ByteArray(0) + } + return bmp.copyOf(bmp.size) + } + + private val GRAY_TO_NIBBLE = + ByteArray(256) { v -> if (v == 0) 0 else minOf(15, (v + 8) shr 4).toByte() } + + /** + * The 4bpp level an 8-bit gray value packs to. Public so the texture-cache planner computes + * a glyph draw's top color with the exact quantization the composited frame was packed + * with. + */ + @JvmStatic + fun nibbleForGray(gray: Int): Int { + return (GRAY_TO_NIBBLE[(gray and 0xff)] and 0xff) + } + + /** + * Pack a full-resolution 8bpp grayscale buffer (row-major, top-to-bottom, one byte per + * pixel) into the headerless 4bpp wire format used by CFW load_image_z modes 3/6/8: + * top-down rows, stride ceil(width/2), high nibble = left pixel. This is the canonical + * in-memory frame format; BMP framing (needed only when an uncompressed full frame goes on + * the wire) is added on demand by build4bppBmpFromPacked. + */ + @JvmStatic + fun pack4bppFromGray8(gray8: ByteArray?, width: Int, height: Int): ByteArray { + if (((width <= 0) || (height <= 0))) { + return ByteArray(0) + } + var stride: Int = ((width + 1) shr 1) + var out: ByteArray = ByteArray((stride * height)) + if (((gray8 == null) || (gray8.size < (width * height)))) { + return out + } + var pairs: Int = (width shr 1) + var src: Int = 0 + var dst: Int = 0 + run { + var y: Int = 0 + while ((y < height)) { + run { + var i: Int = 0 + while ((i < pairs)) { + out[dst++] = + (((GRAY_TO_NIBBLE[(gray8[src] and 0xff)] shl 4) or + (GRAY_TO_NIBBLE[(gray8[(src + 1)] and 0xff)] and 0xff))) + .toByte() + src += 2 + i++ + } + } + if (((width and 1) != 0)) { + out[dst++] = ((GRAY_TO_NIBBLE[(gray8[src++] and 0xff)] shl 4)).toByte() + } + y++ + } + } + return out + } + + /** + * Wrap a packed 4bpp frame in BMP framing (BITMAPINFOHEADER + 16-entry gray palette, + * bottom-up rows padded to a 4-byte stride). Only the full-frame fallback used when mode-6 + * compression does not shrink the frame still speaks BMP on the wire; everything else uses + * the headerless packed format directly. + */ + @JvmStatic + fun build4bppBmpFromPacked(packed: ByteArray?, width: Int, height: Int): ByteArray { + var packedStride: Int = ((width + 1) shr 1) + if ( + ((((width <= 0) || (height <= 0)) || (packed == null)) || + (packed.size < (packedStride * height))) + ) { + return ByteArray(0) + } + var rowStride: Int = ((packedStride + 3) and 3.inv()) + var pixelDataSize: Int = (rowStride * height) + var fileHeaderSize: Int = 14 + var dibHeaderSize: Int = 40 + var paletteSize: Int = (16 * 4) + var pixelOffset: Int = ((fileHeaderSize + dibHeaderSize) + paletteSize) + var fileSize: Int = (pixelOffset + pixelDataSize) + var buf: ByteArray = ByteArray(fileSize) + buf[0] = 0x42 + buf[1] = 0x4 + putUint32Le(buf, 2, fileSize) + putUint32Le(buf, 10, pixelOffset) + putUint32Le(buf, 14, dibHeaderSize) + putInt32Le(buf, 18, width) + putInt32Le(buf, 22, height) + putUint16Le(buf, 26, 1) + putUint16Le(buf, 28, 4) + putUint32Le(buf, 30, 0) + putUint32Le(buf, 34, pixelDataSize) + putUint32Le(buf, 46, 16) + run { + var i: Int = 0 + while ((i < 16)) { + var v: Int = (i * 17) + var base: Int = ((fileHeaderSize + dibHeaderSize) + (i * 4)) + buf[base] = (v).toByte() + buf[(base + 1)] = (v).toByte() + buf[(base + 2)] = (v).toByte() + buf[(base + 3)] = 0 + i++ + } + } + run { + var bmpRow: Int = 0 + while ((bmpRow < height)) { + var srcY: Int = ((height - 1) - bmpRow) + packed.copyInto( + buf, + (pixelOffset + (bmpRow * rowStride)), + (srcY * packedStride), + (srcY * packedStride) + packedStride, + ) + bmpRow++ + } + } + return buf + } + + private fun putUint16Le(buf: ByteArray, offset: Int, value: Int): Unit { + buf[offset] = ((value and 0xff)).toByte() + buf[(offset + 1)] = (((value ushr 8) and 0xff)).toByte() + } + + private fun putUint32Le(buf: ByteArray, offset: Int, value: Int): Unit { + buf[offset] = ((value and 0xff)).toByte() + buf[(offset + 1)] = (((value ushr 8) and 0xff)).toByte() + buf[(offset + 2)] = (((value ushr 16) and 0xff)).toByte() + buf[(offset + 3)] = (((value ushr 24) and 0xff)).toByte() + } + + private fun putInt32Le(buf: ByteArray, offset: Int, value: Int): Unit { + putUint32Le(buf, offset, value) + } + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/ByteReader.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/ByteReader.kt new file mode 100644 index 00000000..cfb69420 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/ByteReader.kt @@ -0,0 +1,43 @@ +package com.faceclaw.app + +/** Sequential little-endian input. Platform adapters can read native buffers without a copy. */ +abstract class ByteReader { + abstract fun remaining(): Int + + abstract fun get(): Byte + + abstract fun get(index: Int): Byte + + open fun get(bytes: ByteArray): ByteReader = get(bytes, 0, bytes.size) + + open fun get(bytes: ByteArray, offset: Int, length: Int): ByteReader { + require( + length >= 0 && offset >= 0 && offset <= bytes.size - length && remaining() >= length + ) + for (i in offset until offset + length) bytes[i] = get() + return this + } + + fun getShort(): Short = ((get().toInt() and 255) or ((get().toInt() and 255) shl 8)).toShort() + + fun getInt(): Int = (getShort().toInt() and 65535) or (getShort().toInt() shl 16) +} + +class ArrayByteReader(private val bytes: ByteArray) : ByteReader() { + private var position = 0 + + override fun remaining(): Int = bytes.size - position + + override fun get(): Byte = bytes[position++] + + override fun get(index: Int): Byte = bytes[index] + + override fun get(bytes: ByteArray, offset: Int, length: Int): ByteReader { + require( + length >= 0 && offset >= 0 && offset <= bytes.size - length && remaining() >= length + ) + this.bytes.copyInto(bytes, offset, position, position + length) + position += length + return this + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/ByteSink.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/ByteSink.kt new file mode 100644 index 00000000..3362e26d --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/ByteSink.kt @@ -0,0 +1,44 @@ +package com.faceclaw.app + +/** Growable byte buffer for wire encoders; no streams or platform objects escape. */ +internal class ByteSink(capacity: Int = 32) { + private var bytes = ByteArray(capacity.coerceAtLeast(1)) + private var count = 0 + + fun size(): Int = count + + fun write(value: Char) = write(value.code) + + fun write(value: ByteArray) = write(value, 0, value.size) + + fun write(value: Int) { + reserve(1) + bytes[count++] = value.toByte() + } + + fun write(value: ByteArray, offset: Int, length: Int) { + require(offset >= 0 && length >= 0 && offset <= value.size - length) + reserve(length) + value.copyInto(bytes, count, offset, offset + length) + count += length + } + + fun toByteArray(): ByteArray = bytes.copyOf(count) + + private fun reserve(extra: Int) { + if (count + extra > bytes.size) bytes = bytes.copyOf(maxOf(count + extra, bytes.size * 2)) + } +} + +internal infix fun Byte.and(mask: Int): Int = toInt() and mask + +internal infix fun Byte.shl(bits: Int): Int = toInt() shl bits + +internal fun codePointUtf8(codePoint: Int): ByteArray { + require(codePoint in 0..0x10ffff) + if (codePoint <= 0xffff) return codePoint.toChar().toString().encodeToByteArray() + val value = codePoint - 0x10000 + return charArrayOf((0xd800 + (value ushr 10)).toChar(), (0xdc00 + (value and 1023)).toChar()) + .concatToString() + .encodeToByteArray() +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/CollectionUtils.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/CollectionUtils.kt new file mode 100644 index 00000000..45012c10 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/CollectionUtils.kt @@ -0,0 +1,31 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmStatic + +class CollectionUtils { + companion object { + @JvmStatic + fun singletonList(value: ByteArray): MutableList { + var list: MutableList = ArrayList(1) + list.add(value) + return list + } + + @JvmStatic + fun listOf(a: ByteArray, b: ByteArray): MutableList { + var list: MutableList = ArrayList(2) + list.add(a) + list.add(b) + return list + } + + @JvmStatic + fun listOf(a: ByteArray, b: ByteArray, c: ByteArray): MutableList { + var list: MutableList = ArrayList(3) + list.add(a) + list.add(b) + list.add(c) + return list + } + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/shared/KotlinBridge.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/shared/KotlinBridge.kt index 66f1ebfe..b43e81ab 100644 --- a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/shared/KotlinBridge.kt +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/shared/KotlinBridge.kt @@ -6,11 +6,17 @@ interface KotlinBridgeListener { } /** - * Portable Kotlin at the same commonMain source path used by ios-port. - * Calls and callbacks are synchronous on the caller's thread. The listener is - * used only during roundTrip and is never retained. + * Portable Kotlin at the same commonMain source path used by ios-port. Calls and callbacks are + * synchronous on the caller's thread. The listener is used only during roundTrip and is never + * retained. */ class KotlinBridge { + fun platform(): String = PlatformInfo.name + + fun threadName(): String = PlatformInfo.threadName() + + fun isMainThread(): Boolean = PlatformInfo.isMainThread() + fun greet(name: String): String = "Hello, $name, from Kotlin" fun roundTrip(message: String, listener: KotlinBridgeListener): String { @@ -19,3 +25,11 @@ class KotlinBridge { return "Kotlin received callback: $reply" } } + +internal expect object PlatformInfo { + val name: String + + fun threadName(): String + + fun isMainThread(): Boolean +} diff --git a/native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/app/IosNativeApi.kt b/native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/app/IosNativeApi.kt new file mode 100644 index 00000000..e461a9b6 --- /dev/null +++ b/native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/app/IosNativeApi.kt @@ -0,0 +1,264 @@ +@file:OptIn(kotlinx.cinterop.ExperimentalForeignApi::class) + +package com.faceclaw.app + +import kotlinx.cinterop.* +import platform.Foundation.NSData +import platform.Foundation.create +import platform.posix.memcpy + +/** NSData keeps large binary crossings out of per-element JavaScript bridge loops. */ +internal fun NSData.byteArray(): ByteArray { + require(length <= Int.MAX_VALUE.toULong()) + val result = ByteArray(length.toInt()) + if (result.isNotEmpty()) result.usePinned { memcpy(it.addressOf(0), bytes, length) } + return result +} + +internal fun ByteArray.data(): NSData = + if (isEmpty()) NSData() + else + usePinned { + NSData.create(bytes = it.addressOf(0), length = size.toULong()) + } + +class IosByteReader(private val data: NSData) : ByteReader() { + private var position = 0 + + override fun remaining(): Int = data.length.toInt() - position + + override fun get(): Byte = get(position++) + + override fun get(index: Int): Byte { + require(index >= 0 && index < data.length.toInt()) + return data.bytes!!.reinterpret()[index] + } + + override fun get(bytes: ByteArray, offset: Int, length: Int): ByteReader { + require( + offset >= 0 && length >= 0 && offset <= bytes.size - length && remaining() >= length + ) + if (length > 0) + bytes.usePinned { + memcpy( + it.addressOf(offset), + data.bytes!!.reinterpret() + position, + length.toULong(), + ) + } + position += length + return this + } +} + +class IosCfwTransport { + private val transport = CfwTransport(IosProtocolPlatform) + + fun reset() = transport.reset() + + fun close() = transport.close() + + fun encode(data: NSData, streamId: Int, lenses: Int, maxWrite: Int): List = + transport.encode(data.byteArray(), streamId, lenses, maxWrite + 3).map { it.data() } +} + +class IosProtocolMessage(message: MessageReceiver.Message) { + val sid = message.sid + val flag = message.flag + val payload = message.payload.data() + val command = message.command + val magic = message.magic + val packet = message.packet?.data() +} + +class IosMessageReceiver { + private val receiver = MessageReceiver() + + fun clear() = receiver.clear() + + fun receive(link: String, data: NSData, now: Long): List = + receiver.receive(link, data.byteArray(), now).map { IosProtocolMessage(it) } +} + +/** Stable binary facade over the shared wire algorithms and font parser. */ +class IosProtocol { + fun authentication(magic: Int): NSData = BleProtocol.buildAuthenticationRequest(magic).data() + + fun prelude(): NSData = BleProtocol.PRELUDE_F5872_PAYLOAD.data() + + fun heartbeat(magic: Int): NSData = BleProtocol.buildHeartbeat(magic).data() + + fun audioControl(magic: Int, enabled: Boolean): NSData = + BleProtocol.buildAudioControl(magic, enabled).data() + + fun settingsQuery(magic: Int): NSData = BleProtocol.buildSettingsQuery(magic).data() + + fun shutdown(magic: Int): NSData = BleProtocol.buildShutdown(magic, 1).data() + + fun framebufferLease(acquire: Boolean): NSData = + BleProtocol.buildFaceclawWakeControl( + if (acquire) BleProtocol.FACECLAW_FB_OP_ACQUIRE + else BleProtocol.FACECLAW_FB_OP_RELEASE, + 0, + ) + .data() + + fun createLayout(magic: Int): NSData = BleProtocol.buildCreateInputPage(magic).data() + + fun integer(field: Int, value: Int): NSData = BleProtocol.encodeVarintField(field, value).data() + + fun bytes(field: Int, data: NSData): NSData = + BleProtocol.encodeBytesField(field, data.byteArray()).data() + + fun crc(data: NSData): Int = CfwTransport.crc(data.byteArray()) + + fun frame(data: NSData, sid: Int, flag: Int, sequence: Int, maxWrite: Int): List = + BleProtocol.framePb(data.byteArray(), sid, flag, sequence, maxWrite).map { it.data() } + + fun acks(data: NSData): List? = + CfwTransport.parseAcks(data.byteArray())?.toList() + + fun readInteger(data: NSData, field: Int, fallback: Int): Int = + BleProtocol.readVarintFieldValue(data.byteArray(), field, fallback) + + fun readBytes(data: NSData, field: Int): NSData? = + BleProtocol.readFieldBytes(data.byteArray(), field)?.data() + + fun readString(data: NSData, field: Int): String = + BleProtocol.readStringFieldValue(data.byteArray(), field) + + fun glassesInput(data: NSData, sid: Int, flag: Int): G2Event? = + if (sid == BleProtocol.SID_EVENHUB && flag in intArrayOf(1, 6)) + G2Event.decodePayload(sid, data.byteArray()) + else null + + fun ringInput(data: NSData): G2Event? = FaceclawRingEventDecoder.decode(data.byteArray())?.event + + fun pack(data: NSData, width: Int, height: Int): NSData { + require(width > 0 && height > 0 && data.length == width.toULong() * height.toULong()) + return BmpUtil.pack4bppFromGray8(data.byteArray(), width, height).data() + } + + fun rle(data: NSData): NSData = BleImageOptimizer.rleEncode(data.byteArray()).data() + + fun boundingBox( + previous: NSData?, + next: NSData, + width: Int, + height: Int, + frameId: Int, + ): NSData? = + BleImageOptimizer.buildIncrementalImagePayload( + previous?.byteArray(), + next.byteArray(), + width, + height, + frameId, + ) + ?.payload + ?.data() + + fun fullFrameBands(data: NSData, width: Int, height: Int, firstId: Int): List { + require( + width in 1..640 && + width % 4 == 0 && + height in 1..480 && + height % 2 == 0 && + data.length == (width * height / 2).toULong() + ) + val packed = data.byteArray() + var id = firstId + return (0 until height step 64).map { top -> + val result = + BleImageOptimizer.encodeMode3Rect( + packed, + width / 2, + 0, + top, + width, + minOf(64, height - top), + id, + ) + .data() + id = if (id >= 0xfffe) 1 else id + 1 + result + } + } + + fun fontMetrics(path: String): NSData = LvglFontFile.getMetrics(path).data() + + fun fontGlyph(path: String, codePoint: Int): NSData = + LvglFontFile.getGlyph(path, codePoint).data() + + fun png(data: NSData, width: Int, height: Int): NSData = + SharedScreenshots.encode4BitGrayPng(data.byteArray(), width, height).data() +} + +/** iOS retains/coalesces surface updates in the same compositor Android uses. */ +class IosSurfaceCompositor(width: Int, height: Int) { + private val compositor = SurfaceCompositor().also { it.configureScreen(width, height) } + private val sizes = mutableMapOf>() + private var sequence = 0L + + fun configure( + id: String, + x: Int, + y: Int, + width: Int, + height: Int, + zOrder: Int, + transparent: Boolean, + ) { + compositor.configureSurface(id, x, y, width, height, zOrder, if (transparent) 1 else 0) + sizes[id] = width to height + } + + fun remove(id: String) { + sizes.remove(id) + compositor.removeSurface(id) + } + + fun visible(id: String, visible: Boolean) = compositor.setSurfaceVisible(id, visible) + + fun dim(below: Int, factor: Double) { + require(factor.isFinite()) + compositor.setUnderlayDim(below, (factor.coerceIn(0.0, 1.0) * 256).toInt()) + } + + fun blank(blanked: Boolean) = compositor.setBlanked(blanked) + + fun submit(id: String, data: NSData, x: Int, y: Int, width: Int, height: Int) { + val (sw, sh) = sizes[id] ?: error("Unknown surface: $id") + require(width > 0 && height > 0 && data.length == width.toULong() * height.toULong()) + val left = maxOf(0, x) + val right = minOf(sw, x + width) + val top = maxOf(0, y) + val bottom = minOf(sh, y + height) + if (right <= left || bottom <= top) return + val reader = + if (left == x && top == y && right - left == width && bottom - top == height) + IosByteReader(data) + else { + val source = data.byteArray() + val clipped = ByteArray((right - left) * (bottom - top)) + for (row in top until bottom) source.copyInto( + clipped, + (row - top) * (right - left), + (row - y) * width + left - x, + (row - y) * width + right - x, + ) + ArrayByteReader(clipped) + } + compositor.submitSurface( + id, + reader, + left, + top, + right - left, + bottom - top, + (++sequence).toString(), + ) + } + + fun composite(): NSData = compositor.composite().gray.data() +} diff --git a/native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/app/PlatformServices.ios.kt b/native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/app/PlatformServices.ios.kt new file mode 100644 index 00000000..91525178 --- /dev/null +++ b/native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/app/PlatformServices.ios.kt @@ -0,0 +1,72 @@ +package com.faceclaw.app + +import kotlinx.cinterop.* + +internal actual fun protocolPlatform(): ProtocolPlatform = IosProtocolPlatform + +@OptIn(kotlinx.cinterop.ExperimentalForeignApi::class) +internal actual fun readFileData(path: String): ByteArray { + val file = platform.posix.fopen(path, "rb") ?: error("Cannot read $path") + try { + check(platform.posix.fseek(file, 0, platform.posix.SEEK_END) == 0) + val size = platform.posix.ftell(file) + require(size in 0..Int.MAX_VALUE.toLong()) + platform.posix.rewind(file) + val bytes = ByteArray(size.toInt()) + if (bytes.isNotEmpty()) + bytes.usePinned { + check( + platform.posix.fread(it.addressOf(0), 1u, bytes.size.toULong(), file) == + bytes.size.toULong() + ) + } + return bytes + } finally { + platform.posix.fclose(file) + } +} + +@OptIn(kotlinx.cinterop.ExperimentalForeignApi::class) +internal actual fun deflateData(bytes: ByteArray): ByteArray = + kotlinx.cinterop.memScoped { + val capacity = platform.zlib.compressBound(bytes.size.toULong()) + val result = ByteArray(capacity.toInt()) + val length = alloc() + length.value = capacity + bytes.usePinned { input -> + result.usePinned { output -> + check( + platform.zlib.compress2( + output.addressOf(0).reinterpret(), + length.ptr, + if (bytes.isEmpty()) null else input.addressOf(0).reinterpret(), + bytes.size.toULong(), + platform.zlib.Z_DEFAULT_COMPRESSION, + ) == platform.zlib.Z_OK + ) + } + } + result.copyOf(length.value.toInt()) + } + +@OptIn(kotlinx.cinterop.ExperimentalForeignApi::class) +internal actual fun inflateData(bytes: ByteArray, size: Int): ByteArray = + kotlinx.cinterop.memScoped { + val result = ByteArray(size) + val length = alloc() + length.value = size.toULong() + bytes.usePinned { input -> + result.usePinned { output -> + check( + platform.zlib.uncompress( + output.addressOf(0).reinterpret(), + length.ptr, + input.addressOf(0).reinterpret(), + bytes.size.toULong(), + ) == platform.zlib.Z_OK + ) + } + } + check(length.value.toInt() == size) { "recorded frame truncated" } + result + } diff --git a/native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/app/g2protocol/IosProtocolPlatform.kt b/native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/app/g2protocol/IosProtocolPlatform.kt new file mode 100644 index 00000000..3b24fcca --- /dev/null +++ b/native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/app/g2protocol/IosProtocolPlatform.kt @@ -0,0 +1,129 @@ +@file:OptIn( + kotlinx.cinterop.ExperimentalForeignApi::class, + kotlin.experimental.ExperimentalNativeApi::class, +) + +package com.faceclaw.app + +import kotlin.native.ref.createCleaner +import kotlinx.cinterop.* +import platform.CoreBluetooth.CBCharacteristicWriteType +import platform.CoreBluetooth.CBCharacteristicWriteWithResponse +import platform.CoreBluetooth.CBCharacteristicWriteWithoutResponse +import platform.Foundation.NSRecursiveLock +import platform.posix.CLOCK_MONOTONIC_RAW +import platform.posix.clock_gettime_nsec_np +import platform.posix.memset +import platform.zlib.* + +object IosProtocolPlatform : ProtocolPlatform { + // Unlike wall time, this cannot jump; unlike uptime, it includes sleep. + override fun elapsedRealtimeMs(): Long = + (clock_gettime_nsec_np(CLOCK_MONOTONIC_RAW.convert()) / 1_000_000uL).toLong() + + override fun createLock(): ProtocolLock = + object : ProtocolLock { + private val lock = NSRecursiveLock() + + override fun lock() = lock.lock() + + override fun unlock() = lock.unlock() + } + + override fun createDeflater(): ProtocolDeflater = IosDeflater() + + fun writeType(mode: GattWriteMode): CBCharacteristicWriteType = + when (mode) { + GattWriteMode.WITH_RESPONSE -> CBCharacteristicWriteWithResponse + GattWriteMode.WITHOUT_RESPONSE -> CBCharacteristicWriteWithoutResponse + } +} + +/** The cleaner holds only the allocation state, never the owning deflater. */ +private class ZlibState { + private val lock = NSRecursiveLock() + var stream: CPointer? = nativeHeap.alloc().ptr + private set + + init { + memset(stream, 0, sizeOf().convert()) + val status = deflateInit(stream, Z_DEFAULT_COMPRESSION) + if (status != Z_OK) { + nativeHeap.free(stream!!) + stream = null + error("zlib initialization failed: $status") + } + } + + fun use(action: (CPointer) -> T): T { + lock.lock() + try { + return action(checkNotNull(stream) { "zlib stream is closed" }) + } finally { + lock.unlock() + } + } + + fun close() { + lock.lock() + try { + val value = stream ?: return + deflateEnd(value) + nativeHeap.free(value) + stream = null + } finally { + lock.unlock() + } + } +} + +private class IosDeflater : ProtocolDeflater { + private val state = ZlibState() + private val cleaner = createCleaner(state) { it.close() } + + override fun reset() = state.use { check(deflateReset(it) == Z_OK) } + + override fun syncFlush(message: ByteArray): ByteArray = state.use { stream -> + val chunks = mutableListOf() + var size = 0 + val buffer = ByteArray(4096) + message.usePinned { input -> + stream.pointed.next_in = + if (message.isEmpty()) null else input.addressOf(0).reinterpret() + stream.pointed.avail_in = message.size.toUInt() + try { + buffer.usePinned { output -> + do { + stream.pointed.next_out = output.addressOf(0).reinterpret() + stream.pointed.avail_out = buffer.size.toUInt() + val status = deflate(stream, Z_SYNC_FLUSH) + // A repeated empty SYNC_FLUSH is a valid no-op. + check(status == Z_OK || status == Z_BUF_ERROR) { + "zlib deflate failed: $status" + } + val count = buffer.size - stream.pointed.avail_out.toInt() + if (count > 0) { + chunks.add(buffer.copyOf(count)) + size += count + } + } while (stream.pointed.avail_out == 0u) + } + } finally { + // Do not leave pointers to unpinned Kotlin arrays in native memory. + stream.pointed.next_in = null + stream.pointed.next_out = null + stream.pointed.avail_in = 0u + stream.pointed.avail_out = 0u + } + } + ByteArray(size).also { result -> + var offset = 0 + for (chunk in chunks) { + chunk.copyInto(result, offset) + offset += chunk.size + } + } + } + + override fun close() = state.close() +} diff --git a/native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/shared/PlatformInfo.ios.kt b/native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/shared/PlatformInfo.ios.kt new file mode 100644 index 00000000..890b5d90 --- /dev/null +++ b/native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/shared/PlatformInfo.ios.kt @@ -0,0 +1,13 @@ +package com.faceclaw.shared + +import platform.Foundation.NSThread + +internal actual object PlatformInfo { + actual val name: String = "iOS" + + actual fun threadName(): String = + NSThread.currentThread.name?.takeIf { it.isNotEmpty() } + ?: if (NSThread.isMainThread) "main" else "background" + + actual fun isMainThread(): Boolean = NSThread.isMainThread +} diff --git a/package-lock.json b/package-lock.json index 783099da..3129c4b6 100644 --- a/package-lock.json +++ b/package-lock.json @@ -9,6 +9,7 @@ "version": "1.0.0", "dependencies": { "@evenrealities/pretext": "^0.1.4", + "@faceclaw/kotlin": "file:native/kotlin/plugin", "@nativescript/core": "~9.0.0", "@nativescript/theme": "^3.1.0", "@xterm/headless": "^6.0.0", @@ -19,12 +20,16 @@ "upng-js": "^2.1.0" }, "devDependencies": { - "@nativescript/android": "9.0.4", + "@nativescript/android": "9.1.1", "@nativescript/types": "~9.0.0", "@nativescript/webpack": "~5.0.25", "typescript": "~5.4.0" } }, + "native/kotlin/plugin": { + "name": "@faceclaw/kotlin", + "version": "0.1.0" + }, "node_modules/@babel/code-frame": { "version": "7.29.0", "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.29.0.tgz", @@ -411,6 +416,10 @@ "integrity": "sha512-gSZk/uxIhZW3geOM5bP1IS0s1sg7cA7KLLpBDgH9T1+ZNHMIFTMcgQN1qw4+/Xi/rcxsDsWZ7UZndIS/s4fRcA==", "license": "MIT" }, + "node_modules/@faceclaw/kotlin": { + "resolved": "native/kotlin/plugin", + "link": true + }, "node_modules/@jridgewell/gen-mapping": { "version": "0.3.13", "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.13.tgz", @@ -473,9 +482,9 @@ } }, "node_modules/@nativescript/android": { - "version": "9.0.4", - "resolved": "https://registry.npmjs.org/@nativescript/android/-/android-9.0.4.tgz", - "integrity": "sha512-htfv7Ku/M6Tq6fQjhV0nSwxa9agNYEs9x4zBdOW8mRye5CZS7xTJq83MffYkItrtN/jJeeaxiSAgu0F+L4oHgA==", + "version": "9.1.1", + "resolved": "https://registry.npmjs.org/@nativescript/android/-/android-9.1.1.tgz", + "integrity": "sha512-oDWfVnQtgQ0ctbfFWSugqGEZnYVjls82FqlO5UbA9HNwTNqdP4gqWwqHR80WKQngrbxlRHYDIuYv5S9kQfKhcw==", "dev": true }, "node_modules/@nativescript/core": { diff --git a/package.json b/package.json index c4a1783e..67423727 100644 --- a/package.json +++ b/package.json @@ -8,10 +8,13 @@ "run": "./build_and_run.sh", "release": "scripts/release.sh", "clean": "rm -rf platforms", - "test": "tsc -p tests/tsconfig.json && node --test tests/*.test.cjs" + "test": "tsc -p tests/tsconfig.json && node --test tests/*.test.cjs", + "test:kotlin": "bash scripts/test-kotlin.sh", + "test:kotlin:ios": "bash scripts/test-kotlin.sh iosSimulatorArm64Test compileKotlinIosArm64" }, "dependencies": { "@evenrealities/pretext": "^0.1.4", + "@faceclaw/kotlin": "file:native/kotlin/plugin", "@nativescript/core": "~9.0.0", "@nativescript/theme": "^3.1.0", "@xterm/headless": "^6.0.0", @@ -22,7 +25,7 @@ "upng-js": "^2.1.0" }, "devDependencies": { - "@nativescript/android": "9.0.4", + "@nativescript/android": "9.1.1", "@nativescript/types": "~9.0.0", "@nativescript/webpack": "~5.0.25", "typescript": "~5.4.0" diff --git a/scripts/kotlin-build.cjs b/scripts/kotlin-build.cjs new file mode 100644 index 00000000..1d4d07d3 --- /dev/null +++ b/scripts/kotlin-build.cjs @@ -0,0 +1,73 @@ +const { spawn } = require('node:child_process'); +const { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync } = require('node:fs'); +const path = require('node:path'); + +const root = path.resolve(__dirname, '..'); +const kotlin = path.join(root, 'native/kotlin'); + +function sameContents(source, destination) { + if (!existsSync(destination)) return false; + if (statSync(source).isDirectory()) { + if (!statSync(destination).isDirectory()) return false; + const entries = readdirSync(source).sort(); + const previous = readdirSync(destination).sort(); + return entries.length === previous.length && entries.every((entry, index) => + entry === previous[index] && sameContents(path.join(source, entry), path.join(destination, entry))); + } + return statSync(destination).isFile() && readFileSync(source).equals(readFileSync(destination)); +} + +function checkAndroidRuntime(projectDir = root) { + const generated = path.join(projectDir, 'platforms/android/build-tools/android-metadata-generator.jar'); + const installed = path.join(projectDir, 'node_modules/@nativescript/android/framework/build-tools/android-metadata-generator.jar'); + if (existsSync(generated) && !sameContents(installed, generated)) { + throw new Error('Generated Android runtime is stale. Run "ns platform clean android" once after npm ci, then rebuild.'); + } +} + +async function buildKotlin(platform, configuration = 'debug') { + if (!['android', 'ios'].includes(platform)) throw new Error(`Unsupported Kotlin platform: ${platform}`); + if (!['debug', 'release'].includes(configuration)) throw new Error(`Unsupported Kotlin configuration: ${configuration}`); + const variant = configuration === 'release' ? 'Release' : 'Debug'; + const task = platform === 'android' ? ':shared:assembleAndroidMain' : `:shared:assembleFaceclawKit${variant}XCFramework`; + const wrapper = path.join(root, 'wear', process.platform === 'win32' ? 'gradlew.bat' : 'gradlew'); + console.log(`[kotlin] Building ${platform} (${configuration})`); + await new Promise((resolve, reject) => { + const child = spawn(wrapper, [task, '--console=plain'], { cwd: kotlin, stdio: 'inherit' }); + child.on('error', reject); + child.on('exit', (code, signal) => { + if (code === 0) resolve(); + else reject(new Error(`Kotlin build failed (${signal || code})`)); + }); + }); + // Stage only after a successful build. npm links this directory into node_modules. + const destination = path.join(kotlin, 'plugin/platforms', platform); + mkdirSync(destination, { recursive: true }); + if (platform === 'android') { + // NativeScript's resource copy can retain deleted sources. Remove the + // generated copy from the pre-KMP bridge so it cannot duplicate the AAR. + rmSync(path.join(root, 'platforms/android/app/src/main/java/com/faceclaw/shared/KotlinBridge.kt'), { force: true }); + const output = path.join(kotlin, 'shared/build/outputs/aar'); + const files = readdirSync(output).filter(name => name.endsWith('.aar')); + if (files.length !== 1) throw new Error(`Expected one Kotlin AAR, found: ${files.join(', ')}`); + const source = path.join(output, files[0]); + const aar = path.join(destination, 'faceclaw-shared.aar'); + if (!sameContents(source, aar)) cpSync(source, aar); + } else { + const framework = path.join(destination, 'FaceclawKit.xcframework'); + const source = path.join(kotlin, `shared/build/XCFrameworks/${configuration}/FaceclawKit.xcframework`); + // Preserve mtimes on no-op builds: NativeScript uses them to detect changes. + if (!sameContents(source, framework)) { + rmSync(framework, { recursive: true, force: true }); + cpSync(source, framework, { recursive: true }); + } + } +} + +module.exports = { buildKotlin, checkAndroidRuntime }; +if (require.main === module) { + buildKotlin(process.argv[2], process.argv[3]).catch(error => { + console.error(error); + process.exitCode = 1; + }); +} diff --git a/scripts/test-kotlin.sh b/scripts/test-kotlin.sh new file mode 100644 index 00000000..ee4bcd4e --- /dev/null +++ b/scripts/test-kotlin.sh @@ -0,0 +1,8 @@ +#!/usr/bin/env bash +set -euo pipefail +cd "$(dirname "$0")/.." +source scripts/before_build.sh +if [ "$#" -eq 0 ]; then + set -- testAndroidHostTest +fi +exec ./wear/gradlew -p tests/kotlin "$@" diff --git a/tests/README.md b/tests/README.md index a9fe157f..98f99845 100644 --- a/tests/README.md +++ b/tests/README.md @@ -15,15 +15,13 @@ That compiles the pure modules with the project's TypeScript into dependencies are needed — the tests are plain `.test.cjs` files that use `node:test` and `node:assert`. -Compass diagnostics have focused UI and wire-format checks: +The shared Kotlin suite runs separately from the Node tests: - node --test tests/compass-debug.test.cjs tests/compass-protocol.test.cjs + npm run test:kotlin + npm run test:kotlin:ios -The protocol check also compiles the production Java parser, so it needs a -JDK (`JAVA_HOME`, or `javac` and `java` on `PATH`). Its golden packet is shared -with the firmware encoder test in `g2flash/tests/compass_diagnostics_test.c`. - -R1 battery field-106 decoding (valid zero, charging, unavailable/disconnected, -legacy firmware, malformed messages) uses the same C/Java golden packet: - - node --test tests/ring-battery-protocol.test.cjs +It includes the migrated compass, R1 battery, gesture and texture Java fixtures, +which now call the Kotlin implementation from Android host tests. Common tests +also run as native iOS simulator binaries. See [the Kotlin README](../native/kotlin/README.md) +for SDK requirements, source layout and coverage. The compass and battery +fixtures retain the golden packets shared with firmware tests. diff --git a/tests/compass-protocol.test.cjs b/tests/compass-protocol.test.cjs deleted file mode 100644 index feee8260..00000000 --- a/tests/compass-protocol.test.cjs +++ /dev/null @@ -1,19 +0,0 @@ -const test = require('node:test'); -const fs = require('node:fs'); -const os = require('node:os'); -const path = require('node:path'); -const { execFileSync } = require('node:child_process'); - -test('compass diagnostics decode with legacy and malformed-extension fallback', () => { - const directory = fs.mkdtempSync(path.join(os.tmpdir(), 'faceclaw-compass-java-')); - const javaBin = (name) => process.env.JAVA_HOME ? path.join(process.env.JAVA_HOME, 'bin', name) : name; - try { - execFileSync(javaBin('javac'), ['-d', directory, - path.join(__dirname, '../App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/BleProtocol.java'), - path.join(__dirname, '../App_Resources/Android/src/main/java/com/faceclaw/app/util/CollectionUtils.java'), - path.join(__dirname, 'fixtures/CompassProtocolTest.java')], { stdio: 'pipe' }); - execFileSync(javaBin('java'), ['-ea', '-cp', directory, 'com.faceclaw.app.CompassProtocolTest'], { stdio: 'pipe' }); - } finally { - fs.rmSync(directory, { recursive: true, force: true }); - } -}); diff --git a/tests/compass-texture-cache.test.cjs b/tests/compass-texture-cache.test.cjs index 55edd8ff..2f947829 100644 --- a/tests/compass-texture-cache.test.cjs +++ b/tests/compass-texture-cache.test.cjs @@ -151,7 +151,7 @@ test('the background registers once and uses a nine-byte image reference on late const registered = []; const { prepareFrameDraws } = load('app/graphics/glyph-wire.ts', {}, '', { global: { isAndroid: true }, - com: { faceclaw: { app: { ImageAtlas: { ensure: (...args) => { + com: { faceclaw: { app: { AndroidByteReader: class { constructor(buffer) { this.buffer = buffer; } }, ImageAtlas: { ensure: (...args) => { registered.push(args); return 1; } } } } }, diff --git a/tests/faceclaw-gesture-event.test.cjs b/tests/faceclaw-gesture-event.test.cjs deleted file mode 100644 index 1071c1f7..00000000 --- a/tests/faceclaw-gesture-event.test.cjs +++ /dev/null @@ -1,19 +0,0 @@ -const test = require('node:test'); -const fs = require('node:fs'); -const os = require('node:os'); -const path = require('node:path'); -const { execFileSync } = require('node:child_process'); - -test('CFW idle-gesture events decode to sys-event types and sources; wake and junk do not', () => { - const directory = fs.mkdtempSync(path.join(os.tmpdir(), 'faceclaw-gesture-java-')); - const javaBin = (name) => process.env.JAVA_HOME ? path.join(process.env.JAVA_HOME, 'bin', name) : name; - try { - execFileSync(javaBin('javac'), ['-d', directory, - path.join(__dirname, '../App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/BleProtocol.java'), - path.join(__dirname, '../App_Resources/Android/src/main/java/com/faceclaw/app/util/CollectionUtils.java'), - path.join(__dirname, 'fixtures/FaceclawGestureEventTest.java')], { stdio: 'pipe' }); - execFileSync(javaBin('java'), ['-ea', '-cp', directory, 'com.faceclaw.app.FaceclawGestureEventTest'], { stdio: 'pipe' }); - } finally { - fs.rmSync(directory, { recursive: true, force: true }); - } -}); diff --git a/tests/kotlin-build.test.cjs b/tests/kotlin-build.test.cjs new file mode 100644 index 00000000..07d4f8cf --- /dev/null +++ b/tests/kotlin-build.test.cjs @@ -0,0 +1,43 @@ +const test = require('node:test'); +const assert = require('node:assert/strict'); +const fs = require('node:fs'); +const os = require('node:os'); +const path = require('node:path'); +const { checkAndroidRuntime } = require('../scripts/kotlin-build.cjs'); + +test('Android preparation rejects a stale metadata generator but allows fresh and matching platforms', () => { + const root = fs.mkdtempSync(path.join(os.tmpdir(), 'faceclaw-kotlin-build-')); + try { + const installed = path.join(root, 'node_modules/@nativescript/android/framework/build-tools/android-metadata-generator.jar'); + const generated = path.join(root, 'platforms/android/build-tools/android-metadata-generator.jar'); + fs.mkdirSync(path.dirname(installed), { recursive: true }); + fs.writeFileSync(installed, 'current metadata generator'); + assert.doesNotThrow(() => checkAndroidRuntime(root)); + fs.mkdirSync(path.dirname(generated), { recursive: true }); + fs.writeFileSync(generated, 'old metadata generator'); + assert.throws(() => checkAndroidRuntime(root), /ns platform clean android/); + fs.copyFileSync(installed, generated); + assert.doesNotThrow(() => checkAndroidRuntime(root)); + } finally { + fs.rmSync(root, { recursive: true, force: true }); + } +}); + +test('every remaining Java source has an explicit Android boundary and every migration has one replacement', () => { + const root = path.resolve(__dirname, '..'); + const java = path.join(root, 'App_Resources/Android/src/main/java'); + const list = directory => fs.readdirSync(directory, { withFileTypes: true }).flatMap(entry => { + const file = path.join(directory, entry.name); + return entry.isDirectory() ? list(file) : file.endsWith('.java') ? [path.relative(java, file)] : []; + }); + const boundaries = require('../native/kotlin/android-java-boundaries.json'); + const retained = boundaries.flatMap(group => { assert.ok(group.reason.length > 20); return group.files; }); + assert.deepEqual(list(java).sort(), retained.sort()); + assert.equal(new Set(retained).size, retained.length); + const migrated = require('../native/kotlin/migrated-java-sources.json'); + assert.equal(new Set(migrated.map(entry => entry.java)).size, migrated.length); + for (const entry of migrated) { + assert.equal(fs.existsSync(path.join(java, entry.java)), false, entry.java); + assert.ok(fs.existsSync(path.join(root, 'native/kotlin', entry.kotlin)), entry.kotlin); + } +}); diff --git a/tests/kotlin/build.gradle.kts b/tests/kotlin/build.gradle.kts new file mode 100644 index 00000000..0c97093c --- /dev/null +++ b/tests/kotlin/build.gradle.kts @@ -0,0 +1,40 @@ +import org.jetbrains.kotlin.gradle.dsl.JvmTarget + +plugins { + kotlin("multiplatform") version "2.4.20" + id("com.android.kotlin.multiplatform.library") version "8.13.2" +} + +// Compile the production sources without building NativeScript or touching BLE. +kotlin { + android { + namespace = "com.faceclaw.protocoltests" + compileSdk = 35 + minSdk = 24 + withJava() + compilerOptions { jvmTarget.set(JvmTarget.JVM_17) } + withHostTestBuilder {}.configure {} + } + iosArm64() + iosSimulatorArm64() + sourceSets { + commonMain { kotlin.srcDir("../../native/kotlin/shared/src/commonMain/kotlin") } + androidMain { kotlin.srcDir("../../native/kotlin/shared/src/androidMain/kotlin") } + iosMain { kotlin.srcDir("../../native/kotlin/shared/src/iosMain/kotlin") } + commonTest.dependencies { implementation(kotlin("test")) } + } +} + +// The font is already shipped in the app; avoid copying megabytes into test fixtures. +val generateFixturePaths = tasks.register("generateFixturePaths") { + val output = layout.buildDirectory.file("generated/fixtures/com/faceclaw/app/FixturePaths.kt") + outputs.dir(layout.buildDirectory.dir("generated/fixtures")) + doLast { + val font = file("../../app/fonts/source-han-sans/SourceHanSansSC-Light-20.lvgl.bin").canonicalPath + output.get().asFile.apply { + parentFile.mkdirs() + writeText("package com.faceclaw.app\ninternal const val TEST_FONT_PATH = \"${font.replace("\\", "\\\\").replace("\"", "\\\"")}\"\n") + } + } +} +kotlin.sourceSets.commonTest { kotlin.srcDir(generateFixturePaths) } diff --git a/tests/kotlin/settings.gradle.kts b/tests/kotlin/settings.gradle.kts new file mode 100644 index 00000000..6c535290 --- /dev/null +++ b/tests/kotlin/settings.gradle.kts @@ -0,0 +1,3 @@ +pluginManagement { repositories { google(); mavenCentral(); gradlePluginPortal() } } +dependencyResolutionManagement { repositories { google(); mavenCentral() } } +rootProject.name = "FaceclawProtocolTests" diff --git a/tests/fixtures/CompassProtocolTest.java b/tests/kotlin/src/androidHostTest/java/com/faceclaw/app/CompassProtocolTest.java similarity index 100% rename from tests/fixtures/CompassProtocolTest.java rename to tests/kotlin/src/androidHostTest/java/com/faceclaw/app/CompassProtocolTest.java diff --git a/tests/fixtures/FaceclawGestureEventTest.java b/tests/kotlin/src/androidHostTest/java/com/faceclaw/app/FaceclawGestureEventTest.java similarity index 100% rename from tests/fixtures/FaceclawGestureEventTest.java rename to tests/kotlin/src/androidHostTest/java/com/faceclaw/app/FaceclawGestureEventTest.java diff --git a/tests/fixtures/RingBatteryProtocolTest.java b/tests/kotlin/src/androidHostTest/java/com/faceclaw/app/RingBatteryProtocolTest.java similarity index 100% rename from tests/fixtures/RingBatteryProtocolTest.java rename to tests/kotlin/src/androidHostTest/java/com/faceclaw/app/RingBatteryProtocolTest.java diff --git a/tests/fixtures/TextureCacheProtocolTest.java b/tests/kotlin/src/androidHostTest/java/com/faceclaw/app/TextureCacheProtocolTest.java similarity index 100% rename from tests/fixtures/TextureCacheProtocolTest.java rename to tests/kotlin/src/androidHostTest/java/com/faceclaw/app/TextureCacheProtocolTest.java diff --git a/tests/kotlin/src/androidHostTest/kotlin/com/faceclaw/app/AndroidProtocolTest.kt b/tests/kotlin/src/androidHostTest/kotlin/com/faceclaw/app/AndroidProtocolTest.kt new file mode 100644 index 00000000..2a48d43b --- /dev/null +++ b/tests/kotlin/src/androidHostTest/kotlin/com/faceclaw/app/AndroidProtocolTest.kt @@ -0,0 +1,117 @@ +package com.faceclaw.app + +import java.io.ByteArrayOutputStream +import java.util.Collections +import java.util.concurrent.Executors +import java.util.concurrent.TimeUnit +import java.util.zip.Inflater +import kotlin.test.* + +// Host tests have no Android clock; all other services use the production adapter. +internal actual fun testPlatform(): ProtocolPlatform = + object : ProtocolPlatform by AndroidProtocolPlatform { + override fun elapsedRealtimeMs() = System.nanoTime() / 1_000_000 + } + +internal actual fun inflateRecords(records: List): List { + val inflater = Inflater() + try { + return records.map { record -> + if (record[0].toInt() and CfwTransport.RESET_CONTEXT != 0) inflater.reset() + val body = record.copyOfRange(5, record.size) + if (record[0].toInt() and CfwTransport.COMPRESSED == 0) body + else { + inflater.setInput(body) + val out = ByteArrayOutputStream() + val buffer = ByteArray(4096) + do { + val count = inflater.inflate(buffer) + out.write(buffer, 0, count) + } while (!inflater.needsInput()) + out.toByteArray() + } + } + } finally { + inflater.end() + } +} + +class AndroidProtocolTest { + @Test + fun javaGoldenCorpus() { + // SHA-256 of packets emitted by the pre-migration Java implementation. + val raw = java.security.MessageDigest.getInstance("SHA-256") + val compressed = java.security.MessageDigest.getInstance("SHA-256") + val transport = CfwTransport(testPlatform()) + var state = 123456789 + try { + repeat(120) { i -> + val size = intArrayOf(0, 1, 4, 247, 248, 252, 4095, 4096, 8192, 65535)[i % 10] + val data = + ByteArray(size) { + state = state xor (state shl 13) + state = state xor (state ushr 17) + state = state xor (state shl 5) + state.toByte() + } + if (i % 3 == 0) data.fill((i % 7).toByte()) + val id = (i * 37) and 255 + val lenses = 1 + (i / 7) % 3 + val mtu = intArrayOf(23, 247, 512, 517)[i % 4] + if (i % 13 == 0) transport.reset() + CfwTransport.frame(data, id, lenses, mtu).forEach { raw.update(it) } + transport.encode(data, id, lenses, mtu).forEach { compressed.update(it) } + } + assertEquals( + "d0efdb99ac71763dd29b70fbd0021b80e1cfe514dfc8a60e2a8424892b16c9f5", + raw.digest().toHexString(), + ) + assertEquals( + "eb5ce0cc6e41b8e84f0d9455f98f3f666b20be0643c3756c5f7aa9d9a66085e2", + compressed.digest().toHexString(), + ) + } finally { + transport.close() + } + } + + @Test + fun writeModeMapping() { + assertEquals( + android.bluetooth.BluetoothGattCharacteristic.WRITE_TYPE_DEFAULT, + AndroidProtocolPlatform.writeType(GattWriteMode.WITH_RESPONSE), + ) + assertEquals( + android.bluetooth.BluetoothGattCharacteristic.WRITE_TYPE_NO_RESPONSE, + AndroidProtocolPlatform.writeType(ConnectionOptions.WRITE_MODE), + ) + } + + @Test + fun concurrentAllocationNeverDuplicatesAnInUseId() { + val pool = BleMagicPool(testPlatform()) + val inUse = Collections.synchronizedSet(mutableSetOf()) + val executor = Executors.newFixedThreadPool(8) + try { + val jobs = + List(8) { + executor.submit { + repeat(2000) { + val id = pool.allocate() + assertTrue(inUse.add(id)) + Thread.yield() + assertTrue(inUse.remove(id)) + pool.release(1, id, null, null) + } + } + } + jobs.forEach { it.get(30, TimeUnit.SECONDS) } + assertEquals(156, List(156) { pool.allocate() }.toSet().size) + } finally { + executor.shutdownNow() + } + } +} + +internal actual fun digest(bytes: ByteArray): String = + BinaryEncoding.bytesToHex(java.security.MessageDigest.getInstance("SHA-256").digest(bytes)) diff --git a/tests/kotlin/src/androidHostTest/kotlin/com/faceclaw/app/JavaCompatibilityTest.kt b/tests/kotlin/src/androidHostTest/kotlin/com/faceclaw/app/JavaCompatibilityTest.kt new file mode 100644 index 00000000..1edb969a --- /dev/null +++ b/tests/kotlin/src/androidHostTest/kotlin/com/faceclaw/app/JavaCompatibilityTest.kt @@ -0,0 +1,27 @@ +package com.faceclaw.app + +import kotlin.test.Test + +/** Existing wire fixtures also verify the Java API retained by the Kotlin port. */ +class JavaCompatibilityTest { + @Test fun compass() = CompassProtocolTest.main(emptyArray()) + + @Test fun ringBattery() = RingBatteryProtocolTest.main(emptyArray()) + + @Test fun gestures() = FaceclawGestureEventTest.main(emptyArray()) + + @Test fun textureCache() = TextureCacheProtocolTest.main(emptyArray()) +} + +class AndroidByteReaderTest { + @Test fun repeatedBridgeCrossingsHaveIndependentCursors() { + val buffer = java.nio.ByteBuffer.wrap(byteArrayOf(10, 20, 30)) + val first = AndroidByteReader(buffer) + kotlin.test.assertEquals(10, first.get().toInt()) + kotlin.test.assertEquals(0, buffer.position()) + val second = AndroidByteReader(buffer) + kotlin.test.assertEquals(3, second.remaining()) + kotlin.test.assertEquals(10, second.get().toInt()) + kotlin.test.assertEquals(20, first.get().toInt()) + } +} diff --git a/tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/AudioRecordingTest.kt b/tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/AudioRecordingTest.kt new file mode 100644 index 00000000..b3316cd9 --- /dev/null +++ b/tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/AudioRecordingTest.kt @@ -0,0 +1,44 @@ +package com.faceclaw.app + +import kotlin.test.* + +internal expect fun digest(bytes: ByteArray): String + +class AudioRecordingTest { + @Test + fun javaNoiseSuppressionGoldenAcrossChunksAndReset() { + val suppressor = FaceclawNoiseSuppressor(16000) + val output = ByteSink() + for (round in 0 until 80) { + val input = ByteArray(if (round % 7 == 0) 514 else 640) + for (i in 0 until input.size / 2) { + val value = ((round * 317 + i * 773) % 48000) - 24000 + input[i * 2] = value.toByte() + input[i * 2 + 1] = (value shr 8).toByte() + } + if (round == 41) suppressor.reset() + output.write(assertNotNull(suppressor.process(input))) + } + // SHA-256 from the original Java DSP, including warmup and irregular chunks. + assertEquals( + "4a7e86b70d61d683b17c7051dbd6666f5ea62427fdd7fdb1d4c9a1772a1eb8ef", + digest(output.toByteArray()), + ) + } + + @Test + fun javaGifGoldenIncludingDedupAndLzwCodeGrowth() { + val recorder = SharedGifScreenRecorder() + assertTrue(recorder.encode().isEmpty()) + for (round in 0 until 7) { + val pixels = ByteArray(33 * 17) { ((it * 73 + round * 117) % 256).toByte() } + recorder.addFrame(pixels, 33, 17, round * 133L) + recorder.addFrame(pixels, 33, 17, round * 133L + 10) + } + assertFalse(recorder.isOverflowed()) + assertEquals( + "8c5dcb98fa03653972f7f7d5ddaaacff323dd633578905bc252ebe21f9d82780", + digest(recorder.encode()), + ) + } +} diff --git a/tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/FontTest.kt b/tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/FontTest.kt new file mode 100644 index 00000000..922261b2 --- /dev/null +++ b/tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/FontTest.kt @@ -0,0 +1,22 @@ +package com.faceclaw.app + +import kotlin.test.* + +class FontTest { + @Test + fun bundledFontMatchesJavaMetricsAndGlyphs() { + assertContentEquals(byteArrayOf(25, 19), LvglFontFile.getMetrics(TEST_FONT_PATH)) + val vectors = + mapOf( + 0x25a6 to "b08ecb603fd059b0a00ba3088f18b79185c421e73049797cd3cb0828e1e5cd04", + 0x25c6 to "c176d5dcdb5f7e3a7220455528efde3760672c40cee39b422fc3f5ad20df66dd", + 0x4e2d to "9bde2c8f1ffcf7afc598f4d0350c9ff262484816aa0c9b46d31f0c3c09613003", + 0xff21 to "0074f96299a75b86912282416e47e0823790e091352aec852eff49b89b2e719d", + ) + vectors.forEach { (codePoint, expected) -> + assertEquals(expected, digest(LvglFontFile.getGlyph(TEST_FONT_PATH, codePoint))) + } + assertTrue(LvglFontFile.getGlyph(TEST_FONT_PATH, 0x10ffff).isEmpty()) + assertTrue(LvglFontFile.getMetrics("/nonexistent/faceclaw-font").isEmpty()) + } +} diff --git a/tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/ProtocolTest.kt b/tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/ProtocolTest.kt new file mode 100644 index 00000000..a2c006e6 --- /dev/null +++ b/tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/ProtocolTest.kt @@ -0,0 +1,283 @@ +package com.faceclaw.app + +import kotlin.random.Random +import kotlin.test.* + +internal expect fun testPlatform(): ProtocolPlatform + +internal expect fun inflateRecords(records: List): List + +internal fun record(packets: List): ByteArray = + packets.flatMap { it.slice(9 until it.size - 2) }.toByteArray() + +private fun hex(value: String) = value.chunked(2).map { it.toInt(16).toByte() }.toByteArray() + +private fun u16(bytes: ByteArray, offset: Int) = + (bytes[offset].toInt() and 255) or ((bytes[offset + 1].toInt() and 255) shl 8) + +class ProtocolTest { + @Test + fun javaGoldenPacketsAndCrc() { + assertEquals(0x29b1, CfwTransport.crc("123456789".encodeToByteArray())) + assertEquals(0xffff, CfwTransport.crc(byteArrayOf())) + // Captured from the Java implementation before migration, including sequence wrap. + val expected = + listOf( + "aa21ff0c0101f000830b0f0078c331323334862b", + "aa21000c0101f000033536373839616263648c7b", + "aa2101050101f000436566de70", + ) + val actual = CfwTransport.frame("123456789abcdef".encodeToByteArray(), 255, 3, 23) + assertEquals(expected.size, actual.size) + expected.zip(actual).forEach { (a, b) -> assertContentEquals(hex(a), b) } + } + + @Test + fun framingBoundariesAndValidation() { + for (size in listOf(0, 1, 247, 252, 253, 65535)) { + val data = ByteArray(size) { it.toByte() } + for (mtu in listOf(23, 247, 512, 517)) { + val packets = CfwTransport.frame(data, 255, 2, mtu) + packets.forEachIndexed { i, packet -> + assertTrue(packet.size <= mtu - 3) + assertEquals((255 + i) and 255, packet[2].toInt() and 255) + assertEquals(packet.size - 8, packet[3].toInt() and 255) + assertEquals( + 2 or (if (i == 0) 128 else 0) or (if (i == packets.lastIndex) 64 else 0), + packet[8].toInt() and 255, + ) + assertEquals( + CfwTransport.crc(packet.copyOfRange(8, packet.size - 2)), + u16(packet, packet.size - 2), + ) + } + val stream = record(packets) + assertEquals(size, u16(stream, 1)) + assertEquals(CfwTransport.crc(data), u16(stream, 3)) + assertContentEquals(data, stream.copyOfRange(5, stream.size)) + } + } + for (invalid in listOf(null, ByteArray(65536))) assertFailsWith< + IllegalArgumentException + > { + CfwTransport.frame(invalid, 0, 3, 23) + } + for (stream in listOf(-1, 256)) assertFailsWith { + CfwTransport.frame(byteArrayOf(), stream, 3, 23) + } + for (lens in listOf(0, 4)) assertFailsWith { + CfwTransport.frame(byteArrayOf(), 0, lens, 23) + } + for (mtu in listOf(22, 518)) assertFailsWith { + CfwTransport.frame(byteArrayOf(), 0, 3, mtu) + } + } + + @Test + fun streamingCompressionRoundTripsAndResets() { + val transport = CfwTransport(testPlatform()) + try { + val text = "shared history 👓 ".repeat(300).encodeToByteArray() + val inputs = listOf(text, text, byteArrayOf(), byteArrayOf(), text, text) + val records = inputs.mapIndexed { i, data -> + if (i == 5) transport.reset() + record(transport.encode(data, i, if (i < 4) 3 else 1, 247)) + } + assertTrue(records[1].size < records[0].size) + assertTrue(records[0][0].toInt() and CfwTransport.RESET_CONTEXT != 0) + assertEquals(0, records[1][0].toInt() and CfwTransport.RESET_CONTEXT) + assertTrue(records[4][0].toInt() and CfwTransport.RESET_CONTEXT != 0) + assertTrue(records[5][0].toInt() and CfwTransport.RESET_CONTEXT != 0) + inputs.zip(inflateRecords(records)).forEach { (a, b) -> assertContentEquals(a, b) } + transport.close() + transport.close() + val reopened = record(transport.encode(text, 10, 1, 512)) + assertTrue(reopened[0].toInt() and CfwTransport.RESET_CONTEXT != 0) + assertContentEquals(text, inflateRecords(listOf(reopened)).single()) + } finally { + transport.close() + } + } + + @Test + fun incompressibleMaximumFallsBackWithoutPoisoningHistory() { + val transport = CfwTransport(testPlatform()) + try { + val data = Random(42).nextBytes(65535) + val raw = record(transport.encode(data, 255, 3, 517)) + assertEquals(3 or CfwTransport.RESET_CONTEXT, raw[0].toInt()) + val next = record(transport.encode(data.copyOf(1000), 0, 3, 517)) + assertTrue(next[0].toInt() and CfwTransport.RESET_CONTEXT != 0) + val decoded = inflateRecords(listOf(raw, next)) + assertContentEquals(data, decoded[0]) + assertContentEquals(data.copyOf(1000), decoded[1]) + } finally { + transport.close() + } + } + + @Test + fun ackBatchesAndMalformedPackets() { + for (count in 1..4) { + val packet = ackPacket(count) + val acks = assertNotNull(CfwTransport.parseAcks(packet)) + assertEquals(count, acks.size) + acks.forEachIndexed { i, ack -> + assertFalse(ack.nack) + assertEquals(255 - i, ack.streamId) + assertEquals(0x1234 + i, ack.messageId) + assertEquals(2, ack.lens) + assertEquals(0x4567 + i, ack.size) + assertEquals(0xabcd + i, ack.checksum) + } + assertEquals(255, assertNotNull(CfwTransport.parseAck(packet)).streamId) + // Every bit of the payload (including ACK trailers and CRC) is protected. + for (i in 8 until packet.size) { + val corrupt = packet.copyOf() + corrupt[i] = (corrupt[i].toInt() xor 1).toByte() + assertNull(CfwTransport.parseAcks(corrupt)) + } + } + assertTrue(assertNotNull(CfwTransport.parseAck(ackPacket(1, 3))).nack) + assertNull(CfwTransport.parseAcks(ackPacket(2, 3))) + assertNull(CfwTransport.parseAcks(ackPacket(5))) + assertNull(CfwTransport.parseAcks(ackPacket(1, 2))) + for (index in listOf(0, 1, 3, 4, 5, 6, 7)) { + val corrupt = ackPacket(1) + corrupt[index] = (corrupt[index].toInt() xor 1).toByte() + assertNull(CfwTransport.parseAcks(corrupt)) + } + val wrongLens = ackPacket(1) + wrongLens[12] = 3 + sealAck(wrongLens) + assertNull(CfwTransport.parseAcks(wrongLens)) + for (size in 0..18) assertNull(CfwTransport.parseAcks(ByteArray(size))) + assertNull(CfwTransport.parseAcks(null)) + } + + @Test + fun ackMatchingAndReplay() { + val input = byteArrayOf(1, 2, 3) + val message = message(input = input) + input[0] = 99 + assertContentEquals(byteArrayOf(1, 2, 3), message.message) + fun ack( + lens: Int, + stream: Int = 100, + nack: Boolean = false, + size: Int = 3, + checksum: Int = message.cfwChecksum, + id: Int = 0, + ) = CfwTransport.Ack(nack, stream, id, lens, size, checksum) + assertFalse(message.acceptCfwAck(null)) + assertFalse(message.acceptCfwAck(ack(1, stream = 99))) + assertFalse(message.acceptCfwAck(ack(1, size = 4))) + assertFalse(message.acceptCfwAck(ack(1, checksum = 0))) + assertFalse(message.acceptCfwAck(ack(3))) + assertFalse(message.acceptCfwAck(ack(1, id = 1))) + assertEquals(0, message.cfwAckLenses) + assertFalse(message.acceptCfwAck(ack(1))) + assertFalse(message.acceptCfwAck(ack(1))) + assertTrue(message.acceptCfwAck(ack(2))) + assertFalse(message.acceptCfwAck(ack(1, nack = true, size = 0, checksum = 0))) + assertFalse(message.acceptCfwAck(ack(2))) + message.ackDeadlineAtMs = 500 + message.ackPayload = byteArrayOf(1) + message.prepareCfwReplay(101) + assertEquals(1, message.cfwRetries) + assertFalse(message.cfwRetryPending) + assertEquals(0, message.cfwAckLenses) + assertEquals(0L, message.ackDeadlineAtMs) + assertTrue(message.ackPayload.isEmpty()) + assertFalse(message.acceptCfwAck(ack(1))) + assertFalse(message.acceptCfwAck(ack(1, stream = 101))) + assertTrue(message.acceptCfwAck(ack(2, stream = 101))) + var callbacks = 0 + message.onAck = MessageCallback { callbacks++ } + message.onAck!!.run() + assertEquals(1, callbacks) + } + + @Test + fun orderedCompletionAndWholeWindowRecovery() { + val head = message() + val tail = message() + val stock = message(sid = 1) + val window = listOf(stock, head, tail) + tail.cfwAckLenses = 3 + assertNull(CfwMessageWindow.acknowledgedHead(window)) + assertTrue(CfwMessageWindow.replayWindow(window, 100).isEmpty()) + head.ackDeadlineAtMs = 100 + assertTrue(CfwMessageWindow.replayWindow(window, 99).isEmpty()) + assertEquals(listOf(head, tail), CfwMessageWindow.replayWindow(window, 100)) + head.cfwAckLenses = 3 + assertSame(head, CfwMessageWindow.acknowledgedHead(window)) + assertTrue(CfwMessageWindow.replayWindow(window, 100).isEmpty()) + tail.cfwRetryPending = true + assertEquals(listOf(head, tail), CfwMessageWindow.replayWindow(window, 100)) + head.cfwRetryPending = true + assertNull(CfwMessageWindow.acknowledgedHead(window)) + } + + @Test + fun magicPoolExhaustionLruAndReleaseRecords() { + var now = 123L + val platform = + object : ProtocolPlatform by testPlatform() { + override fun elapsedRealtimeMs() = now + } + val pool = BleMagicPool(platform) + assertEquals((100..255).toList(), List(156) { pool.allocate() }) + assertFailsWith { pool.allocate() } + pool.release(1, 101, "first", "ack") + pool.release(1, 100, null, null) + now = 456 + pool.release(2, 101, "other", "timeout") // duplicate release must not allocate twice + assertEquals(101, pool.allocate()) + assertEquals(100, pool.allocate()) + assertFailsWith { pool.allocate() } + val first = assertNotNull(pool.getReleaseRecord(1, 101)) + assertEquals(123L, first.releasedAtMs) + assertEquals("first", first.label) + assertEquals(456L, assertNotNull(pool.getReleaseRecord(2, 101)).releasedAtMs) + assertEquals("", assertNotNull(pool.getReleaseRecord(1, 100)).reason) + for (invalid in listOf(-1, 99, 256)) { + pool.release(1, invalid, "bad", "bad") + assertNull(pool.getReleaseRecord(1, invalid)) + } + } +} + +private fun message(sid: Int = CfwTransport.SID, input: ByteArray = byteArrayOf(1, 2, 3)) = + OutboundMessage("test", "test", sid, 0, 100, input, 500, 0, false) + +private fun ackPacket(count: Int, kind: Int = 1): ByteArray { + val packet = ByteArray(19 + (count - 1) * 7) + packet[0] = 0xaa.toByte() + packet[1] = 0x12 + packet[3] = (packet.size - 8).toByte() + packet[4] = 1 + packet[5] = 1 + packet[6] = 0xf0.toByte() + packet[8] = kind.toByte() + packet[12] = 2 + fun put16(offset: Int, value: Int) { + packet[offset] = value.toByte() + packet[offset + 1] = (value ushr 8).toByte() + } + for (i in 0 until count) { + val offset = if (i == 0) 9 else 17 + (i - 1) * 7 + packet[offset] = (255 - i).toByte() + put16(offset + 1, 0x1234 + i) + put16(offset + (if (i == 0) 4 else 3), 0x4567 + i) + put16(offset + (if (i == 0) 6 else 5), 0xabcd + i) + } + sealAck(packet) + return packet +} + +private fun sealAck(packet: ByteArray) { + val crc = CfwTransport.crc(packet.copyOfRange(8, packet.size - 2)) + packet[packet.size - 2] = crc.toByte() + packet[packet.size - 1] = (crc ushr 8).toByte() +} diff --git a/tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/SharedGraphicsTest.kt b/tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/SharedGraphicsTest.kt new file mode 100644 index 00000000..d2ef7b4a --- /dev/null +++ b/tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/SharedGraphicsTest.kt @@ -0,0 +1,136 @@ +package com.faceclaw.app + +import kotlin.test.* + +class SharedGraphicsTest { + private fun hex(value: String) = value.chunked(2).map { it.toInt(16).toByte() }.toByteArray() + + @Test + fun androidWireVectorsAndGrayQuantization() { + val vectors = + listOf( + BleProtocol.buildAuthenticationRequest(101) to "080410651a0408011004", + BleProtocol.PRELUDE_F5872_PAYLOAD to "0802109c01220a1a081206120408001000", + BleProtocol.buildCreateInputPage(102) to + "080010661a2308011a1c0800100018c00420a0024801520964617368626f617264580162012028904e", + BleProtocol.buildHeartbeat(103) to "080c106772020800", + BleProtocol.buildSettingsQuery(104) to "0802106822020801", + BleProtocol.buildShutdown(105, 1) to "080910695a020801", + BleProtocol.buildFaceclawWakeControl(5, 0) to "08011000aa0606464301050000", + ) + vectors.forEach { (actual, expected) -> assertContentEquals(hex(expected), actual) } + val packed = + BmpUtil.pack4bppFromGray8( + byteArrayOf(0, 1, 7, 8, 15, 16, 23, 24, 127, -128, -9, -1), + 3, + 4, + ) + assertContentEquals(hex("0000111012808ff0"), packed) + assertContentEquals(hex("40311011121810182f10"), BleImageOptimizer.rleEncode(packed)) + assertContentEquals( + hex("aa21400c01018000080410651a04080110041024"), + BleProtocol.framePb(vectors.first().first, 128, 0, 64).single(), + ) + } + + @Test + fun splitStreamsExpiryAndCorruption() { + val payload = + BleProtocol.encodeVarintField(1, 3) + + BleProtocol.encodeVarintField(2, 110) + + BleProtocol.encodeBytesField(8, ByteArray(3900) { 55 }) + val frames = BleProtocol.framePb(payload, 224, 32, 17, 185) + assertTrue(frames.all { it.size <= 185 }) + val stream = frames.reduce { a, b -> a + b } + val receiver = MessageReceiver() + assertTrue(receiver.receive("L", stream.copyOf(7), 0).isEmpty()) + val message = receiver.receive("L", stream.copyOfRange(7, stream.size), 1).single() + assertContentEquals(payload, message.payload) + assertEquals(3, message.command) + assertEquals(110, message.magic) + stream[stream.lastIndex] = (stream.last().toInt() xor 1).toByte() + assertTrue(receiver.receive("L", stream, 2).isEmpty()) + receiver.receive("L", frames.first(), 10) + assertTrue(receiver.receive("R", frames.drop(1).reduce { a, b -> a + b }, 11).isEmpty()) + assertTrue(receiver.receive("L", frames.drop(1).reduce { a, b -> a + b }, 5011).isEmpty()) + assertFailsWith { BleProtocol.framePb(payload, 1, 0, 1, 10) } + assertFailsWith { BleProtocol.framePb(ByteArray(60000), 1, 0, 1) } + val invalid = BleProtocol.framePb(byteArrayOf(0x1a, 0x7f), 224, 0, 2).single() + assertTrue(receiver.receive("L", invalid, 6000).isEmpty()) + } + + @Test + fun eventDecodeAcceptsValidatedPayloadWithoutStrippingAgain() { + val event = BleProtocol.encodeVarintField(1, 12) + BleProtocol.encodeVarintField(2, 2) + val payload = BleProtocol.encodeBytesField(13, BleProtocol.encodeBytesField(3, event)) + val received = + MessageReceiver() + .receive("L", BleProtocol.framePb(payload, 224, 1, 1).single(), 0) + .single() + val decoded = assertNotNull(G2Event.decodePayload(received.sid, received.payload)) + assertEquals("sys-event", decoded.kind) + assertEquals(12, decoded.eventType) + assertEquals(2, decoded.eventSource) + } + + @Test + fun retainedCompositionClippingDimmingAndBlanking() { + val c = SurfaceCompositor() + c.configureScreen(3, 2) + c.configureSurface("app", 0, 0, 3, 2, 0, 0) + c.submitSurface("app", ArrayByteReader(ByteArray(6) { 200.toByte() }), 0, 0, 3, 2, "1") + c.configureSurface("shell", 0, 0, 3, 2, 1, 1) + c.submitSurface("shell", ArrayByteReader(byteArrayOf(0, 1, -1, 0, 0, 0)), 0, 0, 3, 2, "2") + c.setUnderlayDim(1, 128) + assertContentEquals(byteArrayOf(100, 1, -1, 100, 100, 100), c.composite().gray) + c.setSurfaceVisible("shell", false) + assertContentEquals(ByteArray(6) { 100 }, c.composite().gray) + c.configureSurface("opaque", 1, 0, 1, 2, 2, 0) + c.submitSurface("opaque", ArrayByteReader(byteArrayOf(0, 0)), 0, 0, 1, 2, "3") + assertContentEquals(byteArrayOf(100, 0, 100, 100, 0, 100), c.composite().gray) + c.setBlanked(true) + assertContentEquals(ByteArray(6), c.composite().gray) + c.setBlanked(false) + c.removeSurface("opaque") + c.configureSurface("app", -1, 0, 3, 2, 0, 0) + c.setUnderlayDim(0, 256) + assertContentEquals(byteArrayOf(-56, -56, 0, -56, -56, 0), c.composite().gray) + } + + @Test + fun pngChunksAndPixels() { + val png = SharedScreenshots.encode4BitGrayPng(byteArrayOf(0, 16, -1, 32, 48, 64), 3, 2) + assertContentEquals(hex("89504e470d0a1a0a"), png.copyOf(8)) + fun intAt(offset: Int): Int = + (0..3).fold(0) { n, i -> (n shl 8) or (png[offset + i].toInt() and 255) } + var offset = 8 + val types = mutableListOf() + var compressed = ByteArray(0) + while (offset < png.size) { + val size = intAt(offset) + val type = png.copyOfRange(offset + 4, offset + 8).decodeToString() + types.add(type) + if (type == "IHDR") { + assertEquals(3, intAt(offset + 8)) + assertEquals(2, intAt(offset + 12)) + assertEquals(4, png[offset + 16].toInt()) + assertEquals(0, png[offset + 17].toInt()) + } + if (type == "IDAT") compressed += png.copyOfRange(offset + 8, offset + 8 + size) + offset += size + 12 + } + assertEquals(listOf("IHDR", "IDAT", "IEND"), types) + assertContentEquals(hex("0001f0002340"), inflateData(compressed, 6)) + } + + @Test + fun wavHeaderAndHex() { + assertEquals("007f80ff", BinaryEncoding.bytesToHex(byteArrayOf(0, 127, -128, -1))) + assertContentEquals( + hex( + "524946462804000057415645666d74201000000001000100803e0000007d0000020010006461746104040000" + ), + BinaryEncoding.wavHeader(1028, 16000, 1), + ) + } +} diff --git a/tests/kotlin/src/iosTest/kotlin/com/faceclaw/app/IosNativeApiTest.kt b/tests/kotlin/src/iosTest/kotlin/com/faceclaw/app/IosNativeApiTest.kt new file mode 100644 index 00000000..2d0f0191 --- /dev/null +++ b/tests/kotlin/src/iosTest/kotlin/com/faceclaw/app/IosNativeApiTest.kt @@ -0,0 +1,38 @@ +package com.faceclaw.app + +import kotlin.test.* + +class IosNativeApiTest { + @Test + fun binaryFacadeRoundTripsAndSlices() { + val bytes = byteArrayOf(0, -1, 2, -128) + assertContentEquals(bytes, bytes.data().byteArray()) + assertTrue(byteArrayOf().data().byteArray().isEmpty()) + val reader = IosByteReader(bytes.data()) + assertEquals(0, reader.get().toInt()) + val target = ByteArray(5) + reader.get(target, 1, 3) + assertContentEquals(byteArrayOf(0, -1, 2, -128, 0), target) + assertEquals(0, reader.remaining()) + val protocol = IosProtocol() + val auth = protocol.authentication(101) + val frames = protocol.frame(auth, 128, 0, 64, 185) + val result = IosMessageReceiver().receive("L", frames.single(), 0).single() + assertEquals(101, result.magic) + assertContentEquals(auth.byteArray(), result.payload.byteArray()) + } + + @Test + fun nativeCompositorClipsPartialUpdatesBeforeCoalescing() { + val compositor = IosSurfaceCompositor(3, 2) + compositor.configure("app", 0, 0, 3, 2, 0, false) + compositor.submit("app", byteArrayOf(10, 20, 30, 40, 50, 60).data(), -1, 0, 3, 2) + assertContentEquals(byteArrayOf(20, 30, 0, 50, 60, 0), compositor.composite().byteArray()) + compositor.submit("app", byteArrayOf(99).data(), 2, 1, 1, 1) + assertContentEquals(byteArrayOf(20, 30, 0, 50, 60, 99), compositor.composite().byteArray()) + compositor.blank(true) + assertContentEquals(ByteArray(6), compositor.composite().byteArray()) + compositor.blank(false) + assertEquals(99, compositor.composite().byteArray().last().toInt()) + } +} diff --git a/tests/kotlin/src/iosTest/kotlin/com/faceclaw/app/IosProtocolTest.kt b/tests/kotlin/src/iosTest/kotlin/com/faceclaw/app/IosProtocolTest.kt new file mode 100644 index 00000000..0afc74d4 --- /dev/null +++ b/tests/kotlin/src/iosTest/kotlin/com/faceclaw/app/IosProtocolTest.kt @@ -0,0 +1,81 @@ +@file:OptIn(kotlinx.cinterop.ExperimentalForeignApi::class) + +package com.faceclaw.app + +import kotlin.test.* +import kotlinx.cinterop.* +import platform.CoreBluetooth.* +import platform.posix.memset +import platform.zlib.* + +internal actual fun testPlatform(): ProtocolPlatform = IosProtocolPlatform + +internal actual fun inflateRecords(records: List): List = memScoped { + val stream = alloc() + memset(stream.ptr, 0, sizeOf().convert()) + check(inflateInit(stream.ptr) == Z_OK) + try { + records.map { record -> + if (record[0].toInt() and CfwTransport.RESET_CONTEXT != 0) + check(inflateReset(stream.ptr) == Z_OK) + val body = record.copyOfRange(5, record.size) + if (record[0].toInt() and CfwTransport.COMPRESSED == 0) body + else { + val output = mutableListOf() + val buffer = ByteArray(4096) + body.usePinned { input -> + stream.next_in = input.addressOf(0).reinterpret() + stream.avail_in = body.size.toUInt() + buffer.usePinned { destination -> + do { + stream.next_out = destination.addressOf(0).reinterpret() + stream.avail_out = buffer.size.toUInt() + val status = inflate(stream.ptr, Z_SYNC_FLUSH) + check(status == Z_OK || status == Z_BUF_ERROR) + output.addAll(buffer.take(buffer.size - stream.avail_out.toInt())) + } while (stream.avail_in > 0u || stream.avail_out == 0u) + } + } + stream.next_in = null + stream.next_out = null + output.toByteArray() + } + } + } finally { + inflateEnd(stream.ptr) + } +} + +class IosProtocolTest { + @Test + fun platformClockAndWriteModes() { + val before = IosProtocolPlatform.elapsedRealtimeMs() + assertTrue(before > 0) + assertTrue(IosProtocolPlatform.elapsedRealtimeMs() >= before) + assertEquals( + CBCharacteristicWriteWithResponse, + IosProtocolPlatform.writeType(GattWriteMode.WITH_RESPONSE), + ) + assertEquals( + CBCharacteristicWriteWithoutResponse, + IosProtocolPlatform.writeType(ConnectionOptions.WRITE_MODE), + ) + } +} + +internal actual fun digest(bytes: ByteArray): String { + val result = ByteArray(32) + result.usePinned { output -> + if (bytes.isEmpty()) + platform.CoreCrypto.CC_SHA256(null, 0u, output.addressOf(0).reinterpret()) + else + bytes.usePinned { input -> + platform.CoreCrypto.CC_SHA256( + input.addressOf(0), + bytes.size.toUInt(), + output.addressOf(0).reinterpret(), + ) + } + } + return BinaryEncoding.bytesToHex(result) +} diff --git a/tests/ring-battery-protocol.test.cjs b/tests/ring-battery-protocol.test.cjs deleted file mode 100644 index eebaea03..00000000 --- a/tests/ring-battery-protocol.test.cjs +++ /dev/null @@ -1,19 +0,0 @@ -const test = require('node:test'); -const fs = require('node:fs'); -const os = require('node:os'); -const path = require('node:path'); -const { execFileSync } = require('node:child_process'); - -test('ring battery decodes valid, unavailable, legacy, and malformed reports', () => { - const directory = fs.mkdtempSync(path.join(os.tmpdir(), 'faceclaw-ring-java-')); - const javaBin = (name) => process.env.JAVA_HOME ? path.join(process.env.JAVA_HOME, 'bin', name) : name; - try { - execFileSync(javaBin('javac'), ['-d', directory, - path.join(__dirname, '../App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/BleProtocol.java'), - path.join(__dirname, '../App_Resources/Android/src/main/java/com/faceclaw/app/util/CollectionUtils.java'), - path.join(__dirname, 'fixtures/RingBatteryProtocolTest.java')], { stdio: 'pipe' }); - execFileSync(javaBin('java'), ['-ea', '-cp', directory, 'com.faceclaw.app.RingBatteryProtocolTest'], { stdio: 'pipe' }); - } finally { - fs.rmSync(directory, { recursive: true, force: true }); - } -}); diff --git a/tests/texture-cache-protocol.test.cjs b/tests/texture-cache-protocol.test.cjs deleted file mode 100644 index dc397251..00000000 --- a/tests/texture-cache-protocol.test.cjs +++ /dev/null @@ -1,23 +0,0 @@ -const test = require('node:test'); -const fs = require('node:fs'); -const os = require('node:os'); -const path = require('node:path'); -const { execFileSync } = require('node:child_process'); - -test('256 KiB cache uploads and planner draws preserve wide image and glyph offsets', () => { - const directory = fs.mkdtempSync(path.join(os.tmpdir(), 'faceclaw-texture-java-')); - const javaBin = (name) => process.env.JAVA_HOME ? path.join(process.env.JAVA_HOME, 'bin', name) : name; - const root = path.join(__dirname, '../App_Resources/Android/src/main/java/com/faceclaw/app'); - try { - const clock = path.join(directory, 'SystemClock.java'); - const log = path.join(directory, 'Log.java'); - fs.writeFileSync(clock, 'package android.os; public class SystemClock { public static long elapsedRealtime() { return 0; } }'); - fs.writeFileSync(log, 'package android.util; public class Log { public static int i(String tag, String msg) { return 0; } }'); - const sources = ['GlyphAtlas.java', 'ImageAtlas.java', 'FwGlyphAtlas.java', 'SurfaceCompositor.java', - 'util/BmpUtil.java', 'util/CollectionUtils.java', 'g2protocol/BleProtocol.java', - 'g2protocol/BleImageOptimizer.java', 'g2protocol/TextureCacheState.java', 'g2protocol/TexturePlanner.java']; - execFileSync(javaBin('javac'), ['-d', directory, ...sources.map(file => path.join(root, file)), - clock, log, path.join(__dirname, 'fixtures/TextureCacheProtocolTest.java')], { stdio: 'pipe' }); - execFileSync(javaBin('java'), ['-ea', '-cp', directory, 'com.faceclaw.app.TextureCacheProtocolTest'], { stdio: 'pipe' }); - } finally { fs.rmSync(directory, { recursive: true, force: true }); } -}); From 68810197a8896dabea9c1e90bc33bdaddb820a52 Mon Sep 17 00:00:00 2001 From: James Babcock Date: Fri, 18 Sep 2026 22:48:20 -0700 Subject: [PATCH 20/99] Refactor Java to shared kotlin --- .gitignore | 4 + App_Resources/Android/app.gradle | 19 + App_Resources/Android/before-plugins.gradle | 4 +- .../com/faceclaw/app/AndroidNoiseEffects.java | 59 + .../faceclaw/app/FaceclawAlarmListener.java | 6 - .../app/FaceclawAmbientLightListener.java | 10 - .../app/FaceclawAudioPacketListener.java | 5 - .../faceclaw/app/FaceclawBleCommunicator.java | 18 +- .../app/FaceclawBleCommunicatorListener.java | 15 - .../com/faceclaw/app/FaceclawBleListener.java | 6 - .../com/faceclaw/app/FaceclawBleManager.java | 2 +- .../app/FaceclawCaptionEngineListener.java | 17 - .../faceclaw/app/FaceclawCompassListener.java | 7 - .../app/FaceclawDeviceDiscoveryListener.java | 18 - .../faceclaw/app/FaceclawDeviceInfoProbe.java | 4 +- .../faceclaw/app/FaceclawEvenHubListener.java | 18 - .../faceclaw/app/FaceclawFirmwareFlasher.java | 2 +- .../app/FaceclawFirmwareFlasherListener.java | 24 - .../faceclaw/app/FaceclawFirmwareUtil.java | 57 - .../app/FaceclawFlashPromptCommunicator.java | 2 +- .../app/FaceclawFlashPromptListener.java | 23 - .../com/faceclaw/app/FaceclawImuListener.java | 10 - .../faceclaw/app/FaceclawLlamaListener.java | 16 - .../app/FaceclawLocationListener.java | 8 - .../app/FaceclawLocationTrackerListener.java | 13 - .../app/FaceclawMediaBrowserListener.java | 10 - .../app/FaceclawMediaControllerListener.java | 23 - .../app/FaceclawMicStatusListener.java | 10 - .../app/FaceclawModelDownloaderListener.java | 11 - .../faceclaw/app/FaceclawNoiseSuppressor.java | 266 --- .../app/FaceclawNotificationListener.java | 5 - .../app/FaceclawPreviewCompositor.java | 3 +- .../app/FaceclawQrScannerListener.java | 10 - .../app/FaceclawRingEventDecoder.java | 126 -- .../app/FaceclawSettingsListener.java | 6 - .../app/FaceclawVoiceControllerListener.java | 47 - .../com/faceclaw/app/FaceclawWavRecorder.java | 100 -- .../faceclaw/app/FaceclawWearListener.java | 19 - .../app/FaceclawWebSocketListener.java | 9 - .../java/com/faceclaw/app/FwGlyphAtlas.java | 83 - .../com/faceclaw/app/GifScreenRecorder.java | 269 +-- .../java/com/faceclaw/app/GlyphAtlas.java | 267 --- .../java/com/faceclaw/app/ImageAtlas.java | 115 -- .../java/com/faceclaw/app/LvglFontFile.java | 229 --- .../java/com/faceclaw/app/ScreenshotUtil.java | 81 +- .../com/faceclaw/app/SurfaceCompositor.java | 509 ------ .../app/g2protocol/BleImageOptimizer.java | 555 ------- .../faceclaw/app/g2protocol/BleMagicPool.java | 69 - .../faceclaw/app/g2protocol/BleProtocol.java | 1240 -------------- .../app/g2protocol/CfwMessageWindow.java | 38 - .../faceclaw/app/g2protocol/CfwTransport.java | 141 -- .../app/g2protocol/ConnectionOptions.java | 75 - .../com/faceclaw/app/g2protocol/G2Event.java | 116 -- .../app/g2protocol/MessageBuilder.java | 281 ---- .../app/g2protocol/OutboundMessage.java | 71 - .../app/g2protocol/TextureCacheState.java | 179 -- .../app/g2protocol/TexturePlanner.java | 721 -------- .../java/com/faceclaw/app/util/BmpUtil.java | 133 -- .../faceclaw/app/util/CollectionUtils.java | 26 - app/g2/ble-image-optimizer.ios.ts | 15 + app/g2/ble-protocol.ios.ts | 66 + app/g2/cfw-transport.ios.ts | 21 + app/graphics/glyph-wire.ts | 8 +- app/graphics/surface-compositor.ios.ts | 30 + app/native/kotlin-data.ts | 12 + app/native/kotlin-platform.android.ts | 2 + app/native/kotlin-platform.ios.ts | 2 + app/native/kotlin-protocol-smoke.ios.ts | 36 + app/native/kotlin-protocol-smoke.ts | 20 + app/native/lvgl-font.ios.ts | 21 +- hooks/before-prepare/faceclaw-kotlin.js | 8 + native/kotlin/README.md | 79 + native/kotlin/android-java-boundaries.json | 136 ++ native/kotlin/build.gradle.kts | 4 + native/kotlin/migrated-java-sources.json | 198 +++ native/kotlin/plugin/index.js | 1 + native/kotlin/plugin/package.json | 7 + .../plugin/platforms/android/include.gradle | 3 + native/kotlin/settings.gradle.kts | 4 + native/kotlin/shared/build.gradle.kts | 25 + .../com/faceclaw/app/AndroidByteReader.kt | 20 + .../com/faceclaw/app/FaceclawFirmwareUtil.kt | 31 + .../com/faceclaw/app/FaceclawWavRecorder.kt | 72 + .../faceclaw/app/PlatformServices.android.kt | 41 + .../app/g2protocol/AndroidProtocolPlatform.kt | 48 + .../faceclaw/shared/PlatformInfo.android.kt | 11 + .../com/faceclaw/app/PlatformServices.kt | 10 + .../app/audio/FaceclawNoiseSuppressor.kt | 263 +++ .../app/callbacks/FaceclawAlarmListener.kt | 6 + .../callbacks/FaceclawAmbientLightListener.kt | 10 + .../callbacks/FaceclawAudioPacketListener.kt | 5 + .../FaceclawBleCommunicatorListener.kt | 37 + .../app/callbacks/FaceclawBleListener.kt | 7 + .../FaceclawCaptionEngineListener.kt | 22 + .../app/callbacks/FaceclawCompassListener.kt | 14 + .../FaceclawDeviceDiscoveryListener.kt | 17 + .../FaceclawDeviceInfoProbeListener.kt | 12 +- .../app/callbacks/FaceclawEvenHubListener.kt | 18 + .../FaceclawFirmwareFlasherListener.kt | 30 + .../callbacks/FaceclawFlashPromptListener.kt | 25 + .../app/callbacks/FaceclawImuListener.kt | 9 + .../app/callbacks/FaceclawLlamaListener.kt | 16 + .../app/callbacks/FaceclawLocationListener.kt | 13 + .../FaceclawLocationTrackerListener.kt | 19 + .../callbacks/FaceclawMediaBrowserListener.kt | 10 + .../FaceclawMediaControllerListener.kt | 23 + .../callbacks/FaceclawMicStatusListener.kt | 10 + .../FaceclawModelDownloaderListener.kt | 11 + .../callbacks/FaceclawNotificationListener.kt | 5 + .../callbacks/FaceclawQrScannerListener.kt | 10 + .../app/callbacks/FaceclawSettingsListener.kt | 6 + .../app/callbacks/FaceclawSseListener.kt | 15 +- .../FaceclawVoiceControllerListener.kt | 44 + .../app/callbacks/FaceclawWearListener.kt | 17 + .../callbacks/FaceclawWebSocketListener.kt | 12 + .../app/g2protocol/BleImageOptimizer.kt | 735 ++++++++ .../faceclaw/app/g2protocol/BleMagicPool.kt | 43 + .../faceclaw/app/g2protocol/BleProtocol.kt | 1480 +++++++++++++++++ .../app/g2protocol/CfwMessageWindow.kt | 44 + .../faceclaw/app/g2protocol/CfwTransport.kt | 190 +++ .../app/g2protocol/ConnectionOptions.kt | 78 + .../g2protocol/FaceclawRingEventDecoder.kt | 145 ++ .../com/faceclaw/app/g2protocol/G2Event.kt | 141 ++ .../faceclaw/app/g2protocol/MessageBuilder.kt | 292 ++++ .../app/g2protocol/MessageReceiver.kt | 127 ++ .../app/g2protocol/OutboundMessage.kt | 68 + .../app/g2protocol/ProtocolPlatform.kt | 46 + .../app/g2protocol/TextureCacheState.kt | 191 +++ .../faceclaw/app/g2protocol/TexturePlanner.kt | 987 +++++++++++ .../com/faceclaw/app/graphics/FwGlyphAtlas.kt | 89 + .../com/faceclaw/app/graphics/GlyphAtlas.kt | 325 ++++ .../com/faceclaw/app/graphics/ImageAtlas.kt | 134 ++ .../com/faceclaw/app/graphics/LvglFontFile.kt | 250 +++ .../app/graphics/SharedGifScreenRecorder.kt | 270 +++ .../app/graphics/SharedScreenshots.kt | 55 + .../app/graphics/SurfaceCompositor.kt | 702 ++++++++ .../com/faceclaw/app/util/BinaryEncoding.kt | 45 + .../kotlin/com/faceclaw/app/util/BmpUtil.kt | 150 ++ .../com/faceclaw/app/util/ByteReader.kt | 43 + .../kotlin/com/faceclaw/app/util/ByteSink.kt | 44 + .../com/faceclaw/app/util/CollectionUtils.kt | 31 + .../com/faceclaw/shared/KotlinBridge.kt | 35 + .../kotlin/com/faceclaw/app/IosNativeApi.kt | 264 +++ .../com/faceclaw/app/PlatformServices.ios.kt | 72 + .../app/g2protocol/IosProtocolPlatform.kt | 129 ++ .../com/faceclaw/shared/PlatformInfo.ios.kt | 13 + package.json | 5 +- scripts/kotlin-build.cjs | 73 + scripts/test-kotlin.sh | 8 + tests/README.md | 18 +- tests/cfw-transport.test.cjs | 16 +- tests/compass-protocol.test.cjs | 19 - tests/compass-texture-cache.test.cjs | 2 +- tests/faceclaw-gesture-event.test.cjs | 19 - tests/fixtures/CfwTransportVectors.java | 19 - tests/fixtures/cfw-java-golden.json | 7 + tests/kotlin-build.test.cjs | 43 + tests/kotlin/build.gradle.kts | 40 + tests/kotlin/settings.gradle.kts | 3 + .../faceclaw/app}/CompassProtocolTest.java | 0 .../app}/FaceclawGestureEventTest.java | 0 .../app}/RingBatteryProtocolTest.java | 0 .../app}/TextureCacheProtocolTest.java | 0 .../com/faceclaw/app/AndroidProtocolTest.kt | 117 ++ .../com/faceclaw/app/JavaCompatibilityTest.kt | 27 + .../com/faceclaw/app/AudioRecordingTest.kt | 44 + .../kotlin/com/faceclaw/app/FontTest.kt | 22 + .../kotlin/com/faceclaw/app/ProtocolTest.kt | 283 ++++ .../com/faceclaw/app/SharedGraphicsTest.kt | 136 ++ .../com/faceclaw/app/IosNativeApiTest.kt | 38 + .../com/faceclaw/app/IosProtocolTest.kt | 81 + tests/ring-battery-protocol.test.cjs | 19 - tests/texture-cache-protocol.test.cjs | 23 - 173 files changed, 9855 insertions(+), 6252 deletions(-) create mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/AndroidNoiseEffects.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawAlarmListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawAmbientLightListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawAudioPacketListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleCommunicatorListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawCaptionEngineListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawCompassListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawDeviceDiscoveryListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawEvenHubListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFirmwareFlasherListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFirmwareUtil.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFlashPromptListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawImuListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawLlamaListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawLocationListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawLocationTrackerListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawMediaBrowserListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawMediaControllerListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawMicStatusListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawModelDownloaderListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawNoiseSuppressor.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawNotificationListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawQrScannerListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawRingEventDecoder.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawSettingsListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawVoiceControllerListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawWavRecorder.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawWearListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawWebSocketListener.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/FwGlyphAtlas.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/GlyphAtlas.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/ImageAtlas.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/LvglFontFile.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/SurfaceCompositor.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/BleImageOptimizer.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/BleMagicPool.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/BleProtocol.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/CfwMessageWindow.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/CfwTransport.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/ConnectionOptions.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/G2Event.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/MessageBuilder.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/OutboundMessage.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/TextureCacheState.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/TexturePlanner.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/util/BmpUtil.java delete mode 100644 App_Resources/Android/src/main/java/com/faceclaw/app/util/CollectionUtils.java create mode 100644 app/g2/ble-image-optimizer.ios.ts create mode 100644 app/g2/ble-protocol.ios.ts create mode 100644 app/g2/cfw-transport.ios.ts create mode 100644 app/graphics/surface-compositor.ios.ts create mode 100644 app/native/kotlin-data.ts create mode 100644 app/native/kotlin-protocol-smoke.ios.ts create mode 100644 app/native/kotlin-protocol-smoke.ts create mode 100644 hooks/before-prepare/faceclaw-kotlin.js create mode 100644 native/kotlin/README.md create mode 100644 native/kotlin/android-java-boundaries.json create mode 100644 native/kotlin/build.gradle.kts create mode 100644 native/kotlin/migrated-java-sources.json create mode 100644 native/kotlin/plugin/index.js create mode 100644 native/kotlin/plugin/package.json create mode 100644 native/kotlin/plugin/platforms/android/include.gradle create mode 100644 native/kotlin/settings.gradle.kts create mode 100644 native/kotlin/shared/build.gradle.kts create mode 100644 native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/AndroidByteReader.kt create mode 100644 native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/FaceclawFirmwareUtil.kt create mode 100644 native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/FaceclawWavRecorder.kt create mode 100644 native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/PlatformServices.android.kt create mode 100644 native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/g2protocol/AndroidProtocolPlatform.kt create mode 100644 native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/shared/PlatformInfo.android.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/PlatformServices.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/audio/FaceclawNoiseSuppressor.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawAlarmListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawAmbientLightListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawAudioPacketListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawBleCommunicatorListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawBleListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawCaptionEngineListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawCompassListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawDeviceDiscoveryListener.kt rename App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawDeviceInfoProbeListener.java => native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawDeviceInfoProbeListener.kt (52%) create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawEvenHubListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawFirmwareFlasherListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawFlashPromptListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawImuListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawLlamaListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawLocationListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawLocationTrackerListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawMediaBrowserListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawMediaControllerListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawMicStatusListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawModelDownloaderListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawNotificationListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawQrScannerListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawSettingsListener.kt rename App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawSseListener.java => native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawSseListener.kt (65%) create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawVoiceControllerListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawWearListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawWebSocketListener.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/BleImageOptimizer.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/BleMagicPool.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/BleProtocol.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/CfwMessageWindow.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/CfwTransport.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/ConnectionOptions.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/FaceclawRingEventDecoder.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/G2Event.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/MessageBuilder.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/MessageReceiver.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/OutboundMessage.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/ProtocolPlatform.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/TextureCacheState.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/TexturePlanner.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/FwGlyphAtlas.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/GlyphAtlas.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/ImageAtlas.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/LvglFontFile.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/SharedGifScreenRecorder.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/SharedScreenshots.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/SurfaceCompositor.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/BinaryEncoding.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/BmpUtil.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/ByteReader.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/ByteSink.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/CollectionUtils.kt create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/shared/KotlinBridge.kt create mode 100644 native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/app/IosNativeApi.kt create mode 100644 native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/app/PlatformServices.ios.kt create mode 100644 native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/app/g2protocol/IosProtocolPlatform.kt create mode 100644 native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/shared/PlatformInfo.ios.kt create mode 100644 scripts/kotlin-build.cjs create mode 100644 scripts/test-kotlin.sh delete mode 100644 tests/compass-protocol.test.cjs delete mode 100644 tests/faceclaw-gesture-event.test.cjs delete mode 100644 tests/fixtures/CfwTransportVectors.java create mode 100644 tests/fixtures/cfw-java-golden.json create mode 100644 tests/kotlin-build.test.cjs create mode 100644 tests/kotlin/build.gradle.kts create mode 100644 tests/kotlin/settings.gradle.kts rename tests/{fixtures => kotlin/src/androidHostTest/java/com/faceclaw/app}/CompassProtocolTest.java (100%) rename tests/{fixtures => kotlin/src/androidHostTest/java/com/faceclaw/app}/FaceclawGestureEventTest.java (100%) rename tests/{fixtures => kotlin/src/androidHostTest/java/com/faceclaw/app}/RingBatteryProtocolTest.java (100%) rename tests/{fixtures => kotlin/src/androidHostTest/java/com/faceclaw/app}/TextureCacheProtocolTest.java (100%) create mode 100644 tests/kotlin/src/androidHostTest/kotlin/com/faceclaw/app/AndroidProtocolTest.kt create mode 100644 tests/kotlin/src/androidHostTest/kotlin/com/faceclaw/app/JavaCompatibilityTest.kt create mode 100644 tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/AudioRecordingTest.kt create mode 100644 tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/FontTest.kt create mode 100644 tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/ProtocolTest.kt create mode 100644 tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/SharedGraphicsTest.kt create mode 100644 tests/kotlin/src/iosTest/kotlin/com/faceclaw/app/IosNativeApiTest.kt create mode 100644 tests/kotlin/src/iosTest/kotlin/com/faceclaw/app/IosProtocolTest.kt delete mode 100644 tests/ring-battery-protocol.test.cjs delete mode 100644 tests/texture-cache-protocol.test.cjs diff --git a/.gitignore b/.gitignore index 9efee48b..9331ae0a 100644 --- a/.gitignore +++ b/.gitignore @@ -59,3 +59,7 @@ native/kotlin/plugin/platforms/ios/ !native/kotlin/plugin/platforms/ !native/kotlin/plugin/platforms/android/ !native/kotlin/plugin/platforms/android/include.gradle + +tests/kotlin/.gradle/ +tests/kotlin/.kotlin/ +tests/kotlin/build/ diff --git a/App_Resources/Android/app.gradle b/App_Resources/Android/app.gradle index 0e24319a..832823ad 100644 --- a/App_Resources/Android/app.gradle +++ b/App_Resources/Android/app.gradle @@ -262,6 +262,7 @@ android { sourceSets.main { jniLibs.srcDirs += ["$projectDir/src/main/jniLibs"] + // Shared Kotlin is packaged by the local @faceclaw/kotlin plugin. } defaultConfig { @@ -288,7 +289,25 @@ android { } } +// NativeScript can retain deleted App_Resources sources in its generated +// project. Remove the former copy before Kotlin compilation after this move. +def removeLegacyKotlinBridgeSource = tasks.register("removeLegacyKotlinBridgeSource", Delete) { + delete file("$projectDir/src/main/java/com/faceclaw/shared/KotlinBridge.kt") + // Explicit, reviewed source moves: never infer deletions from class names. + def migrations = new groovy.json.JsonSlurper().parse(file("$rootDir/../../native/kotlin/migrated-java-sources.json")) + migrations.each { migration -> + if (!file("$rootDir/../../native/kotlin/${migration.kotlin}").isFile()) { + throw new GradleException("Missing Kotlin replacement: ${migration.kotlin}") + } + delete file("$projectDir/src/main/java/${migration.java}") + } +} +tasks.matching { it.name.startsWith("compile") && it.name.endsWith("Kotlin") }.configureEach { + dependsOn removeLegacyKotlinBridgeSource +} + tasks.matching { it.name == "preBuild" }.configureEach { + dependsOn removeLegacyKotlinBridgeSource dependsOn tasks.named("prepareFaceclawNativeLibs") dependsOn tasks.named("prepareFaceclawLlama") } diff --git a/App_Resources/Android/before-plugins.gradle b/App_Resources/Android/before-plugins.gradle index 8ebcb235..da763a5b 100644 --- a/App_Resources/Android/before-plugins.gradle +++ b/App_Resources/Android/before-plugins.gradle @@ -10,7 +10,7 @@ project.ext { // androidXTransition = "1.4.1" // androidXViewPager = "1.0.0" - // Keep the host compiler/runtime compatible with native/kotlin/build.gradle.kts. - // NativeScript 9 already applies kotlin-android. + // NativeScript 9 already applies kotlin-android. Match the shared KMP compiler + // for our .kt sources; no separate Kotlin installation is required. kotlinVersion = "2.4.20" } diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/AndroidNoiseEffects.java b/App_Resources/Android/src/main/java/com/faceclaw/app/AndroidNoiseEffects.java new file mode 100644 index 00000000..72757990 --- /dev/null +++ b/App_Resources/Android/src/main/java/com/faceclaw/app/AndroidNoiseEffects.java @@ -0,0 +1,59 @@ +package com.faceclaw.app; + +import android.media.audiofx.*; +import java.util.ArrayList; + +/** Android AudioRecord effect attachment; PCM processing lives in shared Kotlin. */ +public final class AndroidNoiseEffects { + /** Whether this Android build ships the built-in capture noise suppressor. */ + public static boolean platformSuppressorAvailable() { + try { + return NoiseSuppressor.isAvailable(); + } catch (Throwable t) { + return false; + } + } + + /** Short engine name for the UI. */ + public static String engineDescription() { + return "spectral (phone DSP)"; + } + + /** + * Attach the platform's built-in capture-effect chain (NoiseSuppressor, + * AcousticEchoCanceler, AutomaticGainControl — whichever this Android + * build provides) to a phone AudioRecord session. Only applicable when the + * phone itself captures the audio; the BLE glasses stream must go through + * {@link #process(byte[])} instead. The caller keeps the returned effects + * for the life of the recording and release()s them with it. + */ + public static AudioEffect[] attachPlatformEffects(int audioSessionId) { + ArrayList effects = new ArrayList<>(); + try { + if (NoiseSuppressor.isAvailable()) { + NoiseSuppressor ns = NoiseSuppressor.create(audioSessionId); + if (ns != null) { + ns.setEnabled(true); + effects.add(ns); + } + } + if (AcousticEchoCanceler.isAvailable()) { + AcousticEchoCanceler aec = AcousticEchoCanceler.create(audioSessionId); + if (aec != null) { + aec.setEnabled(true); + effects.add(aec); + } + } + if (AutomaticGainControl.isAvailable()) { + AutomaticGainControl agc = AutomaticGainControl.create(audioSessionId); + if (agc != null) { + agc.setEnabled(true); + effects.add(agc); + } + } + } catch (Throwable t) { + // A missing effect just means this tier is unavailable. + } + return effects.toArray(new AudioEffect[0]); + } +} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawAlarmListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawAlarmListener.java deleted file mode 100644 index 4d9008f0..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawAlarmListener.java +++ /dev/null @@ -1,6 +0,0 @@ -package com.faceclaw.app; - -/** Phone-side alarm actions (dismiss / snooze), delivered to the JS engine; implemented in JS. */ -public interface FaceclawAlarmListener { - void onPhoneAction(long id, String action, int minutes); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawAmbientLightListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawAmbientLightListener.java deleted file mode 100644 index bc6bc272..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawAmbientLightListener.java +++ /dev/null @@ -1,10 +0,0 @@ -package com.faceclaw.app; - -public interface FaceclawAmbientLightListener { - /** - * A CFW ambient-light report (settings-channel field 105) from the master - * temple. body is the raw 24-byte ['A','L',ver,reason,...] record; it is - * decoded on the TS side (app/native/ambient-light.ts). - */ - void onAmbientLight(byte[] body); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawAudioPacketListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawAudioPacketListener.java deleted file mode 100644 index 16aa0702..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawAudioPacketListener.java +++ /dev/null @@ -1,5 +0,0 @@ -package com.faceclaw.app; - -public interface FaceclawAudioPacketListener { - void onAudioPacket(byte[] data, String arm, long arrivalMs); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleCommunicator.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleCommunicator.java index 0d38e59a..7b5436da 100644 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleCommunicator.java +++ b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleCommunicator.java @@ -154,7 +154,7 @@ public class FaceclawBleCommunicator implements FaceclawBleListener, Runnable { private int lastAudioControlAckMagic = 0; private ConnectionOptions connectionOptions = new ConnectionOptions(); - private final BleMagicPool magicPool = new BleMagicPool(); + private final BleMagicPool magicPool = new BleMagicPool(AndroidProtocolPlatform.INSTANCE); private MessageBuilder messageBuilder = new MessageBuilder(magicPool); private int nextTransportSeq = 0x40; private int nextMapSessionId = 0; @@ -267,7 +267,7 @@ public class FaceclawBleCommunicator implements FaceclawBleListener, Runnable { private final TextureCacheState textureCache = new TextureCacheState(); private final ArrayDeque pendingMessages = new ArrayDeque<>(); - private final CfwTransport[] cfwTransports = { new CfwTransport(), new CfwTransport() }; + private final CfwTransport[] cfwTransports = { new CfwTransport(AndroidProtocolPlatform.INSTANCE), new CfwTransport(AndroidProtocolPlatform.INSTANCE) }; private final ArrayDeque inFlightMessages = new ArrayDeque<>(); private OutboundMessage prewrittenMessage; private List prewrittenFrames = Collections.emptyList(); @@ -360,6 +360,7 @@ public class FaceclawBleCommunicator implements FaceclawBleListener, Runnable { activeInstance = null; } disconnect(); + for (CfwTransport transport : cfwTransports) transport.close(); if (phoneLockReceiverRegistered) { phoneLockReceiverRegistered = false; appContext.unregisterReceiver(phoneLockReceiver); @@ -1231,7 +1232,8 @@ public class FaceclawBleCommunicator implements FaceclawBleListener, Runnable { + (glyphs == null ? " (no glyph draws)" : "")); FrameTimings.getInstance().spanStart(frameId, "composite"); SurfaceCompositor.Composite composite = compositor.applyAndComposite( - surfaceId, pixels8bpp, rectX, rectY, rectWidth, rectHeight, contentFingerprint, glyphs); + surfaceId, new AndroidByteReader(pixels8bpp), rectX, rectY, rectWidth, rectHeight, contentFingerprint, + glyphs == null ? null : new AndroidByteReader(glyphs)); FrameTimings.getInstance().spanEnd(frameId, "composite"); // Pack the composited 8bpp buffer down to the headerless 4bpp frame // format the wire planners consume; BMP framing is added later only for @@ -2622,7 +2624,7 @@ public class FaceclawBleCommunicator implements FaceclawBleListener, Runnable { writeAddress, BleProtocol.WRITE_CHAR_UUID, frames, - ConnectionOptions.WRITE_TYPE, + AndroidProtocolPlatform.writeType(ConnectionOptions.WRITE_MODE), ConnectionOptions.WRITE_TIMEOUT_MS ); @@ -2669,7 +2671,7 @@ public class FaceclawBleCommunicator implements FaceclawBleListener, Runnable { writeAddress, BleProtocol.WRITE_CHAR_UUID, prefixFrames, - ConnectionOptions.WRITE_TYPE, + AndroidProtocolPlatform.writeType(ConnectionOptions.WRITE_MODE), ConnectionOptions.WRITE_TIMEOUT_MS ); if (!result) { @@ -2705,7 +2707,7 @@ public class FaceclawBleCommunicator implements FaceclawBleListener, Runnable { writeAddress, BleProtocol.WRITE_CHAR_UUID, Collections.singletonList(finalFrame), - ConnectionOptions.WRITE_TYPE, + AndroidProtocolPlatform.writeType(ConnectionOptions.WRITE_MODE), ConnectionOptions.WRITE_TIMEOUT_MS ); } @@ -3433,7 +3435,7 @@ public class FaceclawBleCommunicator implements FaceclawBleListener, Runnable { if (operation == BleProtocol.FACECLAW_WAKE_OP_ACQUIRE) { lastFaceclawWakeLeaseQueuedAtMs = SystemClock.elapsedRealtime(); } - Runnable onSent = () -> { + MessageCallback onSent = () -> { if (faceclawWakeControlGeneration == generation) { faceclawWakeControlSentCount += 1; } @@ -3489,7 +3491,7 @@ public class FaceclawBleCommunicator implements FaceclawBleListener, Runnable { if (operation == BleProtocol.FACECLAW_FB_OP_ACQUIRE) { lastFaceclawFramebufferLeaseQueuedAtMs = SystemClock.elapsedRealtime(); } - Runnable onSent = () -> { + MessageCallback onSent = () -> { if (faceclawFramebufferControlGeneration == generation) { faceclawFramebufferControlSentCount += 1; } diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleCommunicatorListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleCommunicatorListener.java deleted file mode 100644 index 8a6ed3d0..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleCommunicatorListener.java +++ /dev/null @@ -1,15 +0,0 @@ -package com.faceclaw.app; - -public interface FaceclawBleCommunicatorListener { - void onLog(String line); - void onStateChange(String phase, String status); - void onRingEvent(String kind, String containerName, int eventType, int eventSource, int systemExitReasonCode, int frameId); - void onBatteryState(int headsetBattery, int headsetCharging, int ringBattery, int ringCharging); - void onSilentMode(boolean silent); - void onWearState(boolean wearing); - void onPhoneLockState(boolean locked); - void onEvenAppConflict(String message); - void onFrameMetrics(int paintMs, int transmitMs, int tileCount); - void onFrameFinished(int frameId, String outcome); - void onFirmwareInfo(String leftVersion, String rightVersion, String extension); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleListener.java deleted file mode 100644 index 2a64c2fd..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleListener.java +++ /dev/null @@ -1,6 +0,0 @@ -package com.faceclaw.app; - -public interface FaceclawBleListener { - void onNotification(String address, String characteristicUuid, byte[] data); - void onConnectionStateChange(String address, boolean connected); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleManager.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleManager.java index b8ecc1df..7531a50e 100644 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleManager.java +++ b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleManager.java @@ -268,7 +268,7 @@ public class FaceclawBleManager { return false; } - BluetoothGattDescriptor descriptor = characteristic.getDescriptor(BleProtocol.CCCD_UUID); + BluetoothGattDescriptor descriptor = characteristic.getDescriptor(java.util.UUID.fromString(BleProtocol.CCCD_UUID)); if (descriptor == null) { descriptorLatches.remove(address); return true; diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawCaptionEngineListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawCaptionEngineListener.java deleted file mode 100644 index 24b58a85..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawCaptionEngineListener.java +++ /dev/null @@ -1,17 +0,0 @@ -package com.faceclaw.app; - -public interface FaceclawCaptionEngineListener { - /** - * One finished utterance. text may be empty when no ASR model is loaded - * or recognition produced nothing; embedding is the L2-normalized - * voice-print or null when the speaker model is unavailable or the - * utterance was too short. startMs/endMs are on the engine's sample - * clock (milliseconds of audio since start()). - */ - void onUtterance(String text, float[] embedding, long startMs, long endMs, double peakRms); - - /** A speech onset was detected; the utterance is now being collected. */ - void onSpeechStart(long startMs); - - void onStatus(String status); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawCompassListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawCompassListener.java deleted file mode 100644 index 1d6bb06e..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawCompassListener.java +++ /dev/null @@ -1,7 +0,0 @@ -package com.faceclaw.app; - -/** Receives stock compass heading and calibration notifications on the thread that subscribed. */ -public interface FaceclawCompassListener { - void onCompassEvent(int command, int headingDegrees, int magneticAccuracy, int magneticAnomalies, - int orientationSource, int diagnosticFlags, long sampleTimeMs); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawDeviceDiscoveryListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawDeviceDiscoveryListener.java deleted file mode 100644 index 922e7adb..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawDeviceDiscoveryListener.java +++ /dev/null @@ -1,18 +0,0 @@ -package com.faceclaw.app; - -/** Callbacks from FaceclawDeviceDiscovery's live scan to the TypeScript layer. */ -public interface FaceclawDeviceDiscoveryListener { - /** - * One advertisement (or one bonded device) as a JSON object: - * {address, name, manufacturerData (hex, company id included), rssi|null, - * txPower|null, connectable|null, bonded, source, seenAtMs}. - * Protocol decoding happens in TypeScript (see app/g2/even-advertisement.ts). - */ - void onAdvertisement(String json); - - /** The platform refused to start or continue the scan. */ - void onScanFailed(int errorCode, String message); - - /** Diagnostic line for the pairing log. */ - void onLog(String line); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawDeviceInfoProbe.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawDeviceInfoProbe.java index c4ad3efe..7e7e5991 100644 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawDeviceInfoProbe.java +++ b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawDeviceInfoProbe.java @@ -362,7 +362,7 @@ public class FaceclawDeviceInfoProbe implements FaceclawBleListener { boolean written; try { written = bleManager.writeFrames( - address, BleProtocol.WRITE_CHAR_UUID, frames, ConnectionOptions.WRITE_TYPE, ConnectionOptions.WRITE_TIMEOUT_MS); + address, BleProtocol.WRITE_CHAR_UUID, frames, AndroidProtocolPlatform.writeType(ConnectionOptions.WRITE_MODE), ConnectionOptions.WRITE_TIMEOUT_MS); } catch (IllegalStateException e) { // "Not connected" — the link went away underneath us. written = false; @@ -475,7 +475,7 @@ public class FaceclawDeviceInfoProbe implements FaceclawBleListener { address, sid, flag, magic, seq, payload.length)); List frames = BleProtocol.framePb(payload, sid, flag, seq); boolean written = bleManager.writeFrames( - address, BleProtocol.WRITE_CHAR_UUID, frames, ConnectionOptions.WRITE_TYPE, ConnectionOptions.WRITE_TIMEOUT_MS); + address, BleProtocol.WRITE_CHAR_UUID, frames, AndroidProtocolPlatform.writeType(ConnectionOptions.WRITE_MODE), ConnectionOptions.WRITE_TIMEOUT_MS); if (!written) { emitLog("tx write FAILED sid=0x" + Integer.toHexString(sid)); synchronized (lock) { diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawEvenHubListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawEvenHubListener.java deleted file mode 100644 index 56ff2d61..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawEvenHubListener.java +++ /dev/null @@ -1,18 +0,0 @@ -package com.faceclaw.app; - -/** - * Callbacks from a hosted EvenHub app's WebView to the TypeScript host. - * All methods are delivered on the Android main thread (NativeScript's JS - * thread), regardless of which WebView-internal thread produced them. - */ -public interface FaceclawEvenHubListener { - /** - * The app invoked window.flutter_inappwebview.callHandler(handlerName, ...args). - * argsJson is the JSON-encoded argument array; callId identifies the - * promise to resolve via window.__fcResolve(callId, ok, value). - */ - void onEvenAppMessage(String handlerName, String argsJson, int callId); - - /** The WebView finished loading the app's page. */ - void onPageFinished(String url); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFirmwareFlasher.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFirmwareFlasher.java index 84d66a4f..3a941ac6 100644 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFirmwareFlasher.java +++ b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFirmwareFlasher.java @@ -301,7 +301,7 @@ public class FaceclawFirmwareFlasher implements FaceclawBleListener { private boolean writeOta(String address, String writeChar, int sid, byte[] payload, int seq) { List frames = BleProtocol.framePb(payload, sid, FLAG_OTA, seq); return bleManager.writeFrames( - address, writeChar, frames, ConnectionOptions.WRITE_TYPE, ConnectionOptions.WRITE_TIMEOUT_MS); + address, writeChar, frames, AndroidProtocolPlatform.writeType(ConnectionOptions.WRITE_MODE), ConnectionOptions.WRITE_TIMEOUT_MS); } private int waitAck(int wantOp, int timeoutMs) throws TimeoutException { diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFirmwareFlasherListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFirmwareFlasherListener.java deleted file mode 100644 index 2cd24e20..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFirmwareFlasherListener.java +++ /dev/null @@ -1,24 +0,0 @@ -package com.faceclaw.app; - -/** Callbacks from FaceclawFirmwareFlasher to the TypeScript layer. */ -public interface FaceclawFirmwareFlasherListener { - void onLog(String line); - - /** - * Fine-grained progress for the UI bar. `lens` is "left"/"right"; - * component/block indices are 1-based against their counts. `bytesSent` / - * `bytesTotal` cover the whole lens image, so a bar driven by them moves - * evenly even though the components differ wildly in size. - */ - void onProgress(String lens, int componentIndex, int componentCount, int blockIndex, int blockCount, - long bytesSent, long bytesTotal); - - /** - * Coarse lifecycle. `state` is one of: validating, connecting, flashing, - * rebooting, done, error. `detail` carries the lens name or a message. - */ - void onState(String state, String detail); - - /** Terminal callback: success or failure, with an explanatory message. */ - void onComplete(boolean success, String detail); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFirmwareUtil.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFirmwareUtil.java deleted file mode 100644 index 32ce5dc1..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFirmwareUtil.java +++ /dev/null @@ -1,57 +0,0 @@ -package com.faceclaw.app; - -import java.io.FileOutputStream; -import java.io.IOException; -import java.nio.ByteBuffer; -import java.nio.channels.FileChannel; -import java.security.MessageDigest; -import java.security.NoSuchAlgorithmException; - -/** - * Native helpers for the on-device custom-firmware build: SHA-256 hashing and - * binary file writing. Both take a java.nio.ByteBuffer so NativeScript can - * marshal a JS ArrayBuffer straight across without a per-element copy of the - * ~4 MB firmware image (and with no overload ambiguity). Also home of the one - * shared byte→hex encoder for com.faceclaw.app. - */ -public final class FaceclawFirmwareUtil { - private FaceclawFirmwareUtil() {} - - /** Lowercase hex of the bytes. The TS-side decoder is case-insensitive. */ - public static String bytesToHex(byte[] bytes) { - if (bytes == null || bytes.length == 0) { - return ""; - } - StringBuilder sb = new StringBuilder(bytes.length * 2); - for (byte b : bytes) { - int v = b & 0xff; - sb.append(Character.forDigit(v >>> 4, 16)); - sb.append(Character.forDigit(v & 0x0f, 16)); - } - return sb.toString(); - } - - /** Lowercase hex SHA-256 of the buffer's remaining bytes. */ - public static String sha256Hex(ByteBuffer data) { - try { - MessageDigest md = MessageDigest.getInstance("SHA-256"); - md.update(data.duplicate()); - return bytesToHex(md.digest()); - } catch (NoSuchAlgorithmException e) { - throw new RuntimeException("SHA-256 unavailable", e); - } - } - - /** Write the buffer's remaining bytes to `path`, overwriting any existing file. */ - public static void writeFile(String path, ByteBuffer data) { - try (FileOutputStream fos = new FileOutputStream(path); - FileChannel channel = fos.getChannel()) { - ByteBuffer view = data.duplicate(); - while (view.hasRemaining()) { - channel.write(view); - } - } catch (IOException e) { - throw new RuntimeException("firmware write failed: " + e.getMessage(), e); - } - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFlashPromptCommunicator.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFlashPromptCommunicator.java index 239e290f..ef342706 100644 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFlashPromptCommunicator.java +++ b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFlashPromptCommunicator.java @@ -362,7 +362,7 @@ public class FaceclawFlashPromptCommunicator implements FaceclawBleListener { address, BleProtocol.WRITE_CHAR_UUID, frames, - ConnectionOptions.WRITE_TYPE, + AndroidProtocolPlatform.writeType(ConnectionOptions.WRITE_MODE), ConnectionOptions.WRITE_TIMEOUT_MS); } diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFlashPromptListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFlashPromptListener.java deleted file mode 100644 index a7ac2da3..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawFlashPromptListener.java +++ /dev/null @@ -1,23 +0,0 @@ -package com.faceclaw.app; - -/** Callbacks from FaceclawFlashPromptCommunicator to the TypeScript layer. */ -public interface FaceclawFlashPromptListener { - void onLog(String line); - - /** - * Lifecycle updates. `state` is one of: connecting, connected, prompting, - * battery, result, cancelled, timeout, disconnected, error. `detail` carries the - * "approved"/"declined" text for result, or an error/explanation message. - */ - void onState(String state, String detail); - - /** - * Battery percent of each arm, read after the user approved (or right - * after auth when the prompt is skipped); -1 when an arm didn't answer. - * Always fires before onResult(true). - */ - void onBattery(int rightPercent, int leftPercent); - - /** Fires once the user picks a menu row (or, with skipPrompt, once the battery is read): true = flash, false = cancel. */ - void onResult(boolean approved); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawImuListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawImuListener.java deleted file mode 100644 index 2be8bb81..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawImuListener.java +++ /dev/null @@ -1,10 +0,0 @@ -package com.faceclaw.app; - -/** - * Receives IMU (accelerometer) readings decoded from the glasses' sys-event - * stream. Registered on FaceclawBleCommunicator via addImuListener; callbacks - * are delivered on the Android main thread. - */ -public interface FaceclawImuListener { - void onImuData(double x, double y, double z, int eventSource); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawLlamaListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawLlamaListener.java deleted file mode 100644 index f5419b84..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawLlamaListener.java +++ /dev/null @@ -1,16 +0,0 @@ -package com.faceclaw.app; - -/** - * Callbacks for one on-phone LLM generation. Like the other bridge listeners, - * implementations are typically created on the NativeScript JS thread and - * FaceclawLlamaRunner posts these callbacks back to that thread's Looper. - */ -public interface FaceclawLlamaListener { - /** A piece of generated text (may be a partial word). */ - void onToken(String piece); - - /** Generation finished: "stop" (EOG), "length", or "cancelled". */ - void onDone(String stopReason); - - void onError(String message); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawLocationListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawLocationListener.java deleted file mode 100644 index 84aead80..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawLocationListener.java +++ /dev/null @@ -1,8 +0,0 @@ -package com.faceclaw.app; - -/** One-shot Android location callbacks for the TypeScript Weather bridge. */ -public interface FaceclawLocationListener { - void onLocation(double latitude, double longitude, float accuracyMeters, long timestampMs); - - void onError(String message); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawLocationTrackerListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawLocationTrackerListener.java deleted file mode 100644 index ff0fd1aa..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawLocationTrackerListener.java +++ /dev/null @@ -1,13 +0,0 @@ -package com.faceclaw.app; - -/** Continuous location callbacks for the TypeScript navigation bridge. */ -public interface FaceclawLocationTrackerListener { - /** - * A new fix. bearingDeg/speedMps are -1 when the fix doesn't carry them - * (common when stationary); accuracyMeters is -1 when unknown. - */ - void onLocation(double latitude, double longitude, float accuracyMeters, - float bearingDeg, float speedMps, long timestampMs); - - void onError(String message); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawMediaBrowserListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawMediaBrowserListener.java deleted file mode 100644 index d25c6758..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawMediaBrowserListener.java +++ /dev/null @@ -1,10 +0,0 @@ -package com.faceclaw.app; - -public interface FaceclawMediaBrowserListener { - void onConnectResult(int requestId, boolean connected, String rootId, String error); - - void onBrowseResult(int requestId, String childrenJson, String error); - - /** The service connection dropped after connecting (player crashed or was killed). */ - void onDisconnected(); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawMediaControllerListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawMediaControllerListener.java deleted file mode 100644 index 75909f0e..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawMediaControllerListener.java +++ /dev/null @@ -1,23 +0,0 @@ -package com.faceclaw.app; - -public interface FaceclawMediaControllerListener { - /** All observed session owners, before filtering or choosing the active player. */ - void onSessionAppsChanged(String appsJson); - - void onStateChange( - String playbackState, - String packageName, - String appName, - String title, - String artist, - String album, - long positionMs, - long durationMs, - float playbackSpeed, - boolean canPlayPause, - boolean canSkipNext, - boolean canSkipPrevious, - boolean accessEnabled, - String status - ); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawMicStatusListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawMicStatusListener.java deleted file mode 100644 index e739ea34..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawMicStatusListener.java +++ /dev/null @@ -1,10 +0,0 @@ -package com.faceclaw.app; - -public interface FaceclawMicStatusListener { - /** - * A CFW mic_control field-104 status record from one temple. body is the - * raw 21-byte ['M','C',ver,...] record (decoded on the TS side); arm is - * "L" or "R" for the temple's own BLE link, "?" if unmatched. - */ - void onMicStatus(byte[] body, String arm); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawModelDownloaderListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawModelDownloaderListener.java deleted file mode 100644 index 90bf9380..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawModelDownloaderListener.java +++ /dev/null @@ -1,11 +0,0 @@ -package com.faceclaw.app; - -/** Progress callbacks for FaceclawModelDownloader, posted to the creating thread's Looper. */ -public interface FaceclawModelDownloaderListener { - void onProgress(long bytesDownloaded, long totalBytes); - - /** The file is fully downloaded, verified, and moved to its final path. */ - void onDone(String path); - - void onError(String message); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawNoiseSuppressor.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawNoiseSuppressor.java deleted file mode 100644 index 5d9514dc..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawNoiseSuppressor.java +++ /dev/null @@ -1,266 +0,0 @@ -package com.faceclaw.app; - -import android.media.audiofx.AcousticEchoCanceler; -import android.media.audiofx.AudioEffect; -import android.media.audiofx.AutomaticGainControl; -import android.media.audiofx.NoiseSuppressor; - -import java.util.ArrayList; -import java.util.Arrays; - -/** - * Phone-side noise suppression for the microphone stream. - * - * Android's built-in noise cancellation (the {@link NoiseSuppressor} capture - * effect) only attaches to AudioRecord sessions on the phone's own microphones. Faceclaw's audio - * arrives as raw PCM over BLE from the glasses, which that effect chain never - * sees, so this class picks the best engine that can actually reach the - * samples: - * - * - Audio captured by the phone itself: {@link #attachPlatformEffects(int)} - * enables the device's built-in NS/AEC/AGC chain (hardware or OEM software, - * whatever the Android build ships) on the AudioRecord session. - * - Audio from the glasses (the normal case): {@link #process(byte[])} runs a - * WebRTC-NS-family spectral suppressor here on the phone — 16 ms sqrt-Hann - * frames at 50% overlap, per-bin asymmetric noise-floor tracking, and an - * over-subtracted Wiener gain with a residual floor so speech never pumps - * in and out of silence. - */ -public final class FaceclawNoiseSuppressor { - - private static final int FFT_SIZE = 256; - private static final int HOP = FFT_SIZE / 2; - private static final float OVERSUBTRACTION = 1.6f; - /** About -16 dB of residual: keeps the noise bed natural instead of gated. */ - private static final float GAIN_FLOOR = 0.15f; - private static final float GAIN_SMOOTHING = 0.6f; - /** Frames of pure noise-floor learning after start/reset (~100 ms). */ - private static final int NOISE_WARMUP_FRAMES = 12; - - private final int sampleRate; - private final float[] window = new float[FFT_SIZE]; - private final float[] history = new float[FFT_SIZE]; - private final float[] overlap = new float[HOP]; - private final float[] noise = new float[FFT_SIZE / 2 + 1]; - private final float[] gain = new float[FFT_SIZE / 2 + 1]; - private final float[] re = new float[FFT_SIZE]; - private final float[] im = new float[FFT_SIZE]; - private final short[] pending = new short[HOP]; - private int pendingCount = 0; - private int warmupFrames = 0; - - public FaceclawNoiseSuppressor(int sampleRate) { - this.sampleRate = sampleRate; - // sqrt-Hann (sine) analysis+synthesis windows: exact COLA at 50% overlap. - for (int i = 0; i < FFT_SIZE; i++) { - window[i] = (float) Math.sin(Math.PI * (i + 0.5) / FFT_SIZE); - } - reset(); - } - - public int getSampleRate() { - return sampleRate; - } - - /** Forget the learned noise floor (e.g. after the suppressor was toggled off). */ - public void reset() { - Arrays.fill(history, 0f); - Arrays.fill(overlap, 0f); - Arrays.fill(noise, 0f); - Arrays.fill(gain, 1f); - pendingCount = 0; - warmupFrames = 0; - } - - /** - * Suppress noise in 16-bit little-endian mono PCM. Streaming: input not - * filling a whole 8 ms hop is carried into the next call, so the output - * may be up to one hop shorter than the input (and longer on a later - * call); total latency is one hop. - */ - public byte[] process(byte[] pcm16le) { - if (pcm16le == null || pcm16le.length < 2) { - return pcm16le; - } - int sampleCount = pcm16le.length / 2; - int hops = (pendingCount + sampleCount) / HOP; - byte[] out = new byte[hops * HOP * 2]; - int outPos = 0; - int inPos = 0; - while (inPos < sampleCount) { - int take = Math.min(HOP - pendingCount, sampleCount - inPos); - for (int i = 0; i < take; i++) { - int lo = pcm16le[(inPos + i) * 2] & 0xff; - int hi = pcm16le[(inPos + i) * 2 + 1]; - pending[pendingCount + i] = (short) ((hi << 8) | lo); - } - pendingCount += take; - inPos += take; - if (pendingCount == HOP) { - outPos = processHop(out, outPos); - pendingCount = 0; - } - } - return out; - } - - private int processHop(byte[] out, int outPos) { - System.arraycopy(history, HOP, history, 0, FFT_SIZE - HOP); - for (int i = 0; i < HOP; i++) { - history[FFT_SIZE - HOP + i] = pending[i] / 32768f; - } - for (int i = 0; i < FFT_SIZE; i++) { - re[i] = history[i] * window[i]; - im[i] = 0f; - } - fft(re, im, false); - - boolean warming = warmupFrames < NOISE_WARMUP_FRAMES; - if (warming) { - warmupFrames++; - } - for (int b = 0; b <= FFT_SIZE / 2; b++) { - float power = re[b] * re[b] + im[b] * im[b]; - if (warming) { - noise[b] = warmupFrames == 1 ? power : noise[b] + (power - noise[b]) / warmupFrames; - } else if (power < noise[b]) { - // Track the floor down quickly; drift up slowly so speech - // energy never gets learned as noise. - noise[b] += (power - noise[b]) * 0.2f; - } else { - noise[b] = Math.min(power, noise[b] * 1.006f + 1e-10f); - } - float clean = power - OVERSUBTRACTION * noise[b]; - float g = clean > 0f ? clean / power : 0f; - if (g < GAIN_FLOOR) { - g = GAIN_FLOOR; - } - g = GAIN_SMOOTHING * gain[b] + (1f - GAIN_SMOOTHING) * g; - gain[b] = g; - re[b] *= g; - im[b] *= g; - if (b > 0 && b < FFT_SIZE / 2) { - re[FFT_SIZE - b] *= g; - im[FFT_SIZE - b] *= g; - } - } - - fft(re, im, true); - for (int i = 0; i < HOP; i++) { - float value = (overlap[i] + re[i] * window[i]) * 32767f; - int sample = Math.round(value); - if (sample > 32767) { - sample = 32767; - } - if (sample < -32768) { - sample = -32768; - } - out[outPos + i * 2] = (byte) (sample & 0xff); - out[outPos + i * 2 + 1] = (byte) ((sample >> 8) & 0xff); - } - for (int i = 0; i < HOP; i++) { - overlap[i] = re[HOP + i] * window[HOP + i]; - } - return outPos + HOP * 2; - } - - /** In-place iterative radix-2 FFT (inverse includes the 1/N scale). */ - private static void fft(float[] re, float[] im, boolean inverse) { - int n = re.length; - for (int i = 1, j = 0; i < n; i++) { - int bit = n >> 1; - for (; (j & bit) != 0; bit >>= 1) { - j ^= bit; - } - j ^= bit; - if (i < j) { - float t = re[i]; - re[i] = re[j]; - re[j] = t; - t = im[i]; - im[i] = im[j]; - im[j] = t; - } - } - for (int len = 2; len <= n; len <<= 1) { - double ang = 2 * Math.PI / len * (inverse ? 1 : -1); - float wRe = (float) Math.cos(ang); - float wIm = (float) Math.sin(ang); - for (int i = 0; i < n; i += len) { - float curRe = 1f; - float curIm = 0f; - for (int k = 0; k < len / 2; k++) { - int a = i + k; - int b = a + len / 2; - float xr = re[b] * curRe - im[b] * curIm; - float xi = re[b] * curIm + im[b] * curRe; - re[b] = re[a] - xr; - im[b] = im[a] - xi; - re[a] += xr; - im[a] += xi; - float nextRe = curRe * wRe - curIm * wIm; - curIm = curRe * wIm + curIm * wRe; - curRe = nextRe; - } - } - } - if (inverse) { - for (int i = 0; i < n; i++) { - re[i] /= n; - im[i] /= n; - } - } - } - - /** Whether this Android build ships the built-in capture noise suppressor. */ - public static boolean platformSuppressorAvailable() { - try { - return NoiseSuppressor.isAvailable(); - } catch (Throwable t) { - return false; - } - } - - /** Short engine name for the UI. */ - public static String engineDescription() { - return "spectral (phone DSP)"; - } - - /** - * Attach the platform's built-in capture-effect chain (NoiseSuppressor, - * AcousticEchoCanceler, AutomaticGainControl — whichever this Android - * build provides) to a phone AudioRecord session. Only applicable when the - * phone itself captures the audio; the BLE glasses stream must go through - * {@link #process(byte[])} instead. The caller keeps the returned effects - * for the life of the recording and release()s them with it. - */ - public static AudioEffect[] attachPlatformEffects(int audioSessionId) { - ArrayList effects = new ArrayList<>(); - try { - if (NoiseSuppressor.isAvailable()) { - NoiseSuppressor ns = NoiseSuppressor.create(audioSessionId); - if (ns != null) { - ns.setEnabled(true); - effects.add(ns); - } - } - if (AcousticEchoCanceler.isAvailable()) { - AcousticEchoCanceler aec = AcousticEchoCanceler.create(audioSessionId); - if (aec != null) { - aec.setEnabled(true); - effects.add(aec); - } - } - if (AutomaticGainControl.isAvailable()) { - AutomaticGainControl agc = AutomaticGainControl.create(audioSessionId); - if (agc != null) { - agc.setEnabled(true); - effects.add(agc); - } - } - } catch (Throwable t) { - // A missing effect just means this tier is unavailable. - } - return effects.toArray(new AudioEffect[0]); - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawNotificationListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawNotificationListener.java deleted file mode 100644 index 5dd6687a..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawNotificationListener.java +++ /dev/null @@ -1,5 +0,0 @@ -package com.faceclaw.app; - -public interface FaceclawNotificationListener { - void onNotificationPosted(String key); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawPreviewCompositor.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawPreviewCompositor.java index e0aaae58..b95f9061 100644 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawPreviewCompositor.java +++ b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawPreviewCompositor.java @@ -105,7 +105,8 @@ public final class FaceclawPreviewCompositor { java.nio.ByteBuffer glyphs ) { compositor.applyAndComposite( - surfaceId, pixels8bpp, rectX, rectY, rectWidth, rectHeight, contentFingerprint, glyphs); + surfaceId, new AndroidByteReader(pixels8bpp), rectX, rectY, rectWidth, rectHeight, contentFingerprint, + glyphs == null ? null : new AndroidByteReader(glyphs)); FrameTimings.getInstance().finishFrame(frameId, "composited (preview-only, no glasses)"); Runnable listener = frameListener; if (listener != null) { diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawQrScannerListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawQrScannerListener.java deleted file mode 100644 index b255991e..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawQrScannerListener.java +++ /dev/null @@ -1,10 +0,0 @@ -package com.faceclaw.app; - -/** Callbacks for one FaceclawQrScanner.scan; exactly one method fires. */ -public interface FaceclawQrScannerListener { - void onResult(String text); - - void onCancelled(); - - void onError(String message); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawRingEventDecoder.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawRingEventDecoder.java deleted file mode 100644 index 9cdc44f0..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawRingEventDecoder.java +++ /dev/null @@ -1,126 +0,0 @@ -package com.faceclaw.app; - -import java.util.Locale; - -final class FaceclawRingEventDecoder { - private FaceclawRingEventDecoder() { - } - - static DirectRingEvent decode(byte[] raw) { - if (raw == null || raw.length == 0) { - return null; - } - - DirectRingEvent chargerGesture = decodeChargerGesture(raw); - if (chargerGesture != null) { - return chargerGesture; - } - - return decodeDirectGesture(raw); - } - - private static DirectRingEvent decodeChargerGesture(byte[] raw) { - if (raw.length != 11) { - return null; - } - if (u8(raw[0]) != 0x00 || u8(raw[1]) != 0x09 || u8(raw[2]) != 0x61 || u8(raw[3]) != 0x00) { - return null; - } - - int code = u8(raw[4]); - int param = u8(raw[5]) | (u8(raw[6]) << 8); - long tick = (u8(raw[7]) | (u8(raw[8]) << 8) | (u8(raw[9]) << 16) | (u8(raw[10]) << 24)) & 0xffffffffL; - String detail = String.format(Locale.US, "code=0x%02x(%s) param=0x%04x tick=%d", code, chargerCodeName(code), param, tick); - - switch (code) { - case 0x00: - return event(BleProtocol.EVENT_RING_LONG_PRESS, "LONG_PRESS", detail); - case 0x01: - return event(BleProtocol.EVENT_CLICK, "TAP", detail); - case 0x02: - return event(BleProtocol.EVENT_DOUBLE_CLICK, "DOUBLE_TAP", detail); - case 0x04: - return event(BleProtocol.EVENT_SCROLL_TOP, "SWIPE_UP", detail); - case 0x05: - return event(BleProtocol.EVENT_SCROLL_BOTTOM, "SWIPE_DOWN", detail); - case 0x08: - return event(BleProtocol.EVENT_RING_LONG_PRESS_RELEASE, "LONG_PRESS_RELEASE", detail); - default: - return null; - } - } - - private static DirectRingEvent decodeDirectGesture(byte[] raw) { - if (raw.length != 3 || u8(raw[0]) != 0xff) { - return null; - } - - int type = u8(raw[1]); - int param = u8(raw[2]); - String detail = String.format(Locale.US, "type=0x%02x param=0x%02x", type, param); - - if (type == 0x03 && param == 0x20) { - return event(BleProtocol.EVENT_RING_LONG_PRESS, "HOLD", detail); - } - if (type == 0x04 && param == 0x01) { - return event(BleProtocol.EVENT_CLICK, "TAP_SINGLE", detail); - } - if (type == 0x04 && param == 0x02) { - return event(BleProtocol.EVENT_DOUBLE_CLICK, "TAP_DOUBLE", detail); - } - if (type == 0x05) { - if (param <= 0x01) { - return event(BleProtocol.EVENT_SCROLL_BOTTOM, "SWIPE_FORWARD", detail); - } - return event(BleProtocol.EVENT_SCROLL_TOP, "SWIPE_BACKWARD", detail); - } - - return null; - } - - private static DirectRingEvent event(int eventType, String label, String detail) { - G2Event event = new G2Event( - "sys-event", - "", - eventType, - BleProtocol.EVENT_SOURCE_RING, - 0 - ); - return new DirectRingEvent(event, label, detail); - } - - private static String chargerCodeName(int code) { - switch (code) { - case 0x00: - return "LONG_PRESS"; - case 0x01: - return "TAP"; - case 0x02: - return "DOUBLE_TAP"; - case 0x04: - return "SWIPE_UP"; - case 0x05: - return "SWIPE_DOWN"; - case 0x08: - return "LONG_PRESS_RELEASE"; - default: - return "unknown"; - } - } - - private static int u8(byte value) { - return value & 0xff; - } - - static final class DirectRingEvent { - final G2Event event; - final String label; - final String detail; - - DirectRingEvent(G2Event event, String label, String detail) { - this.event = event; - this.label = label; - this.detail = detail; - } - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawSettingsListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawSettingsListener.java deleted file mode 100644 index a34bd7ab..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawSettingsListener.java +++ /dev/null @@ -1,6 +0,0 @@ -package com.faceclaw.app; - -/** Change-notification callback for FaceclawSettings; implemented in JS. */ -public interface FaceclawSettingsListener { - void onSettingChanged(String key); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawVoiceControllerListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawVoiceControllerListener.java deleted file mode 100644 index 95c5826f..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawVoiceControllerListener.java +++ /dev/null @@ -1,47 +0,0 @@ -package com.faceclaw.app; - -public interface FaceclawVoiceControllerListener { - void onStatus(String status); - - /** - * Best transcript of the current utterance so far. REPLACE semantics: text - * is the complete transcript, not a delta — display it verbatim, replacing - * any previous partial. isFinal marks the end of the utterance. - */ - void onTranscript(String text, boolean isFinal); - - /** Capture has finished, after the final transcript or a startup/recognition error. */ - void onStopped(int captureId); - - /** - * Decoded microphone audio: 16 kHz mono signed 16-bit little-endian PCM. - * Emitted in every mode so raw-PCM consumers (levels, recording, captions) - * keep working while the onboard recognizer owns the transcript. - */ - void onPcm(byte[] pcm16le); - - /** - * Per-packet DSP metadata the glasses firmware appends to each 50 ms audio - * packet, computed on the raw stereo capture before its mono downmix: the - * direction-of-arrival in signed degrees (0 = straight ahead, positive to - * the wearer's right) and a signal-strength ratio that serves as a - * confidence/energy proxy for the angle. - */ - void onFrameMeta(int angleDegrees, int ssr); - - /** - * The speaker stopped, in a hands-free session that has no button release - * to end it. Only fires when endpointing was enabled for the session; see - * FaceclawVoiceController.setEndpointing. - */ - void onSpeechEnd(); - - /** - * Result of speaker verification against the enrolled wearer voice-print, - * emitted once per capture session just before the final transcript. - * Only fires when verification was configured for the session; fails - * open (isWearer=true) when the utterance was too short to verify or the - * speaker model could not be loaded. - */ - void onSpeakerVerified(boolean isWearer, float similarity); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawWavRecorder.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawWavRecorder.java deleted file mode 100644 index ed08d388..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawWavRecorder.java +++ /dev/null @@ -1,100 +0,0 @@ -package com.faceclaw.app; - -import android.util.Log; - -import java.io.File; -import java.io.IOException; -import java.io.RandomAccessFile; -import java.nio.ByteBuffer; -import java.nio.ByteOrder; -import java.nio.charset.StandardCharsets; - -/** - * Streaming WAV writer for conversation recordings: the header is written up - * front with zero sizes and patched on finish, so a crash mid-session leaves - * a recoverable file (data length can be derived from the file size). - */ -public class FaceclawWavRecorder { - private static final String TAG = "FaceclawWavRecorder"; - - private final String path; - private final int sampleRate; - private final int channels; - private RandomAccessFile file; - private long dataBytes; - - public FaceclawWavRecorder(String path, int sampleRate, int channels) throws IOException { - this.path = path; - this.sampleRate = sampleRate; - this.channels = channels; - File parent = new File(path).getParentFile(); - if (parent != null && !parent.exists() && !parent.mkdirs()) { - throw new IOException("could not create " + parent); - } - file = new RandomAccessFile(path, "rw"); - file.setLength(0); - file.write(buildHeader(0)); - } - - public synchronized void append(byte[] pcm16le) { - if (file == null || pcm16le == null || pcm16le.length == 0) { - return; - } - try { - file.write(pcm16le); - dataBytes += pcm16le.length; - } catch (IOException e) { - Log.w(TAG, "append failed", e); - } - } - - public synchronized long getDurationMs() { - return dataBytes * 1000L / (sampleRate * channels * 2L); - } - - public String getPath() { - return path; - } - - /** Patch the header and close. Returns the PCM byte count (0 = empty). */ - public synchronized long finish() { - RandomAccessFile current = file; - file = null; - if (current == null) { - return dataBytes; - } - try { - current.seek(0); - current.write(buildHeader((int) Math.min(dataBytes, Integer.MAX_VALUE))); - current.close(); - } catch (IOException e) { - Log.w(TAG, "finish failed", e); - } - return dataBytes; - } - - /** Delete the (finished or abandoned) recording. */ - public synchronized void discard() { - finish(); - new File(path).delete(); - } - - private byte[] buildHeader(int pcmBytes) { - int byteRate = sampleRate * channels * 2; - ByteBuffer b = ByteBuffer.allocate(44).order(ByteOrder.LITTLE_ENDIAN); - b.put("RIFF".getBytes(StandardCharsets.US_ASCII)); - b.putInt(36 + pcmBytes); - b.put("WAVE".getBytes(StandardCharsets.US_ASCII)); - b.put("fmt ".getBytes(StandardCharsets.US_ASCII)); - b.putInt(16); - b.putShort((short) 1); - b.putShort((short) channels); - b.putInt(sampleRate); - b.putInt(byteRate); - b.putShort((short) (channels * 2)); - b.putShort((short) 16); - b.put("data".getBytes(StandardCharsets.US_ASCII)); - b.putInt(pcmBytes); - return b.array(); - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawWearListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawWearListener.java deleted file mode 100644 index 590c87d6..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawWearListener.java +++ /dev/null @@ -1,19 +0,0 @@ -package com.faceclaw.app; - -/** - * Callbacks from the Android Wear (Wear OS) bridge; implemented in JS. Every - * call is delivered on the thread that registered the listener (see - * FaceclawWearBridge.setListener). - */ -public interface FaceclawWearListener { - /** - * A message from the watch app. `path` is the Data Layer message path - * (e.g. "/faceclaw/input"); `json` is the UTF-8 payload (always a JSON - * object, "{}" when the watch sent none); `nodeId` identifies the watch - * so a reply can be addressed to it. - */ - void onMessage(String path, String json, String nodeId); - - /** The set of reachable watches running the Faceclaw watch app changed. */ - void onWatchConnection(boolean reachable, String watchName); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawWebSocketListener.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawWebSocketListener.java deleted file mode 100644 index f8e8733f..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawWebSocketListener.java +++ /dev/null @@ -1,9 +0,0 @@ -package com.faceclaw.app; - -/** Callbacks for FaceclawWebSocket, delivered on the Android main thread. */ -public interface FaceclawWebSocketListener { - void onOpen(); - void onTextMessage(String message); - void onClosed(int code, String reason); - void onFailure(String message); -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FwGlyphAtlas.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FwGlyphAtlas.java deleted file mode 100644 index c6535c0c..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FwGlyphAtlas.java +++ /dev/null @@ -1,83 +0,0 @@ -package com.faceclaw.app; - -import java.nio.ByteBuffer; -import java.nio.ByteOrder; -import java.util.HashMap; -import java.util.Map; - -/** - * Process-wide registry of the glasses' builtin 20 px font's glyph rasters, - * fed from the TS side (EvenHubFont's extracted firmware font data). Unlike - * GlyphAtlas/ImageAtlas entries, these are never uploaded: the firmware - * already owns the font, and mode 15 draws it directly. The planner needs - * the rasters purely phone-side — for the "would this draw land correctly" - * check against the composite and for punching drawn ink out of delta rects. - * - * Placement model matches the firmware's mode-15 math: a glyph draws at - * (penX + ofsX, lineY + inkTop) where inkTop already folds in the root - * font's line height and baseline. The TS side only registers glyphs whose - * on-glasses rendering it predicts exactly (native-table glyphs; baseline- - * shifted fallback symbols stay baked). - */ -public final class FwGlyphAtlas { - private FwGlyphAtlas() {} - - public static final class Entry { - /** Draw x = pen x + ofsX. */ - public final int ofsX; - /** First raster row relative to the run's line-top y. */ - public final int inkTop; - public final int boxW; - public final int boxH; - /** 4bpp rows, stride ceil(boxW/2), high nibble = left pixel. */ - final byte[] nibbles; - - Entry(int ofsX, int inkTop, int boxW, int boxH, byte[] nibbles) { - this.ofsX = ofsX; - this.inkTop = inkTop; - this.boxW = boxW; - this.boxH = boxH; - this.nibbles = nibbles; - } - - /** The 4bpp source value at (col, row); the draw skips 0 (transparent). */ - public int nibbleAt(int col, int row) { - int b = nibbles[row * ((boxW + 1) >> 1) + (col >> 1)] & 0xff; - return (col & 1) != 0 ? (b & 0x0f) : (b >> 4); - } - } - - private static final Object lock = new Object(); - private static final Map entries = new HashMap<>(); - - /** - * Register glyph rasters. Little-endian buffer of records: - * [cp u32][ofsX s16][inkTop s16][boxW u8][boxH u8] - * [boxH x ceil(boxW/2) nibble bytes] - * Re-registration of a codepoint is ignored (the builtin font is fixed). - */ - public static void register(ByteBuffer buffer) { - if (buffer == null) return; - ByteBuffer in = buffer.order(ByteOrder.LITTLE_ENDIAN); - synchronized (lock) { - while (in.remaining() >= 10) { - int cp = in.getInt(); - int ofsX = in.getShort(); - int inkTop = in.getShort(); - int boxW = in.get() & 0xff; - int boxH = in.get() & 0xff; - byte[] nibbles = new byte[((boxW + 1) >> 1) * boxH]; - in.get(nibbles); - if (boxW > 0 && boxH > 0 && !entries.containsKey(cp)) { - entries.put(cp, new Entry(ofsX, inkTop, boxW, boxH, nibbles)); - } - } - } - } - - public static Entry get(int cp) { - synchronized (lock) { - return entries.get(cp); - } - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/GifScreenRecorder.java b/App_Resources/Android/src/main/java/com/faceclaw/app/GifScreenRecorder.java index cfba7631..1346b07e 100644 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/GifScreenRecorder.java +++ b/App_Resources/Android/src/main/java/com/faceclaw/app/GifScreenRecorder.java @@ -1,273 +1,26 @@ package com.faceclaw.app; import android.content.Context; - -import java.io.BufferedOutputStream; -import java.io.ByteArrayOutputStream; import java.io.File; import java.io.FileOutputStream; import java.io.IOException; -import java.io.OutputStream; -import java.util.ArrayList; -import java.util.Arrays; -import java.util.HashMap; -import java.util.List; -import java.util.zip.DataFormatException; -import java.util.zip.Inflater; -/** - * Accumulates composited screen frames and saves them as a looping animated - * GIF with a 16-entry grayscale palette. Stored frames are deflate-compressed - * (a typical UI frame shrinks from 166KB of indices to a few KB) so long - * recordings stay affordable in memory; consecutive identical frames are - * deduplicated, with the elapsed time folded into the next frame's delay. - */ +/** Android storage adapter for the shared GIF recorder. */ public final class GifScreenRecorder { - /** Backstop against unbounded growth if a recording is left running. */ - private static final int MAX_FRAMES = 3600; - /** Displayed duration of the final frame, which has no successor. */ - private static final int LAST_FRAME_DELAY_CS = 100; - /** Below this, GIF renderers historically clamp or ignore the delay. */ - private static final int MIN_FRAME_DELAY_CS = 2; + private final SharedGifScreenRecorder recorder = new SharedGifScreenRecorder(); - private static final class Frame { - final byte[] deflatedIndices; - final long timestampMs; - - Frame(byte[] deflatedIndices, long timestampMs) { - this.deflatedIndices = deflatedIndices; - this.timestampMs = timestampMs; - } + public void addFrame(byte[] gray, int width, int height, long timestampMs) { + recorder.addFrame(gray, width, height, timestampMs); } - private final List frames = new ArrayList<>(); - /** Undeflated copy of the newest frame, kept for duplicate detection. */ - private byte[] lastIndices; - private int width; - private int height; - private boolean overflowed; + public boolean isOverflowed() { return recorder.isOverflowed(); } - /** - * Append the current screen. gray is 8bpp; only the top nibble (the - * display's native depth, and the palette index) is kept. - */ - public synchronized void addFrame(byte[] gray, int width, int height, long timestampMs) { - if (gray == null || width <= 0 || height <= 0 || gray.length < width * height) { - return; - } - if (frames.isEmpty()) { - this.width = width; - this.height = height; - } else if (width != this.width || height != this.height) { - return; - } - byte[] indices = new byte[width * height]; - for (int i = 0; i < indices.length; i++) { - indices[i] = (byte) ((gray[i] & 0xff) >>> 4); - } - if (lastIndices != null && Arrays.equals(indices, lastIndices)) { - return; - } - if (frames.size() >= MAX_FRAMES) { - overflowed = true; - return; - } - frames.add(new Frame(ScreenshotUtil.zlibDeflate(indices), timestampMs)); - lastIndices = indices; - } - - /** True if frames were dropped because the recording hit MAX_FRAMES. */ - public synchronized boolean isOverflowed() { - return overflowed; - } - - /** - * Encode the recording as an animated GIF in the screenshots directory. - * Returns the absolute path, or "" if no frames were captured. - */ - public synchronized String save(Context context) throws IOException { - if (frames.isEmpty()) { - return ""; - } - File file = new File(ScreenshotUtil.ensureScreenshotsDir(context), "recording-" + ScreenshotUtil.timestamp() + ".gif"); - try (OutputStream out = new BufferedOutputStream(new FileOutputStream(file))) { - writeGif(out); - } + public String save(Context context) throws IOException { + byte[] gif = recorder.encode(); + if (gif.length == 0) return ""; + File file = new File(ScreenshotUtil.ensureScreenshotsDir(context), + "recording-" + ScreenshotUtil.timestamp() + ".gif"); + try (FileOutputStream out = new FileOutputStream(file)) { out.write(gif); } return file.getAbsolutePath(); } - - private void writeGif(OutputStream out) throws IOException { - out.write('G'); - out.write('I'); - out.write('F'); - out.write('8'); - out.write('9'); - out.write('a'); - // Logical screen descriptor: global color table present, 8 bits of - // color resolution, 2^(3+1)=16 palette entries. - writeShortLE(out, width); - writeShortLE(out, height); - out.write(0x80 | 0x70 | 0x03); - out.write(0); // background color index - out.write(0); // pixel aspect ratio - for (int i = 0; i < 16; i++) { - int v = i * 17; - out.write(v); - out.write(v); - out.write(v); - } - // Netscape application extension: loop forever. - out.write(0x21); - out.write(0xff); - out.write(11); - out.write("NETSCAPE2.0".getBytes("US-ASCII")); - out.write(3); - out.write(1); - writeShortLE(out, 0); - out.write(0); - - for (int i = 0; i < frames.size(); i++) { - Frame frame = frames.get(i); - // Each frame displays until the next one was captured; the last - // frame has no successor, so give it a nominal one-second hold. - int delayCs = LAST_FRAME_DELAY_CS; - if (i + 1 < frames.size()) { - long deltaMs = frames.get(i + 1).timestampMs - frame.timestampMs; - delayCs = (int) Math.max(MIN_FRAME_DELAY_CS, Math.min(0xffff, Math.round(deltaMs / 10.0))); - } - // Graphic control extension: no disposal, no transparency. - out.write(0x21); - out.write(0xf9); - out.write(4); - out.write(0x04); // disposal method 1 (do not dispose) - writeShortLE(out, delayCs); - out.write(0); // transparent color index (unused) - out.write(0); - // Image descriptor: full frame, no local color table. - out.write(0x2c); - writeShortLE(out, 0); - writeShortLE(out, 0); - writeShortLE(out, width); - writeShortLE(out, height); - out.write(0); - writeLzwImageData(out, inflate(frame.deflatedIndices, width * height)); - } - out.write(0x3b); // trailer - } - - private static byte[] inflate(byte[] deflated, int size) throws IOException { - Inflater inflater = new Inflater(); - inflater.setInput(deflated); - byte[] data = new byte[size]; - try { - int offset = 0; - while (offset < size && !inflater.finished()) { - int n = inflater.inflate(data, offset, size - offset); - if (n == 0) break; - offset += n; - } - if (offset != size) { - throw new IOException("recorded frame truncated: " + offset + " of " + size); - } - } catch (DataFormatException e) { - throw new IOException("recorded frame corrupt", e); - } finally { - inflater.end(); - } - return data; - } - - /** GIF LZW compression of a 4-bit index stream (minimum code size 4). */ - private static void writeLzwImageData(OutputStream out, byte[] indices) throws IOException { - final int minCodeSize = 4; - out.write(minCodeSize); - SubBlockBitWriter writer = new SubBlockBitWriter(out); - final int clearCode = 1 << minCodeSize; - final int eoiCode = clearCode + 1; - int codeSize = minCodeSize + 1; - int nextCode = eoiCode + 1; - HashMap table = new HashMap<>(); - writer.writeCode(clearCode, codeSize); - int prefix = indices[0] & 0xff; - for (int i = 1; i < indices.length; i++) { - int k = indices[i] & 0xff; - int key = (prefix << 8) | k; - Integer code = table.get(key); - if (code != null) { - prefix = code; - continue; - } - writer.writeCode(prefix, codeSize); - if (nextCode == 0x1000) { - writer.writeCode(clearCode, codeSize); - table.clear(); - codeSize = minCodeSize + 1; - nextCode = eoiCode + 1; - } else { - if (nextCode >= (1 << codeSize)) { - codeSize++; - } - table.put(key, nextCode++); - } - prefix = k; - } - writer.writeCode(prefix, codeSize); - writer.writeCode(eoiCode, codeSize); - writer.finish(); - } - - /** - * Packs LZW codes LSB-first into bytes and the bytes into the 255-byte - * data sub-blocks GIF image data is carried in. - */ - private static final class SubBlockBitWriter { - private final OutputStream out; - private final byte[] block = new byte[255]; - private int blockLength; - private int bitBuffer; - private int bitCount; - - SubBlockBitWriter(OutputStream out) { - this.out = out; - } - - void writeCode(int code, int codeSize) throws IOException { - bitBuffer |= code << bitCount; - bitCount += codeSize; - while (bitCount >= 8) { - writeByte(bitBuffer & 0xff); - bitBuffer >>>= 8; - bitCount -= 8; - } - } - - void finish() throws IOException { - if (bitCount > 0) { - writeByte(bitBuffer & 0xff); - bitBuffer = 0; - bitCount = 0; - } - flushBlock(); - out.write(0); // block terminator - } - - private void writeByte(int b) throws IOException { - block[blockLength++] = (byte) b; - if (blockLength == 255) { - flushBlock(); - } - } - - private void flushBlock() throws IOException { - if (blockLength == 0) return; - out.write(blockLength); - out.write(block, 0, blockLength); - blockLength = 0; - } - } - - private static void writeShortLE(OutputStream out, int value) throws IOException { - out.write(value & 0xff); - out.write((value >>> 8) & 0xff); - } } diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/GlyphAtlas.java b/App_Resources/Android/src/main/java/com/faceclaw/app/GlyphAtlas.java deleted file mode 100644 index c075c230..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/GlyphAtlas.java +++ /dev/null @@ -1,267 +0,0 @@ -package com.faceclaw.app; - -import java.nio.ByteBuffer; -import java.nio.ByteOrder; -import java.nio.charset.StandardCharsets; -import java.util.HashMap; -import java.util.Map; - -/** - * Process-wide registry of glyph rasters, fed from the TS side so glyph - * identity survives to the BLE encoder (see notes/texture-cache-display-list- - * design.md). A frame's glyph list references entries here by (fontId, - * encoding); the texture-cache planner uses the raster three ways: - * - * - as the ink mask for the "would this draw land correctly" check against - * the composited frame, - * - to punch the ink pixels out of the baked delta rect it replaces, - * - pre-encoded as the CFW cached-image bytes ([w][h][4bpp RLE]) uploaded - * via mode 12 and drawn via mode 14 with a top-color LUT. 1bpp (BDF) - * glyphs store ink at 15 so the LUT maps them to exactly the requested - * level; AA (TTF) glyphs store true coverage nibbles the LUT scales. - * - * Fonts are identified by a stable string key (the embedded font name), NOT a - * per-JS-context counter: worker threads register independently and must agree - * on ids. Glyph rasters are immutable once registered; re-registration of the - * same (fontId, encoding) is ignored. - * - * Cell model: a cached glyph image is bbxWidth x cellHeight (the font's line - * height), with the ink rows at inkTop — so every glyph of a line is drawn at - * the same y (the line top), which is what lets one mode-14 string carry a - * whole run. The horizontal bearing (bbxX) is applied phone-side when - * computing the draw x. Vertical padding is nearly free: it RLE-encodes to a - * couple of tokens. - */ -public final class GlyphAtlas { - private GlyphAtlas() {} - - public static final class Glyph { - /** Cached image width in pixels (the glyph's tight bbox width). */ - public final int width; - /** Cached image height in pixels (the font's line height). */ - public final int cellHeight; - /** First row of ink within the cell. */ - public final int inkTop; - /** Number of ink rows. */ - public final int inkHeight; - /** Horizontal bearing: draw x = pen x + bbxX. */ - public final int bbxX; - /** 1bpp ink rows (inkHeight entries), bit (rowBitWidth-1-col) = ink; null for AA glyphs. */ - final int[] rows; - final int rowBitWidth; - /** AA coverage, width*inkHeight nibble values 0..15; null for 1bpp glyphs. */ - final byte[] coverage; - /** CFW cached-image bytes: [w][cellHeight][RLE(w*cellHeight px)]. */ - public final byte[] cachedBytes; - - Glyph(int width, int cellHeight, int inkTop, int inkHeight, int bbxX, - int[] rows, byte[] coverage) { - this.width = width; - this.cellHeight = cellHeight; - this.inkTop = inkTop; - this.inkHeight = inkHeight; - this.bbxX = bbxX; - this.rows = rows; - this.coverage = coverage; - this.rowBitWidth = ((width + 7) >> 3) << 3; - this.cachedBytes = encodeCachedImage(); - } - - /** - * The cell pixel's 4bpp source value at (col, row), row cell-relative. - * 1bpp glyphs are stored at 15 so the draw-time LUT (source*top/15) - * maps them to exactly the requested top color; AA glyphs carry their - * true coverage level. - */ - public int nibbleAt(int col, int row) { - if (col < 0 || col >= width) return 0; - int inkRow = row - inkTop; - if (inkRow < 0 || inkRow >= inkHeight) return 0; - if (coverage != null) return coverage[inkRow * width + col]; - return ((rows[inkRow] >>> (rowBitWidth - 1 - col)) & 1) != 0 ? 15 : 0; - } - - /** Whether the cell pixel at (col, row) has any ink (row is cell-relative). */ - public boolean inkAt(int col, int row) { - return nibbleAt(col, row) != 0; - } - - /** - * The firmware cached-image encoding: [width][height][RLE tokens] - * covering exactly width*cellHeight pixels (no row padding), each - * pixel's stored color being its nibbleAt value. - */ - private byte[] encodeCachedImage() { - int total = width * cellHeight; - // Worst case one token per pixel (1 byte each) + 2 header bytes. - byte[] out = new byte[2 + total]; - out[0] = (byte) width; - out[1] = (byte) cellHeight; - int o = 2; - int i = 0; - while (i < total) { - int color = nibbleAt(i % width, i / width); - int j = i + 1; - while (j < total && nibbleAt(j % width, j / width) == color) j++; - int run = j - i; - while (run > 0) { - int c = Math.min(run, 0xffff); - if (c <= 15) { - out[o++] = (byte) ((c << 4) | color); - } else if (c <= 255) { - // Worst case can exceed the sizing above only via escape - // forms, which occur for runs >= 16 (net win); safe. - out[o++] = (byte) color; - out[o++] = (byte) c; - } else { - out[o++] = (byte) color; - out[o++] = 0; - out[o++] = (byte) (c & 0xff); - out[o++] = (byte) (c >> 8); - } - run -= c; - } - i = j; - } - byte[] trimmed = new byte[o]; - System.arraycopy(out, 0, trimmed, 0, o); - return trimmed; - } - } - - private static final Object lock = new Object(); - private static final Map fontIds = new HashMap<>(); - private static final Map glyphs = new HashMap<>(); - private static int nextFontId = 1; - - /** Stable id for a font key; assigns one on first use. */ - public static int fontId(String key) { - synchronized (lock) { - Integer id = fontIds.get(key); - if (id == null) { - id = nextFontId++; - fontIds.put(key, id); - } - return id; - } - } - - public static Glyph get(int fontId, int encoding) { - synchronized (lock) { - return glyphs.get(key(fontId, encoding)); - } - } - - private static long key(int fontId, int encoding) { - return ((long) fontId << 32) | (encoding & 0xffffffffL); - } - - /** - * Register a batch of glyph rasters. Little-endian buffer, a sequence of - * font groups: - * [keyLen u8][key utf8][cellHeight u8][count u16] - * each followed by count glyph records: - * [encoding u32][bbxX s8][inkTop u8][width u8][inkHeight u8] - * [inkHeight x rows u32] (bit (ceil(width/8)*8 - 1 - col) = ink) - * Records for an already-registered (font, encoding) are skipped (glyph - * rasters are immutable for a given font key). Malformed buffers throw: - * they indicate a phone-side marshalling bug, never device state. - */ - public static void register(ByteBuffer buffer) { - if (buffer == null) return; - ByteBuffer in = buffer.order(ByteOrder.LITTLE_ENDIAN); - synchronized (lock) { - while (in.remaining() > 0) { - int keyLen = in.get() & 0xff; - byte[] keyBytes = new byte[keyLen]; - in.get(keyBytes); - String fontKey = new String(keyBytes, StandardCharsets.UTF_8); - int cellHeight = in.get() & 0xff; - int count = in.getShort() & 0xffff; - Integer idBoxed = fontIds.get(fontKey); - int id; - if (idBoxed == null) { - id = nextFontId++; - fontIds.put(fontKey, id); - } else { - id = idBoxed; - } - for (int g = 0; g < count; g++) { - int encoding = in.getInt(); - int bbxX = in.get(); - int inkTop = in.get() & 0xff; - int width = in.get() & 0xff; - int inkHeight = in.get() & 0xff; - int[] rows = new int[inkHeight]; - for (int r = 0; r < inkHeight; r++) { - rows[r] = in.getInt(); - } - long k = key(id, encoding); - if (!glyphs.containsKey(k) && width > 0 && cellHeight > 0 - && inkTop + inkHeight <= cellHeight) { - glyphs.put(k, new Glyph(width, cellHeight, inkTop, inkHeight, bbxX, - rows, null)); - } - } - } - } - } - - /** - * Register a batch of antialiased (4bpp) glyph rasters, e.g. TTF renders. - * Same font-group framing as register(), but each glyph record carries - * packed coverage instead of 1bpp rows: - * [encoding u32][bbxX s8][inkTop u8][width u8][inkHeight u8] - * [inkHeight x ceil(width/2) packed bytes, high nibble = left pixel] - * Nibble values are the final 4bpp source levels (the draw-time LUT - * scales them by the top color). Already-registered (font, encoding) - * records are skipped, as in register(). - */ - public static void registerAa(ByteBuffer buffer) { - if (buffer == null) return; - ByteBuffer in = buffer.order(ByteOrder.LITTLE_ENDIAN); - synchronized (lock) { - while (in.remaining() > 0) { - int keyLen = in.get() & 0xff; - byte[] keyBytes = new byte[keyLen]; - in.get(keyBytes); - String fontKey = new String(keyBytes, StandardCharsets.UTF_8); - int cellHeight = in.get() & 0xff; - int count = in.getShort() & 0xffff; - Integer idBoxed = fontIds.get(fontKey); - int id; - if (idBoxed == null) { - id = nextFontId++; - fontIds.put(fontKey, id); - } else { - id = idBoxed; - } - for (int g = 0; g < count; g++) { - int encoding = in.getInt(); - int bbxX = in.get(); - int inkTop = in.get() & 0xff; - int width = in.get() & 0xff; - int inkHeight = in.get() & 0xff; - int stride = (width + 1) >> 1; - byte[] coverage = new byte[width * inkHeight]; - for (int r = 0; r < inkHeight; r++) { - for (int b = 0; b < stride; b++) { - int packed = in.get() & 0xff; - int col = b * 2; - coverage[r * width + col] = (byte) (packed >> 4); - if (col + 1 < width) { - coverage[r * width + col + 1] = (byte) (packed & 0x0f); - } - } - } - long k = key(id, encoding); - if (!glyphs.containsKey(k) && width > 0 && cellHeight > 0 - && inkTop + inkHeight <= cellHeight) { - glyphs.put(k, new Glyph(width, cellHeight, inkTop, inkHeight, bbxX, - null, coverage)); - } - } - } - } - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/ImageAtlas.java b/App_Resources/Android/src/main/java/com/faceclaw/app/ImageAtlas.java deleted file mode 100644 index 206bae6b..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/ImageAtlas.java +++ /dev/null @@ -1,115 +0,0 @@ -package com.faceclaw.app; - -import java.nio.ByteBuffer; -import java.util.ArrayList; -import java.util.HashMap; -import java.util.List; -import java.util.Map; - -/** - * Process-wide registry of icon/image rasters for the texture-cache pipeline, - * the image counterpart of GlyphAtlas. Entries are content-addressed: the TS - * side keys each image by a hash of its dimensions and pixels, so the same - * icon registered from any thread or rendered at any time dedupes to one - * entry, and an icon whose content changes is simply a new entry. - * - * Unlike glyphs (1-bit ink recolored at draw time), images keep their exact - * 4bpp values: the cached bytes quantize the registered 8bpp pixels with the - * same GRAY_TO_NIBBLE table the composite is packed with, and the planner - * draws them via mode 13 with an identity LUT (top color 15) and the - * transparent bit — the draw writes exactly the nonzero-nibble pixels, which - * is what the eligibility check and hole punching are defined over. - */ -public final class ImageAtlas { - private ImageAtlas() {} - - public static final class Entry { - public final int width; - public final int height; - /** One 4bpp value per pixel, row-major. */ - final byte[] nibbles; - /** CFW cached-image bytes: [w][h][RLE(w*h pixels)]. */ - public final byte[] cachedBytes; - - Entry(int width, int height, byte[] nibbles) { - this.width = width; - this.height = height; - this.nibbles = nibbles; - this.cachedBytes = encodeCachedImage(); - } - - /** The 4bpp value the mode-13 draw would write at (col, row); 0 = skipped. */ - public int nibbleAt(int col, int row) { - return nibbles[row * width + col] & 0xff; - } - - private byte[] encodeCachedImage() { - int total = width * height; - byte[] out = new byte[2 + total]; - out[0] = (byte) width; - out[1] = (byte) height; - int o = 2; - int i = 0; - while (i < total) { - int color = nibbles[i] & 0xff; - int j = i + 1; - while (j < total && (nibbles[j] & 0xff) == color) j++; - int run = j - i; - while (run > 0) { - int c = Math.min(run, 0xffff); - if (c <= 15) { - out[o++] = (byte) ((c << 4) | color); - } else if (c <= 255) { - out[o++] = (byte) color; - out[o++] = (byte) c; - } else { - out[o++] = (byte) color; - out[o++] = 0; - out[o++] = (byte) (c & 0xff); - out[o++] = (byte) (c >> 8); - } - run -= c; - } - i = j; - } - byte[] trimmed = new byte[o]; - System.arraycopy(out, 0, trimmed, 0, o); - return trimmed; - } - } - - private static final Object lock = new Object(); - private static final Map ids = new HashMap<>(); - private static final List entries = new ArrayList<>(); - - /** - * Register an image (8bpp grayscale pixels, width*height bytes, row-major) - * under a content key, returning its id — or the existing id when the key - * is already registered (the pixels are then ignored: same key means same - * content). Ids are positive and stable for the process lifetime. - */ - public static int ensure(String key, int width, int height, ByteBuffer pixels8bpp) { - if (key == null || width <= 0 || width > 255 || height <= 0 || height > 255 - || pixels8bpp == null || pixels8bpp.remaining() < width * height) { - throw new IllegalArgumentException("bad image registration " + width + "x" + height); - } - synchronized (lock) { - Integer existing = ids.get(key); - if (existing != null) return existing; - byte[] nibbles = new byte[width * height]; - for (int i = 0; i < nibbles.length; i++) { - nibbles[i] = (byte) BmpUtil.nibbleForGray(pixels8bpp.get(i) & 0xff); - } - entries.add(new Entry(width, height, nibbles)); - int id = entries.size(); // ids start at 1 - ids.put(key, id); - return id; - } - } - - public static Entry get(int id) { - synchronized (lock) { - return id >= 1 && id <= entries.size() ? entries.get(id - 1) : null; - } - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/LvglFontFile.java b/App_Resources/Android/src/main/java/com/faceclaw/app/LvglFontFile.java deleted file mode 100644 index d728cc6b..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/LvglFontFile.java +++ /dev/null @@ -1,229 +0,0 @@ -package com.faceclaw.app; - -import android.util.Log; - -import java.io.File; -import java.io.IOException; -import java.io.RandomAccessFile; -import java.nio.ByteBuffer; -import java.nio.ByteOrder; -import java.util.HashMap; -import java.util.LinkedHashMap; -import java.util.Map; - -/** - * Reader for the serialized LVGL font image in the G2's CJK flash partition. - * Faceclaw bundles that font because it is Source Han Sans SC Light under the - * SIL OFL. Proprietary fonts embedded in the main firmware never pass through - * this class and are instead extracted on the user's phone during CFW install. - */ -public final class LvglFontFile { - private static final String TAG = "LvglFontFile"; - private static final int MAPPED_BASE = 0x80100000; - private static final int FONT_CACHE_SIZE = 2; - - private static final Map fontCache = - new LinkedHashMap(FONT_CACHE_SIZE, 0.75f, true) { - @Override - protected boolean removeEldestEntry(Map.Entry eldest) { - return size() > FONT_CACHE_SIZE; - } - }; - - private LvglFontFile() {} - - /** - * Returns [lineHeight, baseline] or an empty array when the font is invalid. - * The baseline is measured down from the top of the line. - */ - public static byte[] getMetrics(String path) { - FontData font = load(path); - if (font == null) return new byte[0]; - return new byte[] { (byte) font.lineHeight, (byte) font.baseline }; - } - - /** - * Returns one packed glyph: - * u16 boxW, u16 boxH, i16 ofsX, i16 ofsY, then aligned 4bpp bitmap bytes. - * Returns an empty array when the code point is not mapped. - */ - public static byte[] getGlyph(String path, int codePoint) { - FontData font = load(path); - if (font == null) return new byte[0]; - Integer glyphId = font.codePointToGlyph.get(codePoint); - if (glyphId == null || glyphId <= 0) return new byte[0]; - try { - int descriptor = font.glyphDescriptors + glyphId * 16; - int bitmapIndex = font.u32(descriptor); - int boxWidth = font.u16(descriptor + 8); - int boxHeight = font.u16(descriptor + 10); - int offsetX = font.i16(descriptor + 12); - int offsetY = font.i16(descriptor + 14); - int stride = boxWidth / 2 + 1; - int bitmapLength = boxWidth > 0 && boxHeight > 0 ? stride * boxHeight : 0; - font.check(font.glyphBitmaps + bitmapIndex, bitmapLength); - - byte[] result = new byte[8 + bitmapLength]; - putU16(result, 0, boxWidth); - putU16(result, 2, boxHeight); - putU16(result, 4, offsetX); - putU16(result, 6, offsetY); - System.arraycopy(font.bytes, font.glyphBitmaps + bitmapIndex, result, 8, bitmapLength); - return result; - } catch (RuntimeException e) { - Log.w(TAG, "invalid glyph U+" + Integer.toHexString(codePoint) + " in " + path, e); - return new byte[0]; - } - } - - private static synchronized FontData load(String path) { - if (path == null || path.isEmpty()) return null; - FontData cached = fontCache.get(path); - if (cached != null) return cached; - try { - FontData font = FontData.read(path); - fontCache.put(path, font); - return font; - } catch (IOException | RuntimeException e) { - Log.w(TAG, "could not load LVGL font " + path, e); - return null; - } - } - - private static void putU16(byte[] destination, int offset, int value) { - destination[offset] = (byte) (value & 0xff); - destination[offset + 1] = (byte) ((value >>> 8) & 0xff); - } - - private static final class FontData { - final byte[] bytes; - final ByteBuffer view; - final int lineHeight; - final int baseline; - final int glyphBitmaps; - final int glyphDescriptors; - final Map codePointToGlyph; - - private FontData(byte[] bytes) { - this.bytes = bytes; - this.view = ByteBuffer.wrap(bytes).order(ByteOrder.LITTLE_ENDIAN); - if (bytes.length < 0x40 || bytes[0] != 'Z' || bytes[1] != 'Z' || bytes[2] != 'Z' || bytes[3] != 'Z') { - throw new IllegalArgumentException("missing ZZZZ font header"); - } - - lineHeight = u16(0x38); - int baseLine = u16(0x3a); - baseline = lineHeight - baseLine; - - int descriptor = pointerOffset(u32(0x34)); - glyphBitmaps = pointerOffset(u32(descriptor)); - glyphDescriptors = pointerOffset(u32(descriptor + 4)); - int cmaps = pointerOffset(u32(descriptor + 8)); - int packed = u16(descriptor + 18); - int cmapCount = packed & 0x1ff; - int bitsPerPixel = (packed >>> 9) & 0xf; - int bitmapFormat = (packed >>> 14) & 0x3; - if (lineHeight <= 0 || baseline < 0 || cmapCount <= 0 || - bitsPerPixel != 4 || bitmapFormat != 3) { - throw new IllegalArgumentException("unsupported LVGL font metadata"); - } - - codePointToGlyph = new HashMap<>(); - for (int index = 0; index < cmapCount; index++) { - readCmap(cmaps + index * 20); - } - } - - static FontData read(String path) throws IOException { - File file = new File(path); - if (!file.isFile() || !file.canRead() || file.length() > Integer.MAX_VALUE) { - throw new IOException("font is not a readable file"); - } - byte[] bytes = new byte[(int) file.length()]; - try (RandomAccessFile input = new RandomAccessFile(file, "r")) { - input.readFully(bytes); - } - return new FontData(bytes); - } - - void readCmap(int address) { - int rangeStart = u32(address); - int rangeLength = u16(address + 4); - int glyphIdStart = u16(address + 6); - int unicodeListPointer = u32(address + 8); - int glyphIdOffsetsPointer = u32(address + 12); - int listLength = u16(address + 16); - int type = u8(address + 18); - - if (type == 2) { - for (int relative = 0; relative < rangeLength; relative++) { - codePointToGlyph.put(rangeStart + relative, glyphIdStart + relative); - } - return; - } - - if (type == 0) { - int offsets = pointerOffset(glyphIdOffsetsPointer); - for (int relative = 0; relative < rangeLength; relative++) { - int offset = u8(offsets + relative); - if (relative != 0 && offset == 0) continue; - codePointToGlyph.put(rangeStart + relative, glyphIdStart + offset); - } - return; - } - - if (type == 3 || type == 1) { - int unicodeList = pointerOffset(unicodeListPointer); - int offsets = glyphIdOffsetsPointer == 0 ? -1 : pointerOffset(glyphIdOffsetsPointer); - for (int index = 0; index < listLength; index++) { - int relative = u16(unicodeList + index * 2); - int offset = index; - if (offsets >= 0) { - offset = type == 1 ? u16(offsets + index * 2) : u8(offsets + index); - if (index != 0 && offset == 0) continue; - } - codePointToGlyph.put(rangeStart + relative, glyphIdStart + offset); - } - return; - } - - throw new IllegalArgumentException("unknown cmap type " + type); - } - - int u8(int offset) { - check(offset, 1); - return bytes[offset] & 0xff; - } - - int u16(int offset) { - check(offset, 2); - return view.getShort(offset) & 0xffff; - } - - int i16(int offset) { - check(offset, 2); - return view.getShort(offset); - } - - int u32(int offset) { - check(offset, 4); - return view.getInt(offset); - } - - int pointerOffset(int pointer) { - long unsignedPointer = pointer & 0xffffffffL; - long offset = unsignedPointer - (MAPPED_BASE & 0xffffffffL); - if (offset < 0 || offset > Integer.MAX_VALUE) { - throw new IllegalArgumentException("font pointer is outside the mapped partition"); - } - check((int) offset, 1); - return (int) offset; - } - - void check(int offset, int length) { - if (offset < 0 || length < 0 || (long) offset + length > bytes.length) { - throw new IllegalArgumentException("font range is out of bounds"); - } - } - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/ScreenshotUtil.java b/App_Resources/Android/src/main/java/com/faceclaw/app/ScreenshotUtil.java index 9ffdcd1b..313abece 100644 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/ScreenshotUtil.java +++ b/App_Resources/Android/src/main/java/com/faceclaw/app/ScreenshotUtil.java @@ -2,15 +2,12 @@ package com.faceclaw.app; import android.content.Context; -import java.io.ByteArrayOutputStream; import java.io.File; import java.io.FileOutputStream; import java.io.IOException; import java.text.SimpleDateFormat; import java.util.Date; import java.util.Locale; -import java.util.zip.CRC32; -import java.util.zip.Deflater; /** * Saves screenshots of the composited screen as 4-bit grayscale PNGs (the @@ -25,7 +22,7 @@ public final class ScreenshotUtil { if (gray == null || width <= 0 || height <= 0 || gray.length < width * height) { throw new IllegalArgumentException("invalid screenshot buffer"); } - byte[] png = encode4BitGrayPng(gray, width, height); + byte[] png = SharedScreenshots.encode4BitGrayPng(gray, width, height); File file = new File(ensureScreenshotsDir(context), "screen-" + timestamp() + ".png"); try (FileOutputStream out = new FileOutputStream(file)) { out.write(png); @@ -45,80 +42,4 @@ public final class ScreenshotUtil { return new SimpleDateFormat("yyyyMMdd-HHmmss-SSS", Locale.US).format(new Date()); } - /** - * Encode an 8bpp grayscale buffer as a bit-depth-4 grayscale PNG, keeping - * the top nibble of each pixel (the same quantization the wire format uses). - */ - static byte[] encode4BitGrayPng(byte[] gray, int width, int height) { - // Raw scanlines: one filter byte (0 = None) then two pixels per byte, - // leftmost pixel in the high nibble. - int rowBytes = (width + 1) / 2; - byte[] raw = new byte[height * (1 + rowBytes)]; - int p = 0; - for (int y = 0; y < height; y++) { - raw[p++] = 0; - int row = y * width; - for (int x = 0; x < width; x += 2) { - int hi = (gray[row + x] & 0xff) >>> 4; - int lo = (x + 1 < width) ? (gray[row + x + 1] & 0xff) >>> 4 : 0; - raw[p++] = (byte) ((hi << 4) | lo); - } - } - - ByteArrayOutputStream out = new ByteArrayOutputStream(); - out.write(0x89); - out.write('P'); - out.write('N'); - out.write('G'); - out.write(0x0d); - out.write(0x0a); - out.write(0x1a); - out.write(0x0a); - - ByteArrayOutputStream ihdr = new ByteArrayOutputStream(); - writeIntBE(ihdr, width); - writeIntBE(ihdr, height); - ihdr.write(4); // bit depth - ihdr.write(0); // color type: grayscale - ihdr.write(0); // compression - ihdr.write(0); // filter - ihdr.write(0); // interlace - writeChunk(out, "IHDR", ihdr.toByteArray()); - writeChunk(out, "IDAT", zlibDeflate(raw)); - writeChunk(out, "IEND", new byte[0]); - return out.toByteArray(); - } - - static byte[] zlibDeflate(byte[] data) { - Deflater deflater = new Deflater(); - deflater.setInput(data); - deflater.finish(); - ByteArrayOutputStream out = new ByteArrayOutputStream(Math.max(64, data.length / 8)); - byte[] buffer = new byte[8192]; - while (!deflater.finished()) { - out.write(buffer, 0, deflater.deflate(buffer)); - } - deflater.end(); - return out.toByteArray(); - } - - private static void writeChunk(ByteArrayOutputStream out, String type, byte[] data) { - writeIntBE(out, data.length); - CRC32 crc = new CRC32(); - for (int i = 0; i < 4; i++) { - int b = type.charAt(i); - out.write(b); - crc.update(b); - } - out.write(data, 0, data.length); - crc.update(data); - writeIntBE(out, (int) crc.getValue()); - } - - private static void writeIntBE(ByteArrayOutputStream out, int value) { - out.write((value >>> 24) & 0xff); - out.write((value >>> 16) & 0xff); - out.write((value >>> 8) & 0xff); - out.write(value & 0xff); - } } diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/SurfaceCompositor.java b/App_Resources/Android/src/main/java/com/faceclaw/app/SurfaceCompositor.java deleted file mode 100644 index 1a86e8cb..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/SurfaceCompositor.java +++ /dev/null @@ -1,509 +0,0 @@ -package com.faceclaw.app; - -import java.nio.ByteBuffer; -import java.util.ArrayList; -import java.util.Comparator; -import java.util.HashMap; -import java.util.List; -import java.util.Map; - -/** - * Retained-surface compositor: the phone-side model of what is on the glasses - * screen. - * - * Each surface is an 8bpp grayscale buffer retained at its last-submitted - * contents, positioned on the screen with a z-order and a transparency mode. - * Sources on the TS side (today the dashboard; later the shell and per-app - * worker threads) submit updates to their surface, and the compositor - * recombines the retained surfaces into a full-screen frame that feeds the - * existing dedupe/compress/transmit pipeline. Because every surface is - * retained, a full screen frame can be regenerated at any time (frame drops, - * reconnects, previews, screenshots) without asking sources to repaint. - * - * Surface format contract (mirrored by the TS side): - * - Pixels are 8bpp grayscale, row-major, one byte per pixel. The wire - * pipeline quantizes to 4bpp downstream, so the low nibble is not visible. - * - TRANSPARENCY_COLOR_KEY surfaces treat pixel value 0 as fully transparent - * and value 1 as black. Quantization collapses 1 into the same 4bpp level - * as 0, so reserving 0 costs no visible shade; painters of color-key - * surfaces must clamp intentional black to 1. - * - An update may cover any rect of its surface; the rest is retained. The - * update buffer holds exactly rectWidth*rectHeight bytes, row-major. - * - Surfaces composite in ascending z-order onto a black (0) background. - * - Surface geometry changes take effect when the next frame composites; - * they do not trigger a recomposite by themselves. - * - * Thread safety: all methods are safe to call from any thread. Apply and - * composite happen atomically under an internal lock, and each composite - * carries a monotonic sequence number so callers can detect when a composite - * was superseded by a concurrent one before being acted on. - */ -public final class SurfaceCompositor { - public static final int TRANSPARENCY_OPAQUE = 0; - public static final int TRANSPARENCY_COLOR_KEY = 1; - - /** - * One deferred draw (a text glyph or an icon image) within a frame, in - * screen coordinates. The draw's pixels are already baked into the - * composited gray buffer (the TS side bakes before submitting); this - * record preserves the draw's identity so the texture-cache planner can - * replay it as an on-glasses cached draw instead of image bytes. - * - * Glyphs: x/y are the pen position and line top; the raster (and its - * bearing/cell placement) comes from GlyphAtlas under (fontId, encoding). - * Images: x/y are the blit's top-left; the raster comes from ImageAtlas - * under imageId. - */ - public static final class ScreenDraw { - public static final int KIND_GLYPH = 0; - public static final int KIND_IMAGE = 1; - /** A firmware-builtin-font text run (CFW mode 15). */ - public static final int KIND_FWTEXT = 2; - - public final int kind; - /** Glyph draws only. */ - public final int fontId; - /** Glyph draws only. */ - public final int encoding; - /** Image draws only. */ - public final int imageId; - public final int x; - public final int y; - /** Glyph and fw-text draws: 8-bit brightness. */ - public final int value; - /** Fw-text runs only: member codepoints, in text order. */ - public final int[] fwCps; - /** Fw-text runs only: member pen offsets relative to x. */ - public final int[] fwDx; - /** Fw-text runs only: whether each member has visible pixels. */ - public final boolean[] fwInk; - - ScreenDraw(int kind, int fontId, int encoding, int imageId, int x, int y, int value, - int[] fwCps, int[] fwDx, boolean[] fwInk) { - this.kind = kind; - this.fontId = fontId; - this.encoding = encoding; - this.imageId = imageId; - this.x = x; - this.y = y; - this.value = value; - this.fwCps = fwCps; - this.fwDx = fwDx; - this.fwInk = fwInk; - } - - static ScreenDraw glyph(int fontId, int encoding, int penX, int lineY, int value) { - return new ScreenDraw(KIND_GLYPH, fontId, encoding, 0, penX, lineY, value, null, null, null); - } - - static ScreenDraw image(int imageId, int x, int y) { - return new ScreenDraw(KIND_IMAGE, 0, 0, imageId, x, y, 0, null, null, null); - } - - static ScreenDraw fwText(int x, int y, int value, int[] cps, int[] dx, boolean[] ink) { - return new ScreenDraw(KIND_FWTEXT, 0, 0, 0, x, y, value, cps, dx, ink); - } - } - - private static final ScreenDraw[] NO_DRAWS = new ScreenDraw[0]; - - /** One composited full-screen frame plus the metadata the pipeline needs. */ - public static final class Composite { - /** Full-screen 8bpp grayscale pixels, screenWidth*screenHeight bytes. */ - public final byte[] gray; - public final int width; - public final int height; - /** - * Stable identifier of screen content, combining every surface's - * geometry and content fingerprint; equal fingerprints mean equal - * composited pixels. - */ - public final String fingerprint; - /** Monotonic: a Composite with a higher seq contains strictly newer state. */ - public final long seq; - /** - * Screen-space deferred draws of every visible surface, in composite - * order (surface z ascending, then each surface's draw order). Their - * pixels are already baked into gray. - */ - public final ScreenDraw[] draws; - - Composite(byte[] gray, int width, int height, String fingerprint, long seq, ScreenDraw[] draws) { - this.gray = gray; - this.width = width; - this.height = height; - this.fingerprint = fingerprint; - this.seq = seq; - this.draws = draws == null ? NO_DRAWS : draws; - } - } - - private static final class Surface { - final String id; - int x; - int y; - int width; - int height; - int zOrder; - int transparency; - boolean visible = true; - byte[] pixels; - String fingerprint = ""; - /** Surface-local deferred draws of the retained content (already baked into pixels). */ - ScreenDraw[] draws = NO_DRAWS; - - Surface(String id) { - this.id = id; - } - } - - private final Object lock = new Object(); - private int screenWidth; - private int screenHeight; - private boolean blanked; - /** See setUnderlayDim: surfaces with zOrder below this are dimmed by underlayDim/256. */ - private int underlayDimBelowZOrder = Integer.MIN_VALUE; - private int underlayDim = 256; - private final Map surfaces = new HashMap<>(); - private long nextCompositeSeq = 1; - - /** Set the output frame size. Must be called before any surface work. */ - public void configureScreen(int width, int height) { - if (width <= 0 || height <= 0) { - throw new IllegalArgumentException("bad screen size " + width + "x" + height); - } - synchronized (lock) { - this.screenWidth = width; - this.screenHeight = height; - } - } - - /** - * Create a surface or update an existing one's geometry. A resize discards - * the surface's retained pixels (reset to 0). - */ - public void configureSurface(String id, int x, int y, int width, int height, int zOrder, int transparency) { - if (id == null || id.isEmpty()) { - throw new IllegalArgumentException("surface id must be non-empty"); - } - if (width <= 0 || height <= 0) { - throw new IllegalArgumentException("bad surface size " + width + "x" + height + " for " + id); - } - if (transparency != TRANSPARENCY_OPAQUE && transparency != TRANSPARENCY_COLOR_KEY) { - throw new IllegalArgumentException("bad transparency mode " + transparency + " for " + id); - } - synchronized (lock) { - requireScreenConfiguredLocked(); - Surface surface = surfaces.get(id); - if (surface == null) { - surface = new Surface(id); - surfaces.put(id, surface); - } - if (surface.pixels == null || surface.width != width || surface.height != height) { - surface.pixels = new byte[width * height]; - surface.fingerprint = ""; - surface.draws = NO_DRAWS; - } - surface.x = x; - surface.y = y; - surface.width = width; - surface.height = height; - surface.zOrder = zOrder; - surface.transparency = transparency; - } - } - - public void removeSurface(String id) { - synchronized (lock) { - surfaces.remove(id); - } - } - - /** - * Dim every surface whose zOrder is below belowZOrder to factor256/256 of - * its brightness (256 = no dimming): how a shell overlay that dims what it - * covers (the TS Layer.dimUnderneath) reaches the window surfaces beneath - * the shell surface, which the shell's own layer stack cannot paint. - * Visible pixels stay at least 1 (the color-key black); glyph and - * firmware-text draws keep their cached-draw form with a dimmed value; - * image draws leave the composite's draw list (their pixels, already - * baked into the surface, dim as raster). Takes effect when the next - * frame composites. - */ - public void setUnderlayDim(int belowZOrder, int factor256) { - synchronized (lock) { - underlayDimBelowZOrder = belowZOrder; - underlayDim = Math.max(0, Math.min(256, factor256)); - } - } - - /** The dim factor (256 = none) that applies to a surface. */ - private int dimForLocked(Surface surface) { - return surface.zOrder < underlayDimBelowZOrder ? underlayDim : 256; - } - - private static int dimValue(int value, int dim) { - return Math.max(1, (value * dim + 128) >> 8); - } - - /** - * Hidden surfaces keep their retained pixels and accept updates, but are - * excluded from the composite and its fingerprint (used for background - * windows). Takes effect when the next frame composites. - */ - public void setSurfaceVisible(String id, boolean visible) { - synchronized (lock) { - Surface surface = surfaces.get(id); - if (surface == null) { - throw new IllegalArgumentException("unknown surface " + id); - } - surface.visible = visible; - } - } - - /** - * While blanked (screen off), composites are all-zero regardless of - * surface content; retained state is untouched, so unblanking restores - * the screen without asking sources to repaint. - */ - public void setBlanked(boolean blanked) { - synchronized (lock) { - this.blanked = blanked; - } - } - - /** - * Apply an update to one surface and composite the whole screen, as one - * atomic step. The update covers the rect (rectX, rectY, rectWidth, - * rectHeight) in surface-local coordinates; pixels must hold exactly - * rectWidth*rectHeight bytes. contentFingerprint identifies the surface's - * full content after this update. - */ - public Composite applyAndComposite( - String surfaceId, - ByteBuffer pixels, - int rectX, - int rectY, - int rectWidth, - int rectHeight, - String contentFingerprint - ) { - return applyAndComposite(surfaceId, pixels, rectX, rectY, rectWidth, rectHeight, - contentFingerprint, null); - } - - /** - * As above, with the frame's deferred draws: a little-endian buffer of - * tagged records - * [0][fontId u16][encoding u32][penX s16][lineY s16][value u8] (glyph) - * [1][imageId u32][x s16][y s16] (image) - * in surface-local coordinates and draw order. The list describes the - * surface's FULL retained content and replaces the previous list, so it is - * only meaningful for full-surface updates (which is what every submitter - * sends); pass null to clear. Draw pixels must already be baked into pixels. - */ - public Composite applyAndComposite( - String surfaceId, - ByteBuffer pixels, - int rectX, - int rectY, - int rectWidth, - int rectHeight, - String contentFingerprint, - ByteBuffer glyphs - ) { - ScreenDraw[] parsed = parseDraws(glyphs); - synchronized (lock) { - requireScreenConfiguredLocked(); - Surface surface = surfaces.get(surfaceId); - if (surface == null) { - throw new IllegalArgumentException("unknown surface " + surfaceId); - } - if (rectX < 0 || rectY < 0 || rectWidth <= 0 || rectHeight <= 0 - || rectX + rectWidth > surface.width || rectY + rectHeight > surface.height) { - throw new IllegalArgumentException("update rect " + rectWidth + "x" + rectHeight - + "+" + rectX + "+" + rectY + " outside surface " + surfaceId - + " (" + surface.width + "x" + surface.height + ")"); - } - int expectedBytes = rectWidth * rectHeight; - if (pixels == null || pixels.remaining() != expectedBytes) { - throw new IllegalArgumentException("update buffer for " + surfaceId + " has " - + (pixels == null ? 0 : pixels.remaining()) + " bytes, expected " + expectedBytes); - } - for (int row = 0; row < rectHeight; row++) { - int dstOffset = (rectY + row) * surface.width + rectX; - pixels.get(surface.pixels, dstOffset, rectWidth); - } - surface.fingerprint = contentFingerprint == null ? "" : contentFingerprint; - surface.draws = parsed; - return compositeLocked(); - } - } - - private static ScreenDraw[] parseDraws(ByteBuffer draws) { - if (draws == null || draws.remaining() < 1) { - return NO_DRAWS; - } - ByteBuffer in = draws.order(java.nio.ByteOrder.LITTLE_ENDIAN); - List out = new ArrayList<>(); - while (in.remaining() >= 1) { - int kind = in.get() & 0xff; - if (kind == ScreenDraw.KIND_GLYPH && in.remaining() >= 11) { - int fontId = in.getShort() & 0xffff; - int encoding = in.getInt(); - int penX = in.getShort(); - int lineY = in.getShort(); - int value = in.get() & 0xff; - out.add(ScreenDraw.glyph(fontId, encoding, penX, lineY, value)); - } else if (kind == ScreenDraw.KIND_IMAGE && in.remaining() >= 8) { - int imageId = in.getInt(); - int x = in.getShort(); - int y = in.getShort(); - out.add(ScreenDraw.image(imageId, x, y)); - } else if (kind == ScreenDraw.KIND_FWTEXT && in.remaining() >= 6) { - int x = in.getShort(); - int y = in.getShort(); - int value = in.get() & 0xff; - int count = in.get() & 0xff; - if (in.remaining() < count * 7) { - break; // malformed tail: keep what parsed cleanly - } - int[] cps = new int[count]; - int[] dx = new int[count]; - boolean[] ink = new boolean[count]; - for (int i = 0; i < count; i++) { - cps[i] = in.getInt(); - dx[i] = in.getShort(); - ink[i] = in.get() != 0; - } - out.add(ScreenDraw.fwText(x, y, value, cps, dx, ink)); - } else { - break; // malformed tail: keep what parsed cleanly - } - } - return out.toArray(new ScreenDraw[0]); - } - - /** Composite the current retained state without applying an update. */ - public Composite composite() { - synchronized (lock) { - requireScreenConfiguredLocked(); - return compositeLocked(); - } - } - - /** - * Current composited pixels for the phone-side preview / screenshot, or - * null before the screen is configured. Does not consume a sequence - * number (it is never stored as the desired frame). - */ - public Composite previewComposite() { - synchronized (lock) { - if (screenWidth <= 0 || screenHeight <= 0) { - return null; - } - byte[] gray = buildGrayLocked(); - return new Composite(gray, screenWidth, screenHeight, "preview", 0, NO_DRAWS); - } - } - - private byte[] buildGrayLocked() { - byte[] gray = new byte[screenWidth * screenHeight]; - if (blanked) { - return gray; - } - List ordered = new ArrayList<>(surfaces.values()); - ordered.sort(Comparator - .comparingInt((Surface s) -> s.zOrder) - .thenComparing(s -> s.id)); - for (Surface surface : ordered) { - if (surface.visible) { - blendLocked(gray, surface); - } - } - return gray; - } - - private Composite compositeLocked() { - byte[] gray = new byte[screenWidth * screenHeight]; - if (blanked) { - return new Composite(gray, screenWidth, screenHeight, - "blanked:" + screenWidth + "x" + screenHeight, nextCompositeSeq++, NO_DRAWS); - } - List ordered = new ArrayList<>(surfaces.values()); - ordered.sort(Comparator - .comparingInt((Surface s) -> s.zOrder) - .thenComparing(s -> s.id)); - StringBuilder fingerprint = new StringBuilder(); - fingerprint.append(screenWidth).append('x').append(screenHeight); - List draws = new ArrayList<>(); - for (Surface surface : ordered) { - if (!surface.visible) continue; - blendLocked(gray, surface); - int dim = dimForLocked(surface); - for (ScreenDraw draw : surface.draws) { - if (dim < 256 && draw.kind == ScreenDraw.KIND_IMAGE) continue; - int value = dim < 256 ? dimValue(draw.value, dim) : draw.value; - draws.add(new ScreenDraw(draw.kind, draw.fontId, draw.encoding, draw.imageId, - draw.x + surface.x, draw.y + surface.y, value, - draw.fwCps, draw.fwDx, draw.fwInk)); - } - fingerprint.append('|').append(surface.id) - .append('@').append(surface.x).append(',').append(surface.y) - .append('+').append(surface.width).append('x').append(surface.height) - .append('#').append(surface.zOrder) - .append(':').append(surface.transparency) - .append(':').append(surface.fingerprint); - if (dim < 256) { - fingerprint.append(":dim").append(dim); - } - } - return new Composite(gray, screenWidth, screenHeight, fingerprint.toString(), nextCompositeSeq++, - draws.toArray(new ScreenDraw[0])); - } - - private void blendLocked(byte[] gray, Surface surface) { - // Clip the surface rect to the screen. - int srcX = Math.max(0, -surface.x); - int srcY = Math.max(0, -surface.y); - int dstX = Math.max(0, surface.x); - int dstY = Math.max(0, surface.y); - int copyWidth = Math.min(surface.width - srcX, screenWidth - dstX); - int copyHeight = Math.min(surface.height - srcY, screenHeight - dstY); - if (copyWidth <= 0 || copyHeight <= 0) { - return; - } - int dim = dimForLocked(surface); - for (int row = 0; row < copyHeight; row++) { - int srcOffset = (srcY + row) * surface.width + srcX; - int dstOffset = (dstY + row) * screenWidth + dstX; - if (dim < 256) { - // Dimmed: opaque or color-keyed, 0 stays 0 (black / transparent) - // and everything visible scales, never below 1. - for (int col = 0; col < copyWidth; col++) { - int value = surface.pixels[srcOffset + col] & 0xff; - if (value != 0) { - gray[dstOffset + col] = (byte) dimValue(value, dim); - } else if (surface.transparency == TRANSPARENCY_OPAQUE) { - gray[dstOffset + col] = 0; - } - } - } else if (surface.transparency == TRANSPARENCY_OPAQUE) { - System.arraycopy(surface.pixels, srcOffset, gray, dstOffset, copyWidth); - } else { - for (int col = 0; col < copyWidth; col++) { - byte value = surface.pixels[srcOffset + col]; - if (value != 0) { - gray[dstOffset + col] = value; - } - } - } - } - } - - private void requireScreenConfiguredLocked() { - if (screenWidth <= 0 || screenHeight <= 0) { - throw new IllegalStateException("configureScreen must be called first"); - } - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/BleImageOptimizer.java b/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/BleImageOptimizer.java deleted file mode 100644 index b9336cee..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/BleImageOptimizer.java +++ /dev/null @@ -1,555 +0,0 @@ -package com.faceclaw.app; - -import java.util.ArrayList; -import java.util.Arrays; -import java.util.Collections; -import java.util.List; -import android.util.Log; - -public final class BleImageOptimizer { - private BleImageOptimizer() {} - private static final String TAG = "BleImageOptimizer"; - - /** - * Split an image into fragments (packets), taking advantage of the fact that each packet can declare - * a logical size longer than its byte payload to get free trailing zero-padding. - * - * Each fragment's logical size stays within maxFragmentSize, while trailing zeros inside that span can - * be omitted from the payload. - */ - public static List planImageFragments(byte[] bmp, int maxFragmentSize) { - return planImageFragments(bmp, maxFragmentSize, false); - } - - public static List planImageFragments( - byte[] bmp, - int maxFragmentSize, - boolean reserveFinalByte - ) { - if (bmp == null || bmp.length == 0) { - return Collections.singletonList(new BleProtocol.ImageFragment(0, new byte[0], 0)); - } - if (maxFragmentSize <= 0) { - throw new IllegalArgumentException("maxFragmentSize must be positive"); - } - - final int bulkLength = reserveFinalByte ? bmp.length - 1 : bmp.length; - final int fragmentCount = ((bulkLength + maxFragmentSize - 1) / maxFragmentSize) - + (bulkLength < bmp.length ? 1 : 0); - final List fragments = new ArrayList<>(fragmentCount); - for (int index = 0; index * maxFragmentSize < bulkLength; index++) { - int start = index * maxFragmentSize; - int end = Math.min(start + maxFragmentSize, bulkLength); - fragments.add(buildFragment(index, bmp, start, end)); - } - if (bulkLength < bmp.length) { - fragments.add(new BleProtocol.ImageFragment( - fragments.size(), - Arrays.copyOfRange(bmp, bulkLength, bmp.length), - bmp.length - bulkLength - )); - } - Log.i(TAG, "planImageFragments: fragments=" + fragments.size() + ", bmp.length=" + bmp.length + ", maxFragmentSize=" + maxFragmentSize); - return fragments; - } - - private static BleProtocol.ImageFragment buildFragment(int index, byte[] bmp, int start, int end) { - int dataEnd = end; - while (dataEnd > start && bmp[dataEnd - 1] == 0) { - dataEnd -= 1; - } - if (dataEnd == start) { - return new BleProtocol.ImageFragment(index, new byte[0], end - start); - } - return new BleProtocol.ImageFragment( - index, - Arrays.copyOfRange(bmp, start, dataEnd), - end - start - ); - } - - public static final class TileImagePlan { - final int tileIndex; - final BleProtocol.ImageTileOptions tile; - // Headerless packed 4bpp frame (top-down, stride ceil(width/2)), kept for - // the displayed-tile dedup cache. Frames are immutable by convention: - // producers always allocate a fresh buffer, so no defensive copy here. - public final byte[] packed; - public final int width; - public final int height; - final byte[] payload; // bytes actually streamed: mode-6 rle(4bpp) - final int sessionId; - List fragments = Collections.emptyList(); - - TileImagePlan(int tileIndex, BleProtocol.ImageTileOptions tile, byte[] packed, int width, int height, int sessionId) { - this.tileIndex = tileIndex; - this.tile = tile; - this.packed = packed == null ? new byte[0] : packed; - this.width = width; - this.height = height; - this.payload = maybeCompress(this.packed, width, height); - this.sessionId = sessionId; - } - - /** - * Plan with an explicit wire payload (e.g. a mode-3 incremental update). - * packed must still be the FULL new frame: it feeds the displayed-frame - * dedup cache, which after an applied incremental equals the full frame. - */ - TileImagePlan(int tileIndex, BleProtocol.ImageTileOptions tile, byte[] packed, int width, int height, int sessionId, byte[] payloadOverride) { - this.tileIndex = tileIndex; - this.tile = tile; - this.packed = packed == null ? new byte[0] : packed; - this.width = width; - this.height = height; - this.payload = payloadOverride; - this.sessionId = sessionId; - } - } - - /** - * Build a mode-3 bounding-box incremental payload, or null when a full - * update should be sent instead (frames not comparable, or the changed - * region spans the whole screen). Wire format: - * [3][left/4][top/2][width/4][height/2][fid_lo][fid_hi][rle(headerless 4bpp region)] - * The region is top-down rows of the NEW frame, stride width/2 bytes. The - * box is aligned so left/width are multiples of 4 pixels and top/height - * multiples of 2 rows, letting each coordinate fit one byte and avoiding - * 4bpp byte-boundary corner cases. Identical frames yield null too; the - * caller's dedup check should normally catch that first. - * - * frameId is a little-endian uint16 the CFW uses to detect reordered, - * skipped or duplicated deltas (its diagnostic overlay); the caller advances - * it by 1 per emitted delta so consecutive deltas are consecutive. - */ - /** - * A mode-3 incremental payload plus diagnostics about how tightly the - * bounding box fit the actual change. {@code changedBytes} is how many - * packed bytes actually differ; {@code boxBytes} is how many the box sends. - * A large box with few changed bytes / multiple clusters means distant - * small edits were merged into one oversized box (which can spill past the - * fragment size into an extra serialized BLE message). - */ - public static final class IncrementalPlan { - public final byte[] payload; - public final int changedBytes; - public final int boxBytes; - public final int clusterCount; - - IncrementalPlan(byte[] payload, int changedBytes, int boxBytes, int clusterCount) { - this.payload = payload; - this.changedBytes = changedBytes; - this.boxBytes = boxBytes; - this.clusterCount = clusterCount; - } - } - - public static IncrementalPlan buildIncrementalImagePayload(byte[] previous, byte[] next, int width, int height, int frameId) { - int stride = (width + 1) >> 1; - if (width <= 0 || height <= 0 || previous == null || next == null - || previous.length != stride * height || next.length != stride * height) { - return null; - } - - // Full diff scan in packed-byte coordinates (1 byte = 2 pixels): the - // changed bounding box plus diagnostics (total changed bytes, and how - // many disjoint horizontal column-clusters the change splits into). - int minByteX = stride; - int maxByteX = -1; - int minY = height; - int maxY = -1; - int changedBytes = 0; - boolean[] columnChanged = new boolean[stride]; - for (int y = 0; y < height; y++) { - int rowOffset = y * stride; - for (int x = 0; x < stride; x++) { - if (previous[rowOffset + x] != next[rowOffset + x]) { - changedBytes++; - columnChanged[x] = true; - if (x < minByteX) minByteX = x; - if (x > maxByteX) maxByteX = x; - if (y < minY) minY = y; - maxY = y; - } - } - } - if (maxY < 0) { - return null; // identical - } - int clusterCount = 0; - boolean inCluster = false; - for (int x = minByteX; x <= maxByteX; x++) { - if (columnChanged[x]) { - if (!inCluster) clusterCount++; - inCluster = true; - } else { - inCluster = false; - } - } - - // Pixel-space box, aligned: left/width to multiples of 4, top/height to - // multiples of 2, clamped to the frame. - int left = (minByteX * 2) & ~3; - int rightExclusive = Math.min(width, (((maxByteX + 1) * 2) + 3) & ~3); - int top = minY & ~1; - int bottomExclusive = Math.min(height, (maxY + 2) & ~1); - int boxWidth = rightExclusive - left; - int boxHeight = bottomExclusive - top; - if (boxWidth >= width && boxHeight >= height) { - return null; // whole screen changed; full update is strictly better - } - - byte[] out = encodeMode3Rect(next, stride, left, top, boxWidth, boxHeight, frameId); - return new IncrementalPlan(out, changedBytes, (boxWidth >> 1) * boxHeight, clusterCount); - } - - /** - * The aligned changed bounding box between two same-size packed frames, or - * null when they are identical: pixel-space {left, top, width, height} with - * left/width multiples of 4 and top/height multiples of 2 (mode-3 header - * quantization). Exposed so the texture-cache planner can reuse the exact - * rect geometry the single-bbox path would send. - */ - public static int[] computeChangedBox(byte[] previous, byte[] next, int width, int height) { - int stride = (width + 1) >> 1; - if (width <= 0 || height <= 0 || previous == null || next == null - || previous.length != stride * height || next.length != stride * height) { - return null; - } - int minByteX = stride; - int maxByteX = -1; - int minY = height; - int maxY = -1; - for (int y = 0; y < height; y++) { - int rowOffset = y * stride; - for (int x = 0; x < stride; x++) { - if (previous[rowOffset + x] != next[rowOffset + x]) { - if (x < minByteX) minByteX = x; - if (x > maxByteX) maxByteX = x; - if (y < minY) minY = y; - maxY = y; - } - } - } - if (maxY < 0) { - return null; - } - int left = (minByteX * 2) & ~3; - int rightExclusive = Math.min(width, (((maxByteX + 1) * 2) + 3) & ~3); - int top = minY & ~1; - int bottomExclusive = Math.min(height, (maxY + 2) & ~1); - return new int[]{left, top, rightExclusive - left, bottomExclusive - top}; - } - - /** - * The multi-rect split of the changed region (see computeSplitRects), or null - * when it is one region / too fragmented / the frames aren't comparable. - * Exposed for the texture-cache planner. - */ - public static List computeChangedRects(byte[] previous, byte[] next, int width, int height, int maxRects) { - int stride = (width + 1) >> 1; - if (width <= 0 || height <= 0 || previous == null || next == null - || previous.length != stride * height || next.length != stride * height) { - return null; - } - List rects = computeSplitRects(previous, next, stride, width, height, maxRects); - return (rects == null || rects.size() < 2) ? null : rects; - } - - /** - * Encode one CFW mode-3 rectangle delta: - * [3][left/4][top/2][width/4][height/2][fid_lo][fid_hi][rle(box pixels)] - * left/width must be multiples of 4 (=> left>>1, width>>1 are whole bytes), top/ - * height multiples of 2. The box pixels are top-down rows of `next` (4bpp packed, - * width>>1 bytes/row), run-length encoded before deflate. Shared by the single-bbox - * path, each rect of a mode-8 multi-rect batch, and the texture-cache planner. - */ - static byte[] encodeMode3Rect(byte[] next, int stride, int left, int top, - int boxWidth, int boxHeight, int fid) { - int regionStride = boxWidth >> 1; - byte[] region = new byte[regionStride * boxHeight]; - for (int y = 0; y < boxHeight; y++) { - System.arraycopy(next, (top + y) * stride + (left >> 1), region, y * regionStride, regionStride); - } - byte[] compressed = rleEncode(region); - byte[] out = new byte[7 + compressed.length]; - out[0] = 3; - out[1] = (byte) (left / 4); - out[2] = (byte) (top / 2); - out[3] = (byte) (boxWidth / 4); - out[4] = (byte) (boxHeight / 2); - out[5] = (byte) (fid & 0xff); // fid_lo - out[6] = (byte) ((fid >> 8) & 0xff); // fid_hi - System.arraycopy(compressed, 0, out, 7, compressed.length); - return out; - } - - /** A full repaint in independently decodable commands below the uint16 record limit. */ - static List encodeFullFrameBands(byte[] packed, int width, int height, int firstFid) { - if (width <= 0 || width > 640 || (width & 3) != 0 || height <= 0 || height > 480 - || (height & 1) != 0 || packed.length != width * height / 2) { - throw new IllegalArgumentException("unsupported custom framebuffer dimensions"); - } - List commands = new ArrayList<>(); - int fid = firstFid; - for (int top = 0; top < height; top += 64) { - commands.add(encodeMode3Rect(packed, width / 2, 0, top, width, - Math.min(64, height - top), fid)); - fid = fid >= 0xfffe ? 1 : fid + 1; - } - return commands; - } - - /** - * A CFW mode-8 multi-segment payload (`[8][count]` then per-rect - * `[len16][mode-3 submsg]`) carrying several tight rectangle deltas instead of - * one bounding box, plus diagnostics. Each rect is applied to the firmware - * shadow with the panel push deferred, then presented once. Used when the change - * splits into regions whose bounding box wastes bytes (distant edits, or a sparse - * box); the caller falls back to the single-rect path when this returns null or - * isn't smaller. - */ - public static final class MultiRectPlan { - public final byte[] payload; - public final int rectCount; - public final int coveredBytes; // sum of rect region bytes, pre-compression - public final int nextFid; // fid to resume from (rectCount consumed) - - MultiRectPlan(byte[] payload, int rectCount, int coveredBytes, int nextFid) { - this.payload = payload; - this.rectCount = rectCount; - this.coveredBytes = coveredBytes; - this.nextFid = nextFid; - } - } - - // Break-even tuning for the rect splitter. Splitting adds ~15 fixed bytes per - // rect (seglen + mode-3 header + fid), so only split across gaps big enough to pay for that. - // Gaps are in the changed-mask's native units: whole 4bpp bytes (2px) for - // columns, rows for the vertical bands. Kept above the 4px/2px box alignment so - // aligned rects never overlap. - private static final int MULTI_RECT_V_GAP_ROWS = 4; - private static final int MULTI_RECT_H_GAP_BYTES = 6; - - /** - * Build a mode-8 multi-rect payload for the change between two same-size 4bpp - * frames, assigning consecutive frame ids starting at fidStart (each rect needs a - * distinct fid — the CFW skips duplicate fids). Returns null when the change is a - * single region (use the single-rect path), when it fragments past maxRects, or - * when the frames aren't comparable. - */ - public static MultiRectPlan buildMultiRectImagePayload(byte[] previous, byte[] next, int width, int height, int fidStart, int maxRects) { - int stride = (width + 1) >> 1; - if (width <= 0 || height <= 0 || previous == null || next == null - || previous.length != stride * height || next.length != stride * height) { - return null; - } - - List rects = computeSplitRects(previous, next, stride, width, height, maxRects); - if (rects == null || rects.size() < 2) { - return null; // single region (or too fragmented): caller uses the bbox path - } - - List subs = new ArrayList<>(rects.size()); - int coveredBytes = 0; - int fid = fidStart; - int total = 2; // [8][count] - for (int[] r : rects) { - byte[] sub = encodeMode3Rect(next, stride, r[0], r[1], r[2], r[3], fid); - subs.add(sub); - coveredBytes += (r[2] >> 1) * r[3]; - total += 2 + sub.length; // len16 + submsg - fid = (fid >= 0xfffe) ? 1 : fid + 1; - } - - byte[] out = new byte[total]; - out[0] = 8; - out[1] = (byte) rects.size(); - int pos = 2; - for (byte[] sub : subs) { - out[pos] = (byte) (sub.length & 0xff); - out[pos + 1] = (byte) ((sub.length >> 8) & 0xff); - pos += 2; - System.arraycopy(sub, 0, out, pos, sub.length); - pos += sub.length; - } - return new MultiRectPlan(out, rects.size(), coveredBytes, fid); - } - - /** - * Split the changed region between two packed 4bpp frames into a small set of - * aligned rectangles that together cover every changed pixel: maximal vertical - * bands of changed rows (merging gaps < V_GAP), each split into horizontal column - * clusters (merging gaps < H_GAP), with each cluster's rows tightened to where it - * actually changes. Rects are pixel-space {left,top,width,height}, left/width - * aligned to 4px and top/height to 2px. Returns null if there's no change or the - * split exceeds maxRects (caller falls back to a single bounding box). - */ - private static List computeSplitRects(byte[] previous, byte[] next, int stride, int width, int height, int maxRects) { - boolean[] rowChanged = new boolean[height]; - boolean anyChange = false; - for (int y = 0; y < height; y++) { - int off = y * stride; - for (int x = 0; x < stride; x++) { - if (previous[off + x] != next[off + x]) { - rowChanged[y] = true; - anyChange = true; - break; - } - } - } - if (!anyChange) { - return null; - } - - List rects = new ArrayList<>(); - boolean[] col = new boolean[stride]; - int y = 0; - while (y < height) { - if (!rowChanged[y]) { y++; continue; } - // Extend a vertical band across changed rows, hopping unchanged gaps < V_GAP. - int bandTop = y; - int bandBot = y; - int cur = y + 1; - while (cur < height) { - if (rowChanged[cur]) { bandBot = cur; cur++; continue; } - int g = cur; - while (g < height && !rowChanged[g]) g++; - if (g < height && (g - cur) < MULTI_RECT_V_GAP_ROWS) { cur = g; } else break; - } - - // Columns changed anywhere in the band. - Arrays.fill(col, false); - for (int yy = bandTop; yy <= bandBot; yy++) { - if (!rowChanged[yy]) continue; - int off = yy * stride; - for (int x = 0; x < stride; x++) { - if (previous[off + x] != next[off + x]) col[x] = true; - } - } - - // Split the band into horizontal clusters, hopping column gaps < H_GAP. - int x = 0; - while (x < stride) { - if (!col[x]) { x++; continue; } - int cL = x; - int cR = x; - int cx = x + 1; - while (cx < stride) { - if (col[cx]) { cR = cx; cx++; continue; } - int g = cx; - while (g < stride && !col[g]) g++; - if (g < stride && (g - cx) < MULTI_RECT_H_GAP_BYTES) { cx = g; } else break; - } - - // Tighten this cluster's rows to those that change within [cL,cR]. - int tTop = height; - int tBot = -1; - for (int yy = bandTop; yy <= bandBot; yy++) { - if (!rowChanged[yy]) continue; - int off = yy * stride; - for (int xx = cL; xx <= cR; xx++) { - if (previous[off + xx] != next[off + xx]) { - if (yy < tTop) tTop = yy; - tBot = yy; - break; - } - } - } - if (tBot >= 0) { - int left = (cL * 2) & ~3; - int rightExclusive = Math.min(width, (((cR + 1) * 2) + 3) & ~3); - int top = tTop & ~1; - int bottomExclusive = Math.min(height, (tBot + 2) & ~1); - rects.add(new int[]{left, top, rightExclusive - left, bottomExclusive - top}); - if (rects.size() > maxRects) { - return null; // too fragmented: a single bounding box is simpler - } - } - x = cR + 1; - } - y = bandBot + 1; - } - return rects; - } - - /** - * Run-length encode headerless 4bpp pixels for CFW load_image_z mode 6. - * Wire format: [6][rle(4bpp pixels)]. Always use mode 6: the logical - * image can be larger than its EvenHub carrier, so a raw BMP fallback would - * carry dimensions the legacy container loader cannot accept. - */ - static byte[] maybeCompress(byte[] packed, int width, int height) { - if (packed == null || packed.length == 0) { - return packed; - } - byte[] z = rleEncode(packed); - byte[] out = new byte[z.length + 1]; - out[0] = 6; - System.arraycopy(z, 0, out, 1, z.length); - return out; - } - - /** - * Run-length encode packed 4bpp pixels for CFW modes 3 and 6, whose payload is - * RLE tokens; deflate belongs to the transport. Runs are over the pixel NIBBLES of - * {@code pix} in wire order (high nibble = left pixel), including the pad nibble - * that ends each row at odd widths — i.e. {@code pix} read as 2*length nibbles. - * One token is: - *
-     *   [cnt4|color4]                 cnt 1..15
-     *   [0|color4][cnt8]              cnt 1..255
-     *   [0|color4][0][cntLo][cntHi]   cnt 1..65535, little-endian
-     * 
- * with the low nibble always the color; runs longer than 65535 split across - * tokens. Worst case (every nibble its own run) is exactly one byte per nibble, - * which is what the buffer is sized for. - */ - static byte[] rleEncode(byte[] pix) { - int n = pix.length * 2; - byte[] out = new byte[n]; - int o = 0; - int i = 0; - while (i < n) { - int v = nibbleAt(pix, i); - int j = i + 1; - while (j < n && nibbleAt(pix, j) == v) j++; - int run = j - i; - while (run > 0) { - int c = Math.min(run, 0xffff); - if (c <= 15) { - out[o++] = (byte) ((c << 4) | v); - } else if (c <= 255) { - out[o++] = (byte) v; // high nibble 0 = escape to an 8-bit count - out[o++] = (byte) c; - } else { - out[o++] = (byte) v; - out[o++] = 0; // 8-bit count 0 = escape to a 16-bit count - out[o++] = (byte) (c & 0xff); - out[o++] = (byte) (c >> 8); - } - run -= c; - } - i = j; - } - return Arrays.copyOf(out, o); - } - - private static int nibbleAt(byte[] pix, int i) { - int b = pix[i >> 1] & 0xff; - return (i & 1) != 0 ? (b & 0x0f) : (b >> 4); - } - - public static final class ImageUpdateStats { - final int paintMs; - final int tileCount; - final int frameId; - long firstWriteStartedAtMs; - - ImageUpdateStats(int paintMs, int tileCount, int frameId) { - this.paintMs = Math.max(0, paintMs); - this.tileCount = tileCount; - this.frameId = frameId; - } - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/BleMagicPool.java b/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/BleMagicPool.java deleted file mode 100644 index bd6afd79..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/BleMagicPool.java +++ /dev/null @@ -1,69 +0,0 @@ -package com.faceclaw.app; -import java.util.ArrayDeque; -import java.util.HashMap; -import java.util.Map; -import android.os.SystemClock; - -/** - * Protobuf messages contain a 1-byte identifier that is used to identify - * which message is referred to in ACK messages. We keep track of which - * identifiers are in use for inflight messages, with some metadata about - * what the message was. We allocate identifiers with an LRU policy so that - * if we release a message's identifier because it timed out, we can still - * detect late ACKs if it hasn't been reused yet. - */ -public final class BleMagicPool { - static final int MIN_MAGIC = 100; - static final int MAX_MAGIC = 255; - - private final ArrayDeque available = new ArrayDeque<>(); - private final boolean[] allocated = new boolean[256]; - private final Map releaseRecords = new HashMap<>(); - - BleMagicPool() { - for (int magic = MIN_MAGIC; magic <= MAX_MAGIC; magic++) { - available.addLast(magic); - } - } - - synchronized int allocate() { - Integer magic = available.pollFirst(); - if (magic == null) { - throw new IllegalStateException("no BLE magic values available"); - } - allocated[magic] = true; - return magic; - } - - synchronized void release(int sid, int magic, String label, String reason) { - if (magic < MIN_MAGIC || magic > MAX_MAGIC) { - return; - } - releaseRecords.put(key(sid, magic), new ReleaseRecord(label, reason, SystemClock.elapsedRealtime())); - if (!allocated[magic]) { - return; - } - allocated[magic] = false; - available.addLast(magic); - } - - synchronized ReleaseRecord getReleaseRecord(int sid, int magic) { - return releaseRecords.get(key(sid, magic)); - } - - private static String key(int sid, int magic) { - return sid + ":" + magic; - } - - public static final class ReleaseRecord { - final String label; - final String reason; - final long releasedAtMs; - - ReleaseRecord(String label, String reason, long releasedAtMs) { - this.label = label == null ? "" : label; - this.reason = reason == null ? "" : reason; - this.releasedAtMs = releasedAtMs; - } - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/BleProtocol.java b/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/BleProtocol.java deleted file mode 100644 index 6031f24d..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/BleProtocol.java +++ /dev/null @@ -1,1240 +0,0 @@ -package com.faceclaw.app; - -import java.io.ByteArrayOutputStream; -import java.nio.charset.StandardCharsets; -import java.util.ArrayList; -import java.util.Arrays; -import java.util.List; -import java.util.UUID; - -/** - * BleProtocol: Functions for generating and parsing messages when speaking to - * the Even Realities G2. Does _not_ include code for actually sending anything; - * for that, see FaceclawBleCommunicator. - * - * Most message formats are protobufs. For schemas, check g2-kit-unofficial. - */ -public class BleProtocol { - public static final String WRITE_CHAR_UUID = "00002760-08c2-11e1-9073-0e8ac72e5401"; - public static final String NOTIFY_CHAR_UUID = "00002760-08c2-11e1-9073-0e8ac72e5402"; - // Firmware-data service (svc ...e1001): the OTA transfer channel, distinct - // from the EvenHub write/notify chars above (which the flasher reuses only - // for the keepalive heartbeat). - public static final String OTA_DATA_WRITE_UUID = "00002760-08c2-11e1-9073-0e8ac72e0001"; - public static final String OTA_DATA_NOTIFY_UUID = "00002760-08c2-11e1-9073-0e8ac72e0002"; - public static final String RENDER_NOTIFY_UUID = "00002760-08c2-11e1-9073-0e8ac72e6402"; - public static final String R1_PHONE_NOTIFY_CHAR_UUID = "bae80011-4f05-4503-8e65-3af1f7329d1f"; - public static final String R1_NOTIFY_CHAR_UUID = "bae80013-4f05-4503-8e65-3af1f7329d1f"; - - public static final int PRELUDE_ACK_SID = 0x01; - public static final int PRELUDE_ACK_MAGIC = 156; - /** - * DEVICE_SETTINGS security-auth channel. Firmware 2.2.9 enforces completing - * this exchange shortly after a GATT connection opens (a ~30 s deadline - * closes unauthenticated links) and gates query responses on it; the - * message itself exists back to the 2.2.4 era, so sending it is safe on all - * stock versions. See ../notes/ble-connections-2.2.9.md. - */ - public static final int SID_SECURITY_AUTH = 0x80; - public static final int FLAG_SECURITY_AUTH = 0x00; - private static final int SECURITY_AUTH_CMD = 4; - public static final int SID_APP_LAUNCH = 0x01; - public static final int SID_EVENHUB = 0xe0; - public static final int SID_UI_SETTING = 0x09; - public static final int SID_STATE_CHANGE = 0x0d; - public static final int SID_ONBOARDING = 0x10; - /** G2SettingPackage.commandId for device-initiated pushes (vs. 2 = app read). */ - public static final int SETTINGS_CMD_DEVICE_SEND_TO_APP = 3; - // Private Faceclaw/CFW wake-takeover protocol. Both payloads are unknown - // protobuf fields to stock implementations, so they are safely ignored. - public static final int FACECLAW_WAKE_CONTROL_FIELD = 101; - public static final int FACECLAW_WAKE_EVENT_FIELD = 102; - /** - * CFW mic_control: host writes an ['M','C',ver,op,...] record as settings - * field 103; each temple - * reports a 21-byte ['M','C',ver,...] status as field 104, both appended - * to settings read responses and as standalone commandId=3 pushes. - */ - public static final int FACECLAW_MIC_CONTROL_FIELD = 103; - public static final int FACECLAW_MIC_STATUS_FIELD = 104; - /** - * CFW als_sensor: ambient-light reports on settings-channel field 105, 24-byte ['A','L',ver,reason,...] records from - * the master temple (decoded in app/native/ambient-light.ts). - */ - public static final int FACECLAW_ALS_REPORT_FIELD = 105; - public static final int FACECLAW_WAKE_OP_ACQUIRE = 1; - public static final int FACECLAW_WAKE_OP_RELEASE = 2; - public static final int FACECLAW_WAKE_OP_CLAIM = 3; - public static final int FACECLAW_WAKE_OP_READY = 4; - public static final int FACECLAW_FB_OP_ACQUIRE = 5; - public static final int FACECLAW_FB_OP_RELEASE = 6; - public static final int FACECLAW_WEAR_OP_QUERY = 7; - public static final int CFW_IMAGE_MODE_CLEANUP = 11; - private static final int FACECLAW_WAKE_EVENT = 1; - // Field-102 deferred wake from the IMU head-up (Faceclaw firmware revision - // 3+); same nonce handshake as the double-tap wake event 1. - public static final int FACECLAW_WAKE_EVENT_HEAD_UP = 5; - // Field-102 idle-gesture events (Faceclaw firmware revision 2+): gestures the - // stock display thread drops while no app is on screen, forwarded while the - // wake lease is held. Their last two bytes are the raw touch source and 0. - public static final int FACECLAW_GESTURE_EVENT_TAP = 2; - public static final int FACECLAW_GESTURE_EVENT_LONG_PRESS = 3; - public static final int FACECLAW_GESTURE_EVENT_LONG_PRESS_RELEASE = 4; - // The display thread's raw touch sources, as the firmware reports them. - private static final int FACECLAW_RAW_SOURCE_LEFT_TEMPLE = 0; - private static final int FACECLAW_RAW_SOURCE_RIGHT_TEMPLE = 1; - private static final int FACECLAW_RAW_SOURCE_RING = 4; - private static final int FACECLAW_WAKE_PROTOCOL_VERSION = 1; - // UI_FOREGROUND_EVEN_AI_ID: the stock "Even AI" assistant app. It is a - // FOREGROUND app, whereas EvenHub (and therefore faceclaw) is the - // BACKGROUND app -- which is why an Even AI launch draws over us. - // Payload is g2.even_ai.EvenAIDataPackage (see - // g2-kit-unofficial/ble/gen/even_ai_pb.ts). - public static final int SID_EVEN_AI = 0x07; - public static final int SID_NAVIGATION = 0x08; - public static final int NAV_CMD_COMPASS_CHANGED = 15; - public static final int NAV_CMD_COMPASS_CALIBRATION_STARTED = 16; - public static final int NAV_CMD_COMPASS_CALIBRATION_COMPLETE = 17; - // eEvenAICommandId - public static final int EVEN_AI_CMD_CTRL = 1; - // eEvenAIStatus, carried in EvenAIDataPackage.ctrl.status (field 3, sub 1). - // WAKE_UP is the on-glasses "Hey Even" wakeword firing; ENTER is a manual - // entry (touch/double-tap), so the two are distinguishable. - public static final int EVEN_AI_STATUS_WAKE_UP = 1; - public static final int EVEN_AI_STATUS_ENTER = 2; - public static final int EVEN_AI_STATUS_EXIT = 3; - public static final int FLAG_REQUEST = 0x20; - public static final int FLAG_NOTIFY = 0x01; - public static final int FLAG_NOTIFY_ALT = 0x06; - public static final int CMD_AUDIO_CONTROL = 15; - // EvenHub_Cmd_List.APP_REQUEST_OPEN_IMU_PACKET; the accelerometer stream is - // gated behind this control message (ImuCtrl, field 22 of the main ctx). - public static final int CMD_OPEN_IMU = 19; - - public static final int EVENT_CLICK = 0; - public static final int EVENT_SCROLL_TOP = 1; - public static final int EVENT_SCROLL_BOTTOM = 2; - public static final int EVENT_DOUBLE_CLICK = 3; - public static final int EVENT_FOREGROUND_ENTER = 4; - public static final int EVENT_FOREGROUND_EXIT = 5; - public static final int EVENT_ABNORMAL_EXIT = 6; - public static final int EVENT_SYSTEM_EXIT = 7; - public static final int EVENT_IMU_DATA_REPORT = 8; - public static final int EVENT_RING_LONG_PRESS = 9; - public static final int EVENT_RING_LONG_PRESS_RELEASE = 10; - // CFW extension: G2 2.2.9 tap-then-hold gesture forwarded to the phone. - public static final int EVENT_SHORT_THEN_LONG_PRESS = 11; - // CFW extension (firmware revision 3+): the IMU head-up, forwarded as a - // sys-event while an EvenHub page is on screen (soft sleep). - public static final int EVENT_HEAD_UP = 12; - - public static final int EVENT_SOURCE_GLASSES_R = 1; - public static final int EVENT_SOURCE_RING = 2; - public static final int EVENT_SOURCE_GLASSES_L = 3; - - public static final UUID CCCD_UUID = UUID.fromString("00002902-0000-1000-8000-00805f9b34fb"); - - // App-launch message. Protobuf contents come from a capture (done in g2-kit-unofficial) - // so the actual meaning of most fields isn't known. The standard protobuf - // wire format still lets us identify field numbers, wire types, and lengths. - public static final byte[] PRELUDE_F5872_PAYLOAD = buildPreludeF5872Payload(); - public static final byte[] PRELUDE_F5872 = - framePb(PRELUDE_F5872_PAYLOAD, SID_APP_LAUNCH, FLAG_REQUEST, 0x92).getFirst(); - - private static byte[] buildPreludeF5872Payload() { - byte[] field4 = encodeMessageField(3, - encodeMessageField(2, - encodeMessageField(2, concat(CollectionUtils.listOf( - encodeVarintField(1, 0), - encodeVarintField(2, 0) - ))) - ) - ); - return concat(CollectionUtils.listOf( - encodeVarintField(1, 2), // known app-launch type/Cmd - encodeVarintField(2, PRELUDE_ACK_MAGIC), - encodeMessageField(4, field4) - )); - } - - public static List framePb(byte[] pb, int sid, int flag, int seq) { - int chunkSize = 232; - byte[] crc = crcBytesLe(pb); - int totalWithCrc = pb.length + 2; - int totalFrags = Math.max(1, (int) Math.ceil(totalWithCrc / (double) chunkSize)); - List frames = new ArrayList<>(totalFrags); - byte[] payload = Arrays.copyOf(pb, totalWithCrc); - payload[pb.length] = crc[0]; - payload[pb.length + 1] = crc[1]; - for (int i = 0; i < totalFrags; i++) { - int offset = i * chunkSize; - byte[] chunk = Arrays.copyOfRange(payload, offset, Math.min(offset + chunkSize, payload.length)); - byte[] frame = new byte[8 + chunk.length]; - frame[0] = (byte) 0xaa; - frame[1] = 0x21; - frame[2] = (byte) (seq & 0xff); - frame[3] = (byte) (chunk.length & 0xff); - frame[4] = (byte) (totalFrags & 0xff); - frame[5] = (byte) ((i + 1) & 0xff); - frame[6] = (byte) (sid & 0xff); - frame[7] = (byte) (flag & 0xff); - System.arraycopy(chunk, 0, frame, 8, chunk.length); - frames.add(frame); - } - return frames; - } - - - /** Retain the text container for forwarded inputs, without an image container. */ - public static byte[] buildCreateInputPage(int magic) { - List innerParts = new ArrayList<>(); - innerParts.add(encodeVarintField(1, 1)); - innerParts.add(encodeMessageField(3, encodeTextObject("dashboard", 1, 0, 0, 576, 288, " ", true))); - innerParts.add(encodeVarintField(5, 10000)); - byte[] inner = concat(innerParts); - return wrapEvenHub(0, magic, 3, inner); - } - - public static byte[] buildDashboardTextUpgrade(int magic) { - List inner = new ArrayList<>(); - inner.add(encodeVarintField(1, 1)); - inner.add(encodeStringField(2, "dashboard")); - inner.add(encodeVarintField(3, 0)); - inner.add(encodeVarintField(4, 1)); - inner.add(encodeStringField(5, " ")); - return wrapEvenHub(5, magic, 9, concat(inner)); - } - - public static byte[] buildImageRawData(ImageTileOptions tile, int sessionId, int totalSize, ImageFragment fragment, int magic) { - List inner = new ArrayList<>(); - inner.add(encodeVarintField(1, tile.containerId)); - inner.add(encodeStringField(2, tile.name)); - //inner.add(encodeVarintField(3, sessionId)); - inner.add(encodeVarintField(3, tile.containerId)); - inner.add(encodeVarintField(4, totalSize)); - // CompressMode stays 0: the CFW's zlib path is detected from the buffer's - // zlib header at BMP-load time, and frag_write must copy our deflated bytes - // VERBATIM (CompressMode!=0 would route them through the 1bpp expander). - inner.add(encodeVarintField(5, 0)); //compression - inner.add(encodeVarintField(6, fragment.index)); - inner.add(encodeVarintField(7, fragment.size)); - inner.add(encodeBytesField(8, fragment.data)); - return wrapEvenHub(3, magic, 5, concat(inner)); - } - - public static byte[] buildHeartbeat(int magic) { - return wrapEvenHub(12, magic, 14, encodeVarintField(1, 0)); - } - - /** - * Cmd=0 CreateStartUpPage carrying a text container (the message) plus a - * list container (the selectable rows) in one page. Uses stock-firmware-safe - * geometry (each container within the stock ~280x130 container-size cap; the - * CFW is what lifts that to 576x288), so this works before flashing. The - * selected row comes back as an async list event — see parseListSelection. - */ - public static byte[] buildCreatePromptPage( - int magic, - String textName, - int textContainerId, - String warningText, - String listName, - int listContainerId, - String[] items - ) { - List inner = new ArrayList<>(); - inner.add(encodeVarintField(1, 2)); // ContainerTotalNum: 1 text + 1 list - inner.add(encodeMessageField(2, encodeListObject(listName, listContainerId, 0, 150, 280, 120, items, true))); - inner.add(encodeMessageField(3, encodeTextObject(textName, textContainerId, 0, 0, 280, 130, warningText, false))); - inner.add(encodeVarintField(5, 10000)); // widgetId - return wrapEvenHub(0, magic, 3, concat(inner)); - } - - public static byte[] encodeListObject( - String name, - int containerId, - int x, - int y, - int width, - int height, - String[] items, - boolean captureEvents - ) { - List parts = new ArrayList<>(); - parts.add(encodeVarintField(1, x)); - parts.add(encodeVarintField(2, y)); - parts.add(encodeVarintField(3, width)); - parts.add(encodeVarintField(4, height)); - parts.add(encodeVarintField(9, containerId)); - parts.add(encodeStringField(10, name)); - parts.add(encodeMessageField(11, encodeListItemContainer(items))); - if (captureEvents) { - parts.add(encodeVarintField(12, 1)); - } - return concat(parts); - } - - private static byte[] encodeListItemContainer(String[] items) { - List parts = new ArrayList<>(); - parts.add(encodeVarintField(1, items.length)); // ItemCount - parts.add(encodeVarintField(3, 1)); // IsItemSelectBorderEn - for (String item : items) { - parts.add(encodeStringField(4, item)); // repeated ItemName - } - return concat(parts); - } - - /** - * Decode a list-selection async event (sid=0xe0, flag=0x01/0x06). Returns - * null if the frame is not a list event. `itemIndex` is 0-based into the - * ItemName array the list was built with; `eventType` is EVENT_CLICK for a - * confirmed selection (scroll/highlight changes arrive with other types). - */ - public static ListSelection parseListSelection(ParsedFrame frame) { - byte[] pb = stripTrailingCrc(frame.pb); - byte[] deviceEvent = readFieldBytes(pb, 13); - if (deviceEvent == null) { - return null; - } - byte[] listEvent = readFieldBytes(deviceEvent, 1); - if (listEvent == null) { - return null; - } - return new ListSelection( - readStringFieldValue(listEvent, 2), - readStringFieldValue(listEvent, 3), - readVarintFieldValue(listEvent, 4, -1), - readVarintFieldValue(listEvent, 5, EVENT_CLICK) - ); - } - - public static byte[] buildAudioControl(int magic, boolean enable) { - return wrapEvenHub(CMD_AUDIO_CONTROL, magic, 18, encodeVarintField(1, enable ? 1 : 0)); - } - - public static byte[] buildShutdown(int magic, int exitMode) { - return wrapEvenHub(9, magic, 11, encodeVarintField(1, exitMode)); - } - - /** - * IMU control (ImuCtrl = field 22 of the main ctx). IMU_CtrlCmd carries - * IMUReportEn (field 1) and reportFrq (field 2). reportFrq is only - * meaningful when enabling; on disable we send just the enable flag. - */ - public static byte[] buildImuControl(int magic, boolean enable, int reportFrq) { - List inner = new ArrayList<>(); - inner.add(encodeVarintField(1, enable ? 1 : 0)); - if (enable && reportFrq > 0) { - inner.add(encodeVarintField(2, reportFrq)); - } - return wrapEvenHub(CMD_OPEN_IMU, magic, 22, concat(inner)); - } - - /** - * Set the lens brightness: G2SettingPackage{commandId=1 (DeviceReceiveInfo), - * deviceReceiveInfoFromApp(3){deviceReceiveBrightness(1){autoAdjust(1), - * brightnessLevel(2)}}} on sid 0x09. brightnessLevel is 0-100 (nonlinear; - * 0 is dim-but-visible, not off). When autoAdjust is set the ambient-light - * sensor drives brightness, so the level field is omitted; otherwise the - * level is always encoded (explicit zero included) so brightnessLevel=0 - * reaches the wire. - */ - public static byte[] buildSetBrightness(int magic, boolean autoAdjust, int brightnessLevel) { - List brightness = new ArrayList<>(); - brightness.add(encodeVarintField(1, autoAdjust ? 1 : 0)); - if (!autoAdjust) { - brightness.add(encodeVarintField(2, brightnessLevel)); - } - return concat(CollectionUtils.listOf( - encodeVarintField(1, 1), - encodeVarintField(2, magic), - encodeMessageField(3, encodeMessageField(1, concat(brightness))) - )); - } - - /** Enable the firmware's wear detector (DeviceReceiveInfoFromAPP field 5). */ - public static byte[] buildSetWearDetection(int magic, boolean enabled) { - byte[] wear = encodeVarintField(1, enabled ? 1 : 0); - return concat(CollectionUtils.listOf( - encodeVarintField(1, 1), - encodeVarintField(2, magic), - encodeMessageField(3, encodeMessageField(5, wear)) - )); - } - - /** - * The application authentication request: DEVICE_SETTINGS/AUTHENTICATION(4) - * on sid 0x80, flag 0x00. Carries no key material — it arms the firmware's - * "security auth" flag; the firmware sends the success notification once - * the flag is set AND the BLE link is encrypted (SMP pairing/bond - * restoration, handled by the OS below GATT, possibly after a pairing - * prompt). Protobuf: f1=4 (command), f2=magic, f3={f1=1, f2=4}. - */ - public static byte[] buildAuthenticationRequest(int magic) { - byte[] auth = concat(CollectionUtils.listOf( - encodeVarintField(1, 1), - encodeVarintField(2, SECURITY_AUTH_CMD) - )); - return concat(CollectionUtils.listOf( - encodeVarintField(1, SECURITY_AUTH_CMD), - encodeVarintField(2, magic), - encodeMessageField(3, auth) - )); - } - - /** - * True when `pb` (trailing CRC still attached) is the success notification - * for the authentication request sent with `magic`: command 4, the same - * magic, and an EMPTY field-3 result message (`1a 00` — the omitted result - * code defaults to zero). A GATT write completing is NOT success; only this - * notification is. - */ - public static boolean isAuthenticationSuccess(byte[] pb, int magic) { - if (pb == null) { - return false; - } - byte[] root = stripTrailingCrc(pb); - if (readVarintFieldValue(root, 1, -1) != SECURITY_AUTH_CMD) { - return false; - } - if (readVarintFieldValue(root, 2, -1) != magic) { - return false; - } - byte[] result = readFieldBytes(root, 3); - return result != null && result.length == 0; - } - - public static byte[] buildSettingsQuery(int magic) { - byte[] request = encodeVarintField(1, 1); - return concat(CollectionUtils.listOf( - encodeVarintField(1, 2), - encodeVarintField(2, magic), - encodeMessageField(4, request) - )); - } - - /** - * Build the CFW-only wake lease control package. Magic zero deliberately - * makes this fire-and-forget: the firmware consumes field 101 before its - * stock nanopb decoder discards the unknown field. - */ - public static byte[] buildFaceclawWakeControl(int operation, int nonce) { - byte[] control = new byte[] { - 'F', - 'C', - (byte) FACECLAW_WAKE_PROTOCOL_VERSION, - (byte) operation, - (byte) (nonce & 0xff), - (byte) ((nonce >>> 8) & 0xff) - }; - return concat(CollectionUtils.listOf( - encodeVarintField(1, 1), - encodeVarintField(2, 0), - encodeBytesField(FACECLAW_WAKE_CONTROL_FIELD, control) - )); - } - - /** - * Wrap an already-encoded ['M','C',ver,op,...] mic-control record as a - * settings write carrying CFW field 103. Magic zero makes it - * fire-and-forget like the wake lease: the firmware consumes the field - * before its stock nanopb decoder discards the unknown tag, and the - * "ack" is the field-104 status notify that follows. - */ - public static byte[] buildFaceclawMicControl(byte[] record) { - return concat(CollectionUtils.listOf( - encodeVarintField(1, 1), - encodeVarintField(2, 0), - encodeBytesField(FACECLAW_MIC_CONTROL_FIELD, record) - )); - } - - /** - * Extract the CFW mic status record (field 104) from a settings frame, or - * null when absent. The 21-byte body layout is decoded on the TS side; - * here we only validate the 'M','C',version prelude. - */ - public static byte[] parseFaceclawMicStatus(byte[] pb) { - if (pb == null) { - return null; - } - byte[] body = readFieldBytes(stripTrailingCrc(pb), FACECLAW_MIC_STATUS_FIELD); - if (body == null - || body.length < 3 - || body[0] != 'M' - || body[1] != 'C') { - return null; - } - return body; - } - - /** - * Return the raw CFW ambient-light report from a sid-0x09 frame, or null - * when this is an ordinary settings frame. Only the 'A','L',version prelude - * is validated here; the fields are decoded on the TS side. - */ - public static byte[] parseFaceclawAlsReport(byte[] pb) { - if (pb == null) { - return null; - } - byte[] body = readFieldBytes(stripTrailingCrc(pb), FACECLAW_ALS_REPORT_FIELD); - if (body == null - || body.length < 24 - || body[0] != 'A' - || body[1] != 'L' - || (body[2] & 0xff) != 1) { - return null; - } - return body; - } - - /** Field 106: RB/version 1/flags/percentage, from the CFW ring-battery cache. */ - public static RingBatterySnapshot parseRingBattery(byte[] pb) { - if (pb == null) return null; - byte[] body = readFieldBytes(stripTrailingCrc(pb), 106); - if (body == null || body.length != 5 || body[0] != 'R' || body[1] != 'B' - || body[2] != 1) return null; - int flags = body[3] & 0xff; - int level = body[4] & 0xff; - if ((flags & ~7) != 0) return null; - if ((flags & 2) != 0) { - if ((flags & 1) == 0 || level > 100) return null; - return new RingBatterySnapshot(level, (flags & 4) != 0 ? 1 : 0); - } - if (level != 255 || (flags & 4) != 0) return null; - return new RingBatterySnapshot(-1, -1); - } - - public static final class RingBatterySnapshot { - final int battery; - final int charging; - RingBatterySnapshot(int battery, int charging) { - this.battery = battery; - this.charging = charging; - } - } - - /** - * Return the uint16 wake nonce from a CFW field-102 deferred-wake - * notification (double tap or head-up), or -1 when this is an ordinary - * settings frame (idle-gesture events included). - */ - public static int parseFaceclawWakeEvent(byte[] pb) { - byte[] event = faceclawWakeEventBytes(pb); - return event == null ? -1 : (event[4] & 0xff) | ((event[5] & 0xff) << 8); - } - - /** - * Which gesture a CFW deferred-wake notification reports: 1 (double tap) - * or FACECLAW_WAKE_EVENT_HEAD_UP; -1 when the frame is not a wake event. - */ - public static int parseFaceclawWakeEventCode(byte[] pb) { - byte[] event = faceclawWakeEventBytes(pb); - return event == null ? -1 : (event[3] & 0xff); - } - - private static byte[] faceclawWakeEventBytes(byte[] pb) { - if (pb == null) { - return null; - } - byte[] event = readFieldBytes(stripTrailingCrc(pb), FACECLAW_WAKE_EVENT_FIELD); - if (event == null - || event.length != 6 - || event[0] != 'F' - || event[1] != 'C' - || (event[2] & 0xff) != FACECLAW_WAKE_PROTOCOL_VERSION) { - return null; - } - int code = event[3] & 0xff; - return code == FACECLAW_WAKE_EVENT || code == FACECLAW_WAKE_EVENT_HEAD_UP ? event : null; - } - - /** An idle gesture from a CFW field-102 notification, in EvenHub sys-event terms. */ - public static final class FaceclawGestureEvent { - public final int eventType; - public final int eventSource; - - FaceclawGestureEvent(int eventType, int eventSource) { - this.eventType = eventType; - this.eventSource = eventSource; - } - } - - /** - * Decode a CFW field-102 idle-gesture event (tap, long press, release - * while no app is on screen) into the EvenHub sys-event type and source - * the same gesture would carry from a live page, or null when the frame - * is not one (ordinary settings frames and the double-tap wake event - * included). - */ - public static FaceclawGestureEvent parseFaceclawGestureEvent(byte[] pb) { - if (pb == null) { - return null; - } - byte[] event = readFieldBytes(stripTrailingCrc(pb), FACECLAW_WAKE_EVENT_FIELD); - if (event == null - || event.length != 6 - || event[0] != 'F' - || event[1] != 'C' - || (event[2] & 0xff) != FACECLAW_WAKE_PROTOCOL_VERSION) { - return null; - } - int eventType; - switch (event[3] & 0xff) { - case FACECLAW_GESTURE_EVENT_TAP: - eventType = EVENT_CLICK; - break; - case FACECLAW_GESTURE_EVENT_LONG_PRESS: - eventType = EVENT_RING_LONG_PRESS; - break; - case FACECLAW_GESTURE_EVENT_LONG_PRESS_RELEASE: - eventType = EVENT_RING_LONG_PRESS_RELEASE; - break; - default: - return null; - } - int eventSource; - switch (event[4] & 0xff) { - case FACECLAW_RAW_SOURCE_LEFT_TEMPLE: - eventSource = EVENT_SOURCE_GLASSES_L; - break; - case FACECLAW_RAW_SOURCE_RIGHT_TEMPLE: - eventSource = EVENT_SOURCE_GLASSES_R; - break; - case FACECLAW_RAW_SOURCE_RING: - eventSource = EVENT_SOURCE_RING; - break; - default: - eventSource = 0; - break; - } - return new FaceclawGestureEvent(eventType, eventSource); - } - - /** - * Decode OnboardingDataPackage EVENT/GLS_WEAR_STATUS. Unlike most async - * G2 traffic, stock firmware sends this event with flag 0x00, so callers - * must recognize it by sid and protobuf shape rather than notify flag. - * Returns 0/1, or -1 when the frame is not a wear event. - */ - public static int parseWearState(ParsedFrame frame) { - if (frame == null || !frame.ok || frame.sid != SID_ONBOARDING) { - return -1; - } - byte[] root = stripTrailingCrc(frame.pb); - if (readVarintFieldValue(root, 1, -1) != 3) { - return -1; - } - byte[] event = readFieldBytes(root, 5); - if (event == null || readVarintFieldValue(event, 1, -1) != 1) { - return -1; - } - int wearStatus = readVarintFieldValue(event, 2, -1); - return wearStatus == 0 || wearStatus == 1 ? wearStatus : -1; - } - - public static BatterySnapshot parseSettingsBattery(byte[] pb) { - byte[] root = stripTrailingCrc(pb); - byte[] request = readFieldBytes(root, 4); - if (request == null) { - return null; - } - int battery = readVarintFieldValue(request, 12, -1); - int charging = readVarintFieldValue(request, 13, -1); - int silentMode = readVarintFieldValue(request, 14, -1); - if (battery < 0) { - return null; - } - return new BatterySnapshot(battery, charging, silentMode); - } - - /** - * Silent mode from an unsolicited settings push. The wearer toggles silent - * mode by long-pressing both touchpads at once; the firmware then sends - * G2SettingPackage{commandId=3 (DeviceSendToAPP), deviceSendInfoToApp(5){ - * silentModeSwitch(2)}} on sid 0x09, with a magic it picked itself, so this - * arrives outside the request/ack flow. - * - * Returns -1 when the frame is not such a push. Ordinary settings-read acks - * (the battery poll) carry commandId=2 and deviceReceiveRequestFromApp in - * field 4, so they never match and stay on the normal ack path. - */ - public static int parseSilentModePush(byte[] pb) { - if (pb == null) { - return -1; - } - byte[] root = stripTrailingCrc(pb); - if (readVarintFieldValue(root, 1, -1) != SETTINGS_CMD_DEVICE_SEND_TO_APP) { - return -1; - } - byte[] info = readFieldBytes(root, 5); - if (info == null) { - return -1; - } - return readVarintFieldValue(info, 2, -1); - } - - /** - * Firmware versions and the firmware-extension string from a settings - * READ ack. Versions are fields 5/6 of the deviceReceiveRequestFromApp - * submessage (field 4); Faceclaw's custom firmware additionally appends - * top-level field 100 with its revision ("Faceclaw/"; older builds sent - * "EVENCFW/ "), which stock firmware never sends. Returns null - * when the ack carries none of it. Compatibility is judged on the TS side - * (app/g2/firmware-compat.ts); Java only needs to know whether the firmware - * is ours at all. - */ - public static FirmwareInfo parseSettingsFirmwareInfo(byte[] pb) { - byte[] root = stripTrailingCrc(pb); - byte[] request = readFieldBytes(root, 4); - if (request == null) { - return null; - } - String leftVersion = readStringFieldValue(request, 5); - String rightVersion = readStringFieldValue(request, 6); - String extension = readStringFieldValue(root, 100); - if (leftVersion.isEmpty() && rightVersion.isEmpty() && extension.isEmpty()) { - return null; - } - return new FirmwareInfo(leftVersion, rightVersion, extension); - } - - public static byte[] wrapEvenHub(int cmd, int magic, int innerFieldNumber, byte[] inner) { - List parts = new ArrayList<>(); - parts.add(encodeVarintField(1, cmd)); - parts.add(encodeVarintField(2, magic)); - parts.add(encodeMessageField(innerFieldNumber, inner)); - return concat(parts); - } - - public static byte[] encodeTextObject(String name, int containerId, int x, int y, int width, int height, String text, boolean captureEvents) { - List parts = new ArrayList<>(); - parts.add(encodeVarintField(1, x)); - parts.add(encodeVarintField(2, y)); - parts.add(encodeVarintField(3, width)); - parts.add(encodeVarintField(4, height)); - parts.add(encodeVarintField(9, containerId)); - parts.add(encodeStringField(10, name)); - if (captureEvents) { - parts.add(encodeVarintField(11, 1)); - } - parts.add(encodeStringField(12, text)); - return concat(parts); - } - - public static byte[] encodeImageObject(ImageTileOptions tile) { - List parts = new ArrayList<>(); - parts.add(encodeVarintField(1, tile.x)); - parts.add(encodeVarintField(2, tile.y)); - parts.add(encodeVarintField(3, tile.width)); - parts.add(encodeVarintField(4, tile.height)); - parts.add(encodeVarintField(5, tile.containerId)); - parts.add(encodeStringField(6, tile.name)); - return concat(parts); - } - - private static byte[] concat(List parts) { - ByteArrayOutputStream out = new ByteArrayOutputStream(); - for (byte[] part : parts) { - if (part != null && part.length > 0) { - out.write(part, 0, part.length); - } - } - return out.toByteArray(); - } - - private static byte[] encodeVarintField(int fieldNumber, int value) { - return concat(CollectionUtils.listOf(encodeKey(fieldNumber, 0), encodeVarint(value))); - } - - private static byte[] encodeStringField(int fieldNumber, String value) { - byte[] bytes = value == null ? new byte[0] : value.getBytes(StandardCharsets.UTF_8); - return concat(CollectionUtils.listOf(encodeKey(fieldNumber, 2), encodeVarint(bytes.length), bytes)); - } - - private static byte[] encodeBytesField(int fieldNumber, byte[] value) { - byte[] bytes = value == null ? new byte[0] : value; - return concat(CollectionUtils.listOf(encodeKey(fieldNumber, 2), encodeVarint(bytes.length), bytes)); - } - - private static byte[] encodeMessageField(int fieldNumber, byte[] value) { - byte[] bytes = value == null ? new byte[0] : value; - return concat(CollectionUtils.listOf(encodeKey(fieldNumber, 2), encodeVarint(bytes.length), bytes)); - } - - private static byte[] encodeKey(int fieldNumber, int wireType) { - return encodeVarint((fieldNumber << 3) | wireType); - } - - private static byte[] encodeVarint(int value) { - ByteArrayOutputStream out = new ByteArrayOutputStream(); - int v = value >>> 0; - while (v >= 0x80) { - out.write((v & 0x7f) | 0x80); - v >>>= 7; - } - out.write(v); - return out.toByteArray(); - } - - private static byte[] crcBytesLe(byte[] data) { - int crc = 0xffff; - for (byte b : data) { - crc ^= (b & 0xff) << 8; - for (int i = 0; i < 8; i++) { - if ((crc & 0x8000) != 0) { - crc = ((crc << 1) ^ 0x1021) & 0xffff; - } else { - crc = (crc << 1) & 0xffff; - } - } - } - return new byte[] {(byte) (crc & 0xff), (byte) ((crc >>> 8) & 0xff)}; - } - - - /** - * Split one notification value into individual `aa21`/`aa12` envelope - * frames. A value normally holds exactly one frame, but the firmware can - * pack several (each self-describing via the length byte at offset 3), and - * a frame that only reads the first would silently drop the rest. A value - * that does not start with an envelope, or a trailing partial frame - * (truncated by the stack — observed on a Samsung tablet for values over - * 64 bytes), is returned as-is so the caller can log it. - */ - public static List splitFrames(byte[] value) { - List out = new ArrayList<>(); - if (value == null || value.length == 0) { - return out; - } - int offset = 0; - while (offset + 8 <= value.length - && value[offset] == (byte) 0xaa - && (value[offset + 1] == 0x21 || value[offset + 1] == 0x12)) { - int len = value[offset + 3] & 0xff; - int end = Math.min(value.length, offset + 8 + len); - out.add(Arrays.copyOfRange(value, offset, end)); - offset = end; - } - if (offset < value.length) { - out.add(Arrays.copyOfRange(value, offset, value.length)); - } - return out; - } - - public static ParsedFrame parseFrame(byte[] buf) { - if (buf == null || buf.length < 10 || buf[0] != (byte) 0xaa || (buf[1] != 0x21 && buf[1] != 0x12)) { - return new ParsedFrame(false, 0, 0, new byte[0], -1, -1); - } - int sid = buf[6] & 0xff; - int flag = buf[7] & 0xff; - int len = buf[3] & 0xff; - int end = Math.min(buf.length, 8 + len); - byte[] pb = Arrays.copyOfRange(buf, 8, end); - - int msgType = -1; - int msgSeq = -1; - int offset = 0; - for (int i = 0; i < 8 && offset < pb.length; i++) { - VarintResult key = readVarint(pb, offset); - if (key == null) { - break; - } - offset = key.next; - int tag = key.value >> 3; - int wire = key.value & 7; - if (wire == 0) { - VarintResult value = readVarint(pb, offset); - if (value == null) { - break; - } - if (tag == 1) { - msgType = value.value; - } else if (tag == 2) { - msgSeq = value.value; - } - offset = value.next; - } else if (wire == 2) { - VarintResult length = readVarint(pb, offset); - if (length == null) { - break; - } - offset = length.next + length.value; - } else { - break; - } - if (msgType >= 0 && msgSeq >= 0) { - break; - } - } - return new ParsedFrame(true, sid, flag, pb, msgType, msgSeq); - } - - public static byte[] stripTrailingCrc(byte[] pb) { - if (pb == null || pb.length < 2) { - return pb == null ? new byte[0] : pb; - } - return Arrays.copyOf(pb, pb.length - 2); - } - - /** Decode the stock firmware's compass navigation notifications (sid 0x08). */ - public static CompassEvent parseCompassEvent(ParsedFrame frame) { - if (frame == null - || !frame.ok - || frame.sid != SID_NAVIGATION - || (frame.flag != FLAG_NOTIFY && frame.flag != FLAG_NOTIFY_ALT)) { - return null; - } - byte[] root = stripTrailingCrc(frame.pb); - int command = readVarintFieldValue(root, 1, -1); - if (command == NAV_CMD_COMPASS_CHANGED) { - byte[] compass = readFieldBytes(root, 10); - if (compass == null) return null; - int heading = readVarintFieldValue(compass, 1, -1); - if (heading < 0 || heading >= 360) return null; - byte[] diagnostic = readFieldBytes(root, 100); - if (diagnostic != null && diagnostic.length == 12 - && diagnostic[0] == 'C' && diagnostic[1] == 'M' && diagnostic[2] == 1 - && diagnostic[7] == 0 - && ((diagnostic[3] & 0xff) <= 3 || diagnostic[3] == (byte) 255) - && ((diagnostic[4] & 0xff) <= 2 || diagnostic[4] == (byte) 255) - && (diagnostic[5] & 0xff) <= 3) { - long sampleTimeMs = 0; - for (int i = 0; i < 4; i++) sampleTimeMs |= (long) (diagnostic[8 + i] & 0xff) << (8 * i); - return new CompassEvent(command, heading, - diagnostic[3] == (byte) 255 ? -1 : diagnostic[3] & 0xff, - diagnostic[4] == (byte) 255 ? -1 : diagnostic[4] & 0xff, - diagnostic[5] & 0xff, diagnostic[6] & 0xff, sampleTimeMs); - } - // Stock/older CFW and unknown extensions still supply usable headings. - return new CompassEvent(command, heading); - } - if (command == NAV_CMD_COMPASS_CALIBRATION_STARTED - || command == NAV_CMD_COMPASS_CALIBRATION_COMPLETE) { - return new CompassEvent(command, -1); - } - return null; - } - - /** - * Display wake notification observed after a ring or right-arm double tap - * while no EvenHub page is running: - * - * sid=0x0d, flag=notify, payload f1=1, f3={f1=1} - * - * Other state-change shapes (wear, charging, head-up, etc.) are deliberately - * excluded. The caller additionally gates this on an intentional EvenHub - * suspension, so normal state traffic cannot become application input. - */ - public static boolean isDisplayWakeStateChange(ParsedFrame frame) { - if (frame == null - || !frame.ok - || frame.sid != SID_STATE_CHANGE - || (frame.flag != FLAG_NOTIFY && frame.flag != FLAG_NOTIFY_ALT)) { - return false; - } - byte[] root = stripTrailingCrc(frame.pb); - if (readVarintFieldValue(root, 1, -1) != 1) { - return false; - } - byte[] state = readFieldBytes(root, 3); - return state != null - && state.length == 2 - && readVarintFieldValue(state, 1, -1) == 1; - } - - public static byte[] readFieldBytes(byte[] pb, int fieldNumber) { - int offset = 0; - while (offset < pb.length) { - VarintResult key = readVarint(pb, offset); - if (key == null) { - return null; - } - offset = key.next; - int field = key.value >> 3; - int wire = key.value & 0x07; - if (wire == 0) { - VarintResult value = readVarint(pb, offset); - if (value == null) { - return null; - } - offset = value.next; - continue; - } - if (wire == 1) { - offset += 8; - continue; - } - if (wire == 5) { - offset += 4; - continue; - } - if (wire != 2) { - return null; - } - VarintResult length = readVarint(pb, offset); - if (length == null) { - return null; - } - offset = length.next; - int end = offset + length.value; - if (end > pb.length) { - return null; - } - byte[] bytes = Arrays.copyOfRange(pb, offset, end); - offset = end; - if (field == fieldNumber) { - return bytes; - } - } - return null; - } - - public static int readVarintFieldValue(byte[] pb, int fieldNumber, int defaultValue) { - int offset = 0; - while (offset < pb.length) { - VarintResult key = readVarint(pb, offset); - if (key == null) { - return defaultValue; - } - offset = key.next; - int field = key.value >> 3; - int wire = key.value & 0x07; - if (wire == 0) { - VarintResult value = readVarint(pb, offset); - if (value == null) { - return defaultValue; - } - offset = value.next; - if (field == fieldNumber) { - return value.value; - } - continue; - } - if (wire == 1) { - offset += 8; - continue; - } - if (wire == 5) { - offset += 4; - continue; - } - if (wire != 2) { - return defaultValue; - } - VarintResult length = readVarint(pb, offset); - if (length == null) { - return defaultValue; - } - offset = length.next + length.value; - } - return defaultValue; - } - - /** - * Read a `float` (protobuf wire type 5, little-endian fixed32) field. The - * g2-kit proto declares IMU_Report_Data's x/y/z as `double`, but the - * firmware actually sends them as fixed32 floats (confirmed from captures). - * Returns defaultValue if absent. - */ - public static float readFloatFieldValue(byte[] pb, int fieldNumber, float defaultValue) { - int offset = 0; - while (offset < pb.length) { - VarintResult key = readVarint(pb, offset); - if (key == null) { - return defaultValue; - } - offset = key.next; - int field = key.value >> 3; - int wire = key.value & 0x07; - if (wire == 0) { - VarintResult value = readVarint(pb, offset); - if (value == null) { - return defaultValue; - } - offset = value.next; - } else if (wire == 1) { - offset += 8; - } else if (wire == 5) { - if (offset + 4 > pb.length) { - return defaultValue; - } - if (field == fieldNumber) { - int bits = 0; - for (int i = 0; i < 4; i++) { - bits |= (pb[offset + i] & 0xff) << (8 * i); - } - return Float.intBitsToFloat(bits); - } - offset += 4; - } else if (wire == 2) { - VarintResult length = readVarint(pb, offset); - if (length == null) { - return defaultValue; - } - offset = length.next + length.value; - } else { - return defaultValue; - } - } - return defaultValue; - } - - public static String readStringFieldValue(byte[] pb, int fieldNumber) { - byte[] bytes = readFieldBytes(pb, fieldNumber); - if (bytes == null) { - return ""; - } - return new String(bytes, StandardCharsets.UTF_8); - } - - public static VarintResult readVarint(byte[] pb, int offset) { - int value = 0; - int shift = 0; - int cursor = offset; - while (cursor < pb.length) { - int b = pb[cursor++] & 0xff; - value |= (b & 0x7f) << shift; - if ((b & 0x80) == 0) { - return new VarintResult(value, cursor); - } - shift += 7; - } - return null; - } - - - public static final class ParsedFrame { - final boolean ok; - final int sid; - final int flag; - final byte[] pb; - final int msgType; - final int msgSeq; - - ParsedFrame(boolean ok, int sid, int flag, byte[] pb, int msgType, int msgSeq) { - this.ok = ok; - this.sid = sid; - this.flag = flag; - this.pb = pb; - this.msgType = msgType; - this.msgSeq = msgSeq; - } - } - - private static final class VarintResult { - final int value; - final int next; - - VarintResult(int value, int next) { - this.value = value; - this.next = next; - } - } - - public static final class ListSelection { - public final String containerName; - public final String itemName; - public final int itemIndex; - public final int eventType; - - ListSelection(String containerName, String itemName, int itemIndex, int eventType) { - this.containerName = containerName == null ? "" : containerName; - this.itemName = itemName == null ? "" : itemName; - this.itemIndex = itemIndex; - this.eventType = eventType; - } - } - - public static final class CompassEvent { - public final int command; - public final int headingDegrees; - /** -1 means unavailable; source: 0 unknown, 1 GRV, 2 GMRV, 3 RV. */ - public final int magneticAccuracy, magneticAnomalies, orientationSource, diagnosticFlags; - public final long sampleTimeMs; - - CompassEvent(int command, int headingDegrees) { - this(command, headingDegrees, -1, -1, -1, -1, -1); - } - - CompassEvent(int command, int headingDegrees, int magneticAccuracy, int magneticAnomalies, - int orientationSource, int diagnosticFlags, long sampleTimeMs) { - this.command = command; - this.headingDegrees = headingDegrees; - this.magneticAccuracy = magneticAccuracy; - this.magneticAnomalies = magneticAnomalies; - this.orientationSource = orientationSource; - this.diagnosticFlags = diagnosticFlags; - this.sampleTimeMs = sampleTimeMs; - } - } - - public static final class ImageTileOptions { - final String name; - final int containerId; - final int x; - final int y; - final int width; - final int height; - - ImageTileOptions(String name, int containerId, int x, int y, int width, int height) { - this.name = name; - this.containerId = containerId; - this.x = x; - this.y = y; - this.width = width; - this.height = height; - } - } - - public static final class ImageFragment { - final int index; - final byte[] data; - final int size; - - ImageFragment(int index, byte[] data, int size) { - this.index = index; - this.data = data; - this.size = size; - } - } - - public static final class BatterySnapshot { - final int battery; - final int charging; - /** 1 = silent mode on, 0 = off, -1 = the ack didn't carry the field. */ - final int silentMode; - - BatterySnapshot(int battery, int charging, int silentMode) { - this.battery = battery; - this.charging = charging; - this.silentMode = silentMode; - } - } - - public static final class FirmwareInfo { - /** Prefix of the firmware-extension string on Faceclaw's custom firmware. */ - public static final String FACECLAW_EXTENSION_PREFIX = "Faceclaw/"; - - final String leftVersion; - final String rightVersion; - /** Raw field-100 string ("" on stock firmware). */ - final String extension; - - FirmwareInfo(String leftVersion, String rightVersion, String extension) { - this.leftVersion = leftVersion; - this.rightVersion = rightVersion; - this.extension = extension == null ? "" : extension; - } - - /** - * True when the glasses run Faceclaw's custom firmware (any revision). - * Whether the revision is the one this app needs is decided on the TS - * side, which disconnects on a mismatch; this only guards the private - * modes against stock or third-party firmware in the meantime. - */ - public boolean isFaceclawFirmware() { - return extension.trim().startsWith(FACECLAW_EXTENSION_PREFIX); - } - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/CfwMessageWindow.java b/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/CfwMessageWindow.java deleted file mode 100644 index c342b066..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/CfwMessageWindow.java +++ /dev/null @@ -1,38 +0,0 @@ -package com.faceclaw.app; - -import java.util.ArrayList; -import java.util.List; - -/** Ordered completion and go-back-N recovery for the custom-message window. */ -final class CfwMessageWindow { - // Flappy capture: p99 ACK 63ms, max 77ms. Leave room for full-frame - // processing while recovering a lost reply well before the stock timeout. - static final int ACK_TIMEOUT_MS = 500; - static final int MAX_RETRIES = 3; - - private CfwMessageWindow() {} - - static OutboundMessage acknowledgedHead(Iterable messages) { - for (OutboundMessage message : messages) { - if (message.sid != CfwTransport.SID) continue; - return !message.cfwRetryPending && message.cfwAckLenses == CfwTransport.BOTH ? message : null; - } - return null; - } - - static List replayWindow(Iterable messages, long nowMs) { - List replay = new ArrayList<>(); - boolean failed = false; - for (OutboundMessage message : messages) { - if (message.sid != CfwTransport.SID) continue; - failed |= message.cfwRetryPending || (message.cfwAckLenses != CfwTransport.BOTH - && message.ackDeadlineAtMs > 0 && message.ackDeadlineAtMs <= nowMs); - replay.add(message); - } - // A lost ACK, first fragment, or NACK can leave an older attempt - // unresolved. Replaying only the named failure strands that older - // attempt at the head until its timeout. Rewind the unresolved window. - if (!failed) replay.clear(); - return replay; - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/CfwTransport.java b/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/CfwTransport.java deleted file mode 100644 index e921b3fb..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/CfwTransport.java +++ /dev/null @@ -1,141 +0,0 @@ -package com.faceclaw.app; - -import java.io.ByteArrayOutputStream; -import java.util.zip.Deflater; -import java.util.ArrayList; -import java.util.List; - -/** Faceclaw/10 records: clear flags, wire length and decoded CRC; persistent zlib body. */ -public final class CfwTransport { - public static final int SID = 0xf0; - public static final int BOTH = 3; - public static final int MAX_MESSAGE = 65535; - public static final int COMPRESSED = 4, RESET_CONTEXT = 8; - private final Deflater deflater = new Deflater(); - private boolean resetPending = true; - private int previousLenses; - - public CfwTransport() {} - - public synchronized void reset() { - deflater.reset(); - resetPending = true; - previousLenses = 0; - } - - /** Compress only when writing, in exactly the order seen by the receiver. */ - public synchronized List encode(byte[] message, int streamId, int lenses, int mtu) { - validate(message, streamId, lenses, mtu); - if (previousLenses != lenses) reset(); - boolean reset = resetPending; - deflater.setInput(message); - ByteArrayOutputStream out = new ByteArrayOutputStream(); - byte[] chunk = new byte[4096]; - int count; - do { - count = deflater.deflate(chunk, 0, chunk.length, Deflater.SYNC_FLUSH); - out.write(chunk, 0, count); - } while (count == chunk.length); - byte[] body = out.toByteArray(); - int flags = lenses | COMPRESSED | (reset ? RESET_CONTEXT : 0); - if (body.length == 0) flags &= ~COMPRESSED; // repeated empty sync flush - if (body.length > MAX_MESSAGE) { - // Incompressible maximum-size records still fit as raw records. - // The attempted deflate advanced history: reset both ends before reuse. - reset(); - body = message; - flags = lenses | RESET_CONTEXT; - } else { - resetPending = false; - previousLenses = lenses; - } - return frameRecord(body, crc(message), streamId, flags, mtu); - } - - private static void validate(byte[] message, int streamId, int lenses, int mtu) { - if (message == null || message.length > MAX_MESSAGE || streamId < 0 || streamId > 255 - || lenses < 1 || lenses > BOTH || mtu < 23 || mtu > 517) - throw new IllegalArgumentException("invalid CFW stream parameters"); - } - - /** One logical command per stream for now. Packets are bounded by actual ATT MTU. */ - public static List frame(byte[] message, int streamId, int lenses, int mtu) { - validate(message, streamId, lenses, mtu); - return frameRecord(message, crc(message), streamId, lenses | RESET_CONTEXT, mtu); - } - - private static List frameRecord(byte[] body, int checksum, int streamId, int flags, int mtu) { - int lenses = flags & BOTH; - int capacity = Math.min(252, mtu - 14); - byte[] stream = new byte[body.length + 5]; - stream[0] = (byte) flags; - stream[1] = (byte) body.length; - stream[2] = (byte) (body.length >>> 8); - stream[3] = (byte) checksum; - stream[4] = (byte) (checksum >>> 8); - System.arraycopy(body, 0, stream, 5, body.length); - List packets = new ArrayList<>(); - for (int offset = 0, index = 0; offset < stream.length; offset += capacity, index++) { - int count = Math.min(capacity, stream.length - offset); - byte[] packet = new byte[count + 11]; - packet[0] = (byte) 0xaa; - packet[1] = 0x21; - packet[2] = (byte) (streamId + index); - packet[3] = (byte) (count + 3); - packet[4] = packet[5] = 1; - packet[6] = (byte) SID; - packet[8] = (byte) (lenses | (offset == 0 ? 0x80 : 0) - | (offset + count == stream.length ? 0x40 : 0)); - System.arraycopy(stream, offset, packet, 9, count); - int crc = crc(packet, 8, count + 1); - packet[packet.length - 2] = (byte) crc; - packet[packet.length - 1] = (byte) (crc >>> 8); - packets.add(packet); - } - return packets; - } - - public static int crc(byte[] data) { return crc(data, 0, data.length); } - private static int crc(byte[] data, int offset, int count) { - int crc = 0xffff; - for (int i = offset; i < offset + count; i++) { - crc ^= (data[i] & 255) << 8; - for (int bit = 0; bit < 8; bit++) - crc = ((crc << 1) ^ ((crc & 0x8000) != 0 ? 0x1021 : 0)) & 65535; - } - return crc; - } - private static int u16(byte[] data, int offset) { - return (data[offset] & 255) | ((data[offset + 1] & 255) << 8); - } - public static Ack parseAck(byte[] packet) { - Ack[] acks = parseAcks(packet); - return acks == null ? null : acks[0]; - } - /** Primary ACK followed by up to three explicit preceding successes from - * the same processing lens. Validate the entire packet before applying any. */ - public static Ack[] parseAcks(byte[] packet) { - if (packet == null || packet.length < 19 || packet.length > 40 - || (packet.length - 19) % 7 != 0 || (packet[0] & 255) != 0xaa - || packet[1] != 0x12 || (packet[3] & 255) != packet.length - 8 || packet[4] != 1 || packet[5] != 1 - || (packet[6] & 255) != SID || packet[7] != 0 || (packet[8] != 1 && packet[8] != 3) - || (packet[12] != 1 && packet[12] != 2) - || (packet[8] == 3 && packet.length != 19) - || crc(packet, 8, packet.length - 10) != u16(packet, packet.length - 2)) return null; - Ack[] acks = new Ack[1 + (packet.length - 19) / 7]; - acks[0] = new Ack(packet[8] == 3, packet[9] & 255, u16(packet, 10), packet[12], u16(packet, 13), u16(packet, 15)); - for (int i = 1, offset = 17; i < acks.length; i++, offset += 7) - acks[i] = new Ack(false, packet[offset] & 255, u16(packet, offset + 1), - packet[12], u16(packet, offset + 3), u16(packet, offset + 5)); - return acks; - } - public static final class Ack { - public final boolean nack; - public final int streamId, messageId, lens, size, checksum; - Ack(boolean nack, int streamId, int messageId, int lens, int size, int checksum) { - this.nack = nack; - this.streamId = streamId; this.messageId = messageId; this.lens = lens; - this.size = size; this.checksum = checksum; - } - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/ConnectionOptions.java b/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/ConnectionOptions.java deleted file mode 100644 index a358dba9..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/ConnectionOptions.java +++ /dev/null @@ -1,75 +0,0 @@ -package com.faceclaw.app; -import android.bluetooth.BluetoothGattCharacteristic; - -public class ConnectionOptions { - public static final int WRITE_TYPE = BluetoothGattCharacteristic.WRITE_TYPE_NO_RESPONSE; - public static final int DESIRED_MTU = 512; - - public static final int CONNECT_TIMEOUT_MS = 5_000; - public static final int SERVICES_TIMEOUT_MS = 5_000; - public static final int DESCRIPTOR_TIMEOUT_MS = 5_000; - public static final int RING_DESIRED_MTU = 247; - public static final int RING_RECONNECT_DELAY_MS = 2_000; - public static final int WRITE_TIMEOUT_MS = 2_000; - public static final int PRELUDE_TIMEOUT_MS = 2_000; - // Application security-auth exchange (sid 0x80). The success notification - // only arrives once the BLE link is encrypted, which on a first-time - // connection means SMP pairing — possibly with an OS dialog the user has - // to accept — so the stock-firmware paths wait generously. - public static final int SECURITY_AUTH_TIMEOUT_MS = 30_000; - // The main communicator's wait is soft (it proceeds on timeout so firmware - // that never answers can't stall every reconnect), so it is kept short. - public static final int SECURITY_AUTH_SOFT_TIMEOUT_MS = 6_000; - public static final int ACK_TIMEOUT_MS = 3_500; - public static final int HEARTBEAT_FAILURE_DEADLINE_MS = 10_000; - public static final int HEARTBEAT_READY_MS = 4_000; - public static final int HEARTBEAT_URGENT_MS = 6_000; - public static final int BATTERY_REFRESH_INTERVAL_MS = 5 * 60_000; - public static final int BATTERY_INPUT_QUIET_MS = 5_000; - // Poll cadence while in charging mode; also bounds how quickly we notice - // the glasses coming back out of the case. - public static final int CHARGING_BATTERY_POLL_MS = 30_000; - public static final int IMAGE_FRAGMENT_SIZE = 3800; - public static final int IMAGE_RETRY_DELAY_MS = 2_000; - public static final int MAX_CONSECUTIVE_ACK_TIMEOUTS = 8; - public static final int EVEN_APP_WRITE_FAILURE_WINDOW_MS = 15_000; - public static final int IDLE_SLEEP_MS = 100; - public static final int RECONNECT_DELAY_MS = 2_000; - - final boolean sendImagesToLeft = true; - final boolean skipSessionIds = true; - // Max messages in flight (awaiting ack) at once — full pipelining. >1 lets a - // frame be sent before the previous frame's ack returns, hiding the BLE ack - // round-trip that otherwise serialized every update. Requires firmware that - // accepts pipelined image messages (the CFW snapshot/deferred FIFO). At 1 the - // communicator behaves exactly as before (serial sends + last-packet prewrite). - final int WINDOW_SIZE = 3; - // Send changed-region (mode 3 bounding box) updates instead of full frames - // when the previous frame is known to be displayed. Requires firmware with - // the experimental bbox-incremental mode. Disabled: the firmware-side - // display buffer is not always the previous frame (occasionally two frames - // back, apparently display-driver buffer swapping), so partial updates - // composite onto stale content per-lens. Re-enable once the firmware - // guarantees the compositing base. - final boolean INCREMENTAL_FRAMES = true; - - // Send several tight rectangle deltas as one CFW mode-8 multi-segment message - // instead of a single bounding box, when the change splits into regions whose - // bounding box wastes bytes (distant edits, or a sparse box). Requires firmware - // with mode-8 multi-rect support; needs INCREMENTAL_FRAMES (same seeded shadow). - // Falls back to the single bounding box whenever multi-rect isn't smaller. - final boolean MULTI_RECT_FRAMES = true; - // Cap on rects per batch. Each rect consumes a distinct CFW frame id, and the - // firmware's duplicate-fid ring holds 16, so keep several batches of history - // within it. Above this the split is abandoned for a single bounding box. - public static final int MULTI_RECT_MAX_RECTS = 6; - // Don't bother splitting when the single bounding box already compresses this - // small (one tight rect); only attempt multi-rect above it or when the box - // spans multiple horizontal clusters. - public static final int MULTI_RECT_MIN_PAYLOAD = 900; - - // Ship text as on-glasses cached-glyph draws (CFW modes 12/14) instead of - // pixels, punching glyph ink out of the baked deltas (see TexturePlanner). - // Also gated at runtime on the firmware advertising texcache12 + texstr14. - final boolean TEXTURE_CACHE_FRAMES = true; -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/G2Event.java b/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/G2Event.java deleted file mode 100644 index 7d5c57bb..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/G2Event.java +++ /dev/null @@ -1,116 +0,0 @@ -package com.faceclaw.app; - -public final class G2Event { - final String kind; - final String containerName; - final int eventType; - final int eventSource; - final int systemExitReasonCode; - // IMU_Report_Data (Sys_ItemEvent.IMUData), populated when the firmware - // attaches an accelerometer reading to a sys-event. - final boolean hasImu; - final double imuX; - final double imuY; - final double imuZ; - - public G2Event(String kind, String containerName, int eventType, int eventSource, int systemExitReasonCode) { - this(kind, containerName, eventType, eventSource, systemExitReasonCode, false, 0, 0, 0); - } - - public G2Event(String kind, String containerName, int eventType, int eventSource, int systemExitReasonCode, - boolean hasImu, double imuX, double imuY, double imuZ) { - this.kind = kind; - this.containerName = containerName; - this.eventType = eventType; - this.eventSource = eventSource; - this.systemExitReasonCode = systemExitReasonCode; - this.hasImu = hasImu; - this.imuX = imuX; - this.imuY = imuY; - this.imuZ = imuZ; - } - - public static G2Event decode(BleProtocol.ParsedFrame frame) { - byte[] pb = BleProtocol.stripTrailingCrc(frame.pb); - - // sid 0x07 is the stock Even AI app, not EvenHub, so it carries an - // EvenAIDataPackage rather than the device-event wrapper below. - // EvenAIDataPackage { command_id = 1, magic_random = 2, ctrl = 3 }, - // EvenAIControl { status = 1 }. The event we care about is - // command_id=CTRL with status=WAKE_UP, which the firmware emits when the - // on-glasses "Hey Even" wakeword fires. - if (frame.sid == BleProtocol.SID_EVEN_AI) { - int commandId = BleProtocol.readVarintFieldValue(pb, 1, -1); - if (commandId != BleProtocol.EVEN_AI_CMD_CTRL) { - return null; - } - byte[] ctrl = BleProtocol.readFieldBytes(pb, 3); - if (ctrl == null) { - return null; - } - int status = BleProtocol.readVarintFieldValue(ctrl, 1, -1); - if (status < 0) { - return null; - } - return new G2Event("even-ai", "", status, 0, 0); - } - - byte[] deviceEvent = BleProtocol.readFieldBytes(pb, 13); - if (deviceEvent == null) { - return null; - } - - byte[] listEvent = BleProtocol.readFieldBytes(deviceEvent, 1); - if (listEvent != null) { - return new G2Event( - "list-click", - BleProtocol.readStringFieldValue(listEvent, 2), - BleProtocol.readVarintFieldValue(listEvent, 5, BleProtocol.EVENT_CLICK), - 0, - 0 - ); - } - - byte[] textEvent = BleProtocol.readFieldBytes(deviceEvent, 2); - if (textEvent != null) { - return new G2Event( - "text-click", - BleProtocol.readStringFieldValue(textEvent, 2), - BleProtocol.readVarintFieldValue(textEvent, 3, BleProtocol.EVENT_CLICK), - 0, - 0 - ); - } - - byte[] sysEvent = BleProtocol.readFieldBytes(deviceEvent, 3); - if (sysEvent != null) { - int eventType = BleProtocol.readVarintFieldValue(sysEvent, 1, BleProtocol.EVENT_CLICK); - int eventSource = BleProtocol.readVarintFieldValue(sysEvent, 2, 0); - int exitReason = BleProtocol.readVarintFieldValue(sysEvent, 4, 0); - // IMUData (field 3) is IMU_Report_Data { double x=1, y=2, z=3 }. It - // may accompany any sys-event, or arrive as a standalone - // IMU_DATA_REPORT sample. - byte[] imu = BleProtocol.readFieldBytes(sysEvent, 3); - if (imu != null) { - double x = BleProtocol.readFloatFieldValue(imu, 1, 0); - double y = BleProtocol.readFloatFieldValue(imu, 2, 0); - double z = BleProtocol.readFloatFieldValue(imu, 3, 0); - return new G2Event("sys-event", "", eventType, eventSource, exitReason, true, x, y, z); - } - return new G2Event("sys-event", "", eventType, eventSource, exitReason); - } - return null; - } - - private static String hex(byte[] data) { - if (data == null) { - return "null"; - } - StringBuilder sb = new StringBuilder(data.length * 2); - for (byte b : data) { - sb.append(String.format("%02x", b & 0xff)); - } - return sb.toString(); - } - -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/MessageBuilder.java b/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/MessageBuilder.java deleted file mode 100644 index 8377dcc4..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/MessageBuilder.java +++ /dev/null @@ -1,281 +0,0 @@ -package com.faceclaw.app; - -public class MessageBuilder { - private static final int ACK_TIMEOUT_MS = 3_500; - private static final int HEARTBEAT_TIMEOUT_MS = 1_500; - - private BleMagicPool magicPool; - - public MessageBuilder(BleMagicPool magicPool) { - this.magicPool = magicPool; - } - - public OutboundMessage prelude() { - return new OutboundMessage( - "prelude", "prelude", - BleProtocol.PRELUDE_ACK_SID, - BleProtocol.FLAG_REQUEST, - BleProtocol.PRELUDE_ACK_MAGIC, - BleProtocol.PRELUDE_F5872_PAYLOAD, - ACK_TIMEOUT_MS, - -1, - false - ); - } - - /** The per-connection sid-0x80 security-auth request (one per arm). */ - public OutboundMessage securityAuth(boolean leftArm) { - int magic = magicPool.allocate(); - return new OutboundMessage( - "security-auth", - "security auth " + (leftArm ? "L" : "R"), - BleProtocol.SID_SECURITY_AUTH, - BleProtocol.FLAG_SECURITY_AUTH, - magic, - BleProtocol.buildAuthenticationRequest(magic), - ConnectionOptions.SECURITY_AUTH_SOFT_TIMEOUT_MS, - -1, - leftArm - ); - } - - public OutboundMessage shutdown(int exitMode) { - int magic = magicPool.allocate(); - return new OutboundMessage( - "shutdown", - "shutdown mode=" + exitMode, - BleProtocol.SID_EVENHUB, - BleProtocol.FLAG_REQUEST, - magic, - BleProtocol.buildShutdown(magic, exitMode), - ACK_TIMEOUT_MS, - -1, - false - ); - } - - public OutboundMessage imagePayload( - BleProtocol.ImageTileOptions tile, - int sessionId, - byte[] payload, - String label, - boolean leftArm - ) { - return imagePayload("sound", tile, sessionId, payload, label, leftArm); - } - - public OutboundMessage imagePayload( - String kind, - BleProtocol.ImageTileOptions tile, - int sessionId, - byte[] payload, - String label, - boolean leftArm - ) { - // Keep these arguments for source compatibility with existing callers; - // the private command no longer carries a tile, session, or image header. - return customMessage(kind, payload, label, -1, leftArm); - } - - public OutboundMessage customMessage(String kind, byte[] payload, String label, - int tileIndex, boolean leftArm) { - if (payload == null || payload.length > CfwTransport.MAX_MESSAGE) - throw new IllegalArgumentException("CFW message exceeds uint16 length"); - int streamId = magicPool.allocate(); - return new OutboundMessage(kind, label, CfwTransport.SID, 0, streamId, payload, - CfwMessageWindow.ACK_TIMEOUT_MS, tileIndex, leftArm); - } - - public OutboundMessage cfwCleanup( - BleProtocol.ImageTileOptions tile, - int sessionId, - boolean leftArm - ) { - byte[] payload = new byte[] { (byte) BleProtocol.CFW_IMAGE_MODE_CLEANUP }; - return imagePayload( - "cfw-cleanup", - tile, - sessionId, - payload, - "CFW cleanup", - leftArm - ); - } - - public OutboundMessage enableOrDisableMic(boolean enable) { - int magic = magicPool.allocate(); - return new OutboundMessage( - "audio-control", - enable ? "G2 mic enable" : "G2 mic disable", - BleProtocol.SID_EVENHUB, - BleProtocol.FLAG_REQUEST, - magic, - BleProtocol.buildAudioControl(magic, enable), - ACK_TIMEOUT_MS, - -1, - false - ); - } - - public OutboundMessage enableOrDisableImu(boolean enable, int reportFrq) { - int magic = magicPool.allocate(); - return new OutboundMessage( - "imu-control", - enable ? "IMU enable" : "IMU disable", - BleProtocol.SID_EVENHUB, - BleProtocol.FLAG_REQUEST, - magic, - BleProtocol.buildImuControl(magic, enable, reportFrq), - ACK_TIMEOUT_MS, - -1, - false - ); - } - - public OutboundMessage setBrightness(boolean autoAdjust, int brightnessLevel) { - int magic = magicPool.allocate(); - return new OutboundMessage( - "brightness-control", - autoAdjust ? "brightness auto" : "brightness level=" + brightnessLevel, - BleProtocol.SID_UI_SETTING, - BleProtocol.FLAG_REQUEST, - magic, - BleProtocol.buildSetBrightness(magic, autoAdjust, brightnessLevel), - ACK_TIMEOUT_MS, - -1, - false - ); - } - - public OutboundMessage setWearDetection(boolean enabled) { - int magic = magicPool.allocate(); - return new OutboundMessage( - "wear-detection-control", - "wear detection " + (enabled ? "enable" : "disable"), - BleProtocol.SID_UI_SETTING, - BleProtocol.FLAG_REQUEST, - magic, - BleProtocol.buildSetWearDetection(magic, enabled), - ACK_TIMEOUT_MS, - -1, - false - ); - } - - public OutboundMessage createLayout() { - int magic = magicPool.allocate(); - return new OutboundMessage( - "create-layout", - "create-layout", - BleProtocol.SID_EVENHUB, - BleProtocol.FLAG_REQUEST, - magic, - BleProtocol.buildCreateInputPage(magic), - ACK_TIMEOUT_MS, - -1, - false - ); - } - - public OutboundMessage startupTextProbe() { - int magic = magicPool.allocate(); - return new OutboundMessage( - "startup-text-probe", - "startup text probe", - BleProtocol.SID_EVENHUB, - BleProtocol.FLAG_REQUEST, - magic, - BleProtocol.buildDashboardTextUpgrade(magic), - ACK_TIMEOUT_MS, - -1, - false - ); - } - - public OutboundMessage heartbeat() { - int magic = magicPool.allocate(); - return new OutboundMessage( - "heartbeat", - "heartbeat", - BleProtocol.SID_EVENHUB, - BleProtocol.FLAG_REQUEST, - magic, - BleProtocol.buildHeartbeat(magic), - HEARTBEAT_TIMEOUT_MS, - -1, - false - ); - } - - public OutboundMessage batteryQuery() { - int magic = magicPool.allocate(); - return new OutboundMessage( - "battery", - "battery", - BleProtocol.SID_UI_SETTING, - BleProtocol.FLAG_REQUEST, - magic, - BleProtocol.buildSettingsQuery(magic), - ACK_TIMEOUT_MS, - -1, - false - ); - } - - public OutboundMessage faceclawWakeControl(int operation, int nonce, boolean leftArm) { - return new OutboundMessage( - "wake-lease-control", - "wake lease op=" + operation + " nonce=" + nonce + (leftArm ? " L" : " R"), - BleProtocol.SID_UI_SETTING, - BleProtocol.FLAG_REQUEST, - 0, - BleProtocol.buildFaceclawWakeControl(operation, nonce), - ACK_TIMEOUT_MS, - -1, - leftArm - ); - } - - public OutboundMessage faceclawFramebufferControl(int operation, boolean leftArm) { - return new OutboundMessage( - "framebuffer-lease-control", - "framebuffer lease op=" + operation + (leftArm ? " L" : " R"), - BleProtocol.SID_UI_SETTING, - BleProtocol.FLAG_REQUEST, - 0, - BleProtocol.buildFaceclawWakeControl(operation, 0), - ACK_TIMEOUT_MS, - -1, - leftArm - ); - } - - /** CFW mic_control write (settings field 103) targeted at one temple. */ - public OutboundMessage faceclawMicControl(byte[] record, String label, boolean leftArm) { - return new OutboundMessage( - "mic-control", - "mic control " + label + (leftArm ? " L" : " R"), - BleProtocol.SID_UI_SETTING, - BleProtocol.FLAG_REQUEST, - 0, - BleProtocol.buildFaceclawMicControl(record), - ACK_TIMEOUT_MS, - -1, - leftArm - ); - } - - public OutboundMessage faceclawWearQuery(boolean leftArm) { - return new OutboundMessage( - "wear-query-control", - "wear state query" + (leftArm ? " L" : " R"), - BleProtocol.SID_UI_SETTING, - BleProtocol.FLAG_REQUEST, - 0, - BleProtocol.buildFaceclawWakeControl(BleProtocol.FACECLAW_WEAR_OP_QUERY, 0), - ACK_TIMEOUT_MS, - -1, - leftArm - ); - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/OutboundMessage.java b/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/OutboundMessage.java deleted file mode 100644 index bfdcd5cf..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/OutboundMessage.java +++ /dev/null @@ -1,71 +0,0 @@ -package com.faceclaw.app; -import java.util.Arrays; - -public final class OutboundMessage { - final String kind; - final String label; - final int sid; - final int flag; - int magic; - final byte[] message; - final int ackTimeoutMs; - final int tileIndex; - final boolean isLeftArmMessage; - - int cfwAckLenses, cfwRetries; - boolean cfwRetryPending; - final int cfwChecksum; - - int imageUpdateId; - int imageMessageNumber; - int imageMessageCount; - long sentAtMs; - long writeStartedAtMs; - long ackDeadlineAtMs; - byte[] ackPayload = new byte[0]; - Runnable onSent; - Runnable onAck; - Runnable onTimeout; - - OutboundMessage(String kind, String label, int sid, int flag, int magic, byte[] message, int ackTimeoutMs, int tileIndex, boolean isLeftArmMessage) { - this.kind = kind; - this.label = label; - this.sid = sid; - this.flag = flag; - this.magic = magic; - this.message = message == null ? new byte[0] : Arrays.copyOf(message, message.length); - this.cfwChecksum = sid == CfwTransport.SID ? CfwTransport.crc(this.message) : 0; - this.ackTimeoutMs = ackTimeoutMs; - this.tileIndex = tileIndex; - this.isLeftArmMessage = isLeftArmMessage; - } - - /** NACK names this attempt's stream/message sequence, even without a decoded size. */ - boolean acceptCfwAck(CfwTransport.Ack ack) { - if (ack == null || sid != CfwTransport.SID || magic != ack.streamId - || ack.messageId != 0 || (ack.lens != 1 && ack.lens != 2)) return false; - if (ack.nack) { - cfwRetryPending = true; - return false; - } - if (message.length != ack.size || cfwChecksum != ack.checksum) return false; - cfwAckLenses |= ack.lens; - return !cfwRetryPending && cfwAckLenses == CfwTransport.BOTH; - } - - /** Replace an attempt atomically under the communicator lock. */ - void prepareCfwReplay(int streamId) { - magic = streamId; - ++cfwRetries; - cfwAckLenses = 0; - cfwRetryPending = false; - ackDeadlineAtMs = 0; - ackPayload = new byte[0]; - } - - void setImageUpdatePosition(int updateId, int messageNumber, int messageCount) { - this.imageUpdateId = updateId; - this.imageMessageNumber = messageNumber; - this.imageMessageCount = messageCount; - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/TextureCacheState.java b/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/TextureCacheState.java deleted file mode 100644 index 23cebc1d..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/TextureCacheState.java +++ /dev/null @@ -1,179 +0,0 @@ -package com.faceclaw.app; - -import java.io.ByteArrayOutputStream; -import java.util.ArrayList; -import java.util.HashMap; -import java.util.List; -import java.util.Map; - -/** - * Phone-side model of the CFW's flat 256 KiB texture cache (zlib_glue mode 18). - * The firmware holds only bytes; every structural decision — where font - * tables and glyph images live, what is resident, when to start over — is - * made here. Layout per font: a 96-entry uint32 offset table (chars 32..127) - * whose entries are written lazily as each glyph is uploaded; glyph images - * are the GlyphAtlas cached bytes ([w][h][4bpp RLE]). - * - * Allocation is a bump pointer with reset-on-full: the realistic working set - * (a few fonts' tables plus ~hundreds of glyphs at tens of bytes each) is far - * below 256 KiB, so eviction sophistication buys nothing. After a reset the - * firmware cache still holds stale bytes; that is safe because a draw only - * ever references (font table entry, glyph image) pairs uploaded in the - * current generation — stale table entries are never named in a mode-20 - * string. - * - * Upload entries accumulate as complete [offset u32][len u16][data] records - * and drain into one or more standalone mode-18 payloads, each independently - * valid, enqueued ahead of the image message that references them (the - * transport is FIFO, so no ack round-trip is needed before use). - * - * Not thread-safe by itself: the communicator calls it under its own lock. - */ -public final class TextureCacheState { - public static final int CACHE_SIZE = 262144; - private static final int FONT_TABLE_BYTES = 96 * 4; - - private int allocEnd = 0; - private final Map fontTableOffsets = new HashMap<>(); - private final Map glyphOffsets = new HashMap<>(); - private final Map imageOffsets = new HashMap<>(); - private final List pendingEntries = new ArrayList<>(); - private int pendingBytes = 0; - private int generation = 0; - - /** - * Forget everything: the on-glasses cache is gone (session teardown, lease - * loss) or no longer trustworthy (upload timeout), or we ran out of space. - * Glyphs and images re-upload lazily on next use. - */ - public void reset() { - allocEnd = 0; - fontTableOffsets.clear(); - glyphOffsets.clear(); - imageOffsets.clear(); - pendingEntries.clear(); - pendingBytes = 0; - generation++; - } - - /** Bumped by every reset; lets a planner detect a mid-plan reset. */ - public int generation() { - return generation; - } - - /** - * Bytes currently allocated out of CACHE_SIZE, for logging/tuning (a - * sudden drop in the frame log means a reset-on-full re-upload cycle — - * the signal that the 256 KiB budget is being outgrown). - */ - public int usedBytes() { - return allocEnd; - } - - /** The font's 96-entry table offset in the cache, or -1 when it exists but this glyph can't fit. */ - public int fontTableOffset(int fontId) { - Integer existing = fontTableOffsets.get(fontId); - return existing == null ? -1 : existing; - } - - /** - * Ensure a glyph image (and its font table slot) is resident, queuing the - * mode-18 upload entries for anything newly placed. Returns the glyph's - * image offset, or -1 when the cache is full (caller resets and retries) - * or the encoding is outside the mode-20 table (32..127). - */ - public int ensureGlyph(int fontId, int encoding, GlyphAtlas.Glyph glyph) { - if (glyph == null || encoding < 32 || encoding > 127) return -1; - long key = ((long) fontId << 32) | (encoding & 0xffffffffL); - Integer existing = glyphOffsets.get(key); - if (existing != null) return existing; - - Integer table = fontTableOffsets.get(fontId); - int need = glyph.cachedBytes.length + (table == null ? FONT_TABLE_BYTES : 0); - if (allocEnd + need > CACHE_SIZE) return -1; - - if (table == null) { - table = allocEnd; - allocEnd += FONT_TABLE_BYTES; - fontTableOffsets.put(fontId, table); - // No upload for the table itself: entries are written per glyph, - // and only uploaded entries are ever referenced by a draw. - } - int offset = allocEnd; - allocEnd += glyph.cachedBytes.length; - glyphOffsets.put(key, offset); - - addEntry(offset, glyph.cachedBytes); - addEntry(table + 4 * (encoding - 32), - new byte[]{(byte) offset, (byte) (offset >> 8), - (byte) (offset >> 16), (byte) (offset >> 24)}); - return offset; - } - - /** - * Ensure an ImageAtlas entry is resident (mode-19 draws reference it by - * raw cache offset; no table involved). Returns the image offset, or -1 - * when the cache is full (caller resets and retries). - */ - public int ensureImage(int imageId, ImageAtlas.Entry image) { - if (image == null) return -1; - Integer existing = imageOffsets.get(imageId); - if (existing != null) return existing; - if (allocEnd + image.cachedBytes.length > CACHE_SIZE) return -1; - int offset = allocEnd; - allocEnd += image.cachedBytes.length; - imageOffsets.put(imageId, offset); - addEntry(offset, image.cachedBytes); - return offset; - } - - private void addEntry(int offset, byte[] data) { - byte[] entry = new byte[6 + data.length]; - entry[0] = (byte) (offset & 0xff); - entry[1] = (byte) ((offset >> 8) & 0xff); - entry[2] = (byte) ((offset >> 16) & 0xff); - entry[3] = (byte) ((offset >> 24) & 0xff); - entry[4] = (byte) (data.length & 0xff); - entry[5] = (byte) ((data.length >> 8) & 0xff); - System.arraycopy(data, 0, entry, 6, data.length); - pendingEntries.add(entry); - pendingBytes += entry.length; - } - - public boolean hasPendingUploads() { - return !pendingEntries.isEmpty(); - } - - /** Total queued upload bytes (entry framing included), for logging. */ - public int pendingUploadBytes() { - return pendingBytes; - } - - /** - * Drain the queued entries into complete mode-18 payloads ([18][entries]), - * each at most maxPayloadBytes so a payload fits one BLE image message - * without fragmentation. A single entry larger than the cap still gets its - * own payload (the transport can fragment it). - */ - public List drainUploadPayloads(int maxPayloadBytes) { - List payloads = new ArrayList<>(); - ByteArrayOutputStream current = null; - for (byte[] entry : pendingEntries) { - if (current != null && current.size() + entry.length > maxPayloadBytes) { - payloads.add(current.toByteArray()); - current = null; - } - if (current == null) { - current = new ByteArrayOutputStream(Math.min(maxPayloadBytes, 4 + entry.length)); - current.write(18); - } - current.write(entry, 0, entry.length); - } - if (current != null) { - payloads.add(current.toByteArray()); - } - pendingEntries.clear(); - pendingBytes = 0; - return payloads; - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/TexturePlanner.java b/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/TexturePlanner.java deleted file mode 100644 index ac700cc2..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/TexturePlanner.java +++ /dev/null @@ -1,721 +0,0 @@ -package com.faceclaw.app; - -import java.util.ArrayList; -import java.util.Collections; -import java.util.Comparator; -import java.util.List; - -/** - * Plans a screen update that ships text and icons as on-glasses cached draws - * instead of pixels (CFW modes 18/19/20; see g2flash/patches/zlib_glue.c and - * texture_cache.c). - * - * Approach: dirty rects come from comparing the fully composited old and new - * frames, exactly as the plain incremental path does. For each deferred draw - * (glyph or image) whose pixels intersect a sent rect, check that every pixel - * the on-glasses draw would write lands correct — i.e. the new composite's - * 4bpp value at each in-panel nonzero-source pixel equals what the draw - * produces (this one check subsumes plane occlusion, surface - * occlusion/clipping, and draw-on-draw overlap). A draw that passes and is - * (or can be made) resident in the texture cache is replayed on-glasses: its - * written pixels are punched to 0 in the delta rect content — which is what - * makes text and icons nearly free to compress — and re-emitted as a mode-20 - * string or mode-19 image sub-message in the same atomic mode-8 batch, so - * the shadow after apply equals the full composite exactly. Everything else - * stays baked. - * - * Fallback shape: when nothing qualifies, plan() returns null and the caller - * uses the plain single-bbox/multi-rect/full-frame paths unchanged. - */ -public final class TexturePlanner { - private TexturePlanner() {} - - /** Cap on mode-20 string sub-messages (mode-8 count is a u8). */ - private static final int MAX_GLYPH_RUNS = 180; - /** - * Soft cap on cached-glyph selection per update, before run grouping. - * Sized above a full-screen 6x12 terminal repaint (~4,240 cells) so dense - * screens draw everything; the run budget is the real bound. - */ - private static final int MAX_SELECTED_GLYPHS = 4600; - /** Cap on mode-19 image sub-messages per update. */ - private static final int MAX_IMAGE_DRAWS = 60; - /** Cap on mode-15 builtin-font string sub-messages per update. */ - private static final int MAX_FWTEXT_RUNS = 80; - /** Mode-18 payload size that fits one BLE image message comfortably. */ - private static final int UPLOAD_PAYLOAD_MAX = 3600; - /** Max x-adjust control bytes between two glyphs before starting a new run. */ - private static final int MAX_ADJUST_BYTES = 4; - /** Options: identity LUT (top 15) + transparent, for mode-19 image draws. */ - private static final int IMAGE_DRAW_OPTIONS = 0x1f; - - public static final class Result { - /** Complete image payload: a mode-8 batch of rect deltas + cached draws. */ - public final byte[] payload; - /** Mode-18 upload payloads to enqueue BEFORE the image message. */ - public final List uploads; - /** Next mode-3 frame id (deltas consumed some). */ - public final int nextFid; - public final int rectCount; - public final int drawnGlyphs; - public final int runCount; - public final int drawnImages; - public final int fwGlyphs; - public final int fwRuns; - public final int bakedCandidates; - public final int uploadBytes; - public final boolean fullFrame; - /** - * Where the planning time went, in ms. This runs on the send thread, - * directly in the input-to-display path, so the split is reported in - * the frame log: rects = finding the changed region, match = checking - * each draw against the composite, cache = residency/uploads plus run - * building, punch = clearing replayed draws out of a copy of the - * frame, encode = compressing the leftover pixels. - */ - public int rectsMs; - public int matchMs; - public int cacheMs; - public int punchMs; - public int encodeMs; - - Result(byte[] payload, List uploads, int nextFid, int rectCount, - int drawnGlyphs, int runCount, int drawnImages, int fwGlyphs, int fwRuns, - int bakedCandidates, int uploadBytes, boolean fullFrame) { - this.payload = payload; - this.uploads = uploads; - this.nextFid = nextFid; - this.rectCount = rectCount; - this.drawnGlyphs = drawnGlyphs; - this.runCount = runCount; - this.drawnImages = drawnImages; - this.fwGlyphs = fwGlyphs; - this.fwRuns = fwRuns; - this.bakedCandidates = bakedCandidates; - this.uploadBytes = uploadBytes; - this.fullFrame = fullFrame; - } - } - - /** One draw selected for on-glasses replay. */ - private static final class Selected { - final SurfaceCompositor.ScreenDraw draw; - final GlyphAtlas.Glyph glyphAtlas; // glyph draws - final ImageAtlas.Entry imageAtlas; // image draws - final int gx; // screen x of the cached image (pen + bearing / blit left) - final int top; // glyph draws: 4bpp top color - - Selected(SurfaceCompositor.ScreenDraw draw, GlyphAtlas.Glyph glyphAtlas, - ImageAtlas.Entry imageAtlas, int gx, int top) { - this.draw = draw; - this.glyphAtlas = glyphAtlas; - this.imageAtlas = imageAtlas; - this.gx = gx; - this.top = top; - } - } - - /** - * Plan a cached-draw update. previous is the delta base (the frame the - * shadow currently holds), or null/mismatched for a full-frame keyframe. - * Returns null when the plain paths should run instead (no replayable - * draws, or identical frames). - */ - public static Result plan( - byte[] previous, byte[] next, int width, int height, - SurfaceCompositor.ScreenDraw[] draws, - TextureCacheState cache, int fidStart, - boolean allowMultiRect, int maxRects) { - if (next == null || draws == null || draws.length == 0 || width <= 0 || height <= 0) { - return null; - } - int stride = (width + 1) >> 1; - if (next.length != stride * height) { - return null; - } - long planStartedAtMs = android.os.SystemClock.elapsedRealtime(); - - // Rect geometry, matching what the plain paths would send. - boolean fullFrame = previous == null || previous.length != next.length; - List rects; - if (!fullFrame) { - int[] box = BleImageOptimizer.computeChangedBox(previous, next, width, height); - if (box == null) { - return null; // identical frames; caller's dedup normally catches this - } - if (box[2] >= width && box[3] >= height) { - fullFrame = true; - rects = Collections.singletonList(new int[]{0, 0, width, height}); - } else { - List split = allowMultiRect - ? BleImageOptimizer.computeChangedRects(previous, next, width, height, maxRects) - : null; - rects = split != null ? split : Collections.singletonList(box); - } - } else { - rects = Collections.singletonList(new int[]{0, 0, width, height}); - } - - long matchStartedAtMs = android.os.SystemClock.elapsedRealtime(); - - // Candidates: draws whose written pixels intersect a sent rect, are - // representable on the wire, and land correct against the composite. - List selected = new ArrayList<>(); - int bakedCandidates = 0; - int selectedImages = 0; - // Builtin-font (mode 15) runs: no cache residency, no uploads — the - // firmware owns the font. Processed first because it has no cache - // side effects; the counters feed the shared stats. - List fwSubs = new ArrayList<>(); - List fwPunches = new ArrayList<>(); - int fwGlyphCount = 0; - int fwBaked = 0; - for (SurfaceCompositor.ScreenDraw draw : draws) { - if (draw.kind != SurfaceCompositor.ScreenDraw.KIND_FWTEXT) continue; - fwBaked += planFwRun(draw, rects, next, stride, width, height, fwSubs, fwPunches); - } - fwGlyphCount = fwPunches.size(); - bakedCandidates += fwBaked; - for (SurfaceCompositor.ScreenDraw draw : draws) { - if (draw.kind == SurfaceCompositor.ScreenDraw.KIND_GLYPH) { - GlyphAtlas.Glyph atlas = GlyphAtlas.get(draw.fontId, draw.encoding); - if (atlas == null) continue; // unregistered: stays baked, not a "candidate" - int gx = draw.x + atlas.bbxX; - int inkTop = draw.y + atlas.inkTop; - if (!intersectsAny(rects, gx, inkTop, atlas.width, atlas.inkHeight)) { - continue; - } - if (draw.encoding < 32 || draw.encoding > 127 - || gx < 0 || draw.y < 0 || gx > 0xffff || draw.y > 0xffff) { - bakedCandidates++; - continue; - } - int top = BmpUtil.nibbleForGray(draw.value); - if (!glyphMatchesComposite(next, stride, width, height, atlas, gx, draw.y, top)) { - bakedCandidates++; - continue; - } - if (selected.size() >= MAX_SELECTED_GLYPHS) { - bakedCandidates++; - continue; - } - selected.add(new Selected(draw, atlas, null, gx, top)); - } else { - ImageAtlas.Entry atlas = ImageAtlas.get(draw.imageId); - if (atlas == null) continue; - if (!intersectsAny(rects, draw.x, draw.y, atlas.width, atlas.height)) { - continue; - } - if (draw.x < 0 || draw.y < 0 || draw.x > 0xffff || draw.y > 0xffff - || selectedImages >= MAX_IMAGE_DRAWS) { - bakedCandidates++; - continue; - } - if (!imageMatchesComposite(next, stride, width, height, atlas, draw.x, draw.y)) { - bakedCandidates++; - continue; - } - selected.add(new Selected(draw, null, atlas, draw.x, 0)); - selectedImages++; - } - } - if (selected.isEmpty() && fwSubs.isEmpty()) { - return null; - } - long cacheStartedAtMs = android.os.SystemClock.elapsedRealtime(); - - // Residency: ensure every selected draw is in the cache, retrying once - // after a reset when the bump allocator fills. A draw that still fails - // falls back to baked. IMPORTANT: once ensure* has run, every bail-out - // to the plain path must cache.reset() — ensure* marked entries - // resident and queued uploads that only a returned Result would - // enqueue. (Fw-text needs no residency, so a fw-only plan skips this.) - List drawable = selected.isEmpty() - ? Collections.emptyList() - : ensureResident(cache, selected); - bakedCandidates += selected.size() - drawable.size(); - - // Group glyphs into mode-20 runs; leftover-budget glyphs bake. - List glyphDrawable = new ArrayList<>(); - List imageDrawable = new ArrayList<>(); - for (Selected sel : drawable) { - if (sel.glyphAtlas != null) glyphDrawable.add(sel); - else imageDrawable.add(sel); - } - List runs = new ArrayList<>(); - List drawnGlyphs = buildRuns(cache, glyphDrawable, runs); - bakedCandidates += glyphDrawable.size() - drawnGlyphs.size(); - List drawn = new ArrayList<>(drawnGlyphs); - drawn.addAll(imageDrawable); - if ((drawn.isEmpty() && fwSubs.isEmpty()) - || rects.size() + runs.size() + imageDrawable.size() + fwSubs.size() > 255) { - if (!selected.isEmpty()) { - cache.reset(); - } - return null; - } - - // Punch the drawn pixels out of a copy of the composite, then encode - // the rect deltas from the punched content. - long punchStartedAtMs = android.os.SystemClock.elapsedRealtime(); - byte[] punched = next.clone(); - for (Selected sel : drawn) { - punch(punched, stride, width, height, sel); - } - for (FwPunch fw : fwPunches) { - punchFw(punched, stride, width, height, fw); - } - - long encodeStartedAtMs = android.os.SystemClock.elapsedRealtime(); - List subs = new ArrayList<>(); - int fid = fidStart; - if (fullFrame) { - subs.add(BleImageOptimizer.maybeCompress(punched, width, height)); - } else { - for (int[] r : rects) { - subs.add(BleImageOptimizer.encodeMode3Rect(punched, stride, r[0], r[1], r[2], r[3], fid)); - fid = (fid >= 0xfffe) ? 1 : fid + 1; - } - } - for (Selected sel : imageDrawable) { - subs.add(encodeImageDraw(cache, sel)); - } - subs.addAll(runs); - subs.addAll(fwSubs); - byte[] payload = assembleMode8(subs); - - int uploadBytes = cache.pendingUploadBytes(); - List uploads = cache.drainUploadPayloads(UPLOAD_PAYLOAD_MAX); - Result result = new Result(payload, uploads, fid, rects.size(), drawnGlyphs.size(), runs.size(), - imageDrawable.size(), fwGlyphCount, fwSubs.size(), - bakedCandidates, uploadBytes, fullFrame); - long doneAtMs = android.os.SystemClock.elapsedRealtime(); - result.rectsMs = (int) (matchStartedAtMs - planStartedAtMs); - result.matchMs = (int) (cacheStartedAtMs - matchStartedAtMs); - result.cacheMs = (int) (punchStartedAtMs - cacheStartedAtMs); - result.punchMs = (int) (encodeStartedAtMs - punchStartedAtMs); - result.encodeMs = (int) (doneAtMs - encodeStartedAtMs); - return result; - } - - /** One punch task for an emitted firmware-font glyph. */ - private static final class FwPunch { - final FwGlyphAtlas.Entry entry; - final int gx; - final int gy; - - FwPunch(FwGlyphAtlas.Entry entry, int gx, int gy) { - this.entry = entry; - this.gx = gx; - this.gy = gy; - } - } - - /** - * Plan one firmware-font run (mode 15): classify every member, and when - * any correct ink member intersects a sent rect, emit sub-messages over - * the maximal correct stretches. A stretch never spans an incorrect - * member — the sub-message boundary restarts the firmware's advance walk - * at an explicit pen x, so occluded or unknown glyphs simply stay baked - * without disturbing their neighbors' positions. Emitted ink members are - * queued for punching. Returns how many ink members stay baked. - */ - private static int planFwRun( - SurfaceCompositor.ScreenDraw draw, List rects, - byte[] next, int stride, int width, int height, - List outSubs, List outPunches) { - int n = draw.fwCps.length; - if (n == 0 || draw.y < 0 || draw.y > 0xffff) { - return countInk(draw); - } - int top = BmpUtil.nibbleForGray(draw.value); - boolean[] ok = new boolean[n]; - FwGlyphAtlas.Entry[] entries = new FwGlyphAtlas.Entry[n]; - boolean relevant = false; - int baked = 0; - for (int i = 0; i < n; i++) { - if (!draw.fwInk[i]) { - ok[i] = true; // inkless connector (space): draws nothing - continue; - } - FwGlyphAtlas.Entry entry = FwGlyphAtlas.get(draw.fwCps[i]); - if (entry == null) { - baked++; - continue; - } - int gx = draw.x + draw.fwDx[i] + entry.ofsX; - int gy = draw.y + entry.inkTop; - if (!fwGlyphMatchesComposite(next, stride, width, height, entry, gx, gy, top)) { - baked++; - continue; - } - ok[i] = true; - entries[i] = entry; - if (intersectsAny(rects, gx, gy, entry.boxW, entry.boxH)) { - relevant = true; - } - } - if (!relevant) { - return 0; // nothing in a sent rect: leave the run's pixels alone - } - - int i = 0; - while (i < n && outSubs.size() < MAX_FWTEXT_RUNS) { - while (i < n && !(ok[i] && draw.fwInk[i])) i++; - if (i >= n) break; - int startX = draw.x + draw.fwDx[i]; - if (startX < 0 || startX > 0xffff) { - baked++; - i++; - continue; - } - // Extend across correct members while the UTF-8 payload fits, - // tracking the last ink member so trailing connectors trim away. - int j = i; - int lastInk = -1; - int bytesToLastInk = 0; - int bytesSoFar = 0; - while (j < n && ok[j]) { - int encodedLength = utf8Length(draw.fwCps[j]); - if (bytesSoFar + encodedLength > 255) break; - bytesSoFar += encodedLength; - if (draw.fwInk[j]) { - lastInk = j; - bytesToLastInk = bytesSoFar; - } - j++; - } - if (lastInk < i) { // a single over-long codepoint; not realistic - baked++; - i++; - continue; - } - byte[] sub = new byte[7 + bytesToLastInk]; - sub[0] = 15; - sub[1] = (byte) (startX & 0xff); - sub[2] = (byte) ((startX >> 8) & 0xff); - sub[3] = (byte) (draw.y & 0xff); - sub[4] = (byte) ((draw.y >> 8) & 0xff); - sub[5] = (byte) (top | 0x10); // top color + transparent - sub[6] = (byte) bytesToLastInk; - int pos = 7; - for (int k = i; k <= lastInk; k++) { - byte[] encoded = new StringBuilder().appendCodePoint(draw.fwCps[k]) - .toString().getBytes(java.nio.charset.StandardCharsets.UTF_8); - System.arraycopy(encoded, 0, sub, pos, encoded.length); - pos += encoded.length; - } - outSubs.add(sub); - for (int k = i; k <= lastInk; k++) { - if (draw.fwInk[k]) { - outPunches.add(new FwPunch(entries[k], - draw.x + draw.fwDx[k] + entries[k].ofsX, - draw.y + entries[k].inkTop)); - } - } - i = lastInk + 1; - } - return baked; - } - - private static int utf8Length(int cp) { - if (cp < 0x80) return 1; - if (cp < 0x800) return 2; - if (cp < 0x10000) return 3; - return 4; - } - - private static int countInk(SurfaceCompositor.ScreenDraw draw) { - int count = 0; - for (boolean ink : draw.fwInk) { - if (ink) count++; - } - return count; - } - - /** - * Whether every in-panel nonzero pixel of the builtin-font glyph lands - * correct: the composite's 4bpp value must equal the firmware's LUT - * output src*top/15 (integer division — a general LUT check, since these - * glyphs are anti-aliased). - */ - private static boolean fwGlyphMatchesComposite(byte[] packed, int stride, int width, int height, - FwGlyphAtlas.Entry entry, int gx, int gy, int top) { - for (int row = 0; row < entry.boxH; row++) { - int y = gy + row; - if (y < 0 || y >= height) continue; - for (int col = 0; col < entry.boxW; col++) { - int source = entry.nibbleAt(col, row); - if (source == 0) continue; - int x = gx + col; - if (x < 0 || x >= width) continue; - if (nibbleAt(packed, stride, x, y) != (source * top) / 15) { - return false; - } - } - } - return true; - } - - private static void punchFw(byte[] packed, int stride, int width, int height, FwPunch fw) { - for (int row = 0; row < fw.entry.boxH; row++) { - int y = fw.gy + row; - if (y < 0 || y >= height) continue; - for (int col = 0; col < fw.entry.boxW; col++) { - if (fw.entry.nibbleAt(col, row) == 0) continue; - punchPixel(packed, stride, width, fw.gx + col, y); - } - } - } - - private static boolean intersectsAny(List rects, int x, int y, int w, int h) { - if (w <= 0 || h <= 0) return false; - for (int[] r : rects) { - if (x < r[0] + r[2] && x + w > r[0] && y < r[1] + r[3] && y + h > r[1]) { - return true; - } - } - return false; - } - - /** - * Whether every in-panel ink pixel of the glyph lands correct in the - * packed new frame: the composite's 4bpp value must equal the firmware's - * LUT output source*top/15 (integer). For 1bpp glyphs (source 15) this is - * exactly `== top`; AA glyphs get the general check. Ink outside the - * panel is clipped by the firmware and irrelevant. - */ - private static boolean glyphMatchesComposite(byte[] packed, int stride, int width, int height, - GlyphAtlas.Glyph atlas, int gx, int lineY, int top) { - for (int row = atlas.inkTop; row < atlas.inkTop + atlas.inkHeight; row++) { - int y = lineY + row; - if (y < 0 || y >= height) continue; - for (int col = 0; col < atlas.width; col++) { - int source = atlas.nibbleAt(col, row); - if (source == 0) continue; - int x = gx + col; - if (x < 0 || x >= width) continue; - if (nibbleAt(packed, stride, x, y) != (source * top) / 15) { - return false; - } - } - } - return true; - } - - /** - * Whether every in-panel nonzero pixel of the cached image equals the - * packed new frame — the mode-19 transparent draw writes exactly those. - */ - private static boolean imageMatchesComposite(byte[] packed, int stride, int width, int height, - ImageAtlas.Entry atlas, int left, int top) { - for (int row = 0; row < atlas.height; row++) { - int y = top + row; - if (y < 0 || y >= height) continue; - for (int col = 0; col < atlas.width; col++) { - int source = atlas.nibbleAt(col, row); - if (source == 0) continue; - int x = left + col; - if (x < 0 || x >= width) continue; - if (nibbleAt(packed, stride, x, y) != source) { - return false; - } - } - } - return true; - } - - private static int nibbleAt(byte[] packed, int stride, int x, int y) { - int b = packed[y * stride + (x >> 1)] & 0xff; - return (x & 1) != 0 ? (b & 0x0f) : (b >> 4); - } - - private static void punch(byte[] packed, int stride, int width, int height, Selected sel) { - if (sel.glyphAtlas != null) { - GlyphAtlas.Glyph atlas = sel.glyphAtlas; - for (int row = atlas.inkTop; row < atlas.inkTop + atlas.inkHeight; row++) { - int y = sel.draw.y + row; - if (y < 0 || y >= height) continue; - for (int col = 0; col < atlas.width; col++) { - if (!atlas.inkAt(col, row)) continue; - punchPixel(packed, stride, width, sel.gx + col, y); - } - } - } else { - ImageAtlas.Entry atlas = sel.imageAtlas; - for (int row = 0; row < atlas.height; row++) { - int y = sel.draw.y + row; - if (y < 0 || y >= height) continue; - for (int col = 0; col < atlas.width; col++) { - if (atlas.nibbleAt(col, row) == 0) continue; - punchPixel(packed, stride, width, sel.gx + col, y); - } - } - } - } - - private static void punchPixel(byte[] packed, int stride, int width, int x, int y) { - if (x < 0 || x >= width) return; - int index = y * stride + (x >> 1); - if ((x & 1) != 0) { - packed[index] = (byte) (packed[index] & 0xf0); - } else { - packed[index] = (byte) (packed[index] & 0x0f); - } - } - - /** - * Ensure residency for all of `selected`, resetting the cache once if the - * allocator fills mid-plan (a reset invalidates offsets handed out earlier - * in the same pass, so the whole pass reruns). Returns the draws that are - * resident afterwards. - */ - private static List ensureResident(TextureCacheState cache, List selected) { - for (int attempt = 0; attempt < 2; attempt++) { - List resident = new ArrayList<>(selected.size()); - boolean full = false; - for (Selected sel : selected) { - int offset = sel.glyphAtlas != null - ? cache.ensureGlyph(sel.draw.fontId, sel.draw.encoding, sel.glyphAtlas) - : cache.ensureImage(sel.draw.imageId, sel.imageAtlas); - if (offset >= 0) { - resident.add(sel); - } else { - full = true; - } - } - if (!full || attempt == 1) { - return resident; - } - cache.reset(); - } - return Collections.emptyList(); // unreachable - } - - /** Mode-19 cached-image draw: [19][offset u32][x u16][y u16][options u8]. */ - private static byte[] encodeImageDraw(TextureCacheState cache, Selected sel) { - int offset = cache.ensureImage(sel.draw.imageId, sel.imageAtlas); // resident: returns the offset - byte[] sub = new byte[10]; - sub[0] = 19; - sub[1] = (byte) (offset & 0xff); - sub[2] = (byte) ((offset >> 8) & 0xff); - sub[3] = (byte) ((offset >> 16) & 0xff); - sub[4] = (byte) ((offset >> 24) & 0xff); - sub[5] = (byte) (sel.draw.x & 0xff); - sub[6] = (byte) ((sel.draw.x >> 8) & 0xff); - sub[7] = (byte) (sel.draw.y & 0xff); - sub[8] = (byte) ((sel.draw.y >> 8) & 0xff); - sub[9] = (byte) IMAGE_DRAW_OPTIONS; - return sub; - } - - /** - * Group selected glyphs into mode-20 string sub-messages: - * [20][fontTable u32][x u16][y u16][options u8][strlen u8][string] - * One run per (font, line y, top color) span; within a run, control bytes - * 1..31 adjust x by -10..+20 to hit each glyph's exact position, and each - * glyph advances x by its cached width. Order across runs is free: every - * drawn glyph's ink equals the composite, so overlaps write equal values. - * Returns the glyphs actually emitted (run budget can drop stragglers). - */ - private static List buildRuns(TextureCacheState cache, List drawable, List outRuns) { - List sorted = new ArrayList<>(drawable); - sorted.sort(Comparator - .comparingInt((Selected s) -> s.draw.fontId) - .thenComparingInt(s -> s.draw.y) - .thenComparingInt(s -> s.top) - .thenComparingInt(s -> s.gx)); - - List drawn = new ArrayList<>(sorted.size()); - int i = 0; - while (i < sorted.size() && outRuns.size() < MAX_GLYPH_RUNS) { - Selected first = sorted.get(i); - int fontTable = cache.fontTableOffset(first.draw.fontId); - if (fontTable < 0) { // shouldn't happen: residency ensured above - i++; - continue; - } - java.io.ByteArrayOutputStream string = new java.io.ByteArrayOutputStream(); - List runGlyphs = new ArrayList<>(); - int cursor = first.gx; // the run's wire x starts exactly at the first glyph - int j = i; - while (j < sorted.size()) { - Selected sel = sorted.get(j); - if (sel.draw.fontId != first.draw.fontId - || sel.draw.y != first.draw.y - || sel.top != first.top) { - break; - } - int delta = sel.gx - cursor; - int adjustBytes = adjustByteCount(delta); - if (adjustBytes > MAX_ADJUST_BYTES && j > i) { - break; // far gap: cheaper to start a fresh run - } - if (string.size() + adjustBytes + 1 > 255) { - break; // strlen is a u8 - } - emitAdjust(string, delta); - string.write(sel.draw.encoding); - runGlyphs.add(sel); - cursor = sel.gx + sel.glyphAtlas.width; - j++; - } - if (!runGlyphs.isEmpty()) { - byte[] stringBytes = string.toByteArray(); - byte[] run = new byte[11 + stringBytes.length]; - run[0] = 20; - run[1] = (byte) (fontTable & 0xff); - run[2] = (byte) ((fontTable >> 8) & 0xff); - run[3] = (byte) ((fontTable >> 16) & 0xff); - run[4] = (byte) ((fontTable >> 24) & 0xff); - run[5] = (byte) (first.gx & 0xff); - run[6] = (byte) ((first.gx >> 8) & 0xff); - run[7] = (byte) (first.draw.y & 0xff); - run[8] = (byte) ((first.draw.y >> 8) & 0xff); - run[9] = (byte) (first.top | 0x10); // top color + transparent - run[10] = (byte) stringBytes.length; - System.arraycopy(stringBytes, 0, run, 11, stringBytes.length); - outRuns.add(run); - drawn.addAll(runGlyphs); - i = j; - } else { - i++; - } - } - return drawn; - } - - /** How many 1..31 control bytes are needed to move the cursor by delta. */ - private static int adjustByteCount(int delta) { - if (delta == 0) return 0; - return delta > 0 ? (delta + 19) / 20 : (-delta + 9) / 10; - } - - private static void emitAdjust(java.io.ByteArrayOutputStream out, int delta) { - while (delta != 0) { - int step = delta > 0 ? Math.min(delta, 20) : Math.max(delta, -10); - out.write(step + 11); // byte 1..31 adjusts x by (byte - 11) - delta -= step; - } - } - - /** [8][count]([len u16][sub])* — one atomic present for deltas + draws. */ - private static byte[] assembleMode8(List subs) { - int total = 2; - for (byte[] sub : subs) { - total += 2 + sub.length; - } - byte[] out = new byte[total]; - out[0] = 8; - out[1] = (byte) subs.size(); - int pos = 2; - for (byte[] sub : subs) { - out[pos] = (byte) (sub.length & 0xff); - out[pos + 1] = (byte) ((sub.length >> 8) & 0xff); - pos += 2; - System.arraycopy(sub, 0, out, pos, sub.length); - pos += sub.length; - } - return out; - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/util/BmpUtil.java b/App_Resources/Android/src/main/java/com/faceclaw/app/util/BmpUtil.java deleted file mode 100644 index 23898347..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/util/BmpUtil.java +++ /dev/null @@ -1,133 +0,0 @@ -package com.faceclaw.app; -import java.util.Arrays; - -public class BmpUtil { - public static byte[] copyTileBmp(byte[] bmp) { - if (bmp == null || bmp.length == 0) { - return new byte[0]; - } - return Arrays.copyOf(bmp, bmp.length); - } - - // Quantize an 8-bit gray value to a 4-bit nibble. Truncate rather than round - // up at the bottom: the shell's color-key convention paints intentional - // black as 1 (0 being transparent), which must land on nibble 0, not a - // faintly-visible level 1. - private static final byte[] GRAY_TO_NIBBLE = new byte[256]; - static { - for (int v = 1; v < 256; v++) { - GRAY_TO_NIBBLE[v] = (byte) Math.min(15, (v + 8) >> 4); - } - } - - /** - * The 4bpp level an 8-bit gray value packs to. Public so the texture-cache - * planner computes a glyph draw's top color with the exact quantization - * the composited frame was packed with. - */ - public static int nibbleForGray(int gray) { - return GRAY_TO_NIBBLE[gray & 0xff] & 0xff; - } - - /** - * Pack a full-resolution 8bpp grayscale buffer (row-major, top-to-bottom, - * one byte per pixel) into the headerless 4bpp wire format used by CFW - * load_image_z modes 3/6/8: top-down rows, stride ceil(width/2), high - * nibble = left pixel. This is the canonical in-memory frame format; BMP - * framing (needed only when an uncompressed full frame goes on the wire) - * is added on demand by build4bppBmpFromPacked. - */ - public static byte[] pack4bppFromGray8(byte[] gray8, int width, int height) { - if (width <= 0 || height <= 0) { - return new byte[0]; - } - int stride = (width + 1) >> 1; - byte[] out = new byte[stride * height]; - if (gray8 == null || gray8.length < width * height) { - return out; // short buffer: treat missing pixels as black - } - int pairs = width >> 1; - int src = 0; - int dst = 0; - for (int y = 0; y < height; y++) { - for (int i = 0; i < pairs; i++) { - out[dst++] = (byte) ((GRAY_TO_NIBBLE[gray8[src] & 0xff] << 4) - | GRAY_TO_NIBBLE[gray8[src + 1] & 0xff]); - src += 2; - } - if ((width & 1) != 0) { - out[dst++] = (byte) (GRAY_TO_NIBBLE[gray8[src++] & 0xff] << 4); - } - } - return out; - } - - /** - * Wrap a packed 4bpp frame in BMP framing (BITMAPINFOHEADER + 16-entry gray - * palette, bottom-up rows padded to a 4-byte stride). Only the full-frame - * fallback used when mode-6 compression does not shrink the frame still - * speaks BMP on the wire; everything else uses the headerless packed format - * directly. - */ - public static byte[] build4bppBmpFromPacked(byte[] packed, int width, int height) { - int packedStride = (width + 1) >> 1; - if (width <= 0 || height <= 0 - || packed == null || packed.length < packedStride * height) { - return new byte[0]; - } - int rowStride = (packedStride + 3) & ~3; - int pixelDataSize = rowStride * height; - - int fileHeaderSize = 14; - int dibHeaderSize = 40; - int paletteSize = 16 * 4; - int pixelOffset = fileHeaderSize + dibHeaderSize + paletteSize; - int fileSize = pixelOffset + pixelDataSize; - - byte[] buf = new byte[fileSize]; - buf[0] = 0x42; // 'B' - buf[1] = 0x4d; // 'M' - putUint32Le(buf, 2, fileSize); - putUint32Le(buf, 10, pixelOffset); - putUint32Le(buf, 14, dibHeaderSize); - putInt32Le(buf, 18, width); - putInt32Le(buf, 22, height); - putUint16Le(buf, 26, 1); // planes - putUint16Le(buf, 28, 4); // bits per pixel - putUint32Le(buf, 30, 0); // compression (BI_RGB) - putUint32Le(buf, 34, pixelDataSize); - putUint32Le(buf, 46, 16); // palette entry count - - for (int i = 0; i < 16; i++) { - int v = i * 17; - int base = fileHeaderSize + dibHeaderSize + i * 4; - buf[base] = (byte) v; - buf[base + 1] = (byte) v; - buf[base + 2] = (byte) v; - buf[base + 3] = 0; - } - - for (int bmpRow = 0; bmpRow < height; bmpRow++) { - int srcY = height - 1 - bmpRow; // BMP rows run bottom-up - System.arraycopy(packed, srcY * packedStride, - buf, pixelOffset + bmpRow * rowStride, packedStride); - } - return buf; - } - - private static void putUint16Le(byte[] buf, int offset, int value) { - buf[offset] = (byte) (value & 0xff); - buf[offset + 1] = (byte) ((value >>> 8) & 0xff); - } - - private static void putUint32Le(byte[] buf, int offset, int value) { - buf[offset] = (byte) (value & 0xff); - buf[offset + 1] = (byte) ((value >>> 8) & 0xff); - buf[offset + 2] = (byte) ((value >>> 16) & 0xff); - buf[offset + 3] = (byte) ((value >>> 24) & 0xff); - } - - private static void putInt32Le(byte[] buf, int offset, int value) { - putUint32Le(buf, offset, value); - } -} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/util/CollectionUtils.java b/App_Resources/Android/src/main/java/com/faceclaw/app/util/CollectionUtils.java deleted file mode 100644 index c99e29ea..00000000 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/util/CollectionUtils.java +++ /dev/null @@ -1,26 +0,0 @@ -package com.faceclaw.app; -import java.util.ArrayList; -import java.util.List; - -public class CollectionUtils { - public static List singletonList(byte[] value) { - List list = new ArrayList<>(1); - list.add(value); - return list; - } - - public static List listOf(byte[] a, byte[] b) { - List list = new ArrayList<>(2); - list.add(a); - list.add(b); - return list; - } - - public static List listOf(byte[] a, byte[] b, byte[] c) { - List list = new ArrayList<>(3); - list.add(a); - list.add(b); - list.add(c); - return list; - } -} diff --git a/app/g2/ble-image-optimizer.ios.ts b/app/g2/ble-image-optimizer.ios.ts new file mode 100644 index 00000000..989ca1c2 --- /dev/null +++ b/app/g2/ble-image-optimizer.ios.ts @@ -0,0 +1,15 @@ +import { fromData, toData, nativeArray } from '../native/kotlin-data' +declare const FaceclawKitIosProtocol: any +const protocol = FaceclawKitIosProtocol.new() +export function buildBoundingBoxPayload(previous: Uint8Array | null, next: Uint8Array, width: number, height: number, frameId: number): Uint8Array | null { + if (!Number.isInteger(width) || !Number.isInteger(height) || width <= 0 || height <= 0 || + width % 4 || height % 2 || width / 4 > 255 || height / 2 > 255 || + !previous || previous.length !== width * height / 2 || next.length !== previous.length) return null + const result = protocol.boundingBoxPreviousNextWidthHeightFrameId(toData(previous), toData(next), width, height, frameId) + return result ? fromData(result) : null +} +export function buildFullFrameBands(packed: Uint8Array, width: number, height: number, firstId: number): Uint8Array[] { + if (width <= 0 || width > 640 || width % 4 || height <= 0 || height > 480 || height % 2 || packed.length !== width * height / 2) + throw new Error('Invalid framebuffer dimensions') + return nativeArray(protocol.fullFrameBandsDataWidthHeightFirstId(toData(packed), width, height, firstId), fromData) +} diff --git a/app/g2/ble-protocol.ios.ts b/app/g2/ble-protocol.ios.ts new file mode 100644 index 00000000..e22945dc --- /dev/null +++ b/app/g2/ble-protocol.ios.ts @@ -0,0 +1,66 @@ +/** iOS binary bridge to the same Kotlin protocol used by Android. */ +import { fromData, toData, nativeArray } from '../native/kotlin-data' +import { OsEventTypeList } from './events' +declare const FaceclawKitIosProtocol: any, FaceclawKitIosMessageReceiver: any +const protocol = FaceclawKitIosProtocol.new() +export const G2_WRITE = '00002760-08c2-11e1-9073-0e8ac72e5401' +export const G2_NOTIFY = '00002760-08c2-11e1-9073-0e8ac72e5402' +export const G2_RENDER_NOTIFY = '00002760-08c2-11e1-9073-0e8ac72e6402' +export const RING_NOTIFY = ['bae80011-4f05-4503-8e65-3af1f7329d1f', 'bae80013-4f05-4503-8e65-3af1f7329d1f'] +export const SID = { auth: 0x80, launch: 1, hub: 0xe0, settings: 9, cfw: 0xf0 } as const +export function concat(...parts: Uint8Array[]): Uint8Array { + const output = new Uint8Array(parts.reduce((n, p) => n + p.length, 0)) + let offset = 0 + for (const part of parts) { output.set(part, offset); offset += part.length } + return output +} +export const integer = (field: number, value: number): Uint8Array => fromData(protocol.integerFieldValue(field, value)) +export const bytes = (field: number, value: Uint8Array): Uint8Array => fromData(protocol.bytesFieldData(field, toData(value))) +export const authentication = (magic: number) => fromData(protocol.authenticationMagic(magic)) +export const prelude = () => fromData(protocol.prelude()) +export const heartbeat = (magic: number) => fromData(protocol.heartbeatMagic(magic)) +export const audioControl = (magic: number, enabled: boolean) => fromData(protocol.audioControlMagicEnabled(magic, enabled)) +export const settingsQuery = (magic: number) => fromData(protocol.settingsQueryMagic(magic)) +export const shutdown = (magic: number) => fromData(protocol.shutdownMagic(magic)) +export const framebufferLease = (acquire: boolean) => fromData(protocol.framebufferLeaseAcquire(acquire)) +export const createLayout = (magic: number) => fromData(protocol.createLayoutMagic(magic)) +export const crc16 = (data: Uint8Array): number => protocol.crcData(toData(data)) +export function frameMessage(payload: Uint8Array, sid: number, flag: number, sequence: number, maxWrite = 240): Uint8Array[] { + const capacity = Math.min(232, Math.floor(maxWrite) - 8) + if (capacity < 12 || !Number.isFinite(capacity)) throw new Error('Negotiated BLE write size is too small') + if (Math.ceil((payload.length + 2) / capacity) > 255) throw new Error('Protocol message exceeds the fragment limit') + return nativeArray(protocol.frameDataSidFlagSequenceMaxWrite(toData(payload), sid, flag, sequence, Math.floor(maxWrite)), fromData) +} +export type ProtocolMessage = { sid: number; flag: number; payload: Uint8Array; command: number; magic: number; packet?: Uint8Array } +export class MessageReceiver { + private native = FaceclawKitIosMessageReceiver.new() + clear(): void { this.native.clear() } + receive(link: string, data: Uint8Array, now = Date.now()): ProtocolMessage[] { + return nativeArray(this.native.receiveLinkDataNow(link, toData(data), now), (message: any) => ({ + sid: message.sid, flag: message.flag, payload: fromData(message.payload), command: message.command, + magic: message.magic, ...(message.packet ? { packet: fromData(message.packet) } : {}), + })) + } +} +export const readInteger = (data: Uint8Array, field: number, fallback = 0): number => protocol.readIntegerDataFieldFallback(toData(data), field, fallback) +export const readBytes = (data: Uint8Array, field: number): Uint8Array | undefined => { + const value = protocol.readBytesDataField(toData(data), field) + return value ? fromData(value) : undefined +} +export const readString = (data: Uint8Array, field: number): string => protocol.readStringDataField(toData(data), field) +export function authenticationSucceeded(message: ProtocolMessage, magic: number): boolean { + return message.sid === SID.auth && message.command === 4 && message.magic === magic && readBytes(message.payload, 3)?.length === 0 +} +export type GlassesInput = { kind: 'sys-event' | 'list-click' | 'text-click' | 'display-wake'; eventType: number; eventSource: number; systemExitReasonCode: number; containerName: string; frameId: number } +function input(event: any): GlassesInput | null { + return event ? { kind: event.kind === 'sys-event' && event.eventType === OsEventTypeList.HEAD_UP_EVENT ? 'display-wake' : event.kind, + eventType: event.eventType, eventSource: event.eventSource, systemExitReasonCode: event.systemExitReasonCode, + containerName: event.containerName, frameId: 0 } : null +} +export const decodeGlassesInput = (message: ProtocolMessage): GlassesInput | null => input(protocol.glassesInputDataSidFlag(toData(message.payload), message.sid, message.flag)) +export const decodeRingInput = (data: Uint8Array): GlassesInput | null => input(protocol.ringInputData(toData(data))) +export function packGray4(gray: Uint8Array, width: number, height: number): Uint8Array { + if (!Number.isInteger(width) || !Number.isInteger(height) || width < 1 || height < 1 || gray.length !== width * height) throw new Error('Invalid display frame') + return fromData(protocol.packDataWidthHeight(toData(gray), width, height)) +} +export const rle4 = (packed: Uint8Array): Uint8Array => fromData(protocol.rleData(toData(packed))) diff --git a/app/g2/cfw-transport.ios.ts b/app/g2/cfw-transport.ios.ts new file mode 100644 index 00000000..135f31d1 --- /dev/null +++ b/app/g2/cfw-transport.ios.ts @@ -0,0 +1,21 @@ +import { fromData, toData, nativeArray } from '../native/kotlin-data' +declare const FaceclawKitIosCfwTransport: any, FaceclawKitIosProtocol: any +export const CFW_MAX_MESSAGE = 65535 +export type CfwAck = { nack: boolean; streamId: number; messageId: number; lens: number; size: number; checksum: number } +/** maxWrite is the ATT value limit; Kotlin owns the persistent zlib stream. */ +export class CfwTransport { + private native = FaceclawKitIosCfwTransport.new() + reset(): void { this.native.reset() } + encode(message: Uint8Array, streamId: number, lenses: number, maxWrite: number): Uint8Array[] { + if (message.length > CFW_MAX_MESSAGE || !Number.isInteger(streamId) || streamId < 0 || streamId > 255 || + ![1, 2, 3].includes(lenses) || !Number.isInteger(maxWrite) || maxWrite < 20 || maxWrite > 514) + throw new Error('Invalid CFW stream parameters') + return nativeArray(this.native.encodeDataStreamIdLensesMaxWrite(toData(message), streamId, lenses, maxWrite), fromData) + } +} +const protocol = FaceclawKitIosProtocol.new() +export function parseCfwAcks(packet: Uint8Array): CfwAck[] | null { + const acks = protocol.acksData(toData(packet)) + return acks ? nativeArray(acks, (ack: any) => ({ nack: ack.nack, streamId: ack.streamId, messageId: ack.messageId, + lens: ack.lens, size: ack.size, checksum: ack.checksum })) : null +} diff --git a/app/graphics/glyph-wire.ts b/app/graphics/glyph-wire.ts index 3842c499..adbf533f 100644 --- a/app/graphics/glyph-wire.ts +++ b/app/graphics/glyph-wire.ts @@ -116,7 +116,7 @@ function prepareFwTextRun(placed: PlacedFwText): boolean { bytes.set(entry.data.nibbles, offset + 10); offset += 10 + entry.data.nibbles.length; } - com.faceclaw.app.FwGlyphAtlas.register(buffer); + com.faceclaw.app.FwGlyphAtlas.register(new com.faceclaw.app.AndroidByteReader(buffer)); } return true; } @@ -130,7 +130,7 @@ function imageId(placed: PlacedImage): number | null { let id: number | null = null; if (source.width > 0 && source.width <= 255 && source.height > 0 && source.height <= 255) { const key = `img:${source.width}x${source.height}:${source.contentHash32().toString(16)}`; - id = com.faceclaw.app.ImageAtlas.ensure(key, source.width, source.height, source.pixels.buffer); + id = com.faceclaw.app.ImageAtlas.ensure(key, source.width, source.height, new com.faceclaw.app.AndroidByteReader(source.pixels.buffer)); if (!(typeof id === "number") || id <= 0) id = null; } imageIds.set(source, id); @@ -184,9 +184,9 @@ export function prepareFrameDraws(draws: readonly DeferredDraw[]): ArrayBuffer | } if (registration) { const plainBuffer = buildRegistrationBuffer(registration); - if (plainBuffer) com.faceclaw.app.GlyphAtlas.register(plainBuffer); + if (plainBuffer) com.faceclaw.app.GlyphAtlas.register(new com.faceclaw.app.AndroidByteReader(plainBuffer)); const aaBuffer = buildAaRegistrationBuffer(registration); - if (aaBuffer) com.faceclaw.app.GlyphAtlas.registerAa(aaBuffer); + if (aaBuffer) com.faceclaw.app.GlyphAtlas.registerAa(new com.faceclaw.app.AndroidByteReader(aaBuffer)); } if (bytes === 0) return null; diff --git a/app/graphics/surface-compositor.ios.ts b/app/graphics/surface-compositor.ios.ts new file mode 100644 index 00000000..8cb04f50 --- /dev/null +++ b/app/graphics/surface-compositor.ios.ts @@ -0,0 +1,30 @@ +import { fromData, toData } from '../native/kotlin-data' +import type { SurfaceConfiguration, SurfaceRect } from './surface-compositor' +export type { SurfaceConfiguration, SurfaceRect } from './surface-compositor' +declare const FaceclawKitIosSurfaceCompositor: any +/** Retained pixels, clipping, layers and composition live in shared Kotlin. */ +export class SurfaceCompositor { + private native: any + constructor(readonly width: number, readonly height: number) { + if (!Number.isInteger(width) || !Number.isInteger(height) || width <= 0 || height <= 0) throw new Error('Invalid compositor size') + this.native = FaceclawKitIosSurfaceCompositor.alloc().initWithWidthHeight(width, height) + } + configureSurface(id: string, options: SurfaceConfiguration): void { + if (![options.x, options.y, options.width, options.height, options.zOrder].every(Number.isInteger) + || options.width <= 0 || options.height <= 0) throw new Error('Invalid surface geometry') + this.native.configureIdXYWidthHeightZOrderTransparent(id, options.x, options.y, options.width, options.height, options.zOrder, options.transparency === 'color-key') + } + removeSurface(id: string): void { this.native.removeId(id) } + setSurfaceVisible(id: string, visible: boolean): void { this.native.visibleIdVisible(id, visible) } + setUnderlayDim(belowZOrder: number, factor: number): void { + if (!Number.isFinite(factor)) throw new Error('Invalid dim factor') + this.native.dimBelowFactor(belowZOrder, factor) + } + setScreenBlanked(blanked: boolean): void { this.native.blankBlanked(blanked) } + submitSurfaceFrame(id: string, pixels: Uint8Array, rect: SurfaceRect): void { + if (![rect.x, rect.y, rect.width, rect.height].every(Number.isInteger) + || rect.width <= 0 || rect.height <= 0 || pixels.length !== rect.width * rect.height) throw new Error('Invalid frame buffer or rectangle') + this.native.submitIdDataXYWidthHeight(id, toData(pixels), rect.x, rect.y, rect.width, rect.height) + } + composite(): Uint8Array { return fromData(this.native.composite()) } +} diff --git a/app/native/kotlin-data.ts b/app/native/kotlin-data.ts new file mode 100644 index 00000000..a3729fb6 --- /dev/null +++ b/app/native/kotlin-data.ts @@ -0,0 +1,12 @@ +/** Bulk binary bridge; slices are normalized without per-byte native calls. */ +export function toData(bytes: Uint8Array): NSData { + const buffer = bytes.byteOffset === 0 && bytes.byteLength === bytes.buffer.byteLength + ? bytes.buffer : bytes.slice().buffer + return NSData.dataWithBytesLength(interop.handleof(buffer), bytes.byteLength) +} +export function fromData(data: NSData): Uint8Array { + return new Uint8Array(interop.bufferFromData(data)).slice() +} +export function nativeArray(items: NSArray, convert: (item: T) => R): R[] { + return Array.from({ length: items.count }, (_, i) => convert(items.objectAtIndex(i))) +} diff --git a/app/native/kotlin-platform.android.ts b/app/native/kotlin-platform.android.ts index 7ca6ba1c..3ece2aa1 100644 --- a/app/native/kotlin-platform.android.ts +++ b/app/native/kotlin-platform.android.ts @@ -1,3 +1,4 @@ +import { runKotlinProtocolSmokeTest } from './kotlin-protocol-smoke'; import type { KotlinBridge } from './kotlin-platform'; // Handwritten declarations for the small native surface, checked against the @@ -17,6 +18,7 @@ declare namespace com.faceclaw.shared { } export function createKotlinBridge(): KotlinBridge { + runKotlinProtocolSmokeTest(); const bridge = new com.faceclaw.shared.KotlinBridge(); return { platform: () => bridge.platform(), diff --git a/app/native/kotlin-platform.ios.ts b/app/native/kotlin-platform.ios.ts index 24e4ea2c..f137f627 100644 --- a/app/native/kotlin-platform.ios.ts +++ b/app/native/kotlin-platform.ios.ts @@ -1,3 +1,4 @@ +import { runKotlinProtocolSmokeTest } from './kotlin-protocol-smoke.ios'; import type { KotlinBridge } from './kotlin-platform'; // Handwritten declarations matching FaceclawKit's Objective-C header. @@ -26,6 +27,7 @@ class KotlinCallback extends NSObject implements FaceclawKitKotlinBridgeListener } export function createKotlinBridge(): KotlinBridge { + runKotlinProtocolSmokeTest(); const bridge = FaceclawKitKotlinBridge.alloc().init(); return { platform: () => bridge.platform(), diff --git a/app/native/kotlin-protocol-smoke.ios.ts b/app/native/kotlin-protocol-smoke.ios.ts new file mode 100644 index 00000000..91c3ad21 --- /dev/null +++ b/app/native/kotlin-protocol-smoke.ios.ts @@ -0,0 +1,36 @@ +import * as protocol from '../g2/ble-protocol.ios' +import { CfwTransport, parseCfwAcks } from '../g2/cfw-transport.ios' +import { SurfaceCompositor } from '../graphics/surface-compositor.ios' +import { buildBoundingBoxPayload } from '../g2/ble-image-optimizer.ios' +import { lvglMetrics } from './lvgl-font.ios' + +/** Development-only checks of real NativeScript selectors and bulk data crossings. */ +export function runKotlinProtocolSmokeTest(): void { + const hex = (data: Uint8Array) => Array.from(data, byte => byte.toString(16).padStart(2, '0')).join('') + const assert = (condition: boolean, what: string) => { if (!condition) throw new Error(`Kotlin protocol bridge: ${what}`) } + const auth = protocol.authentication(101) + assert(hex(auth) === '080410651a0408011004', 'authentication') + assert(protocol.crc16(new Uint8Array([1, 2, 3])) === 0xadad, 'CRC') + const receiver = new protocol.MessageReceiver() + const frame = protocol.frameMessage(auth, 128, 0, 64)[0] + const received = receiver.receive('test', frame) + assert(received.length === 1 && received[0].magic === 101 && hex(received[0].payload) === hex(auth), 'reassembly') + const payload = protocol.bytes(13, protocol.bytes(3, protocol.concat(protocol.integer(1, 12), protocol.integer(2, 2)))) + const event = protocol.decodeGlassesInput({ sid: 224, flag: 1, payload, command: 0, magic: 0 }) + assert(event?.kind === 'display-wake' && event.eventSource === 2, 'event') + const transport = new CfwTransport() + const packets = transport.encode(new Uint8Array(128).fill(9), 255, 3, 185) + assert(packets.length > 0 && packets.every(p => p.length <= 185), 'compression') + transport.reset() + assert(parseCfwAcks(new Uint8Array()) === null, 'invalid ACK') + const c = new SurfaceCompositor(3, 2) + c.configureSurface('test', { x: 0, y: 0, width: 3, height: 2, zOrder: 0, transparency: 'opaque' }) + c.submitSurfaceFrame('test', new Uint8Array([0, 16, 255, 32, 48, 64]), { x: 0, y: 0, width: 3, height: 2 }) + assert(hex(c.composite()) === '0010ff203040', 'composition') + assert(hex(protocol.packGray4(c.composite(), 3, 2)) === '01f02340', 'packing') + c.setScreenBlanked(true); assert(c.composite().every(p => p === 0), 'blanking') + const changed = new Uint8Array(16); changed[0] = 255 + assert(buildBoundingBoxPayload(new Uint8Array(16), changed, 8, 4, 1)?.[0] === 3, 'image update') + assert(lvglMetrics('/nonexistent/faceclaw-font').length === 0, 'font bridge') + console.log('FACECLAW_KOTLIN_PROTOCOL_PASS iOS') +} diff --git a/app/native/kotlin-protocol-smoke.ts b/app/native/kotlin-protocol-smoke.ts new file mode 100644 index 00000000..a99cc1e2 --- /dev/null +++ b/app/native/kotlin-protocol-smoke.ts @@ -0,0 +1,20 @@ +declare const com: any + +/** Development-only checks of NativeScript metadata and bulk ByteBuffer crossings. */ +export function runKotlinProtocolSmokeTest(): void { + const native = com.faceclaw.app + const hex = (data: any) => Array.from({ length: data.length }, (_, i) => (data[i] & 255).toString(16).padStart(2, '0')).join('') + const assert = (condition: boolean, what: string) => { if (!condition) throw new Error(`Kotlin protocol bridge: ${what}`) } + const auth = native.BleProtocol.buildAuthenticationRequest(101) + assert(hex(auth) === '080410651a0408011004', 'authentication') + const compositor = new native.SurfaceCompositor() + compositor.configureScreen(3, 2) + compositor.configureSurface('test', 0, 0, 3, 2, 0, 0) + const pixels = new Uint8Array([0, 16, 255, 32, 48, 64]) + compositor.submitSurface('test', new native.AndroidByteReader(pixels.buffer), 0, 0, 3, 2, '1') + assert(hex(compositor.composite().gray) === '0010ff203040', 'composition/ByteBuffer') + assert(hex(native.BmpUtil.pack4bppFromGray8(compositor.composite().gray, 3, 2)) === '01f02340', 'packing') + const id = native.ImageAtlas.ensure('kotlin-smoke', 3, 2, new native.AndroidByteReader(pixels.buffer)) + assert(id > 0 && native.ImageAtlas.get(id).width === 3, 'image atlas/reused buffer') + console.log('FACECLAW_KOTLIN_PROTOCOL_PASS Android') +} diff --git a/app/native/lvgl-font.ios.ts b/app/native/lvgl-font.ios.ts index 99dbdd01..2f84f401 100644 --- a/app/native/lvgl-font.ios.ts +++ b/app/native/lvgl-font.ios.ts @@ -1,16 +1,5 @@ -import { LvglFont } from '../graphics/lvgl-font' -import { readBinaryFile } from './file-access' -const cache = new Map() -function load(path: string): LvglFont { - let font = cache.get(path) - if (!font) { - const bytes = readBinaryFile(path) - if (!bytes) throw new Error('Cannot read LVGL font') - font = new LvglFont(bytes) - if (cache.size >= 2) cache.delete(cache.keys().next().value!) - cache.set(path, font) - } - return font -} -export function lvglMetrics(path: string): Uint8Array { return load(path).metrics } -export function lvglGlyph(path: string, codePoint: number): Uint8Array { return load(path).glyph(codePoint) } +import { fromData } from './kotlin-data' +declare const FaceclawKitIosProtocol: any +const protocol = FaceclawKitIosProtocol.new() +export function lvglMetrics(path: string): Uint8Array { return fromData(protocol.fontMetricsPath(path)) } +export function lvglGlyph(path: string, codePoint: number): Uint8Array { return fromData(protocol.fontGlyphPathCodePoint(path, codePoint)) } diff --git a/hooks/before-prepare/faceclaw-kotlin.js b/hooks/before-prepare/faceclaw-kotlin.js new file mode 100644 index 00000000..435b315f --- /dev/null +++ b/hooks/before-prepare/faceclaw-kotlin.js @@ -0,0 +1,8 @@ +const { buildKotlin, checkAndroidRuntime } = require('../../scripts/kotlin-build.cjs'); + +module.exports = function (hookArgs) { + // NativeScript parses hooks with an older JavaScript parser; avoid optional chaining. + const { platform, release } = hookArgs.prepareData; + if (platform === 'android') checkAndroidRuntime(); + return buildKotlin(platform, release ? 'release' : 'debug'); +}; diff --git a/native/kotlin/README.md b/native/kotlin/README.md new file mode 100644 index 00000000..441b6639 --- /dev/null +++ b/native/kotlin/README.md @@ -0,0 +1,79 @@ +# Shared Kotlin + +Both `main` and `ios-port` build the same Kotlin Multiplatform sources in +`native/kotlin/shared/src`. NativeScript's `before-prepare` hook builds an AAR +for Android or a static `FaceclawKit.xcframework` for iOS, then stages it in the +local `@faceclaw/kotlin` plugin. Generated binaries and Gradle caches are ignored. + +- `commonMain/kotlin`: wire protocol, fragmentation/reassembly, event decoding, + image/RLE/texture planning, retained surface composition, glyph/image atlases, + LVGL font parsing, spectral noise suppression, PNG/GIF/WAV encodings and + callback interfaces. +- `androidMain/kotlin`: monotonic clock, reentrant locks, JVM zlib and file I/O, + zero-copy `ByteBuffer` readers, firmware hashing/file writes and WAV file storage. +- `iosMain/kotlin`: monotonic clock, recursive locks, native zlib and POSIX file + reads, plus `NSData` facades for NativeScript's Objective-C bridge. + +The `com.faceclaw.app` package, `@JvmStatic` methods and `@JvmField` properties +preserve existing Java/NativeScript callers. Android's `java.nio.ByteBuffer` +entry points for atlases/composition now take `AndroidByteReader`, keeping the +bulk buffer crossing without putting Java APIs in common code. iOS uses +`IosByteReader` and `NSData`; binary bridges avoid per-element JS/native calls. + +## Platform boundaries + +`ProtocolPlatform` supplies clocks, locks and persistent deflaters. `expect` / +`actual` functions select default platform services at compilation. Stateful +transports and caches retain reentrant locking; callbacks still run on their +caller's thread. The migration does not introduce implicit UI-thread dispatch. +`OutboundMessage` and `CfwMessageWindow` require their owner's synchronization. + +`CfwTransport` uses ordered `SYNC_FLUSH` records with one persistent compression +context. Lens changes and replay resets reset that context. Owners can close it +explicitly; iOS also cleans up abandoned native allocations. GATT write modes +are mapped by platform adapters. + +`migrated-java-sources.json` lists each removed Java source and its Kotlin +replacement. Android's build removes precisely those stale generated copies +before compilation. `android-java-boundaries.json` inventories every retained +Java file and its Android API boundary: services/receivers, GATT, media, +WebView, SQLite, rendering, networking and JNI. The sherpa-onnx Java classes +remain the vendored Android JNI ABI. PNG/GIF adapters retain only Android +storage responsibilities; their codecs are shared. + +On `ios-port`, platform adapters route the existing TypeScript session and UI +logic through shared Kotlin for protocol builders, CRC/framing/reassembly, +event decoding, CFW compression/ACKs, changed-image regions, surface composition, +and LVGL glyphs. The original pure TypeScript implementations remain as Node +test references; NativeScript selects the `.ios.ts` native adapters. Features +not yet present in the iOS app can use the shared audio/recording and texture +classes without another Java port. + +## Build and validation + +Requires JDK 21, Android SDK 35 and the existing `wear/gradlew` wrapper. iOS +additionally requires macOS, Xcode and an arm64 simulator. Configure paths in +`build_paths.sh`. Both production and tests use Kotlin 2.4.20 and Android KMP +plugin 8.13.2. + +```sh +npm ci +# Once when upgrading an existing generated Android platform to runtime 9.1.1: +npx nativescript platform clean android +npm run test:kotlin +npm run test:kotlin:ios +./build.sh +# In ios-port: +./scripts/ios.sh build ios --emulator +``` + +`tests/kotlin` compiles production sources directly. Common tests run on JVM +and iOS: wire vectors, framing/corruption/expiry, streaming compression, replay, +composition, PNG pixels, font glyphs, and Java SHA-256 golden outputs for DSP +and GIF. Android additionally runs the existing Java protocol fixtures and +concurrency checks; iOS exercises `NSData` and compositor adapters. Debug app +startup checks real NativeScript metadata and bidirectional callbacks, logging +`FACECLAW_KOTLIN_BRIDGE_PASS` and `FACECLAW_KOTLIN_PROTOCOL_PASS`. + +These checks require no BLE hardware. Physical glasses/ring behavior still +needs device testing, particularly sustained rendering and microphone traffic. diff --git a/native/kotlin/android-java-boundaries.json b/native/kotlin/android-java-boundaries.json new file mode 100644 index 00000000..9bef130a --- /dev/null +++ b/native/kotlin/android-java-boundaries.json @@ -0,0 +1,136 @@ +[ + { + "reason": "BluetoothGatt, BluetoothLeScanner, Android callback threads", + "files": [ + "com/faceclaw/app/FaceclawBleCommunicator.java", + "com/faceclaw/app/FaceclawBleManager.java", + "com/faceclaw/app/FaceclawDeviceDiscovery.java", + "com/faceclaw/app/FaceclawDeviceInfoProbe.java", + "com/faceclaw/app/FaceclawFirmwareFlasher.java", + "com/faceclaw/app/FaceclawFlashPromptCommunicator.java" + ] + }, + { + "reason": "AlarmManager, PendingIntent, Android activities/services/receivers", + "files": [ + "com/faceclaw/app/FaceclawAlarmActivity.java", + "com/faceclaw/app/FaceclawAlarmReceiver.java", + "com/faceclaw/app/FaceclawAlarmRescheduleReceiver.java", + "com/faceclaw/app/FaceclawAlarmService.java", + "com/faceclaw/app/FaceclawAlarms.java", + "com/faceclaw/app/FaceclawForegroundService.java" + ] + }, + { + "reason": "Android providers, sensors, permissions and preferences", + "files": [ + "com/faceclaw/app/FaceclawCalendarProvider.java", + "com/faceclaw/app/FaceclawLocationProvider.java", + "com/faceclaw/app/FaceclawLocationTracker.java", + "com/faceclaw/app/FaceclawSettings.java", + "com/faceclaw/app/FaceclawSettingsPortReceiver.java", + "com/faceclaw/app/FaceclawResourceUsage.java" + ] + }, + { + "reason": "Android MediaSession, notifications, status icons and wearable services", + "files": [ + "com/faceclaw/app/FaceclawMediaBrowser.java", + "com/faceclaw/app/FaceclawMediaController.java", + "com/faceclaw/app/FaceclawMediaNotificationListenerService.java", + "com/faceclaw/app/FaceclawSystemStatusIconProvider.java", + "com/faceclaw/app/FaceclawWearBridge.java", + "com/faceclaw/app/FaceclawWearListenerService.java" + ] + }, + { + "reason": "Android WebView/JavascriptInterface, package manager and intent integration", + "files": [ + "com/faceclaw/app/FaceclawEvenAppDetector.java", + "com/faceclaw/app/FaceclawEvenHubDocumentStart.java", + "com/faceclaw/app/FaceclawEvenHubJsBridge.java", + "com/faceclaw/app/FaceclawEvenHubWebView.java", + "com/faceclaw/app/FaceclawEvenHubWebViewClient.java", + "com/faceclaw/app/FaceclawEvenHubWebViewHost.java" + ] + }, + { + "reason": "Android AudioRecord/AudioTrack/MediaCodec, Handler delivery and JNI speech/model engines", + "files": [ + "com/faceclaw/app/AndroidNoiseEffects.java", + "com/faceclaw/app/FaceclawAudioTranscoder.java", + "com/faceclaw/app/FaceclawCaptionEngine.java", + "com/faceclaw/app/FaceclawDiarizer.java", + "com/faceclaw/app/FaceclawLc3Decoder.java", + "com/faceclaw/app/FaceclawLlamaRunner.java", + "com/faceclaw/app/FaceclawSpeakerId.java", + "com/faceclaw/app/FaceclawVoiceController.java" + ] + }, + { + "reason": "Android SQLite persistence and cursor/content APIs", + "files": [ + "com/faceclaw/app/FaceclawConversationStore.java" + ] + }, + { + "reason": "Android OkHttp backend, Handler/Log delivery, download lifecycle", + "files": [ + "com/faceclaw/app/FaceclawHttp.java", + "com/faceclaw/app/FaceclawModelDownloader.java", + "com/faceclaw/app/FaceclawSseRequest.java", + "com/faceclaw/app/FaceclawWebSocket.java" + ] + }, + { + "reason": "Android Bitmap/Canvas/Paint/typeface, SVG rasterization and camera scanning", + "files": [ + "com/faceclaw/app/FontFileRenderer.java", + "com/faceclaw/app/IconRenderer.java", + "com/faceclaw/app/ImageFileLoader.java", + "com/faceclaw/app/PreviewBitmapUtil.java", + "com/faceclaw/app/FaceclawQrScanner.java" + ] + }, + { + "reason": "Android preview/UI delivery and app-scoped export paths; codecs/composition are shared", + "files": [ + "com/faceclaw/app/FaceclawPreviewCompositor.java", + "com/faceclaw/app/GifScreenRecorder.java", + "com/faceclaw/app/ScreenshotUtil.java" + ] + }, + { + "reason": "Android elapsedRealtime, worker wait/notify and Context-backed trace export", + "files": [ + "com/faceclaw/app/FrameTimings.java", + "com/faceclaw/app/util/InterruptibleSleep.java" + ] + }, + { + "reason": "Vendored sherpa-onnx JNI ABI: Java classes/fields are consumed by the Android native library; iOS uses its native engine APIs.", + "files": [ + "com/k2fsa/sherpa/onnx/FastClusteringConfig.java", + "com/k2fsa/sherpa/onnx/FeatureConfig.java", + "com/k2fsa/sherpa/onnx/HomophoneReplacerConfig.java", + "com/k2fsa/sherpa/onnx/OfflineModelConfig.java", + "com/k2fsa/sherpa/onnx/OfflineMoonshineModelConfig.java", + "com/k2fsa/sherpa/onnx/OfflineRecognizer.java", + "com/k2fsa/sherpa/onnx/OfflineRecognizerConfig.java", + "com/k2fsa/sherpa/onnx/OfflineRecognizerResult.java", + "com/k2fsa/sherpa/onnx/OfflineSpeakerDiarization.java", + "com/k2fsa/sherpa/onnx/OfflineSpeakerDiarizationCallback.java", + "com/k2fsa/sherpa/onnx/OfflineSpeakerDiarizationConfig.java", + "com/k2fsa/sherpa/onnx/OfflineSpeakerDiarizationSegment.java", + "com/k2fsa/sherpa/onnx/OfflineSpeakerSegmentationModelConfig.java", + "com/k2fsa/sherpa/onnx/OfflineSpeakerSegmentationPyannoteModelConfig.java", + "com/k2fsa/sherpa/onnx/OfflineStream.java", + "com/k2fsa/sherpa/onnx/OfflineWhisperModelConfig.java", + "com/k2fsa/sherpa/onnx/OnlineStream.java", + "com/k2fsa/sherpa/onnx/QnnConfig.java", + "com/k2fsa/sherpa/onnx/SpeakerEmbeddingExtractor.java", + "com/k2fsa/sherpa/onnx/SpeakerEmbeddingExtractorConfig.java", + "com/k2fsa/sherpa/onnx/SpeakerEmbeddingManager.java" + ] + } +] diff --git a/native/kotlin/build.gradle.kts b/native/kotlin/build.gradle.kts new file mode 100644 index 00000000..fca20d61 --- /dev/null +++ b/native/kotlin/build.gradle.kts @@ -0,0 +1,4 @@ +plugins { + kotlin("multiplatform") version "2.4.20" apply false + id("com.android.kotlin.multiplatform.library") version "8.13.2" apply false +} diff --git a/native/kotlin/migrated-java-sources.json b/native/kotlin/migrated-java-sources.json new file mode 100644 index 00000000..2342cdf2 --- /dev/null +++ b/native/kotlin/migrated-java-sources.json @@ -0,0 +1,198 @@ +[ + { + "java": "com/faceclaw/app/LvglFontFile.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/graphics/LvglFontFile.kt" + }, + { + "java": "com/faceclaw/app/FaceclawAlarmListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawAlarmListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawAmbientLightListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawAmbientLightListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawAudioPacketListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawAudioPacketListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawBleCommunicatorListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawBleCommunicatorListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawBleListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawBleListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawCaptionEngineListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawCaptionEngineListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawCompassListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawCompassListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawDeviceDiscoveryListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawDeviceDiscoveryListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawDeviceInfoProbeListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawDeviceInfoProbeListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawEvenHubListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawEvenHubListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawFirmwareFlasherListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawFirmwareFlasherListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawFlashPromptListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawFlashPromptListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawImuListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawImuListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawLlamaListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawLlamaListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawLocationListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawLocationListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawLocationTrackerListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawLocationTrackerListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawMediaBrowserListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawMediaBrowserListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawMediaControllerListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawMediaControllerListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawMicStatusListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawMicStatusListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawModelDownloaderListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawModelDownloaderListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawNoiseSuppressor.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/audio/FaceclawNoiseSuppressor.kt" + }, + { + "java": "com/faceclaw/app/FaceclawNotificationListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawNotificationListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawQrScannerListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawQrScannerListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawRingEventDecoder.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/FaceclawRingEventDecoder.kt" + }, + { + "java": "com/faceclaw/app/FaceclawSettingsListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawSettingsListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawSseListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawSseListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawVoiceControllerListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawVoiceControllerListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawWearListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawWearListener.kt" + }, + { + "java": "com/faceclaw/app/FaceclawWebSocketListener.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawWebSocketListener.kt" + }, + { + "java": "com/faceclaw/app/FwGlyphAtlas.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/graphics/FwGlyphAtlas.kt" + }, + { + "java": "com/faceclaw/app/g2protocol/BleImageOptimizer.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/BleImageOptimizer.kt" + }, + { + "java": "com/faceclaw/app/g2protocol/BleMagicPool.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/BleMagicPool.kt" + }, + { + "java": "com/faceclaw/app/g2protocol/BleProtocol.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/BleProtocol.kt" + }, + { + "java": "com/faceclaw/app/g2protocol/CfwMessageWindow.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/CfwMessageWindow.kt" + }, + { + "java": "com/faceclaw/app/g2protocol/CfwTransport.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/CfwTransport.kt" + }, + { + "java": "com/faceclaw/app/g2protocol/ConnectionOptions.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/ConnectionOptions.kt" + }, + { + "java": "com/faceclaw/app/g2protocol/G2Event.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/G2Event.kt" + }, + { + "java": "com/faceclaw/app/g2protocol/MessageBuilder.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/MessageBuilder.kt" + }, + { + "java": "com/faceclaw/app/g2protocol/OutboundMessage.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/OutboundMessage.kt" + }, + { + "java": "com/faceclaw/app/g2protocol/TextureCacheState.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/TextureCacheState.kt" + }, + { + "java": "com/faceclaw/app/g2protocol/TexturePlanner.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/TexturePlanner.kt" + }, + { + "java": "com/faceclaw/app/GlyphAtlas.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/graphics/GlyphAtlas.kt" + }, + { + "java": "com/faceclaw/app/ImageAtlas.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/graphics/ImageAtlas.kt" + }, + { + "java": "com/faceclaw/app/SurfaceCompositor.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/graphics/SurfaceCompositor.kt" + }, + { + "java": "com/faceclaw/app/util/BmpUtil.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/util/BmpUtil.kt" + }, + { + "java": "com/faceclaw/app/util/CollectionUtils.java", + "kotlin": "shared/src/commonMain/kotlin/com/faceclaw/app/util/CollectionUtils.kt" + }, + { + "java": "com/faceclaw/app/FaceclawFirmwareUtil.java", + "kotlin": "shared/src/androidMain/kotlin/com/faceclaw/app/FaceclawFirmwareUtil.kt" + }, + { + "java": "com/faceclaw/app/FaceclawWavRecorder.java", + "kotlin": "shared/src/androidMain/kotlin/com/faceclaw/app/FaceclawWavRecorder.kt" + } +] diff --git a/native/kotlin/plugin/index.js b/native/kotlin/plugin/index.js new file mode 100644 index 00000000..6e600195 --- /dev/null +++ b/native/kotlin/plugin/index.js @@ -0,0 +1 @@ +// Native APIs are exposed by NativeScript's platform metadata. diff --git a/native/kotlin/plugin/package.json b/native/kotlin/plugin/package.json new file mode 100644 index 00000000..0ed01162 --- /dev/null +++ b/native/kotlin/plugin/package.json @@ -0,0 +1,7 @@ +{ + "name": "@faceclaw/kotlin", + "version": "0.1.0", + "private": true, + "main": "index.js", + "nativescript": { "platforms": { "android": "9.1.1", "ios": "9.0.3" } } +} diff --git a/native/kotlin/plugin/platforms/android/include.gradle b/native/kotlin/plugin/platforms/android/include.gradle new file mode 100644 index 00000000..99f51576 --- /dev/null +++ b/native/kotlin/plugin/platforms/android/include.gradle @@ -0,0 +1,3 @@ +dependencies { + implementation "org.jetbrains.kotlin:kotlin-stdlib:2.4.20" +} diff --git a/native/kotlin/settings.gradle.kts b/native/kotlin/settings.gradle.kts new file mode 100644 index 00000000..b1c53109 --- /dev/null +++ b/native/kotlin/settings.gradle.kts @@ -0,0 +1,4 @@ +pluginManagement { repositories { google(); mavenCentral(); gradlePluginPortal() } } +dependencyResolutionManagement { repositories { google(); mavenCentral() } } +rootProject.name = "FaceclawKotlin" +include(":shared") diff --git a/native/kotlin/shared/build.gradle.kts b/native/kotlin/shared/build.gradle.kts new file mode 100644 index 00000000..cdcf1f87 --- /dev/null +++ b/native/kotlin/shared/build.gradle.kts @@ -0,0 +1,25 @@ +import org.jetbrains.kotlin.gradle.dsl.JvmTarget +import org.jetbrains.kotlin.gradle.plugin.mpp.apple.XCFramework + +plugins { + kotlin("multiplatform") + id("com.android.kotlin.multiplatform.library") +} +kotlin { + android { + namespace = "com.faceclaw.shared" + compileSdk = 35 + minSdk = 24 + compilerOptions { jvmTarget.set(JvmTarget.JVM_17) } + withHostTestBuilder {}.configure {} + } + val framework = XCFramework("FaceclawKit") + listOf(iosArm64(), iosSimulatorArm64()).forEach { target -> + target.binaries.framework { + baseName = "FaceclawKit" + isStatic = true + binaryOption("bundleId", "com.faceclaw.shared") + framework.add(this) + } + } +} diff --git a/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/AndroidByteReader.kt b/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/AndroidByteReader.kt new file mode 100644 index 00000000..cd9e6710 --- /dev/null +++ b/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/AndroidByteReader.kt @@ -0,0 +1,20 @@ +package com.faceclaw.app + +import java.nio.ByteBuffer + +/** NativeScript's ArrayBuffer-backed ByteBuffer stays on the JVM side. */ +class AndroidByteReader(buffer: ByteBuffer) : ByteReader() { + // NativeScript can reuse the same ByteBuffer for an ArrayBuffer. Reading one + // frame must not advance the cursor used by a later atlas/preview crossing. + private val buffer = buffer.duplicate() + override fun remaining(): Int = buffer.remaining() + + override fun get(): Byte = buffer.get() + + override fun get(index: Int): Byte = buffer.get(index) + + override fun get(bytes: ByteArray, offset: Int, length: Int): ByteReader { + buffer.get(bytes, offset, length) + return this + } +} diff --git a/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/FaceclawFirmwareUtil.kt b/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/FaceclawFirmwareUtil.kt new file mode 100644 index 00000000..79b5f3a1 --- /dev/null +++ b/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/FaceclawFirmwareUtil.kt @@ -0,0 +1,31 @@ +package com.faceclaw.app + +import java.io.FileOutputStream +import java.nio.ByteBuffer +import java.security.MessageDigest + +/** Android's bulk ByteBuffer boundary avoids per-byte NativeScript crossings. */ +object FaceclawFirmwareUtil { + @JvmStatic fun bytesToHex(bytes: ByteArray?): String = BinaryEncoding.bytesToHex(bytes) + + @JvmStatic + fun sha256Hex(data: ByteBuffer): String { + val digest = MessageDigest.getInstance("SHA-256") + digest.update(data.duplicate()) + return bytesToHex(digest.digest()) + } + + @JvmStatic + fun writeFile(path: String, data: ByteBuffer) { + try { + FileOutputStream(path).use { file -> + file.channel.use { channel -> + val view = data.duplicate() + while (view.hasRemaining()) channel.write(view) + } + } + } catch (e: java.io.IOException) { + throw RuntimeException("firmware write failed: ${e.message}", e) + } + } +} diff --git a/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/FaceclawWavRecorder.kt b/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/FaceclawWavRecorder.kt new file mode 100644 index 00000000..8e0d8482 --- /dev/null +++ b/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/FaceclawWavRecorder.kt @@ -0,0 +1,72 @@ +package com.faceclaw.app + +import android.util.Log +import java.io.File +import java.io.IOException +import java.io.RandomAccessFile + +/** Android streaming file adapter; the PCM/WAV format is shared Kotlin. */ +class FaceclawWavRecorder +@Throws(IOException::class) +constructor( + private val path: String, + private val sampleRate: Int, + private val channels: Int, +) { + private var file: RandomAccessFile? + private var dataBytes = 0L + + init { + val parent = File(path).parentFile + if (parent != null && !parent.exists() && !parent.mkdirs()) + throw IOException("could not create $parent") + file = + RandomAccessFile(path, "rw").also { + it.setLength(0) + it.write(BinaryEncoding.wavHeader(0, sampleRate, channels)) + } + } + + @Synchronized + fun append(pcm16le: ByteArray?) { + val current = file ?: return + if (pcm16le == null || pcm16le.isEmpty()) return + try { + current.write(pcm16le) + dataBytes += pcm16le.size + } catch (e: IOException) { + Log.w("FaceclawWavRecorder", "append failed", e) + } + } + + @Synchronized fun getDurationMs(): Long = dataBytes * 1000L / (sampleRate * channels * 2L) + + fun getPath(): String = path + + @Synchronized + fun finish(): Long { + val current = file ?: return dataBytes + file = null + try { + current.use { + it.seek(0) + it.write( + BinaryEncoding.wavHeader( + minOf(dataBytes, Int.MAX_VALUE.toLong()).toInt(), + sampleRate, + channels, + ) + ) + } + } catch (e: IOException) { + Log.w("FaceclawWavRecorder", "finish failed", e) + } + return dataBytes + } + + @Synchronized + fun discard() { + finish() + File(path).delete() + } +} diff --git a/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/PlatformServices.android.kt b/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/PlatformServices.android.kt new file mode 100644 index 00000000..9aa0f905 --- /dev/null +++ b/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/PlatformServices.android.kt @@ -0,0 +1,41 @@ +package com.faceclaw.app + +internal actual fun protocolPlatform(): ProtocolPlatform = AndroidProtocolPlatform + +internal actual fun readFileData(path: String): ByteArray { + val file = java.io.File(path) + require(file.isFile && file.canRead() && file.length() <= Int.MAX_VALUE) + return file.readBytes() +} + +internal actual fun deflateData(bytes: ByteArray): ByteArray { + val encoder = java.util.zip.Deflater() + try { + encoder.setInput(bytes) + encoder.finish() + val out = ByteSink() + val buffer = ByteArray(8192) + while (!encoder.finished()) out.write(buffer, 0, encoder.deflate(buffer)) + return out.toByteArray() + } finally { + encoder.end() + } +} + +internal actual fun inflateData(bytes: ByteArray, size: Int): ByteArray { + val decoder = java.util.zip.Inflater() + try { + decoder.setInput(bytes) + val result = ByteArray(size) + var offset = 0 + while (offset < size && !decoder.finished()) { + val count = decoder.inflate(result, offset, size - offset) + if (count == 0) break + offset += count + } + check(offset == size) { "recorded frame truncated: $offset of $size" } + return result + } finally { + decoder.end() + } +} diff --git a/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/g2protocol/AndroidProtocolPlatform.kt b/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/g2protocol/AndroidProtocolPlatform.kt new file mode 100644 index 00000000..b5667e1d --- /dev/null +++ b/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/app/g2protocol/AndroidProtocolPlatform.kt @@ -0,0 +1,48 @@ +package com.faceclaw.app + +import android.bluetooth.BluetoothGattCharacteristic +import android.os.SystemClock +import java.io.ByteArrayOutputStream +import java.util.concurrent.locks.ReentrantLock +import java.util.zip.Deflater + +object AndroidProtocolPlatform : ProtocolPlatform { + override fun elapsedRealtimeMs(): Long = SystemClock.elapsedRealtime() + + override fun createLock(): ProtocolLock = + object : ProtocolLock { + private val lock = ReentrantLock() + + override fun lock() = lock.lock() + + override fun unlock() = lock.unlock() + } + + override fun createDeflater(): ProtocolDeflater = AndroidDeflater() + + @JvmStatic + fun writeType(mode: GattWriteMode): Int = + when (mode) { + GattWriteMode.WITH_RESPONSE -> BluetoothGattCharacteristic.WRITE_TYPE_DEFAULT + GattWriteMode.WITHOUT_RESPONSE -> BluetoothGattCharacteristic.WRITE_TYPE_NO_RESPONSE + } +} + +private class AndroidDeflater : ProtocolDeflater { + private val deflater = Deflater() + + override fun reset() = deflater.reset() + + override fun syncFlush(message: ByteArray): ByteArray { + deflater.setInput(message) + val out = ByteArrayOutputStream() + val chunk = ByteArray(4096) + do { + val count = deflater.deflate(chunk, 0, chunk.size, Deflater.SYNC_FLUSH) + out.write(chunk, 0, count) + } while (count == chunk.size) + return out.toByteArray() + } + + override fun close() = deflater.end() +} diff --git a/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/shared/PlatformInfo.android.kt b/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/shared/PlatformInfo.android.kt new file mode 100644 index 00000000..08e3fbdd --- /dev/null +++ b/native/kotlin/shared/src/androidMain/kotlin/com/faceclaw/shared/PlatformInfo.android.kt @@ -0,0 +1,11 @@ +package com.faceclaw.shared + +import android.os.Looper + +internal actual object PlatformInfo { + actual val name: String = "Android" + + actual fun threadName(): String = Thread.currentThread().name + + actual fun isMainThread(): Boolean = Looper.myLooper() == Looper.getMainLooper() +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/PlatformServices.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/PlatformServices.kt new file mode 100644 index 00000000..9d0f0dca --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/PlatformServices.kt @@ -0,0 +1,10 @@ +package com.faceclaw.app + +/** Platform selection happens at compilation; protocol algorithms stay shared. */ +internal expect fun protocolPlatform(): ProtocolPlatform + +internal expect fun deflateData(bytes: ByteArray): ByteArray + +internal expect fun inflateData(bytes: ByteArray, size: Int): ByteArray + +internal expect fun readFileData(path: String): ByteArray diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/audio/FaceclawNoiseSuppressor.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/audio/FaceclawNoiseSuppressor.kt new file mode 100644 index 00000000..db247853 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/audio/FaceclawNoiseSuppressor.kt @@ -0,0 +1,263 @@ +package com.faceclaw.app + +import kotlin.math.roundToInt + +/** + * Spectral suppression for PCM from glasses microphones: 16 ms sqrt-Hann frames at 50% overlap, + * asymmetric noise-floor tracking and a smoothed Wiener gain. Android capture-session effects live + * in AndroidNoiseEffects. This processor has no platform dependencies and must be owned by a single + * audio worker. + */ +class FaceclawNoiseSuppressor { + companion object { + private const val FFT_SIZE: Int = 256 + + private val HOP: Int = (FFT_SIZE / 2) + + private val OVERSUBTRACTION: Float = 1.6f + + /** About -16 dB of residual: keeps the noise bed natural instead of gated. */ + private val GAIN_FLOOR: Float = 0.15f + + private val GAIN_SMOOTHING: Float = 0.6f + + /** Frames of pure noise-floor learning after start/reset (~100 ms). */ + private const val NOISE_WARMUP_FRAMES: Int = 12 + + /** In-place iterative radix-2 FFT (inverse includes the 1/N scale). */ + private fun fft(re: FloatArray, im: FloatArray, inverse: Boolean): Unit { + var n: Int = re.size + run { + var i: Int = 1 + var j: Int = 0 + while ((i < n)) { + var bit: Int = (n shr 1) + run { + while (((j and bit) != 0)) { + j = (j xor bit) + bit = (bit shr 1) + } + } + j = (j xor bit) + if ((i < j)) { + var t: Float = re[i] + re[i] = re[j] + re[j] = t + t = im[i] + im[i] = im[j] + im[j] = t + } + i++ + } + } + run { + var len: Int = 2 + while ((len <= n)) { + var ang: Double = (((2 * kotlin.math.PI) / len) * (if (inverse) 1 else -1)) + var wRe: Float = (kotlin.math.cos(ang)).toFloat() + var wIm: Float = (kotlin.math.sin(ang)).toFloat() + run { + var i: Int = 0 + while ((i < n)) { + var curRe: Float = 1f + var curIm: Float = 0f + run { + var k: Int = 0 + while ((k < (len / 2))) { + var a: Int = (i + k) + var b: Int = (a + (len / 2)) + var xr: Float = ((re[b] * curRe) - (im[b] * curIm)) + var xi: Float = ((re[b] * curIm) + (im[b] * curRe)) + re[b] = (re[a] - xr) + im[b] = (im[a] - xi) + re[a] += xr + im[a] += xi + var nextRe: Float = ((curRe * wRe) - (curIm * wIm)) + curIm = ((curRe * wIm) + (curIm * wRe)) + curRe = nextRe + k++ + } + } + i += len + } + } + len = (len shl 1) + } + } + if (inverse) { + run { + var i: Int = 0 + while ((i < n)) { + re[i] /= n + im[i] /= n + i++ + } + } + } + } + } + + private val sampleRate: Int + + private val window: FloatArray = FloatArray(FFT_SIZE) + + private val history: FloatArray = FloatArray(FFT_SIZE) + + private val overlap: FloatArray = FloatArray(HOP) + + private val noise: FloatArray = FloatArray(((FFT_SIZE / 2) + 1)) + + private val gain: FloatArray = FloatArray(((FFT_SIZE / 2) + 1)) + + private val re: FloatArray = FloatArray(FFT_SIZE) + + private val im: FloatArray = FloatArray(FFT_SIZE) + + private val pending: ShortArray = ShortArray(HOP) + + private var pendingCount: Int = 0 + + private var warmupFrames: Int = 0 + + constructor(sampleRate: Int) { + this.sampleRate = sampleRate + run { + var i: Int = 0 + while ((i < FFT_SIZE)) { + window[i] = (kotlin.math.sin(((kotlin.math.PI * (i + 0.5)) / FFT_SIZE))).toFloat() + i++ + } + } + reset() + } + + fun getSampleRate(): Int { + return sampleRate + } + + /** Forget the learned noise floor (e.g. after the suppressor was toggled off). */ + fun reset(): Unit { + history.fill(0f) + overlap.fill(0f) + noise.fill(0f) + gain.fill(1f) + pendingCount = 0 + warmupFrames = 0 + } + + /** + * Suppress noise in 16-bit little-endian mono PCM. Streaming: input not filling a whole 8 ms + * hop is carried into the next call, so the output may be up to one hop shorter than the input + * (and longer on a later call); total latency is one hop. + */ + fun process(pcm16le: ByteArray?): ByteArray? { + if (((pcm16le == null) || (pcm16le.size < 2))) { + return pcm16le + } + var sampleCount: Int = (pcm16le.size / 2) + var hops: Int = ((pendingCount + sampleCount) / HOP) + var out: ByteArray = ByteArray(((hops * HOP) * 2)) + var outPos: Int = 0 + var inPos: Int = 0 + while ((inPos < sampleCount)) { + var take: Int = minOf((HOP - pendingCount), (sampleCount - inPos)) + run { + var i: Int = 0 + while ((i < take)) { + var lo: Int = (pcm16le[((inPos + i) * 2)] and 0xff) + var hi: Int = pcm16le[(((inPos + i) * 2) + 1)].toInt() + pending[(pendingCount + i)] = (((hi shl 8) or lo)).toShort() + i++ + } + } + pendingCount += take + inPos += take + if ((pendingCount == HOP)) { + outPos = processHop(out, outPos) + pendingCount = 0 + } + } + return out + } + + private fun processHop(out: ByteArray, outPos: Int): Int { + var outPos = outPos + history.copyInto(history, 0, HOP, HOP + (FFT_SIZE - HOP)) + run { + var i: Int = 0 + while ((i < HOP)) { + history[((FFT_SIZE - HOP) + i)] = (pending[i] / 32768f) + i++ + } + } + run { + var i: Int = 0 + while ((i < FFT_SIZE)) { + re[i] = (history[i] * window[i]) + im[i] = 0f + i++ + } + } + fft(re, im, false) + var warming: Boolean = (warmupFrames < NOISE_WARMUP_FRAMES) + if (warming) { + warmupFrames++ + } + run { + var b: Int = 0 + while ((b <= (FFT_SIZE / 2))) { + var power: Float = ((re[b] * re[b]) + (im[b] * im[b])) + if (warming) { + noise[b] = + (if ((warmupFrames == 1)) power + else (noise[b] + ((power - noise[b]) / warmupFrames))) + } else { + if ((power < noise[b])) { + noise[b] += ((power - noise[b]) * 0.2f) + } else { + noise[b] = minOf(power, ((noise[b] * 1.006f) + 1e-10f)) + } + } + var clean: Float = (power - (OVERSUBTRACTION * noise[b])) + var g: Float = (if ((clean > 0f)) (clean / power) else 0f) + if ((g < GAIN_FLOOR)) { + g = GAIN_FLOOR + } + g = ((GAIN_SMOOTHING * gain[b]) + ((1f - GAIN_SMOOTHING) * g)) + gain[b] = g + re[b] *= g + im[b] *= g + if (((b > 0) && (b < (FFT_SIZE / 2)))) { + re[(FFT_SIZE - b)] *= g + im[(FFT_SIZE - b)] *= g + } + b++ + } + } + fft(re, im, true) + run { + var i: Int = 0 + while ((i < HOP)) { + var value: Float = ((overlap[i] + (re[i] * window[i])) * 32767f) + var sample: Int = value.roundToInt() + if ((sample > 32767)) { + sample = 32767 + } + if ((sample < -32768)) { + sample = -32768 + } + out[(outPos + (i * 2))] = ((sample and 0xff)).toByte() + out[((outPos + (i * 2)) + 1)] = (((sample shr 8) and 0xff)).toByte() + i++ + } + } + run { + var i: Int = 0 + while ((i < HOP)) { + overlap[i] = (re[(HOP + i)] * window[(HOP + i)]) + i++ + } + } + return (outPos + (HOP * 2)) + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawAlarmListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawAlarmListener.kt new file mode 100644 index 00000000..63bcd1c4 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawAlarmListener.kt @@ -0,0 +1,6 @@ +package com.faceclaw.app + +/** Phone-side alarm actions (dismiss / snooze), delivered to the JS engine; implemented in JS. */ +interface FaceclawAlarmListener { + fun onPhoneAction(id: Long, action: String?, minutes: Int): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawAmbientLightListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawAmbientLightListener.kt new file mode 100644 index 00000000..edf3cddd --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawAmbientLightListener.kt @@ -0,0 +1,10 @@ +package com.faceclaw.app + +interface FaceclawAmbientLightListener { + /** + * A CFW ambient-light report (settings-channel field 105) from the master temple. body is the + * raw 24-byte ['A','L',ver,reason,...] record; it is decoded on the TS side + * (app/native/ambient-light.ts). + */ + fun onAmbientLight(body: ByteArray?): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawAudioPacketListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawAudioPacketListener.kt new file mode 100644 index 00000000..fb5364eb --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawAudioPacketListener.kt @@ -0,0 +1,5 @@ +package com.faceclaw.app + +interface FaceclawAudioPacketListener { + fun onAudioPacket(data: ByteArray?, arm: String?, arrivalMs: Long): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawBleCommunicatorListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawBleCommunicatorListener.kt new file mode 100644 index 00000000..59a79b07 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawBleCommunicatorListener.kt @@ -0,0 +1,37 @@ +package com.faceclaw.app + +interface FaceclawBleCommunicatorListener { + fun onLog(line: String?): Unit + + fun onStateChange(phase: String?, status: String?): Unit + + fun onRingEvent( + kind: String?, + containerName: String?, + eventType: Int, + eventSource: Int, + systemExitReasonCode: Int, + frameId: Int, + ): Unit + + fun onBatteryState( + headsetBattery: Int, + headsetCharging: Int, + ringBattery: Int, + ringCharging: Int, + ): Unit + + fun onSilentMode(silent: Boolean): Unit + + fun onWearState(wearing: Boolean): Unit + + fun onPhoneLockState(locked: Boolean): Unit + + fun onEvenAppConflict(message: String?): Unit + + fun onFrameMetrics(paintMs: Int, transmitMs: Int, tileCount: Int): Unit + + fun onFrameFinished(frameId: Int, outcome: String?): Unit + + fun onFirmwareInfo(leftVersion: String?, rightVersion: String?, extension: String?): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawBleListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawBleListener.kt new file mode 100644 index 00000000..ed676588 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawBleListener.kt @@ -0,0 +1,7 @@ +package com.faceclaw.app + +interface FaceclawBleListener { + fun onNotification(address: String?, characteristicUuid: String?, data: ByteArray?): Unit + + fun onConnectionStateChange(address: String?, connected: Boolean): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawCaptionEngineListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawCaptionEngineListener.kt new file mode 100644 index 00000000..857492de --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawCaptionEngineListener.kt @@ -0,0 +1,22 @@ +package com.faceclaw.app + +interface FaceclawCaptionEngineListener { + /** + * One finished utterance. text may be empty when no ASR model is loaded or recognition produced + * nothing; embedding is the L2-normalized voice-print or null when the speaker model is + * unavailable or the utterance was too short. startMs/endMs are on the engine's sample clock + * (milliseconds of audio since start()). + */ + fun onUtterance( + text: String?, + embedding: FloatArray?, + startMs: Long, + endMs: Long, + peakRms: Double, + ): Unit + + /** A speech onset was detected; the utterance is now being collected. */ + fun onSpeechStart(startMs: Long): Unit + + fun onStatus(status: String?): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawCompassListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawCompassListener.kt new file mode 100644 index 00000000..b9f3b3d2 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawCompassListener.kt @@ -0,0 +1,14 @@ +package com.faceclaw.app + +/** Receives stock compass heading and calibration notifications on the thread that subscribed. */ +interface FaceclawCompassListener { + fun onCompassEvent( + command: Int, + headingDegrees: Int, + magneticAccuracy: Int, + magneticAnomalies: Int, + orientationSource: Int, + diagnosticFlags: Int, + sampleTimeMs: Long, + ): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawDeviceDiscoveryListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawDeviceDiscoveryListener.kt new file mode 100644 index 00000000..b2a6137f --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawDeviceDiscoveryListener.kt @@ -0,0 +1,17 @@ +package com.faceclaw.app + +/** Callbacks from FaceclawDeviceDiscovery's live scan to the TypeScript layer. */ +interface FaceclawDeviceDiscoveryListener { + /** + * One advertisement (or one bonded device) as a JSON object: {address, name, manufacturerData + * (hex, company id included), rssi|null, txPower|null, connectable|null, bonded, source, + * seenAtMs}. Protocol decoding happens in TypeScript (see app/g2/even-advertisement.ts). + */ + fun onAdvertisement(json: String?): Unit + + /** The platform refused to start or continue the scan. */ + fun onScanFailed(errorCode: Int, message: String?): Unit + + /** Diagnostic line for the pairing log. */ + fun onLog(line: String?): Unit +} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawDeviceInfoProbeListener.java b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawDeviceInfoProbeListener.kt similarity index 52% rename from App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawDeviceInfoProbeListener.java rename to native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawDeviceInfoProbeListener.kt index fe02f55d..19ec10ad 100644 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawDeviceInfoProbeListener.java +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawDeviceInfoProbeListener.kt @@ -1,15 +1,15 @@ -package com.faceclaw.app; +package com.faceclaw.app /** Callbacks from FaceclawDeviceInfoProbe to the TypeScript layer. */ -public interface FaceclawDeviceInfoProbeListener { - void onLog(String line); +interface FaceclawDeviceInfoProbeListener { + fun onLog(line: String?): Unit /** Lifecycle: connecting/authenticating for each arm, then querying. */ - void onState(String state, String detail); + fun onState(state: String?, detail: String?): Unit /** Terminal success: firmware versions and the firmware-extension string (empty on stock). */ - void onResult(String leftVersion, String rightVersion, String extension); + fun onResult(leftVersion: String?, rightVersion: String?, extension: String?): Unit /** Terminal failure (couldn't connect or read the version). */ - void onError(String message); + fun onError(message: String?): Unit } diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawEvenHubListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawEvenHubListener.kt new file mode 100644 index 00000000..a1b3ee97 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawEvenHubListener.kt @@ -0,0 +1,18 @@ +package com.faceclaw.app + +/** + * Callbacks from a hosted EvenHub app's WebView to the TypeScript host. All methods are delivered + * on the Android main thread (NativeScript's JS thread), regardless of which WebView-internal + * thread produced them. + */ +interface FaceclawEvenHubListener { + /** + * The app invoked window.flutter_inappwebview.callHandler(handlerName, ...args). argsJson is + * the JSON-encoded argument array; callId identifies the promise to resolve via + * window.__fcResolve(callId, ok, value). + */ + fun onEvenAppMessage(handlerName: String?, argsJson: String?, callId: Int): Unit + + /** The WebView finished loading the app's page. */ + fun onPageFinished(url: String?): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawFirmwareFlasherListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawFirmwareFlasherListener.kt new file mode 100644 index 00000000..a918fc37 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawFirmwareFlasherListener.kt @@ -0,0 +1,30 @@ +package com.faceclaw.app + +/** Callbacks from FaceclawFirmwareFlasher to the TypeScript layer. */ +interface FaceclawFirmwareFlasherListener { + fun onLog(line: String?): Unit + + /** + * Fine-grained progress for the UI bar. `lens` is "left"/"right"; component/block indices are + * 1-based against their counts. `bytesSent` / `bytesTotal` cover the whole lens image, so a bar + * driven by them moves evenly even though the components differ wildly in size. + */ + fun onProgress( + lens: String?, + componentIndex: Int, + componentCount: Int, + blockIndex: Int, + blockCount: Int, + bytesSent: Long, + bytesTotal: Long, + ): Unit + + /** + * Coarse lifecycle. `state` is one of: validating, connecting, flashing, rebooting, done, + * error. `detail` carries the lens name or a message. + */ + fun onState(state: String?, detail: String?): Unit + + /** Terminal callback: success or failure, with an explanatory message. */ + fun onComplete(success: Boolean, detail: String?): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawFlashPromptListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawFlashPromptListener.kt new file mode 100644 index 00000000..04dc0531 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawFlashPromptListener.kt @@ -0,0 +1,25 @@ +package com.faceclaw.app + +/** Callbacks from FaceclawFlashPromptCommunicator to the TypeScript layer. */ +interface FaceclawFlashPromptListener { + fun onLog(line: String?): Unit + + /** + * Lifecycle updates. `state` is one of: connecting, connected, prompting, battery, result, + * cancelled, timeout, disconnected, error. `detail` carries the "approved"/"declined" text for + * result, or an error/explanation message. + */ + fun onState(state: String?, detail: String?): Unit + + /** + * Battery percent of each arm, read after the user approved (or right after auth when the + * prompt is skipped); -1 when an arm didn't answer. Always fires before onResult(true). + */ + fun onBattery(rightPercent: Int, leftPercent: Int): Unit + + /** + * Fires once the user picks a menu row (or, with skipPrompt, once the battery is read): true = + * flash, false = cancel. + */ + fun onResult(approved: Boolean): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawImuListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawImuListener.kt new file mode 100644 index 00000000..3dd17667 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawImuListener.kt @@ -0,0 +1,9 @@ +package com.faceclaw.app + +/** + * Receives IMU (accelerometer) readings decoded from the glasses' sys-event stream. Registered on + * FaceclawBleCommunicator via addImuListener; callbacks are delivered on the Android main thread. + */ +interface FaceclawImuListener { + fun onImuData(x: Double, y: Double, z: Double, eventSource: Int): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawLlamaListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawLlamaListener.kt new file mode 100644 index 00000000..31027dd7 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawLlamaListener.kt @@ -0,0 +1,16 @@ +package com.faceclaw.app + +/** + * Callbacks for one on-phone LLM generation. Like the other bridge listeners, implementations are + * typically created on the NativeScript JS thread and FaceclawLlamaRunner posts these callbacks + * back to that thread's Looper. + */ +interface FaceclawLlamaListener { + /** A piece of generated text (may be a partial word). */ + fun onToken(piece: String?): Unit + + /** Generation finished: "stop" (EOG), "length", or "cancelled". */ + fun onDone(stopReason: String?): Unit + + fun onError(message: String?): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawLocationListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawLocationListener.kt new file mode 100644 index 00000000..f74ac723 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawLocationListener.kt @@ -0,0 +1,13 @@ +package com.faceclaw.app + +/** One-shot Android location callbacks for the TypeScript Weather bridge. */ +interface FaceclawLocationListener { + fun onLocation( + latitude: Double, + longitude: Double, + accuracyMeters: Float, + timestampMs: Long, + ): Unit + + fun onError(message: String?): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawLocationTrackerListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawLocationTrackerListener.kt new file mode 100644 index 00000000..488dc09a --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawLocationTrackerListener.kt @@ -0,0 +1,19 @@ +package com.faceclaw.app + +/** Continuous location callbacks for the TypeScript navigation bridge. */ +interface FaceclawLocationTrackerListener { + /** + * A new fix. bearingDeg/speedMps are -1 when the fix doesn't carry them (common when + * stationary); accuracyMeters is -1 when unknown. + */ + fun onLocation( + latitude: Double, + longitude: Double, + accuracyMeters: Float, + bearingDeg: Float, + speedMps: Float, + timestampMs: Long, + ): Unit + + fun onError(message: String?): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawMediaBrowserListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawMediaBrowserListener.kt new file mode 100644 index 00000000..f71b6b2d --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawMediaBrowserListener.kt @@ -0,0 +1,10 @@ +package com.faceclaw.app + +interface FaceclawMediaBrowserListener { + fun onConnectResult(requestId: Int, connected: Boolean, rootId: String?, error: String?): Unit + + fun onBrowseResult(requestId: Int, childrenJson: String?, error: String?): Unit + + /** The service connection dropped after connecting (player crashed or was killed). */ + fun onDisconnected(): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawMediaControllerListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawMediaControllerListener.kt new file mode 100644 index 00000000..8b887dae --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawMediaControllerListener.kt @@ -0,0 +1,23 @@ +package com.faceclaw.app + +interface FaceclawMediaControllerListener { + /** All observed session owners, before filtering or choosing the active player. */ + fun onSessionAppsChanged(appsJson: String?): Unit + + fun onStateChange( + playbackState: String?, + packageName: String?, + appName: String?, + title: String?, + artist: String?, + album: String?, + positionMs: Long, + durationMs: Long, + playbackSpeed: Float, + canPlayPause: Boolean, + canSkipNext: Boolean, + canSkipPrevious: Boolean, + accessEnabled: Boolean, + status: String?, + ): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawMicStatusListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawMicStatusListener.kt new file mode 100644 index 00000000..da9cd687 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawMicStatusListener.kt @@ -0,0 +1,10 @@ +package com.faceclaw.app + +interface FaceclawMicStatusListener { + /** + * A CFW mic_control field-104 status record from one temple. body is the raw 21-byte + * ['M','C',ver,...] record (decoded on the TS side); arm is "L" or "R" for the temple's own BLE + * link, "?" if unmatched. + */ + fun onMicStatus(body: ByteArray?, arm: String?): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawModelDownloaderListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawModelDownloaderListener.kt new file mode 100644 index 00000000..f2811569 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawModelDownloaderListener.kt @@ -0,0 +1,11 @@ +package com.faceclaw.app + +/** Progress callbacks for FaceclawModelDownloader, posted to the creating thread's Looper. */ +interface FaceclawModelDownloaderListener { + fun onProgress(bytesDownloaded: Long, totalBytes: Long): Unit + + /** The file is fully downloaded, verified, and moved to its final path. */ + fun onDone(path: String?): Unit + + fun onError(message: String?): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawNotificationListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawNotificationListener.kt new file mode 100644 index 00000000..35cf0523 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawNotificationListener.kt @@ -0,0 +1,5 @@ +package com.faceclaw.app + +interface FaceclawNotificationListener { + fun onNotificationPosted(key: String?): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawQrScannerListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawQrScannerListener.kt new file mode 100644 index 00000000..60a2f29d --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawQrScannerListener.kt @@ -0,0 +1,10 @@ +package com.faceclaw.app + +/** Callbacks for one FaceclawQrScanner.scan; exactly one method fires. */ +interface FaceclawQrScannerListener { + fun onResult(text: String?): Unit + + fun onCancelled(): Unit + + fun onError(message: String?): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawSettingsListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawSettingsListener.kt new file mode 100644 index 00000000..d453a8ac --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawSettingsListener.kt @@ -0,0 +1,6 @@ +package com.faceclaw.app + +/** Change-notification callback for FaceclawSettings; implemented in JS. */ +interface FaceclawSettingsListener { + fun onSettingChanged(key: String?): Unit +} diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawSseListener.java b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawSseListener.kt similarity index 65% rename from App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawSseListener.java rename to native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawSseListener.kt index 8780d601..fde0d60a 100644 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawSseListener.java +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawSseListener.kt @@ -1,13 +1,16 @@ -package com.faceclaw.app; +package com.faceclaw.app /** Callbacks for FaceclawSseRequest, delivered on the constructing thread's Looper. */ -public interface FaceclawSseListener { +interface FaceclawSseListener { /** One line of a successful (2xx) streaming response body, without the newline. */ - void onLine(String line); + fun onLine(line: String?): Unit + /** The server answered with a non-2xx status; body is the full error body. */ - void onHttpError(int code, String body); + fun onHttpError(code: Int, body: String?): Unit + /** The 2xx response body ended normally. */ - void onComplete(); + fun onComplete(): Unit + /** Network-level failure (connect, TLS, mid-stream drop). Not called after cancel(). */ - void onFailure(String message); + fun onFailure(message: String?): Unit } diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawVoiceControllerListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawVoiceControllerListener.kt new file mode 100644 index 00000000..e3b4fd75 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawVoiceControllerListener.kt @@ -0,0 +1,44 @@ +package com.faceclaw.app + +interface FaceclawVoiceControllerListener { + fun onStatus(status: String?): Unit + + /** + * Best transcript of the current utterance so far. REPLACE semantics: text is the complete + * transcript, not a delta — display it verbatim, replacing any previous partial. isFinal marks + * the end of the utterance. + */ + fun onTranscript(text: String?, isFinal: Boolean): Unit + + /** Capture has finished, after the final transcript or a startup/recognition error. */ + fun onStopped(captureId: Int): Unit + + /** + * Decoded microphone audio: 16 kHz mono signed 16-bit little-endian PCM. Emitted in every mode + * so raw-PCM consumers (levels, recording, captions) keep working while the onboard recognizer + * owns the transcript. + */ + fun onPcm(pcm16le: ByteArray?): Unit + + /** + * Per-packet DSP metadata the glasses firmware appends to each 50 ms audio packet, computed on + * the raw stereo capture before its mono downmix: the direction-of-arrival in signed degrees (0 + * = straight ahead, positive to the wearer's right) and a signal-strength ratio that serves as + * a confidence/energy proxy for the angle. + */ + fun onFrameMeta(angleDegrees: Int, ssr: Int): Unit + + /** + * The speaker stopped, in a hands-free session that has no button release to end it. Only fires + * when endpointing was enabled for the session; see FaceclawVoiceController.setEndpointing. + */ + fun onSpeechEnd(): Unit + + /** + * Result of speaker verification against the enrolled wearer voice-print, emitted once per + * capture session just before the final transcript. Only fires when verification was configured + * for the session; fails open (isWearer=true) when the utterance was too short to verify or the + * speaker model could not be loaded. + */ + fun onSpeakerVerified(isWearer: Boolean, similarity: Float): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawWearListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawWearListener.kt new file mode 100644 index 00000000..420865ee --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawWearListener.kt @@ -0,0 +1,17 @@ +package com.faceclaw.app + +/** + * Callbacks from the Android Wear (Wear OS) bridge; implemented in JS. Every call is delivered on + * the thread that registered the listener (see FaceclawWearBridge.setListener). + */ +interface FaceclawWearListener { + /** + * A message from the watch app. `path` is the Data Layer message path (e.g. "/faceclaw/input"); + * `json` is the UTF-8 payload (always a JSON object, "{}" when the watch sent none); `nodeId` + * identifies the watch so a reply can be addressed to it. + */ + fun onMessage(path: String?, json: String?, nodeId: String?): Unit + + /** The set of reachable watches running the Faceclaw watch app changed. */ + fun onWatchConnection(reachable: Boolean, watchName: String?): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawWebSocketListener.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawWebSocketListener.kt new file mode 100644 index 00000000..b613f7e1 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/callbacks/FaceclawWebSocketListener.kt @@ -0,0 +1,12 @@ +package com.faceclaw.app + +/** Callbacks for FaceclawWebSocket, delivered on the Android main thread. */ +interface FaceclawWebSocketListener { + fun onOpen(): Unit + + fun onTextMessage(message: String?): Unit + + fun onClosed(code: Int, reason: String?): Unit + + fun onFailure(message: String?): Unit +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/BleImageOptimizer.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/BleImageOptimizer.kt new file mode 100644 index 00000000..c2fa50a0 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/BleImageOptimizer.kt @@ -0,0 +1,735 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmField +import kotlin.jvm.JvmStatic + +class BleImageOptimizer { + companion object { + private const val TAG: String = "BleImageOptimizer" + + /** + * Split an image into fragments (packets), taking advantage of the fact that each packet + * can declare a logical size longer than its byte payload to get free trailing + * zero-padding. + * + * Each fragment's logical size stays within maxFragmentSize, while trailing zeros inside + * that span can be omitted from the payload. + */ + @JvmStatic + fun planImageFragments( + bmp: ByteArray, + maxFragmentSize: Int, + ): MutableList { + return planImageFragments(bmp, maxFragmentSize, false) + } + + @JvmStatic + fun planImageFragments( + bmp: ByteArray?, + maxFragmentSize: Int, + reserveFinalByte: Boolean, + ): MutableList { + if (((bmp == null) || (bmp.size == 0))) { + return mutableListOf(BleProtocol.ImageFragment(0, ByteArray(0), 0)) + } + if ((maxFragmentSize <= 0)) { + throw IllegalArgumentException("maxFragmentSize must be positive") + } + val bulkLength: Int = (if (reserveFinalByte) (bmp.size - 1) else bmp.size) + val fragmentCount: Int = + ((((bulkLength + maxFragmentSize) - 1) / maxFragmentSize) + + (if ((bulkLength < bmp.size)) 1 else 0)) + val fragments: MutableList = ArrayList(fragmentCount) + run { + var index: Int = 0 + while (((index * maxFragmentSize) < bulkLength)) { + var start: Int = (index * maxFragmentSize) + var end: Int = minOf((start + maxFragmentSize), bulkLength) + fragments.add(buildFragment(index, bmp, start, end)) + index++ + } + } + if ((bulkLength < bmp.size)) { + fragments.add( + BleProtocol.ImageFragment( + fragments.size, + bmp.copyOfRange(bulkLength, bmp.size), + (bmp.size - bulkLength), + ) + ) + } + + return fragments + } + + private fun buildFragment( + index: Int, + bmp: ByteArray, + start: Int, + end: Int, + ): BleProtocol.ImageFragment { + var dataEnd: Int = end + while (((dataEnd > start) && (bmp[(dataEnd - 1)].toInt() == 0))) { + dataEnd -= 1 + } + if ((dataEnd == start)) { + return BleProtocol.ImageFragment(index, ByteArray(0), (end - start)) + } + return BleProtocol.ImageFragment(index, bmp.copyOfRange(start, dataEnd), (end - start)) + } + + @JvmStatic + fun buildIncrementalImagePayload( + previous: ByteArray?, + next: ByteArray?, + width: Int, + height: Int, + frameId: Int, + ): IncrementalPlan? { + var stride: Int = ((width + 1) shr 1) + if ( + ((((((width <= 0) || (height <= 0)) || (previous == null)) || (next == null)) || + (previous.size != (stride * height))) || (next.size != (stride * height))) + ) { + return null + } + var minByteX: Int = stride + var maxByteX: Int = -1 + var minY: Int = height + var maxY: Int = -1 + var changedBytes: Int = 0 + var columnChanged: BooleanArray = BooleanArray(stride) + run { + var y: Int = 0 + while ((y < height)) { + var rowOffset: Int = (y * stride) + run { + var x: Int = 0 + while ((x < stride)) { + if ((previous[(rowOffset + x)] != next[(rowOffset + x)])) { + changedBytes++ + columnChanged[x] = true + if ((x < minByteX)) { + minByteX = x + } + if ((x > maxByteX)) { + maxByteX = x + } + if ((y < minY)) { + minY = y + } + maxY = y + } + x++ + } + } + y++ + } + } + if ((maxY < 0)) { + return null + } + var clusterCount: Int = 0 + var inCluster: Boolean = false + run { + var x: Int = minByteX + while ((x <= maxByteX)) { + if (columnChanged[x]) { + if (!inCluster) { + clusterCount++ + } + inCluster = true + } else { + inCluster = false + } + x++ + } + } + var left: Int = ((minByteX * 2) and 3.inv()) + var rightExclusive: Int = minOf(width, ((((maxByteX + 1) * 2) + 3) and 3.inv())) + var top: Int = (minY and 1.inv()) + var bottomExclusive: Int = minOf(height, ((maxY + 2) and 1.inv())) + var boxWidth: Int = (rightExclusive - left) + var boxHeight: Int = (bottomExclusive - top) + if (((boxWidth >= width) && (boxHeight >= height))) { + return null + } + var out: ByteArray = + encodeMode3Rect(next, stride, left, top, boxWidth, boxHeight, frameId) + return IncrementalPlan(out, changedBytes, ((boxWidth shr 1) * boxHeight), clusterCount) + } + + /** + * The aligned changed bounding box between two same-size packed frames, or null when they + * are identical: pixel-space {left, top, width, height} with left/width multiples of 4 and + * top/height multiples of 2 (mode-3 header quantization). Exposed so the texture-cache + * planner can reuse the exact rect geometry the single-bbox path would send. + */ + @JvmStatic + fun computeChangedBox( + previous: ByteArray?, + next: ByteArray?, + width: Int, + height: Int, + ): IntArray? { + var stride: Int = ((width + 1) shr 1) + if ( + ((((((width <= 0) || (height <= 0)) || (previous == null)) || (next == null)) || + (previous.size != (stride * height))) || (next.size != (stride * height))) + ) { + return null + } + var minByteX: Int = stride + var maxByteX: Int = -1 + var minY: Int = height + var maxY: Int = -1 + run { + var y: Int = 0 + while ((y < height)) { + var rowOffset: Int = (y * stride) + run { + var x: Int = 0 + while ((x < stride)) { + if ((previous[(rowOffset + x)] != next[(rowOffset + x)])) { + if ((x < minByteX)) { + minByteX = x + } + if ((x > maxByteX)) { + maxByteX = x + } + if ((y < minY)) { + minY = y + } + maxY = y + } + x++ + } + } + y++ + } + } + if ((maxY < 0)) { + return null + } + var left: Int = ((minByteX * 2) and 3.inv()) + var rightExclusive: Int = minOf(width, ((((maxByteX + 1) * 2) + 3) and 3.inv())) + var top: Int = (minY and 1.inv()) + var bottomExclusive: Int = minOf(height, ((maxY + 2) and 1.inv())) + return intArrayOf(left, top, (rightExclusive - left), (bottomExclusive - top)) + } + + /** + * The multi-rect split of the changed region (see computeSplitRects), or null when it is + * one region / too fragmented / the frames aren't comparable. Exposed for the texture-cache + * planner. + */ + @JvmStatic + fun computeChangedRects( + previous: ByteArray?, + next: ByteArray?, + width: Int, + height: Int, + maxRects: Int, + ): MutableList? { + var stride: Int = ((width + 1) shr 1) + if ( + ((((((width <= 0) || (height <= 0)) || (previous == null)) || (next == null)) || + (previous.size != (stride * height))) || (next.size != (stride * height))) + ) { + return null + } + var rects: MutableList? = + computeSplitRects(previous, next, stride, width, height, maxRects) + return (if (((rects == null) || (rects.size < 2))) null else rects) + } + + /** + * Encode one CFW mode-3 rectangle delta: + * [3][left/4][top/2][width/4][height/2][fid_lo][fid_hi][rle(box pixels)] left/width must be + * multiples of 4 (=> left>>1, width>>1 are whole bytes), top/ height multiples of 2. The + * box pixels are top-down rows of `next` (4bpp packed, width>>1 bytes/row), run-length + * encoded before deflate. Shared by the single-bbox path, each rect of a mode-8 multi-rect + * batch, and the texture-cache planner. + */ + @JvmStatic + fun encodeMode3Rect( + next: ByteArray, + stride: Int, + left: Int, + top: Int, + boxWidth: Int, + boxHeight: Int, + fid: Int, + ): ByteArray { + var regionStride: Int = (boxWidth shr 1) + var region: ByteArray = ByteArray((regionStride * boxHeight)) + run { + var y: Int = 0 + while ((y < boxHeight)) { + next.copyInto( + region, + (y * regionStride), + (((top + y) * stride) + (left shr 1)), + (((top + y) * stride) + (left shr 1)) + regionStride, + ) + y++ + } + } + var compressed: ByteArray = rleEncode(region) + var out: ByteArray = ByteArray((7 + compressed.size)) + out[0] = 3 + out[1] = ((left / 4)).toByte() + out[2] = ((top / 2)).toByte() + out[3] = ((boxWidth / 4)).toByte() + out[4] = ((boxHeight / 2)).toByte() + out[5] = ((fid and 0xff)).toByte() + out[6] = (((fid shr 8) and 0xff)).toByte() + compressed.copyInto(out, 7, 0, 0 + compressed.size) + return out + } + + /** A full repaint in independently decodable commands below the uint16 record limit. */ + @JvmStatic + fun encodeFullFrameBands( + packed: ByteArray, + width: Int, + height: Int, + firstFid: Int, + ): MutableList { + if ( + (((((((width <= 0) || (width > 640)) || ((width and 3) != 0)) || (height <= 0)) || + (height > 480)) || ((height and 1) != 0)) || + (packed.size != ((width * height) / 2))) + ) { + throw IllegalArgumentException("unsupported custom framebuffer dimensions") + } + var commands: MutableList = ArrayList() + var fid: Int = firstFid + run { + var top: Int = 0 + while ((top < height)) { + commands.add( + encodeMode3Rect( + packed, + (width / 2), + 0, + top, + width, + minOf(64, (height - top)), + fid, + ) + ) + fid = (if ((fid >= 0xfffe)) 1 else (fid + 1)) + top += 64 + } + } + return commands + } + + private const val MULTI_RECT_V_GAP_ROWS: Int = 4 + + private const val MULTI_RECT_H_GAP_BYTES: Int = 6 + + /** + * Build a mode-8 multi-rect payload for the change between two same-size 4bpp frames, + * assigning consecutive frame ids starting at fidStart (each rect needs a distinct fid — + * the CFW skips duplicate fids). Returns null when the change is a single region (use the + * single-rect path), when it fragments past maxRects, or when the frames aren't comparable. + */ + @JvmStatic + fun buildMultiRectImagePayload( + previous: ByteArray?, + next: ByteArray?, + width: Int, + height: Int, + fidStart: Int, + maxRects: Int, + ): MultiRectPlan? { + var stride: Int = ((width + 1) shr 1) + if ( + ((((((width <= 0) || (height <= 0)) || (previous == null)) || (next == null)) || + (previous.size != (stride * height))) || (next.size != (stride * height))) + ) { + return null + } + var rects: MutableList? = + computeSplitRects(previous, next, stride, width, height, maxRects) + if (((rects == null) || (rects.size < 2))) { + return null + } + var subs: MutableList = ArrayList(rects.size) + var coveredBytes: Int = 0 + var fid: Int = fidStart + var total: Int = 2 + for (r in rects) { + var sub: ByteArray = encodeMode3Rect(next, stride, r[0], r[1], r[2], r[3], fid) + subs.add(sub) + coveredBytes += ((r[2] shr 1) * r[3]) + total += (2 + sub.size) + fid = (if ((fid >= 0xfffe)) 1 else (fid + 1)) + } + var out: ByteArray = ByteArray(total) + out[0] = 8 + out[1] = (rects.size).toByte() + var pos: Int = 2 + for (sub in subs) { + out[pos] = ((sub.size and 0xff)).toByte() + out[(pos + 1)] = (((sub.size shr 8) and 0xff)).toByte() + pos += 2 + sub.copyInto(out, pos, 0, 0 + sub.size) + pos += sub.size + } + return MultiRectPlan(out, rects.size, coveredBytes, fid) + } + + /** + * Split the changed region between two packed 4bpp frames into a small set of aligned + * rectangles that together cover every changed pixel: maximal vertical bands of changed + * rows (merging gaps < V_GAP), each split into horizontal column clusters (merging gaps < + * H_GAP), with each cluster's rows tightened to where it actually changes. Rects are + * pixel-space {left,top,width,height}, left/width aligned to 4px and top/height to 2px. + * Returns null if there's no change or the split exceeds maxRects (caller falls back to a + * single bounding box). + */ + private fun computeSplitRects( + previous: ByteArray, + next: ByteArray, + stride: Int, + width: Int, + height: Int, + maxRects: Int, + ): MutableList? { + var rowChanged: BooleanArray = BooleanArray(height) + var anyChange: Boolean = false + run { + var y: Int = 0 + while ((y < height)) { + var off: Int = (y * stride) + run { + var x: Int = 0 + while ((x < stride)) { + if ((previous[(off + x)] != next[(off + x)])) { + rowChanged[y] = true + anyChange = true + break + } + x++ + } + } + y++ + } + } + if (!anyChange) { + return null + } + var rects: MutableList = ArrayList() + var col: BooleanArray = BooleanArray(stride) + var y: Int = 0 + while ((y < height)) { + if (!rowChanged[y]) { + y++ + continue + } + var bandTop: Int = y + var bandBot: Int = y + var cur: Int = (y + 1) + while ((cur < height)) { + if (rowChanged[cur]) { + bandBot = cur + cur++ + continue + } + var g: Int = cur + while (((g < height) && !rowChanged[g])) { + g++ + } + if (((g < height) && ((g - cur) < MULTI_RECT_V_GAP_ROWS))) { + cur = g + } else { + break + } + } + col.fill(false) + run { + var yy: Int = bandTop + while ((yy <= bandBot)) { + if (!rowChanged[yy]) { + yy++ + continue + } + var off: Int = (yy * stride) + run { + var x: Int = 0 + while ((x < stride)) { + if ((previous[(off + x)] != next[(off + x)])) { + col[x] = true + } + x++ + } + } + yy++ + } + } + var x: Int = 0 + while ((x < stride)) { + if (!col[x]) { + x++ + continue + } + var cL: Int = x + var cR: Int = x + var cx: Int = (x + 1) + while ((cx < stride)) { + if (col[cx]) { + cR = cx + cx++ + continue + } + var g: Int = cx + while (((g < stride) && !col[g])) { + g++ + } + if (((g < stride) && ((g - cx) < MULTI_RECT_H_GAP_BYTES))) { + cx = g + } else { + break + } + } + var tTop: Int = height + var tBot: Int = -1 + run { + var yy: Int = bandTop + while ((yy <= bandBot)) { + if (!rowChanged[yy]) { + yy++ + continue + } + var off: Int = (yy * stride) + run { + var xx: Int = cL + while ((xx <= cR)) { + if ((previous[(off + xx)] != next[(off + xx)])) { + if ((yy < tTop)) { + tTop = yy + } + tBot = yy + break + } + xx++ + } + } + yy++ + } + } + if ((tBot >= 0)) { + var left: Int = ((cL * 2) and 3.inv()) + var rightExclusive: Int = minOf(width, ((((cR + 1) * 2) + 3) and 3.inv())) + var top: Int = (tTop and 1.inv()) + var bottomExclusive: Int = minOf(height, ((tBot + 2) and 1.inv())) + rects.add( + intArrayOf(left, top, (rightExclusive - left), (bottomExclusive - top)) + ) + if ((rects.size > maxRects)) { + return null + } + } + x = (cR + 1) + } + y = (bandBot + 1) + } + return rects + } + + /** + * Run-length encode headerless 4bpp pixels for CFW load_image_z mode 6. Wire format: + * [6][rle(4bpp pixels)]. Always use mode 6: the logical image can be larger than its + * EvenHub carrier, so a raw BMP fallback would carry dimensions the legacy container loader + * cannot accept. + */ + @JvmStatic + fun maybeCompress(packed: ByteArray?, width: Int, height: Int): ByteArray { + if (((packed == null) || (packed.size == 0))) { + return packed ?: ByteArray(0) + } + var z: ByteArray = rleEncode(packed) + var out: ByteArray = ByteArray((z.size + 1)) + out[0] = 6 + z.copyInto(out, 1, 0, 0 + z.size) + return out + } + + /** + * Run-length encode packed 4bpp pixels for CFW modes 3 and 6, whose payload is RLE tokens; + * deflate belongs to the transport. Runs are over the pixel NIBBLES of {@code pix} in wire + * order (high nibble = left pixel), including the pad nibble that ends each row at odd + * widths — i.e. {@code pix} read as 2*length nibbles. One token is: + *
+         *   [cnt4|color4]                 cnt 1..15
+         *   [0|color4][cnt8]              cnt 1..255
+         *   [0|color4][0][cntLo][cntHi]   cnt 1..65535, little-endian
+         * 
+ * with the low nibble always the color; runs longer than 65535 split across tokens. Worst + * case (every nibble its own run) is exactly one byte per nibble, which is what the buffer + * is sized for. + */ + @JvmStatic + fun rleEncode(pix: ByteArray): ByteArray { + var n: Int = (pix.size * 2) + var out: ByteArray = ByteArray(n) + var o: Int = 0 + var i: Int = 0 + while ((i < n)) { + var v: Int = nibbleAt(pix, i) + var j: Int = (i + 1) + while (((j < n) && (nibbleAt(pix, j) == v))) { + j++ + } + var run: Int = (j - i) + while ((run > 0)) { + var c: Int = minOf(run, 0xffff) + if ((c <= 15)) { + out[o++] = (((c shl 4) or v)).toByte() + } else { + if ((c <= 255)) { + out[o++] = (v).toByte() + out[o++] = (c).toByte() + } else { + out[o++] = (v).toByte() + out[o++] = 0 + out[o++] = ((c and 0xff)).toByte() + out[o++] = ((c shr 8)).toByte() + } + } + run -= c + } + i = j + } + return out.copyOf(o) + } + + private fun nibbleAt(pix: ByteArray, i: Int): Int { + var b: Int = (pix[(i shr 1)] and 0xff) + return (if (((i and 1) != 0)) (b and 0x0f) else (b shr 4)) + } + } + + constructor() {} + + class TileImagePlan { + @JvmField val tileIndex: Int + + @JvmField val tile: BleProtocol.ImageTileOptions + + @JvmField val packed: ByteArray? + + @JvmField val width: Int + + @JvmField val height: Int + + @JvmField val payload: ByteArray + + @JvmField val sessionId: Int + + @JvmField var fragments: MutableList = mutableListOf() + + constructor( + tileIndex: Int, + tile: BleProtocol.ImageTileOptions, + packed: ByteArray?, + width: Int, + height: Int, + sessionId: Int, + ) { + this.tileIndex = tileIndex + this.tile = tile + this.packed = (if ((packed == null)) ByteArray(0) else packed) + this.width = width + this.height = height + this.payload = maybeCompress(this.packed, width, height) + this.sessionId = sessionId + } + + constructor( + tileIndex: Int, + tile: BleProtocol.ImageTileOptions, + packed: ByteArray?, + width: Int, + height: Int, + sessionId: Int, + payloadOverride: ByteArray, + ) { + this.tileIndex = tileIndex + this.tile = tile + this.packed = (if ((packed == null)) ByteArray(0) else packed) + this.width = width + this.height = height + this.payload = payloadOverride + this.sessionId = sessionId + } + } + + /** + * A mode-3 incremental payload plus diagnostics about how tightly the bounding box fit the + * actual change. {@code changedBytes} is how many packed bytes actually differ; {@code + * boxBytes} is how many the box sends. A large box with few changed bytes / multiple clusters + * means distant small edits were merged into one oversized box (which can spill past the + * fragment size into an extra serialized BLE message). + */ + class IncrementalPlan { + @JvmField val payload: ByteArray + + @JvmField val changedBytes: Int + + @JvmField val boxBytes: Int + + @JvmField val clusterCount: Int + + constructor(payload: ByteArray, changedBytes: Int, boxBytes: Int, clusterCount: Int) { + this.payload = payload + this.changedBytes = changedBytes + this.boxBytes = boxBytes + this.clusterCount = clusterCount + } + } + + /** + * A CFW mode-8 multi-segment payload (`[8][count]` then per-rect `[len16][mode-3 submsg]`) + * carrying several tight rectangle deltas instead of one bounding box, plus diagnostics. Each + * rect is applied to the firmware shadow with the panel push deferred, then presented once. + * Used when the change splits into regions whose bounding box wastes bytes (distant edits, or a + * sparse box); the caller falls back to the single-rect path when this returns null or isn't + * smaller. + */ + class MultiRectPlan { + @JvmField val payload: ByteArray + + @JvmField val rectCount: Int + + @JvmField val coveredBytes: Int + + @JvmField val nextFid: Int + + constructor(payload: ByteArray, rectCount: Int, coveredBytes: Int, nextFid: Int) { + this.payload = payload + this.rectCount = rectCount + this.coveredBytes = coveredBytes + this.nextFid = nextFid + } + } + + class ImageUpdateStats { + @JvmField val paintMs: Int + + @JvmField val tileCount: Int + + @JvmField val frameId: Int + + @JvmField var firstWriteStartedAtMs: Long = 0L + + constructor(paintMs: Int, tileCount: Int, frameId: Int) { + this.paintMs = maxOf(0, paintMs) + this.tileCount = tileCount + this.frameId = frameId + } + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/BleMagicPool.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/BleMagicPool.kt new file mode 100644 index 00000000..354ff1c1 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/BleMagicPool.kt @@ -0,0 +1,43 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmField + +/** + * Allocates one-byte message identifiers in LRU order. Release records survive reuse so the + * communicator can diagnose late ACKs after a timeout. + */ +class BleMagicPool(private val platform: ProtocolPlatform) { + companion object { + const val MIN_MAGIC = 100 + const val MAX_MAGIC = 255 + } + + private val lock = platform.createLock() + private val available = ArrayDeque((MIN_MAGIC..MAX_MAGIC).toList()) + private val allocated = BooleanArray(256) + private val releaseRecords = mutableMapOf() + + fun allocate(): Int = lock.withLock { + check(available.isNotEmpty()) { "no BLE magic values available" } + val magic = available.removeFirst() + allocated[magic] = true + magic + } + + fun release(sid: Int, magic: Int, label: String?, reason: String?) = lock.withLock { + if (magic !in MIN_MAGIC..MAX_MAGIC) return@withLock + releaseRecords["$sid:$magic"] = ReleaseRecord(label, reason, platform.elapsedRealtimeMs()) + if (!allocated[magic]) return@withLock + allocated[magic] = false + available.addLast(magic) + } + + fun getReleaseRecord(sid: Int, magic: Int): ReleaseRecord? = lock.withLock { + releaseRecords["$sid:$magic"] + } + + class ReleaseRecord(label: String?, reason: String?, @JvmField val releasedAtMs: Long) { + @JvmField val label: String = label ?: "" + @JvmField val reason: String = reason ?: "" + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/BleProtocol.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/BleProtocol.kt new file mode 100644 index 00000000..4227cdb5 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/BleProtocol.kt @@ -0,0 +1,1480 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmField +import kotlin.jvm.JvmOverloads +import kotlin.jvm.JvmStatic + +/** + * BleProtocol: Functions for generating and parsing messages when speaking to the Even Realities + * G2. Does _not_ include code for actually sending anything; for that, see FaceclawBleCommunicator. + * + * Most message formats are protobufs. For schemas, check g2-kit-unofficial. + */ +class BleProtocol { + companion object { + const val WRITE_CHAR_UUID: String = "00002760-08c2-11e1-9073-0e8ac72e5401" + + const val NOTIFY_CHAR_UUID: String = "00002760-08c2-11e1-9073-0e8ac72e5402" + + const val OTA_DATA_WRITE_UUID: String = "00002760-08c2-11e1-9073-0e8ac72e0001" + + const val OTA_DATA_NOTIFY_UUID: String = "00002760-08c2-11e1-9073-0e8ac72e0002" + + const val RENDER_NOTIFY_UUID: String = "00002760-08c2-11e1-9073-0e8ac72e6402" + + const val R1_PHONE_NOTIFY_CHAR_UUID: String = "bae80011-4f05-4503-8e65-3af1f7329d1f" + + const val R1_NOTIFY_CHAR_UUID: String = "bae80013-4f05-4503-8e65-3af1f7329d1f" + + const val PRELUDE_ACK_SID: Int = 0x01 + + const val PRELUDE_ACK_MAGIC: Int = 156 + + /** + * DEVICE_SETTINGS security-auth channel. Firmware 2.2.9 enforces completing this exchange + * shortly after a GATT connection opens (a ~30 s deadline closes unauthenticated links) and + * gates query responses on it; the message itself exists back to the 2.2.4 era, so sending + * it is safe on all stock versions. See ../notes/ble-connections-2.2.9.md. + */ + const val SID_SECURITY_AUTH: Int = 0x80 + + const val FLAG_SECURITY_AUTH: Int = 0x00 + + private const val SECURITY_AUTH_CMD: Int = 4 + + const val SID_APP_LAUNCH: Int = 0x01 + + const val SID_EVENHUB: Int = 0xe0 + + const val SID_UI_SETTING: Int = 0x09 + + const val SID_STATE_CHANGE: Int = 0x0 + + const val SID_ONBOARDING: Int = 0x10 + + /** G2SettingPackage.commandId for device-initiated pushes (vs. 2 = app read). */ + const val SETTINGS_CMD_DEVICE_SEND_TO_APP: Int = 3 + + const val FACECLAW_WAKE_CONTROL_FIELD: Int = 101 + + const val FACECLAW_WAKE_EVENT_FIELD: Int = 102 + + /** + * CFW mic_control: host writes an [77.toByte(),67.toByte(),ver,op,...] record as settings + * field 103; each temple reports a 21-byte [77.toByte(),67.toByte(),ver,...] status as + * field 104, both appended to settings read responses and as standalone commandId=3 pushes. + */ + const val FACECLAW_MIC_CONTROL_FIELD: Int = 103 + + const val FACECLAW_MIC_STATUS_FIELD: Int = 104 + + /** + * CFW als_sensor: ambient-light reports on settings-channel field 105, 24-byte + * [65.toByte(),76.toByte(),ver,reason,...] records from the master temple (decoded in + * app/native/ambient-light.ts). + */ + const val FACECLAW_ALS_REPORT_FIELD: Int = 105 + + const val FACECLAW_WAKE_OP_ACQUIRE: Int = 1 + + const val FACECLAW_WAKE_OP_RELEASE: Int = 2 + + const val FACECLAW_WAKE_OP_CLAIM: Int = 3 + + const val FACECLAW_WAKE_OP_READY: Int = 4 + + const val FACECLAW_FB_OP_ACQUIRE: Int = 5 + + const val FACECLAW_FB_OP_RELEASE: Int = 6 + + const val FACECLAW_WEAR_OP_QUERY: Int = 7 + + const val CFW_IMAGE_MODE_CLEANUP: Int = 11 + + private const val FACECLAW_WAKE_EVENT: Int = 1 + + const val FACECLAW_WAKE_EVENT_HEAD_UP: Int = 5 + + const val FACECLAW_GESTURE_EVENT_TAP: Int = 2 + + const val FACECLAW_GESTURE_EVENT_LONG_PRESS: Int = 3 + + const val FACECLAW_GESTURE_EVENT_LONG_PRESS_RELEASE: Int = 4 + + private const val FACECLAW_RAW_SOURCE_LEFT_TEMPLE: Int = 0 + + private const val FACECLAW_RAW_SOURCE_RIGHT_TEMPLE: Int = 1 + + private const val FACECLAW_RAW_SOURCE_RING: Int = 4 + + private const val FACECLAW_WAKE_PROTOCOL_VERSION: Int = 1 + + const val SID_EVEN_AI: Int = 0x07 + + const val SID_NAVIGATION: Int = 0x08 + + const val NAV_CMD_COMPASS_CHANGED: Int = 15 + + const val NAV_CMD_COMPASS_CALIBRATION_STARTED: Int = 16 + + const val NAV_CMD_COMPASS_CALIBRATION_COMPLETE: Int = 17 + + const val EVEN_AI_CMD_CTRL: Int = 1 + + const val EVEN_AI_STATUS_WAKE_UP: Int = 1 + + const val EVEN_AI_STATUS_ENTER: Int = 2 + + const val EVEN_AI_STATUS_EXIT: Int = 3 + + const val FLAG_REQUEST: Int = 0x20 + + const val FLAG_NOTIFY: Int = 0x01 + + const val FLAG_NOTIFY_ALT: Int = 0x06 + + const val CMD_AUDIO_CONTROL: Int = 15 + + const val CMD_OPEN_IMU: Int = 19 + + const val EVENT_CLICK: Int = 0 + + const val EVENT_SCROLL_TOP: Int = 1 + + const val EVENT_SCROLL_BOTTOM: Int = 2 + + const val EVENT_DOUBLE_CLICK: Int = 3 + + const val EVENT_FOREGROUND_ENTER: Int = 4 + + const val EVENT_FOREGROUND_EXIT: Int = 5 + + const val EVENT_ABNORMAL_EXIT: Int = 6 + + const val EVENT_SYSTEM_EXIT: Int = 7 + + const val EVENT_IMU_DATA_REPORT: Int = 8 + + const val EVENT_RING_LONG_PRESS: Int = 9 + + const val EVENT_RING_LONG_PRESS_RELEASE: Int = 10 + + const val EVENT_SHORT_THEN_LONG_PRESS: Int = 11 + + const val EVENT_HEAD_UP: Int = 12 + + const val EVENT_SOURCE_GLASSES_R: Int = 1 + + const val EVENT_SOURCE_RING: Int = 2 + + const val EVENT_SOURCE_GLASSES_L: Int = 3 + + const val CCCD_UUID: String = "00002902-0000-1000-8000-00805f9b34fb" + + @JvmField val PRELUDE_F5872_PAYLOAD: ByteArray = buildPreludeF5872Payload() + + @JvmField + val PRELUDE_F5872: ByteArray = + framePb(PRELUDE_F5872_PAYLOAD, SID_APP_LAUNCH, FLAG_REQUEST, 0x92).first() + + private fun buildPreludeF5872Payload(): ByteArray { + var field4: ByteArray = + encodeMessageField( + 3, + encodeMessageField( + 2, + encodeMessageField( + 2, + concat( + CollectionUtils.listOf( + encodeVarintField(1, 0), + encodeVarintField(2, 0), + ) + ), + ), + ), + ) + return concat( + CollectionUtils.listOf( + encodeVarintField(1, 2), + encodeVarintField(2, PRELUDE_ACK_MAGIC), + encodeMessageField(4, field4), + ) + ) + } + + @JvmStatic + @JvmOverloads + fun framePb( + pb: ByteArray, + sid: Int, + flag: Int, + seq: Int, + maxWrite: Int = 240, + ): MutableList { + val chunkSize = minOf(232, maxWrite - 8) + require(chunkSize >= 12) { "Negotiated BLE write size is too small" } + var crc: ByteArray = crcBytesLe(pb) + var totalWithCrc: Int = (pb.size + 2) + var totalFrags: Int = + maxOf(1, (kotlin.math.ceil((totalWithCrc / (chunkSize).toDouble()))).toInt()) + require(totalFrags <= 255) { "Protocol message exceeds the fragment limit" } + var frames: MutableList = ArrayList(totalFrags) + var payload: ByteArray = pb.copyOf(totalWithCrc) + payload[pb.size] = crc[0] + payload[(pb.size + 1)] = crc[1] + run { + var i: Int = 0 + while ((i < totalFrags)) { + var offset: Int = (i * chunkSize) + var chunk: ByteArray = + payload.copyOfRange(offset, minOf((offset + chunkSize), payload.size)) + var frame: ByteArray = ByteArray((8 + chunk.size)) + frame[0] = (0xaa).toByte() + frame[1] = 0x21 + frame[2] = ((seq and 0xff)).toByte() + frame[3] = ((chunk.size and 0xff)).toByte() + frame[4] = ((totalFrags and 0xff)).toByte() + frame[5] = (((i + 1) and 0xff)).toByte() + frame[6] = ((sid and 0xff)).toByte() + frame[7] = ((flag and 0xff)).toByte() + chunk.copyInto(frame, 8, 0, 0 + chunk.size) + frames.add(frame) + i++ + } + } + return frames + } + + /** Retain the text container for forwarded inputs, without an image container. */ + @JvmStatic + fun buildCreateInputPage(magic: Int): ByteArray { + var innerParts: MutableList = ArrayList() + innerParts.add(encodeVarintField(1, 1)) + innerParts.add( + encodeMessageField(3, encodeTextObject("dashboard", 1, 0, 0, 576, 288, " ", true)) + ) + innerParts.add(encodeVarintField(5, 10000)) + var inner: ByteArray = concat(innerParts) + return wrapEvenHub(0, magic, 3, inner) + } + + @JvmStatic + fun buildDashboardTextUpgrade(magic: Int): ByteArray { + var inner: MutableList = ArrayList() + inner.add(encodeVarintField(1, 1)) + inner.add(encodeStringField(2, "dashboard")) + inner.add(encodeVarintField(3, 0)) + inner.add(encodeVarintField(4, 1)) + inner.add(encodeStringField(5, " ")) + return wrapEvenHub(5, magic, 9, concat(inner)) + } + + @JvmStatic + fun buildImageRawData( + tile: ImageTileOptions, + sessionId: Int, + totalSize: Int, + fragment: ImageFragment, + magic: Int, + ): ByteArray { + var inner: MutableList = ArrayList() + inner.add(encodeVarintField(1, tile.containerId)) + inner.add(encodeStringField(2, tile.name)) + inner.add(encodeVarintField(3, tile.containerId)) + inner.add(encodeVarintField(4, totalSize)) + inner.add(encodeVarintField(5, 0)) + inner.add(encodeVarintField(6, fragment.index)) + inner.add(encodeVarintField(7, fragment.size)) + inner.add(encodeBytesField(8, fragment.data)) + return wrapEvenHub(3, magic, 5, concat(inner)) + } + + @JvmStatic + fun buildHeartbeat(magic: Int): ByteArray { + return wrapEvenHub(12, magic, 14, encodeVarintField(1, 0)) + } + + /** + * Cmd=0 CreateStartUpPage carrying a text container (the message) plus a list container + * (the selectable rows) in one page. Uses stock-firmware-safe geometry (each container + * within the stock ~280x130 container-size cap; the CFW is what lifts that to 576x288), so + * this works before flashing. The selected row comes back as an async list event — see + * parseListSelection. + */ + @JvmStatic + fun buildCreatePromptPage( + magic: Int, + textName: String, + textContainerId: Int, + warningText: String, + listName: String, + listContainerId: Int, + items: Array, + ): ByteArray { + var inner: MutableList = ArrayList() + inner.add(encodeVarintField(1, 2)) + inner.add( + encodeMessageField( + 2, + encodeListObject(listName, listContainerId, 0, 150, 280, 120, items, true), + ) + ) + inner.add( + encodeMessageField( + 3, + encodeTextObject(textName, textContainerId, 0, 0, 280, 130, warningText, false), + ) + ) + inner.add(encodeVarintField(5, 10000)) + return wrapEvenHub(0, magic, 3, concat(inner)) + } + + @JvmStatic + fun encodeListObject( + name: String, + containerId: Int, + x: Int, + y: Int, + width: Int, + height: Int, + items: Array, + captureEvents: Boolean, + ): ByteArray { + var parts: MutableList = ArrayList() + parts.add(encodeVarintField(1, x)) + parts.add(encodeVarintField(2, y)) + parts.add(encodeVarintField(3, width)) + parts.add(encodeVarintField(4, height)) + parts.add(encodeVarintField(9, containerId)) + parts.add(encodeStringField(10, name)) + parts.add(encodeMessageField(11, encodeListItemContainer(items))) + if (captureEvents) { + parts.add(encodeVarintField(12, 1)) + } + return concat(parts) + } + + private fun encodeListItemContainer(items: Array): ByteArray { + var parts: MutableList = ArrayList() + parts.add(encodeVarintField(1, items.size)) + parts.add(encodeVarintField(3, 1)) + for (item in items) { + parts.add(encodeStringField(4, item)) + } + return concat(parts) + } + + /** + * Decode a list-selection async event (sid=0xe0, flag=0x01/0x06). Returns null if the frame + * is not a list event. `itemIndex` is 0-based into the ItemName array the list was built + * with; `eventType` is EVENT_CLICK for a confirmed selection (scroll/highlight changes + * arrive with other types). + */ + @JvmStatic + fun parseListSelection(frame: ParsedFrame): ListSelection? { + var pb: ByteArray = stripTrailingCrc(frame.pb) + var deviceEvent: ByteArray? = readFieldBytes(pb, 13) + if ((deviceEvent == null)) { + return null + } + var listEvent: ByteArray? = readFieldBytes(deviceEvent, 1) + if ((listEvent == null)) { + return null + } + return ListSelection( + readStringFieldValue(listEvent, 2), + readStringFieldValue(listEvent, 3), + readVarintFieldValue(listEvent, 4, -1), + readVarintFieldValue(listEvent, 5, EVENT_CLICK), + ) + } + + @JvmStatic + fun buildAudioControl(magic: Int, enable: Boolean): ByteArray { + return wrapEvenHub( + CMD_AUDIO_CONTROL, + magic, + 18, + encodeVarintField(1, (if (enable) 1 else 0)), + ) + } + + @JvmStatic + fun buildShutdown(magic: Int, exitMode: Int): ByteArray { + return wrapEvenHub(9, magic, 11, encodeVarintField(1, exitMode)) + } + + /** + * IMU control (ImuCtrl = field 22 of the main ctx). IMU_CtrlCmd carries IMUReportEn + * (field 1) and reportFrq (field 2). reportFrq is only meaningful when enabling; on disable + * we send just the enable flag. + */ + @JvmStatic + fun buildImuControl(magic: Int, enable: Boolean, reportFrq: Int): ByteArray { + var inner: MutableList = ArrayList() + inner.add(encodeVarintField(1, (if (enable) 1 else 0))) + if ((enable && (reportFrq > 0))) { + inner.add(encodeVarintField(2, reportFrq)) + } + return wrapEvenHub(CMD_OPEN_IMU, magic, 22, concat(inner)) + } + + /** + * Set the lens brightness: G2SettingPackage{commandId=1 (DeviceReceiveInfo), + * deviceReceiveInfoFromApp(3){deviceReceiveBrightness(1){autoAdjust(1), + * brightnessLevel(2)}}} on sid 0x09. brightnessLevel is 0-100 (nonlinear; 0 is + * dim-but-visible, not off). When autoAdjust is set the ambient-light sensor drives + * brightness, so the level field is omitted; otherwise the level is always encoded + * (explicit zero included) so brightnessLevel=0 reaches the wire. + */ + @JvmStatic + fun buildSetBrightness(magic: Int, autoAdjust: Boolean, brightnessLevel: Int): ByteArray { + var brightness: MutableList = ArrayList() + brightness.add(encodeVarintField(1, (if (autoAdjust) 1 else 0))) + if (!autoAdjust) { + brightness.add(encodeVarintField(2, brightnessLevel)) + } + return concat( + CollectionUtils.listOf( + encodeVarintField(1, 1), + encodeVarintField(2, magic), + encodeMessageField(3, encodeMessageField(1, concat(brightness))), + ) + ) + } + + /** Enable the firmware's wear detector (DeviceReceiveInfoFromAPP field 5). */ + @JvmStatic + fun buildSetWearDetection(magic: Int, enabled: Boolean): ByteArray { + var wear: ByteArray = encodeVarintField(1, (if (enabled) 1 else 0)) + return concat( + CollectionUtils.listOf( + encodeVarintField(1, 1), + encodeVarintField(2, magic), + encodeMessageField(3, encodeMessageField(5, wear)), + ) + ) + } + + /** + * The application authentication request: DEVICE_SETTINGS/AUTHENTICATION(4) on sid 0x80, + * flag 0x00. Carries no key material — it arms the firmware's "security auth" flag; the + * firmware sends the success notification once the flag is set AND the BLE link is + * encrypted (SMP pairing/bond restoration, handled by the OS below GATT, possibly after a + * pairing prompt). Protobuf: f1=4 (command), f2=magic, f3={f1=1, f2=4}. + */ + @JvmStatic + fun buildAuthenticationRequest(magic: Int): ByteArray { + var auth: ByteArray = + concat( + CollectionUtils.listOf( + encodeVarintField(1, 1), + encodeVarintField(2, SECURITY_AUTH_CMD), + ) + ) + return concat( + CollectionUtils.listOf( + encodeVarintField(1, SECURITY_AUTH_CMD), + encodeVarintField(2, magic), + encodeMessageField(3, auth), + ) + ) + } + + /** + * True when `pb` (trailing CRC still attached) is the success notification for the + * authentication request sent with `magic`: command 4, the same magic, and an EMPTY field-3 + * result message (`1a 00` — the omitted result code defaults to zero). A GATT write + * completing is NOT success; only this notification is. + */ + @JvmStatic + fun isAuthenticationSuccess(pb: ByteArray?, magic: Int): Boolean { + if ((pb == null)) { + return false + } + var root: ByteArray = stripTrailingCrc(pb) + if ((readVarintFieldValue(root, 1, -1) != SECURITY_AUTH_CMD)) { + return false + } + if ((readVarintFieldValue(root, 2, -1) != magic)) { + return false + } + var result: ByteArray? = readFieldBytes(root, 3) + return ((result != null) && (result.size == 0)) + } + + @JvmStatic + fun buildSettingsQuery(magic: Int): ByteArray { + var request: ByteArray = encodeVarintField(1, 1) + return concat( + CollectionUtils.listOf( + encodeVarintField(1, 2), + encodeVarintField(2, magic), + encodeMessageField(4, request), + ) + ) + } + + /** + * Build the CFW-only wake lease control package. Magic zero deliberately makes this + * fire-and-forget: the firmware consumes field 101 before its stock nanopb decoder discards + * the unknown field. + */ + @JvmStatic + fun buildFaceclawWakeControl(operation: Int, nonce: Int): ByteArray { + var control: ByteArray = + byteArrayOf( + 70.toByte(), + 67.toByte(), + (FACECLAW_WAKE_PROTOCOL_VERSION).toByte(), + (operation).toByte(), + ((nonce and 0xff)).toByte(), + (((nonce ushr 8) and 0xff)).toByte(), + ) + return concat( + CollectionUtils.listOf( + encodeVarintField(1, 1), + encodeVarintField(2, 0), + encodeBytesField(FACECLAW_WAKE_CONTROL_FIELD, control), + ) + ) + } + + /** + * Wrap an already-encoded [77.toByte(),67.toByte(),ver,op,...] mic-control record as a + * settings write carrying CFW field 103. Magic zero makes it fire-and-forget like the wake + * lease: the firmware consumes the field before its stock nanopb decoder discards the + * unknown tag, and the "ack" is the field-104 status notify that follows. + */ + @JvmStatic + fun buildFaceclawMicControl(record: ByteArray): ByteArray { + return concat( + CollectionUtils.listOf( + encodeVarintField(1, 1), + encodeVarintField(2, 0), + encodeBytesField(FACECLAW_MIC_CONTROL_FIELD, record), + ) + ) + } + + /** + * Extract the CFW mic status record (field 104) from a settings frame, or null when absent. + * The 21-byte body layout is decoded on the TS side; here we only validate the + * 77.toByte(),67.toByte(),version prelude. + */ + @JvmStatic + fun parseFaceclawMicStatus(pb: ByteArray?): ByteArray? { + if ((pb == null)) { + return null + } + var body: ByteArray? = readFieldBytes(stripTrailingCrc(pb), FACECLAW_MIC_STATUS_FIELD) + if ( + ((((body == null) || (body.size < 3)) || (body[0].toInt() != 77)) || + (body[1].toInt() != 67)) + ) { + return null + } + return body + } + + /** + * Return the raw CFW ambient-light report from a sid-0x09 frame, or null when this is an + * ordinary settings frame. Only the 65.toByte(),76.toByte(),version prelude is validated + * here; the fields are decoded on the TS side. + */ + @JvmStatic + fun parseFaceclawAlsReport(pb: ByteArray?): ByteArray? { + if ((pb == null)) { + return null + } + var body: ByteArray? = readFieldBytes(stripTrailingCrc(pb), FACECLAW_ALS_REPORT_FIELD) + if ( + (((((body == null) || (body.size < 24)) || (body[0].toInt() != 65)) || + (body[1].toInt() != 76)) || ((body[2] and 0xff) != 1)) + ) { + return null + } + return body + } + + /** Field 106: RB/version 1/flags/percentage, from the CFW ring-battery cache. */ + @JvmStatic + fun parseRingBattery(pb: ByteArray?): RingBatterySnapshot? { + if ((pb == null)) { + return null + } + var body: ByteArray? = readFieldBytes(stripTrailingCrc(pb), 106) + if ( + (((((body == null) || (body.size != 5)) || (body[0].toInt() != 82)) || + (body[1].toInt() != 66)) || (body[2].toInt() != 1)) + ) { + return null + } + var flags: Int = (body[3] and 0xff) + var level: Int = (body[4] and 0xff) + if (((flags and 7.inv()) != 0)) { + return null + } + if (((flags and 2) != 0)) { + if ((((flags and 1) == 0) || (level > 100))) { + return null + } + return RingBatterySnapshot(level, (if (((flags and 4) != 0)) 1 else 0)) + } + if (((level != 255) || ((flags and 4) != 0))) { + return null + } + return RingBatterySnapshot(-1, -1) + } + + /** + * Return the uint16 wake nonce from a CFW field-102 deferred-wake notification (double tap + * or head-up), or -1 when this is an ordinary settings frame (idle-gesture events + * included). + */ + @JvmStatic + fun parseFaceclawWakeEvent(pb: ByteArray): Int { + var event: ByteArray? = faceclawWakeEventBytes(pb) + return (if ((event == null)) -1 + else ((event[4] and 0xff) or ((event[5] and 0xff) shl 8))) + } + + /** + * Which gesture a CFW deferred-wake notification reports: 1 (double tap) or + * FACECLAW_WAKE_EVENT_HEAD_UP; -1 when the frame is not a wake event. + */ + @JvmStatic + fun parseFaceclawWakeEventCode(pb: ByteArray): Int { + var event: ByteArray? = faceclawWakeEventBytes(pb) + return (if ((event == null)) -1 else (event[3] and 0xff)) + } + + private fun faceclawWakeEventBytes(pb: ByteArray?): ByteArray? { + if ((pb == null)) { + return null + } + var event: ByteArray? = readFieldBytes(stripTrailingCrc(pb), FACECLAW_WAKE_EVENT_FIELD) + if ( + (((((event == null) || (event.size != 6)) || (event[0].toInt() != 70)) || + (event[1].toInt() != 67)) || + ((event[2] and 0xff) != FACECLAW_WAKE_PROTOCOL_VERSION)) + ) { + return null + } + var code: Int = (event[3] and 0xff) + return (if (((code == FACECLAW_WAKE_EVENT) || (code == FACECLAW_WAKE_EVENT_HEAD_UP))) + event + else null) + } + + /** + * Decode a CFW field-102 idle-gesture event (tap, long press, release while no app is on + * screen) into the EvenHub sys-event type and source the same gesture would carry from a + * live page, or null when the frame is not one (ordinary settings frames and the double-tap + * wake event included). + */ + @JvmStatic + fun parseFaceclawGestureEvent(pb: ByteArray?): FaceclawGestureEvent? { + if ((pb == null)) { + return null + } + var event: ByteArray? = readFieldBytes(stripTrailingCrc(pb), FACECLAW_WAKE_EVENT_FIELD) + if ( + (((((event == null) || (event.size != 6)) || (event[0].toInt() != 70)) || + (event[1].toInt() != 67)) || + ((event[2] and 0xff) != FACECLAW_WAKE_PROTOCOL_VERSION)) + ) { + return null + } + var eventType: Int + when ((event[3] and 0xff)) { + FACECLAW_GESTURE_EVENT_TAP -> { + eventType = EVENT_CLICK + } + FACECLAW_GESTURE_EVENT_LONG_PRESS -> { + eventType = EVENT_RING_LONG_PRESS + } + FACECLAW_GESTURE_EVENT_LONG_PRESS_RELEASE -> { + eventType = EVENT_RING_LONG_PRESS_RELEASE + } + else -> { + return null + } + } + var eventSource: Int + when ((event[4] and 0xff)) { + FACECLAW_RAW_SOURCE_LEFT_TEMPLE -> { + eventSource = EVENT_SOURCE_GLASSES_L + } + FACECLAW_RAW_SOURCE_RIGHT_TEMPLE -> { + eventSource = EVENT_SOURCE_GLASSES_R + } + FACECLAW_RAW_SOURCE_RING -> { + eventSource = EVENT_SOURCE_RING + } + else -> { + eventSource = 0 + } + } + return FaceclawGestureEvent(eventType, eventSource) + } + + /** + * Decode OnboardingDataPackage EVENT/GLS_WEAR_STATUS. Unlike most async G2 traffic, stock + * firmware sends this event with flag 0x00, so callers must recognize it by sid and + * protobuf shape rather than notify flag. Returns 0/1, or -1 when the frame is not a wear + * event. + */ + @JvmStatic + fun parseWearState(frame: ParsedFrame?): Int { + if ((((frame == null) || !frame.ok) || (frame.sid != SID_ONBOARDING))) { + return -1 + } + var root: ByteArray = stripTrailingCrc(frame.pb) + if ((readVarintFieldValue(root, 1, -1) != 3)) { + return -1 + } + var event: ByteArray? = readFieldBytes(root, 5) + if (((event == null) || (readVarintFieldValue(event, 1, -1) != 1))) { + return -1 + } + var wearStatus: Int = readVarintFieldValue(event, 2, -1) + return (if (((wearStatus == 0) || (wearStatus == 1))) wearStatus else -1) + } + + @JvmStatic + fun parseSettingsBattery(pb: ByteArray): BatterySnapshot? { + var root: ByteArray = stripTrailingCrc(pb) + var request: ByteArray? = readFieldBytes(root, 4) + if ((request == null)) { + return null + } + var battery: Int = readVarintFieldValue(request, 12, -1) + var charging: Int = readVarintFieldValue(request, 13, -1) + var silentMode: Int = readVarintFieldValue(request, 14, -1) + if ((battery < 0)) { + return null + } + return BatterySnapshot(battery, charging, silentMode) + } + + /** + * Silent mode from an unsolicited settings push. The wearer toggles silent mode by + * long-pressing both touchpads at once; the firmware then sends + * G2SettingPackage{commandId=3 (DeviceSendToAPP), deviceSendInfoToApp(5){ + * silentModeSwitch(2)}} on sid 0x09, with a magic it picked itself, so this arrives outside + * the request/ack flow. + * + * Returns -1 when the frame is not such a push. Ordinary settings-read acks (the battery + * poll) carry commandId=2 and deviceReceiveRequestFromApp in field 4, so they never match + * and stay on the normal ack path. + */ + @JvmStatic + fun parseSilentModePush(pb: ByteArray?): Int { + if ((pb == null)) { + return -1 + } + var root: ByteArray = stripTrailingCrc(pb) + if ((readVarintFieldValue(root, 1, -1) != SETTINGS_CMD_DEVICE_SEND_TO_APP)) { + return -1 + } + var info: ByteArray? = readFieldBytes(root, 5) + if ((info == null)) { + return -1 + } + return readVarintFieldValue(info, 2, -1) + } + + /** + * Firmware versions and the firmware-extension string from a settings READ ack. Versions + * are fields 5/6 of the deviceReceiveRequestFromApp submessage (field 4); Faceclaw's custom + * firmware additionally appends top-level field 100 with its revision ("Faceclaw/"; + * older builds sent "EVENCFW/ "), which stock firmware never sends. Returns + * null when the ack carries none of it. Compatibility is judged on the TS side + * (app/g2/firmware-compat.ts); Java only needs to know whether the firmware is ours at all. + */ + @JvmStatic + fun parseSettingsFirmwareInfo(pb: ByteArray): FirmwareInfo? { + var root: ByteArray = stripTrailingCrc(pb) + var request: ByteArray? = readFieldBytes(root, 4) + if ((request == null)) { + return null + } + var leftVersion: String = readStringFieldValue(request, 5) + var rightVersion: String = readStringFieldValue(request, 6) + var extension: String = readStringFieldValue(root, 100) + if (((leftVersion.isEmpty() && rightVersion.isEmpty()) && extension.isEmpty())) { + return null + } + return FirmwareInfo(leftVersion, rightVersion, extension) + } + + @JvmStatic + fun wrapEvenHub(cmd: Int, magic: Int, innerFieldNumber: Int, inner: ByteArray): ByteArray { + var parts: MutableList = ArrayList() + parts.add(encodeVarintField(1, cmd)) + parts.add(encodeVarintField(2, magic)) + parts.add(encodeMessageField(innerFieldNumber, inner)) + return concat(parts) + } + + @JvmStatic + fun encodeTextObject( + name: String, + containerId: Int, + x: Int, + y: Int, + width: Int, + height: Int, + text: String, + captureEvents: Boolean, + ): ByteArray { + var parts: MutableList = ArrayList() + parts.add(encodeVarintField(1, x)) + parts.add(encodeVarintField(2, y)) + parts.add(encodeVarintField(3, width)) + parts.add(encodeVarintField(4, height)) + parts.add(encodeVarintField(9, containerId)) + parts.add(encodeStringField(10, name)) + if (captureEvents) { + parts.add(encodeVarintField(11, 1)) + } + parts.add(encodeStringField(12, text)) + return concat(parts) + } + + @JvmStatic + fun encodeImageObject(tile: ImageTileOptions): ByteArray { + var parts: MutableList = ArrayList() + parts.add(encodeVarintField(1, tile.x)) + parts.add(encodeVarintField(2, tile.y)) + parts.add(encodeVarintField(3, tile.width)) + parts.add(encodeVarintField(4, tile.height)) + parts.add(encodeVarintField(5, tile.containerId)) + parts.add(encodeStringField(6, tile.name)) + return concat(parts) + } + + private fun concat(parts: MutableList): ByteArray { + var out: ByteSink = ByteSink() + for (part in parts) { + if (((part != null) && (part.size > 0))) { + out.write(part, 0, part.size) + } + } + return out.toByteArray() + } + + internal fun encodeVarintField(fieldNumber: Int, value: Int): ByteArray { + return concat(CollectionUtils.listOf(encodeKey(fieldNumber, 0), encodeVarint(value))) + } + + private fun encodeStringField(fieldNumber: Int, value: String?): ByteArray { + var bytes: ByteArray = + (if ((value == null)) ByteArray(0) else value.encodeToByteArray()) + return concat( + CollectionUtils.listOf(encodeKey(fieldNumber, 2), encodeVarint(bytes.size), bytes) + ) + } + + internal fun encodeBytesField(fieldNumber: Int, value: ByteArray?): ByteArray { + var bytes: ByteArray = (if ((value == null)) ByteArray(0) else value) + return concat( + CollectionUtils.listOf(encodeKey(fieldNumber, 2), encodeVarint(bytes.size), bytes) + ) + } + + private fun encodeMessageField(fieldNumber: Int, value: ByteArray?): ByteArray { + var bytes: ByteArray = (if ((value == null)) ByteArray(0) else value) + return concat( + CollectionUtils.listOf(encodeKey(fieldNumber, 2), encodeVarint(bytes.size), bytes) + ) + } + + private fun encodeKey(fieldNumber: Int, wireType: Int): ByteArray { + return encodeVarint(((fieldNumber shl 3) or wireType)) + } + + private fun encodeVarint(value: Int): ByteArray { + var out: ByteSink = ByteSink() + var v: Int = (value ushr 0) + while ((v >= 0x80)) { + out.write(((v and 0x7f) or 0x80)) + v = (v ushr 7) + } + out.write(v) + return out.toByteArray() + } + + private fun crcBytesLe(data: ByteArray): ByteArray { + var crc: Int = 0xffff + for (b in data) { + crc = (crc xor ((b and 0xff) shl 8)) + run { + var i: Int = 0 + while ((i < 8)) { + if (((crc and 0x8000) != 0)) { + crc = (((crc shl 1) xor 0x1021) and 0xffff) + } else { + crc = ((crc shl 1) and 0xffff) + } + i++ + } + } + } + return byteArrayOf(((crc and 0xff)).toByte(), (((crc ushr 8) and 0xff)).toByte()) + } + + /** + * Split one notification value into individual `aa21`/`aa12` envelope frames. A value + * normally holds exactly one frame, but the firmware can pack several (each self-describing + * via the length byte at offset 3), and a frame that only reads the first would silently + * drop the rest. A value that does not start with an envelope, or a trailing partial frame + * (truncated by the stack — observed on a Samsung tablet for values over 64 bytes), is + * returned as-is so the caller can log it. + */ + @JvmStatic + fun splitFrames(value: ByteArray?): MutableList { + var out: MutableList = ArrayList() + if (((value == null) || (value.size == 0))) { + return out + } + var offset: Int = 0 + while ( + ((((offset + 8) <= value.size) && (value[offset] == (0xaa).toByte())) && + ((value[(offset + 1)].toInt() == 0x21) || + (value[(offset + 1)].toInt() == 0x12))) + ) { + var len: Int = (value[(offset + 3)] and 0xff) + var end: Int = minOf(value.size, ((offset + 8) + len)) + out.add(value.copyOfRange(offset, end)) + offset = end + } + if ((offset < value.size)) { + out.add(value.copyOfRange(offset, value.size)) + } + return out + } + + @JvmStatic + fun parseFrame(buf: ByteArray?): ParsedFrame { + if ( + ((((buf == null) || (buf.size < 10)) || (buf[0] != (0xaa).toByte())) || + ((buf[1].toInt() != 0x21) && (buf[1].toInt() != 0x12))) + ) { + return ParsedFrame(false, 0, 0, ByteArray(0), -1, -1) + } + var sid: Int = (buf[6] and 0xff) + var flag: Int = (buf[7] and 0xff) + var len: Int = (buf[3] and 0xff) + var end: Int = minOf(buf.size, (8 + len)) + var pb: ByteArray = buf.copyOfRange(8, end) + var msgType: Int = -1 + var msgSeq: Int = -1 + var offset: Int = 0 + run { + var i: Int = 0 + while (((i < 8) && (offset < pb.size))) { + var key: VarintResult? = readVarint(pb, offset) + if ((key == null)) { + break + } + offset = key.next + var tag: Int = (key.value shr 3) + var wire: Int = (key.value and 7) + if ((wire == 0)) { + var value: VarintResult? = readVarint(pb, offset) + if ((value == null)) { + break + } + if ((tag == 1)) { + msgType = value.value + } else { + if ((tag == 2)) { + msgSeq = value.value + } + } + offset = value.next + } else { + if ((wire == 2)) { + var length: VarintResult? = readVarint(pb, offset) + if ((length == null)) { + break + } + offset = (length.next + length.value) + } else { + break + } + } + if (((msgType >= 0) && (msgSeq >= 0))) { + break + } + i++ + } + } + return ParsedFrame(true, sid, flag, pb, msgType, msgSeq) + } + + @JvmStatic + fun stripTrailingCrc(pb: ByteArray?): ByteArray { + if (((pb == null) || (pb.size < 2))) { + return (if ((pb == null)) ByteArray(0) else pb) + } + return pb.copyOf((pb.size - 2)) + } + + /** Decode the stock firmware's compass navigation notifications (sid 0x08). */ + @JvmStatic + fun parseCompassEvent(frame: ParsedFrame?): CompassEvent? { + if ( + ((((frame == null) || !frame.ok) || (frame.sid != SID_NAVIGATION)) || + ((frame.flag != FLAG_NOTIFY) && (frame.flag != FLAG_NOTIFY_ALT))) + ) { + return null + } + var root: ByteArray = stripTrailingCrc(frame.pb) + var command: Int = readVarintFieldValue(root, 1, -1) + if ((command == NAV_CMD_COMPASS_CHANGED)) { + var compass: ByteArray? = readFieldBytes(root, 10) + if ((compass == null)) { + return null + } + var heading: Int = readVarintFieldValue(compass, 1, -1) + if (((heading < 0) || (heading >= 360))) { + return null + } + var diagnostic: ByteArray? = readFieldBytes(root, 100) + if ( + (((((((((diagnostic != null) && (diagnostic.size == 12)) && + (diagnostic[0].toInt() == 67)) && (diagnostic[1].toInt() == 77)) && + (diagnostic[2].toInt() == 1)) && (diagnostic[7].toInt() == 0)) && + (((diagnostic[3] and 0xff) <= 3) || (diagnostic[3] == (255).toByte()))) && + (((diagnostic[4] and 0xff) <= 2) || (diagnostic[4] == (255).toByte()))) && + ((diagnostic[5] and 0xff) <= 3)) + ) { + var sampleTimeMs: Long = 0 + run { + var i: Int = 0 + while ((i < 4)) { + sampleTimeMs = + (sampleTimeMs or + (((diagnostic[(8 + i)] and 0xff)).toLong() shl (8 * i))) + i++ + } + } + return CompassEvent( + command, + heading, + (if ((diagnostic[3] == (255).toByte())) -1 else (diagnostic[3] and 0xff)), + (if ((diagnostic[4] == (255).toByte())) -1 else (diagnostic[4] and 0xff)), + (diagnostic[5] and 0xff), + (diagnostic[6] and 0xff), + sampleTimeMs, + ) + } + return CompassEvent(command, heading) + } + if ( + ((command == NAV_CMD_COMPASS_CALIBRATION_STARTED) || + (command == NAV_CMD_COMPASS_CALIBRATION_COMPLETE)) + ) { + return CompassEvent(command, -1) + } + return null + } + + /** + * Display wake notification observed after a ring or right-arm double tap while no EvenHub + * page is running: + * + * sid=0x0d, flag=notify, payload f1=1, f3={f1=1} + * + * Other state-change shapes (wear, charging, head-up, etc.) are deliberately excluded. The + * caller additionally gates this on an intentional EvenHub suspension, so normal state + * traffic cannot become application input. + */ + @JvmStatic + fun isDisplayWakeStateChange(frame: ParsedFrame?): Boolean { + if ( + ((((frame == null) || !frame.ok) || (frame.sid != SID_STATE_CHANGE)) || + ((frame.flag != FLAG_NOTIFY) && (frame.flag != FLAG_NOTIFY_ALT))) + ) { + return false + } + var root: ByteArray = stripTrailingCrc(frame.pb) + if ((readVarintFieldValue(root, 1, -1) != 1)) { + return false + } + var state: ByteArray? = readFieldBytes(root, 3) + return (((state != null) && (state.size == 2)) && + (readVarintFieldValue(state, 1, -1) == 1)) + } + + @JvmStatic + fun readFieldBytes(pb: ByteArray, fieldNumber: Int): ByteArray? { + var offset: Int = 0 + while ((offset < pb.size)) { + var key: VarintResult? = readVarint(pb, offset) + if ((key == null)) { + return null + } + offset = key.next + var field: Int = (key.value shr 3) + var wire: Int = (key.value and 0x07) + if ((wire == 0)) { + var value: VarintResult? = readVarint(pb, offset) + if ((value == null)) { + return null + } + offset = value.next + continue + } + if ((wire == 1)) { + offset += 8 + continue + } + if ((wire == 5)) { + offset += 4 + continue + } + if ((wire != 2)) { + return null + } + var length: VarintResult? = readVarint(pb, offset) + if ((length == null)) { + return null + } + offset = length.next + var end: Int = (offset + length.value) + if ((end > pb.size)) { + return null + } + var bytes: ByteArray = pb.copyOfRange(offset, end) + offset = end + if ((field == fieldNumber)) { + return bytes + } + } + return null + } + + @JvmStatic + fun readVarintFieldValue(pb: ByteArray, fieldNumber: Int, defaultValue: Int): Int { + var offset: Int = 0 + while ((offset < pb.size)) { + var key: VarintResult? = readVarint(pb, offset) + if ((key == null)) { + return defaultValue + } + offset = key.next + var field: Int = (key.value shr 3) + var wire: Int = (key.value and 0x07) + if ((wire == 0)) { + var value: VarintResult? = readVarint(pb, offset) + if ((value == null)) { + return defaultValue + } + offset = value.next + if ((field == fieldNumber)) { + return value.value + } + continue + } + if ((wire == 1)) { + offset += 8 + continue + } + if ((wire == 5)) { + offset += 4 + continue + } + if ((wire != 2)) { + return defaultValue + } + var length: VarintResult? = readVarint(pb, offset) + if ((length == null)) { + return defaultValue + } + offset = (length.next + length.value) + } + return defaultValue + } + + /** + * Read a `float` (protobuf wire type 5, little-endian fixed32) field. The g2-kit proto + * declares IMU_Report_Data's x/y/z as `double`, but the firmware actually sends them as + * fixed32 floats (confirmed from captures). Returns defaultValue if absent. + */ + @JvmStatic + fun readFloatFieldValue(pb: ByteArray, fieldNumber: Int, defaultValue: Float): Float { + var offset: Int = 0 + while ((offset < pb.size)) { + var key: VarintResult? = readVarint(pb, offset) + if ((key == null)) { + return defaultValue + } + offset = key.next + var field: Int = (key.value shr 3) + var wire: Int = (key.value and 0x07) + if ((wire == 0)) { + var value: VarintResult? = readVarint(pb, offset) + if ((value == null)) { + return defaultValue + } + offset = value.next + } else { + if ((wire == 1)) { + offset += 8 + } else { + if ((wire == 5)) { + if (((offset + 4) > pb.size)) { + return defaultValue + } + if ((field == fieldNumber)) { + var bits: Int = 0 + run { + var i: Int = 0 + while ((i < 4)) { + bits = (bits or ((pb[(offset + i)] and 0xff) shl (8 * i))) + i++ + } + } + return Float.fromBits(bits) + } + offset += 4 + } else { + if ((wire == 2)) { + var length: VarintResult? = readVarint(pb, offset) + if ((length == null)) { + return defaultValue + } + offset = (length.next + length.value) + } else { + return defaultValue + } + } + } + } + } + return defaultValue + } + + @JvmStatic + fun readStringFieldValue(pb: ByteArray, fieldNumber: Int): String { + var bytes: ByteArray? = readFieldBytes(pb, fieldNumber) + if ((bytes == null)) { + return "" + } + return bytes.decodeToString() + } + + @JvmStatic + fun readVarint(pb: ByteArray, offset: Int): VarintResult? { + var value: Int = 0 + var shift: Int = 0 + var cursor: Int = offset + while ((cursor < pb.size)) { + var b: Int = (pb[cursor++] and 0xff) + value = (value or ((b and 0x7f) shl shift)) + if (((b and 0x80) == 0)) { + return VarintResult(value, cursor) + } + shift += 7 + } + return null + } + } + + class RingBatterySnapshot { + @JvmField val battery: Int + + @JvmField val charging: Int + + constructor(battery: Int, charging: Int) { + this.battery = battery + this.charging = charging + } + } + + /** An idle gesture from a CFW field-102 notification, in EvenHub sys-event terms. */ + class FaceclawGestureEvent { + @JvmField val eventType: Int + + @JvmField val eventSource: Int + + constructor(eventType: Int, eventSource: Int) { + this.eventType = eventType + this.eventSource = eventSource + } + } + + class ParsedFrame { + @JvmField val ok: Boolean + + @JvmField val sid: Int + + @JvmField val flag: Int + + @JvmField val pb: ByteArray + + @JvmField val msgType: Int + + @JvmField val msgSeq: Int + + constructor(ok: Boolean, sid: Int, flag: Int, pb: ByteArray, msgType: Int, msgSeq: Int) { + this.ok = ok + this.sid = sid + this.flag = flag + this.pb = pb + this.msgType = msgType + this.msgSeq = msgSeq + } + } + + class VarintResult { + @JvmField val value: Int + + @JvmField val next: Int + + constructor(value: Int, next: Int) { + this.value = value + this.next = next + } + } + + class ListSelection { + @JvmField val containerName: String? + + @JvmField val itemName: String? + + @JvmField val itemIndex: Int + + @JvmField val eventType: Int + + constructor(containerName: String?, itemName: String?, itemIndex: Int, eventType: Int) { + this.containerName = (if ((containerName == null)) "" else containerName) + this.itemName = (if ((itemName == null)) "" else itemName) + this.itemIndex = itemIndex + this.eventType = eventType + } + } + + class CompassEvent { + @JvmField val command: Int + + @JvmField val headingDegrees: Int + + /** -1 means unavailable; source: 0 unknown, 1 GRV, 2 GMRV, 3 RV. */ + @JvmField val magneticAccuracy: Int + @JvmField val magneticAnomalies: Int + @JvmField val orientationSource: Int + @JvmField val diagnosticFlags: Int + + @JvmField val sampleTimeMs: Long + + constructor( + command: Int, + headingDegrees: Int, + ) : this(command, headingDegrees, -1, -1, -1, -1, -1) {} + + constructor( + command: Int, + headingDegrees: Int, + magneticAccuracy: Int, + magneticAnomalies: Int, + orientationSource: Int, + diagnosticFlags: Int, + sampleTimeMs: Long, + ) { + this.command = command + this.headingDegrees = headingDegrees + this.magneticAccuracy = magneticAccuracy + this.magneticAnomalies = magneticAnomalies + this.orientationSource = orientationSource + this.diagnosticFlags = diagnosticFlags + this.sampleTimeMs = sampleTimeMs + } + } + + class ImageTileOptions { + @JvmField val name: String + + @JvmField val containerId: Int + + @JvmField val x: Int + + @JvmField val y: Int + + @JvmField val width: Int + + @JvmField val height: Int + + constructor(name: String, containerId: Int, x: Int, y: Int, width: Int, height: Int) { + this.name = name + this.containerId = containerId + this.x = x + this.y = y + this.width = width + this.height = height + } + } + + class ImageFragment { + @JvmField val index: Int + + @JvmField val data: ByteArray + + @JvmField val size: Int + + constructor(index: Int, data: ByteArray, size: Int) { + this.index = index + this.data = data + this.size = size + } + } + + class BatterySnapshot { + @JvmField val battery: Int + + @JvmField val charging: Int + + /** 1 = silent mode on, 0 = off, -1 = the ack didn't carry the field. */ + @JvmField val silentMode: Int + + constructor(battery: Int, charging: Int, silentMode: Int) { + this.battery = battery + this.charging = charging + this.silentMode = silentMode + } + } + + class FirmwareInfo { + companion object { + /** Prefix of the firmware-extension string on Faceclaw's custom firmware. */ + const val FACECLAW_EXTENSION_PREFIX: String = "Faceclaw/" + } + + @JvmField val leftVersion: String + + @JvmField val rightVersion: String + + /** Raw field-100 string ("" on stock firmware). */ + @JvmField val extension: String + + constructor(leftVersion: String, rightVersion: String, extension: String?) { + this.leftVersion = leftVersion + this.rightVersion = rightVersion + this.extension = (if ((extension == null)) "" else extension) + } + + /** + * True when the glasses run Faceclaw's custom firmware (any revision). Whether the revision + * is the one this app needs is decided on the TS side, which disconnects on a mismatch; + * this only guards the private modes against stock or third-party firmware in the meantime. + */ + fun isFaceclawFirmware(): Boolean { + return extension.trim().startsWith(FACECLAW_EXTENSION_PREFIX) + } + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/CfwMessageWindow.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/CfwMessageWindow.kt new file mode 100644 index 00000000..74868596 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/CfwMessageWindow.kt @@ -0,0 +1,44 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmStatic + +/** Ordered completion and go-back-N recovery for the custom-message window. */ +class CfwMessageWindow private constructor() { + companion object { + // Flappy capture: p99 ACK 63ms, max 77ms. Allow full-frame processing + // while recovering a lost reply well before the stock timeout. + const val ACK_TIMEOUT_MS = 500 + const val MAX_RETRIES = 3 + + @JvmStatic + fun acknowledgedHead(messages: Iterable): OutboundMessage? { + for (message in messages) { + if (message.sid != CfwTransport.SID) continue + return if (!message.cfwRetryPending && message.cfwAckLenses == CfwTransport.BOTH) + message + else null + } + return null + } + + @JvmStatic + fun replayWindow(messages: Iterable, nowMs: Long): List { + val replay = mutableListOf() + var failed = false + for (message in messages) { + if (message.sid != CfwTransport.SID) continue + failed = + failed || + message.cfwRetryPending || + (message.cfwAckLenses != CfwTransport.BOTH && + message.ackDeadlineAtMs > 0 && + message.ackDeadlineAtMs <= nowMs) + replay.add(message) + } + // Replaying only the named failure can strand an older unresolved + // attempt at the head. Rewind the entire unresolved custom window. + if (!failed) replay.clear() + return replay + } + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/CfwTransport.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/CfwTransport.kt new file mode 100644 index 00000000..0ce887fd --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/CfwTransport.kt @@ -0,0 +1,190 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmField +import kotlin.jvm.JvmStatic + +/** Faceclaw/10 records: clear flags, wire length and decoded CRC; persistent zlib body. */ +class CfwTransport(private val platform: ProtocolPlatform) { + private val lock = platform.createLock() + private var deflater: ProtocolDeflater? = null + private var resetPending = true + private var previousLenses = 0 + + fun reset() = lock.withLock { + deflater?.reset() + resetPending = true + previousLenses = 0 + } + + /** Release native compression resources. A later encode starts a fresh stream. */ + fun close() = lock.withLock { + deflater?.close() + deflater = null + resetPending = true + previousLenses = 0 + } + + /** Compress only when writing, in exactly the order seen by the receiver. */ + fun encode(message: ByteArray?, streamId: Int, lenses: Int, mtu: Int): List = + lock.withLock { + validate(message, streamId, lenses, mtu) + val input = message!! + if (previousLenses != lenses) reset() + val reset = resetPending + val encoder = deflater ?: platform.createDeflater().also { deflater = it } + var body = encoder.syncFlush(input) + var flags = lenses or COMPRESSED or (if (reset) RESET_CONTEXT else 0) + if (body.isEmpty()) flags = flags and COMPRESSED.inv() // repeated empty sync flush + if (body.size > MAX_MESSAGE) { + // The attempted deflate advanced history: reset both ends before reuse. + reset() + body = input + flags = lenses or RESET_CONTEXT + } else { + resetPending = false + previousLenses = lenses + } + frameRecord(body, crc(input), streamId, flags, mtu) + } + + companion object { + const val SID = 0xf0 + const val BOTH = 3 + const val MAX_MESSAGE = 65535 + const val COMPRESSED = 4 + const val RESET_CONTEXT = 8 + + private fun validate(message: ByteArray?, streamId: Int, lenses: Int, mtu: Int) { + require( + message != null && + message.size <= MAX_MESSAGE && + streamId in 0..255 && + lenses in 1..BOTH && + mtu in 23..517 + ) { + "invalid CFW stream parameters" + } + } + + /** One logical command per stream. Packets are bounded by actual ATT MTU. */ + @JvmStatic + fun frame(message: ByteArray?, streamId: Int, lenses: Int, mtu: Int): List { + validate(message, streamId, lenses, mtu) + return frameRecord(message!!, crc(message), streamId, lenses or RESET_CONTEXT, mtu) + } + + private fun frameRecord( + body: ByteArray, + checksum: Int, + streamId: Int, + flags: Int, + mtu: Int, + ): List { + val lenses = flags and BOTH + val capacity = minOf(252, mtu - 14) + val stream = ByteArray(body.size + 5) + stream[0] = flags.toByte() + stream[1] = body.size.toByte() + stream[2] = (body.size ushr 8).toByte() + stream[3] = checksum.toByte() + stream[4] = (checksum ushr 8).toByte() + body.copyInto(stream, 5) + val packets = mutableListOf() + for (offset in stream.indices step capacity) { + val count = minOf(capacity, stream.size - offset) + val packet = ByteArray(count + 11) + packet[0] = 0xaa.toByte() + packet[1] = 0x21 + packet[2] = (streamId + packets.size).toByte() + packet[3] = (count + 3).toByte() + packet[4] = 1 + packet[5] = 1 + packet[6] = SID.toByte() + packet[8] = + (lenses or + (if (offset == 0) 0x80 else 0) or + (if (offset + count == stream.size) 0x40 else 0)) + .toByte() + stream.copyInto(packet, 9, offset, offset + count) + val crc = crc(packet, 8, count + 1) + packet[packet.size - 2] = crc.toByte() + packet[packet.size - 1] = (crc ushr 8).toByte() + packets.add(packet) + } + return packets + } + + @JvmStatic fun crc(data: ByteArray): Int = crc(data, 0, data.size) + + private fun crc(data: ByteArray, offset: Int, count: Int): Int { + var crc = 0xffff + for (i in offset until offset + count) { + crc = crc xor ((data[i].toInt() and 255) shl 8) + repeat(8) { + crc = ((crc shl 1) xor (if (crc and 0x8000 != 0) 0x1021 else 0)) and 65535 + } + } + return crc + } + + private fun u16(data: ByteArray, offset: Int): Int = + (data[offset].toInt() and 255) or ((data[offset + 1].toInt() and 255) shl 8) + + @JvmStatic fun parseAck(packet: ByteArray?): Ack? = parseAcks(packet)?.first() + + /** + * Validate the entire primary ACK and up to three preceding successes before applying any. + */ + @JvmStatic + fun parseAcks(packet: ByteArray?): Array? { + if ( + packet == null || + packet.size !in 19..40 || + (packet.size - 19) % 7 != 0 || + packet[0].toInt() and 255 != 0xaa || + packet[1].toInt() != 0x12 || + packet[3].toInt() and 255 != packet.size - 8 || + packet[4].toInt() != 1 || + packet[5].toInt() != 1 || + packet[6].toInt() and 255 != SID || + packet[7].toInt() != 0 || + (packet[8].toInt() != 1 && packet[8].toInt() != 3) || + (packet[12].toInt() != 1 && packet[12].toInt() != 2) || + (packet[8].toInt() == 3 && packet.size != 19) || + crc(packet, 8, packet.size - 10) != u16(packet, packet.size - 2) + ) + return null + return Array(1 + (packet.size - 19) / 7) { i -> + if (i == 0) + Ack( + packet[8].toInt() == 3, + packet[9].toInt() and 255, + u16(packet, 10), + packet[12].toInt(), + u16(packet, 13), + u16(packet, 15), + ) + else { + val offset = 17 + (i - 1) * 7 + Ack( + false, + packet[offset].toInt() and 255, + u16(packet, offset + 1), + packet[12].toInt(), + u16(packet, offset + 3), + u16(packet, offset + 5), + ) + } + } + } + } + + class Ack( + @JvmField val nack: Boolean, + @JvmField val streamId: Int, + @JvmField val messageId: Int, + @JvmField val lens: Int, + @JvmField val size: Int, + @JvmField val checksum: Int, + ) +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/ConnectionOptions.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/ConnectionOptions.kt new file mode 100644 index 00000000..caba97a1 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/ConnectionOptions.kt @@ -0,0 +1,78 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmField + +class ConnectionOptions { + companion object { + @JvmField val WRITE_MODE = GattWriteMode.WITHOUT_RESPONSE + const val DESIRED_MTU = 512 + + const val CONNECT_TIMEOUT_MS = 5_000 + const val SERVICES_TIMEOUT_MS = 5_000 + const val DESCRIPTOR_TIMEOUT_MS = 5_000 + const val RING_DESIRED_MTU = 247 + const val RING_RECONNECT_DELAY_MS = 2_000 + const val WRITE_TIMEOUT_MS = 2_000 + const val PRELUDE_TIMEOUT_MS = 2_000 + // Application security-auth exchange (sid 0x80). The success notification + // only arrives once the BLE link is encrypted, which on a first-time + // connection means SMP pairing — possibly with an OS dialog the user has + // to accept — so the stock-firmware paths wait generously. + const val SECURITY_AUTH_TIMEOUT_MS = 30_000 + // The main communicator's wait is soft (it proceeds on timeout so firmware + // that never answers can't stall every reconnect), so it is kept short. + const val SECURITY_AUTH_SOFT_TIMEOUT_MS = 6_000 + const val ACK_TIMEOUT_MS = 3_500 + const val HEARTBEAT_FAILURE_DEADLINE_MS = 10_000 + const val HEARTBEAT_READY_MS = 4_000 + const val HEARTBEAT_URGENT_MS = 6_000 + const val BATTERY_REFRESH_INTERVAL_MS = 5 * 60_000 + const val BATTERY_INPUT_QUIET_MS = 5_000 + // Poll cadence while in charging mode; also bounds how quickly we notice + // the glasses coming back out of the case. + const val CHARGING_BATTERY_POLL_MS = 30_000 + const val IMAGE_FRAGMENT_SIZE = 3800 + const val IMAGE_RETRY_DELAY_MS = 2_000 + const val MAX_CONSECUTIVE_ACK_TIMEOUTS = 8 + const val EVEN_APP_WRITE_FAILURE_WINDOW_MS = 15_000 + const val IDLE_SLEEP_MS = 100 + const val RECONNECT_DELAY_MS = 2_000 + // Cap on rects per batch. Each rect consumes a distinct CFW frame id, and the + // firmware's duplicate-fid ring holds 16, so keep several batches of history + // within it. Above this the split is abandoned for a single bounding box. + const val MULTI_RECT_MAX_RECTS = 6 + // Don't bother splitting when the single bounding box already compresses this + // small (one tight rect); only attempt multi-rect above it or when the box + // spans multiple horizontal clusters. + const val MULTI_RECT_MIN_PAYLOAD = 900 + } + + @JvmField val sendImagesToLeft = true + @JvmField val skipSessionIds = true + // Max messages in flight (awaiting ack) at once — full pipelining. >1 lets a + // frame be sent before the previous frame's ack returns, hiding the BLE ack + // round-trip that otherwise serialized every update. Requires firmware that + // accepts pipelined image messages (the CFW snapshot/deferred FIFO). At 1 the + // communicator behaves exactly as before (serial sends + last-packet prewrite). + @JvmField val WINDOW_SIZE = 3 + // Send changed-region (mode 3 bounding box) updates instead of full frames + // when the previous frame is known to be displayed. Requires firmware with + // the experimental bbox-incremental mode. Disabled: the firmware-side + // display buffer is not always the previous frame (occasionally two frames + // back, apparently display-driver buffer swapping), so partial updates + // composite onto stale content per-lens. Re-enable once the firmware + // guarantees the compositing base. + @JvmField val INCREMENTAL_FRAMES = true + + // Send several tight rectangle deltas as one CFW mode-8 multi-segment message + // instead of a single bounding box, when the change splits into regions whose + // bounding box wastes bytes (distant edits, or a sparse box). Requires firmware + // with mode-8 multi-rect support; needs INCREMENTAL_FRAMES (same seeded shadow). + // Falls back to the single bounding box whenever multi-rect isn't smaller. + @JvmField val MULTI_RECT_FRAMES = true + + // Ship text as on-glasses cached-glyph draws (CFW modes 12/14) instead of + // pixels, punching glyph ink out of the baked deltas (see TexturePlanner). + // Also gated at runtime on the firmware advertising texcache12 + texstr14. + @JvmField val TEXTURE_CACHE_FRAMES = true +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/FaceclawRingEventDecoder.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/FaceclawRingEventDecoder.kt new file mode 100644 index 00000000..651f18a9 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/FaceclawRingEventDecoder.kt @@ -0,0 +1,145 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmField +import kotlin.jvm.JvmStatic + +class FaceclawRingEventDecoder { + companion object { + @JvmStatic + fun decode(raw: ByteArray?): DirectRingEvent? { + if (((raw == null) || (raw.size == 0))) { + return null + } + var chargerGesture: DirectRingEvent? = decodeChargerGesture(raw) + if ((chargerGesture != null)) { + return chargerGesture + } + return decodeDirectGesture(raw) + } + + private fun decodeChargerGesture(raw: ByteArray): DirectRingEvent? { + if ((raw.size != 11)) { + return null + } + if ( + ((((u8(raw[0]) != 0x00) || (u8(raw[1]) != 0x09)) || (u8(raw[2]) != 0x61)) || + (u8(raw[3]) != 0x00)) + ) { + return null + } + var code: Int = u8(raw[4]) + var param: Int = (u8(raw[5]) or (u8(raw[6]) shl 8)) + var tick: Long = + ((((u8(raw[7]) or (u8(raw[8]) shl 8)) or (u8(raw[9]) shl 16)) or + (u8(raw[10]) shl 24)) + .toLong() and 0xffffffffL) + var detail: String = + "code=0x${code.toString(16).padStart(2, '0')}(${chargerCodeName(code)}) param=0x${param.toString(16).padStart(4, '0')} tick=$tick" + when (code) { + 0x00 -> { + return event(BleProtocol.EVENT_RING_LONG_PRESS, "LONG_PRESS", detail) + } + 0x01 -> { + return event(BleProtocol.EVENT_CLICK, "TAP", detail) + } + 0x02 -> { + return event(BleProtocol.EVENT_DOUBLE_CLICK, "DOUBLE_TAP", detail) + } + 0x04 -> { + return event(BleProtocol.EVENT_SCROLL_TOP, "SWIPE_UP", detail) + } + 0x05 -> { + return event(BleProtocol.EVENT_SCROLL_BOTTOM, "SWIPE_DOWN", detail) + } + 0x08 -> { + return event( + BleProtocol.EVENT_RING_LONG_PRESS_RELEASE, + "LONG_PRESS_RELEASE", + detail, + ) + } + else -> { + return null + } + } + } + + private fun decodeDirectGesture(raw: ByteArray): DirectRingEvent? { + if (((raw.size != 3) || (u8(raw[0]) != 0xff))) { + return null + } + var type: Int = u8(raw[1]) + var param: Int = u8(raw[2]) + var detail: String = + "type=0x${type.toString(16).padStart(2, '0')} param=0x${param.toString(16).padStart(2, '0')}" + if (((type == 0x03) && (param == 0x20))) { + return event(BleProtocol.EVENT_RING_LONG_PRESS, "HOLD", detail) + } + if (((type == 0x04) && (param == 0x01))) { + return event(BleProtocol.EVENT_CLICK, "TAP_SINGLE", detail) + } + if (((type == 0x04) && (param == 0x02))) { + return event(BleProtocol.EVENT_DOUBLE_CLICK, "TAP_DOUBLE", detail) + } + if ((type == 0x05)) { + if ((param <= 0x01)) { + return event(BleProtocol.EVENT_SCROLL_BOTTOM, "SWIPE_FORWARD", detail) + } + return event(BleProtocol.EVENT_SCROLL_TOP, "SWIPE_BACKWARD", detail) + } + return null + } + + private fun event(eventType: Int, label: String, detail: String): DirectRingEvent { + var event: G2Event = + G2Event("sys-event", "", eventType, BleProtocol.EVENT_SOURCE_RING, 0) + return DirectRingEvent(event, label, detail) + } + + private fun chargerCodeName(code: Int): String { + when (code) { + 0x00 -> { + return "LONG_PRESS" + } + 0x01 -> { + return "TAP" + } + 0x02 -> { + return "DOUBLE_TAP" + } + 0x04 -> { + return "SWIPE_UP" + } + 0x05 -> { + return "SWIPE_DOWN" + } + 0x08 -> { + return "LONG_PRESS_RELEASE" + } + else -> { + return "unknown" + } + } + } + + private fun u8(value: Byte): Int { + return (value and 0xff) + } + } + + constructor() {} + + class DirectRingEvent { + @JvmField val event: G2Event + + @JvmField val label: String + + @JvmField val detail: String + + constructor(event: G2Event, label: String, detail: String) { + this.event = event + this.label = label + this.detail = detail + } + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/G2Event.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/G2Event.kt new file mode 100644 index 00000000..0bc9ee9c --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/G2Event.kt @@ -0,0 +1,141 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmField +import kotlin.jvm.JvmStatic + +class G2Event { + companion object { + @JvmStatic + fun decode(frame: BleProtocol.ParsedFrame): G2Event? { + return decodePayload(frame.sid, BleProtocol.stripTrailingCrc(frame.pb)) + } + + /** Decode an already validated payload, without the envelope's trailing CRC. */ + @JvmStatic + fun decodePayload(sid: Int, pb: ByteArray): G2Event? { + if ((sid == BleProtocol.SID_EVEN_AI)) { + var commandId: Int = BleProtocol.readVarintFieldValue(pb, 1, -1) + if ((commandId != BleProtocol.EVEN_AI_CMD_CTRL)) { + return null + } + var ctrl: ByteArray? = BleProtocol.readFieldBytes(pb, 3) + if ((ctrl == null)) { + return null + } + var status: Int = BleProtocol.readVarintFieldValue(ctrl, 1, -1) + if ((status < 0)) { + return null + } + return G2Event("even-ai", "", status, 0, 0) + } + var deviceEvent: ByteArray? = BleProtocol.readFieldBytes(pb, 13) + if ((deviceEvent == null)) { + return null + } + var listEvent: ByteArray? = BleProtocol.readFieldBytes(deviceEvent, 1) + if ((listEvent != null)) { + return G2Event( + "list-click", + BleProtocol.readStringFieldValue(listEvent, 2), + BleProtocol.readVarintFieldValue(listEvent, 5, BleProtocol.EVENT_CLICK), + 0, + 0, + ) + } + var textEvent: ByteArray? = BleProtocol.readFieldBytes(deviceEvent, 2) + if ((textEvent != null)) { + return G2Event( + "text-click", + BleProtocol.readStringFieldValue(textEvent, 2), + BleProtocol.readVarintFieldValue(textEvent, 3, BleProtocol.EVENT_CLICK), + 0, + 0, + ) + } + var sysEvent: ByteArray? = BleProtocol.readFieldBytes(deviceEvent, 3) + if ((sysEvent != null)) { + var eventType: Int = + BleProtocol.readVarintFieldValue(sysEvent, 1, BleProtocol.EVENT_CLICK) + var eventSource: Int = BleProtocol.readVarintFieldValue(sysEvent, 2, 0) + var exitReason: Int = BleProtocol.readVarintFieldValue(sysEvent, 4, 0) + var imu: ByteArray? = BleProtocol.readFieldBytes(sysEvent, 3) + if ((imu != null)) { + var x: Double = BleProtocol.readFloatFieldValue(imu, 1, 0f).toDouble() + var y: Double = BleProtocol.readFloatFieldValue(imu, 2, 0f).toDouble() + var z: Double = BleProtocol.readFloatFieldValue(imu, 3, 0f).toDouble() + return G2Event( + "sys-event", + "", + eventType, + eventSource, + exitReason, + true, + x, + y, + z, + ) + } + return G2Event("sys-event", "", eventType, eventSource, exitReason) + } + return null + } + } + + @JvmField val kind: String + + @JvmField val containerName: String + + @JvmField val eventType: Int + + @JvmField val eventSource: Int + + @JvmField val systemExitReasonCode: Int + + @JvmField val hasImu: Boolean + + @JvmField val imuX: Double + + @JvmField val imuY: Double + + @JvmField val imuZ: Double + + constructor( + kind: String, + containerName: String, + eventType: Int, + eventSource: Int, + systemExitReasonCode: Int, + ) : this( + kind, + containerName, + eventType, + eventSource, + systemExitReasonCode, + false, + 0.0, + 0.0, + 0.0, + ) {} + + constructor( + kind: String, + containerName: String, + eventType: Int, + eventSource: Int, + systemExitReasonCode: Int, + hasImu: Boolean, + imuX: Double, + imuY: Double, + imuZ: Double, + ) { + this.kind = kind + this.containerName = containerName + this.eventType = eventType + this.eventSource = eventSource + this.systemExitReasonCode = systemExitReasonCode + this.hasImu = hasImu + this.imuX = imuX + this.imuY = imuY + this.imuZ = imuZ + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/MessageBuilder.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/MessageBuilder.kt new file mode 100644 index 00000000..218c7d4c --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/MessageBuilder.kt @@ -0,0 +1,292 @@ +package com.faceclaw.app + +class MessageBuilder { + companion object { + private const val ACK_TIMEOUT_MS: Int = 3_500 + + private const val HEARTBEAT_TIMEOUT_MS: Int = 1_500 + } + + private var magicPool: BleMagicPool + + constructor(magicPool: BleMagicPool) { + this.magicPool = magicPool + } + + fun prelude(): OutboundMessage { + return OutboundMessage( + "prelude", + "prelude", + BleProtocol.PRELUDE_ACK_SID, + BleProtocol.FLAG_REQUEST, + BleProtocol.PRELUDE_ACK_MAGIC, + BleProtocol.PRELUDE_F5872_PAYLOAD, + ACK_TIMEOUT_MS, + -1, + false, + ) + } + + /** The per-connection sid-0x80 security-auth request (one per arm). */ + fun securityAuth(leftArm: Boolean): OutboundMessage { + var magic: Int = magicPool.allocate() + return OutboundMessage( + "security-auth", + ("security auth " + (if (leftArm) "L" else "R")), + BleProtocol.SID_SECURITY_AUTH, + BleProtocol.FLAG_SECURITY_AUTH, + magic, + BleProtocol.buildAuthenticationRequest(magic), + ConnectionOptions.SECURITY_AUTH_SOFT_TIMEOUT_MS, + -1, + leftArm, + ) + } + + fun shutdown(exitMode: Int): OutboundMessage { + var magic: Int = magicPool.allocate() + return OutboundMessage( + "shutdown", + ("shutdown mode=" + exitMode), + BleProtocol.SID_EVENHUB, + BleProtocol.FLAG_REQUEST, + magic, + BleProtocol.buildShutdown(magic, exitMode), + ACK_TIMEOUT_MS, + -1, + false, + ) + } + + fun imagePayload( + tile: BleProtocol.ImageTileOptions, + sessionId: Int, + payload: ByteArray, + label: String, + leftArm: Boolean, + ): OutboundMessage { + return imagePayload("sound", tile, sessionId, payload, label, leftArm) + } + + fun imagePayload( + kind: String, + tile: BleProtocol.ImageTileOptions, + sessionId: Int, + payload: ByteArray, + label: String, + leftArm: Boolean, + ): OutboundMessage { + return customMessage(kind, payload, label, -1, leftArm) + } + + fun customMessage( + kind: String, + payload: ByteArray?, + label: String, + tileIndex: Int, + leftArm: Boolean, + ): OutboundMessage { + if (((payload == null) || (payload.size > CfwTransport.MAX_MESSAGE))) { + throw IllegalArgumentException("CFW message exceeds uint16 length") + } + var streamId: Int = magicPool.allocate() + return OutboundMessage( + kind, + label, + CfwTransport.SID, + 0, + streamId, + payload, + CfwMessageWindow.ACK_TIMEOUT_MS, + tileIndex, + leftArm, + ) + } + + fun cfwCleanup( + tile: BleProtocol.ImageTileOptions, + sessionId: Int, + leftArm: Boolean, + ): OutboundMessage { + var payload: ByteArray = byteArrayOf((BleProtocol.CFW_IMAGE_MODE_CLEANUP).toByte()) + return imagePayload("cfw-cleanup", tile, sessionId, payload, "CFW cleanup", leftArm) + } + + fun enableOrDisableMic(enable: Boolean): OutboundMessage { + var magic: Int = magicPool.allocate() + return OutboundMessage( + "audio-control", + (if (enable) "G2 mic enable" else "G2 mic disable"), + BleProtocol.SID_EVENHUB, + BleProtocol.FLAG_REQUEST, + magic, + BleProtocol.buildAudioControl(magic, enable), + ACK_TIMEOUT_MS, + -1, + false, + ) + } + + fun enableOrDisableImu(enable: Boolean, reportFrq: Int): OutboundMessage { + var magic: Int = magicPool.allocate() + return OutboundMessage( + "imu-control", + (if (enable) "IMU enable" else "IMU disable"), + BleProtocol.SID_EVENHUB, + BleProtocol.FLAG_REQUEST, + magic, + BleProtocol.buildImuControl(magic, enable, reportFrq), + ACK_TIMEOUT_MS, + -1, + false, + ) + } + + fun setBrightness(autoAdjust: Boolean, brightnessLevel: Int): OutboundMessage { + var magic: Int = magicPool.allocate() + return OutboundMessage( + "brightness-control", + (if (autoAdjust) "brightness auto" else ("brightness level=" + brightnessLevel)), + BleProtocol.SID_UI_SETTING, + BleProtocol.FLAG_REQUEST, + magic, + BleProtocol.buildSetBrightness(magic, autoAdjust, brightnessLevel), + ACK_TIMEOUT_MS, + -1, + false, + ) + } + + fun setWearDetection(enabled: Boolean): OutboundMessage { + var magic: Int = magicPool.allocate() + return OutboundMessage( + "wear-detection-control", + ("wear detection " + (if (enabled) "enable" else "disable")), + BleProtocol.SID_UI_SETTING, + BleProtocol.FLAG_REQUEST, + magic, + BleProtocol.buildSetWearDetection(magic, enabled), + ACK_TIMEOUT_MS, + -1, + false, + ) + } + + fun createLayout(): OutboundMessage { + var magic: Int = magicPool.allocate() + return OutboundMessage( + "create-layout", + "create-layout", + BleProtocol.SID_EVENHUB, + BleProtocol.FLAG_REQUEST, + magic, + BleProtocol.buildCreateInputPage(magic), + ACK_TIMEOUT_MS, + -1, + false, + ) + } + + fun startupTextProbe(): OutboundMessage { + var magic: Int = magicPool.allocate() + return OutboundMessage( + "startup-text-probe", + "startup text probe", + BleProtocol.SID_EVENHUB, + BleProtocol.FLAG_REQUEST, + magic, + BleProtocol.buildDashboardTextUpgrade(magic), + ACK_TIMEOUT_MS, + -1, + false, + ) + } + + fun heartbeat(): OutboundMessage { + var magic: Int = magicPool.allocate() + return OutboundMessage( + "heartbeat", + "heartbeat", + BleProtocol.SID_EVENHUB, + BleProtocol.FLAG_REQUEST, + magic, + BleProtocol.buildHeartbeat(magic), + HEARTBEAT_TIMEOUT_MS, + -1, + false, + ) + } + + fun batteryQuery(): OutboundMessage { + var magic: Int = magicPool.allocate() + return OutboundMessage( + "battery", + "battery", + BleProtocol.SID_UI_SETTING, + BleProtocol.FLAG_REQUEST, + magic, + BleProtocol.buildSettingsQuery(magic), + ACK_TIMEOUT_MS, + -1, + false, + ) + } + + fun faceclawWakeControl(operation: Int, nonce: Int, leftArm: Boolean): OutboundMessage { + return OutboundMessage( + "wake-lease-control", + (((("wake lease op=" + operation) + " nonce=") + nonce) + + (if (leftArm) " L" else " R")), + BleProtocol.SID_UI_SETTING, + BleProtocol.FLAG_REQUEST, + 0, + BleProtocol.buildFaceclawWakeControl(operation, nonce), + ACK_TIMEOUT_MS, + -1, + leftArm, + ) + } + + fun faceclawFramebufferControl(operation: Int, leftArm: Boolean): OutboundMessage { + return OutboundMessage( + "framebuffer-lease-control", + (("framebuffer lease op=" + operation) + (if (leftArm) " L" else " R")), + BleProtocol.SID_UI_SETTING, + BleProtocol.FLAG_REQUEST, + 0, + BleProtocol.buildFaceclawWakeControl(operation, 0), + ACK_TIMEOUT_MS, + -1, + leftArm, + ) + } + + /** CFW mic_control write (settings field 103) targeted at one temple. */ + fun faceclawMicControl(record: ByteArray, label: String, leftArm: Boolean): OutboundMessage { + return OutboundMessage( + "mic-control", + (("mic control " + label) + (if (leftArm) " L" else " R")), + BleProtocol.SID_UI_SETTING, + BleProtocol.FLAG_REQUEST, + 0, + BleProtocol.buildFaceclawMicControl(record), + ACK_TIMEOUT_MS, + -1, + leftArm, + ) + } + + fun faceclawWearQuery(leftArm: Boolean): OutboundMessage { + return OutboundMessage( + "wear-query-control", + ("wear state query" + (if (leftArm) " L" else " R")), + BleProtocol.SID_UI_SETTING, + BleProtocol.FLAG_REQUEST, + 0, + BleProtocol.buildFaceclawWakeControl(BleProtocol.FACECLAW_WEAR_OP_QUERY, 0), + ACK_TIMEOUT_MS, + -1, + leftArm, + ) + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/MessageReceiver.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/MessageReceiver.kt new file mode 100644 index 00000000..6761dfa8 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/MessageReceiver.kt @@ -0,0 +1,127 @@ +package com.faceclaw.app + +/** Split/coalesced notifications and protobuf fragments, isolated per BLE link and sequence. */ +class MessageReceiver { + class Message( + val sid: Int, + val flag: Int, + val payload: ByteArray, + val command: Int, + val magic: Int, + val packet: ByteArray? = null, + ) + + private class Partial(val total: Int, var seen: Long) { + val chunks = mutableListOf() + var size = 0 + } + + private val lock = protocolPlatform().createLock() + private val streams = mutableMapOf() + private val messages = mutableMapOf() + + fun clear() = lock.withLock { + streams.clear() + messages.clear() + } + + fun receive(link: String, data: ByteArray, now: Long): List = lock.withLock { + messages.entries.removeAll { now - it.value.seen > 5000 } + val stream = (streams[link] ?: ByteArray(0)) + data + val output = mutableListOf() + var offset = 0 + while (stream.size - offset >= 8) { + fun u8(index: Int) = stream[offset + index].toInt() and 255 + if (u8(0) != 0xaa || u8(1) !in intArrayOf(0x21, 0x12)) { + offset++ + continue + } + val length = u8(3) + if (stream.size - offset < length + 8) break + val count = u8(4) + val index = u8(5) + val sid = u8(6) + val flag = u8(7) + val key = "$link:${u8(2)}:$sid:$flag" + val packet = stream.copyOfRange(offset, offset + length + 8) + val chunk = packet.copyOfRange(8, packet.size) + offset += length + 8 + if (sid == CfwTransport.SID) { + output.add(Message(sid, flag, chunk, -1, -1, packet)) + continue + } + if (count == 0 || index == 0 || index > count) { + messages.remove(key) + continue + } + if (index == 1) messages[key] = Partial(count, now) + val partial = messages[key] + if (partial == null || partial.total != count || partial.chunks.size + 1 != index) { + messages.remove(key) + continue + } + partial.chunks.add(chunk) + partial.size += chunk.size + partial.seen = now + if (partial.size > 65536) { + messages.remove(key) + continue + } + if (index != count) continue + messages.remove(key) + val bytes = ByteSink(partial.size) + partial.chunks.forEach { bytes.write(it) } + val complete = bytes.toByteArray() + if (complete.size < 2) continue + val payload = complete.copyOf(complete.size - 2) + val checksum = + (complete[complete.size - 2].toInt() and 255) or + ((complete.last().toInt() and 255) shl 8) + if (CfwTransport.crc(payload) != checksum || !validProtobuf(payload)) continue + output.add( + Message( + sid, + flag, + payload, + BleProtocol.readVarintFieldValue(payload, 1, -1), + BleProtocol.readVarintFieldValue(payload, 2, -1), + ) + ) + } + streams[link] = stream.copyOfRange(offset, stream.size) + output + } + + private fun validProtobuf(data: ByteArray): Boolean { + var offset = 0 + fun varint(): Int? { + var value = 0 + for (i in 0..4) { + if (offset == data.size) return null + val byte = data[offset++].toInt() and 255 + if (i == 4 && byte > 15) return null + value = value or ((byte and 127) shl (i * 7)) + if (byte and 128 == 0) return value + } + return null + } + while (offset < data.size) { + val key = varint() ?: return false + if (key ushr 3 == 0) return false + if (key and 7 == 0) { + varint() ?: return false + continue + } + val length = + when (key and 7) { + 1 -> 8 + 5 -> 4 + 2 -> varint() ?: return false + else -> return false + } + if (length < 0 || length > data.size - offset) return false + offset += length + } + return true + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/OutboundMessage.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/OutboundMessage.kt new file mode 100644 index 00000000..43ee91db --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/OutboundMessage.kt @@ -0,0 +1,68 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmField + +/** Mutable attempt state, owned by the communicator and guarded by its lock. */ +class OutboundMessage( + @JvmField val kind: String?, + @JvmField val label: String?, + @JvmField val sid: Int, + @JvmField val flag: Int, + @JvmField var magic: Int, + message: ByteArray?, + @JvmField val ackTimeoutMs: Int, + @JvmField val tileIndex: Int, + @JvmField val isLeftArmMessage: Boolean, +) { + @JvmField val message: ByteArray = message?.copyOf() ?: ByteArray(0) + @JvmField + val cfwChecksum: Int = if (sid == CfwTransport.SID) CfwTransport.crc(this.message) else 0 + @JvmField var cfwAckLenses = 0 + @JvmField var cfwRetries = 0 + @JvmField var cfwRetryPending = false + @JvmField var imageUpdateId = 0 + @JvmField var imageMessageNumber = 0 + @JvmField var imageMessageCount = 0 + @JvmField var sentAtMs = 0L + @JvmField var writeStartedAtMs = 0L + @JvmField var ackDeadlineAtMs = 0L + @JvmField var ackPayload = ByteArray(0) + @JvmField var onSent: MessageCallback? = null + @JvmField var onAck: MessageCallback? = null + @JvmField var onTimeout: MessageCallback? = null + + /** NACK names this attempt's sequence, even without a decoded size. */ + fun acceptCfwAck(ack: CfwTransport.Ack?): Boolean { + if ( + ack == null || + sid != CfwTransport.SID || + magic != ack.streamId || + ack.messageId != 0 || + (ack.lens != 1 && ack.lens != 2) + ) + return false + if (ack.nack) { + cfwRetryPending = true + return false + } + if (message.size != ack.size || cfwChecksum != ack.checksum) return false + cfwAckLenses = cfwAckLenses or ack.lens + return !cfwRetryPending && cfwAckLenses == CfwTransport.BOTH + } + + /** Replace an attempt atomically under the communicator lock. */ + fun prepareCfwReplay(streamId: Int) { + magic = streamId + cfwRetries++ + cfwAckLenses = 0 + cfwRetryPending = false + ackDeadlineAtMs = 0 + ackPayload = ByteArray(0) + } + + fun setImageUpdatePosition(updateId: Int, messageNumber: Int, messageCount: Int) { + imageUpdateId = updateId + imageMessageNumber = messageNumber + imageMessageCount = messageCount + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/ProtocolPlatform.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/ProtocolPlatform.kt new file mode 100644 index 00000000..ab7691f0 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/ProtocolPlatform.kt @@ -0,0 +1,46 @@ +package com.faceclaw.app + +/** OS services used by the protocol state machines; supplied by their owner. */ +interface ProtocolPlatform { + /** Monotonic milliseconds since boot, including time spent asleep. */ + fun elapsedRealtimeMs(): Long + + fun createLock(): ProtocolLock + + fun createDeflater(): ProtocolDeflater +} + +/** Must be reentrant: transport encoding can reset its history under the lock. */ +interface ProtocolLock { + fun lock() + + fun unlock() +} + +/** Persistent zlib stream. Each write completes a SYNC_FLUSH, not a new stream. */ +interface ProtocolDeflater { + fun reset() + + fun syncFlush(message: ByteArray): ByteArray + + fun close() +} + +internal inline fun ProtocolLock.withLock(action: () -> T): T { + lock() + try { + return action() + } finally { + unlock() + } +} + +enum class GattWriteMode { + WITH_RESPONSE, + WITHOUT_RESPONSE, +} + +/** Keeps message callbacks independent of java.lang.Runnable. */ +fun interface MessageCallback { + fun run() +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/TextureCacheState.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/TextureCacheState.kt new file mode 100644 index 00000000..623ff165 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/TextureCacheState.kt @@ -0,0 +1,191 @@ +package com.faceclaw.app + +/** + * Phone-side model of the CFW's flat 256 KiB texture cache (zlib_glue mode 18). The firmware holds + * only bytes; every structural decision — where font tables and glyph images live, what is + * resident, when to start over — is made here. Layout per font: a 96-entry uint32 offset table + * (chars 32..127) whose entries are written lazily as each glyph is uploaded; glyph images are the + * GlyphAtlas cached bytes ([w][h][4bpp RLE]). + * + * Allocation is a bump pointer with reset-on-full: the realistic working set (a few fonts' tables + * plus ~hundreds of glyphs at tens of bytes each) is far below 256 KiB, so eviction sophistication + * buys nothing. After a reset the firmware cache still holds stale bytes; that is safe because a + * draw only ever references (font table entry, glyph image) pairs uploaded in the current + * generation — stale table entries are never named in a mode-20 string. + * + * Upload entries accumulate as complete [offset u32][len u16][data] records and drain into one or + * more standalone mode-18 payloads, each independently valid, enqueued ahead of the image message + * that references them (the transport is FIFO, so no ack round-trip is needed before use). + * + * Not thread-safe by itself: the communicator calls it under its own lock. + */ +class TextureCacheState { + companion object { + const val CACHE_SIZE: Int = 262144 + + private val FONT_TABLE_BYTES: Int = (96 * 4) + } + + private var allocEnd: Int = 0 + + private val fontTableOffsets: MutableMap = HashMap() + + private val glyphOffsets: MutableMap = HashMap() + + private val imageOffsets: MutableMap = HashMap() + + private val pendingEntries: MutableList = ArrayList() + + private var pendingBytes: Int = 0 + + private var generation: Int = 0 + + /** + * Forget everything: the on-glasses cache is gone (session teardown, lease loss) or no longer + * trustworthy (upload timeout), or we ran out of space. Glyphs and images re-upload lazily on + * next use. + */ + fun reset(): Unit { + allocEnd = 0 + fontTableOffsets.clear() + glyphOffsets.clear() + imageOffsets.clear() + pendingEntries.clear() + pendingBytes = 0 + generation++ + } + + /** Bumped by every reset; lets a planner detect a mid-plan reset. */ + fun generation(): Int { + return generation + } + + /** + * Bytes currently allocated out of CACHE_SIZE, for logging/tuning (a sudden drop in the frame + * log means a reset-on-full re-upload cycle — the signal that the 256 KiB budget is being + * outgrown). + */ + fun usedBytes(): Int { + return allocEnd + } + + /** + * The font's 96-entry table offset in the cache, or -1 when it exists but this glyph can't fit. + */ + fun fontTableOffset(fontId: Int): Int { + var existing: Int? = fontTableOffsets.get(fontId) + return (if ((existing == null)) -1 else existing) + } + + /** + * Ensure a glyph image (and its font table slot) is resident, queuing the mode-18 upload + * entries for anything newly placed. Returns the glyph's image offset, or -1 when the cache is + * full (caller resets and retries) or the encoding is outside the mode-20 table (32..127). + */ + fun ensureGlyph(fontId: Int, encoding: Int, glyph: GlyphAtlas.Glyph?): Int { + if ((((glyph == null) || (encoding < 32)) || (encoding > 127))) { + return -1 + } + var key: Long = (((fontId).toLong() shl 32) or (encoding.toLong() and 0xffffffffL)) + var existing: Int? = glyphOffsets.get(key) + if ((existing != null)) { + return existing + } + var table: Int? = fontTableOffsets.get(fontId) + var need: Int = (glyph.cachedBytes.size + (if ((table == null)) FONT_TABLE_BYTES else 0)) + if (((allocEnd + need) > CACHE_SIZE)) { + return -1 + } + if ((table == null)) { + table = allocEnd + allocEnd += FONT_TABLE_BYTES + fontTableOffsets.put(fontId, table) + } + var offset: Int = allocEnd + allocEnd += glyph.cachedBytes.size + glyphOffsets.put(key, offset) + addEntry(offset, glyph.cachedBytes) + addEntry( + (table + (4 * (encoding - 32))), + byteArrayOf( + (offset).toByte(), + ((offset shr 8)).toByte(), + ((offset shr 16)).toByte(), + ((offset shr 24)).toByte(), + ), + ) + return offset + } + + /** + * Ensure an ImageAtlas entry is resident (mode-19 draws reference it by raw cache offset; no + * table involved). Returns the image offset, or -1 when the cache is full (caller resets and + * retries). + */ + fun ensureImage(imageId: Int, image: ImageAtlas.Entry?): Int { + if ((image == null)) { + return -1 + } + var existing: Int? = imageOffsets.get(imageId) + if ((existing != null)) { + return existing + } + if (((allocEnd + image.cachedBytes.size) > CACHE_SIZE)) { + return -1 + } + var offset: Int = allocEnd + allocEnd += image.cachedBytes.size + imageOffsets.put(imageId, offset) + addEntry(offset, image.cachedBytes) + return offset + } + + private fun addEntry(offset: Int, data: ByteArray): Unit { + var entry: ByteArray = ByteArray((6 + data.size)) + entry[0] = ((offset and 0xff)).toByte() + entry[1] = (((offset shr 8) and 0xff)).toByte() + entry[2] = (((offset shr 16) and 0xff)).toByte() + entry[3] = (((offset shr 24) and 0xff)).toByte() + entry[4] = ((data.size and 0xff)).toByte() + entry[5] = (((data.size shr 8) and 0xff)).toByte() + data.copyInto(entry, 6, 0, 0 + data.size) + pendingEntries.add(entry) + pendingBytes += entry.size + } + + fun hasPendingUploads(): Boolean { + return !pendingEntries.isEmpty() + } + + /** Total queued upload bytes (entry framing included), for logging. */ + fun pendingUploadBytes(): Int { + return pendingBytes + } + + /** + * Drain the queued entries into complete mode-18 payloads ([18][entries]), each at most + * maxPayloadBytes so a payload fits one BLE image message without fragmentation. A single entry + * larger than the cap still gets its own payload (the transport can fragment it). + */ + fun drainUploadPayloads(maxPayloadBytes: Int): MutableList { + var payloads: MutableList = ArrayList() + var current: ByteSink? = null + for (entry in pendingEntries) { + if (((current != null) && ((current.size() + entry.size) > maxPayloadBytes))) { + payloads.add(current.toByteArray()) + current = null + } + if ((current == null)) { + current = ByteSink(minOf(maxPayloadBytes, (4 + entry.size))) + current.write(18) + } + current.write(entry, 0, entry.size) + } + if ((current != null)) { + payloads.add(current.toByteArray()) + } + pendingEntries.clear() + pendingBytes = 0 + return payloads + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/TexturePlanner.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/TexturePlanner.kt new file mode 100644 index 00000000..6effc438 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/TexturePlanner.kt @@ -0,0 +1,987 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmField +import kotlin.jvm.JvmStatic + +/** + * Plans a screen update that ships text and icons as on-glasses cached draws instead of pixels (CFW + * modes 18/19/20; see g2flash/patches/zlib_glue.c and texture_cache.c). + * + * Approach: dirty rects come from comparing the fully composited old and new frames, exactly as the + * plain incremental path does. For each deferred draw (glyph or image) whose pixels intersect a + * sent rect, check that every pixel the on-glasses draw would write lands correct — i.e. the new + * composite's 4bpp value at each in-panel nonzero-source pixel equals what the draw produces (this + * one check subsumes plane occlusion, surface occlusion/clipping, and draw-on-draw overlap). A draw + * that passes and is (or can be made) resident in the texture cache is replayed on-glasses: its + * written pixels are punched to 0 in the delta rect content — which is what makes text and icons + * nearly free to compress — and re-emitted as a mode-20 string or mode-19 image sub-message in the + * same atomic mode-8 batch, so the shadow after apply equals the full composite exactly. Everything + * else stays baked. + * + * Fallback shape: when nothing qualifies, plan() returns null and the caller uses the plain + * single-bbox/multi-rect/full-frame paths unchanged. + */ +class TexturePlanner { + companion object { + /** Cap on mode-20 string sub-messages (mode-8 count is a u8). */ + private const val MAX_GLYPH_RUNS: Int = 180 + + /** + * Soft cap on cached-glyph selection per update, before run grouping. Sized above a + * full-screen 6x12 terminal repaint (~4,240 cells) so dense screens draw everything; the + * run budget is the real bound. + */ + private const val MAX_SELECTED_GLYPHS: Int = 4600 + + /** Cap on mode-19 image sub-messages per update. */ + private const val MAX_IMAGE_DRAWS: Int = 60 + + /** Cap on mode-15 builtin-font string sub-messages per update. */ + private const val MAX_FWTEXT_RUNS: Int = 80 + + /** Mode-18 payload size that fits one BLE image message comfortably. */ + private const val UPLOAD_PAYLOAD_MAX: Int = 3600 + + /** Max x-adjust control bytes between two glyphs before starting a new run. */ + private const val MAX_ADJUST_BYTES: Int = 4 + + /** Options: identity LUT (top 15) + transparent, for mode-19 image draws. */ + private const val IMAGE_DRAW_OPTIONS: Int = 0x1f + + /** + * Plan a cached-draw update. previous is the delta base (the frame the shadow currently + * holds), or null/mismatched for a full-frame keyframe. Returns null when the plain paths + * should run instead (no replayable draws, or identical frames). + */ + @JvmStatic + fun plan( + previous: ByteArray?, + next: ByteArray?, + width: Int, + height: Int, + draws: Array?, + cache: TextureCacheState, + fidStart: Int, + allowMultiRect: Boolean, + maxRects: Int, + ): Result? { + if ( + (((((next == null) || (draws == null)) || (draws.size == 0)) || (width <= 0)) || + (height <= 0)) + ) { + return null + } + var stride: Int = ((width + 1) shr 1) + if ((next.size != (stride * height))) { + return null + } + var planStartedAtMs: Long = protocolPlatform().elapsedRealtimeMs() + var fullFrame: Boolean = ((previous == null) || (previous.size != next.size)) + var rects: MutableList + if (!fullFrame) { + var box: IntArray? = + BleImageOptimizer.computeChangedBox(previous, next, width, height) + if ((box == null)) { + return null + } + if (((box[2] >= width) && (box[3] >= height))) { + fullFrame = true + rects = mutableListOf(intArrayOf(0, 0, width, height)) + } else { + var split: MutableList? = + (if (allowMultiRect) + BleImageOptimizer.computeChangedRects( + previous, + next, + width, + height, + maxRects, + ) + else null) + rects = (if ((split != null)) split else mutableListOf(box)) + } + } else { + rects = mutableListOf(intArrayOf(0, 0, width, height)) + } + var matchStartedAtMs: Long = protocolPlatform().elapsedRealtimeMs() + var selected: MutableList = ArrayList() + var bakedCandidates: Int = 0 + var selectedImages: Int = 0 + var fwSubs: MutableList = ArrayList() + var fwPunches: MutableList = ArrayList() + var fwGlyphCount: Int = 0 + var fwBaked: Int = 0 + for (draw in draws) { + if ((draw.kind != SurfaceCompositor.ScreenDraw.KIND_FWTEXT)) { + continue + } + fwBaked += planFwRun(draw, rects, next, stride, width, height, fwSubs, fwPunches) + } + fwGlyphCount = fwPunches.size + bakedCandidates += fwBaked + for (draw in draws) { + if ((draw.kind == SurfaceCompositor.ScreenDraw.KIND_GLYPH)) { + var atlas: GlyphAtlas.Glyph? = GlyphAtlas.get(draw.fontId, draw.encoding) + if ((atlas == null)) { + continue + } + var gx: Int = (draw.x + atlas.bbxX) + var inkTop: Int = (draw.y + atlas.inkTop) + if (!intersectsAny(rects, gx, inkTop, atlas.width, atlas.inkHeight)) { + continue + } + if ( + ((((((draw.encoding < 32) || (draw.encoding > 127)) || (gx < 0)) || + (draw.y < 0)) || (gx > 0xffff)) || (draw.y > 0xffff)) + ) { + bakedCandidates++ + continue + } + var top: Int = BmpUtil.nibbleForGray(draw.value) + if ( + !glyphMatchesComposite(next, stride, width, height, atlas, gx, draw.y, top) + ) { + bakedCandidates++ + continue + } + if ((selected.size >= MAX_SELECTED_GLYPHS)) { + bakedCandidates++ + continue + } + selected.add(Selected(draw, atlas, null, gx, top)) + } else { + var atlas: ImageAtlas.Entry? = ImageAtlas.get(draw.imageId) + if ((atlas == null)) { + continue + } + if (!intersectsAny(rects, draw.x, draw.y, atlas.width, atlas.height)) { + continue + } + if ( + (((((draw.x < 0) || (draw.y < 0)) || (draw.x > 0xffff)) || + (draw.y > 0xffff)) || (selectedImages >= MAX_IMAGE_DRAWS)) + ) { + bakedCandidates++ + continue + } + if ( + !imageMatchesComposite(next, stride, width, height, atlas, draw.x, draw.y) + ) { + bakedCandidates++ + continue + } + selected.add(Selected(draw, null, atlas, draw.x, 0)) + selectedImages++ + } + } + if ((selected.isEmpty() && fwSubs.isEmpty())) { + return null + } + var cacheStartedAtMs: Long = protocolPlatform().elapsedRealtimeMs() + var drawable: MutableList = + (if (selected.isEmpty()) mutableListOf() else ensureResident(cache, selected)) + bakedCandidates += (selected.size - drawable.size) + var glyphDrawable: MutableList = ArrayList() + var imageDrawable: MutableList = ArrayList() + for (sel in drawable) { + if ((sel.glyphAtlas != null)) { + glyphDrawable.add(sel) + } else { + imageDrawable.add(sel) + } + } + var runs: MutableList = ArrayList() + var drawnGlyphs: MutableList = buildRuns(cache, glyphDrawable, runs) + bakedCandidates += (glyphDrawable.size - drawnGlyphs.size) + var drawn: MutableList = ArrayList(drawnGlyphs) + drawn.addAll(imageDrawable) + if ( + ((drawn.isEmpty() && fwSubs.isEmpty()) || + ((((rects.size + runs.size) + imageDrawable.size) + fwSubs.size) > 255)) + ) { + if (!selected.isEmpty()) { + cache.reset() + } + return null + } + var punchStartedAtMs: Long = protocolPlatform().elapsedRealtimeMs() + var punched: ByteArray = next.copyOf() + for (sel in drawn) { + punch(punched, stride, width, height, sel) + } + for (fw in fwPunches) { + punchFw(punched, stride, width, height, fw) + } + var encodeStartedAtMs: Long = protocolPlatform().elapsedRealtimeMs() + var subs: MutableList = ArrayList() + var fid: Int = fidStart + if (fullFrame) { + subs.add(BleImageOptimizer.maybeCompress(punched, width, height)) + } else { + for (r in rects) { + subs.add( + BleImageOptimizer.encodeMode3Rect( + punched, + stride, + r[0], + r[1], + r[2], + r[3], + fid, + ) + ) + fid = (if ((fid >= 0xfffe)) 1 else (fid + 1)) + } + } + for (sel in imageDrawable) { + subs.add(encodeImageDraw(cache, sel)) + } + subs.addAll(runs) + subs.addAll(fwSubs) + var payload: ByteArray = assembleMode8(subs) + var uploadBytes: Int = cache.pendingUploadBytes() + var uploads: MutableList = cache.drainUploadPayloads(UPLOAD_PAYLOAD_MAX) + var result: Result = + Result( + payload, + uploads, + fid, + rects.size, + drawnGlyphs.size, + runs.size, + imageDrawable.size, + fwGlyphCount, + fwSubs.size, + bakedCandidates, + uploadBytes, + fullFrame, + ) + var doneAtMs: Long = protocolPlatform().elapsedRealtimeMs() + result.rectsMs = ((matchStartedAtMs - planStartedAtMs)).toInt() + result.matchMs = ((cacheStartedAtMs - matchStartedAtMs)).toInt() + result.cacheMs = ((punchStartedAtMs - cacheStartedAtMs)).toInt() + result.punchMs = ((encodeStartedAtMs - punchStartedAtMs)).toInt() + result.encodeMs = ((doneAtMs - encodeStartedAtMs)).toInt() + return result + } + + /** + * Plan one firmware-font run (mode 15): classify every member, and when any correct ink + * member intersects a sent rect, emit sub-messages over the maximal correct stretches. A + * stretch never spans an incorrect member — the sub-message boundary restarts the + * firmware's advance walk at an explicit pen x, so occluded or unknown glyphs simply stay + * baked without disturbing their neighbors' positions. Emitted ink members are queued for + * punching. Returns how many ink members stay baked. + */ + private fun planFwRun( + draw: SurfaceCompositor.ScreenDraw, + rects: MutableList, + next: ByteArray, + stride: Int, + width: Int, + height: Int, + outSubs: MutableList, + outPunches: MutableList, + ): Int { + var n: Int = draw.fwCps!!.size + if ((((n == 0) || (draw.y < 0)) || (draw.y > 0xffff))) { + return countInk(draw) + } + var top: Int = BmpUtil.nibbleForGray(draw.value) + var ok: BooleanArray = BooleanArray(n) + var entries: Array = arrayOfNulls(n) + var relevant: Boolean = false + var baked: Int = 0 + run { + var i: Int = 0 + while ((i < n)) { + if (!draw.fwInk!![i]) { + ok[i] = true + i++ + continue + } + var entry: FwGlyphAtlas.Entry? = FwGlyphAtlas.get(draw.fwCps!![i]) + if ((entry == null)) { + baked++ + i++ + continue + } + var gx: Int = ((draw.x + draw.fwDx!![i]) + entry.ofsX) + var gy: Int = (draw.y + entry.inkTop) + if (!fwGlyphMatchesComposite(next, stride, width, height, entry, gx, gy, top)) { + baked++ + i++ + continue + } + ok[i] = true + entries[i] = entry + if (intersectsAny(rects, gx, gy, entry.boxW, entry.boxH)) { + relevant = true + } + i++ + } + } + if (!relevant) { + return 0 + } + var i: Int = 0 + while (((i < n) && (outSubs.size < MAX_FWTEXT_RUNS))) { + while (((i < n) && !(ok[i] && draw.fwInk!![i]))) { + i++ + } + if ((i >= n)) { + break + } + var startX: Int = (draw.x + draw.fwDx!![i]) + if (((startX < 0) || (startX > 0xffff))) { + baked++ + i++ + continue + } + var j: Int = i + var lastInk: Int = -1 + var bytesToLastInk: Int = 0 + var bytesSoFar: Int = 0 + while (((j < n) && ok[j])) { + var encodedLength: Int = utf8Length(draw.fwCps!![j]) + if (((bytesSoFar + encodedLength) > 255)) { + break + } + bytesSoFar += encodedLength + if (draw.fwInk!![j]) { + lastInk = j + bytesToLastInk = bytesSoFar + } + j++ + } + if ((lastInk < i)) { + baked++ + i++ + continue + } + var sub: ByteArray = ByteArray((7 + bytesToLastInk)) + sub[0] = 15 + sub[1] = ((startX and 0xff)).toByte() + sub[2] = (((startX shr 8) and 0xff)).toByte() + sub[3] = ((draw.y and 0xff)).toByte() + sub[4] = (((draw.y shr 8) and 0xff)).toByte() + sub[5] = ((top or 0x10)).toByte() + sub[6] = (bytesToLastInk).toByte() + var pos: Int = 7 + run { + var k: Int = i + while ((k <= lastInk)) { + var encoded: ByteArray = codePointUtf8(draw.fwCps!![k]) + encoded.copyInto(sub, pos, 0, 0 + encoded.size) + pos += encoded.size + k++ + } + } + outSubs.add(sub) + run { + var k: Int = i + while ((k <= lastInk)) { + if (draw.fwInk!![k]) { + outPunches.add( + FwPunch( + entries[k]!!, + ((draw.x + draw.fwDx!![k]) + entries[k]!!.ofsX), + (draw.y + entries[k]!!.inkTop), + ) + ) + } + k++ + } + } + i = (lastInk + 1) + } + return baked + } + + private fun utf8Length(cp: Int): Int { + if ((cp < 0x80)) { + return 1 + } + if ((cp < 0x800)) { + return 2 + } + if ((cp < 0x10000)) { + return 3 + } + return 4 + } + + private fun countInk(draw: SurfaceCompositor.ScreenDraw): Int { + var count: Int = 0 + for (ink in draw.fwInk!!) { + if (ink) { + count++ + } + } + return count + } + + /** + * Whether every in-panel nonzero pixel of the builtin-font glyph lands correct: the + * composite's 4bpp value must equal the firmware's LUT output src*top/15 (integer division + * — a general LUT check, since these glyphs are anti-aliased). + */ + private fun fwGlyphMatchesComposite( + packed: ByteArray, + stride: Int, + width: Int, + height: Int, + entry: FwGlyphAtlas.Entry, + gx: Int, + gy: Int, + top: Int, + ): Boolean { + run { + var row: Int = 0 + while ((row < entry.boxH)) { + var y: Int = (gy + row) + if (((y < 0) || (y >= height))) { + row++ + continue + } + run { + var col: Int = 0 + while ((col < entry.boxW)) { + var source: Int = entry.nibbleAt(col, row) + if ((source == 0)) { + col++ + continue + } + var x: Int = (gx + col) + if (((x < 0) || (x >= width))) { + col++ + continue + } + if ((nibbleAt(packed, stride, x, y) != ((source * top) / 15))) { + return false + } + col++ + } + } + row++ + } + } + return true + } + + private fun punchFw( + packed: ByteArray, + stride: Int, + width: Int, + height: Int, + fw: FwPunch, + ): Unit { + run { + var row: Int = 0 + while ((row < fw.entry.boxH)) { + var y: Int = (fw.gy + row) + if (((y < 0) || (y >= height))) { + row++ + continue + } + run { + var col: Int = 0 + while ((col < fw.entry.boxW)) { + if ((fw.entry.nibbleAt(col, row) == 0)) { + col++ + continue + } + punchPixel(packed, stride, width, (fw.gx + col), y) + col++ + } + } + row++ + } + } + } + + private fun intersectsAny( + rects: MutableList, + x: Int, + y: Int, + w: Int, + h: Int, + ): Boolean { + if (((w <= 0) || (h <= 0))) { + return false + } + for (r in rects) { + if ( + ((((x < (r[0] + r[2])) && ((x + w) > r[0])) && (y < (r[1] + r[3]))) && + ((y + h) > r[1])) + ) { + return true + } + } + return false + } + + /** + * Whether every in-panel ink pixel of the glyph lands correct in the packed new frame: the + * composite's 4bpp value must equal the firmware's LUT output source*top/15 (integer). For + * 1bpp glyphs (source 15) this is exactly `== top`; AA glyphs get the general check. Ink + * outside the panel is clipped by the firmware and irrelevant. + */ + private fun glyphMatchesComposite( + packed: ByteArray, + stride: Int, + width: Int, + height: Int, + atlas: GlyphAtlas.Glyph, + gx: Int, + lineY: Int, + top: Int, + ): Boolean { + run { + var row: Int = atlas.inkTop + while ((row < (atlas.inkTop + atlas.inkHeight))) { + var y: Int = (lineY + row) + if (((y < 0) || (y >= height))) { + row++ + continue + } + run { + var col: Int = 0 + while ((col < atlas.width)) { + var source: Int = atlas.nibbleAt(col, row) + if ((source == 0)) { + col++ + continue + } + var x: Int = (gx + col) + if (((x < 0) || (x >= width))) { + col++ + continue + } + if ((nibbleAt(packed, stride, x, y) != ((source * top) / 15))) { + return false + } + col++ + } + } + row++ + } + } + return true + } + + /** + * Whether every in-panel nonzero pixel of the cached image equals the packed new frame — + * the mode-19 transparent draw writes exactly those. + */ + private fun imageMatchesComposite( + packed: ByteArray, + stride: Int, + width: Int, + height: Int, + atlas: ImageAtlas.Entry, + left: Int, + top: Int, + ): Boolean { + run { + var row: Int = 0 + while ((row < atlas.height)) { + var y: Int = (top + row) + if (((y < 0) || (y >= height))) { + row++ + continue + } + run { + var col: Int = 0 + while ((col < atlas.width)) { + var source: Int = atlas.nibbleAt(col, row) + if ((source == 0)) { + col++ + continue + } + var x: Int = (left + col) + if (((x < 0) || (x >= width))) { + col++ + continue + } + if ((nibbleAt(packed, stride, x, y) != source)) { + return false + } + col++ + } + } + row++ + } + } + return true + } + + private fun nibbleAt(packed: ByteArray, stride: Int, x: Int, y: Int): Int { + var b: Int = (packed[((y * stride) + (x shr 1))] and 0xff) + return (if (((x and 1) != 0)) (b and 0x0f) else (b shr 4)) + } + + private fun punch( + packed: ByteArray, + stride: Int, + width: Int, + height: Int, + sel: Selected, + ): Unit { + if ((sel.glyphAtlas != null)) { + var atlas: GlyphAtlas.Glyph = sel.glyphAtlas + run { + var row: Int = atlas.inkTop + while ((row < (atlas.inkTop + atlas.inkHeight))) { + var y: Int = (sel.draw.y + row) + if (((y < 0) || (y >= height))) { + row++ + continue + } + run { + var col: Int = 0 + while ((col < atlas.width)) { + if (!atlas.inkAt(col, row)) { + col++ + continue + } + punchPixel(packed, stride, width, (sel.gx + col), y) + col++ + } + } + row++ + } + } + } else { + var atlas: ImageAtlas.Entry = sel.imageAtlas!! + run { + var row: Int = 0 + while ((row < atlas.height)) { + var y: Int = (sel.draw.y + row) + if (((y < 0) || (y >= height))) { + row++ + continue + } + run { + var col: Int = 0 + while ((col < atlas.width)) { + if ((atlas.nibbleAt(col, row) == 0)) { + col++ + continue + } + punchPixel(packed, stride, width, (sel.gx + col), y) + col++ + } + } + row++ + } + } + } + } + + private fun punchPixel(packed: ByteArray, stride: Int, width: Int, x: Int, y: Int): Unit { + if (((x < 0) || (x >= width))) { + return + } + var index: Int = ((y * stride) + (x shr 1)) + if (((x and 1) != 0)) { + packed[index] = ((packed[index] and 0xf0)).toByte() + } else { + packed[index] = ((packed[index] and 0x0f)).toByte() + } + } + + /** + * Ensure residency for all of `selected`, resetting the cache once if the allocator fills + * mid-plan (a reset invalidates offsets handed out earlier in the same pass, so the whole + * pass reruns). Returns the draws that are resident afterwards. + */ + private fun ensureResident( + cache: TextureCacheState, + selected: MutableList, + ): MutableList { + run { + var attempt: Int = 0 + while ((attempt < 2)) { + var resident: MutableList = ArrayList(selected.size) + var full: Boolean = false + for (sel in selected) { + var offset: Int = + (if ((sel.glyphAtlas != null)) + cache.ensureGlyph( + sel.draw.fontId, + sel.draw.encoding, + sel.glyphAtlas, + ) + else cache.ensureImage(sel.draw.imageId, sel.imageAtlas)) + if ((offset >= 0)) { + resident.add(sel) + } else { + full = true + } + } + if ((!full || (attempt == 1))) { + return resident + } + cache.reset() + attempt++ + } + } + return mutableListOf() + } + + /** Mode-19 cached-image draw: [19][offset u32][x u16][y u16][options u8]. */ + @JvmStatic + private fun encodeImageDraw(cache: TextureCacheState, sel: Selected): ByteArray { + var offset: Int = cache.ensureImage(sel.draw.imageId, sel.imageAtlas) + var sub: ByteArray = ByteArray(10) + sub[0] = 19 + sub[1] = ((offset and 0xff)).toByte() + sub[2] = (((offset shr 8) and 0xff)).toByte() + sub[3] = (((offset shr 16) and 0xff)).toByte() + sub[4] = (((offset shr 24) and 0xff)).toByte() + sub[5] = ((sel.draw.x and 0xff)).toByte() + sub[6] = (((sel.draw.x shr 8) and 0xff)).toByte() + sub[7] = ((sel.draw.y and 0xff)).toByte() + sub[8] = (((sel.draw.y shr 8) and 0xff)).toByte() + sub[9] = (IMAGE_DRAW_OPTIONS).toByte() + return sub + } + + /** + * Group selected glyphs into mode-20 string sub-messages: [20][fontTable u32][x u16][y + * u16][options u8][strlen u8][string] One run per (font, line y, top color) span; within a + * run, control bytes 1..31 adjust x by -10..+20 to hit each glyph's exact position, and + * each glyph advances x by its cached width. Order across runs is free: every drawn glyph's + * ink equals the composite, so overlaps write equal values. Returns the glyphs actually + * emitted (run budget can drop stragglers). + */ + @JvmStatic + private fun buildRuns( + cache: TextureCacheState, + drawable: MutableList, + outRuns: MutableList, + ): MutableList { + var sorted: MutableList = ArrayList(drawable) + sorted.sortWith( + compareBy { it.draw.fontId } + .thenBy { it.draw.y } + .thenBy { it.top } + .thenBy { it.gx } + ) + var drawn: MutableList = ArrayList(sorted.size) + var i: Int = 0 + while (((i < sorted.size) && (outRuns.size < MAX_GLYPH_RUNS))) { + var first: Selected = sorted.get(i) + var fontTable: Int = cache.fontTableOffset(first.draw.fontId) + if ((fontTable < 0)) { + i++ + continue + } + var string: ByteSink = ByteSink() + var runGlyphs: MutableList = ArrayList() + var cursor: Int = first.gx + var j: Int = i + while ((j < sorted.size)) { + var sel: Selected = sorted.get(j) + if ( + (((sel.draw.fontId != first.draw.fontId) || (sel.draw.y != first.draw.y)) || + (sel.top != first.top)) + ) { + break + } + var delta: Int = (sel.gx - cursor) + var adjustBytes: Int = adjustByteCount(delta) + if (((adjustBytes > MAX_ADJUST_BYTES) && (j > i))) { + break + } + if ((((string.size() + adjustBytes) + 1) > 255)) { + break + } + emitAdjust(string, delta) + string.write(sel.draw.encoding) + runGlyphs.add(sel) + cursor = (sel.gx + sel.glyphAtlas!!.width) + j++ + } + if (!runGlyphs.isEmpty()) { + var stringBytes: ByteArray = string.toByteArray() + var run: ByteArray = ByteArray((11 + stringBytes.size)) + run[0] = 20 + run[1] = ((fontTable and 0xff)).toByte() + run[2] = (((fontTable shr 8) and 0xff)).toByte() + run[3] = (((fontTable shr 16) and 0xff)).toByte() + run[4] = (((fontTable shr 24) and 0xff)).toByte() + run[5] = ((first.gx and 0xff)).toByte() + run[6] = (((first.gx shr 8) and 0xff)).toByte() + run[7] = ((first.draw.y and 0xff)).toByte() + run[8] = (((first.draw.y shr 8) and 0xff)).toByte() + run[9] = ((first.top or 0x10)).toByte() + run[10] = (stringBytes.size).toByte() + stringBytes.copyInto(run, 11, 0, 0 + stringBytes.size) + outRuns.add(run) + drawn.addAll(runGlyphs) + i = j + } else { + i++ + } + } + return drawn + } + + /** How many 1..31 control bytes are needed to move the cursor by delta. */ + private fun adjustByteCount(delta: Int): Int { + if ((delta == 0)) { + return 0 + } + return (if ((delta > 0)) ((delta + 19) / 20) else ((-delta + 9) / 10)) + } + + private fun emitAdjust(out: ByteSink, delta: Int): Unit { + var delta = delta + while ((delta != 0)) { + var step: Int = (if ((delta > 0)) minOf(delta, 20) else maxOf(delta, -10)) + out.write((step + 11)) + delta -= step + } + } + + /** [8][count]([len u16][sub])* — one atomic present for deltas + draws. */ + private fun assembleMode8(subs: MutableList): ByteArray { + var total: Int = 2 + for (sub in subs) { + total += (2 + sub.size) + } + var out: ByteArray = ByteArray(total) + out[0] = 8 + out[1] = (subs.size).toByte() + var pos: Int = 2 + for (sub in subs) { + out[pos] = ((sub.size and 0xff)).toByte() + out[(pos + 1)] = (((sub.size shr 8) and 0xff)).toByte() + pos += 2 + sub.copyInto(out, pos, 0, 0 + sub.size) + pos += sub.size + } + return out + } + } + + constructor() {} + + class Result { + /** Complete image payload: a mode-8 batch of rect deltas + cached draws. */ + @JvmField val payload: ByteArray + + /** Mode-18 upload payloads to enqueue BEFORE the image message. */ + @JvmField val uploads: MutableList + + /** Next mode-3 frame id (deltas consumed some). */ + @JvmField val nextFid: Int + + @JvmField val rectCount: Int + + @JvmField val drawnGlyphs: Int + + @JvmField val runCount: Int + + @JvmField val drawnImages: Int + + @JvmField val fwGlyphs: Int + + @JvmField val fwRuns: Int + + @JvmField val bakedCandidates: Int + + @JvmField val uploadBytes: Int + + @JvmField val fullFrame: Boolean + + /** + * Where the planning time went, in ms. This runs on the send thread, directly in the + * input-to-display path, so the split is reported in the frame log: rects = finding the + * changed region, match = checking each draw against the composite, cache = + * residency/uploads plus run building, punch = clearing replayed draws out of a copy of the + * frame, encode = compressing the leftover pixels. + */ + @JvmField var rectsMs: Int = 0 + + @JvmField var matchMs: Int = 0 + + @JvmField var cacheMs: Int = 0 + + @JvmField var punchMs: Int = 0 + + @JvmField var encodeMs: Int = 0 + + constructor( + payload: ByteArray, + uploads: MutableList, + nextFid: Int, + rectCount: Int, + drawnGlyphs: Int, + runCount: Int, + drawnImages: Int, + fwGlyphs: Int, + fwRuns: Int, + bakedCandidates: Int, + uploadBytes: Int, + fullFrame: Boolean, + ) { + this.payload = payload + this.uploads = uploads + this.nextFid = nextFid + this.rectCount = rectCount + this.drawnGlyphs = drawnGlyphs + this.runCount = runCount + this.drawnImages = drawnImages + this.fwGlyphs = fwGlyphs + this.fwRuns = fwRuns + this.bakedCandidates = bakedCandidates + this.uploadBytes = uploadBytes + this.fullFrame = fullFrame + } + } + + /** One draw selected for on-glasses replay. */ + private class Selected { + @JvmField val draw: SurfaceCompositor.ScreenDraw + + @JvmField val glyphAtlas: GlyphAtlas.Glyph? + + @JvmField val imageAtlas: ImageAtlas.Entry? + + @JvmField val gx: Int + + @JvmField val top: Int + + constructor( + draw: SurfaceCompositor.ScreenDraw, + glyphAtlas: GlyphAtlas.Glyph?, + imageAtlas: ImageAtlas.Entry?, + gx: Int, + top: Int, + ) { + this.draw = draw + this.glyphAtlas = glyphAtlas + this.imageAtlas = imageAtlas + this.gx = gx + this.top = top + } + } + + /** One punch task for an emitted firmware-font glyph. */ + private class FwPunch { + @JvmField val entry: FwGlyphAtlas.Entry + + @JvmField val gx: Int + + @JvmField val gy: Int + + constructor(entry: FwGlyphAtlas.Entry, gx: Int, gy: Int) { + this.entry = entry + this.gx = gx + this.gy = gy + } + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/FwGlyphAtlas.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/FwGlyphAtlas.kt new file mode 100644 index 00000000..ce972e08 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/FwGlyphAtlas.kt @@ -0,0 +1,89 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmField +import kotlin.jvm.JvmStatic + +/** + * Process-wide registry of the glasses' builtin 20 px font's glyph rasters, fed from the TS side + * (EvenHubFont's extracted firmware font data). Unlike GlyphAtlas/ImageAtlas entries, these are + * never uploaded: the firmware already owns the font, and mode 15 draws it directly. The planner + * needs the rasters purely phone-side — for the "would this draw land correctly" check against the + * composite and for punching drawn ink out of delta rects. + * + * Placement model matches the firmware's mode-15 math: a glyph draws at (penX + ofsX, lineY + + * inkTop) where inkTop already folds in the root font's line height and baseline. The TS side only + * registers glyphs whose on-glasses rendering it predicts exactly (native-table glyphs; baseline- + * shifted fallback symbols stay baked). + */ +class FwGlyphAtlas { + companion object { + private val lock = protocolPlatform().createLock() + + private val entries: MutableMap = HashMap() + + /** + * Register glyph rasters. Little-endian buffer of records: [cp u32][ofsX s16][inkTop + * s16][boxW u8][boxH u8] [boxH x ceil(boxW/2) nibble bytes] Re-registration of a codepoint + * is ignored (the builtin font is fixed). + */ + @JvmStatic + fun register(buffer: ByteReader?): Unit { + if ((buffer == null)) { + return + } + val cursor: ByteReader = buffer + lock.withLock { + while ((cursor.remaining() >= 10)) { + var cp: Int = cursor.getInt() + var ofsX: Int = cursor.getShort().toInt() + var inkTop: Int = cursor.getShort().toInt() + var boxW: Int = (cursor.get() and 0xff) + var boxH: Int = (cursor.get() and 0xff) + var nibbles: ByteArray = ByteArray((((boxW + 1) shr 1) * boxH)) + cursor.get(nibbles) + if ((((boxW > 0) && (boxH > 0)) && !entries.containsKey(cp))) { + entries.put(cp, Entry(ofsX, inkTop, boxW, boxH, nibbles)) + } + } + } + } + + @JvmStatic + fun get(cp: Int): Entry? { + lock.withLock { + return entries.get(cp) + } + } + } + + constructor() {} + + class Entry { + /** Draw x = pen x + ofsX. */ + @JvmField val ofsX: Int + + /** First raster row relative to the run's line-top y. */ + @JvmField val inkTop: Int + + @JvmField val boxW: Int + + @JvmField val boxH: Int + + /** 4bpp rows, stride ceil(boxW/2), high nibble = left pixel. */ + @JvmField val nibbles: ByteArray + + constructor(ofsX: Int, inkTop: Int, boxW: Int, boxH: Int, nibbles: ByteArray) { + this.ofsX = ofsX + this.inkTop = inkTop + this.boxW = boxW + this.boxH = boxH + this.nibbles = nibbles + } + + /** The 4bpp source value at (col, row); the draw skips 0 (transparent). */ + fun nibbleAt(col: Int, row: Int): Int { + var b: Int = (nibbles[((row * ((boxW + 1) shr 1)) + (col shr 1))] and 0xff) + return (if (((col and 1) != 0)) (b and 0x0f) else (b shr 4)) + } + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/GlyphAtlas.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/GlyphAtlas.kt new file mode 100644 index 00000000..97450875 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/GlyphAtlas.kt @@ -0,0 +1,325 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmField +import kotlin.jvm.JvmStatic + +/** + * Process-wide registry of glyph rasters, fed from the TS side so glyph identity survives to the + * BLE encoder (see notes/texture-cache-display-list- design.md). A frame's glyph list references + * entries here by (fontId, encoding); the texture-cache planner uses the raster three ways: + * + * - as the ink mask for the "would this draw land correctly" check against the composited frame, + * - to punch the ink pixels out of the baked delta rect it replaces, + * - pre-encoded as the CFW cached-image bytes ([w][h][4bpp RLE]) uploaded via mode 12 and drawn via + * mode 14 with a top-color LUT. 1bpp (BDF) glyphs store ink at 15 so the LUT maps them to exactly + * the requested level; AA (TTF) glyphs store true coverage nibbles the LUT scales. + * + * Fonts are identified by a stable string key (the embedded font name), NOT a per-JS-context + * counter: worker threads register independently and must agree on ids. Glyph rasters are immutable + * once registered; re-registration of the same (fontId, encoding) is ignored. + * + * Cell model: a cached glyph image is bbxWidth x cellHeight (the font's line height), with the ink + * rows at inkTop — so every glyph of a line is drawn at the same y (the line top), which is what + * lets one mode-14 string carry a whole run. The horizontal bearing (bbxX) is applied phone-side + * when computing the draw x. Vertical padding is nearly free: it RLE-encodes to a couple of tokens. + */ +class GlyphAtlas { + companion object { + private val lock = protocolPlatform().createLock() + + private val fontIds: MutableMap = HashMap() + + private val glyphs: MutableMap = HashMap() + + private var nextFontId: Int = 1 + + /** Stable id for a font key; assigns one on first use. */ + @JvmStatic + fun fontId(key: String): Int { + lock.withLock { + var id: Int? = fontIds.get(key) + if ((id == null)) { + id = nextFontId++ + fontIds.put(key, id) + } + return id + } + } + + @JvmStatic + fun get(fontId: Int, encoding: Int): Glyph? { + lock.withLock { + return glyphs.get(key(fontId, encoding)) + } + } + + private fun key(fontId: Int, encoding: Int): Long { + return (((fontId).toLong() shl 32) or (encoding.toLong() and 0xffffffffL)) + } + + /** + * Register a batch of glyph rasters. Little-endian buffer, a sequence of font groups: + * [keyLen u8][key utf8][cellHeight u8][count u16] each followed by count glyph records: + * [encoding u32][bbxX s8][inkTop u8][width u8][inkHeight u8] [inkHeight x rows u32] (bit + * (ceil(width/8)*8 - 1 - col) = ink) Records for an already-registered (font, encoding) are + * skipped (glyph rasters are immutable for a given font key). Malformed buffers throw: they + * indicate a phone-side marshalling bug, never device state. + */ + @JvmStatic + fun register(buffer: ByteReader?): Unit { + if ((buffer == null)) { + return + } + val cursor: ByteReader = buffer + lock.withLock { + while ((cursor.remaining() > 0)) { + var keyLen: Int = (cursor.get() and 0xff) + var keyBytes: ByteArray = ByteArray(keyLen) + cursor.get(keyBytes) + var fontKey: String = keyBytes.decodeToString() + var cellHeight: Int = (cursor.get() and 0xff) + var count: Int = (cursor.getShort().toInt() and 0xffff) + var idBoxed: Int? = fontIds.get(fontKey) + var id: Int = 0 + if ((idBoxed == null)) { + id = nextFontId++ + fontIds.put(fontKey, id) + } else { + id = idBoxed + } + run { + var g: Int = 0 + while ((g < count)) { + var encoding: Int = cursor.getInt() + val bbxX: Int = cursor.get().toInt() + var inkTop: Int = (cursor.get() and 0xff) + var width: Int = (cursor.get() and 0xff) + var inkHeight: Int = (cursor.get() and 0xff) + val rows: IntArray = IntArray(inkHeight) + run { + var r: Int = 0 + while ((r < inkHeight)) { + rows[r] = cursor.getInt() + r++ + } + } + var k: Long = key(id, encoding) + if ( + (((!glyphs.containsKey(k) && (width > 0)) && (cellHeight > 0)) && + ((inkTop + inkHeight) <= cellHeight)) + ) { + glyphs.put( + k, + Glyph(width, cellHeight, inkTop, inkHeight, bbxX, rows, null), + ) + } + g++ + } + } + } + } + } + + /** + * Register a batch of antialiased (4bpp) glyph rasters, e.g. TTF renders. Same font-group + * framing as register(), but each glyph record carries packed coverage instead of 1bpp + * rows: [encoding u32][bbxX s8][inkTop u8][width u8][inkHeight u8] + * [inkHeight x ceil(width/2) packed bytes, high nibble = left pixel] Nibble values are the + * final 4bpp source levels (the draw-time LUT scales them by the top color). + * Already-registered (font, encoding) records are skipped, as in register(). + */ + @JvmStatic + fun registerAa(buffer: ByteReader?): Unit { + if ((buffer == null)) { + return + } + val cursor: ByteReader = buffer + lock.withLock { + while ((cursor.remaining() > 0)) { + var keyLen: Int = (cursor.get() and 0xff) + var keyBytes: ByteArray = ByteArray(keyLen) + cursor.get(keyBytes) + var fontKey: String = keyBytes.decodeToString() + var cellHeight: Int = (cursor.get() and 0xff) + var count: Int = (cursor.getShort().toInt() and 0xffff) + var idBoxed: Int? = fontIds.get(fontKey) + var id: Int = 0 + if ((idBoxed == null)) { + id = nextFontId++ + fontIds.put(fontKey, id) + } else { + id = idBoxed + } + run { + var g: Int = 0 + while ((g < count)) { + var encoding: Int = cursor.getInt() + val bbxX: Int = cursor.get().toInt() + var inkTop: Int = (cursor.get() and 0xff) + var width: Int = (cursor.get() and 0xff) + var inkHeight: Int = (cursor.get() and 0xff) + var stride: Int = ((width + 1) shr 1) + var coverage: ByteArray = ByteArray((width * inkHeight)) + run { + var r: Int = 0 + while ((r < inkHeight)) { + run { + var b: Int = 0 + while ((b < stride)) { + var packed: Int = (cursor.get() and 0xff) + var col: Int = (b * 2) + coverage[((r * width) + col)] = + ((packed shr 4)).toByte() + if (((col + 1) < width)) { + coverage[(((r * width) + col) + 1)] = + ((packed and 0x0f)).toByte() + } + b++ + } + } + r++ + } + } + var k: Long = key(id, encoding) + if ( + (((!glyphs.containsKey(k) && (width > 0)) && (cellHeight > 0)) && + ((inkTop + inkHeight) <= cellHeight)) + ) { + glyphs.put( + k, + Glyph( + width, + cellHeight, + inkTop, + inkHeight, + bbxX, + null, + coverage, + ), + ) + } + g++ + } + } + } + } + } + } + + constructor() {} + + class Glyph { + /** Cached image width in pixels (the glyph's tight bbox width). */ + @JvmField val width: Int + + /** Cached image height in pixels (the font's line height). */ + @JvmField val cellHeight: Int + + /** First row of ink within the cell. */ + @JvmField val inkTop: Int + + /** Number of ink rows. */ + @JvmField val inkHeight: Int + + /** Horizontal bearing: draw x = pen x + bbxX. */ + @JvmField val bbxX: Int + + /** 1bpp ink rows (inkHeight entries), bit (rowBitWidth-1-col) = ink; null for AA glyphs. */ + @JvmField val rows: IntArray? + + @JvmField val rowBitWidth: Int + + /** AA coverage, width*inkHeight nibble values 0..15; null for 1bpp glyphs. */ + @JvmField val coverage: ByteArray? + + /** CFW cached-image bytes: [w][cellHeight][RLE(w*cellHeight px)]. */ + @JvmField val cachedBytes: ByteArray + + constructor( + width: Int, + cellHeight: Int, + inkTop: Int, + inkHeight: Int, + bbxX: Int, + rows: IntArray?, + coverage: ByteArray?, + ) { + this.width = width + this.cellHeight = cellHeight + this.inkTop = inkTop + this.inkHeight = inkHeight + this.bbxX = bbxX + this.rows = rows + this.coverage = coverage + this.rowBitWidth = (((width + 7) shr 3) shl 3) + this.cachedBytes = encodeCachedImage() + } + + /** + * The cell pixel's 4bpp source value at (col, row), row cell-relative. 1bpp glyphs are + * stored at 15 so the draw-time LUT (source*top/15) maps them to exactly the requested top + * color; AA glyphs carry their true coverage level. + */ + fun nibbleAt(col: Int, row: Int): Int { + if (((col < 0) || (col >= width))) { + return 0 + } + var inkRow: Int = (row - inkTop) + if (((inkRow < 0) || (inkRow >= inkHeight))) { + return 0 + } + if ((coverage != null)) { + return coverage[((inkRow * width) + col)].toInt() + } + return (if ((((rows!![inkRow] ushr ((rowBitWidth - 1) - col)) and 1) != 0)) 15 else 0) + } + + /** Whether the cell pixel at (col, row) has any ink (row is cell-relative). */ + fun inkAt(col: Int, row: Int): Boolean { + return (nibbleAt(col, row) != 0) + } + + /** + * The firmware cached-image encoding: [width][height][RLE tokens] covering exactly + * width*cellHeight pixels (no row padding), each pixel's stored color being its nibbleAt + * value. + */ + private fun encodeCachedImage(): ByteArray { + var total: Int = (width * cellHeight) + var out: ByteArray = ByteArray((2 + total)) + out[0] = (width).toByte() + out[1] = (cellHeight).toByte() + var o: Int = 2 + var i: Int = 0 + while ((i < total)) { + var color: Int = nibbleAt((i % width), (i / width)) + var j: Int = (i + 1) + while (((j < total) && (nibbleAt((j % width), (j / width)) == color))) { + j++ + } + var run: Int = (j - i) + while ((run > 0)) { + var c: Int = minOf(run, 0xffff) + if ((c <= 15)) { + out[o++] = (((c shl 4) or color)).toByte() + } else { + if ((c <= 255)) { + out[o++] = (color).toByte() + out[o++] = (c).toByte() + } else { + out[o++] = (color).toByte() + out[o++] = 0 + out[o++] = ((c and 0xff)).toByte() + out[o++] = ((c shr 8)).toByte() + } + } + run -= c + } + i = j + } + var trimmed: ByteArray = ByteArray(o) + out.copyInto(trimmed, 0, 0, 0 + o) + return trimmed + } + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/ImageAtlas.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/ImageAtlas.kt new file mode 100644 index 00000000..01af3217 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/ImageAtlas.kt @@ -0,0 +1,134 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmField +import kotlin.jvm.JvmStatic + +/** + * Process-wide registry of icon/image rasters for the texture-cache pipeline, the image counterpart + * of GlyphAtlas. Entries are content-addressed: the TS side keys each image by a hash of its + * dimensions and pixels, so the same icon registered from any thread or rendered at any time + * dedupes to one entry, and an icon whose content changes is simply a new entry. + * + * Unlike glyphs (1-bit ink recolored at draw time), images keep their exact 4bpp values: the cached + * bytes quantize the registered 8bpp pixels with the same GRAY_TO_NIBBLE table the composite is + * packed with, and the planner draws them via mode 13 with an identity LUT (top color 15) and the + * transparent bit — the draw writes exactly the nonzero-nibble pixels, which is what the + * eligibility check and hole punching are defined over. + */ +class ImageAtlas { + companion object { + private val lock = protocolPlatform().createLock() + + private val ids: MutableMap = HashMap() + + private val entries: MutableList = ArrayList() + + /** + * Register an image (8bpp grayscale pixels, width*height bytes, row-major) under a content + * key, returning its id — or the existing id when the key is already registered (the pixels + * are then ignored: same key means same content). Ids are positive and stable for the + * process lifetime. + */ + @JvmStatic + fun ensure(key: String?, width: Int, height: Int, pixels8bpp: ByteReader?): Int { + if ( + (((((((key == null) || (width <= 0)) || (width > 255)) || (height <= 0)) || + (height > 255)) || (pixels8bpp == null)) || + (pixels8bpp.remaining() < (width * height))) + ) { + throw IllegalArgumentException( + ((("bad image registration " + width) + "x") + height) + ) + } + lock.withLock { + var existing: Int? = ids.get(key) + if ((existing != null)) { + return existing + } + var nibbles: ByteArray = ByteArray((width * height)) + run { + var i: Int = 0 + while ((i < nibbles.size)) { + nibbles[i] = (BmpUtil.nibbleForGray((pixels8bpp.get(i) and 0xff))).toByte() + i++ + } + } + entries.add(Entry(width, height, nibbles)) + var id: Int = entries.size + ids.put(key, id) + return id + } + } + + @JvmStatic + fun get(id: Int): Entry? { + lock.withLock { + return (if (((id >= 1) && (id <= entries.size))) entries.get((id - 1)) else null) + } + } + } + + constructor() {} + + class Entry { + @JvmField val width: Int + + @JvmField val height: Int + + /** One 4bpp value per pixel, row-major. */ + @JvmField val nibbles: ByteArray + + /** CFW cached-image bytes: [w][h][RLE(w*h pixels)]. */ + @JvmField val cachedBytes: ByteArray + + constructor(width: Int, height: Int, nibbles: ByteArray) { + this.width = width + this.height = height + this.nibbles = nibbles + this.cachedBytes = encodeCachedImage() + } + + /** The 4bpp value the mode-13 draw would write at (col, row); 0 = skipped. */ + fun nibbleAt(col: Int, row: Int): Int { + return (nibbles[((row * width) + col)] and 0xff) + } + + private fun encodeCachedImage(): ByteArray { + var total: Int = (width * height) + var out: ByteArray = ByteArray((2 + total)) + out[0] = (width).toByte() + out[1] = (height).toByte() + var o: Int = 2 + var i: Int = 0 + while ((i < total)) { + var color: Int = (nibbles[i] and 0xff) + var j: Int = (i + 1) + while (((j < total) && ((nibbles[j] and 0xff) == color))) { + j++ + } + var run: Int = (j - i) + while ((run > 0)) { + var c: Int = minOf(run, 0xffff) + if ((c <= 15)) { + out[o++] = (((c shl 4) or color)).toByte() + } else { + if ((c <= 255)) { + out[o++] = (color).toByte() + out[o++] = (c).toByte() + } else { + out[o++] = (color).toByte() + out[o++] = 0 + out[o++] = ((c and 0xff)).toByte() + out[o++] = ((c shr 8)).toByte() + } + } + run -= c + } + i = j + } + var trimmed: ByteArray = ByteArray(o) + out.copyInto(trimmed, 0, 0, 0 + o) + return trimmed + } + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/LvglFontFile.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/LvglFontFile.kt new file mode 100644 index 00000000..cffb1817 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/LvglFontFile.kt @@ -0,0 +1,250 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmField +import kotlin.jvm.JvmStatic + +/** + * Reader for the serialized LVGL font image in the G2's CJK flash partition. Faceclaw bundles that + * font because it is Source Han Sans SC Light under the SIL OFL. Proprietary fonts embedded in the + * main firmware never pass through this class and are instead extracted on the user's phone during + * CFW install. + */ +class LvglFontFile { + companion object { + private val lock = protocolPlatform().createLock() + + private fun load(path: String?): FontData? = lock.withLock { + if (path.isNullOrEmpty()) return null + val cached = fontCache.remove(path) + if (cached != null) { + fontCache[path] = cached + return cached + } + try { + val font = FontData(readFileData(path)) + fontCache[path] = font + while (fontCache.size > FONT_CACHE_SIZE) fontCache.remove(fontCache.keys.first()) + font + } catch (_: Exception) { + null + } + } + + private const val TAG: String = "LvglFontFile" + + private const val MAPPED_BASE: Int = -2146435072 + + private const val FONT_CACHE_SIZE: Int = 2 + + private val fontCache: MutableMap = LinkedHashMap() + + /** + * Returns [lineHeight, baseline] or an empty array when the font is invalid. The baseline + * is measured down from the top of the line. + */ + @JvmStatic + fun getMetrics(path: String): ByteArray { + var font: FontData? = load(path) + if ((font == null)) { + return ByteArray(0) + } + return byteArrayOf((font.lineHeight).toByte(), (font.baseline).toByte()) + } + + /** + * Returns one packed glyph: u16 boxW, u16 boxH, i16 ofsX, i16 ofsY, then aligned 4bpp + * bitmap bytes. Returns an empty array when the code point is not mapped. + */ + @JvmStatic + fun getGlyph(path: String, codePoint: Int): ByteArray { + var font: FontData? = load(path) + if ((font == null)) { + return ByteArray(0) + } + var glyphId: Int? = font.codePointToGlyph.get(codePoint) + if (((glyphId == null) || (glyphId <= 0))) { + return ByteArray(0) + } + try { + var descriptor: Int = (font.glyphDescriptors + (glyphId * 16)) + var bitmapIndex: Int = font.u32(descriptor) + var boxWidth: Int = font.u16((descriptor + 8)) + var boxHeight: Int = font.u16((descriptor + 10)) + var offsetX: Int = font.i16((descriptor + 12)) + var offsetY: Int = font.i16((descriptor + 14)) + var stride: Int = ((boxWidth / 2) + 1) + var bitmapLength: Int = + (if (((boxWidth > 0) && (boxHeight > 0))) (stride * boxHeight) else 0) + font.check((font.glyphBitmaps + bitmapIndex), bitmapLength) + var result: ByteArray = ByteArray((8 + bitmapLength)) + putU16(result, 0, boxWidth) + putU16(result, 2, boxHeight) + putU16(result, 4, offsetX) + putU16(result, 6, offsetY) + font.bytes.copyInto( + result, + 8, + (font.glyphBitmaps + bitmapIndex), + (font.glyphBitmaps + bitmapIndex) + bitmapLength, + ) + return result + } catch (e: RuntimeException) { + + return ByteArray(0) + } + } + + private fun putU16(destination: ByteArray, offset: Int, value: Int): Unit { + destination[offset] = ((value and 0xff)).toByte() + destination[(offset + 1)] = (((value ushr 8) and 0xff)).toByte() + } + } + + constructor() {} + + private class FontData { + @JvmField val bytes: ByteArray + + @JvmField val lineHeight: Int + + @JvmField val baseline: Int + + @JvmField val glyphBitmaps: Int + + @JvmField val glyphDescriptors: Int + + @JvmField val codePointToGlyph: MutableMap + + constructor(bytes: ByteArray) { + this.bytes = bytes + if ( + (((((bytes.size < 0x40) || (bytes[0].toInt() != 90)) || (bytes[1].toInt() != 90)) || + (bytes[2].toInt() != 90)) || (bytes[3].toInt() != 90)) + ) { + throw IllegalArgumentException("missing ZZZZ font header") + } + lineHeight = u16(0x38) + var baseLine: Int = u16(0x3a) + baseline = (lineHeight - baseLine) + var descriptor: Int = pointerOffset(u32(0x34)) + glyphBitmaps = pointerOffset(u32(descriptor)) + glyphDescriptors = pointerOffset(u32((descriptor + 4))) + var cmaps: Int = pointerOffset(u32((descriptor + 8))) + var packed: Int = u16((descriptor + 18)) + var cmapCount: Int = (packed and 0x1ff) + var bitsPerPixel: Int = ((packed ushr 9) and 0xf) + var bitmapFormat: Int = ((packed ushr 14) and 0x3) + if ( + (((((lineHeight <= 0) || (baseline < 0)) || (cmapCount <= 0)) || + (bitsPerPixel != 4)) || (bitmapFormat != 3)) + ) { + throw IllegalArgumentException("unsupported LVGL font metadata") + } + codePointToGlyph = HashMap() + run { + var index: Int = 0 + while ((index < cmapCount)) { + readCmap((cmaps + (index * 20))) + index++ + } + } + } + + fun readCmap(address: Int): Unit { + var rangeStart: Int = u32(address) + var rangeLength: Int = u16((address + 4)) + var glyphIdStart: Int = u16((address + 6)) + var unicodeListPointer: Int = u32((address + 8)) + var glyphIdOffsetsPointer: Int = u32((address + 12)) + var listLength: Int = u16((address + 16)) + var type: Int = u8((address + 18)) + if ((type == 2)) { + run { + var relative: Int = 0 + while ((relative < rangeLength)) { + codePointToGlyph.put((rangeStart + relative), (glyphIdStart + relative)) + relative++ + } + } + return + } + if ((type == 0)) { + var offsets: Int = pointerOffset(glyphIdOffsetsPointer) + run { + var relative: Int = 0 + while ((relative < rangeLength)) { + var offset: Int = u8((offsets + relative)) + if (((relative != 0) && (offset == 0))) { + relative++ + continue + } + codePointToGlyph.put((rangeStart + relative), (glyphIdStart + offset)) + relative++ + } + } + return + } + if (((type == 3) || (type == 1))) { + var unicodeList: Int = pointerOffset(unicodeListPointer) + var offsets: Int = + (if ((glyphIdOffsetsPointer == 0)) -1 else pointerOffset(glyphIdOffsetsPointer)) + run { + var index: Int = 0 + while ((index < listLength)) { + var relative: Int = u16((unicodeList + (index * 2))) + var offset: Int = index + if ((offsets >= 0)) { + offset = + (if ((type == 1)) u16((offsets + (index * 2))) + else u8((offsets + index))) + if (((index != 0) && (offset == 0))) { + index++ + continue + } + } + codePointToGlyph.put((rangeStart + relative), (glyphIdStart + offset)) + index++ + } + } + return + } + throw IllegalArgumentException(("unknown cmap type " + type)) + } + + fun u8(offset: Int): Int { + check(offset, 1) + return (bytes[offset] and 0xff) + } + + fun u16(offset: Int): Int { + check(offset, 2) + return ((bytes[offset].toInt() and 255) or ((bytes[offset + 1].toInt() and 255) shl 8)) + } + + fun i16(offset: Int): Int { + check(offset, 2) + return u16(offset).toShort().toInt() + } + + fun u32(offset: Int): Int { + check(offset, 4) + return u16(offset) or (u16(offset + 2) shl 16) + } + + fun pointerOffset(pointer: Int): Int { + var unsignedPointer: Long = (pointer.toLong() and 0xffffffffL) + var offset: Long = (unsignedPointer - (MAPPED_BASE.toLong() and 0xffffffffL)) + if (((offset < 0) || (offset > Int.MAX_VALUE))) { + throw IllegalArgumentException("font pointer is outside the mapped partition") + } + check((offset).toInt(), 1) + return (offset).toInt() + } + + fun check(offset: Int, length: Int): Unit { + if ((((offset < 0) || (length < 0)) || (((offset).toLong() + length) > bytes.size))) { + throw IllegalArgumentException("font range is out of bounds") + } + } + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/SharedGifScreenRecorder.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/SharedGifScreenRecorder.kt new file mode 100644 index 00000000..c47d8d84 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/SharedGifScreenRecorder.kt @@ -0,0 +1,270 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmField +import kotlin.math.roundToLong + +/** + * Accumulates composited screen frames and saves them as a looping animated GIF with a 16-entry + * grayscale palette. Stored frames are deflate-compressed (a typical UI frame shrinks from 166KB of + * indices to a few KB) so long recordings stay affordable in memory; consecutive identical frames + * are deduplicated, with the elapsed time folded into the next frame's delay. + */ +class SharedGifScreenRecorder { + private val lock = protocolPlatform().createLock() + + fun encode(): ByteArray = lock.withLock { + if (frames.isEmpty()) return ByteArray(0) + val out = ByteSink() + writeGif(out) + out.toByteArray() + } + + companion object { + /** Backstop against unbounded growth if a recording is left running. */ + private const val MAX_FRAMES: Int = 3600 + + /** Displayed duration of the final frame, which has no successor. */ + private const val LAST_FRAME_DELAY_CS: Int = 100 + + /** Below this, GIF renderers historically clamp or ignore the delay. */ + private const val MIN_FRAME_DELAY_CS: Int = 2 + + /** GIF LZW compression of a 4-bit index stream (minimum code size 4). */ + private fun writeLzwImageData(out: ByteSink, indices: ByteArray): Unit { + val minCodeSize: Int = 4 + out.write(minCodeSize) + var writer: SubBlockBitWriter = SubBlockBitWriter(out) + val clearCode: Int = (1 shl minCodeSize) + val eoiCode: Int = (clearCode + 1) + var codeSize: Int = (minCodeSize + 1) + var nextCode: Int = (eoiCode + 1) + var table: HashMap = HashMap() + writer.writeCode(clearCode, codeSize) + var prefix: Int = (indices[0] and 0xff) + run { + var i: Int = 1 + while ((i < indices.size)) { + var k: Int = (indices[i] and 0xff) + var key: Int = ((prefix shl 8) or k) + var code: Int? = table.get(key) + if ((code != null)) { + prefix = code + i++ + continue + } + writer.writeCode(prefix, codeSize) + if ((nextCode == 0x1000)) { + writer.writeCode(clearCode, codeSize) + table.clear() + codeSize = (minCodeSize + 1) + nextCode = (eoiCode + 1) + } else { + if ((nextCode >= (1 shl codeSize))) { + codeSize++ + } + table.put(key, nextCode++) + } + prefix = k + i++ + } + } + writer.writeCode(prefix, codeSize) + writer.writeCode(eoiCode, codeSize) + writer.finish() + } + + private fun writeShortLE(out: ByteSink, value: Int): Unit { + out.write((value and 0xff)) + out.write(((value ushr 8) and 0xff)) + } + } + + private class Frame { + @JvmField val deflatedIndices: ByteArray + + @JvmField val timestampMs: Long + + constructor(deflatedIndices: ByteArray, timestampMs: Long) { + this.deflatedIndices = deflatedIndices + this.timestampMs = timestampMs + } + } + + private val frames: MutableList = ArrayList() + + /** Undeflated copy of the newest frame, kept for duplicate detection. */ + private var lastIndices: ByteArray? = null + + private var width: Int = 0 + + private var height: Int = 0 + + private var overflowed: Boolean = false + + /** + * Append the current screen. gray is 8bpp; only the top nibble (the display's native depth, and + * the palette index) is kept. + */ + fun addFrame(gray: ByteArray?, width: Int, height: Int, timestampMs: Long): Unit { + lock.withLock { + if ( + ((((gray == null) || (width <= 0)) || (height <= 0)) || + (gray.size < (width * height))) + ) { + return + } + if (frames.isEmpty()) { + this.width = width + this.height = height + } else { + if (((width != this.width) || (height != this.height))) { + return + } + } + var indices: ByteArray = ByteArray((width * height)) + run { + var i: Int = 0 + while ((i < indices.size)) { + indices[i] = (((gray[i] and 0xff) ushr 4)).toByte() + i++ + } + } + if (((lastIndices != null) && indices.contentEquals(lastIndices))) { + return + } + if ((frames.size >= MAX_FRAMES)) { + overflowed = true + return + } + frames.add(Frame(deflateData(indices), timestampMs)) + lastIndices = indices + } + } + + /** True if frames were dropped because the recording hit MAX_FRAMES. */ + fun isOverflowed(): Boolean { + lock.withLock { + return overflowed + } + } + + private fun writeGif(out: ByteSink): Unit { + out.write('G') + out.write('I') + out.write('F') + out.write('8') + out.write('9') + out.write('a') + writeShortLE(out, width) + writeShortLE(out, height) + out.write(((0x80 or 0x70) or 0x03)) + out.write(0) + out.write(0) + run { + var i: Int = 0 + while ((i < 16)) { + var v: Int = (i * 17) + out.write(v) + out.write(v) + out.write(v) + i++ + } + } + out.write(0x21) + out.write(0xff) + out.write(11) + out.write("NETSCAPE2.0".encodeToByteArray()) + out.write(3) + out.write(1) + writeShortLE(out, 0) + out.write(0) + run { + var i: Int = 0 + while ((i < frames.size)) { + val frame: Frame = frames.get(i) + var delayCs: Int = LAST_FRAME_DELAY_CS + if (((i + 1) < frames.size)) { + var deltaMs: Long = (frames.get((i + 1)).timestampMs - frame.timestampMs) + delayCs = + (maxOf( + MIN_FRAME_DELAY_CS.toLong(), + minOf(0xffffL, (deltaMs / 10.0).roundToLong()), + )) + .toInt() + } + out.write(0x21) + out.write(0xf9) + out.write(4) + out.write(0x04) + writeShortLE(out, delayCs) + out.write(0) + out.write(0) + out.write(0x2c) + writeShortLE(out, 0) + writeShortLE(out, 0) + writeShortLE(out, width) + writeShortLE(out, height) + out.write(0) + writeLzwImageData(out, inflateData(frame.deflatedIndices, (width * height))) + i++ + } + } + out.write(0x3b) + } + + /** + * Packs LZW codes LSB-first into bytes and the bytes into the 255-byte data sub-blocks GIF + * image data is carried in. + */ + private class SubBlockBitWriter { + private val out: ByteSink + + private val block: ByteArray = ByteArray(255) + + private var blockLength: Int = 0 + + private var bitBuffer: Int = 0 + + private var bitCount: Int = 0 + + constructor(out: ByteSink) { + this.out = out + } + + fun writeCode(code: Int, codeSize: Int): Unit { + bitBuffer = (bitBuffer or (code shl bitCount)) + bitCount += codeSize + while ((bitCount >= 8)) { + writeByte((bitBuffer and 0xff)) + bitBuffer = (bitBuffer ushr 8) + bitCount -= 8 + } + } + + fun finish(): Unit { + if ((bitCount > 0)) { + writeByte((bitBuffer and 0xff)) + bitBuffer = 0 + bitCount = 0 + } + flushBlock() + out.write(0) + } + + private fun writeByte(b: Int): Unit { + block[blockLength++] = (b).toByte() + if ((blockLength == 255)) { + flushBlock() + } + } + + private fun flushBlock(): Unit { + if ((blockLength == 0)) { + return + } + out.write(blockLength) + out.write(block, 0, blockLength) + blockLength = 0 + } + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/SharedScreenshots.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/SharedScreenshots.kt new file mode 100644 index 00000000..b0043485 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/SharedScreenshots.kt @@ -0,0 +1,55 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmStatic + +/** Screen export codecs; filesystem destinations belong to platform adapters. */ +class SharedScreenshots private constructor() { + companion object { + @JvmStatic + fun encode4BitGrayPng(gray: ByteArray, width: Int, height: Int): ByteArray { + require(width > 0 && height > 0 && gray.size >= width * height) + val rowBytes = (width + 1) / 2 + val raw = ByteArray(height * (1 + rowBytes)) + var offset = 0 + for (y in 0 until height) { + raw[offset++] = 0 // PNG filter: None + for (x in 0 until width step 2) { + val hi = (gray[y * width + x].toInt() and 255) ushr 4 + val lo = + if (x + 1 < width) (gray[y * width + x + 1].toInt() and 255) ushr 4 else 0 + raw[offset++] = ((hi shl 4) or lo).toByte() + } + } + val out = ByteSink() + out.write(byteArrayOf(0x89.toByte(), 80, 78, 71, 13, 10, 26, 10)) + val header = ByteSink() + writeInt(header, width) + writeInt(header, height) + header.write(byteArrayOf(4, 0, 0, 0, 0)) + writeChunk(out, "IHDR", header.toByteArray()) + writeChunk(out, "IDAT", deflateData(raw)) + writeChunk(out, "IEND", ByteArray(0)) + return out.toByteArray() + } + + private fun writeChunk(out: ByteSink, type: String, data: ByteArray) { + writeInt(out, data.size) + val name = type.encodeToByteArray() + out.write(name) + out.write(data) + var crc = -1 + for (bytes in arrayOf(name, data)) for (byte in bytes) { + crc = crc xor (byte.toInt() and 255) + repeat(8) { crc = (crc ushr 1) xor (if (crc and 1 != 0) 0xedb88320.toInt() else 0) } + } + writeInt(out, crc.inv()) + } + + private fun writeInt(out: ByteSink, value: Int) { + out.write(value ushr 24) + out.write(value ushr 16) + out.write(value ushr 8) + out.write(value) + } + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/SurfaceCompositor.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/SurfaceCompositor.kt new file mode 100644 index 00000000..78c59e86 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/graphics/SurfaceCompositor.kt @@ -0,0 +1,702 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmField +import kotlin.jvm.JvmStatic + +/** + * Retained-surface compositor: the phone-side model of what is on the glasses screen. + * + * Each surface is an 8bpp grayscale buffer retained at its last-submitted contents, positioned on + * the screen with a z-order and a transparency mode. Sources on the TS side (today the dashboard; + * later the shell and per-app worker threads) submit updates to their surface, and the compositor + * recombines the retained surfaces into a full-screen frame that feeds the existing + * dedupe/compress/transmit pipeline. Because every surface is retained, a full screen frame can be + * regenerated at any time (frame drops, reconnects, previews, screenshots) without asking sources + * to repaint. + * + * Surface format contract (mirrored by the TS side): + * - Pixels are 8bpp grayscale, row-major, one byte per pixel. The wire pipeline quantizes to 4bpp + * downstream, so the low nibble is not visible. + * - TRANSPARENCY_COLOR_KEY surfaces treat pixel value 0 as fully transparent and value 1 as black. + * Quantization collapses 1 into the same 4bpp level as 0, so reserving 0 costs no visible shade; + * painters of color-key surfaces must clamp intentional black to 1. + * - An update may cover any rect of its surface; the rest is retained. The update buffer holds + * exactly rectWidth*rectHeight bytes, row-major. + * - Surfaces composite in ascending z-order onto a black (0) background. + * - Surface geometry changes take effect when the next frame composites; they do not trigger a + * recomposite by themselves. + * + * Thread safety: all methods are safe to call from any thread. Apply and composite happen + * atomically under an internal lock, and each composite carries a monotonic sequence number so + * callers can detect when a composite was superseded by a concurrent one before being acted on. + */ +class SurfaceCompositor { + companion object { + const val TRANSPARENCY_OPAQUE: Int = 0 + + const val TRANSPARENCY_COLOR_KEY: Int = 1 + + private val NO_DRAWS: Array = emptyArray() + + private fun dimValue(value: Int, dim: Int): Int { + return maxOf(1, (((value * dim) + 128) shr 8)) + } + + private fun parseDraws(draws: ByteReader?): Array { + if (((draws == null) || (draws.remaining() < 1))) { + return NO_DRAWS + } + val cursor: ByteReader = draws + var out: MutableList = ArrayList() + while ((cursor.remaining() >= 1)) { + var kind: Int = (cursor.get() and 0xff) + if (((kind == ScreenDraw.KIND_GLYPH) && (cursor.remaining() >= 11))) { + var fontId: Int = (cursor.getShort().toInt() and 0xffff) + var encoding: Int = cursor.getInt() + var penX: Int = cursor.getShort().toInt() + var lineY: Int = cursor.getShort().toInt() + var value: Int = (cursor.get() and 0xff) + out.add(ScreenDraw.glyph(fontId, encoding, penX, lineY, value)) + } else { + if (((kind == ScreenDraw.KIND_IMAGE) && (cursor.remaining() >= 8))) { + var imageId: Int = cursor.getInt() + var x: Int = cursor.getShort().toInt() + var y: Int = cursor.getShort().toInt() + out.add(ScreenDraw.image(imageId, x, y)) + } else { + if (((kind == ScreenDraw.KIND_FWTEXT) && (cursor.remaining() >= 6))) { + var x: Int = cursor.getShort().toInt() + var y: Int = cursor.getShort().toInt() + var value: Int = (cursor.get() and 0xff) + var count: Int = (cursor.get() and 0xff) + if ((cursor.remaining() < (count * 7))) { + break + } + var cps: IntArray = IntArray(count) + var dx: IntArray = IntArray(count) + var ink: BooleanArray = BooleanArray(count) + run { + var i: Int = 0 + while ((i < count)) { + cps[i] = cursor.getInt() + dx[i] = cursor.getShort().toInt() + ink[i] = (cursor.get().toInt() != 0) + i++ + } + } + out.add(ScreenDraw.fwText(x, y, value, cps, dx, ink)) + } else { + break + } + } + } + } + return out.toTypedArray() + } + } + + /** + * One deferred draw (a text glyph or an icon image) within a frame, in screen coordinates. The + * draw's pixels are already baked into the composited gray buffer (the TS side bakes before + * submitting); this record preserves the draw's identity so the texture-cache planner can + * replay it as an on-glasses cached draw instead of image bytes. + * + * Glyphs: x/y are the pen position and line top; the raster (and its bearing/cell placement) + * comes from GlyphAtlas under (fontId, encoding). Images: x/y are the blit's top-left; the + * raster comes from ImageAtlas under imageId. + */ + class ScreenDraw { + companion object { + const val KIND_GLYPH: Int = 0 + + const val KIND_IMAGE: Int = 1 + + /** A firmware-builtin-font text run (CFW mode 15). */ + const val KIND_FWTEXT: Int = 2 + + @JvmStatic + fun glyph(fontId: Int, encoding: Int, penX: Int, lineY: Int, value: Int): ScreenDraw { + return ScreenDraw( + KIND_GLYPH, + fontId, + encoding, + 0, + penX, + lineY, + value, + null, + null, + null, + ) + } + + @JvmStatic + fun image(imageId: Int, x: Int, y: Int): ScreenDraw { + return ScreenDraw(KIND_IMAGE, 0, 0, imageId, x, y, 0, null, null, null) + } + + @JvmStatic + fun fwText( + x: Int, + y: Int, + value: Int, + cps: IntArray, + dx: IntArray, + ink: BooleanArray, + ): ScreenDraw { + return ScreenDraw(KIND_FWTEXT, 0, 0, 0, x, y, value, cps, dx, ink) + } + } + + @JvmField val kind: Int + + /** Glyph draws only. */ + @JvmField val fontId: Int + + /** Glyph draws only. */ + @JvmField val encoding: Int + + /** Image draws only. */ + @JvmField val imageId: Int + + @JvmField val x: Int + + @JvmField val y: Int + + /** Glyph and fw-text draws: 8-bit brightness. */ + @JvmField val value: Int + + /** Fw-text runs only: member codepoints, in text order. */ + @JvmField val fwCps: IntArray? + + /** Fw-text runs only: member pen offsets relative to x. */ + @JvmField val fwDx: IntArray? + + /** Fw-text runs only: whether each member has visible pixels. */ + @JvmField val fwInk: BooleanArray? + + constructor( + kind: Int, + fontId: Int, + encoding: Int, + imageId: Int, + x: Int, + y: Int, + value: Int, + fwCps: IntArray?, + fwDx: IntArray?, + fwInk: BooleanArray?, + ) { + this.kind = kind + this.fontId = fontId + this.encoding = encoding + this.imageId = imageId + this.x = x + this.y = y + this.value = value + this.fwCps = fwCps + this.fwDx = fwDx + this.fwInk = fwInk + } + } + + /** One composited full-screen frame plus the metadata the pipeline needs. */ + class Composite { + /** Full-screen 8bpp grayscale pixels, screenWidth*screenHeight bytes. */ + @JvmField val gray: ByteArray + + @JvmField val width: Int + + @JvmField val height: Int + + /** + * Stable identifier of screen content, combining every surface's geometry and content + * fingerprint; equal fingerprints mean equal composited pixels. + */ + @JvmField val fingerprint: String + + /** Monotonic: a Composite with a higher seq contains strictly newer state. */ + @JvmField val seq: Long + + /** + * Screen-space deferred draws of every visible surface, in composite order (surface z + * ascending, then each surface's draw order). Their pixels are already baked into gray. + */ + @JvmField val draws: Array? + + constructor( + gray: ByteArray, + width: Int, + height: Int, + fingerprint: String, + seq: Long, + draws: Array?, + ) { + this.gray = gray + this.width = width + this.height = height + this.fingerprint = fingerprint + this.seq = seq + this.draws = (if ((draws == null)) NO_DRAWS else draws) + } + } + + private class Surface { + @JvmField val id: String + + @JvmField var x: Int = 0 + + @JvmField var y: Int = 0 + + @JvmField var width: Int = 0 + + @JvmField var height: Int = 0 + + @JvmField var zOrder: Int = 0 + + @JvmField var transparency: Int = 0 + + @JvmField var visible: Boolean = true + + @JvmField var pixels: ByteArray = ByteArray(0) + + @JvmField var fingerprint: String = "" + + /** Surface-local deferred draws of the retained content (already baked into pixels). */ + @JvmField var draws: Array = NO_DRAWS + + constructor(id: String) { + this.id = id + } + } + + private val lock = protocolPlatform().createLock() + + private var screenWidth: Int = 0 + + private var screenHeight: Int = 0 + + private var blanked: Boolean = false + + /** See setUnderlayDim: surfaces with zOrder below this are dimmed by underlayDim/256. */ + private var underlayDimBelowZOrder: Int = Int.MIN_VALUE + + private var underlayDim: Int = 256 + + private val surfaces: MutableMap = HashMap() + + private var nextCompositeSeq: Long = 1 + + /** Set the output frame size. Must be called before any surface work. */ + fun configureScreen(width: Int, height: Int): Unit { + if (((width <= 0) || (height <= 0))) { + throw IllegalArgumentException(((("bad screen size " + width) + "x") + height)) + } + lock.withLock { + this.screenWidth = width + this.screenHeight = height + } + } + + /** + * Create a surface or update an existing one's geometry. A resize discards the surface's + * retained pixels (reset to 0). + */ + fun configureSurface( + id: String?, + x: Int, + y: Int, + width: Int, + height: Int, + zOrder: Int, + transparency: Int, + ): Unit { + if (((id == null) || id.isEmpty())) { + throw IllegalArgumentException("surface id must be non-empty") + } + if (((width <= 0) || (height <= 0))) { + throw IllegalArgumentException( + ((((("bad surface size " + width) + "x") + height) + " for ") + id) + ) + } + if (((transparency != TRANSPARENCY_OPAQUE) && (transparency != TRANSPARENCY_COLOR_KEY))) { + throw IllegalArgumentException( + ((("bad transparency mode " + transparency) + " for ") + id) + ) + } + lock.withLock { + requireScreenConfiguredLocked() + var surface: Surface? = surfaces.get(id) + if ((surface == null)) { + surface = Surface(id) + surfaces.put(id, surface) + } + if ( + (((surface.pixels == null) || (surface.width != width)) || + (surface.height != height)) + ) { + surface.pixels = ByteArray((width * height)) + surface.fingerprint = "" + surface.draws = NO_DRAWS + } + surface.x = x + surface.y = y + surface.width = width + surface.height = height + surface.zOrder = zOrder + surface.transparency = transparency + } + } + + fun removeSurface(id: String): Unit { + lock.withLock { + surfaces.remove(id) + } + } + + /** + * Dim every surface whose zOrder is below belowZOrder to factor256/256 of its brightness (256 = + * no dimming): how a shell overlay that dims what it covers (the TS Layer.dimUnderneath) + * reaches the window surfaces beneath the shell surface, which the shell's own layer stack + * cannot paint. Visible pixels stay at least 1 (the color-key black); glyph and firmware-text + * draws keep their cached-draw form with a dimmed value; image draws leave the composite's draw + * list (their pixels, already baked into the surface, dim as raster). Takes effect when the + * next frame composites. + */ + fun setUnderlayDim(belowZOrder: Int, factor256: Int): Unit { + lock.withLock { + underlayDimBelowZOrder = belowZOrder + underlayDim = maxOf(0, minOf(256, factor256)) + } + } + + /** The dim factor (256 = none) that applies to a surface. */ + private fun dimForLocked(surface: Surface): Int { + return (if ((surface.zOrder < underlayDimBelowZOrder)) underlayDim else 256) + } + + /** + * Hidden surfaces keep their retained pixels and accept updates, but are excluded from the + * composite and its fingerprint (used for background windows). Takes effect when the next frame + * composites. + */ + fun setSurfaceVisible(id: String, visible: Boolean): Unit { + lock.withLock { + var surface: Surface? = surfaces.get(id) + if ((surface == null)) { + throw IllegalArgumentException(("unknown surface " + id)) + } + surface.visible = visible + } + } + + /** + * While blanked (screen off), composites are all-zero regardless of surface content; retained + * state is untouched, so unblanking restores the screen without asking sources to repaint. + */ + fun setBlanked(blanked: Boolean): Unit { + lock.withLock { + this.blanked = blanked + } + } + + /** + * Apply an update to one surface and composite the whole screen, as one atomic step. The update + * covers the rect (rectX, rectY, rectWidth, rectHeight) in surface-local coordinates; pixels + * must hold exactly rectWidth*rectHeight bytes. contentFingerprint identifies the surface's + * full content after this update. + */ + fun applyAndComposite( + surfaceId: String, + pixels: ByteReader, + rectX: Int, + rectY: Int, + rectWidth: Int, + rectHeight: Int, + contentFingerprint: String, + ): Composite { + return applyAndComposite( + surfaceId, + pixels, + rectX, + rectY, + rectWidth, + rectHeight, + contentFingerprint, + null, + ) + } + + /** + * As above, with the frame's deferred draws: a little-endian buffer of tagged records + * [0][fontId u16][encoding u32][penX s16][lineY s16][value u8] (glyph) [1][imageId u32][x + * s16][y s16] (image) in surface-local coordinates and draw order. The list describes the + * surface's FULL retained content and replaces the previous list, so it is only meaningful for + * full-surface updates (which is what every submitter sends); pass null to clear. Draw pixels + * must already be baked into pixels. + */ + fun applyAndComposite( + surfaceId: String, + pixels: ByteReader?, + rectX: Int, + rectY: Int, + rectWidth: Int, + rectHeight: Int, + contentFingerprint: String?, + glyphs: ByteReader?, + ): Composite = + updateSurface( + surfaceId, + pixels, + rectX, + rectY, + rectWidth, + rectHeight, + contentFingerprint, + glyphs, + true, + )!! + + /** Retain pixels without recompositing; iOS coalesces updates before its frame callback. */ + fun submitSurface( + surfaceId: String, + pixels: ByteReader, + rectX: Int, + rectY: Int, + rectWidth: Int, + rectHeight: Int, + fingerprint: String, + ) { + updateSurface( + surfaceId, + pixels, + rectX, + rectY, + rectWidth, + rectHeight, + fingerprint, + null, + false, + ) + } + + private fun updateSurface( + surfaceId: String, + pixels: ByteReader?, + rectX: Int, + rectY: Int, + rectWidth: Int, + rectHeight: Int, + contentFingerprint: String?, + glyphs: ByteReader?, + composeAfter: Boolean, + ): Composite? { + var parsed: Array = parseDraws(glyphs) + lock.withLock { + requireScreenConfiguredLocked() + var surface: Surface? = surfaces.get(surfaceId) + if ((surface == null)) { + throw IllegalArgumentException(("unknown surface " + surfaceId)) + } + if ( + ((((((rectX < 0) || (rectY < 0)) || (rectWidth <= 0)) || (rectHeight <= 0)) || + ((rectX + rectWidth) > surface.width)) || + ((rectY + rectHeight) > surface.height)) + ) { + throw IllegalArgumentException( + (((((((((((((("update rect " + rectWidth) + "x") + rectHeight) + "+") + rectX) + + "+") + rectY) + " outside surface ") + surfaceId) + " (") + surface.width) + + "x") + surface.height) + ")") + ) + } + var expectedBytes: Int = (rectWidth * rectHeight) + if (((pixels == null) || (pixels.remaining() != expectedBytes))) { + throw IllegalArgumentException( + ((((("update buffer for " + surfaceId) + " has ") + + (if ((pixels == null)) 0 else pixels.remaining())) + " bytes, expected ") + + expectedBytes) + ) + } + run { + var row: Int = 0 + while ((row < rectHeight)) { + var dstOffset: Int = (((rectY + row) * surface.width) + rectX) + pixels.get(surface.pixels, dstOffset, rectWidth) + row++ + } + } + surface.fingerprint = (if ((contentFingerprint == null)) "" else contentFingerprint) + surface.draws = parsed + return if (composeAfter) compositeLocked() else null + } + } + + /** Composite the current retained state without applying an update. */ + fun composite(): Composite { + lock.withLock { + requireScreenConfiguredLocked() + return compositeLocked() + } + } + + /** + * Current composited pixels for the phone-side preview / screenshot, or null before the screen + * is configured. Does not consume a sequence number (it is never stored as the desired frame). + */ + fun previewComposite(): Composite? { + lock.withLock { + if (((screenWidth <= 0) || (screenHeight <= 0))) { + return null + } + var gray: ByteArray = buildGrayLocked() + return Composite(gray, screenWidth, screenHeight, "preview", 0, NO_DRAWS) + } + } + + private fun buildGrayLocked(): ByteArray { + var gray: ByteArray = ByteArray((screenWidth * screenHeight)) + if (blanked) { + return gray + } + var ordered: MutableList = ArrayList(surfaces.values) + ordered.sortWith(compareBy { it.zOrder }.thenBy { it.id }) + for (surface in ordered) { + if (surface.visible) { + blendLocked(gray, surface) + } + } + return gray + } + + private fun compositeLocked(): Composite { + var gray: ByteArray = ByteArray((screenWidth * screenHeight)) + if (blanked) { + return Composite( + gray, + screenWidth, + screenHeight, + ((("blanked:" + screenWidth) + "x") + screenHeight), + nextCompositeSeq++, + NO_DRAWS, + ) + } + var ordered: MutableList = ArrayList(surfaces.values) + ordered.sortWith(compareBy { it.zOrder }.thenBy { it.id }) + var fingerprint: StringBuilder = StringBuilder() + fingerprint.append(screenWidth).append('x').append(screenHeight) + var draws: MutableList = ArrayList() + for (surface in ordered) { + if (!surface.visible) { + continue + } + blendLocked(gray, surface) + var dim: Int = dimForLocked(surface) + for (draw in surface.draws) { + if (((dim < 256) && (draw.kind == ScreenDraw.KIND_IMAGE))) { + continue + } + var value: Int = (if ((dim < 256)) dimValue(draw.value, dim) else draw.value) + draws.add( + ScreenDraw( + draw.kind, + draw.fontId, + draw.encoding, + draw.imageId, + (draw.x + surface.x), + (draw.y + surface.y), + value, + draw.fwCps, + draw.fwDx, + draw.fwInk, + ) + ) + } + fingerprint + .append('|') + .append(surface.id) + .append('@') + .append(surface.x) + .append(',') + .append(surface.y) + .append('+') + .append(surface.width) + .append('x') + .append(surface.height) + .append('#') + .append(surface.zOrder) + .append(':') + .append(surface.transparency) + .append(':') + .append(surface.fingerprint) + if ((dim < 256)) { + fingerprint.append(":dim").append(dim) + } + } + return Composite( + gray, + screenWidth, + screenHeight, + fingerprint.toString(), + nextCompositeSeq++, + draws.toTypedArray(), + ) + } + + private fun blendLocked(gray: ByteArray, surface: Surface): Unit { + var srcX: Int = maxOf(0, -surface.x) + var srcY: Int = maxOf(0, -surface.y) + var dstX: Int = maxOf(0, surface.x) + var dstY: Int = maxOf(0, surface.y) + var copyWidth: Int = minOf((surface.width - srcX), (screenWidth - dstX)) + var copyHeight: Int = minOf((surface.height - srcY), (screenHeight - dstY)) + if (((copyWidth <= 0) || (copyHeight <= 0))) { + return + } + var dim: Int = dimForLocked(surface) + run { + var row: Int = 0 + while ((row < copyHeight)) { + var srcOffset: Int = (((srcY + row) * surface.width) + srcX) + var dstOffset: Int = (((dstY + row) * screenWidth) + dstX) + if ((dim < 256)) { + run { + var col: Int = 0 + while ((col < copyWidth)) { + var value: Int = (surface.pixels[(srcOffset + col)] and 0xff) + if ((value.toInt() != 0)) { + gray[(dstOffset + col)] = (dimValue(value, dim)).toByte() + } else { + if ((surface.transparency == TRANSPARENCY_OPAQUE)) { + gray[(dstOffset + col)] = 0 + } + } + col++ + } + } + } else { + if ((surface.transparency == TRANSPARENCY_OPAQUE)) { + surface.pixels.copyInto(gray, dstOffset, srcOffset, srcOffset + copyWidth) + } else { + run { + var col: Int = 0 + while ((col < copyWidth)) { + var value: Byte = surface.pixels[(srcOffset + col)] + if ((value.toInt() != 0)) { + gray[(dstOffset + col)] = value + } + col++ + } + } + } + } + row++ + } + } + } + + private fun requireScreenConfiguredLocked(): Unit { + if (((screenWidth <= 0) || (screenHeight <= 0))) { + throw IllegalStateException("configureScreen must be called first") + } + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/BinaryEncoding.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/BinaryEncoding.kt new file mode 100644 index 00000000..9a7c1f77 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/BinaryEncoding.kt @@ -0,0 +1,45 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmStatic + +/** Binary encodings shared by firmware downloads and audio recordings. */ +object BinaryEncoding { + @JvmStatic + fun bytesToHex(bytes: ByteArray?): String { + if (bytes == null) return "" + val digits = "0123456789abcdef" + return buildString(bytes.size * 2) { + for (byte in bytes) { + val value = byte.toInt() and 255 + append(digits[value ushr 4]) + append(digits[value and 15]) + } + } + } + + @JvmStatic + fun wavHeader(pcmBytes: Int, sampleRate: Int, channels: Int): ByteArray { + val out = ByteSink(44) + fun u16(value: Int) { + out.write(value) + out.write(value ushr 8) + } + fun u32(value: Int) { + u16(value) + u16(value ushr 16) + } + out.write("RIFF".encodeToByteArray()) + u32(36 + pcmBytes) + out.write("WAVEfmt ".encodeToByteArray()) + u32(16) + u16(1) + u16(channels) + u32(sampleRate) + u32(sampleRate * channels * 2) + u16(channels * 2) + u16(16) + out.write("data".encodeToByteArray()) + u32(pcmBytes) + return out.toByteArray() + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/BmpUtil.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/BmpUtil.kt new file mode 100644 index 00000000..b68046cf --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/BmpUtil.kt @@ -0,0 +1,150 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmStatic + +class BmpUtil { + companion object { + @JvmStatic + fun copyTileBmp(bmp: ByteArray?): ByteArray { + if (((bmp == null) || (bmp.size == 0))) { + return ByteArray(0) + } + return bmp.copyOf(bmp.size) + } + + private val GRAY_TO_NIBBLE = + ByteArray(256) { v -> if (v == 0) 0 else minOf(15, (v + 8) shr 4).toByte() } + + /** + * The 4bpp level an 8-bit gray value packs to. Public so the texture-cache planner computes + * a glyph draw's top color with the exact quantization the composited frame was packed + * with. + */ + @JvmStatic + fun nibbleForGray(gray: Int): Int { + return (GRAY_TO_NIBBLE[(gray and 0xff)] and 0xff) + } + + /** + * Pack a full-resolution 8bpp grayscale buffer (row-major, top-to-bottom, one byte per + * pixel) into the headerless 4bpp wire format used by CFW load_image_z modes 3/6/8: + * top-down rows, stride ceil(width/2), high nibble = left pixel. This is the canonical + * in-memory frame format; BMP framing (needed only when an uncompressed full frame goes on + * the wire) is added on demand by build4bppBmpFromPacked. + */ + @JvmStatic + fun pack4bppFromGray8(gray8: ByteArray?, width: Int, height: Int): ByteArray { + if (((width <= 0) || (height <= 0))) { + return ByteArray(0) + } + var stride: Int = ((width + 1) shr 1) + var out: ByteArray = ByteArray((stride * height)) + if (((gray8 == null) || (gray8.size < (width * height)))) { + return out + } + var pairs: Int = (width shr 1) + var src: Int = 0 + var dst: Int = 0 + run { + var y: Int = 0 + while ((y < height)) { + run { + var i: Int = 0 + while ((i < pairs)) { + out[dst++] = + (((GRAY_TO_NIBBLE[(gray8[src] and 0xff)] shl 4) or + (GRAY_TO_NIBBLE[(gray8[(src + 1)] and 0xff)] and 0xff))) + .toByte() + src += 2 + i++ + } + } + if (((width and 1) != 0)) { + out[dst++] = ((GRAY_TO_NIBBLE[(gray8[src++] and 0xff)] shl 4)).toByte() + } + y++ + } + } + return out + } + + /** + * Wrap a packed 4bpp frame in BMP framing (BITMAPINFOHEADER + 16-entry gray palette, + * bottom-up rows padded to a 4-byte stride). Only the full-frame fallback used when mode-6 + * compression does not shrink the frame still speaks BMP on the wire; everything else uses + * the headerless packed format directly. + */ + @JvmStatic + fun build4bppBmpFromPacked(packed: ByteArray?, width: Int, height: Int): ByteArray { + var packedStride: Int = ((width + 1) shr 1) + if ( + ((((width <= 0) || (height <= 0)) || (packed == null)) || + (packed.size < (packedStride * height))) + ) { + return ByteArray(0) + } + var rowStride: Int = ((packedStride + 3) and 3.inv()) + var pixelDataSize: Int = (rowStride * height) + var fileHeaderSize: Int = 14 + var dibHeaderSize: Int = 40 + var paletteSize: Int = (16 * 4) + var pixelOffset: Int = ((fileHeaderSize + dibHeaderSize) + paletteSize) + var fileSize: Int = (pixelOffset + pixelDataSize) + var buf: ByteArray = ByteArray(fileSize) + buf[0] = 0x42 + buf[1] = 0x4 + putUint32Le(buf, 2, fileSize) + putUint32Le(buf, 10, pixelOffset) + putUint32Le(buf, 14, dibHeaderSize) + putInt32Le(buf, 18, width) + putInt32Le(buf, 22, height) + putUint16Le(buf, 26, 1) + putUint16Le(buf, 28, 4) + putUint32Le(buf, 30, 0) + putUint32Le(buf, 34, pixelDataSize) + putUint32Le(buf, 46, 16) + run { + var i: Int = 0 + while ((i < 16)) { + var v: Int = (i * 17) + var base: Int = ((fileHeaderSize + dibHeaderSize) + (i * 4)) + buf[base] = (v).toByte() + buf[(base + 1)] = (v).toByte() + buf[(base + 2)] = (v).toByte() + buf[(base + 3)] = 0 + i++ + } + } + run { + var bmpRow: Int = 0 + while ((bmpRow < height)) { + var srcY: Int = ((height - 1) - bmpRow) + packed.copyInto( + buf, + (pixelOffset + (bmpRow * rowStride)), + (srcY * packedStride), + (srcY * packedStride) + packedStride, + ) + bmpRow++ + } + } + return buf + } + + private fun putUint16Le(buf: ByteArray, offset: Int, value: Int): Unit { + buf[offset] = ((value and 0xff)).toByte() + buf[(offset + 1)] = (((value ushr 8) and 0xff)).toByte() + } + + private fun putUint32Le(buf: ByteArray, offset: Int, value: Int): Unit { + buf[offset] = ((value and 0xff)).toByte() + buf[(offset + 1)] = (((value ushr 8) and 0xff)).toByte() + buf[(offset + 2)] = (((value ushr 16) and 0xff)).toByte() + buf[(offset + 3)] = (((value ushr 24) and 0xff)).toByte() + } + + private fun putInt32Le(buf: ByteArray, offset: Int, value: Int): Unit { + putUint32Le(buf, offset, value) + } + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/ByteReader.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/ByteReader.kt new file mode 100644 index 00000000..cfb69420 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/ByteReader.kt @@ -0,0 +1,43 @@ +package com.faceclaw.app + +/** Sequential little-endian input. Platform adapters can read native buffers without a copy. */ +abstract class ByteReader { + abstract fun remaining(): Int + + abstract fun get(): Byte + + abstract fun get(index: Int): Byte + + open fun get(bytes: ByteArray): ByteReader = get(bytes, 0, bytes.size) + + open fun get(bytes: ByteArray, offset: Int, length: Int): ByteReader { + require( + length >= 0 && offset >= 0 && offset <= bytes.size - length && remaining() >= length + ) + for (i in offset until offset + length) bytes[i] = get() + return this + } + + fun getShort(): Short = ((get().toInt() and 255) or ((get().toInt() and 255) shl 8)).toShort() + + fun getInt(): Int = (getShort().toInt() and 65535) or (getShort().toInt() shl 16) +} + +class ArrayByteReader(private val bytes: ByteArray) : ByteReader() { + private var position = 0 + + override fun remaining(): Int = bytes.size - position + + override fun get(): Byte = bytes[position++] + + override fun get(index: Int): Byte = bytes[index] + + override fun get(bytes: ByteArray, offset: Int, length: Int): ByteReader { + require( + length >= 0 && offset >= 0 && offset <= bytes.size - length && remaining() >= length + ) + this.bytes.copyInto(bytes, offset, position, position + length) + position += length + return this + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/ByteSink.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/ByteSink.kt new file mode 100644 index 00000000..3362e26d --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/ByteSink.kt @@ -0,0 +1,44 @@ +package com.faceclaw.app + +/** Growable byte buffer for wire encoders; no streams or platform objects escape. */ +internal class ByteSink(capacity: Int = 32) { + private var bytes = ByteArray(capacity.coerceAtLeast(1)) + private var count = 0 + + fun size(): Int = count + + fun write(value: Char) = write(value.code) + + fun write(value: ByteArray) = write(value, 0, value.size) + + fun write(value: Int) { + reserve(1) + bytes[count++] = value.toByte() + } + + fun write(value: ByteArray, offset: Int, length: Int) { + require(offset >= 0 && length >= 0 && offset <= value.size - length) + reserve(length) + value.copyInto(bytes, count, offset, offset + length) + count += length + } + + fun toByteArray(): ByteArray = bytes.copyOf(count) + + private fun reserve(extra: Int) { + if (count + extra > bytes.size) bytes = bytes.copyOf(maxOf(count + extra, bytes.size * 2)) + } +} + +internal infix fun Byte.and(mask: Int): Int = toInt() and mask + +internal infix fun Byte.shl(bits: Int): Int = toInt() shl bits + +internal fun codePointUtf8(codePoint: Int): ByteArray { + require(codePoint in 0..0x10ffff) + if (codePoint <= 0xffff) return codePoint.toChar().toString().encodeToByteArray() + val value = codePoint - 0x10000 + return charArrayOf((0xd800 + (value ushr 10)).toChar(), (0xdc00 + (value and 1023)).toChar()) + .concatToString() + .encodeToByteArray() +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/CollectionUtils.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/CollectionUtils.kt new file mode 100644 index 00000000..45012c10 --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/util/CollectionUtils.kt @@ -0,0 +1,31 @@ +package com.faceclaw.app + +import kotlin.jvm.JvmStatic + +class CollectionUtils { + companion object { + @JvmStatic + fun singletonList(value: ByteArray): MutableList { + var list: MutableList = ArrayList(1) + list.add(value) + return list + } + + @JvmStatic + fun listOf(a: ByteArray, b: ByteArray): MutableList { + var list: MutableList = ArrayList(2) + list.add(a) + list.add(b) + return list + } + + @JvmStatic + fun listOf(a: ByteArray, b: ByteArray, c: ByteArray): MutableList { + var list: MutableList = ArrayList(3) + list.add(a) + list.add(b) + list.add(c) + return list + } + } +} diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/shared/KotlinBridge.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/shared/KotlinBridge.kt new file mode 100644 index 00000000..b43e81ab --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/shared/KotlinBridge.kt @@ -0,0 +1,35 @@ +package com.faceclaw.shared + +/** NativeScript implements this Kotlin-owned contract in TypeScript. */ +interface KotlinBridgeListener { + fun transform(message: String): String +} + +/** + * Portable Kotlin at the same commonMain source path used by ios-port. Calls and callbacks are + * synchronous on the caller's thread. The listener is used only during roundTrip and is never + * retained. + */ +class KotlinBridge { + fun platform(): String = PlatformInfo.name + + fun threadName(): String = PlatformInfo.threadName() + + fun isMainThread(): Boolean = PlatformInfo.isMainThread() + + fun greet(name: String): String = "Hello, $name, from Kotlin" + + fun roundTrip(message: String, listener: KotlinBridgeListener): String { + val reply = listener.transform("Kotlin received: $message") + // Consume the TypeScript return value, then return it across the bridge. + return "Kotlin received callback: $reply" + } +} + +internal expect object PlatformInfo { + val name: String + + fun threadName(): String + + fun isMainThread(): Boolean +} diff --git a/native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/app/IosNativeApi.kt b/native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/app/IosNativeApi.kt new file mode 100644 index 00000000..e461a9b6 --- /dev/null +++ b/native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/app/IosNativeApi.kt @@ -0,0 +1,264 @@ +@file:OptIn(kotlinx.cinterop.ExperimentalForeignApi::class) + +package com.faceclaw.app + +import kotlinx.cinterop.* +import platform.Foundation.NSData +import platform.Foundation.create +import platform.posix.memcpy + +/** NSData keeps large binary crossings out of per-element JavaScript bridge loops. */ +internal fun NSData.byteArray(): ByteArray { + require(length <= Int.MAX_VALUE.toULong()) + val result = ByteArray(length.toInt()) + if (result.isNotEmpty()) result.usePinned { memcpy(it.addressOf(0), bytes, length) } + return result +} + +internal fun ByteArray.data(): NSData = + if (isEmpty()) NSData() + else + usePinned { + NSData.create(bytes = it.addressOf(0), length = size.toULong()) + } + +class IosByteReader(private val data: NSData) : ByteReader() { + private var position = 0 + + override fun remaining(): Int = data.length.toInt() - position + + override fun get(): Byte = get(position++) + + override fun get(index: Int): Byte { + require(index >= 0 && index < data.length.toInt()) + return data.bytes!!.reinterpret()[index] + } + + override fun get(bytes: ByteArray, offset: Int, length: Int): ByteReader { + require( + offset >= 0 && length >= 0 && offset <= bytes.size - length && remaining() >= length + ) + if (length > 0) + bytes.usePinned { + memcpy( + it.addressOf(offset), + data.bytes!!.reinterpret() + position, + length.toULong(), + ) + } + position += length + return this + } +} + +class IosCfwTransport { + private val transport = CfwTransport(IosProtocolPlatform) + + fun reset() = transport.reset() + + fun close() = transport.close() + + fun encode(data: NSData, streamId: Int, lenses: Int, maxWrite: Int): List = + transport.encode(data.byteArray(), streamId, lenses, maxWrite + 3).map { it.data() } +} + +class IosProtocolMessage(message: MessageReceiver.Message) { + val sid = message.sid + val flag = message.flag + val payload = message.payload.data() + val command = message.command + val magic = message.magic + val packet = message.packet?.data() +} + +class IosMessageReceiver { + private val receiver = MessageReceiver() + + fun clear() = receiver.clear() + + fun receive(link: String, data: NSData, now: Long): List = + receiver.receive(link, data.byteArray(), now).map { IosProtocolMessage(it) } +} + +/** Stable binary facade over the shared wire algorithms and font parser. */ +class IosProtocol { + fun authentication(magic: Int): NSData = BleProtocol.buildAuthenticationRequest(magic).data() + + fun prelude(): NSData = BleProtocol.PRELUDE_F5872_PAYLOAD.data() + + fun heartbeat(magic: Int): NSData = BleProtocol.buildHeartbeat(magic).data() + + fun audioControl(magic: Int, enabled: Boolean): NSData = + BleProtocol.buildAudioControl(magic, enabled).data() + + fun settingsQuery(magic: Int): NSData = BleProtocol.buildSettingsQuery(magic).data() + + fun shutdown(magic: Int): NSData = BleProtocol.buildShutdown(magic, 1).data() + + fun framebufferLease(acquire: Boolean): NSData = + BleProtocol.buildFaceclawWakeControl( + if (acquire) BleProtocol.FACECLAW_FB_OP_ACQUIRE + else BleProtocol.FACECLAW_FB_OP_RELEASE, + 0, + ) + .data() + + fun createLayout(magic: Int): NSData = BleProtocol.buildCreateInputPage(magic).data() + + fun integer(field: Int, value: Int): NSData = BleProtocol.encodeVarintField(field, value).data() + + fun bytes(field: Int, data: NSData): NSData = + BleProtocol.encodeBytesField(field, data.byteArray()).data() + + fun crc(data: NSData): Int = CfwTransport.crc(data.byteArray()) + + fun frame(data: NSData, sid: Int, flag: Int, sequence: Int, maxWrite: Int): List = + BleProtocol.framePb(data.byteArray(), sid, flag, sequence, maxWrite).map { it.data() } + + fun acks(data: NSData): List? = + CfwTransport.parseAcks(data.byteArray())?.toList() + + fun readInteger(data: NSData, field: Int, fallback: Int): Int = + BleProtocol.readVarintFieldValue(data.byteArray(), field, fallback) + + fun readBytes(data: NSData, field: Int): NSData? = + BleProtocol.readFieldBytes(data.byteArray(), field)?.data() + + fun readString(data: NSData, field: Int): String = + BleProtocol.readStringFieldValue(data.byteArray(), field) + + fun glassesInput(data: NSData, sid: Int, flag: Int): G2Event? = + if (sid == BleProtocol.SID_EVENHUB && flag in intArrayOf(1, 6)) + G2Event.decodePayload(sid, data.byteArray()) + else null + + fun ringInput(data: NSData): G2Event? = FaceclawRingEventDecoder.decode(data.byteArray())?.event + + fun pack(data: NSData, width: Int, height: Int): NSData { + require(width > 0 && height > 0 && data.length == width.toULong() * height.toULong()) + return BmpUtil.pack4bppFromGray8(data.byteArray(), width, height).data() + } + + fun rle(data: NSData): NSData = BleImageOptimizer.rleEncode(data.byteArray()).data() + + fun boundingBox( + previous: NSData?, + next: NSData, + width: Int, + height: Int, + frameId: Int, + ): NSData? = + BleImageOptimizer.buildIncrementalImagePayload( + previous?.byteArray(), + next.byteArray(), + width, + height, + frameId, + ) + ?.payload + ?.data() + + fun fullFrameBands(data: NSData, width: Int, height: Int, firstId: Int): List { + require( + width in 1..640 && + width % 4 == 0 && + height in 1..480 && + height % 2 == 0 && + data.length == (width * height / 2).toULong() + ) + val packed = data.byteArray() + var id = firstId + return (0 until height step 64).map { top -> + val result = + BleImageOptimizer.encodeMode3Rect( + packed, + width / 2, + 0, + top, + width, + minOf(64, height - top), + id, + ) + .data() + id = if (id >= 0xfffe) 1 else id + 1 + result + } + } + + fun fontMetrics(path: String): NSData = LvglFontFile.getMetrics(path).data() + + fun fontGlyph(path: String, codePoint: Int): NSData = + LvglFontFile.getGlyph(path, codePoint).data() + + fun png(data: NSData, width: Int, height: Int): NSData = + SharedScreenshots.encode4BitGrayPng(data.byteArray(), width, height).data() +} + +/** iOS retains/coalesces surface updates in the same compositor Android uses. */ +class IosSurfaceCompositor(width: Int, height: Int) { + private val compositor = SurfaceCompositor().also { it.configureScreen(width, height) } + private val sizes = mutableMapOf>() + private var sequence = 0L + + fun configure( + id: String, + x: Int, + y: Int, + width: Int, + height: Int, + zOrder: Int, + transparent: Boolean, + ) { + compositor.configureSurface(id, x, y, width, height, zOrder, if (transparent) 1 else 0) + sizes[id] = width to height + } + + fun remove(id: String) { + sizes.remove(id) + compositor.removeSurface(id) + } + + fun visible(id: String, visible: Boolean) = compositor.setSurfaceVisible(id, visible) + + fun dim(below: Int, factor: Double) { + require(factor.isFinite()) + compositor.setUnderlayDim(below, (factor.coerceIn(0.0, 1.0) * 256).toInt()) + } + + fun blank(blanked: Boolean) = compositor.setBlanked(blanked) + + fun submit(id: String, data: NSData, x: Int, y: Int, width: Int, height: Int) { + val (sw, sh) = sizes[id] ?: error("Unknown surface: $id") + require(width > 0 && height > 0 && data.length == width.toULong() * height.toULong()) + val left = maxOf(0, x) + val right = minOf(sw, x + width) + val top = maxOf(0, y) + val bottom = minOf(sh, y + height) + if (right <= left || bottom <= top) return + val reader = + if (left == x && top == y && right - left == width && bottom - top == height) + IosByteReader(data) + else { + val source = data.byteArray() + val clipped = ByteArray((right - left) * (bottom - top)) + for (row in top until bottom) source.copyInto( + clipped, + (row - top) * (right - left), + (row - y) * width + left - x, + (row - y) * width + right - x, + ) + ArrayByteReader(clipped) + } + compositor.submitSurface( + id, + reader, + left, + top, + right - left, + bottom - top, + (++sequence).toString(), + ) + } + + fun composite(): NSData = compositor.composite().gray.data() +} diff --git a/native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/app/PlatformServices.ios.kt b/native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/app/PlatformServices.ios.kt new file mode 100644 index 00000000..91525178 --- /dev/null +++ b/native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/app/PlatformServices.ios.kt @@ -0,0 +1,72 @@ +package com.faceclaw.app + +import kotlinx.cinterop.* + +internal actual fun protocolPlatform(): ProtocolPlatform = IosProtocolPlatform + +@OptIn(kotlinx.cinterop.ExperimentalForeignApi::class) +internal actual fun readFileData(path: String): ByteArray { + val file = platform.posix.fopen(path, "rb") ?: error("Cannot read $path") + try { + check(platform.posix.fseek(file, 0, platform.posix.SEEK_END) == 0) + val size = platform.posix.ftell(file) + require(size in 0..Int.MAX_VALUE.toLong()) + platform.posix.rewind(file) + val bytes = ByteArray(size.toInt()) + if (bytes.isNotEmpty()) + bytes.usePinned { + check( + platform.posix.fread(it.addressOf(0), 1u, bytes.size.toULong(), file) == + bytes.size.toULong() + ) + } + return bytes + } finally { + platform.posix.fclose(file) + } +} + +@OptIn(kotlinx.cinterop.ExperimentalForeignApi::class) +internal actual fun deflateData(bytes: ByteArray): ByteArray = + kotlinx.cinterop.memScoped { + val capacity = platform.zlib.compressBound(bytes.size.toULong()) + val result = ByteArray(capacity.toInt()) + val length = alloc() + length.value = capacity + bytes.usePinned { input -> + result.usePinned { output -> + check( + platform.zlib.compress2( + output.addressOf(0).reinterpret(), + length.ptr, + if (bytes.isEmpty()) null else input.addressOf(0).reinterpret(), + bytes.size.toULong(), + platform.zlib.Z_DEFAULT_COMPRESSION, + ) == platform.zlib.Z_OK + ) + } + } + result.copyOf(length.value.toInt()) + } + +@OptIn(kotlinx.cinterop.ExperimentalForeignApi::class) +internal actual fun inflateData(bytes: ByteArray, size: Int): ByteArray = + kotlinx.cinterop.memScoped { + val result = ByteArray(size) + val length = alloc() + length.value = size.toULong() + bytes.usePinned { input -> + result.usePinned { output -> + check( + platform.zlib.uncompress( + output.addressOf(0).reinterpret(), + length.ptr, + input.addressOf(0).reinterpret(), + bytes.size.toULong(), + ) == platform.zlib.Z_OK + ) + } + } + check(length.value.toInt() == size) { "recorded frame truncated" } + result + } diff --git a/native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/app/g2protocol/IosProtocolPlatform.kt b/native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/app/g2protocol/IosProtocolPlatform.kt new file mode 100644 index 00000000..3b24fcca --- /dev/null +++ b/native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/app/g2protocol/IosProtocolPlatform.kt @@ -0,0 +1,129 @@ +@file:OptIn( + kotlinx.cinterop.ExperimentalForeignApi::class, + kotlin.experimental.ExperimentalNativeApi::class, +) + +package com.faceclaw.app + +import kotlin.native.ref.createCleaner +import kotlinx.cinterop.* +import platform.CoreBluetooth.CBCharacteristicWriteType +import platform.CoreBluetooth.CBCharacteristicWriteWithResponse +import platform.CoreBluetooth.CBCharacteristicWriteWithoutResponse +import platform.Foundation.NSRecursiveLock +import platform.posix.CLOCK_MONOTONIC_RAW +import platform.posix.clock_gettime_nsec_np +import platform.posix.memset +import platform.zlib.* + +object IosProtocolPlatform : ProtocolPlatform { + // Unlike wall time, this cannot jump; unlike uptime, it includes sleep. + override fun elapsedRealtimeMs(): Long = + (clock_gettime_nsec_np(CLOCK_MONOTONIC_RAW.convert()) / 1_000_000uL).toLong() + + override fun createLock(): ProtocolLock = + object : ProtocolLock { + private val lock = NSRecursiveLock() + + override fun lock() = lock.lock() + + override fun unlock() = lock.unlock() + } + + override fun createDeflater(): ProtocolDeflater = IosDeflater() + + fun writeType(mode: GattWriteMode): CBCharacteristicWriteType = + when (mode) { + GattWriteMode.WITH_RESPONSE -> CBCharacteristicWriteWithResponse + GattWriteMode.WITHOUT_RESPONSE -> CBCharacteristicWriteWithoutResponse + } +} + +/** The cleaner holds only the allocation state, never the owning deflater. */ +private class ZlibState { + private val lock = NSRecursiveLock() + var stream: CPointer? = nativeHeap.alloc().ptr + private set + + init { + memset(stream, 0, sizeOf().convert()) + val status = deflateInit(stream, Z_DEFAULT_COMPRESSION) + if (status != Z_OK) { + nativeHeap.free(stream!!) + stream = null + error("zlib initialization failed: $status") + } + } + + fun use(action: (CPointer) -> T): T { + lock.lock() + try { + return action(checkNotNull(stream) { "zlib stream is closed" }) + } finally { + lock.unlock() + } + } + + fun close() { + lock.lock() + try { + val value = stream ?: return + deflateEnd(value) + nativeHeap.free(value) + stream = null + } finally { + lock.unlock() + } + } +} + +private class IosDeflater : ProtocolDeflater { + private val state = ZlibState() + private val cleaner = createCleaner(state) { it.close() } + + override fun reset() = state.use { check(deflateReset(it) == Z_OK) } + + override fun syncFlush(message: ByteArray): ByteArray = state.use { stream -> + val chunks = mutableListOf() + var size = 0 + val buffer = ByteArray(4096) + message.usePinned { input -> + stream.pointed.next_in = + if (message.isEmpty()) null else input.addressOf(0).reinterpret() + stream.pointed.avail_in = message.size.toUInt() + try { + buffer.usePinned { output -> + do { + stream.pointed.next_out = output.addressOf(0).reinterpret() + stream.pointed.avail_out = buffer.size.toUInt() + val status = deflate(stream, Z_SYNC_FLUSH) + // A repeated empty SYNC_FLUSH is a valid no-op. + check(status == Z_OK || status == Z_BUF_ERROR) { + "zlib deflate failed: $status" + } + val count = buffer.size - stream.pointed.avail_out.toInt() + if (count > 0) { + chunks.add(buffer.copyOf(count)) + size += count + } + } while (stream.pointed.avail_out == 0u) + } + } finally { + // Do not leave pointers to unpinned Kotlin arrays in native memory. + stream.pointed.next_in = null + stream.pointed.next_out = null + stream.pointed.avail_in = 0u + stream.pointed.avail_out = 0u + } + } + ByteArray(size).also { result -> + var offset = 0 + for (chunk in chunks) { + chunk.copyInto(result, offset) + offset += chunk.size + } + } + } + + override fun close() = state.close() +} diff --git a/native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/shared/PlatformInfo.ios.kt b/native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/shared/PlatformInfo.ios.kt new file mode 100644 index 00000000..890b5d90 --- /dev/null +++ b/native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/shared/PlatformInfo.ios.kt @@ -0,0 +1,13 @@ +package com.faceclaw.shared + +import platform.Foundation.NSThread + +internal actual object PlatformInfo { + actual val name: String = "iOS" + + actual fun threadName(): String = + NSThread.currentThread.name?.takeIf { it.isNotEmpty() } + ?: if (NSThread.isMainThread) "main" else "background" + + actual fun isMainThread(): Boolean = NSThread.isMainThread +} diff --git a/package.json b/package.json index a9779a9a..d0d81931 100644 --- a/package.json +++ b/package.json @@ -6,7 +6,7 @@ "scripts": { "native:android": "node scripts/kotlin-build.cjs android", "native:ios": "node scripts/kotlin-build.cjs ios", - "test:kotlin": "cd native/kotlin && ./gradlew :shared:testAndroidHostTest :shared:iosSimulatorArm64Test", + "test:kotlin": "bash scripts/test-kotlin.sh", "build:ios": "scripts/ios.sh build ios --for-device", "run:ios": "scripts/ios.sh run ios", "prepare:ios": "scripts/ios.sh prepare ios", @@ -15,7 +15,8 @@ "run": "./build_and_run.sh", "release": "scripts/release.sh", "clean": "rm -rf platforms", - "test": "tsc -p tests/tsconfig.json && node --test tests/*.test.cjs" + "test": "tsc -p tests/tsconfig.json && node --test tests/*.test.cjs", + "test:kotlin:ios": "bash scripts/test-kotlin.sh iosSimulatorArm64Test compileKotlinIosArm64" }, "dependencies": { "@evenrealities/pretext": "^0.1.4", diff --git a/scripts/kotlin-build.cjs b/scripts/kotlin-build.cjs new file mode 100644 index 00000000..1d4d07d3 --- /dev/null +++ b/scripts/kotlin-build.cjs @@ -0,0 +1,73 @@ +const { spawn } = require('node:child_process'); +const { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync } = require('node:fs'); +const path = require('node:path'); + +const root = path.resolve(__dirname, '..'); +const kotlin = path.join(root, 'native/kotlin'); + +function sameContents(source, destination) { + if (!existsSync(destination)) return false; + if (statSync(source).isDirectory()) { + if (!statSync(destination).isDirectory()) return false; + const entries = readdirSync(source).sort(); + const previous = readdirSync(destination).sort(); + return entries.length === previous.length && entries.every((entry, index) => + entry === previous[index] && sameContents(path.join(source, entry), path.join(destination, entry))); + } + return statSync(destination).isFile() && readFileSync(source).equals(readFileSync(destination)); +} + +function checkAndroidRuntime(projectDir = root) { + const generated = path.join(projectDir, 'platforms/android/build-tools/android-metadata-generator.jar'); + const installed = path.join(projectDir, 'node_modules/@nativescript/android/framework/build-tools/android-metadata-generator.jar'); + if (existsSync(generated) && !sameContents(installed, generated)) { + throw new Error('Generated Android runtime is stale. Run "ns platform clean android" once after npm ci, then rebuild.'); + } +} + +async function buildKotlin(platform, configuration = 'debug') { + if (!['android', 'ios'].includes(platform)) throw new Error(`Unsupported Kotlin platform: ${platform}`); + if (!['debug', 'release'].includes(configuration)) throw new Error(`Unsupported Kotlin configuration: ${configuration}`); + const variant = configuration === 'release' ? 'Release' : 'Debug'; + const task = platform === 'android' ? ':shared:assembleAndroidMain' : `:shared:assembleFaceclawKit${variant}XCFramework`; + const wrapper = path.join(root, 'wear', process.platform === 'win32' ? 'gradlew.bat' : 'gradlew'); + console.log(`[kotlin] Building ${platform} (${configuration})`); + await new Promise((resolve, reject) => { + const child = spawn(wrapper, [task, '--console=plain'], { cwd: kotlin, stdio: 'inherit' }); + child.on('error', reject); + child.on('exit', (code, signal) => { + if (code === 0) resolve(); + else reject(new Error(`Kotlin build failed (${signal || code})`)); + }); + }); + // Stage only after a successful build. npm links this directory into node_modules. + const destination = path.join(kotlin, 'plugin/platforms', platform); + mkdirSync(destination, { recursive: true }); + if (platform === 'android') { + // NativeScript's resource copy can retain deleted sources. Remove the + // generated copy from the pre-KMP bridge so it cannot duplicate the AAR. + rmSync(path.join(root, 'platforms/android/app/src/main/java/com/faceclaw/shared/KotlinBridge.kt'), { force: true }); + const output = path.join(kotlin, 'shared/build/outputs/aar'); + const files = readdirSync(output).filter(name => name.endsWith('.aar')); + if (files.length !== 1) throw new Error(`Expected one Kotlin AAR, found: ${files.join(', ')}`); + const source = path.join(output, files[0]); + const aar = path.join(destination, 'faceclaw-shared.aar'); + if (!sameContents(source, aar)) cpSync(source, aar); + } else { + const framework = path.join(destination, 'FaceclawKit.xcframework'); + const source = path.join(kotlin, `shared/build/XCFrameworks/${configuration}/FaceclawKit.xcframework`); + // Preserve mtimes on no-op builds: NativeScript uses them to detect changes. + if (!sameContents(source, framework)) { + rmSync(framework, { recursive: true, force: true }); + cpSync(source, framework, { recursive: true }); + } + } +} + +module.exports = { buildKotlin, checkAndroidRuntime }; +if (require.main === module) { + buildKotlin(process.argv[2], process.argv[3]).catch(error => { + console.error(error); + process.exitCode = 1; + }); +} diff --git a/scripts/test-kotlin.sh b/scripts/test-kotlin.sh new file mode 100644 index 00000000..ee4bcd4e --- /dev/null +++ b/scripts/test-kotlin.sh @@ -0,0 +1,8 @@ +#!/usr/bin/env bash +set -euo pipefail +cd "$(dirname "$0")/.." +source scripts/before_build.sh +if [ "$#" -eq 0 ]; then + set -- testAndroidHostTest +fi +exec ./wear/gradlew -p tests/kotlin "$@" diff --git a/tests/README.md b/tests/README.md index a9fe157f..98f99845 100644 --- a/tests/README.md +++ b/tests/README.md @@ -15,15 +15,13 @@ That compiles the pure modules with the project's TypeScript into dependencies are needed — the tests are plain `.test.cjs` files that use `node:test` and `node:assert`. -Compass diagnostics have focused UI and wire-format checks: +The shared Kotlin suite runs separately from the Node tests: - node --test tests/compass-debug.test.cjs tests/compass-protocol.test.cjs + npm run test:kotlin + npm run test:kotlin:ios -The protocol check also compiles the production Java parser, so it needs a -JDK (`JAVA_HOME`, or `javac` and `java` on `PATH`). Its golden packet is shared -with the firmware encoder test in `g2flash/tests/compass_diagnostics_test.c`. - -R1 battery field-106 decoding (valid zero, charging, unavailable/disconnected, -legacy firmware, malformed messages) uses the same C/Java golden packet: - - node --test tests/ring-battery-protocol.test.cjs +It includes the migrated compass, R1 battery, gesture and texture Java fixtures, +which now call the Kotlin implementation from Android host tests. Common tests +also run as native iOS simulator binaries. See [the Kotlin README](../native/kotlin/README.md) +for SDK requirements, source layout and coverage. The compass and battery +fixtures retain the golden packets shared with firmware tests. diff --git a/tests/cfw-transport.test.cjs b/tests/cfw-transport.test.cjs index 6e9e3ad4..8811c45d 100644 --- a/tests/cfw-transport.test.cjs +++ b/tests/cfw-transport.test.cjs @@ -9,28 +9,22 @@ const { crc16, concat, MessageReceiver } = require('../.test-build/app/g2/ble-pr const hex = value => Buffer.from(value).toString('hex'); test('iOS transport matches Android packets including persistent compression, reset, raw fallback and ATT limits', () => { - const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'faceclaw-cfw-java-')); - const java = name => process.env.JAVA_HOME ? path.join(process.env.JAVA_HOME, 'bin', name) : name; const random = new Uint8Array(65535); let seed = 42; for (let i = 0; i < random.length; i++) { seed ^= seed << 13; seed ^= seed >>> 17; seed ^= seed << 5; random[i] = seed & 255; } const cases = [[100, 3, 185, new Uint8Array([6, 0, 0, 255, 255])], [101, 3, 185, new Uint8Array([6, 0, 0, 255, 255])], [102, 1, 20, new Uint8Array(500).fill(42)], 'reset', [255, 3, 514, random], [103, 3, 240, new Uint8Array([11])]]; - try { - execFileSync(java('javac'), ['-d', dir, - path.join(__dirname, '../App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/CfwTransport.java'), - path.join(__dirname, 'fixtures/CfwTransportVectors.java')]); - const expected = execFileSync(java('java'), ['-cp', dir, 'com.faceclaw.app.CfwTransportVectors', - ...cases.map(c => c === 'reset' ? c : `${c[0]}:${c[1]}:${c[2]}:${hex(c[3])}`)], - { maxBuffer: 1024 * 1024 }).toString().trim().split('\n'); + // Captured from the original Java encoder before migration; production now uses Kotlin. + const expected = require('./fixtures/cfw-java-golden.json'); + const hash = value => require('node:crypto').createHash('sha256').update(value).digest('hex'); const transport = new CfwTransport(); let index = 0; for (const c of cases) { if (c === 'reset') { transport.reset(); continue; } const [id, lenses, maxWrite, payload] = c, packets = transport.encode(payload, id, lenses, maxWrite); assert.ok(packets.every(p => p.length <= maxWrite)); - assert.equal(packets.map(hex).join(' '), expected[index++]); + assert.equal(hash(packets.map(hex).join(' ')), expected[index++]); } - } finally { fs.rmSync(dir, { recursive: true, force: true }); } + }); function ackPacket(records, lens = 1, nack = false) { diff --git a/tests/compass-protocol.test.cjs b/tests/compass-protocol.test.cjs deleted file mode 100644 index feee8260..00000000 --- a/tests/compass-protocol.test.cjs +++ /dev/null @@ -1,19 +0,0 @@ -const test = require('node:test'); -const fs = require('node:fs'); -const os = require('node:os'); -const path = require('node:path'); -const { execFileSync } = require('node:child_process'); - -test('compass diagnostics decode with legacy and malformed-extension fallback', () => { - const directory = fs.mkdtempSync(path.join(os.tmpdir(), 'faceclaw-compass-java-')); - const javaBin = (name) => process.env.JAVA_HOME ? path.join(process.env.JAVA_HOME, 'bin', name) : name; - try { - execFileSync(javaBin('javac'), ['-d', directory, - path.join(__dirname, '../App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/BleProtocol.java'), - path.join(__dirname, '../App_Resources/Android/src/main/java/com/faceclaw/app/util/CollectionUtils.java'), - path.join(__dirname, 'fixtures/CompassProtocolTest.java')], { stdio: 'pipe' }); - execFileSync(javaBin('java'), ['-ea', '-cp', directory, 'com.faceclaw.app.CompassProtocolTest'], { stdio: 'pipe' }); - } finally { - fs.rmSync(directory, { recursive: true, force: true }); - } -}); diff --git a/tests/compass-texture-cache.test.cjs b/tests/compass-texture-cache.test.cjs index 55edd8ff..2f947829 100644 --- a/tests/compass-texture-cache.test.cjs +++ b/tests/compass-texture-cache.test.cjs @@ -151,7 +151,7 @@ test('the background registers once and uses a nine-byte image reference on late const registered = []; const { prepareFrameDraws } = load('app/graphics/glyph-wire.ts', {}, '', { global: { isAndroid: true }, - com: { faceclaw: { app: { ImageAtlas: { ensure: (...args) => { + com: { faceclaw: { app: { AndroidByteReader: class { constructor(buffer) { this.buffer = buffer; } }, ImageAtlas: { ensure: (...args) => { registered.push(args); return 1; } } } } }, diff --git a/tests/faceclaw-gesture-event.test.cjs b/tests/faceclaw-gesture-event.test.cjs deleted file mode 100644 index 1071c1f7..00000000 --- a/tests/faceclaw-gesture-event.test.cjs +++ /dev/null @@ -1,19 +0,0 @@ -const test = require('node:test'); -const fs = require('node:fs'); -const os = require('node:os'); -const path = require('node:path'); -const { execFileSync } = require('node:child_process'); - -test('CFW idle-gesture events decode to sys-event types and sources; wake and junk do not', () => { - const directory = fs.mkdtempSync(path.join(os.tmpdir(), 'faceclaw-gesture-java-')); - const javaBin = (name) => process.env.JAVA_HOME ? path.join(process.env.JAVA_HOME, 'bin', name) : name; - try { - execFileSync(javaBin('javac'), ['-d', directory, - path.join(__dirname, '../App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/BleProtocol.java'), - path.join(__dirname, '../App_Resources/Android/src/main/java/com/faceclaw/app/util/CollectionUtils.java'), - path.join(__dirname, 'fixtures/FaceclawGestureEventTest.java')], { stdio: 'pipe' }); - execFileSync(javaBin('java'), ['-ea', '-cp', directory, 'com.faceclaw.app.FaceclawGestureEventTest'], { stdio: 'pipe' }); - } finally { - fs.rmSync(directory, { recursive: true, force: true }); - } -}); diff --git a/tests/fixtures/CfwTransportVectors.java b/tests/fixtures/CfwTransportVectors.java deleted file mode 100644 index bbbf00f0..00000000 --- a/tests/fixtures/CfwTransportVectors.java +++ /dev/null @@ -1,19 +0,0 @@ -package com.faceclaw.app; - -/** Production Android encoder oracle for the iOS transport parity test. */ -public final class CfwTransportVectors { - public static void main(String[] args) { - CfwTransport transport = new CfwTransport(); - for (String line : args) { - String[] fields = line.split(":", -1); - if (fields[0].equals("reset")) { transport.reset(); continue; } - int id = Integer.parseInt(fields[0]), lenses = Integer.parseInt(fields[1]); - int maxWrite = Integer.parseInt(fields[2]); - byte[] payload = java.util.HexFormat.of().parseHex(fields[3]); - StringBuilder result = new StringBuilder(); - for (byte[] packet : transport.encode(payload, id, lenses, maxWrite + 3)) - result.append(java.util.HexFormat.of().formatHex(packet)).append(" "); - System.out.println(result.toString().trim()); - } - } -} diff --git a/tests/fixtures/cfw-java-golden.json b/tests/fixtures/cfw-java-golden.json new file mode 100644 index 00000000..8eb619d3 --- /dev/null +++ b/tests/fixtures/cfw-java-golden.json @@ -0,0 +1,7 @@ +[ + "d73e76bae77dd09f6af2f9483b8d24b7ebb79dca266ace5f062dea936c181219", + "60afd64152c40d6a0b4a70437d3636a36b41f690fe7fa43a44c1fff1accb0845", + "8f4ce275c048001ef30da8b9d93e63c15d3fb49bc643d3f5fd6908b0adaf2292", + "50a45b6816d4f0669d09958ef2dd32ab3d162b6959b6252a940d3ec1180bd80e", + "5e53d5665b33cd46cb868f8063cda22ee6cce4584e5e28123803e41642f5563f" +] diff --git a/tests/kotlin-build.test.cjs b/tests/kotlin-build.test.cjs new file mode 100644 index 00000000..07d4f8cf --- /dev/null +++ b/tests/kotlin-build.test.cjs @@ -0,0 +1,43 @@ +const test = require('node:test'); +const assert = require('node:assert/strict'); +const fs = require('node:fs'); +const os = require('node:os'); +const path = require('node:path'); +const { checkAndroidRuntime } = require('../scripts/kotlin-build.cjs'); + +test('Android preparation rejects a stale metadata generator but allows fresh and matching platforms', () => { + const root = fs.mkdtempSync(path.join(os.tmpdir(), 'faceclaw-kotlin-build-')); + try { + const installed = path.join(root, 'node_modules/@nativescript/android/framework/build-tools/android-metadata-generator.jar'); + const generated = path.join(root, 'platforms/android/build-tools/android-metadata-generator.jar'); + fs.mkdirSync(path.dirname(installed), { recursive: true }); + fs.writeFileSync(installed, 'current metadata generator'); + assert.doesNotThrow(() => checkAndroidRuntime(root)); + fs.mkdirSync(path.dirname(generated), { recursive: true }); + fs.writeFileSync(generated, 'old metadata generator'); + assert.throws(() => checkAndroidRuntime(root), /ns platform clean android/); + fs.copyFileSync(installed, generated); + assert.doesNotThrow(() => checkAndroidRuntime(root)); + } finally { + fs.rmSync(root, { recursive: true, force: true }); + } +}); + +test('every remaining Java source has an explicit Android boundary and every migration has one replacement', () => { + const root = path.resolve(__dirname, '..'); + const java = path.join(root, 'App_Resources/Android/src/main/java'); + const list = directory => fs.readdirSync(directory, { withFileTypes: true }).flatMap(entry => { + const file = path.join(directory, entry.name); + return entry.isDirectory() ? list(file) : file.endsWith('.java') ? [path.relative(java, file)] : []; + }); + const boundaries = require('../native/kotlin/android-java-boundaries.json'); + const retained = boundaries.flatMap(group => { assert.ok(group.reason.length > 20); return group.files; }); + assert.deepEqual(list(java).sort(), retained.sort()); + assert.equal(new Set(retained).size, retained.length); + const migrated = require('../native/kotlin/migrated-java-sources.json'); + assert.equal(new Set(migrated.map(entry => entry.java)).size, migrated.length); + for (const entry of migrated) { + assert.equal(fs.existsSync(path.join(java, entry.java)), false, entry.java); + assert.ok(fs.existsSync(path.join(root, 'native/kotlin', entry.kotlin)), entry.kotlin); + } +}); diff --git a/tests/kotlin/build.gradle.kts b/tests/kotlin/build.gradle.kts new file mode 100644 index 00000000..0c97093c --- /dev/null +++ b/tests/kotlin/build.gradle.kts @@ -0,0 +1,40 @@ +import org.jetbrains.kotlin.gradle.dsl.JvmTarget + +plugins { + kotlin("multiplatform") version "2.4.20" + id("com.android.kotlin.multiplatform.library") version "8.13.2" +} + +// Compile the production sources without building NativeScript or touching BLE. +kotlin { + android { + namespace = "com.faceclaw.protocoltests" + compileSdk = 35 + minSdk = 24 + withJava() + compilerOptions { jvmTarget.set(JvmTarget.JVM_17) } + withHostTestBuilder {}.configure {} + } + iosArm64() + iosSimulatorArm64() + sourceSets { + commonMain { kotlin.srcDir("../../native/kotlin/shared/src/commonMain/kotlin") } + androidMain { kotlin.srcDir("../../native/kotlin/shared/src/androidMain/kotlin") } + iosMain { kotlin.srcDir("../../native/kotlin/shared/src/iosMain/kotlin") } + commonTest.dependencies { implementation(kotlin("test")) } + } +} + +// The font is already shipped in the app; avoid copying megabytes into test fixtures. +val generateFixturePaths = tasks.register("generateFixturePaths") { + val output = layout.buildDirectory.file("generated/fixtures/com/faceclaw/app/FixturePaths.kt") + outputs.dir(layout.buildDirectory.dir("generated/fixtures")) + doLast { + val font = file("../../app/fonts/source-han-sans/SourceHanSansSC-Light-20.lvgl.bin").canonicalPath + output.get().asFile.apply { + parentFile.mkdirs() + writeText("package com.faceclaw.app\ninternal const val TEST_FONT_PATH = \"${font.replace("\\", "\\\\").replace("\"", "\\\"")}\"\n") + } + } +} +kotlin.sourceSets.commonTest { kotlin.srcDir(generateFixturePaths) } diff --git a/tests/kotlin/settings.gradle.kts b/tests/kotlin/settings.gradle.kts new file mode 100644 index 00000000..6c535290 --- /dev/null +++ b/tests/kotlin/settings.gradle.kts @@ -0,0 +1,3 @@ +pluginManagement { repositories { google(); mavenCentral(); gradlePluginPortal() } } +dependencyResolutionManagement { repositories { google(); mavenCentral() } } +rootProject.name = "FaceclawProtocolTests" diff --git a/tests/fixtures/CompassProtocolTest.java b/tests/kotlin/src/androidHostTest/java/com/faceclaw/app/CompassProtocolTest.java similarity index 100% rename from tests/fixtures/CompassProtocolTest.java rename to tests/kotlin/src/androidHostTest/java/com/faceclaw/app/CompassProtocolTest.java diff --git a/tests/fixtures/FaceclawGestureEventTest.java b/tests/kotlin/src/androidHostTest/java/com/faceclaw/app/FaceclawGestureEventTest.java similarity index 100% rename from tests/fixtures/FaceclawGestureEventTest.java rename to tests/kotlin/src/androidHostTest/java/com/faceclaw/app/FaceclawGestureEventTest.java diff --git a/tests/fixtures/RingBatteryProtocolTest.java b/tests/kotlin/src/androidHostTest/java/com/faceclaw/app/RingBatteryProtocolTest.java similarity index 100% rename from tests/fixtures/RingBatteryProtocolTest.java rename to tests/kotlin/src/androidHostTest/java/com/faceclaw/app/RingBatteryProtocolTest.java diff --git a/tests/fixtures/TextureCacheProtocolTest.java b/tests/kotlin/src/androidHostTest/java/com/faceclaw/app/TextureCacheProtocolTest.java similarity index 100% rename from tests/fixtures/TextureCacheProtocolTest.java rename to tests/kotlin/src/androidHostTest/java/com/faceclaw/app/TextureCacheProtocolTest.java diff --git a/tests/kotlin/src/androidHostTest/kotlin/com/faceclaw/app/AndroidProtocolTest.kt b/tests/kotlin/src/androidHostTest/kotlin/com/faceclaw/app/AndroidProtocolTest.kt new file mode 100644 index 00000000..2a48d43b --- /dev/null +++ b/tests/kotlin/src/androidHostTest/kotlin/com/faceclaw/app/AndroidProtocolTest.kt @@ -0,0 +1,117 @@ +package com.faceclaw.app + +import java.io.ByteArrayOutputStream +import java.util.Collections +import java.util.concurrent.Executors +import java.util.concurrent.TimeUnit +import java.util.zip.Inflater +import kotlin.test.* + +// Host tests have no Android clock; all other services use the production adapter. +internal actual fun testPlatform(): ProtocolPlatform = + object : ProtocolPlatform by AndroidProtocolPlatform { + override fun elapsedRealtimeMs() = System.nanoTime() / 1_000_000 + } + +internal actual fun inflateRecords(records: List): List { + val inflater = Inflater() + try { + return records.map { record -> + if (record[0].toInt() and CfwTransport.RESET_CONTEXT != 0) inflater.reset() + val body = record.copyOfRange(5, record.size) + if (record[0].toInt() and CfwTransport.COMPRESSED == 0) body + else { + inflater.setInput(body) + val out = ByteArrayOutputStream() + val buffer = ByteArray(4096) + do { + val count = inflater.inflate(buffer) + out.write(buffer, 0, count) + } while (!inflater.needsInput()) + out.toByteArray() + } + } + } finally { + inflater.end() + } +} + +class AndroidProtocolTest { + @Test + fun javaGoldenCorpus() { + // SHA-256 of packets emitted by the pre-migration Java implementation. + val raw = java.security.MessageDigest.getInstance("SHA-256") + val compressed = java.security.MessageDigest.getInstance("SHA-256") + val transport = CfwTransport(testPlatform()) + var state = 123456789 + try { + repeat(120) { i -> + val size = intArrayOf(0, 1, 4, 247, 248, 252, 4095, 4096, 8192, 65535)[i % 10] + val data = + ByteArray(size) { + state = state xor (state shl 13) + state = state xor (state ushr 17) + state = state xor (state shl 5) + state.toByte() + } + if (i % 3 == 0) data.fill((i % 7).toByte()) + val id = (i * 37) and 255 + val lenses = 1 + (i / 7) % 3 + val mtu = intArrayOf(23, 247, 512, 517)[i % 4] + if (i % 13 == 0) transport.reset() + CfwTransport.frame(data, id, lenses, mtu).forEach { raw.update(it) } + transport.encode(data, id, lenses, mtu).forEach { compressed.update(it) } + } + assertEquals( + "d0efdb99ac71763dd29b70fbd0021b80e1cfe514dfc8a60e2a8424892b16c9f5", + raw.digest().toHexString(), + ) + assertEquals( + "eb5ce0cc6e41b8e84f0d9455f98f3f666b20be0643c3756c5f7aa9d9a66085e2", + compressed.digest().toHexString(), + ) + } finally { + transport.close() + } + } + + @Test + fun writeModeMapping() { + assertEquals( + android.bluetooth.BluetoothGattCharacteristic.WRITE_TYPE_DEFAULT, + AndroidProtocolPlatform.writeType(GattWriteMode.WITH_RESPONSE), + ) + assertEquals( + android.bluetooth.BluetoothGattCharacteristic.WRITE_TYPE_NO_RESPONSE, + AndroidProtocolPlatform.writeType(ConnectionOptions.WRITE_MODE), + ) + } + + @Test + fun concurrentAllocationNeverDuplicatesAnInUseId() { + val pool = BleMagicPool(testPlatform()) + val inUse = Collections.synchronizedSet(mutableSetOf()) + val executor = Executors.newFixedThreadPool(8) + try { + val jobs = + List(8) { + executor.submit { + repeat(2000) { + val id = pool.allocate() + assertTrue(inUse.add(id)) + Thread.yield() + assertTrue(inUse.remove(id)) + pool.release(1, id, null, null) + } + } + } + jobs.forEach { it.get(30, TimeUnit.SECONDS) } + assertEquals(156, List(156) { pool.allocate() }.toSet().size) + } finally { + executor.shutdownNow() + } + } +} + +internal actual fun digest(bytes: ByteArray): String = + BinaryEncoding.bytesToHex(java.security.MessageDigest.getInstance("SHA-256").digest(bytes)) diff --git a/tests/kotlin/src/androidHostTest/kotlin/com/faceclaw/app/JavaCompatibilityTest.kt b/tests/kotlin/src/androidHostTest/kotlin/com/faceclaw/app/JavaCompatibilityTest.kt new file mode 100644 index 00000000..1edb969a --- /dev/null +++ b/tests/kotlin/src/androidHostTest/kotlin/com/faceclaw/app/JavaCompatibilityTest.kt @@ -0,0 +1,27 @@ +package com.faceclaw.app + +import kotlin.test.Test + +/** Existing wire fixtures also verify the Java API retained by the Kotlin port. */ +class JavaCompatibilityTest { + @Test fun compass() = CompassProtocolTest.main(emptyArray()) + + @Test fun ringBattery() = RingBatteryProtocolTest.main(emptyArray()) + + @Test fun gestures() = FaceclawGestureEventTest.main(emptyArray()) + + @Test fun textureCache() = TextureCacheProtocolTest.main(emptyArray()) +} + +class AndroidByteReaderTest { + @Test fun repeatedBridgeCrossingsHaveIndependentCursors() { + val buffer = java.nio.ByteBuffer.wrap(byteArrayOf(10, 20, 30)) + val first = AndroidByteReader(buffer) + kotlin.test.assertEquals(10, first.get().toInt()) + kotlin.test.assertEquals(0, buffer.position()) + val second = AndroidByteReader(buffer) + kotlin.test.assertEquals(3, second.remaining()) + kotlin.test.assertEquals(10, second.get().toInt()) + kotlin.test.assertEquals(20, first.get().toInt()) + } +} diff --git a/tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/AudioRecordingTest.kt b/tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/AudioRecordingTest.kt new file mode 100644 index 00000000..b3316cd9 --- /dev/null +++ b/tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/AudioRecordingTest.kt @@ -0,0 +1,44 @@ +package com.faceclaw.app + +import kotlin.test.* + +internal expect fun digest(bytes: ByteArray): String + +class AudioRecordingTest { + @Test + fun javaNoiseSuppressionGoldenAcrossChunksAndReset() { + val suppressor = FaceclawNoiseSuppressor(16000) + val output = ByteSink() + for (round in 0 until 80) { + val input = ByteArray(if (round % 7 == 0) 514 else 640) + for (i in 0 until input.size / 2) { + val value = ((round * 317 + i * 773) % 48000) - 24000 + input[i * 2] = value.toByte() + input[i * 2 + 1] = (value shr 8).toByte() + } + if (round == 41) suppressor.reset() + output.write(assertNotNull(suppressor.process(input))) + } + // SHA-256 from the original Java DSP, including warmup and irregular chunks. + assertEquals( + "4a7e86b70d61d683b17c7051dbd6666f5ea62427fdd7fdb1d4c9a1772a1eb8ef", + digest(output.toByteArray()), + ) + } + + @Test + fun javaGifGoldenIncludingDedupAndLzwCodeGrowth() { + val recorder = SharedGifScreenRecorder() + assertTrue(recorder.encode().isEmpty()) + for (round in 0 until 7) { + val pixels = ByteArray(33 * 17) { ((it * 73 + round * 117) % 256).toByte() } + recorder.addFrame(pixels, 33, 17, round * 133L) + recorder.addFrame(pixels, 33, 17, round * 133L + 10) + } + assertFalse(recorder.isOverflowed()) + assertEquals( + "8c5dcb98fa03653972f7f7d5ddaaacff323dd633578905bc252ebe21f9d82780", + digest(recorder.encode()), + ) + } +} diff --git a/tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/FontTest.kt b/tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/FontTest.kt new file mode 100644 index 00000000..922261b2 --- /dev/null +++ b/tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/FontTest.kt @@ -0,0 +1,22 @@ +package com.faceclaw.app + +import kotlin.test.* + +class FontTest { + @Test + fun bundledFontMatchesJavaMetricsAndGlyphs() { + assertContentEquals(byteArrayOf(25, 19), LvglFontFile.getMetrics(TEST_FONT_PATH)) + val vectors = + mapOf( + 0x25a6 to "b08ecb603fd059b0a00ba3088f18b79185c421e73049797cd3cb0828e1e5cd04", + 0x25c6 to "c176d5dcdb5f7e3a7220455528efde3760672c40cee39b422fc3f5ad20df66dd", + 0x4e2d to "9bde2c8f1ffcf7afc598f4d0350c9ff262484816aa0c9b46d31f0c3c09613003", + 0xff21 to "0074f96299a75b86912282416e47e0823790e091352aec852eff49b89b2e719d", + ) + vectors.forEach { (codePoint, expected) -> + assertEquals(expected, digest(LvglFontFile.getGlyph(TEST_FONT_PATH, codePoint))) + } + assertTrue(LvglFontFile.getGlyph(TEST_FONT_PATH, 0x10ffff).isEmpty()) + assertTrue(LvglFontFile.getMetrics("/nonexistent/faceclaw-font").isEmpty()) + } +} diff --git a/tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/ProtocolTest.kt b/tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/ProtocolTest.kt new file mode 100644 index 00000000..a2c006e6 --- /dev/null +++ b/tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/ProtocolTest.kt @@ -0,0 +1,283 @@ +package com.faceclaw.app + +import kotlin.random.Random +import kotlin.test.* + +internal expect fun testPlatform(): ProtocolPlatform + +internal expect fun inflateRecords(records: List): List + +internal fun record(packets: List): ByteArray = + packets.flatMap { it.slice(9 until it.size - 2) }.toByteArray() + +private fun hex(value: String) = value.chunked(2).map { it.toInt(16).toByte() }.toByteArray() + +private fun u16(bytes: ByteArray, offset: Int) = + (bytes[offset].toInt() and 255) or ((bytes[offset + 1].toInt() and 255) shl 8) + +class ProtocolTest { + @Test + fun javaGoldenPacketsAndCrc() { + assertEquals(0x29b1, CfwTransport.crc("123456789".encodeToByteArray())) + assertEquals(0xffff, CfwTransport.crc(byteArrayOf())) + // Captured from the Java implementation before migration, including sequence wrap. + val expected = + listOf( + "aa21ff0c0101f000830b0f0078c331323334862b", + "aa21000c0101f000033536373839616263648c7b", + "aa2101050101f000436566de70", + ) + val actual = CfwTransport.frame("123456789abcdef".encodeToByteArray(), 255, 3, 23) + assertEquals(expected.size, actual.size) + expected.zip(actual).forEach { (a, b) -> assertContentEquals(hex(a), b) } + } + + @Test + fun framingBoundariesAndValidation() { + for (size in listOf(0, 1, 247, 252, 253, 65535)) { + val data = ByteArray(size) { it.toByte() } + for (mtu in listOf(23, 247, 512, 517)) { + val packets = CfwTransport.frame(data, 255, 2, mtu) + packets.forEachIndexed { i, packet -> + assertTrue(packet.size <= mtu - 3) + assertEquals((255 + i) and 255, packet[2].toInt() and 255) + assertEquals(packet.size - 8, packet[3].toInt() and 255) + assertEquals( + 2 or (if (i == 0) 128 else 0) or (if (i == packets.lastIndex) 64 else 0), + packet[8].toInt() and 255, + ) + assertEquals( + CfwTransport.crc(packet.copyOfRange(8, packet.size - 2)), + u16(packet, packet.size - 2), + ) + } + val stream = record(packets) + assertEquals(size, u16(stream, 1)) + assertEquals(CfwTransport.crc(data), u16(stream, 3)) + assertContentEquals(data, stream.copyOfRange(5, stream.size)) + } + } + for (invalid in listOf(null, ByteArray(65536))) assertFailsWith< + IllegalArgumentException + > { + CfwTransport.frame(invalid, 0, 3, 23) + } + for (stream in listOf(-1, 256)) assertFailsWith { + CfwTransport.frame(byteArrayOf(), stream, 3, 23) + } + for (lens in listOf(0, 4)) assertFailsWith { + CfwTransport.frame(byteArrayOf(), 0, lens, 23) + } + for (mtu in listOf(22, 518)) assertFailsWith { + CfwTransport.frame(byteArrayOf(), 0, 3, mtu) + } + } + + @Test + fun streamingCompressionRoundTripsAndResets() { + val transport = CfwTransport(testPlatform()) + try { + val text = "shared history 👓 ".repeat(300).encodeToByteArray() + val inputs = listOf(text, text, byteArrayOf(), byteArrayOf(), text, text) + val records = inputs.mapIndexed { i, data -> + if (i == 5) transport.reset() + record(transport.encode(data, i, if (i < 4) 3 else 1, 247)) + } + assertTrue(records[1].size < records[0].size) + assertTrue(records[0][0].toInt() and CfwTransport.RESET_CONTEXT != 0) + assertEquals(0, records[1][0].toInt() and CfwTransport.RESET_CONTEXT) + assertTrue(records[4][0].toInt() and CfwTransport.RESET_CONTEXT != 0) + assertTrue(records[5][0].toInt() and CfwTransport.RESET_CONTEXT != 0) + inputs.zip(inflateRecords(records)).forEach { (a, b) -> assertContentEquals(a, b) } + transport.close() + transport.close() + val reopened = record(transport.encode(text, 10, 1, 512)) + assertTrue(reopened[0].toInt() and CfwTransport.RESET_CONTEXT != 0) + assertContentEquals(text, inflateRecords(listOf(reopened)).single()) + } finally { + transport.close() + } + } + + @Test + fun incompressibleMaximumFallsBackWithoutPoisoningHistory() { + val transport = CfwTransport(testPlatform()) + try { + val data = Random(42).nextBytes(65535) + val raw = record(transport.encode(data, 255, 3, 517)) + assertEquals(3 or CfwTransport.RESET_CONTEXT, raw[0].toInt()) + val next = record(transport.encode(data.copyOf(1000), 0, 3, 517)) + assertTrue(next[0].toInt() and CfwTransport.RESET_CONTEXT != 0) + val decoded = inflateRecords(listOf(raw, next)) + assertContentEquals(data, decoded[0]) + assertContentEquals(data.copyOf(1000), decoded[1]) + } finally { + transport.close() + } + } + + @Test + fun ackBatchesAndMalformedPackets() { + for (count in 1..4) { + val packet = ackPacket(count) + val acks = assertNotNull(CfwTransport.parseAcks(packet)) + assertEquals(count, acks.size) + acks.forEachIndexed { i, ack -> + assertFalse(ack.nack) + assertEquals(255 - i, ack.streamId) + assertEquals(0x1234 + i, ack.messageId) + assertEquals(2, ack.lens) + assertEquals(0x4567 + i, ack.size) + assertEquals(0xabcd + i, ack.checksum) + } + assertEquals(255, assertNotNull(CfwTransport.parseAck(packet)).streamId) + // Every bit of the payload (including ACK trailers and CRC) is protected. + for (i in 8 until packet.size) { + val corrupt = packet.copyOf() + corrupt[i] = (corrupt[i].toInt() xor 1).toByte() + assertNull(CfwTransport.parseAcks(corrupt)) + } + } + assertTrue(assertNotNull(CfwTransport.parseAck(ackPacket(1, 3))).nack) + assertNull(CfwTransport.parseAcks(ackPacket(2, 3))) + assertNull(CfwTransport.parseAcks(ackPacket(5))) + assertNull(CfwTransport.parseAcks(ackPacket(1, 2))) + for (index in listOf(0, 1, 3, 4, 5, 6, 7)) { + val corrupt = ackPacket(1) + corrupt[index] = (corrupt[index].toInt() xor 1).toByte() + assertNull(CfwTransport.parseAcks(corrupt)) + } + val wrongLens = ackPacket(1) + wrongLens[12] = 3 + sealAck(wrongLens) + assertNull(CfwTransport.parseAcks(wrongLens)) + for (size in 0..18) assertNull(CfwTransport.parseAcks(ByteArray(size))) + assertNull(CfwTransport.parseAcks(null)) + } + + @Test + fun ackMatchingAndReplay() { + val input = byteArrayOf(1, 2, 3) + val message = message(input = input) + input[0] = 99 + assertContentEquals(byteArrayOf(1, 2, 3), message.message) + fun ack( + lens: Int, + stream: Int = 100, + nack: Boolean = false, + size: Int = 3, + checksum: Int = message.cfwChecksum, + id: Int = 0, + ) = CfwTransport.Ack(nack, stream, id, lens, size, checksum) + assertFalse(message.acceptCfwAck(null)) + assertFalse(message.acceptCfwAck(ack(1, stream = 99))) + assertFalse(message.acceptCfwAck(ack(1, size = 4))) + assertFalse(message.acceptCfwAck(ack(1, checksum = 0))) + assertFalse(message.acceptCfwAck(ack(3))) + assertFalse(message.acceptCfwAck(ack(1, id = 1))) + assertEquals(0, message.cfwAckLenses) + assertFalse(message.acceptCfwAck(ack(1))) + assertFalse(message.acceptCfwAck(ack(1))) + assertTrue(message.acceptCfwAck(ack(2))) + assertFalse(message.acceptCfwAck(ack(1, nack = true, size = 0, checksum = 0))) + assertFalse(message.acceptCfwAck(ack(2))) + message.ackDeadlineAtMs = 500 + message.ackPayload = byteArrayOf(1) + message.prepareCfwReplay(101) + assertEquals(1, message.cfwRetries) + assertFalse(message.cfwRetryPending) + assertEquals(0, message.cfwAckLenses) + assertEquals(0L, message.ackDeadlineAtMs) + assertTrue(message.ackPayload.isEmpty()) + assertFalse(message.acceptCfwAck(ack(1))) + assertFalse(message.acceptCfwAck(ack(1, stream = 101))) + assertTrue(message.acceptCfwAck(ack(2, stream = 101))) + var callbacks = 0 + message.onAck = MessageCallback { callbacks++ } + message.onAck!!.run() + assertEquals(1, callbacks) + } + + @Test + fun orderedCompletionAndWholeWindowRecovery() { + val head = message() + val tail = message() + val stock = message(sid = 1) + val window = listOf(stock, head, tail) + tail.cfwAckLenses = 3 + assertNull(CfwMessageWindow.acknowledgedHead(window)) + assertTrue(CfwMessageWindow.replayWindow(window, 100).isEmpty()) + head.ackDeadlineAtMs = 100 + assertTrue(CfwMessageWindow.replayWindow(window, 99).isEmpty()) + assertEquals(listOf(head, tail), CfwMessageWindow.replayWindow(window, 100)) + head.cfwAckLenses = 3 + assertSame(head, CfwMessageWindow.acknowledgedHead(window)) + assertTrue(CfwMessageWindow.replayWindow(window, 100).isEmpty()) + tail.cfwRetryPending = true + assertEquals(listOf(head, tail), CfwMessageWindow.replayWindow(window, 100)) + head.cfwRetryPending = true + assertNull(CfwMessageWindow.acknowledgedHead(window)) + } + + @Test + fun magicPoolExhaustionLruAndReleaseRecords() { + var now = 123L + val platform = + object : ProtocolPlatform by testPlatform() { + override fun elapsedRealtimeMs() = now + } + val pool = BleMagicPool(platform) + assertEquals((100..255).toList(), List(156) { pool.allocate() }) + assertFailsWith { pool.allocate() } + pool.release(1, 101, "first", "ack") + pool.release(1, 100, null, null) + now = 456 + pool.release(2, 101, "other", "timeout") // duplicate release must not allocate twice + assertEquals(101, pool.allocate()) + assertEquals(100, pool.allocate()) + assertFailsWith { pool.allocate() } + val first = assertNotNull(pool.getReleaseRecord(1, 101)) + assertEquals(123L, first.releasedAtMs) + assertEquals("first", first.label) + assertEquals(456L, assertNotNull(pool.getReleaseRecord(2, 101)).releasedAtMs) + assertEquals("", assertNotNull(pool.getReleaseRecord(1, 100)).reason) + for (invalid in listOf(-1, 99, 256)) { + pool.release(1, invalid, "bad", "bad") + assertNull(pool.getReleaseRecord(1, invalid)) + } + } +} + +private fun message(sid: Int = CfwTransport.SID, input: ByteArray = byteArrayOf(1, 2, 3)) = + OutboundMessage("test", "test", sid, 0, 100, input, 500, 0, false) + +private fun ackPacket(count: Int, kind: Int = 1): ByteArray { + val packet = ByteArray(19 + (count - 1) * 7) + packet[0] = 0xaa.toByte() + packet[1] = 0x12 + packet[3] = (packet.size - 8).toByte() + packet[4] = 1 + packet[5] = 1 + packet[6] = 0xf0.toByte() + packet[8] = kind.toByte() + packet[12] = 2 + fun put16(offset: Int, value: Int) { + packet[offset] = value.toByte() + packet[offset + 1] = (value ushr 8).toByte() + } + for (i in 0 until count) { + val offset = if (i == 0) 9 else 17 + (i - 1) * 7 + packet[offset] = (255 - i).toByte() + put16(offset + 1, 0x1234 + i) + put16(offset + (if (i == 0) 4 else 3), 0x4567 + i) + put16(offset + (if (i == 0) 6 else 5), 0xabcd + i) + } + sealAck(packet) + return packet +} + +private fun sealAck(packet: ByteArray) { + val crc = CfwTransport.crc(packet.copyOfRange(8, packet.size - 2)) + packet[packet.size - 2] = crc.toByte() + packet[packet.size - 1] = (crc ushr 8).toByte() +} diff --git a/tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/SharedGraphicsTest.kt b/tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/SharedGraphicsTest.kt new file mode 100644 index 00000000..d2ef7b4a --- /dev/null +++ b/tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/SharedGraphicsTest.kt @@ -0,0 +1,136 @@ +package com.faceclaw.app + +import kotlin.test.* + +class SharedGraphicsTest { + private fun hex(value: String) = value.chunked(2).map { it.toInt(16).toByte() }.toByteArray() + + @Test + fun androidWireVectorsAndGrayQuantization() { + val vectors = + listOf( + BleProtocol.buildAuthenticationRequest(101) to "080410651a0408011004", + BleProtocol.PRELUDE_F5872_PAYLOAD to "0802109c01220a1a081206120408001000", + BleProtocol.buildCreateInputPage(102) to + "080010661a2308011a1c0800100018c00420a0024801520964617368626f617264580162012028904e", + BleProtocol.buildHeartbeat(103) to "080c106772020800", + BleProtocol.buildSettingsQuery(104) to "0802106822020801", + BleProtocol.buildShutdown(105, 1) to "080910695a020801", + BleProtocol.buildFaceclawWakeControl(5, 0) to "08011000aa0606464301050000", + ) + vectors.forEach { (actual, expected) -> assertContentEquals(hex(expected), actual) } + val packed = + BmpUtil.pack4bppFromGray8( + byteArrayOf(0, 1, 7, 8, 15, 16, 23, 24, 127, -128, -9, -1), + 3, + 4, + ) + assertContentEquals(hex("0000111012808ff0"), packed) + assertContentEquals(hex("40311011121810182f10"), BleImageOptimizer.rleEncode(packed)) + assertContentEquals( + hex("aa21400c01018000080410651a04080110041024"), + BleProtocol.framePb(vectors.first().first, 128, 0, 64).single(), + ) + } + + @Test + fun splitStreamsExpiryAndCorruption() { + val payload = + BleProtocol.encodeVarintField(1, 3) + + BleProtocol.encodeVarintField(2, 110) + + BleProtocol.encodeBytesField(8, ByteArray(3900) { 55 }) + val frames = BleProtocol.framePb(payload, 224, 32, 17, 185) + assertTrue(frames.all { it.size <= 185 }) + val stream = frames.reduce { a, b -> a + b } + val receiver = MessageReceiver() + assertTrue(receiver.receive("L", stream.copyOf(7), 0).isEmpty()) + val message = receiver.receive("L", stream.copyOfRange(7, stream.size), 1).single() + assertContentEquals(payload, message.payload) + assertEquals(3, message.command) + assertEquals(110, message.magic) + stream[stream.lastIndex] = (stream.last().toInt() xor 1).toByte() + assertTrue(receiver.receive("L", stream, 2).isEmpty()) + receiver.receive("L", frames.first(), 10) + assertTrue(receiver.receive("R", frames.drop(1).reduce { a, b -> a + b }, 11).isEmpty()) + assertTrue(receiver.receive("L", frames.drop(1).reduce { a, b -> a + b }, 5011).isEmpty()) + assertFailsWith { BleProtocol.framePb(payload, 1, 0, 1, 10) } + assertFailsWith { BleProtocol.framePb(ByteArray(60000), 1, 0, 1) } + val invalid = BleProtocol.framePb(byteArrayOf(0x1a, 0x7f), 224, 0, 2).single() + assertTrue(receiver.receive("L", invalid, 6000).isEmpty()) + } + + @Test + fun eventDecodeAcceptsValidatedPayloadWithoutStrippingAgain() { + val event = BleProtocol.encodeVarintField(1, 12) + BleProtocol.encodeVarintField(2, 2) + val payload = BleProtocol.encodeBytesField(13, BleProtocol.encodeBytesField(3, event)) + val received = + MessageReceiver() + .receive("L", BleProtocol.framePb(payload, 224, 1, 1).single(), 0) + .single() + val decoded = assertNotNull(G2Event.decodePayload(received.sid, received.payload)) + assertEquals("sys-event", decoded.kind) + assertEquals(12, decoded.eventType) + assertEquals(2, decoded.eventSource) + } + + @Test + fun retainedCompositionClippingDimmingAndBlanking() { + val c = SurfaceCompositor() + c.configureScreen(3, 2) + c.configureSurface("app", 0, 0, 3, 2, 0, 0) + c.submitSurface("app", ArrayByteReader(ByteArray(6) { 200.toByte() }), 0, 0, 3, 2, "1") + c.configureSurface("shell", 0, 0, 3, 2, 1, 1) + c.submitSurface("shell", ArrayByteReader(byteArrayOf(0, 1, -1, 0, 0, 0)), 0, 0, 3, 2, "2") + c.setUnderlayDim(1, 128) + assertContentEquals(byteArrayOf(100, 1, -1, 100, 100, 100), c.composite().gray) + c.setSurfaceVisible("shell", false) + assertContentEquals(ByteArray(6) { 100 }, c.composite().gray) + c.configureSurface("opaque", 1, 0, 1, 2, 2, 0) + c.submitSurface("opaque", ArrayByteReader(byteArrayOf(0, 0)), 0, 0, 1, 2, "3") + assertContentEquals(byteArrayOf(100, 0, 100, 100, 0, 100), c.composite().gray) + c.setBlanked(true) + assertContentEquals(ByteArray(6), c.composite().gray) + c.setBlanked(false) + c.removeSurface("opaque") + c.configureSurface("app", -1, 0, 3, 2, 0, 0) + c.setUnderlayDim(0, 256) + assertContentEquals(byteArrayOf(-56, -56, 0, -56, -56, 0), c.composite().gray) + } + + @Test + fun pngChunksAndPixels() { + val png = SharedScreenshots.encode4BitGrayPng(byteArrayOf(0, 16, -1, 32, 48, 64), 3, 2) + assertContentEquals(hex("89504e470d0a1a0a"), png.copyOf(8)) + fun intAt(offset: Int): Int = + (0..3).fold(0) { n, i -> (n shl 8) or (png[offset + i].toInt() and 255) } + var offset = 8 + val types = mutableListOf() + var compressed = ByteArray(0) + while (offset < png.size) { + val size = intAt(offset) + val type = png.copyOfRange(offset + 4, offset + 8).decodeToString() + types.add(type) + if (type == "IHDR") { + assertEquals(3, intAt(offset + 8)) + assertEquals(2, intAt(offset + 12)) + assertEquals(4, png[offset + 16].toInt()) + assertEquals(0, png[offset + 17].toInt()) + } + if (type == "IDAT") compressed += png.copyOfRange(offset + 8, offset + 8 + size) + offset += size + 12 + } + assertEquals(listOf("IHDR", "IDAT", "IEND"), types) + assertContentEquals(hex("0001f0002340"), inflateData(compressed, 6)) + } + + @Test + fun wavHeaderAndHex() { + assertEquals("007f80ff", BinaryEncoding.bytesToHex(byteArrayOf(0, 127, -128, -1))) + assertContentEquals( + hex( + "524946462804000057415645666d74201000000001000100803e0000007d0000020010006461746104040000" + ), + BinaryEncoding.wavHeader(1028, 16000, 1), + ) + } +} diff --git a/tests/kotlin/src/iosTest/kotlin/com/faceclaw/app/IosNativeApiTest.kt b/tests/kotlin/src/iosTest/kotlin/com/faceclaw/app/IosNativeApiTest.kt new file mode 100644 index 00000000..2d0f0191 --- /dev/null +++ b/tests/kotlin/src/iosTest/kotlin/com/faceclaw/app/IosNativeApiTest.kt @@ -0,0 +1,38 @@ +package com.faceclaw.app + +import kotlin.test.* + +class IosNativeApiTest { + @Test + fun binaryFacadeRoundTripsAndSlices() { + val bytes = byteArrayOf(0, -1, 2, -128) + assertContentEquals(bytes, bytes.data().byteArray()) + assertTrue(byteArrayOf().data().byteArray().isEmpty()) + val reader = IosByteReader(bytes.data()) + assertEquals(0, reader.get().toInt()) + val target = ByteArray(5) + reader.get(target, 1, 3) + assertContentEquals(byteArrayOf(0, -1, 2, -128, 0), target) + assertEquals(0, reader.remaining()) + val protocol = IosProtocol() + val auth = protocol.authentication(101) + val frames = protocol.frame(auth, 128, 0, 64, 185) + val result = IosMessageReceiver().receive("L", frames.single(), 0).single() + assertEquals(101, result.magic) + assertContentEquals(auth.byteArray(), result.payload.byteArray()) + } + + @Test + fun nativeCompositorClipsPartialUpdatesBeforeCoalescing() { + val compositor = IosSurfaceCompositor(3, 2) + compositor.configure("app", 0, 0, 3, 2, 0, false) + compositor.submit("app", byteArrayOf(10, 20, 30, 40, 50, 60).data(), -1, 0, 3, 2) + assertContentEquals(byteArrayOf(20, 30, 0, 50, 60, 0), compositor.composite().byteArray()) + compositor.submit("app", byteArrayOf(99).data(), 2, 1, 1, 1) + assertContentEquals(byteArrayOf(20, 30, 0, 50, 60, 99), compositor.composite().byteArray()) + compositor.blank(true) + assertContentEquals(ByteArray(6), compositor.composite().byteArray()) + compositor.blank(false) + assertEquals(99, compositor.composite().byteArray().last().toInt()) + } +} diff --git a/tests/kotlin/src/iosTest/kotlin/com/faceclaw/app/IosProtocolTest.kt b/tests/kotlin/src/iosTest/kotlin/com/faceclaw/app/IosProtocolTest.kt new file mode 100644 index 00000000..0afc74d4 --- /dev/null +++ b/tests/kotlin/src/iosTest/kotlin/com/faceclaw/app/IosProtocolTest.kt @@ -0,0 +1,81 @@ +@file:OptIn(kotlinx.cinterop.ExperimentalForeignApi::class) + +package com.faceclaw.app + +import kotlin.test.* +import kotlinx.cinterop.* +import platform.CoreBluetooth.* +import platform.posix.memset +import platform.zlib.* + +internal actual fun testPlatform(): ProtocolPlatform = IosProtocolPlatform + +internal actual fun inflateRecords(records: List): List = memScoped { + val stream = alloc() + memset(stream.ptr, 0, sizeOf().convert()) + check(inflateInit(stream.ptr) == Z_OK) + try { + records.map { record -> + if (record[0].toInt() and CfwTransport.RESET_CONTEXT != 0) + check(inflateReset(stream.ptr) == Z_OK) + val body = record.copyOfRange(5, record.size) + if (record[0].toInt() and CfwTransport.COMPRESSED == 0) body + else { + val output = mutableListOf() + val buffer = ByteArray(4096) + body.usePinned { input -> + stream.next_in = input.addressOf(0).reinterpret() + stream.avail_in = body.size.toUInt() + buffer.usePinned { destination -> + do { + stream.next_out = destination.addressOf(0).reinterpret() + stream.avail_out = buffer.size.toUInt() + val status = inflate(stream.ptr, Z_SYNC_FLUSH) + check(status == Z_OK || status == Z_BUF_ERROR) + output.addAll(buffer.take(buffer.size - stream.avail_out.toInt())) + } while (stream.avail_in > 0u || stream.avail_out == 0u) + } + } + stream.next_in = null + stream.next_out = null + output.toByteArray() + } + } + } finally { + inflateEnd(stream.ptr) + } +} + +class IosProtocolTest { + @Test + fun platformClockAndWriteModes() { + val before = IosProtocolPlatform.elapsedRealtimeMs() + assertTrue(before > 0) + assertTrue(IosProtocolPlatform.elapsedRealtimeMs() >= before) + assertEquals( + CBCharacteristicWriteWithResponse, + IosProtocolPlatform.writeType(GattWriteMode.WITH_RESPONSE), + ) + assertEquals( + CBCharacteristicWriteWithoutResponse, + IosProtocolPlatform.writeType(ConnectionOptions.WRITE_MODE), + ) + } +} + +internal actual fun digest(bytes: ByteArray): String { + val result = ByteArray(32) + result.usePinned { output -> + if (bytes.isEmpty()) + platform.CoreCrypto.CC_SHA256(null, 0u, output.addressOf(0).reinterpret()) + else + bytes.usePinned { input -> + platform.CoreCrypto.CC_SHA256( + input.addressOf(0), + bytes.size.toUInt(), + output.addressOf(0).reinterpret(), + ) + } + } + return BinaryEncoding.bytesToHex(result) +} diff --git a/tests/ring-battery-protocol.test.cjs b/tests/ring-battery-protocol.test.cjs deleted file mode 100644 index eebaea03..00000000 --- a/tests/ring-battery-protocol.test.cjs +++ /dev/null @@ -1,19 +0,0 @@ -const test = require('node:test'); -const fs = require('node:fs'); -const os = require('node:os'); -const path = require('node:path'); -const { execFileSync } = require('node:child_process'); - -test('ring battery decodes valid, unavailable, legacy, and malformed reports', () => { - const directory = fs.mkdtempSync(path.join(os.tmpdir(), 'faceclaw-ring-java-')); - const javaBin = (name) => process.env.JAVA_HOME ? path.join(process.env.JAVA_HOME, 'bin', name) : name; - try { - execFileSync(javaBin('javac'), ['-d', directory, - path.join(__dirname, '../App_Resources/Android/src/main/java/com/faceclaw/app/g2protocol/BleProtocol.java'), - path.join(__dirname, '../App_Resources/Android/src/main/java/com/faceclaw/app/util/CollectionUtils.java'), - path.join(__dirname, 'fixtures/RingBatteryProtocolTest.java')], { stdio: 'pipe' }); - execFileSync(javaBin('java'), ['-ea', '-cp', directory, 'com.faceclaw.app.RingBatteryProtocolTest'], { stdio: 'pipe' }); - } finally { - fs.rmSync(directory, { recursive: true, force: true }); - } -}); diff --git a/tests/texture-cache-protocol.test.cjs b/tests/texture-cache-protocol.test.cjs deleted file mode 100644 index dc397251..00000000 --- a/tests/texture-cache-protocol.test.cjs +++ /dev/null @@ -1,23 +0,0 @@ -const test = require('node:test'); -const fs = require('node:fs'); -const os = require('node:os'); -const path = require('node:path'); -const { execFileSync } = require('node:child_process'); - -test('256 KiB cache uploads and planner draws preserve wide image and glyph offsets', () => { - const directory = fs.mkdtempSync(path.join(os.tmpdir(), 'faceclaw-texture-java-')); - const javaBin = (name) => process.env.JAVA_HOME ? path.join(process.env.JAVA_HOME, 'bin', name) : name; - const root = path.join(__dirname, '../App_Resources/Android/src/main/java/com/faceclaw/app'); - try { - const clock = path.join(directory, 'SystemClock.java'); - const log = path.join(directory, 'Log.java'); - fs.writeFileSync(clock, 'package android.os; public class SystemClock { public static long elapsedRealtime() { return 0; } }'); - fs.writeFileSync(log, 'package android.util; public class Log { public static int i(String tag, String msg) { return 0; } }'); - const sources = ['GlyphAtlas.java', 'ImageAtlas.java', 'FwGlyphAtlas.java', 'SurfaceCompositor.java', - 'util/BmpUtil.java', 'util/CollectionUtils.java', 'g2protocol/BleProtocol.java', - 'g2protocol/BleImageOptimizer.java', 'g2protocol/TextureCacheState.java', 'g2protocol/TexturePlanner.java']; - execFileSync(javaBin('javac'), ['-d', directory, ...sources.map(file => path.join(root, file)), - clock, log, path.join(__dirname, 'fixtures/TextureCacheProtocolTest.java')], { stdio: 'pipe' }); - execFileSync(javaBin('java'), ['-ea', '-cp', directory, 'com.faceclaw.app.TextureCacheProtocolTest'], { stdio: 'pipe' }); - } finally { fs.rmSync(directory, { recursive: true, force: true }); } -}); From 5ae2c245c622b668caae5e9e39ddefa8e20cf1d3 Mon Sep 17 00:00:00 2001 From: James Babcock Date: Fri, 18 Sep 2026 23:16:22 -0700 Subject: [PATCH 21/99] Nightscout works on iOS --- app/apps/nightscout/nightscout-app.ts | 1 + app/g2/ios-preview-controller.ts | 19 ++++++-- app/graphics/surface-compositor.ios.ts | 7 ++- app/native/nightscout-bridge.ts | 4 +- tests/ios-app-host.test.cjs | 60 +++++++++++++++++++++++++- tests/ios-glanceboard.test.cjs | 4 +- tests/nightscout.test.cjs | 27 ++++++++++++ 7 files changed, 114 insertions(+), 8 deletions(-) diff --git a/app/apps/nightscout/nightscout-app.ts b/app/apps/nightscout/nightscout-app.ts index b2fbdb00..2f6c536e 100644 --- a/app/apps/nightscout/nightscout-app.ts +++ b/app/apps/nightscout/nightscout-app.ts @@ -62,6 +62,7 @@ export function createNightscoutAppWindow(options: InProcessAppOptions): InProce submitFrame: options.submitFrame, setSurfaceVisible: options.setSurfaceVisible, removeSurface: options.removeSurface, + reconfigureSurface: options.reconfigureSurface, onClosed: () => { windowRenders.delete(render); syncNightscout(); diff --git a/app/g2/ios-preview-controller.ts b/app/g2/ios-preview-controller.ts index 37106104..566eeed8 100644 --- a/app/g2/ios-preview-controller.ts +++ b/app/g2/ios-preview-controller.ts @@ -1,6 +1,7 @@ import { Dialogs, File, knownFolders, path, type ImageSource } from '@nativescript/core' import { iosBluetooth } from '../native/ios-bluetooth' import { iosVoiceInput } from '../native/ios-voice-input' +import { nightscoutBridge } from '../native/nightscout-bridge' import { GlassesSession, type SessionState } from './glasses-session' import { GlanceHost, type GlanceDisplay } from './glance-host' import { OsEventTypeList } from './events' @@ -11,7 +12,7 @@ import { ALL_APPS } from '../apps/all-apps' import type { AppContext, AppDefinition, AppLaunchParams } from '../apps/app-definition' import { WorkerAppHost } from '../ui/shell/worker-window' import { createInProcessWindow, YieldAtRootLayer, type InProcessAppOptions, type InProcessWindow } from '../ui/shell/in-process-window' -import { getStringSettingById } from '../ui/dashboard-settings' +import { getStringSettingById, nightscoutSiteUrlSetting, nightscoutApiTokenSetting } from '../ui/dashboard-settings' import { readPhoneBatteryState } from '../native/phone-battery' import { iosAppUnavailableReason } from '../apps/ios-availability' import { SurfaceCompositor } from '../graphics/surface-compositor' @@ -152,6 +153,7 @@ export class IosPreviewController { this.runtimeRunning = running for (const window of shell.getWindows()) window.setScreenOn?.(running && shell.isScreenOn()) if (!running) { + void nightscoutBridge.stop().catch(error => this.fail(error)) this.glance.dismiss() this.compositor.setScreenBlanked(!shell.isScreenOn()) this.offSettings?.(); this.offSettings = null @@ -163,6 +165,7 @@ export class IosPreviewController { return } UIDevice.currentDevice.batteryMonitoringEnabled = true + void nightscoutBridge.start().catch(error => this.fail(error)) for (const name of [UIDeviceBatteryLevelDidChangeNotification, UIDeviceBatteryStateDidChangeNotification]) { this.batteryObservers.push(NSNotificationCenter.defaultCenter.addObserverForNameObjectQueueUsingBlock(name, null, NSOperationQueue.mainQueue, () => this.requestShellRender())) } @@ -307,15 +310,20 @@ export class IosPreviewController { create: (options: InProcessAppOptions) => InProcessWindow): Promise { const existing = this.inProcessApps.get(windowId) if (existing) { shell.focusWindow(windowId); existing.requestRender(); this.requestShellRender(); return } + // Apps can request a render while their factory runs (Nightscout's tray + // subscription does). The surface only exists once the factory returns. + // The explicit render below supplies a fresh frame after configuration. + let surfaceReady = false const app = create({ - actions: this.actions, submitFrame: planes => this.submit(surfaceId, planes), + actions: this.actions, submitFrame: planes => surfaceReady ? this.submit(surfaceId, planes) : Promise.resolve(), setSurfaceVisible: visible => { this.compositor.setSurfaceVisible(surfaceId, visible); this.scheduleFrame() }, - removeSurface: () => { this.compositor.removeSurface(surfaceId); this.scheduleFrame() }, + removeSurface: () => { surfaceReady = false; this.compositor.removeSurface(surfaceId); this.scheduleFrame() }, reconfigureSurface: () => { const window = shell.getWindows().find(w => w.windowId === windowId); if (window) this.configureWindow(window); this.requestShellRender() }, onClosed: () => { this.inProcessApps.delete(windowId) }, }) this.inProcessApps.set(windowId, app) this.configureWindow(app.window) + surfaceReady = true shell.registerWindow(app.window); shell.focusWindow(windowId) app.requestRender(); this.requestShellRender() } @@ -419,6 +427,9 @@ export class IosPreviewController { private async editSetting(setting: { editorTitle: string; get(): string; set(value: string): void }): Promise { if (!this.active) { this.logBluetooth('Editing text settings requires opening Faceclaw on the phone'); return } const result = await Dialogs.prompt({ title: setting.editorTitle, defaultText: setting.get(), okButtonText: 'Save', cancelButtonText: 'Cancel' }) - if (result.result) setting.set(result.text) + if (result.result) { + setting.set(result.text) + if (setting === nightscoutSiteUrlSetting || setting === nightscoutApiTokenSetting) await nightscoutBridge.refreshNow() + } } } diff --git a/app/graphics/surface-compositor.ios.ts b/app/graphics/surface-compositor.ios.ts index 8cb04f50..30fc81f7 100644 --- a/app/graphics/surface-compositor.ios.ts +++ b/app/graphics/surface-compositor.ios.ts @@ -5,6 +5,7 @@ declare const FaceclawKitIosSurfaceCompositor: any /** Retained pixels, clipping, layers and composition live in shared Kotlin. */ export class SurfaceCompositor { private native: any + private readonly surfaces = new Set() constructor(readonly width: number, readonly height: number) { if (!Number.isInteger(width) || !Number.isInteger(height) || width <= 0 || height <= 0) throw new Error('Invalid compositor size') this.native = FaceclawKitIosSurfaceCompositor.alloc().initWithWidthHeight(width, height) @@ -13,8 +14,9 @@ export class SurfaceCompositor { if (![options.x, options.y, options.width, options.height, options.zOrder].every(Number.isInteger) || options.width <= 0 || options.height <= 0) throw new Error('Invalid surface geometry') this.native.configureIdXYWidthHeightZOrderTransparent(id, options.x, options.y, options.width, options.height, options.zOrder, options.transparency === 'color-key') + this.surfaces.add(id) } - removeSurface(id: string): void { this.native.removeId(id) } + removeSurface(id: string): void { this.native.removeId(id); this.surfaces.delete(id) } setSurfaceVisible(id: string, visible: boolean): void { this.native.visibleIdVisible(id, visible) } setUnderlayDim(belowZOrder: number, factor: number): void { if (!Number.isFinite(factor)) throw new Error('Invalid dim factor') @@ -22,6 +24,9 @@ export class SurfaceCompositor { } setScreenBlanked(blanked: boolean): void { this.native.blankBlanked(blanked) } submitSurfaceFrame(id: string, pixels: Uint8Array, rect: SurfaceRect): void { + // Keep lifecycle errors catchable in JS; an undeclared Kotlin exception + // crossing the Objective-C boundary terminates the process. + if (!this.surfaces.has(id)) throw new Error(`Unknown surface: ${id}`) if (![rect.x, rect.y, rect.width, rect.height].every(Number.isInteger) || rect.width <= 0 || rect.height <= 0 || pixels.length !== rect.width * rect.height) throw new Error('Invalid frame buffer or rectangle') this.native.submitIdDataXYWidthHeight(id, toData(pixels), rect.x, rect.y, rect.width, rect.height) diff --git a/app/native/nightscout-bridge.ts b/app/native/nightscout-bridge.ts index 5da6237d..646b6622 100644 --- a/app/native/nightscout-bridge.ts +++ b/app/native/nightscout-bridge.ts @@ -167,10 +167,12 @@ export class NightscoutBridge { await this.refreshNow(); return; } - await this.refreshNow(); + // Register polling before awaiting HTTP so stop() during the first fetch + // cannot leave a timer behind, and concurrent starts share one timer. this.refreshHandle = setInterval(() => { void this.refreshNow(); }, NIGHTSCOUT_REFRESH_MS); + await this.refreshNow(); } async stop(): Promise { diff --git a/tests/ios-app-host.test.cjs b/tests/ios-app-host.test.cjs index 5a180c9b..2d4b702c 100644 --- a/tests/ios-app-host.test.cjs +++ b/tests/ios-app-host.test.cjs @@ -72,7 +72,7 @@ test('settings-driven repaint runs after font cache invalidation, regardless of test('background glasses input still composites frames; phone resume preserves the session; explicit stop stays stopped', async () => { const tasks = new Map(), screenStates = [], inputs = [], frames = [], previews = [], states = []; - let nextTask = 0, starts = 0, stops = 0, session; + let nextTask = 0, starts = 0, stops = 0, pollStarts = 0, pollStops = 0, session; const window = { windowId: 'launcher', surfaceId: 'launcher', appId: 'launcher', title: 'Apps', setScreenOn: on => screenStates.push(on), requestRender() {} }; const shell = { configure() {}, registerWindow() {}, wake() {}, focusWindow() {}, @@ -92,6 +92,7 @@ test('background glasses input still composites frames; phone resume preserves t '@nativescript/core': { File: { fromPath: () => ({ writeTextSync() {} }) }, knownFolders: { documents: () => ({ path: '/tmp' }) }, path }, '../native/ios-voice-input': { iosVoiceInput: { handleSessionEnded() {} } }, '../native/ios-bluetooth': { iosBluetooth: () => ({}) }, './glasses-session': { GlassesSession: Session }, + '../native/nightscout-bridge': { nightscoutBridge: { async start() { pollStarts++; }, async stop() { pollStops++; } } }, './glance-host': { GlanceHost: class { dismiss() {} isVisible() { return false; } } }, './device-addresses': { loadDeviceAddresses: () => ({}) }, './ios-peripheral-identity': { deviceAddressError: () => null }, '../apps/launcher/launcher-app': { createLauncherWindow: () => window, LAUNCHER_SURFACE_ID: 'launcher' }, @@ -122,6 +123,7 @@ test('background glasses input still composites frames; phone resume preserves t const previewCount = previews.length, stateCount = states.length; controller.pause(); controller.pause(); // NativeScript also unloads its root page on background entry. assert.equal(stops, 0); assert.ok(screenStates.every(Boolean)); + assert.equal(pollStarts, 1); assert.equal(pollStops, 0, 'connected glasses keep Nightscout polling in background'); session.onInput({ eventType: 3, eventSource: 1 }); await controller.inputQueue; flush(); assert.equal(inputs.length, 1); assert.ok(frames.length >= 2); @@ -130,11 +132,13 @@ test('background glasses input still composites frames; phone resume preserves t assert.equal(starts, 1); assert.ok(previews.length > previewCount); controller.pause(); await controller.disconnect(); flush(); assert.equal(stops, 1); assert.equal(screenStates.at(-1), false); + assert.equal(pollStops, 1); const frameCount = frames.length; session.onInput({ eventType: 3, eventSource: 1 }); await controller.inputQueue; flush(); assert.equal(inputs.length, 1); assert.equal(frames.length, frameCount); controller.resume(); flush(); assert.equal(starts, 1); assert.equal(controller.connectionState.phase, 'disconnected'); + assert.equal(pollStarts, 2, 'resuming the phone restarts Nightscout polling'); }); test('iOS bandwidth footer toggles live, polls only in foreground and resets its rate window on resume', () => { @@ -182,3 +186,57 @@ test('iOS bandwidth footer toggles live, polls only in foreground and resets its enabled = false; for (const fn of settingListeners) fn(); assert.equal(footer.visibility, 'collapse'); assert.equal(intervals.size, 0); page.events.get('unloaded')(); assert.equal(appEvents.size, 0); assert.equal(settingListeners.size, 0); }); + +test('iOS configures an in-process surface before submitting constructor-triggered frames', async () => { + const submitted = [], surfaces = new Set(); + const shell = { getWindows: () => [], configure() {}, registerWindow() {}, focusWindow() {}, foregroundWindow: () => null }; + const api = load('app/g2/ios-preview-controller.ts', { + require: name => ({ + '../ui/shell/shell': { shell }, + '../ui/shell/geometry': { appViewportRect: () => ({ x: 0, y: 0, width: 2, height: 1 }) }, + '../graphics/plane': { flattenPlanes: planes => planes[0] }, + })[name] ?? {}, + console, + }); + // Exercise the real launch method with a strict compositor boundary. App + // construction paints synchronously, as Nightscout's tray subscription does. + const controller = Object.create(api.IosPreviewController.prototype); + controller.inProcessApps = new Map(); + controller.requestShellRender = () => {}; + controller.scheduleFrame = () => {}; + controller.compositor = { + configureSurface(id) { surfaces.add(id); }, setSurfaceVisible() {}, + removeSurface(id) { surfaces.delete(id); }, + submitSurfaceFrame(id, pixels) { assert.ok(surfaces.has(id), `unconfigured ${id}`); submitted.push([...pixels]); }, + }; + let plumbing, early; + const fresh = [{ pixels: new Uint8Array([30, 40]), width: 2, height: 1 }]; + await controller.launchInProcessApp('nightscout', 'window:nightscout', options => { + plumbing = options; + early = options.submitFrame([{ pixels: new Uint8Array([10, 20]), width: 2, height: 1 }]); + return { window: { windowId: 'nightscout', surfaceId: 'window:nightscout', appId: 'nightscout' }, + requestRender: () => options.submitFrame(fresh) }; + }); + await early; + assert.deepEqual(submitted, [[30, 40]]); + plumbing.removeSurface(); + await plumbing.submitFrame(fresh); + assert.deepEqual(submitted, [[30, 40]], 'late callbacks cannot submit to a removed surface'); +}); + +test('iOS compositor rejects missing and removed surfaces before crossing into Kotlin', () => { + let nativeSubmissions = 0; + const native = { configureIdXYWidthHeightZOrderTransparent() {}, removeId() {}, submitIdDataXYWidthHeight() { nativeSubmissions++; } }; + const api = load('app/graphics/surface-compositor.ios.ts', { + require: () => ({ toData: data => data }), + FaceclawKitIosSurfaceCompositor: { alloc: () => ({ initWithWidthHeight: () => native }) }, + }); + const c = new api.SurfaceCompositor(2, 1), pixels = new Uint8Array([1, 2]); + const rect = { x: 0, y: 0, width: 2, height: 1 }; + assert.throws(() => c.submitSurfaceFrame('nightscout', pixels, rect), /Unknown surface/); + c.configureSurface('nightscout', { ...rect, zOrder: 0, transparency: 'opaque' }); + c.submitSurfaceFrame('nightscout', pixels, rect); + c.removeSurface('nightscout'); + assert.throws(() => c.submitSurfaceFrame('nightscout', pixels, rect), /Unknown surface/); + assert.equal(nativeSubmissions, 1); +}); diff --git a/tests/ios-glanceboard.test.cjs b/tests/ios-glanceboard.test.cjs index 51a03554..e8cb9e07 100644 --- a/tests/ios-glanceboard.test.cjs +++ b/tests/ios-glanceboard.test.cjs @@ -72,7 +72,9 @@ function fixture() { knownFolders: { documents: () => ({ path: '/tmp' }) }, path }, '../native/ios-bluetooth': { iosBluetooth: () => ({}) }, '../native/ios-voice-input': { iosVoiceInput: { handleSessionEnded() {} } }, - './glasses-session': { GlassesSession: Session }, './glance-host': { GlanceHost }, './events': events, + './glasses-session': { GlassesSession: Session }, + '../native/nightscout-bridge': { nightscoutBridge: { async start() {}, async stop() {} } }, + './glance-host': { GlanceHost }, './events': events, './device-addresses': { loadDeviceAddresses: () => ({}) }, './ios-peripheral-identity': { deviceAddressError: () => null }, '../apps/launcher/launcher-app': { createLauncherWindow: () => window, LAUNCHER_SURFACE_ID: 'launcher' }, '../apps/all-apps': { ALL_APPS: [{ appId: 'glanceboard', glanceboard: provider }] }, diff --git a/tests/nightscout.test.cjs b/tests/nightscout.test.cjs index 2e65706e..03e69c2b 100644 --- a/tests/nightscout.test.cjs +++ b/tests/nightscout.test.cjs @@ -154,3 +154,30 @@ test('bridge exposes numeric measurements and treats absent values as unknown', await bridge.refreshNow(); assert.equal(bridge.snapshot().reservoirUnits, 0); }); + +test('polling starts once and stops even while the initial HTTP request is pending', async () => { + let resolveHttp, calls = 0, nextTimer = 0; + const pending = new Promise(resolve => { resolveHttp = resolve; }); + const timers = new Map(); + const module = load('app/native/nightscout-bridge.ts', { + '../ui/dashboard-settings': { nightscoutSiteUrlSetting: { get: () => 'https://example.test' }, nightscoutApiTokenSetting: { get: () => 'test' } }, + '../util/http': { async fetchWithUserAgent() { + calls++; + await pending; + return { ok: true, json: async () => [] }; + } }, + }, { Date, console, setInterval(fn) { const id = ++nextTimer; timers.set(id, fn); return id; }, clearInterval(id) { timers.delete(id); } }); + const bridge = new module.NightscoutBridge(); + const first = bridge.start(), second = bridge.start(); + assert.equal(timers.size, 1); + assert.equal(calls, 5); + const stopping = bridge.stop(); + assert.equal(timers.size, 0); + resolveHttp(); + await Promise.all([first, second, stopping]); + assert.equal(timers.size, 0, 'finishing the first refresh must not restart polling'); + await bridge.start(); + assert.equal(timers.size, 1); + assert.equal(calls, 10); + await bridge.stop(); +}); From 2b3e068a23bdf4d98d6d20d16da32c6df20c9e48 Mon Sep 17 00:00:00 2001 From: James Babcock Date: Fri, 18 Sep 2026 23:30:07 -0700 Subject: [PATCH 22/99] Port Compass to iOS --- App_Resources/iOS/Info.plist | 2 + App_Resources/iOS/build.xcconfig | 2 +- App_Resources/iOS/src/FaceclawLocation.h | 9 ++ App_Resources/iOS/src/FaceclawLocation.m | 101 ++++++++++++++++++ App_Resources/iOS/src/module.modulemap | 1 + app/apps/compass/compass-app.ts | 3 +- app/apps/compass/declination.ts | 25 ++--- .../glanceboard/widgets/compass-widget.ts | 2 +- app/apps/ios-availability.ts | 1 - app/g2/ble-protocol.ios.ts | 11 ++ app/g2/ble-protocol.ts | 21 ++++ app/g2/glasses-session.ts | 36 ++++++- app/g2/ios-preview-controller.ts | 4 +- app/native/compass-types.ts | 23 ++++ app/native/compass.ios.ts | 29 +++++ app/native/compass.ts | 24 +---- app/native/declination.ios.ts | 14 +++ app/native/declination.ts | 13 +++ app/native/kotlin-protocol-smoke.ios.ts | 4 + app/native/location-permissions.ios.ts | 5 + app/native/location-permissions.ts | 1 + .../faceclaw/app/g2protocol/BleProtocol.kt | 15 +-- .../kotlin/com/faceclaw/app/IosNativeApi.kt | 3 + tests/compass-debug.test.cjs | 2 +- tests/compass-style.test.cjs | 2 +- tests/compass-texture-cache.test.cjs | 2 +- tests/ios-app-host.test.cjs | 2 + tests/ios-ble.test.cjs | 54 +++++++++- tests/ios-compass.test.cjs | 86 +++++++++++++++ tests/ios-glanceboard.test.cjs | 1 + .../kotlin/com/faceclaw/app/CompassTest.kt | 40 +++++++ .../com/faceclaw/app/IosNativeApiTest.kt | 8 ++ 32 files changed, 490 insertions(+), 56 deletions(-) create mode 100644 App_Resources/iOS/src/FaceclawLocation.h create mode 100644 App_Resources/iOS/src/FaceclawLocation.m create mode 100644 app/native/compass-types.ts create mode 100644 app/native/compass.ios.ts create mode 100644 app/native/declination.ios.ts create mode 100644 app/native/declination.ts create mode 100644 app/native/location-permissions.ios.ts create mode 100644 app/native/location-permissions.ts create mode 100644 tests/ios-compass.test.cjs create mode 100644 tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/CompassTest.kt diff --git a/App_Resources/iOS/Info.plist b/App_Resources/iOS/Info.plist index eb192802..b63a4b01 100644 --- a/App_Resources/iOS/Info.plist +++ b/App_Resources/iOS/Info.plist @@ -22,6 +22,8 @@ Faceclaw uses Bluetooth to connect to your glasses and ring, display your apps, and receive gestures. NSSpeechRecognitionUsageDescription Faceclaw turns audio from your glasses microphone into text for the app you choose. Dictation uses on-device recognition. + NSLocationWhenInUseUsageDescription + Faceclaw uses your location to correct the glasses compass from magnetic north to true north. UIBackgroundModes bluetooth-central diff --git a/App_Resources/iOS/build.xcconfig b/App_Resources/iOS/build.xcconfig index 15e50f3e..fdc60547 100644 --- a/App_Resources/iOS/build.xcconfig +++ b/App_Resources/iOS/build.xcconfig @@ -3,7 +3,7 @@ TARGETED_DEVICE_FAMILY = 1; CODE_SIGN_STYLE = Automatic; // Select the local signing team in Xcode or pass --teamId to the iOS scripts. -OTHER_LDFLAGS = $(inherited) -framework CoreBluetooth -framework CoreText -framework Speech -framework AVFoundation -framework WebKit -framework UniformTypeIdentifiers +OTHER_LDFLAGS = $(inherited) -framework CoreBluetooth -framework CoreLocation -framework CoreText -framework Speech -framework AVFoundation -framework WebKit -framework UniformTypeIdentifiers ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; diff --git a/App_Resources/iOS/src/FaceclawLocation.h b/App_Resources/iOS/src/FaceclawLocation.h new file mode 100644 index 00000000..53aaa101 --- /dev/null +++ b/App_Resources/iOS/src/FaceclawLocation.h @@ -0,0 +1,9 @@ +#import + +/** Short, foreground Core Location lookups for the glasses' true-north correction. */ +@interface FaceclawLocation : NSObject ++ (instancetype)shared; +- (BOOL)hasPermission; +- (void)requestPermission:(void (^)(BOOL granted))completion; +- (void)requestDeclination:(void (^)(double degrees, double latitude, double longitude, NSString *error))completion; +@end diff --git a/App_Resources/iOS/src/FaceclawLocation.m b/App_Resources/iOS/src/FaceclawLocation.m new file mode 100644 index 00000000..1f8872ef --- /dev/null +++ b/App_Resources/iOS/src/FaceclawLocation.m @@ -0,0 +1,101 @@ +#import "FaceclawLocation.h" +#import +#import + +@interface FaceclawLocation () +@property(nonatomic, strong) CLLocationManager *manager; +@property(nonatomic, strong) NSMutableArray *permissionCallbacks; +@property(nonatomic, strong) NSMutableArray *declinationCallbacks; +@property(nonatomic, strong) NSTimer *timer; +@property(nonatomic, strong) CLLocation *location; +@property(nonatomic, strong) CLHeading *heading; +@end + +@implementation FaceclawLocation ++ (instancetype)shared { + static FaceclawLocation *instance; + static dispatch_once_t once; + dispatch_once(&once, ^{ instance = [FaceclawLocation new]; }); + return instance; +} +- (instancetype)init { + if ((self = [super init])) { + _permissionCallbacks = [NSMutableArray new]; + _declinationCallbacks = [NSMutableArray new]; + _manager = [CLLocationManager new]; + _manager.delegate = self; + _manager.desiredAccuracy = kCLLocationAccuracyKilometer; + } + return self; +} +- (BOOL)hasPermission { + CLAuthorizationStatus status = self.manager.authorizationStatus; + return status == kCLAuthorizationStatusAuthorizedAlways || status == kCLAuthorizationStatusAuthorizedWhenInUse; +} +- (void)requestPermission:(void (^)(BOOL))completion { + if (self.manager.authorizationStatus != kCLAuthorizationStatusNotDetermined) { + completion([self hasPermission]); + return; + } + [self.permissionCallbacks addObject:[completion copy]]; + [self.manager requestWhenInUseAuthorization]; +} +- (void)locationManagerDidChangeAuthorization:(CLLocationManager *)manager { + if (manager.authorizationStatus == kCLAuthorizationStatusNotDetermined) return; + NSArray *callbacks = [self.permissionCallbacks copy]; + [self.permissionCallbacks removeAllObjects]; + for (void (^callback)(BOOL) in callbacks) callback([self hasPermission]); + if (![self hasPermission]) [self finishWithError:@"Location permission is required for true north"]; +} +- (void)requestDeclination:(void (^)(double, double, double, NSString *))completion { + if (![self hasPermission] || ![CLLocationManager headingAvailable]) { + completion(0, 0, 0, @"Location or heading unavailable for true north"); + return; + } + [self.declinationCallbacks addObject:[completion copy]]; + if (self.timer) return; + self.location = nil; + self.heading = nil; + // trueHeading is valid only while the same manager receives location updates. + // Subtracting magneticHeading cancels the phone's orientation: the result is + // a local correction to the GLASSES heading, never the phone's heading. + [self.manager startUpdatingLocation]; + [self.manager startUpdatingHeading]; + self.timer = [NSTimer scheduledTimerWithTimeInterval:20 repeats:NO block:^(NSTimer *timer) { + [self finishWithError:@"Timed out obtaining the true-north correction"]; + }]; +} +- (void)locationManager:(CLLocationManager *)manager didUpdateLocations:(NSArray *)locations { + CLLocation *location = locations.lastObject; + if (!location || location.horizontalAccuracy < 0 || fabs(location.timestamp.timeIntervalSinceNow) > 60) return; + self.location = location; + [self finishIfReady]; +} +- (void)locationManager:(CLLocationManager *)manager didUpdateHeading:(CLHeading *)heading { + if (heading.headingAccuracy < 0 || heading.trueHeading < 0 || heading.magneticHeading < 0 || + fabs(heading.timestamp.timeIntervalSinceNow) > 60) return; + self.heading = heading; + [self finishIfReady]; +} +- (BOOL)locationManagerShouldDisplayHeadingCalibration:(CLLocationManager *)manager { return NO; } +- (void)locationManager:(CLLocationManager *)manager didFailWithError:(NSError *)error { + if (error.code != kCLErrorLocationUnknown) [self finishWithError:error.localizedDescription]; +} +- (void)finishIfReady { + if (self.location && self.heading) [self finishWithError:@""]; +} +- (void)finishWithError:(NSString *)error { + double degrees = self.heading.trueHeading - self.heading.magneticHeading; + if (degrees > 180) degrees -= 360; + if (degrees < -180) degrees += 360; + CLLocationCoordinate2D coordinate = self.location.coordinate; + NSArray *callbacks = [self.declinationCallbacks copy]; + [self.declinationCallbacks removeAllObjects]; + [self.timer invalidate]; self.timer = nil; + [self.manager stopUpdatingLocation]; + [self.manager stopUpdatingHeading]; + self.location = nil; self.heading = nil; + for (void (^callback)(double, double, double, NSString *) in callbacks) + callback(degrees, coordinate.latitude, coordinate.longitude, error); +} +@end diff --git a/App_Resources/iOS/src/module.modulemap b/App_Resources/iOS/src/module.modulemap index 7f9d2b72..08938423 100644 --- a/App_Resources/iOS/src/module.modulemap +++ b/App_Resources/iOS/src/module.modulemap @@ -5,6 +5,7 @@ module FaceclawGraphics { header "FaceclawSocket.h" header "FaceclawLc3Decoder.h" header "FaceclawSpeech.h" + header "FaceclawLocation.h" header "FaceclawConfigPort.h" header "FaceclawEvenHubWebView.h" export * diff --git a/app/apps/compass/compass-app.ts b/app/apps/compass/compass-app.ts index 85e0f287..872e6079 100644 --- a/app/apps/compass/compass-app.ts +++ b/app/apps/compass/compass-app.ts @@ -21,7 +21,7 @@ import { type InProcessWindow, } from "../../ui/shell/in-process-window"; import { shell } from "../../ui/shell/shell"; -import { ensureLocationPermission, hasLocationPermission } from "../../g2/android-permissions"; +import { ensureLocationPermission, hasLocationPermission } from "../../native/location-permissions"; import { isCompassCalibrated, normalizeHeading } from "./calibration"; import { cardinalDirection, createCompassBackground, drawCompassRose, layoutCompassRose, TICK_HEIGHT } from "./compass-rose"; import { CompassCalibrationLayer } from "./calibration-layer"; @@ -268,6 +268,7 @@ export function createCompassAppWindow(options: InProcessAppOptions): InProcessW submitFrame: options.submitFrame, setSurfaceVisible: options.setSurfaceVisible, removeSurface: options.removeSurface, + reconfigureSurface: options.reconfigureSurface, onClosed: () => { layer.stop(); options.onClosed(); diff --git a/app/apps/compass/declination.ts b/app/apps/compass/declination.ts index beb9cfe5..a3d04cca 100644 --- a/app/apps/compass/declination.ts +++ b/app/apps/compass/declination.ts @@ -2,16 +2,16 @@ * Local magnetic declination for the compass, so the app can show true north. * * Declination only varies over tens of kilometres, so the location it needs is - * whatever the phone can cheaply produce: the same one-shot coarse lookup the - * Weather app uses, refreshed no more than daily. The last fix is persisted so - * a fresh start has a usable declination before location comes back, and the - * model is re-evaluated at the current time when it does. + * whatever the phone can cheaply produce, refreshed no more than daily. The + * last fix is persisted so a fresh start has a usable correction immediately. + * Android re-evaluates its magnetic model; iOS caches the correction supplied + * by Core Location (true heading minus magnetic heading). */ -import { hasLocationPermission } from "../../g2/android-permissions"; -import { magneticDeclinationDegrees } from "../../native/geomagnetic"; -import { getCurrentLocation } from "../../native/location"; +import { hasLocationPermission } from "../../native/location-permissions"; +import { getCurrentDeclination, restoreDeclination } from "../../native/declination"; import { getStringSetting, setStringSetting } from "../../native/settings-store"; +const DEGREES_KEY = "compass.declination.degrees"; const LATITUDE_KEY = "compass.declination.latitude"; const LONGITUDE_KEY = "compass.declination.longitude"; const LOCATED_AT_KEY = "compass.declination.locatedAtMs"; @@ -40,7 +40,7 @@ function loadStoredFix(): void { const locatedAtMs = parseInt(getStringSetting(LOCATED_AT_KEY, ""), 10); if (Number.isFinite(latitude) && Number.isFinite(longitude) && Number.isFinite(locatedAtMs)) { fix = { latitude, longitude, locatedAtMs }; - declination = magneticDeclinationDegrees(latitude, longitude); + declination = restoreDeclination(latitude, longitude, parseFloat(getStringSetting(DEGREES_KEY, ""))); } } @@ -73,16 +73,17 @@ export function refreshDeclination(): void { loadStoredFix(); if (refreshing || !hasLocationPermission()) return; const now = Date.now(); - if (fix !== null && now - fix.locatedAtMs < FIX_MAX_AGE_MS) return; + if (declination !== null && fix !== null && now - fix.locatedAtMs < FIX_MAX_AGE_MS) return; if (now - lastAttemptMs < RETRY_INTERVAL_MS) return; lastAttemptMs = now; refreshing = true; - getCurrentLocation() + getCurrentDeclination() .then((location) => { - const value = magneticDeclinationDegrees(location.latitude, location.longitude); - if (value === null) return; + const value = location.degrees; + if (!Number.isFinite(value)) return; fix = { latitude: location.latitude, longitude: location.longitude, locatedAtMs: now }; declination = value; + setStringSetting(DEGREES_KEY, String(value)); setStringSetting(LATITUDE_KEY, String(location.latitude)); setStringSetting(LONGITUDE_KEY, String(location.longitude)); setStringSetting(LOCATED_AT_KEY, String(now)); diff --git a/app/apps/glanceboard/widgets/compass-widget.ts b/app/apps/glanceboard/widgets/compass-widget.ts index 0a3a6d1d..8e6716f0 100644 --- a/app/apps/glanceboard/widgets/compass-widget.ts +++ b/app/apps/glanceboard/widgets/compass-widget.ts @@ -1,6 +1,6 @@ import { type GrayImage } from "../../../graphics/image"; import { getDefaultMediumFont, getDefaultSmallFont } from "../../../graphics/ui-fonts"; -import { hasLocationPermission } from "../../../g2/android-permissions"; +import { hasLocationPermission } from "../../../native/location-permissions"; import { addCompassListener, COMPASS_CHANGED, setCompassEnabled } from "../../../native/compass"; import { isCompassCalibrated, normalizeHeading } from "../../compass/calibration"; import { cardinalDirection, createCompassBackground, drawCompassRose, layoutCompassRose, TICK_HEIGHT } from "../../compass/compass-rose"; diff --git a/app/apps/ios-availability.ts b/app/apps/ios-availability.ts index 4a6b794a..bae12f44 100644 --- a/app/apps/ios-availability.ts +++ b/app/apps/ios-availability.ts @@ -4,7 +4,6 @@ const unavailable: Record = { notifications: 'Phone notification integration is not available on iOS yet.', transcribe: 'Voice capture and transcription are not available on iOS yet.', microphones: 'Glasses microphone capture is not available on iOS yet.', - compass: 'Glasses compass streaming is not available on iOS yet.', navigate: 'Navigation location tracking is not available on iOS yet.', weather: 'Weather location access is not available on iOS yet.', calendar: 'Calendar access is not available on iOS yet.', diff --git a/app/g2/ble-protocol.ios.ts b/app/g2/ble-protocol.ios.ts index e22945dc..e2cfaa80 100644 --- a/app/g2/ble-protocol.ios.ts +++ b/app/g2/ble-protocol.ios.ts @@ -1,3 +1,4 @@ +import { type CompassEvent } from '../native/compass-types' /** iOS binary bridge to the same Kotlin protocol used by Android. */ import { fromData, toData, nativeArray } from '../native/kotlin-data' import { OsEventTypeList } from './events' @@ -64,3 +65,13 @@ export function packGray4(gray: Uint8Array, width: number, height: number): Uint return fromData(protocol.packDataWidthHeight(toData(gray), width, height)) } export const rle4 = (packed: Uint8Array): Uint8Array => fromData(protocol.rleData(toData(packed))) + +export function decodeCompassInput(message: ProtocolMessage): CompassEvent | null { + const event = protocol.compassInputDataSidFlag(toData(message.payload), message.sid, message.flag) + return event ? { command: event.command, headingDegrees: event.headingDegrees, + ...(event.diagnosticFlags >= 0 ? { diagnostics: { + magneticAccuracy: event.magneticAccuracy, magneticAnomalies: event.magneticAnomalies, + orientationSource: event.orientationSource, flags: event.diagnosticFlags, sampleTimeMs: Number(event.sampleTimeMs), + } } : {}), + } : null +} diff --git a/app/g2/ble-protocol.ts b/app/g2/ble-protocol.ts index 9fd16184..e8115773 100644 --- a/app/g2/ble-protocol.ts +++ b/app/g2/ble-protocol.ts @@ -1,3 +1,4 @@ +import { type CompassEvent } from '../native/compass-types' /** G2 wire protocol, ported from g2protocol/BleProtocol.java. No platform APIs. */ import { OsEventTypeList } from './events' export const G2_WRITE = '00002760-08c2-11e1-9073-0e8ac72e5401' @@ -178,3 +179,23 @@ export function rle4(packed: Uint8Array): Uint8Array { } return output.slice(0, used) } + +/** Reference decoder for host tests; iOS uses the shared Kotlin implementation. */ +export function decodeCompassInput(message: ProtocolMessage): CompassEvent | null { + if (message.sid !== 8 || ![1, 6].includes(message.flag)) return null + const command = readInteger(message.payload, 1, -1) + if (command === 16 || command === 17) return { command, headingDegrees: -1 } + if (command !== 15) return null + const compass = readBytes(message.payload, 10) + const headingDegrees = compass ? readInteger(compass, 1, -1) : -1 + if (headingDegrees < 0 || headingDegrees >= 360) return null + const event: CompassEvent = { command, headingDegrees } + let d: Uint8Array | undefined + try { d = readBytes(message.payload, 100) } catch { return event } + if (d?.length === 12 && d[0] === 67 && d[1] === 77 && d[2] === 1 && d[7] === 0 && + (d[3] <= 3 || d[3] === 255) && (d[4] <= 2 || d[4] === 255) && d[5] <= 3) { + event.diagnostics = { magneticAccuracy: d[3] === 255 ? -1 : d[3], magneticAnomalies: d[4] === 255 ? -1 : d[4], + orientationSource: d[5], flags: d[6], sampleTimeMs: new DataView(d.buffer, d.byteOffset + 8, 4).getUint32(0, true) } + } + return event +} diff --git a/app/g2/glasses-session.ts b/app/g2/glasses-session.ts index 16251ed7..d3aeca16 100644 --- a/app/g2/glasses-session.ts +++ b/app/g2/glasses-session.ts @@ -1,3 +1,4 @@ +import { type CompassEvent } from '../native/compass-types' import * as protocol from './ble-protocol' import { iosBleTraffic } from './ble-traffic-counters' import { buildBoundingBoxPayload, buildFullFrameBands } from './ble-image-optimizer' @@ -74,11 +75,16 @@ export class GlassesSession { private microphoneToken = 0 private microphoneWork: Promise = Promise.resolve() private microphoneEnabled = false + private compassWanted = false + private compassSent: boolean | null = null + private compassStopping = false + private compassWork: Promise = Promise.resolve() constructor(private readonly transport: SessionTransport, private readonly onState: (state: SessionState) => void, private readonly onInput: (input: protocol.GlassesInput) => void, private readonly log: (message: string) => void = () => {}, - private readonly onActivity: () => void = () => {}) { + private readonly onActivity: () => void = () => {}, + private readonly onCompass: (event: CompassEvent) => void = () => {}) { this.off = transport.onEvent(event => this.receive(event)) } private update(phase: SessionState['phase'], status: string): void { @@ -88,7 +94,7 @@ export class GlassesSession { if (['connecting', 'connected', 'disconnecting'].includes(this.state.phase)) return const invalid = deviceAddressError(addresses) if (invalid) { this.update('error', invalid); return } - this.addresses = { ...addresses }; this.wanted = true + this.addresses = { ...addresses }; this.wanted = true; this.compassStopping = false if (!retry) this.retryCount = 0 const generation = ++this.generation this.state = { ...this.state, capabilities: '', leftVersion: '', rightVersion: '', battery: null, charging: null, ring: false } @@ -131,6 +137,7 @@ export class GlassesSession { this.lastHeartbeat = this.lastLease = this.lastSettings = Date.now() this.displayed = null; this.retryCount = 0 this.update('connected', 'Glasses connected') + await this.syncCompass(); this.check(generation) this.schedule() if (addresses.ring && ids.ring) await this.connectRing(generation) else if (addresses.ring) this.update('connected', 'Glasses connected; configured ring was not found') @@ -347,6 +354,10 @@ export class GlassesSession { } if (message.sid === protocol.SID.settings) this.applySettings(message) if (event.identifier === this.ids.right) { + if (this.state.phase === 'connected') { + const compass = protocol.decodeCompassInput(message) + if (compass) this.onCompass(compass) + } const input = protocol.decodeGlassesInput(message) if (input) { if (input.kind === 'sys-event' && [5, 6, 7].includes(input.eventType) && this.state.phase === 'connected') { @@ -406,6 +417,24 @@ export class GlassesSession { this.microphoneWork = work return work } + setCompassEnabled(enabled: boolean): void { + this.compassWanted = enabled + void this.syncCompass() + } + /** Serialize changes so a release cannot overtake an unacknowledged enable. */ + private syncCompass(): Promise { + const generation = this.generation + const work = this.compassWork.then(async () => { + if (generation !== this.generation || this.state.phase !== 'connected') return + const enabled = !this.compassStopping && this.compassWanted + if (this.compassSent === enabled) return + // Same CFW mode 10, 100 ms report interval and zero minimum change as Android. + await this.requestCfw('left', new Uint8Array(enabled ? [10, 2, 100, 0, 0, 0] : [10, 0])) + if (generation === this.generation) this.compassSent = enabled + }).catch(error => { if (generation === this.generation) this.fail(error, true) }) + this.compassWork = work + return work + } wake(): void { if (this.timer !== null) { clearTimeout(this.timer); this.timer = null } void this.pump() @@ -480,6 +509,7 @@ export class GlassesSession { } private reset(): void { ++this.generation + this.compassSent = null; this.compassWork = Promise.resolve() ++this.microphoneToken; this.audioListener = null; this.microphoneEnabled = false if (this.timer !== null) clearTimeout(this.timer) if (this.retryTimer !== null) clearTimeout(this.retryTimer) @@ -516,6 +546,8 @@ export class GlassesSession { } private async stopInternal(): Promise { this.wanted = false + this.compassStopping = true + await this.syncCompass() // Stop mic capture before ending the display session. Late enable ACKs // cannot leave a microphone streaming after an explicit Disconnect. if (this.audioListener || this.microphoneEnabled) { diff --git a/app/g2/ios-preview-controller.ts b/app/g2/ios-preview-controller.ts index 566eeed8..1f0b0a51 100644 --- a/app/g2/ios-preview-controller.ts +++ b/app/g2/ios-preview-controller.ts @@ -1,3 +1,4 @@ +import { bindCompassSession, receiveCompassEvent } from '../native/compass.ios' import { Dialogs, File, knownFolders, path, type ImageSource } from '@nativescript/core' import { iosBluetooth } from '../native/ios-bluetooth' import { iosVoiceInput } from '../native/ios-voice-input' @@ -378,7 +379,8 @@ export class IosPreviewController { input.kind === 'display-wake' && input.eventType === OsEventTypeList.HEAD_UP_EVENT) this.logBluetooth(`Input ${input.eventType} source ${input.eventSource}`) }).catch(error => this.fail(error)) - }, message => this.logBluetooth(message), () => this.refreshClock()) + }, message => this.logBluetooth(message), () => this.refreshClock(), receiveCompassEvent) + bindCompassSession(this.session) } await this.session.start(addresses) } diff --git a/app/native/compass-types.ts b/app/native/compass-types.ts new file mode 100644 index 00000000..14ea05b7 --- /dev/null +++ b/app/native/compass-types.ts @@ -0,0 +1,23 @@ +export const COMPASS_CHANGED = 15; +export const COMPASS_CALIBRATION_STARTED = 16; +export const COMPASS_CALIBRATION_COMPLETE = 17; + +export type CompassDiagnostics = { + /** 0 uncalibrated .. 3 well calibrated; -1 unavailable. */ + magneticAccuracy: number; + /** 0 none, 1 small/temperature, 2 large; -1 unavailable. */ + magneticAnomalies: number; + /** 0 unknown, 1 GRV (relative), 2 GMRV, 3 RV. */ + orientationSource: number; + flags: number; + sampleTimeMs: number; +}; + +export type CompassEvent = { + command: number; + /** Magnetic heading in degrees, or -1 for calibration-only events. */ + headingDegrees: number; + /** Absent with stock/older CFW or an unrecognized diagnostic extension. */ + diagnostics?: CompassDiagnostics; +}; + diff --git a/app/native/compass.ios.ts b/app/native/compass.ios.ts new file mode 100644 index 00000000..ab201fce --- /dev/null +++ b/app/native/compass.ios.ts @@ -0,0 +1,29 @@ +import { type CompassEvent } from './compass-types' +export * from './compass-types' + +type CompassSession = { setCompassEnabled(enabled: boolean): void } +const owners = new Set() +const listeners = new Set<(event: CompassEvent) => void>() +let session: CompassSession | null = null + +/** Holds and listeners survive disconnect/reconnect and opening before Connect. */ +export function bindCompassSession(next: CompassSession): void { + if (session && session !== next) session.setCompassEnabled(false) + session = next + session.setCompassEnabled(owners.size > 0) +} + +export function setCompassEnabled(enabled: boolean, owner = 'compass'): void { + if (enabled) owners.add(owner) + else owners.delete(owner) + session?.setCompassEnabled(owners.size > 0) +} + +export function addCompassListener(listener: (event: CompassEvent) => void): () => void { + listeners.add(listener) + return () => { listeners.delete(listener) } +} + +export function receiveCompassEvent(event: CompassEvent): void { + for (const listener of [...listeners]) listener(event) +} diff --git a/app/native/compass.ts b/app/native/compass.ts index 8a0d6491..dae5f42f 100644 --- a/app/native/compass.ts +++ b/app/native/compass.ts @@ -1,28 +1,8 @@ declare const com: any; declare const global: any; -export const COMPASS_CHANGED = 15; -export const COMPASS_CALIBRATION_STARTED = 16; -export const COMPASS_CALIBRATION_COMPLETE = 17; - -export type CompassDiagnostics = { - /** 0 uncalibrated .. 3 well calibrated; -1 unavailable. */ - magneticAccuracy: number; - /** 0 none, 1 small/temperature, 2 large; -1 unavailable. */ - magneticAnomalies: number; - /** 0 unknown, 1 GRV (relative), 2 GMRV, 3 RV. */ - orientationSource: number; - flags: number; - sampleTimeMs: number; -}; - -export type CompassEvent = { - command: number; - /** Magnetic heading in degrees, or -1 for calibration-only events. */ - headingDegrees: number; - /** Absent with stock/older CFW or an unrecognized diagnostic extension. */ - diagnostics?: CompassDiagnostics; -}; +import { type CompassEvent } from "./compass-types"; +export * from "./compass-types"; function activeCommunicator(): any { if (!global.isAndroid) return null; diff --git a/app/native/declination.ios.ts b/app/native/declination.ios.ts new file mode 100644 index 00000000..d8f8678f --- /dev/null +++ b/app/native/declination.ios.ts @@ -0,0 +1,14 @@ +declare const FaceclawLocation: any + +export function restoreDeclination(_latitude: number, _longitude: number, degrees: number): number | null { + return Number.isFinite(degrees) && Math.abs(degrees) <= 180 ? degrees : null +} + +export function getCurrentDeclination(): Promise<{ latitude: number; longitude: number; degrees: number }> { + return new Promise((resolve, reject) => { + FaceclawLocation.shared().requestDeclination((degrees: number, latitude: number, longitude: number, error: string) => { + if (error) reject(new Error(error)) + else resolve({ degrees, latitude, longitude }) + }) + }) +} diff --git a/app/native/declination.ts b/app/native/declination.ts new file mode 100644 index 00000000..751ddae4 --- /dev/null +++ b/app/native/declination.ts @@ -0,0 +1,13 @@ +import { magneticDeclinationDegrees } from './geomagnetic' +import { getCurrentLocation } from './location' + +export function restoreDeclination(latitude: number, longitude: number, _degrees: number): number | null { + return magneticDeclinationDegrees(latitude, longitude) +} + +export async function getCurrentDeclination(): Promise<{ latitude: number; longitude: number; degrees: number }> { + const location = await getCurrentLocation() + const degrees = magneticDeclinationDegrees(location.latitude, location.longitude) + if (degrees === null) throw new Error('Magnetic declination unavailable') + return { ...location, degrees } +} diff --git a/app/native/kotlin-protocol-smoke.ios.ts b/app/native/kotlin-protocol-smoke.ios.ts index 91c3ad21..b7c964f6 100644 --- a/app/native/kotlin-protocol-smoke.ios.ts +++ b/app/native/kotlin-protocol-smoke.ios.ts @@ -32,5 +32,9 @@ export function runKotlinProtocolSmokeTest(): void { const changed = new Uint8Array(16); changed[0] = 255 assert(buildBoundingBoxPayload(new Uint8Array(16), changed, 8, 4, 1)?.[0] === 3, 'image update') assert(lvglMetrics('/nonexistent/faceclaw-font').length === 0, 'font bridge') + const compass = protocol.decodeCompassInput({ sid: 8, flag: 1, command: 15, magic: 0, + payload: new Uint8Array([8, 15, 16, 0, 82, 3, 8, 231, 2, 162, 6, 12, 67, 77, 1, 3, 2, 3, 140, 0, 152, 186, 220, 254]) }) + if (compass?.headingDegrees !== 359 || compass.diagnostics?.sampleTimeMs !== 0xfedcba98) + throw new Error('Kotlin compass notification mismatch') console.log('FACECLAW_KOTLIN_PROTOCOL_PASS iOS') } diff --git a/app/native/location-permissions.ios.ts b/app/native/location-permissions.ios.ts new file mode 100644 index 00000000..aa668f93 --- /dev/null +++ b/app/native/location-permissions.ios.ts @@ -0,0 +1,5 @@ +declare const FaceclawLocation: any +export const hasLocationPermission = (): boolean => FaceclawLocation.shared().hasPermission() +export function ensureLocationPermission(): Promise { + return new Promise(resolve => FaceclawLocation.shared().requestPermission(resolve)) +} diff --git a/app/native/location-permissions.ts b/app/native/location-permissions.ts new file mode 100644 index 00000000..c4776a51 --- /dev/null +++ b/app/native/location-permissions.ts @@ -0,0 +1 @@ +export { ensureLocationPermission, hasLocationPermission } from '../g2/android-permissions' diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/BleProtocol.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/BleProtocol.kt index 4227cdb5..f8dd8058 100644 --- a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/BleProtocol.kt +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/g2protocol/BleProtocol.kt @@ -1027,13 +1027,14 @@ class BleProtocol { /** Decode the stock firmware's compass navigation notifications (sid 0x08). */ @JvmStatic fun parseCompassEvent(frame: ParsedFrame?): CompassEvent? { - if ( - ((((frame == null) || !frame.ok) || (frame.sid != SID_NAVIGATION)) || - ((frame.flag != FLAG_NOTIFY) && (frame.flag != FLAG_NOTIFY_ALT))) - ) { - return null - } - var root: ByteArray = stripTrailingCrc(frame.pb) + if (frame == null || !frame.ok) return null + return parseCompassPayload(frame.sid, frame.flag, stripTrailingCrc(frame.pb)) + } + + /** MessageReceiver has already validated and removed the CRC. */ + @JvmStatic + fun parseCompassPayload(sid: Int, flag: Int, root: ByteArray): CompassEvent? { + if (sid != SID_NAVIGATION || (flag != FLAG_NOTIFY && flag != FLAG_NOTIFY_ALT)) return null var command: Int = readVarintFieldValue(root, 1, -1) if ((command == NAV_CMD_COMPASS_CHANGED)) { var compass: ByteArray? = readFieldBytes(root, 10) diff --git a/native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/app/IosNativeApi.kt b/native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/app/IosNativeApi.kt index e461a9b6..2c1b364f 100644 --- a/native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/app/IosNativeApi.kt +++ b/native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/app/IosNativeApi.kt @@ -132,6 +132,9 @@ class IosProtocol { G2Event.decodePayload(sid, data.byteArray()) else null + fun compassInput(data: NSData, sid: Int, flag: Int): BleProtocol.CompassEvent? = + BleProtocol.parseCompassPayload(sid, flag, data.byteArray()) + fun ringInput(data: NSData): G2Event? = FaceclawRingEventDecoder.decode(data.byteArray())?.event fun pack(data: NSData, width: Int, height: Int): NSData { diff --git a/tests/compass-debug.test.cjs b/tests/compass-debug.test.cjs index a000c57a..d9057409 100644 --- a/tests/compass-debug.test.cjs +++ b/tests/compass-debug.test.cjs @@ -59,7 +59,7 @@ function compass(width = 576, height = 260) { createInProcessWindow: (options) => { window = options; return { requestRender: () => ++renders }; }, }, '../../ui/shell/shell': { shell: { isWindowVisible: () => true } }, - '../../g2/android-permissions': { hasLocationPermission: () => false }, + '../../native/location-permissions': { hasLocationPermission: () => false }, './calibration': calibration, './calibration-layer': {}, './declination': { onDeclinationChanged: () => () => {} }, './heading': { getNorthReference: () => 'magnetic', resolveHeading: (v) => ({ displayDegrees: v }) }, diff --git a/tests/compass-style.test.cjs b/tests/compass-style.test.cjs index c6ef2d21..423e5f87 100644 --- a/tests/compass-style.test.cjs +++ b/tests/compass-style.test.cjs @@ -58,7 +58,7 @@ function compass({ style, width = 576, height = 260 } = {}) { createInProcessWindow: (options) => { window = options; return { requestRender: () => renders++ }; }, }, '../../ui/shell/shell': { shell: { isWindowVisible: () => true } }, - '../../g2/android-permissions': { hasLocationPermission: () => false }, + '../../native/location-permissions': { hasLocationPermission: () => false }, './calibration': { isCompassCalibrated: () => true, normalizeHeading: (n) => ((n % 360) + 360) % 360 }, './calibration-layer': {}, './compass-rose': load('app/apps/compass/compass-rose.ts', { diff --git a/tests/compass-texture-cache.test.cjs b/tests/compass-texture-cache.test.cjs index 2f947829..a544fa79 100644 --- a/tests/compass-texture-cache.test.cjs +++ b/tests/compass-texture-cache.test.cjs @@ -43,7 +43,7 @@ const compass = load('app/apps/compass/compass-app.ts', { '../../ui/shell/geometry': { screenCenterInViewportX: () => viewportWidth - 320 }, '../../ui/shell/in-process-window': {}, '../../ui/shell/shell': {}, - '../../g2/android-permissions': {}, + '../../native/location-permissions': {}, './calibration': calibration, './calibration-layer': {}, './compass-rose': rose, diff --git a/tests/ios-app-host.test.cjs b/tests/ios-app-host.test.cjs index 2d4b702c..e81d37a2 100644 --- a/tests/ios-app-host.test.cjs +++ b/tests/ios-app-host.test.cjs @@ -89,6 +89,7 @@ test('background glasses input still composites frames; phone resume preserves t } const settings = { onAnySettingChanged: () => () => {}, previewColorSetting: { get: () => 'white' } }; const modules = { + '../native/compass.ios': { bindCompassSession() {}, receiveCompassEvent() {} }, '@nativescript/core': { File: { fromPath: () => ({ writeTextSync() {} }) }, knownFolders: { documents: () => ({ path: '/tmp' }) }, path }, '../native/ios-voice-input': { iosVoiceInput: { handleSessionEnded() {} } }, '../native/ios-bluetooth': { iosBluetooth: () => ({}) }, './glasses-session': { GlassesSession: Session }, @@ -156,6 +157,7 @@ test('iOS bandwidth footer toggles live, polls only in foreground and resets its on: (key, fn) => appEvents.set(key, fn), off: key => appEvents.delete(key) }, Button: View, Color: class {}, Dialogs: {}, GridLayout: View, Image: View, Label: View, Page: View, StackLayout: View }; const modules = { + '../native/compass.ios': { bindCompassSession() {}, receiveCompassEvent() {} }, '@nativescript/core': core, '../apps/all-apps': { ALL_APPS: [] }, '../g2/ios-preview-controller': { IosPreviewController: class { resume() {} pause() {} } }, diff --git a/tests/ios-ble.test.cjs b/tests/ios-ble.test.cjs index 55694b12..5d28078a 100644 --- a/tests/ios-ble.test.cjs +++ b/tests/ios-ble.test.cjs @@ -159,10 +159,10 @@ async function until(predicate) { assert.fail('Timed out waiting for test state'); } function harness(t, transport = new FakeTransport()) { - const states = [], input = []; - const session = new GlassesSession(transport, state => states.push(state), event => input.push(event)); + const states = [], input = [], compass = []; + const session = new GlassesSession(transport, state => states.push(state), event => input.push(event), undefined, undefined, event => compass.push(event)); t.after(async () => { transport.hold = false; await session.stop(); }); - return { transport, session, states, input }; + return { transport, session, states, input, compass }; } test('session authenticates both arms, checks firmware and sends acknowledged display data to L', async t => { const h = harness(t); await h.session.start({ ...addresses, ring: 'AA:BB:CC:DD:EE:03' }); @@ -171,7 +171,7 @@ test('session authenticates both arms, checks firmware and sends acknowledged di assert.equal(h.session.state.charging, false); assert.deepEqual(h.transport.sent.filter(s => s.message.sid === 128).map(s => s.id).sort(), ['L', 'R']); h.session.setFrame(new Uint8Array(640 * 480)); await until(() => h.session.state.frames === 1); - const image = h.transport.sent.find(s => s.message.sid === p.SID.cfw); + const image = h.transport.sent.find(s => s.message.sid === p.SID.cfw && s.message.payload[0] === 6); assert.equal(image.id, 'L'); assert.equal(image.message.payload[0], 6); const layout = h.transport.sent.find(s => s.message.sid === p.SID.hub && s.message.command === 0); @@ -293,7 +293,7 @@ test('release while microphone enable awaits ACK sends disable last and rejects assert.equal(p.readInteger(p.readBytes(mic.at(-1).message.payload, 18), 1), 0); }); -const imageMessages = transport => transport.sent.filter(s => s.message.sid === p.SID.cfw && s.message.payload[0] !== 11); +const imageMessages = transport => transport.sent.filter(s => s.message.sid === p.SID.cfw && ![10, 11].includes(s.message.payload[0])); const imageBody = sent => sent.message.payload; const ack = (transport, sent, overrides) => transport.ack(sent.id, sent.message, overrides); const tick = () => new Promise(resolve => setImmediate(resolve)); @@ -467,3 +467,47 @@ test('delta ids skip reserved values and advance only on emitted deltas; reconne await h.session.stop(); await h.session.start(addresses); assert.equal((await submit(base))[0], 6); // Even the same pixels need a trusted full base. }); + +const compassMessages = transport => transport.sent.filter(s => s.message.sid === p.SID.cfw && s.message.payload[0] === 10); +test('compass desired state survives connecting and reconnecting; explicit stop disables it first', async t => { + const h = harness(t); + h.session.setCompassEnabled(true); + await h.session.start(addresses); + assert.equal(compassMessages(h.transport).length, 1); + assert.equal(compassMessages(h.transport)[0].id, 'L'); + assert.deepEqual([...compassMessages(h.transport)[0].message.payload], [10, 2, 100, 0, 0, 0]); + await h.session.stop(); + assert.deepEqual([...compassMessages(h.transport).at(-1).message.payload], [10, 0]); + assert.equal(h.transport.sent.at(-1).message.payload[0], 11); + await h.session.start(addresses); + assert.equal(compassMessages(h.transport).at(-1).message.payload[1], 2); + h.transport.emit({ kind: 'disconnected', identifier: 'R' }); + assert.equal(h.session.state.phase, 'retrying'); + await h.session.start(addresses, true); + assert.equal(compassMessages(h.transport).at(-1).message.payload[1], 2); +}); +test('release during pending compass enable sends disable after the enable ACK', async t => { + const h = harness(t); await h.session.start(addresses); + assert.deepEqual([...compassMessages(h.transport)[0].message.payload], [10, 0]); + h.transport.hold = true; + h.session.setCompassEnabled(true); + await until(() => h.transport.held.length === 1); + h.session.setCompassEnabled(false); + const enabling = h.transport.held.shift(); + h.transport.hold = false; h.transport.ack(enabling.id, enabling.message); + await until(() => compassMessages(h.transport).length === 3); + assert.deepEqual(compassMessages(h.transport).map(s => s.message.payload[1]), [0, 2, 0]); +}); +test('compass notifications only come from the right arm and preserve diagnostics and calibration', async t => { + const h = harness(t); await h.session.start(addresses); + const payload = new Uint8Array(Buffer.from('080f1000520308e702a2060c434d010302038c0098badcfe', 'hex')); + const emit = (id, sid = 8, flag = 1, body = payload) => h.transport.emit({ kind: 'notification', identifier: id, + characteristic: p.G2_NOTIFY, data: hex(p.concat(...p.frameMessage(body, sid, flag, 20))) }); + emit('L'); emit('other'); emit('R', 9); emit('R', 8, 0x20); + assert.equal(h.compass.length, 0); + emit('R'); emit('R', 8, 6, new Uint8Array([8, 16, 16, 0])); + emit('R', 8, 1, new Uint8Array([8, 17, 16, 0])); + assert.deepEqual(h.compass, [{ command: 15, headingDegrees: 359, diagnostics: { + magneticAccuracy: 3, magneticAnomalies: 2, orientationSource: 3, flags: 140, sampleTimeMs: 0xfedcba98, + } }, { command: 16, headingDegrees: -1 }, { command: 17, headingDegrees: -1 }]); +}); diff --git a/tests/ios-compass.test.cjs b/tests/ios-compass.test.cjs new file mode 100644 index 00000000..a348dba3 --- /dev/null +++ b/tests/ios-compass.test.cjs @@ -0,0 +1,86 @@ +const test = require('node:test'); +const assert = require('node:assert/strict'); +const fs = require('node:fs'); +const vm = require('node:vm'); +const ts = require('typescript'); +const path = require('node:path'); +function load(file, context = {}) { + const sandbox = { exports: {}, console, ...context }; + vm.runInNewContext(ts.transpileModule(fs.readFileSync(path.join(__dirname, '..', file), 'utf8'), { + compilerOptions: { module: ts.ModuleKind.CommonJS, target: ts.ScriptTarget.ES2020 }, + }).outputText, sandbox); + return sandbox.exports; +} + +test('iOS compass owners and listeners work before connection and across session replacement', () => { + const api = load('app/native/compass.ios.ts', { require: () => ({}) }); + const states = [], nextStates = [], events = []; + const off = api.addCompassListener(event => events.push(event)); + api.setCompassEnabled(true, 'compass'); + api.setCompassEnabled(true, 'glanceboard'); + api.bindCompassSession({ setCompassEnabled: enabled => states.push(enabled) }); + api.setCompassEnabled(false, 'compass'); + assert.deepEqual(states, [true, true]); + api.bindCompassSession({ setCompassEnabled: enabled => nextStates.push(enabled) }); + assert.equal(states.at(-1), false); + api.setCompassEnabled(false, 'glanceboard'); + assert.deepEqual(nextStates, [true, false]); + api.receiveCompassEvent({ command: 15, headingDegrees: 271 }); + off(); api.receiveCompassEvent({ command: 15, headingDegrees: 90 }); + assert.deepEqual(events, [{ command: 15, headingDegrees: 271 }]); +}); + +test('shared declination cache handles iOS fixes, persisted corrections and unavailable sensors', async () => { + const store = new Map(), listeners = []; + let permission = false, lookups = 0, fail = false; + let now = 1_800_000_000_000; + const ios = load('app/native/declination.ios.ts'); + const context = { + Date: { now: () => now }, console: { warn() {} }, + require: id => ({ + '../../native/location-permissions': { hasLocationPermission: () => permission }, + '../../native/declination': { restoreDeclination: ios.restoreDeclination, getCurrentDeclination: async () => { + lookups++; if (fail) throw new Error('No heading sensor'); + return { latitude: 37.7, longitude: -122.4, degrees: 12.5 }; + } }, + '../../native/settings-store': { getStringSetting: (key, fallback) => store.get(key) ?? fallback, + setStringSetting: (key, value) => store.set(key, value) }, + })[id], + }; + const api = load('app/apps/compass/declination.ts', context); + api.onDeclinationChanged(() => listeners.push(api.getDeclinationDegrees())); + assert.equal(api.getDeclinationAvailability(), 'no-permission'); + api.refreshDeclination(); assert.equal(lookups, 0); + permission = true; + assert.equal(api.getDeclinationAvailability(), 'no-fix'); + api.refreshDeclination(); api.refreshDeclination(); + await new Promise(resolve => setImmediate(resolve)); + assert.equal(lookups, 1); assert.deepEqual(listeners, [12.5]); + assert.equal(api.getDeclinationAvailability(), 'available'); + const restarted = load('app/apps/compass/declination.ts', context); + assert.equal(restarted.getDeclinationDegrees(), 12.5); + restarted.refreshDeclination(); assert.equal(lookups, 1); + now += 25 * 60 * 60 * 1000; fail = true; + restarted.refreshDeclination(); await new Promise(resolve => setImmediate(resolve)); + assert.equal(restarted.getDeclinationDegrees(), 12.5); + restarted.refreshDeclination(); assert.equal(lookups, 2); + // Existing Android preferences have coordinates but no cached correction. + store.delete('compass.declination.degrees'); fail = false; + store.set('compass.declination.locatedAtMs', String(now)); + const migrated = load('app/apps/compass/declination.ts', context); + assert.equal(migrated.getDeclinationDegrees(), null); + migrated.refreshDeclination(); await new Promise(resolve => setImmediate(resolve)); + assert.equal(migrated.getDeclinationDegrees(), 12.5); +}); + +test('iOS native correction callbacks resolve values or propagate unavailable errors', async () => { + let unavailable = false; + const api = load('app/native/declination.ios.ts', { FaceclawLocation: { shared: () => ({ + requestDeclination: callback => callback(-8.25, 51, 0, unavailable ? 'Heading unavailable' : ''), + }) } }); + assert.deepEqual({ ...await api.getCurrentDeclination() }, { latitude: 51, longitude: 0, degrees: -8.25 }); + unavailable = true; + await assert.rejects(api.getCurrentDeclination(), /Heading unavailable/); + assert.equal(api.restoreDeclination(0, 0, NaN), null); + assert.equal(api.restoreDeclination(0, 0, 360), null); +}); diff --git a/tests/ios-glanceboard.test.cjs b/tests/ios-glanceboard.test.cjs index e8cb9e07..eb518f36 100644 --- a/tests/ios-glanceboard.test.cjs +++ b/tests/ios-glanceboard.test.cjs @@ -68,6 +68,7 @@ function fixture() { paint: () => { boardStats.paints++; return new images.GrayImage(100, 80, 200); } }), }; const modules = { + "../native/compass.ios": { bindCompassSession() {}, receiveCompassEvent() {} }, '@nativescript/core': { File: { fromPath: () => ({ writeTextSync() {} }) }, knownFolders: { documents: () => ({ path: '/tmp' }) }, path }, '../native/ios-bluetooth': { iosBluetooth: () => ({}) }, diff --git a/tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/CompassTest.kt b/tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/CompassTest.kt new file mode 100644 index 00000000..08383b72 --- /dev/null +++ b/tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/CompassTest.kt @@ -0,0 +1,40 @@ +package com.faceclaw.app + +import kotlin.test.* + +class CompassTest { + private fun hex(text: String) = text.chunked(2).map { it.toInt(16).toByte() }.toByteArray() + + @Test + fun receiverPayloadAndAndroidFrameDecodeTheSameCompassSample() { + val payload = hex("080f1000520308e702a2060c434d010302038c0098badcfe") + for (flag in listOf(1, 6)) { + val frame = BleProtocol.framePb(payload, 8, flag, 15).single() + val received = MessageReceiver().receive("R", frame, 0).single() + val shared = assertNotNull(BleProtocol.parseCompassPayload(received.sid, received.flag, received.payload)) + val android = assertNotNull(BleProtocol.parseCompassEvent(BleProtocol.parseFrame(frame))) + assertEquals(359, shared.headingDegrees) + assertEquals(15, shared.command) + assertEquals(3, shared.magneticAccuracy) + assertEquals(2, shared.magneticAnomalies) + assertEquals(3, shared.orientationSource) + assertEquals(0x8c, shared.diagnosticFlags) + assertEquals(0xfedcba98L, shared.sampleTimeMs) + assertEquals(android.sampleTimeMs, shared.sampleTimeMs) + } + assertNull(BleProtocol.parseCompassPayload(9, 1, payload)) + assertNull(BleProtocol.parseCompassPayload(8, 0x20, payload)) + assertNull(BleProtocol.parseCompassPayload(8, 1, hex("080f1000520308e802"))) + assertNull(BleProtocol.parseCompassPayload(8, 1, byteArrayOf())) + for (size in 9 until payload.size) { + val legacy = assertNotNull(BleProtocol.parseCompassPayload(8, 1, payload.copyOf(size))) + assertEquals(359, legacy.headingDegrees) + assertEquals(-1, legacy.diagnosticFlags) + } + for (command in listOf(16, 17)) { + val calibration = assertNotNull(BleProtocol.parseCompassPayload(8, 1, byteArrayOf(8, command.toByte(), 16, 0))) + assertEquals(command, calibration.command) + assertEquals(-1, calibration.headingDegrees) + } + } +} diff --git a/tests/kotlin/src/iosTest/kotlin/com/faceclaw/app/IosNativeApiTest.kt b/tests/kotlin/src/iosTest/kotlin/com/faceclaw/app/IosNativeApiTest.kt index 2d0f0191..b81255a5 100644 --- a/tests/kotlin/src/iosTest/kotlin/com/faceclaw/app/IosNativeApiTest.kt +++ b/tests/kotlin/src/iosTest/kotlin/com/faceclaw/app/IosNativeApiTest.kt @@ -22,6 +22,14 @@ class IosNativeApiTest { assertContentEquals(auth.byteArray(), result.payload.byteArray()) } + @Test + fun compassFacadePreservesTheEndOfTheCrcFreePayload() { + val protocol = IosProtocol() + val payload = byteArrayOf(8, 15, 16, 0, 82, 3, 8, -25, 2).data() + assertEquals(359, protocol.compassInput(payload, 8, 1)?.headingDegrees) + assertNull(protocol.compassInput(payload, 8, 0)) + } + @Test fun nativeCompositorClipsPartialUpdatesBeforeCoalescing() { val compositor = IosSurfaceCompositor(3, 2) From 9e18745e53216de6db4f5d4fcedfa98c91159231 Mon Sep 17 00:00:00 2001 From: James Babcock Date: Fri, 18 Sep 2026 23:46:27 -0700 Subject: [PATCH 23/99] Port navigate and weather --- App_Resources/iOS/Info.plist | 5 +- App_Resources/iOS/build.xcconfig | 2 +- App_Resources/iOS/src/FaceclawGraphics.h | 1 + App_Resources/iOS/src/FaceclawGraphics.m | 27 ++++ App_Resources/iOS/src/FaceclawLocation.h | 9 ++ App_Resources/iOS/src/FaceclawLocation.m | 96 ++++++++++++++ app/apps/ios-availability.ts | 2 - app/apps/navigate/index.ts | 2 +- app/apps/navigate/navigate-app.worker.ts | 43 +++--- .../navigate/navigation-sensors-messages.ts | 11 ++ app/apps/navigate/navigation-sensors.ios.ts | 45 +++++++ app/apps/navigate/navigation-sensors.ts | 13 ++ app/apps/weather/weather-app.ts | 10 +- app/g2/ios-preview-controller.ts | 8 +- app/native/image-bytes.ios.ts | 12 ++ app/native/image-bytes.ts | 7 + app/native/ios-navigation-sensors.ts | 56 ++++++++ app/native/kotlin-protocol-smoke.ios.ts | 5 + app/native/location-permissions.ios.ts | 4 + app/native/location-permissions.ts | 2 +- app/native/location-tracker.ios.ts | 25 ++++ app/native/location-tracker.ts | 18 +-- app/native/location-types.ts | 23 ++++ app/native/location.ios.ts | 19 +++ app/native/location.ts | 8 +- app/native/mapbox.ts | 9 +- app/native/open-url.ios.ts | 9 ++ app/native/weather.ts | 2 +- app/ui/shell/worker-window.ts | 14 ++ tests/ios-app-host.test.cjs | 2 + tests/ios-glanceboard.test.cjs | 1 + tests/ios-location.test.cjs | 122 ++++++++++++++++++ tests/navigate-worker.test.cjs | 78 +++++++++++ 33 files changed, 630 insertions(+), 60 deletions(-) create mode 100644 app/apps/navigate/navigation-sensors-messages.ts create mode 100644 app/apps/navigate/navigation-sensors.ios.ts create mode 100644 app/apps/navigate/navigation-sensors.ts create mode 100644 app/native/image-bytes.ios.ts create mode 100644 app/native/image-bytes.ts create mode 100644 app/native/ios-navigation-sensors.ts create mode 100644 app/native/location-tracker.ios.ts create mode 100644 app/native/location-types.ts create mode 100644 app/native/location.ios.ts create mode 100644 app/native/open-url.ios.ts create mode 100644 tests/ios-location.test.cjs create mode 100644 tests/navigate-worker.test.cjs diff --git a/App_Resources/iOS/Info.plist b/App_Resources/iOS/Info.plist index b63a4b01..b79da82a 100644 --- a/App_Resources/iOS/Info.plist +++ b/App_Resources/iOS/Info.plist @@ -23,10 +23,13 @@ NSSpeechRecognitionUsageDescription Faceclaw turns audio from your glasses microphone into text for the app you choose. Dictation uses on-device recognition. NSLocationWhenInUseUsageDescription - Faceclaw uses your location to correct the glasses compass from magnetic north to true north. + Faceclaw uses your location for local weather, turn-by-turn navigation, and true north on the glasses compass. + NSLocationTemporaryUsageDescriptionDictionary + NavigationPrecise location lets Faceclaw follow your route and show upcoming turns on your glasses. UIBackgroundModes bluetooth-central + location NSAppTransportSecurity diff --git a/App_Resources/iOS/build.xcconfig b/App_Resources/iOS/build.xcconfig index fdc60547..d6de5450 100644 --- a/App_Resources/iOS/build.xcconfig +++ b/App_Resources/iOS/build.xcconfig @@ -3,7 +3,7 @@ TARGETED_DEVICE_FAMILY = 1; CODE_SIGN_STYLE = Automatic; // Select the local signing team in Xcode or pass --teamId to the iOS scripts. -OTHER_LDFLAGS = $(inherited) -framework CoreBluetooth -framework CoreLocation -framework CoreText -framework Speech -framework AVFoundation -framework WebKit -framework UniformTypeIdentifiers +OTHER_LDFLAGS = $(inherited) -framework CoreBluetooth -framework CoreLocation -framework CoreText -framework Speech -framework AVFoundation -framework WebKit -framework UniformTypeIdentifiers -framework ImageIO ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; diff --git a/App_Resources/iOS/src/FaceclawGraphics.h b/App_Resources/iOS/src/FaceclawGraphics.h index 3dc2e7d5..333f6bc2 100644 --- a/App_Resources/iOS/src/FaceclawGraphics.h +++ b/App_Resources/iOS/src/FaceclawGraphics.h @@ -3,4 +3,5 @@ @interface FaceclawGraphics : NSObject + (UIImage *)preview:(NSData *)gray width:(NSInteger)width height:(NSInteger)height green:(BOOL)green; + (NSData *)renderSVG:(NSString *)svg size:(NSInteger)size; ++ (NSData *)decodeImage:(NSData *)data width:(NSInteger)width height:(NSInteger)height; @end diff --git a/App_Resources/iOS/src/FaceclawGraphics.m b/App_Resources/iOS/src/FaceclawGraphics.m index 96a5e25e..361e7353 100644 --- a/App_Resources/iOS/src/FaceclawGraphics.m +++ b/App_Resources/iOS/src/FaceclawGraphics.m @@ -1,7 +1,34 @@ #import "FaceclawGraphics.h" #import +#import @implementation FaceclawGraphics ++ (NSData *)decodeImage:(NSData *)data width:(NSInteger)width height:(NSInteger)height { + if (!data.length || width <= 0 || height <= 0 || width > 2048 || height > 2048) return nil; + CGImageSourceRef source = CGImageSourceCreateWithData((__bridge CFDataRef)data, NULL); + if (!source) return nil; + NSDictionary *options = @{(id)kCGImageSourceCreateThumbnailFromImageAlways: @YES, + (id)kCGImageSourceCreateThumbnailWithTransform: @YES, + (id)kCGImageSourceThumbnailMaxPixelSize: @(MAX(width, height))}; + CGImageRef image = CGImageSourceCreateThumbnailAtIndex(source, 0, (__bridge CFDictionaryRef)options); + CFRelease(source); + if (!image) return nil; + NSMutableData *rgba = [NSMutableData dataWithLength:width * height * 4]; + CGColorSpaceRef space = CGColorSpaceCreateDeviceRGB(); + CGContextRef context = CGBitmapContextCreate(rgba.mutableBytes, width, height, 8, width * 4, space, + kCGBitmapByteOrder32Big | (CGBitmapInfo)kCGImageAlphaPremultipliedLast); + CGColorSpaceRelease(space); + if (!context) { CGImageRelease(image); return nil; } + // ImageIO applies image orientation; the bitmap's row order is top-to-bottom. + CGContextDrawImage(context, CGRectMake(0, 0, width, height), image); + NSMutableData *gray = [NSMutableData dataWithLength:width * height]; + const uint8_t *src = rgba.bytes; + uint8_t *dst = gray.mutableBytes; + for (NSInteger i = 0; i < width * height; i++) + dst[i] = (uint8_t)round(0.2126 * src[i * 4] + 0.7152 * src[i * 4 + 1] + 0.0722 * src[i * 4 + 2]); + CGContextRelease(context); CGImageRelease(image); + return gray; +} + (UIImage *)preview:(NSData *)gray width:(NSInteger)width height:(NSInteger)height green:(BOOL)green { if (width <= 0 || height <= 0 || gray.length != width * height) return nil; NSMutableData *rgba = [NSMutableData dataWithLength:width * height * 4]; diff --git a/App_Resources/iOS/src/FaceclawLocation.h b/App_Resources/iOS/src/FaceclawLocation.h index 53aaa101..9045fbf3 100644 --- a/App_Resources/iOS/src/FaceclawLocation.h +++ b/App_Resources/iOS/src/FaceclawLocation.h @@ -5,5 +5,14 @@ + (instancetype)shared; - (BOOL)hasPermission; - (void)requestPermission:(void (^)(BOOL granted))completion; +- (void)requestPrecisePermission:(void (^)(BOOL granted))completion; - (void)requestDeclination:(void (^)(double degrees, double latitude, double longitude, NSString *error))completion; @end + +/** Each lookup/stream owns a separate manager, so stopping one never stops another. Main thread only. */ +@interface FaceclawLocationUpdates : NSObject +@property(nonatomic, copy) void (^eventHandler)(NSString *json); +- (void)startOnce; +- (void)startTracking:(NSInteger)intervalMs; +- (void)stop; +@end diff --git a/App_Resources/iOS/src/FaceclawLocation.m b/App_Resources/iOS/src/FaceclawLocation.m index 1f8872ef..0e9b175f 100644 --- a/App_Resources/iOS/src/FaceclawLocation.m +++ b/App_Resources/iOS/src/FaceclawLocation.m @@ -47,6 +47,17 @@ for (void (^callback)(BOOL) in callbacks) callback([self hasPermission]); if (![self hasPermission]) [self finishWithError:@"Location permission is required for true north"]; } +- (void)requestPrecisePermission:(void (^)(BOOL))completion { + [self requestPermission:^(BOOL granted) { + if (!granted || self.manager.accuracyAuthorization == CLAccuracyAuthorizationFullAccuracy) { + completion(granted); + return; + } + [self.manager requestTemporaryFullAccuracyAuthorizationWithPurposeKey:@"Navigation" completion:^(NSError *error) { + completion([self hasPermission] && self.manager.accuracyAuthorization == CLAccuracyAuthorizationFullAccuracy); + }]; + }]; +} - (void)requestDeclination:(void (^)(double, double, double, NSString *))completion { if (![self hasPermission] || ![CLLocationManager headingAvailable]) { completion(0, 0, 0, @"Location or heading unavailable for true north"); @@ -99,3 +110,88 @@ callback(degrees, coordinate.latitude, coordinate.longitude, error); } @end + +@interface FaceclawLocationUpdates () +@property(nonatomic, strong) CLLocationManager *manager; +@property(nonatomic, strong) NSTimer *timeout; +@property(nonatomic) BOOL running; +@property(nonatomic) BOOL once; +@property(nonatomic) NSTimeInterval interval; +@property(nonatomic) NSTimeInterval lastTimestamp; +@end + +@implementation FaceclawLocationUpdates +- (void)startOnce { [self start:YES interval:0]; } +- (void)startTracking:(NSInteger)intervalMs { [self start:NO interval:MAX(500, intervalMs) / 1000.0]; } +- (void)start:(BOOL)once interval:(NSTimeInterval)interval { + if (self.running) return; + self.once = once; self.interval = interval; self.lastTimestamp = 0; + self.manager = [CLLocationManager new]; + self.manager.delegate = self; + CLAuthorizationStatus status = self.manager.authorizationStatus; + if (status != kCLAuthorizationStatusAuthorizedAlways && status != kCLAuthorizationStatusAuthorizedWhenInUse) { + [self fail:@"Location permission is required. Allow location in the phone's Settings, then retry."]; return; + } + if (!once && self.manager.accuracyAuthorization != CLAccuracyAuthorizationFullAccuracy) { + [self fail:@"Precise location is required for navigation. Enable Precise Location in the phone's Settings."]; return; + } + self.running = YES; + self.manager.desiredAccuracy = once ? kCLLocationAccuracyKilometer : kCLLocationAccuracyBestForNavigation; + self.manager.distanceFilter = kCLDistanceFilterNone; + if (!once) { + self.manager.activityType = CLActivityTypeOtherNavigation; + self.manager.pausesLocationUpdatesAutomatically = NO; + self.manager.allowsBackgroundLocationUpdates = YES; + self.manager.showsBackgroundLocationIndicator = YES; + } + [self.manager startUpdatingLocation]; + if (once) self.timeout = [NSTimer scheduledTimerWithTimeInterval:20 repeats:NO block:^(NSTimer *timer) { + [self fail:@"Couldn't get a current location. Check Location Services and retry."]; + }]; +} +- (void)stop { + self.running = NO; + [self.timeout invalidate]; self.timeout = nil; + [self.manager stopUpdatingLocation]; + self.manager.delegate = nil; self.manager = nil; + self.eventHandler = nil; +} +- (void)emit:(NSDictionary *)event { + NSData *data = [NSJSONSerialization dataWithJSONObject:event options:0 error:nil]; + if (data && self.eventHandler) self.eventHandler([[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding]); +} +- (void)fail:(NSString *)message { + void (^handler)(NSString *) = self.eventHandler; + [self stop]; + NSData *data = [NSJSONSerialization dataWithJSONObject:@{@"error": message} options:0 error:nil]; + if (handler) handler([[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding]); +} +- (void)locationManagerDidChangeAuthorization:(CLLocationManager *)manager { + if (!self.running) return; + CLAuthorizationStatus status = manager.authorizationStatus; + if (status == kCLAuthorizationStatusDenied || status == kCLAuthorizationStatusRestricted || + (!self.once && manager.accuracyAuthorization != CLAccuracyAuthorizationFullAccuracy)) + [self fail:@"Location permission changed. Allow precise location in the phone's Settings, then retry."]; +} +- (void)locationManager:(CLLocationManager *)manager didUpdateLocations:(NSArray *)locations { + if (!self.running) return; + CLLocation *fix = locations.lastObject; + if (!fix || fix.horizontalAccuracy < 0 || fabs(fix.timestamp.timeIntervalSinceNow) > 60) return; + NSTimeInterval timestamp = fix.timestamp.timeIntervalSince1970; + if (self.lastTimestamp && timestamp - self.lastTimestamp < self.interval) return; + self.lastTimestamp = timestamp; + NSDictionary *event = @{@"latitude": @(fix.coordinate.latitude), @"longitude": @(fix.coordinate.longitude), + @"accuracyMeters": @(fix.horizontalAccuracy), @"timestampMs": @(timestamp * 1000), + @"bearingDeg": fix.course >= 0 ? @(fix.course) : NSNull.null, + @"speedMps": fix.speed >= 0 ? @(fix.speed) : NSNull.null}; + if (self.once) { + void (^handler)(NSString *) = self.eventHandler; + [self stop]; + NSData *data = [NSJSONSerialization dataWithJSONObject:event options:0 error:nil]; + if (handler) handler([[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding]); + } else [self emit:event]; +} +- (void)locationManager:(CLLocationManager *)manager didFailWithError:(NSError *)error { + if (self.running && error.code != kCLErrorLocationUnknown) [self fail:error.localizedDescription]; +} +@end diff --git a/app/apps/ios-availability.ts b/app/apps/ios-availability.ts index bae12f44..52de7cfd 100644 --- a/app/apps/ios-availability.ts +++ b/app/apps/ios-availability.ts @@ -4,8 +4,6 @@ const unavailable: Record = { notifications: 'Phone notification integration is not available on iOS yet.', transcribe: 'Voice capture and transcription are not available on iOS yet.', microphones: 'Glasses microphone capture is not available on iOS yet.', - navigate: 'Navigation location tracking is not available on iOS yet.', - weather: 'Weather location access is not available on iOS yet.', calendar: 'Calendar access is not available on iOS yet.', evenhub: 'Open a local .ehpk file in Files to run an EvenHub app. The EvenHub store is not available on iOS yet.', } diff --git a/app/apps/navigate/index.ts b/app/apps/navigate/index.ts index a6f2c0cf..6f02096d 100644 --- a/app/apps/navigate/index.ts +++ b/app/apps/navigate/index.ts @@ -1,4 +1,4 @@ -import { ensureFineLocationPermission } from "../../g2/android-permissions"; +import { ensureFineLocationPermission } from "../../native/location-permissions"; import { launchWorkerAppWindow, type AppDefinition } from "../app-definition"; const navigateApp: AppDefinition = { diff --git a/app/apps/navigate/navigate-app.worker.ts b/app/apps/navigate/navigate-app.worker.ts index 3eff4595..1334515b 100644 --- a/app/apps/navigate/navigate-app.worker.ts +++ b/app/apps/navigate/navigate-app.worker.ts @@ -64,7 +64,7 @@ import { GESTURE_SHORT_THEN_LONG_PRESS, type InputEvent, } from "../../ui/gestures"; -import { LocationTracker, type TrackedLocation } from "../../native/location-tracker"; +import { LocationTracker, type TrackedLocation } from "./navigation-sensors"; import { fetchRoute, fetchStaticMapGray, @@ -76,8 +76,8 @@ import { type RouteProfile, type StaticMapCamera, } from "../../native/mapbox"; -import { addCompassListener, COMPASS_CHANGED, setCompassEnabled, type CompassEvent } from "../../native/compass"; -import { magneticDeclinationDegrees } from "../../native/geomagnetic"; +import { addCompassListener, COMPASS_CHANGED, setCompassEnabled, type CompassEvent } from "./navigation-sensors"; +import { magneticDeclinationDegrees, handleNavigationSensorEvent } from "./navigation-sensors"; import { calibrateHeading, normalizeHeading } from "../compass/calibration"; import { bearingDegrees, haversineMeters, RouteFollower, type RouteProgress } from "./route-follower"; import { drawManeuverGlyph } from "./maneuver-icons"; @@ -184,6 +184,8 @@ let lastRerouteAtMs = 0; let rerouteInFlight = false; /** Bumped on every new route/mode so stale map fetches can be discarded. */ let routeGeneration = 0; +/** Invalidates GPS/geocoding/routing work when the route is replaced or closed. */ +let navigationGeneration = 0; /** * Where to go: free text to geocode (optionally shown under a saved @@ -239,7 +241,6 @@ let compassActive = false; let unsubscribeCompass: (() => void) | null = null; /** Wearer's true heading (degrees clockwise from north) as last drawn, or null before compass data arrives. */ let headHeadingDeg: number | null = null; -let declinationCache: { latitude: number; longitude: number; degrees: number | null } | null = null; let tickTimer: ReturnType | null = null; let firstFixWaiters: Array<(fix: TrackedLocation) => void> = []; @@ -274,6 +275,9 @@ post({ type: "worker-ready" }); global.onmessage = (event: { data: WorkerAppMessage }) => { const message = event.data; switch (message.type) { + case "navigation-sensors": + handleNavigationSensorEvent(message.event); + break; case "open-window": window = { windowId: message.windowId, @@ -390,6 +394,8 @@ async function startNavigationTo(target: NavTarget, requestedProfile: RouteProfi render(); throw new Error(statusMessage); } + const generation = ++navigationGeneration; + const checkCurrent = () => { if (generation !== navigationGeneration) throw new Error("Navigation cancelled."); }; const hadActiveRoute = phase === "navigating" && follower !== null; const previous = { destination, @@ -404,6 +410,7 @@ async function startNavigationTo(target: NavTarget, requestedProfile: RouteProfi render(); ensureTracking(); const fix = await waitForFix(); + checkCurrent(); phase = "routing"; let picked: GeocodeCandidate; @@ -420,6 +427,7 @@ async function startNavigationTo(target: NavTarget, requestedProfile: RouteProfi statusMessage = `Finding ${query}...`; render(); candidates = await geocodeForward(query, fix, 5); + checkCurrent(); if (!candidates.length) { throw new Error(`No places found matching "${query}".`); } @@ -432,6 +440,7 @@ async function startNavigationTo(target: NavTarget, requestedProfile: RouteProfi statusMessage = `Routing to ${destinationName}...`; render(); const route = await fetchRoute(fix, destination, profile); + checkCurrent(); adoptRoute(route); // Saved destinations already have a row of their own on the idle page; // everything else (voice, assistant, a re-picked recent) goes on the @@ -447,6 +456,7 @@ async function startNavigationTo(target: NavTarget, requestedProfile: RouteProfi if (window) post({ type: "focus-window", windowId: window.windowId }); return startSummary(picked, candidates, route); } catch (error) { + if (generation !== navigationGeneration) throw error; const message = String((error as Error)?.message ?? error); statusMessage = message; // A failed new destination shouldn't kill guidance that was already @@ -484,6 +494,7 @@ function adoptRoute(route: Route): void { } function stopNavigation(finalStatus: string): void { + ++navigationGeneration; phase = "idle"; statusMessage = finalStatus; follower = null; @@ -533,14 +544,16 @@ function handleFix(fix: TrackedLocation): void { async function maybeReroute(fix: TrackedLocation): Promise { if (rerouteInFlight || !destination) return; if (Date.now() - lastRerouteAtMs < REROUTE_MIN_INTERVAL_MS) return; + const generation = navigationGeneration; rerouteInFlight = true; lastRerouteAtMs = Date.now(); statusMessage = "Rerouting..."; render(); try { const route = await fetchRoute(fix, destination, profile); - if (phase === "navigating") adoptRoute(route); + if (generation === navigationGeneration && phase === "navigating") adoptRoute(route); } catch (error) { + if (generation !== navigationGeneration) return; statusMessage = `Reroute failed: ${String((error as Error)?.message ?? error)}`; render(); } finally { @@ -601,7 +614,9 @@ function handleCompassEvent(event: CompassEvent): void { // Wearer-fit offset from the Compass app's calibration, then declination // from our own GPS fix: the map is always true-north referenced. const magnetic = calibrateHeading(event.headingDegrees); - const heading = normalizeHeading(magnetic + (currentDeclination() ?? 0)); + const correction = currentDeclination(); + if (correction === null) return; // Keep the travel-direction arrow until true north is known. + const heading = normalizeHeading(magnetic + correction); if (headHeadingDeg !== null && angularDistance(heading, headHeadingDeg) < HEADING_STEP_DEG) return; headHeadingDeg = heading; render(); @@ -609,19 +624,7 @@ function handleCompassEvent(event: CompassEvent): void { /** Declination at the last fix; it only varies over tens of kilometres, so cache per coarse position. */ function currentDeclination(): number | null { - if (!lastFix) return null; - if ( - !declinationCache || - Math.abs(declinationCache.latitude - lastFix.latitude) > 0.5 || - Math.abs(declinationCache.longitude - lastFix.longitude) > 0.5 - ) { - declinationCache = { - latitude: lastFix.latitude, - longitude: lastFix.longitude, - degrees: magneticDeclinationDegrees(lastFix.latitude, lastFix.longitude), - }; - } - return declinationCache.degrees; + return lastFix ? magneticDeclinationDegrees(lastFix.latitude, lastFix.longitude) : null; } function angularDistance(a: number, b: number): number { @@ -1123,7 +1126,7 @@ function tokenSetupEntries(): IdleEntry[] { detail: "Get a free token in the phone browser", run: () => { statusMessage = openUrlOnPhone(MAPBOX_TOKENS_URL) - ? "Opened mapbox.com on your phone. Copy your public token (pk...) and pick Edit token." + ? "Opening mapbox.com on your phone. Copy your public token (pk...) and pick Edit token." : "Could not open a browser on the phone. Visit account.mapbox.com/access-tokens to get a token."; }, }, diff --git a/app/apps/navigate/navigation-sensors-messages.ts b/app/apps/navigate/navigation-sensors-messages.ts new file mode 100644 index 00000000..964571a7 --- /dev/null +++ b/app/apps/navigate/navigation-sensors-messages.ts @@ -0,0 +1,11 @@ +import { type TrackedLocation } from '../../native/location-types' +import { type CompassEvent } from '../../native/compass-types' + +export type NavigationSensorRequest = + | { action: 'start'; id: number; intervalMs: number } + | { action: 'stop'; id: number } + | { action: 'compass'; enabled: boolean } +export type NavigationSensorEvent = + | { kind: 'location'; id: number; location: TrackedLocation } + | { kind: 'error'; id: number; message: string } + | { kind: 'compass'; event: CompassEvent; declination: number | null } diff --git a/app/apps/navigate/navigation-sensors.ios.ts b/app/apps/navigate/navigation-sensors.ios.ts new file mode 100644 index 00000000..2a8739e4 --- /dev/null +++ b/app/apps/navigate/navigation-sensors.ios.ts @@ -0,0 +1,45 @@ +import { type LocationTrackerCallbacks } from '../../native/location-types' +import { type CompassEvent } from '../../native/compass-types' +import { type NavigationSensorEvent, type NavigationSensorRequest } from './navigation-sensors-messages' +export { type TrackedLocation } from '../../native/location-types' +export { COMPASS_CHANGED, type CompassEvent } from '../../native/compass-types' +declare const global: any + +const listeners = new Set<(event: CompassEvent) => void>() +const trackers = new Map() +let nextId = 0 +let declination: number | null = null +function send(request: NavigationSensorRequest): void { + global.postMessage({ type: 'navigation-sensors', request }) +} +export class LocationTracker { + private id = 0 + constructor(private readonly callbacks: LocationTrackerCallbacks) {} + isRunning(): boolean { return this.id !== 0 } + start(intervalMs = 1000): void { + if (this.id) return + this.id = ++nextId; trackers.set(this.id, this) + send({ action: 'start', id: this.id, intervalMs }) + } + stop(): void { + if (!this.id) return + const id = this.id; this.id = 0; trackers.delete(id) + send({ action: 'stop', id }) + } + receive(event: NavigationSensorEvent): void { + if (event.kind === 'location') this.callbacks.onLocation(event.location) + else if (event.kind === 'error') { this.stop(); this.callbacks.onError(event.message) } + } +} +export function handleNavigationSensorEvent(event: NavigationSensorEvent): void { + if (event.kind === 'compass') { + declination = event.declination + for (const listener of [...listeners]) listener(event.event) + } else trackers.get(event.id)?.receive(event) +} +export function addCompassListener(listener: (event: CompassEvent) => void): () => void { + listeners.add(listener) + return () => { listeners.delete(listener) } +} +export function setCompassEnabled(enabled: boolean, _owner?: string): void { send({ action: 'compass', enabled }) } +export function magneticDeclinationDegrees(_latitude: number, _longitude: number): number | null { return declination } diff --git a/app/apps/navigate/navigation-sensors.ts b/app/apps/navigate/navigation-sensors.ts new file mode 100644 index 00000000..4bf4793d --- /dev/null +++ b/app/apps/navigate/navigation-sensors.ts @@ -0,0 +1,13 @@ +import { type NavigationSensorEvent } from './navigation-sensors-messages' +export { LocationTracker, type TrackedLocation } from '../../native/location-tracker' +export { addCompassListener, setCompassEnabled, COMPASS_CHANGED, type CompassEvent } from '../../native/compass' +import { magneticDeclinationDegrees as calculate } from '../../native/geomagnetic' +let cached: { latitude: number; longitude: number; degrees: number | null } | null = null +export function magneticDeclinationDegrees(latitude: number, longitude: number): number | null { + if (!cached || Math.abs(latitude - cached.latitude) > 0.5 || Math.abs(longitude - cached.longitude) > 0.5) + cached = { latitude, longitude, degrees: calculate(latitude, longitude) } + return cached.degrees +} + +/** Android delivers native callbacks directly on the worker's Looper. */ +export function handleNavigationSensorEvent(_event: NavigationSensorEvent): void {} diff --git a/app/apps/weather/weather-app.ts b/app/apps/weather/weather-app.ts index 5636af1a..a0efec28 100644 --- a/app/apps/weather/weather-app.ts +++ b/app/apps/weather/weather-app.ts @@ -1,4 +1,4 @@ -import { ensureLocationPermission, hasLocationPermission } from "../../g2/android-permissions"; +import { ensureLocationPermission, hasLocationPermission } from "../../native/location-permissions"; import { weatherBridge } from "../../native/weather"; import { WeatherLayer } from "./weather"; import { @@ -13,12 +13,13 @@ export const WEATHER_SURFACE_ID = "window:weather"; /** Local current conditions and forecast from the National Weather Service. */ export function createWeatherAppWindow(options: InProcessAppOptions): InProcessWindow { + let closed = false; let requestingPermission = false; let unsubscribe: (() => void) | null = null; let app: InProcessWindow; const requestUpdate = () => { - if (requestingPermission) return; + if (closed || requestingPermission) return; if (hasLocationPermission()) { weatherBridge.start(); return; @@ -26,9 +27,10 @@ export function createWeatherAppWindow(options: InProcessAppOptions): InProcessW requestingPermission = true; void ensureLocationPermission().then((granted) => { requestingPermission = false; + if (closed) return; if (granted) weatherBridge.start(); app.requestRender(); - }); + }).catch((error) => { requestingPermission = false; console.warn(`Weather permission: ${error}`); }); }; app = createInProcessWindow({ @@ -52,7 +54,9 @@ export function createWeatherAppWindow(options: InProcessAppOptions): InProcessW submitFrame: options.submitFrame, setSurfaceVisible: options.setSurfaceVisible, removeSurface: options.removeSurface, + reconfigureSurface: options.reconfigureSurface, onClosed: () => { + closed = true; unsubscribe?.(); unsubscribe = null; weatherBridge.stop(); diff --git a/app/g2/ios-preview-controller.ts b/app/g2/ios-preview-controller.ts index 1f0b0a51..dd4f927e 100644 --- a/app/g2/ios-preview-controller.ts +++ b/app/g2/ios-preview-controller.ts @@ -1,3 +1,5 @@ +import { IosNavigationSensors } from '../native/ios-navigation-sensors' +import { Utils } from '@nativescript/core' import { bindCompassSession, receiveCompassEvent } from '../native/compass.ios' import { Dialogs, File, knownFolders, path, type ImageSource } from '@nativescript/core' import { iosBluetooth } from '../native/ios-bluetooth' @@ -331,8 +333,12 @@ export class IosPreviewController { private ensureWorkerHost(appId: string, create: () => Worker): WorkerAppHost { const existing = this.appHosts.get(appId) if (existing) return existing + const worker = create() + const navigationSensors = appId === 'navigate' + ? new IosNavigationSensors(event => worker.postMessage({ type: 'navigation-sensors', event })) : undefined const host = new WorkerAppHost({ - appId, worker: create(), + appId, worker, navigationSensors, + openUrl: url => { void Utils.openUrl(url) }, configureSurface: async (id, visible, heightMode) => { this.compositor.configureSurface(id, { ...appViewportRect(heightMode, appId), zOrder: 0, transparency: 'opaque' }) this.compositor.setSurfaceVisible(id, visible) diff --git a/app/native/image-bytes.ios.ts b/app/native/image-bytes.ios.ts new file mode 100644 index 00000000..d5cac1c7 --- /dev/null +++ b/app/native/image-bytes.ios.ts @@ -0,0 +1,12 @@ +import { GrayImage } from '../graphics/image' +import { toData, fromData } from './kotlin-data' +declare const FaceclawGraphics: any + +/** Native image decoding and grayscale conversion, safe on a rendering worker. */ +export function decodeImageBytes(bytes: ArrayBuffer, width: number, height: number): GrayImage | null { + const data = FaceclawGraphics.decodeImageWidthHeight(toData(new Uint8Array(bytes)), width, height) + if (!data) return null + const image = new GrayImage(width, height, 0) + image.pixels.set(fromData(data)) + return image +} diff --git a/app/native/image-bytes.ts b/app/native/image-bytes.ts new file mode 100644 index 00000000..12c7fd5e --- /dev/null +++ b/app/native/image-bytes.ts @@ -0,0 +1,7 @@ +import { grayImageFromPacket } from './image-files' +import { type GrayImage } from '../graphics/image' +declare const com: any + +export function decodeImageBytes(bytes: ArrayBuffer, width: number, height: number): GrayImage | null { + return grayImageFromPacket(com.faceclaw.app.ImageFileLoader.loadGrayFromBytes(bytes, width, height)) +} diff --git a/app/native/ios-navigation-sensors.ts b/app/native/ios-navigation-sensors.ts new file mode 100644 index 00000000..36580bd1 --- /dev/null +++ b/app/native/ios-navigation-sensors.ts @@ -0,0 +1,56 @@ +import { LocationTracker } from './location-tracker.ios' +import { ensureFineLocationPermission } from './location-permissions.ios' +import { addCompassListener, setCompassEnabled } from './compass.ios' +import { getDeclinationDegrees, refreshDeclination } from '../apps/compass/declination' +import { type NavigationSensorEvent, type NavigationSensorRequest } from '../apps/navigate/navigation-sensors-messages' + +/** Core Location stays on main; the shared Navigate worker receives only JSON. */ +export class IosNavigationSensors { + private generation = 0 + private id = 0 + private tracker: LocationTracker | null = null + private offCompass: (() => void) | null = null + private readonly owner = 'worker:navigate' + constructor(private readonly reply: (event: NavigationSensorEvent) => void) {} + handle(request: NavigationSensorRequest): void { + if (request.action === 'compass') { + if (request.enabled && !this.offCompass) { + refreshDeclination() + this.offCompass = addCompassListener(event => this.reply({ kind: 'compass', event, declination: getDeclinationDegrees() })) + } else if (!request.enabled) { this.offCompass?.(); this.offCompass = null } + setCompassEnabled(request.enabled, this.owner) + } else if (request.action === 'stop') { + if (request.id === this.id) this.stopLocation() + } else { + this.stopLocation(); this.id = request.id + const generation = this.generation + void ensureFineLocationPermission().then(granted => { + if (generation !== this.generation) return + if (!granted) throw new Error('Precise location is required for navigation. Enable it in the phone’s Settings, then retry.') + refreshDeclination() + this.tracker = new LocationTracker({ + onLocation: location => { + if (generation === this.generation) this.reply({ kind: 'location', id: request.id, location }) + }, + onError: message => { + if (generation !== this.generation) return + this.stopLocation(); this.reply({ kind: 'error', id: request.id, message }) + }, + }) + this.tracker.start(request.intervalMs) + }).catch(error => { + if (generation !== this.generation) return + this.stopLocation(); this.reply({ kind: 'error', id: request.id, message: String(error.message ?? error) }) + }) + } + } + private stopLocation(): void { + ++this.generation; this.id = 0 + this.tracker?.stop(); this.tracker = null + } + stop(): void { + this.stopLocation() + this.offCompass?.(); this.offCompass = null + setCompassEnabled(false, this.owner) + } +} diff --git a/app/native/kotlin-protocol-smoke.ios.ts b/app/native/kotlin-protocol-smoke.ios.ts index b7c964f6..390f662f 100644 --- a/app/native/kotlin-protocol-smoke.ios.ts +++ b/app/native/kotlin-protocol-smoke.ios.ts @@ -1,3 +1,4 @@ +import { decodeImageBytes } from './image-bytes.ios' import * as protocol from '../g2/ble-protocol.ios' import { CfwTransport, parseCfwAcks } from '../g2/cfw-transport.ios' import { SurfaceCompositor } from '../graphics/surface-compositor.ios' @@ -36,5 +37,9 @@ export function runKotlinProtocolSmokeTest(): void { payload: new Uint8Array([8, 15, 16, 0, 82, 3, 8, 231, 2, 162, 6, 12, 67, 77, 1, 3, 2, 3, 140, 0, 152, 186, 220, 254]) }) if (compass?.headingDegrees !== 359 || compass.diagnostics?.sampleTimeMs !== 0xfedcba98) throw new Error('Kotlin compass notification mismatch') + const png = NSData.alloc().initWithBase64EncodedStringOptions('iVBORw0KGgoAAAANSUhEUgAAAAIAAAACCAIAAAD91JpzAAAAEklEQVR4nGP4z8DAAMIM/4EAAB/uBfsL2WiLAAAAAElFTkSuQmCC', 0 as NSDataBase64DecodingOptions) + const decoded = decodeImageBytes(interop.bufferFromData(png), 2, 2) + assert(!!decoded && Array.from(decoded.pixels).join(',') === '54,182,18,255', 'native map image orientation and grayscale') + assert(decodeImageBytes(new ArrayBuffer(0), 2, 2) === null, 'invalid map image') console.log('FACECLAW_KOTLIN_PROTOCOL_PASS iOS') } diff --git a/app/native/location-permissions.ios.ts b/app/native/location-permissions.ios.ts index aa668f93..4a8fc468 100644 --- a/app/native/location-permissions.ios.ts +++ b/app/native/location-permissions.ios.ts @@ -3,3 +3,7 @@ export const hasLocationPermission = (): boolean => FaceclawLocation.shared().ha export function ensureLocationPermission(): Promise { return new Promise(resolve => FaceclawLocation.shared().requestPermission(resolve)) } + +export function ensureFineLocationPermission(): Promise { + return new Promise(resolve => FaceclawLocation.shared().requestPrecisePermission(resolve)) +} diff --git a/app/native/location-permissions.ts b/app/native/location-permissions.ts index c4776a51..7d05f8b3 100644 --- a/app/native/location-permissions.ts +++ b/app/native/location-permissions.ts @@ -1 +1 @@ -export { ensureLocationPermission, hasLocationPermission } from '../g2/android-permissions' +export { ensureLocationPermission, ensureFineLocationPermission, hasLocationPermission } from '../g2/android-permissions' diff --git a/app/native/location-tracker.ios.ts b/app/native/location-tracker.ios.ts new file mode 100644 index 00000000..da4b8a4d --- /dev/null +++ b/app/native/location-tracker.ios.ts @@ -0,0 +1,25 @@ +import { type LocationTrackerCallbacks } from './location-types' +export { type TrackedLocation, type LocationTrackerCallbacks } from './location-types' +declare const FaceclawLocationUpdates: any + +/** Owned by the main-thread iOS sensor host; JSON fixes are relayed to app workers. */ +export class LocationTracker { + private native: any = null + constructor(private readonly callbacks: LocationTrackerCallbacks) {} + isRunning(): boolean { return this.native !== null } + start(intervalMs = 1000): void { + if (this.native) return + const native = this.native = FaceclawLocationUpdates.new() + native.eventHandler = (json: string) => { + if (this.native !== native) return + const event = JSON.parse(json) + if (event.error) { this.stop(); this.callbacks.onError(event.error) } + else this.callbacks.onLocation(event) + } + native.startTracking(intervalMs) + } + stop(): void { + const native = this.native; this.native = null + native?.stop() + } +} diff --git a/app/native/location-tracker.ts b/app/native/location-tracker.ts index 6487ddb6..f087a650 100644 --- a/app/native/location-tracker.ts +++ b/app/native/location-tracker.ts @@ -9,22 +9,8 @@ import { Utils } from "@nativescript/core"; declare const com: any; declare const global: any; -export type TrackedLocation = { - latitude: number; - longitude: number; - /** Meters, or null when the fix doesn't report accuracy. */ - accuracyMeters: number | null; - /** Degrees clockwise from true north, or null (common when stationary). */ - bearingDeg: number | null; - /** Meters per second, or null. */ - speedMps: number | null; - timestampMs: number; -}; - -export type LocationTrackerCallbacks = { - onLocation: (location: TrackedLocation) => void; - onError: (message: string) => void; -}; +import { type LocationTrackerCallbacks } from "./location-types"; +export { type LocationTrackerCallbacks, type TrackedLocation } from "./location-types"; export class LocationTracker { private tracker: any = null; diff --git a/app/native/location-types.ts b/app/native/location-types.ts new file mode 100644 index 00000000..bd29a813 --- /dev/null +++ b/app/native/location-types.ts @@ -0,0 +1,23 @@ +export type CurrentLocation = { + latitude: number; + longitude: number; + accuracyMeters: number | null; + timestampMs: number; +}; + +export type TrackedLocation = { + latitude: number; + longitude: number; + /** Meters, or null when the fix doesn't report accuracy. */ + accuracyMeters: number | null; + /** Degrees clockwise from true north, or null (common when stationary). */ + bearingDeg: number | null; + /** Meters per second, or null. */ + speedMps: number | null; + timestampMs: number; +}; + +export type LocationTrackerCallbacks = { + onLocation: (location: TrackedLocation) => void; + onError: (message: string) => void; +}; diff --git a/app/native/location.ios.ts b/app/native/location.ios.ts new file mode 100644 index 00000000..886b6e77 --- /dev/null +++ b/app/native/location.ios.ts @@ -0,0 +1,19 @@ +import { type CurrentLocation } from './location-types' +export { type CurrentLocation } from './location-types' +declare const FaceclawLocationUpdates: any + +/** Main-thread one-shot lookup, independent of navigation and compass managers. */ +export function getCurrentLocation(): Promise { + return new Promise((resolve, reject) => { + const provider = FaceclawLocationUpdates.new() + provider.eventHandler = (json: string) => { + try { + const event = JSON.parse(json) + if (event.error) reject(new Error(event.error)) + else resolve(event) + } catch (error) { reject(error) } + finally { provider.stop() } + } + provider.startOnce() + }) +} diff --git a/app/native/location.ts b/app/native/location.ts index e2b23abd..1dbafb0e 100644 --- a/app/native/location.ts +++ b/app/native/location.ts @@ -2,12 +2,8 @@ import { Utils } from "@nativescript/core"; declare const com: any; -export type CurrentLocation = { - latitude: number; - longitude: number; - accuracyMeters: number | null; - timestampMs: number; -}; +import { type CurrentLocation } from "./location-types"; +export { type CurrentLocation } from "./location-types"; /** Resolve one current foreground location using Android's LocationManager. */ export function getCurrentLocation(): Promise { diff --git a/app/native/mapbox.ts b/app/native/mapbox.ts index 364d9252..9f5ad8da 100644 --- a/app/native/mapbox.ts +++ b/app/native/mapbox.ts @@ -6,11 +6,9 @@ */ import { GrayImage } from "../graphics/image"; import { getStringSetting } from "./settings-store"; -import { grayImageFromPacket } from "./image-files"; +import { decodeImageBytes } from "./image-bytes"; import { fetchWithUserAgent } from "../util/http"; -declare const com: any; -declare const global: any; export const MAPBOX_TOKEN_SETTING_KEY = "maps.mapboxApiKey"; const SEARCH_ROOT = "https://api.mapbox.com/search/searchbox/v1"; @@ -231,10 +229,7 @@ export async function fetchStaticMapGray(options: { } throw new Error(`Mapbox static map failed (HTTP ${response.status}).`); } - if (!global.isAndroid) throw new Error("Map decoding is only available on Android."); - const image = grayImageFromPacket( - com.faceclaw.app.ImageFileLoader.loadGrayFromBytes(bytes, Math.round(options.width), Math.round(options.height)), - ); + const image = decodeImageBytes(bytes, Math.round(options.width), Math.round(options.height)); if (!image) throw new Error("Failed to decode the Mapbox map image."); return image; } diff --git a/app/native/open-url.ios.ts b/app/native/open-url.ios.ts new file mode 100644 index 00000000..6c9eac63 --- /dev/null +++ b/app/native/open-url.ios.ts @@ -0,0 +1,9 @@ +import { Utils } from '@nativescript/core' +declare const global: any + +export function openUrlOnPhone(url: string): boolean { + if (!/^https?:\/\//i.test(url)) return false + if (NSThread.isMainThread) void Utils.openUrl(url) + else global.postMessage({ type: 'open-url', url }) + return true +} diff --git a/app/native/weather.ts b/app/native/weather.ts index 8cc073e9..f1e98a5f 100644 --- a/app/native/weather.ts +++ b/app/native/weather.ts @@ -1,4 +1,4 @@ -import { hasLocationPermission } from "../g2/android-permissions"; +import { hasLocationPermission } from "./location-permissions"; import { getCurrentLocation, type CurrentLocation } from "./location"; import { fetchWithUserAgent } from "../util/http"; import { USER_AGENT } from "../version"; diff --git a/app/ui/shell/worker-window.ts b/app/ui/shell/worker-window.ts index 77966429..6f5f3251 100644 --- a/app/ui/shell/worker-window.ts +++ b/app/ui/shell/worker-window.ts @@ -1,3 +1,4 @@ +import { type NavigationSensorRequest, type NavigationSensorEvent } from "../../apps/navigate/navigation-sensors-messages"; import { GrayImage } from "../../graphics/image"; import { windowIcon } from "./chrome-layer"; import { type IconActivity, type IconName } from "../../graphics/icons"; @@ -14,6 +15,7 @@ import { publishWorkerState } from "./worker-state"; * worker→Java directly on Android; iOS posts baked frames to the main host. */ export type WorkerAppMessage = + | { type: "navigation-sensors"; event: NavigationSensorEvent } | { type: "open-window"; windowId: string; surfaceId: string; title: string; viewport: { width: number; height: number } } | { type: "resize-window"; windowId: string; viewport: { width: number; height: number } } | { type: "close-window"; windowId: string } @@ -32,6 +34,8 @@ export type WorkerAppMessage = | { type: "tool-call"; callId: string; windowId: string; name: string; args: unknown }; export type WorkerAppReply = + | { type: "navigation-sensors"; request: NavigationSensorRequest } + | { type: "open-url"; url: string } | { type: "surface-frame"; surfaceId: string; width: number; height: number; pixels: string } | { /** @@ -177,6 +181,8 @@ export type WorkerWindowSpec = { export type WorkerAppHostOptions = { appId: string; worker: Worker; + navigationSensors?: { handle(request: NavigationSensorRequest): void; stop(): void }; + openUrl?: (url: string) => void; /** Create/refresh a window surface on the compositor (no-op when disconnected). */ configureSurface: (surfaceId: string, visible: boolean, heightMode: WindowHeightMode) => Promise; setSurfaceVisible: (surfaceId: string, visible: boolean) => void; @@ -234,6 +240,12 @@ export class WorkerAppHost { const message = event.data as WorkerAppReply | undefined; if (!message) return; switch (message.type) { + case "navigation-sensors": + if (this.openWindows.size) this.options.navigationSensors?.handle(message.request); + break; + case "open-url": + if (this.openWindows.size && /^https?:\/\//i.test(message.url)) this.options.openUrl?.(message.url); + break; case "surface-frame": { if (!global.isIOS || !this.options.submitPixels || !this.openWindows.has(message.surfaceId.replace(/^window:/, ""))) break; const { width, height } = message; @@ -361,6 +373,7 @@ export class WorkerAppHost { } }; options.worker.onerror = (error) => { + options.navigationSensors?.stop(); console.error(`worker app ${options.appId} error: ${JSON.stringify(error)}`); }; } @@ -397,6 +410,7 @@ export class WorkerAppHost { claimsLongPress: () => this.windowGestures.get(spec.windowId)?.claimsLongPress ?? false, close: () => { this.openWindows.delete(spec.windowId); + if (!this.openWindows.size) this.options.navigationSensors?.stop(); this.windowGestures.delete(spec.windowId); this.windowIconActivity.delete(spec.windowId); // Withdraw this window's tools and fail any in-flight calls to it. diff --git a/tests/ios-app-host.test.cjs b/tests/ios-app-host.test.cjs index e81d37a2..e7374bad 100644 --- a/tests/ios-app-host.test.cjs +++ b/tests/ios-app-host.test.cjs @@ -89,6 +89,7 @@ test('background glasses input still composites frames; phone resume preserves t } const settings = { onAnySettingChanged: () => () => {}, previewColorSetting: { get: () => 'white' } }; const modules = { + "../native/ios-navigation-sensors": {}, '../native/compass.ios': { bindCompassSession() {}, receiveCompassEvent() {} }, '@nativescript/core': { File: { fromPath: () => ({ writeTextSync() {} }) }, knownFolders: { documents: () => ({ path: '/tmp' }) }, path }, '../native/ios-voice-input': { iosVoiceInput: { handleSessionEnded() {} } }, @@ -157,6 +158,7 @@ test('iOS bandwidth footer toggles live, polls only in foreground and resets its on: (key, fn) => appEvents.set(key, fn), off: key => appEvents.delete(key) }, Button: View, Color: class {}, Dialogs: {}, GridLayout: View, Image: View, Label: View, Page: View, StackLayout: View }; const modules = { + "../native/ios-navigation-sensors": {}, '../native/compass.ios': { bindCompassSession() {}, receiveCompassEvent() {} }, '@nativescript/core': core, '../apps/all-apps': { ALL_APPS: [] }, diff --git a/tests/ios-glanceboard.test.cjs b/tests/ios-glanceboard.test.cjs index eb518f36..86f8cadd 100644 --- a/tests/ios-glanceboard.test.cjs +++ b/tests/ios-glanceboard.test.cjs @@ -68,6 +68,7 @@ function fixture() { paint: () => { boardStats.paints++; return new images.GrayImage(100, 80, 200); } }), }; const modules = { + "../native/ios-navigation-sensors": {}, "../native/compass.ios": { bindCompassSession() {}, receiveCompassEvent() {} }, '@nativescript/core': { File: { fromPath: () => ({ writeTextSync() {} }) }, knownFolders: { documents: () => ({ path: '/tmp' }) }, path }, diff --git a/tests/ios-location.test.cjs b/tests/ios-location.test.cjs new file mode 100644 index 00000000..01f384e7 --- /dev/null +++ b/tests/ios-location.test.cjs @@ -0,0 +1,122 @@ +const test = require('node:test'); +const assert = require('node:assert/strict'); +const { loader } = require('./helpers/load-typescript.cjs'); +const flush = () => new Promise(resolve => setImmediate(resolve)); + +function nativeLocation() { + const instances = []; + const FaceclawLocationUpdates = { new() { + const value = { stopped: 0, startOnce() { this.once = true; }, startTracking(ms) { this.interval = ms; }, + stop() { this.stopped++; this.eventHandler = null; } }; + instances.push(value); return value; + } }; + return { instances, load: loader({ FaceclawLocationUpdates }) }; +} +const fix = { latitude: 37.7, longitude: -122.4, accuracyMeters: 8, bearingDeg: null, speedMps: null, timestampMs: 1234 }; + +test('iOS one-shot location resolves a fix, rejects native errors, and releases each provider', async () => { + const h = nativeLocation(), api = h.load('app/native/location.ios.ts'); + const result = api.getCurrentLocation(), native = h.instances[0]; + assert.equal(native.once, true); + native.eventHandler(JSON.stringify(fix)); + assert.deepEqual({ ...await result }, fix); assert.ok(native.stopped); + const denied = api.getCurrentLocation(); + h.instances[1].eventHandler(JSON.stringify({ error: 'Permission denied' })); + await assert.rejects(denied, /Permission denied/); + assert.ok(h.instances[1].stopped); +}); + +test('iOS tracking preserves unavailable course/speed and ignores callbacks after stop or restart', () => { + const h = nativeLocation(), api = h.load('app/native/location-tracker.ios.ts'), fixes = [], errors = []; + const tracker = new api.LocationTracker({ onLocation: fix => fixes.push(fix), onError: error => errors.push(error) }); + tracker.start(1000); tracker.start(1000); + assert.equal(h.instances.length, 1); assert.equal(h.instances[0].interval, 1000); + const old = h.instances[0].eventHandler; + old(JSON.stringify(fix)); tracker.stop(); old(JSON.stringify(fix)); tracker.start(); old(JSON.stringify(fix)); + assert.equal(fixes.length, 1); assert.equal(fixes[0].bearingDeg, null); + h.instances[1].eventHandler(JSON.stringify({ error: 'Location disabled' })); + assert.equal(tracker.isRunning(), false); assert.deepEqual(errors, ['Location disabled']); +}); + +test('Navigate worker routes sensor callbacks by stream id and receives true-north correction', () => { + const messages = [], fixes = [], headings = []; + const api = loader({ global: { postMessage: message => messages.push(message) } })('app/apps/navigate/navigation-sensors.ios.ts'); + const tracker = new api.LocationTracker({ onLocation: fix => fixes.push(fix), onError() {} }); + tracker.start(); const first = messages.at(-1).request.id; + tracker.stop(); tracker.start(); const second = messages.at(-1).request.id; + api.handleNavigationSensorEvent({ kind: 'location', id: first, location: fix }); + api.handleNavigationSensorEvent({ kind: 'location', id: second, location: fix }); + assert.equal(fixes.length, 1); + const off = api.addCompassListener(event => headings.push(event)); + api.handleNavigationSensorEvent({ kind: 'compass', event: { command: 15, headingDegrees: 123 }, declination: 12 }); + assert.equal(api.magneticDeclinationDegrees(37.7, -122.4), 12); + off(); api.handleNavigationSensorEvent({ kind: 'compass', event: {}, declination: null }); + assert.equal(headings.length, 1); tracker.stop(); +}); + +function sensorHost() { + const pending = [], trackers = [], holds = [], replies = []; + let compass; + class Tracker { + constructor(callbacks) { this.callbacks = callbacks; trackers.push(this); } + start() { this.started = true; } + stop() { this.stopped = true; } + } + const api = loader({}, { + './location-tracker.ios': { LocationTracker: Tracker }, + './location-permissions.ios': { ensureFineLocationPermission: () => new Promise(resolve => pending.push(resolve)) }, + './compass.ios': { setCompassEnabled: (on, owner) => holds.push([on, owner]), + addCompassListener: fn => { compass = fn; return () => { compass = null; }; } }, + '../apps/compass/declination': { refreshDeclination() {}, getDeclinationDegrees: () => 12.5 }, + })('app/native/ios-navigation-sensors.ts'); + return { host: new api.IosNavigationSensors(event => replies.push(event)), pending, trackers, holds, replies, + heading: () => compass?.({ command: 15, headingDegrees: 90 }) }; +} +test('closing Navigate while precise permission is pending cannot start GPS later', async () => { + const h = sensorHost(); h.host.handle({ action: 'start', id: 1, intervalMs: 1000 }); + h.host.stop(); h.pending.shift()(true); await flush(); + assert.equal(h.trackers.length, 0); assert.equal(h.replies.length, 0); + h.host.handle({ action: 'start', id: 2, intervalMs: 1000 }); h.pending.shift()(false); await flush(); + assert.equal(h.replies[0].kind, 'error'); assert.equal(h.replies[0].id, 2); +}); +test('Navigate host releases GPS and compass together and ignores an old stream error', async () => { + const h = sensorHost(); h.host.handle({ action: 'start', id: 1, intervalMs: 1000 }); + h.pending.shift()(true); await flush(); + h.host.handle({ action: 'compass', enabled: true }); h.heading(); + assert.equal(h.replies[0].declination, 12.5); + h.trackers[0].callbacks.onLocation(fix); assert.equal(h.replies[1].kind, 'location'); + h.host.stop(); h.trackers[0].callbacks.onError('late error'); h.heading(); + assert.equal(h.replies.length, 2); assert.equal(h.trackers[0].stopped, true); + assert.deepEqual(h.holds.at(-1), [false, 'worker:navigate']); +}); + +test('Weather uses the portable location provider and preserves NWS parsing', async () => { + const requests = [], timers = new Set(); let permission = true; + const period = { name: 'Today', temperature: 70, temperatureUnit: 'F', shortForecast: 'Sunny', windSpeed: '5 mph', windDirection: 'W' }; + const api = loader({ setTimeout, clearTimeout, setInterval: fn => { timers.add(fn); return fn; }, clearInterval: fn => timers.delete(fn) }, { + './location-permissions': { hasLocationPermission: () => permission }, + './location': { getCurrentLocation: async () => fix }, + '../version': { USER_AGENT: 'test' }, + '../util/http': { fetchWithUserAgent: async url => { requests.push(url); return { ok: true, json: async () => + url.includes('/points/') ? { properties: { forecast: 'https://fixture/forecast', relativeLocation: { properties: { city: 'San Francisco', state: 'CA' } } } } + : { properties: { periods: [period] } } }; } }, + })('app/native/weather.ts'); + const bridge = new api.WeatherBridge(); bridge.start(); await bridge.refreshNow(); + assert.equal(bridge.snapshot().phase, 'ready'); assert.equal(bridge.snapshot().current.temperatureF, 70); + assert.equal(bridge.snapshot().locationName, 'San Francisco, CA'); + assert.match(requests[0], /37\.7000,-122\.4000/); + bridge.stop(); assert.equal(timers.size, 0); + permission = false; await bridge.refreshNow(); assert.equal(bridge.snapshot().phase, 'permission-required'); +}); + +test('closing Weather during permission prompt cannot restart polling', async () => { + let granted, options, starts = 0, stops = 0; + const api = loader({}, { + '../../native/location-permissions': { hasLocationPermission: () => false, ensureLocationPermission: () => new Promise(resolve => { granted = resolve; }) }, + '../../native/weather': { weatherBridge: { start() { starts++; }, stop() { stops++; }, onStateChange: () => () => {}, snapshot() {} } }, + './weather': { WeatherLayer: class {} }, + '../../ui/shell/in-process-window': { YieldAtRootLayer: class {}, createInProcessWindow: opts => { options = opts; return { requestRender() {} }; } }, + })('app/apps/weather/weather-app.ts'); + api.createWeatherAppWindow({ onClosed() {} }); options.onClosed(); granted(true); await flush(); + assert.equal(starts, 0); assert.equal(stops, 1); +}); diff --git a/tests/navigate-worker.test.cjs b/tests/navigate-worker.test.cjs new file mode 100644 index 00000000..c4706615 --- /dev/null +++ b/tests/navigate-worker.test.cjs @@ -0,0 +1,78 @@ +const test = require('node:test'); +const assert = require('node:assert/strict'); +const fs = require('node:fs'); +const vm = require('node:vm'); +const ts = require('typescript'); +const path = require('node:path'); +const { loader } = require('./helpers/load-typescript.cjs'); +const flush = () => new Promise(resolve => setImmediate(resolve)); + +const route = { coordinates: [[-122.4, 37.7], [-122.4, 37.71]], distanceMeters: 1112, durationSec: 600, + steps: [{ distanceMeters: 1112, durationSec: 600, instruction: 'Head north', maneuverType: 'depart' }, + { distanceMeters: 0, durationSec: 0, instruction: 'Arrive', maneuverType: 'arrive' }] }; +const fix = latitude => ({ latitude, longitude: -122.4, timestampMs: Date.now(), bearingDeg: 0, speedMps: 1.5, accuracyMeters: 5 }); +function fixture() { + const messages = [], timers = new Set(), holds = [], maps = [], errors = []; + let callbacks, compass, delayRoute = null; + const routeMath = loader()('app/apps/navigate/route-follower.ts'); + const tracker = { running: false, isRunning() { return this.running; }, start() { this.running = true; }, stop() { this.running = false; } }; + const sensor = { LocationTracker: function (value) { callbacks = value; return tracker; }, COMPASS_CHANGED: 15, + addCompassListener: fn => { compass = fn; return () => { compass = null; }; }, + setCompassEnabled: value => holds.push(value), magneticDeclinationDegrees: () => 12, + handleNavigationSensorEvent: event => { if (event.kind === 'location') callbacks.onLocation(event.location); } }; + const modules = { + '@nativescript/core/globals': {}, + '../../graphics/bdffont': { getFont: () => ({}) }, '../../graphics/ui-fonts': { getDefaultSmallFont: () => ({}) }, + '../../native/settings-store': { onSettingsStoreChanged() {} }, + './navigation-sensors': sensor, + './route-follower': routeMath, + './destinations': { findSavedDestinationByName: () => null, rememberRecentDestination() {} }, + '../compass/calibration': { calibrateHeading: value => value + 5, normalizeHeading: value => (value + 360) % 360 }, + '../../native/frame-timings': { startFrame: () => 1, finishFrame() {}, span: (_id, _name, fn) => fn(), runWithFrame: (_id, fn) => fn() }, + '../../native/active-display': { getActiveDisplay: () => null }, + '../../ui/window-menu': { WindowMenu: class { paint() { return []; } } }, + '../../graphics/plane': { planesFingerprint: () => 'frame' }, + '../../native/mapbox': { + isMapboxConfigured: () => true, + geocodeForward: async () => [{ name: 'Test park', placeFormatted: 'San Francisco', latitude: 37.71, longitude: -122.4 }], + fetchRoute: async () => delayRoute ? await delayRoute : route, + fetchStaticMapGray: async options => { maps.push(options); return { pixels: new Uint8Array([0, 128, 255]) }; }, + }, + }; + const global = { postMessage: message => messages.push(message) }; + const source = fs.readFileSync(path.join(__dirname, '../app/apps/navigate/navigate-app.worker.ts'), 'utf8') + + '\nexports.probe = { startNavigation, stopNavigation, state: () => ({ phase, headHeadingDeg, progress }) };'; + const exports = {}; + vm.runInNewContext(ts.transpileModule(source, { compilerOptions: { module: ts.ModuleKind.CommonJS, target: ts.ScriptTarget.ES2020 } }).outputText, { + exports, global, Uint8Array, setTimeout, clearTimeout, + setInterval: fn => { timers.add(fn); return fn; }, clearInterval: fn => timers.delete(fn), + console: { log() {}, warn() {}, error: error => errors.push(error) }, require: id => modules[id] ?? {}, + }); + const send = data => global.onmessage({ data }); + send({ type: 'open-window', windowId: 'navigate:main', surfaceId: 'window:navigate:main', title: 'Navigate', viewport: { width: 576, height: 480 } }); + send({ type: 'foreground', windowId: 'navigate:main', foreground: true, focused: true }); + return { ...exports.probe, send, timers, holds, maps, errors, tracker, + fix: latitude => send({ type: 'navigation-sensors', event: { kind: 'location', location: fix(latitude), id: 1 } }), + heading: value => compass?.({ command: 15, headingDegrees: value }), + holdRoute: () => { let resolve; delayRoute = new Promise(done => { resolve = done; }); return () => resolve(route); } }; +} + +test('shared Navigate worker follows streamed GPS, uses calibrated true heading and stops at arrival', async () => { + const h = fixture(); const starting = h.startNavigation('Test park', 'walking'); + h.fix(37.7); assert.match(await starting, /Navigating to Test park/); await flush(); + assert.equal(h.state().phase, 'navigating'); assert.ok(h.maps.length > 0); + h.heading(90); assert.equal(h.state().headHeadingDeg, 107); + h.send({ type: 'screen', on: false }); assert.equal(h.holds.at(-1), false); assert.equal(h.tracker.running, true); + h.fix(37.705); assert.ok(h.state().progress.remainingMeters < 600); + h.fix(37.71); assert.equal(h.state().phase, 'arrived'); assert.equal(h.tracker.running, false); + assert.equal(h.timers.size, 0); assert.deepEqual(h.errors, []); +}); + +test('closing Navigate while a route request is pending cannot restart guidance or GPS', async () => { + const h = fixture(), release = h.holdRoute(); + const starting = h.startNavigation('Test park', 'walking'); + h.fix(37.7); await flush(); assert.equal(h.state().phase, 'routing'); + h.send({ type: 'close-window', windowId: 'navigate:main' }); release(); + await assert.rejects(starting, /Navigation cancelled/); + assert.equal(h.state().phase, 'idle'); assert.equal(h.tracker.running, false); assert.equal(h.timers.size, 0); +}); From 617cdc39eb128078751c0f219d3a8fbd1838e955 Mon Sep 17 00:00:00 2001 From: James Babcock Date: Sat, 19 Sep 2026 00:02:15 -0700 Subject: [PATCH 24/99] Port assistant integration (with cloud AIs) to iOS --- App_Resources/iOS/src/FaceclawSseRequest.h | 8 ++ App_Resources/iOS/src/FaceclawSseRequest.m | 153 +++++++++++++++++++++ App_Resources/iOS/src/module.modulemap | 1 + app/apps/ai-chat/ai-chat-app.ts | 6 +- app/assistant/conversations.ts | 4 +- app/assistant/direct-backend.ts | 13 +- app/assistant/models.ts | 7 + app/assistant/navigate-tools.ts | 2 +- app/assistant/system-tools.ts | 5 +- app/g2/ios-preview-controller.ts | 9 ++ app/native/anthropic.ts | 33 ++--- app/native/openai.ts | 31 ++--- app/native/sse-types.ts | 6 + app/native/sse.ios.ts | 28 ++++ app/native/sse.ts | 11 ++ app/ui/dashboard-settings.ts | 12 +- app/ui/dashboard/settings-menus.ts | 4 +- app/ui/shell/shell.ts | 4 +- app/ui/shell/voice-input.ts | 4 +- tests/ai-chat.test.cjs | 2 +- tests/ios-app-host.test.cjs | 12 +- tests/ios-assistant.test.cjs | 129 +++++++++++++++++ tests/ios-glanceboard.test.cjs | 4 + tests/ios-sse-native.cjs | 45 ++++++ tests/native/ios-sse-test.m | 38 +++++ 25 files changed, 508 insertions(+), 63 deletions(-) create mode 100644 App_Resources/iOS/src/FaceclawSseRequest.h create mode 100644 App_Resources/iOS/src/FaceclawSseRequest.m create mode 100644 app/native/sse-types.ts create mode 100644 app/native/sse.ios.ts create mode 100644 app/native/sse.ts create mode 100644 tests/ios-assistant.test.cjs create mode 100644 tests/ios-sse-native.cjs create mode 100644 tests/native/ios-sse-test.m diff --git a/App_Resources/iOS/src/FaceclawSseRequest.h b/App_Resources/iOS/src/FaceclawSseRequest.h new file mode 100644 index 00000000..3177e20b --- /dev/null +++ b/App_Resources/iOS/src/FaceclawSseRequest.h @@ -0,0 +1,8 @@ +#import + +/** Streaming POST. Events are polled by the owning JS isolate, including workers. */ +@interface FaceclawSseRequest : NSObject +- (instancetype)initWithURL:(NSString *)url body:(NSString *)body headers:(NSString *)headersJson; +- (NSString *)takeEvents; +- (void)cancel; +@end diff --git a/App_Resources/iOS/src/FaceclawSseRequest.m b/App_Resources/iOS/src/FaceclawSseRequest.m new file mode 100644 index 00000000..7e793257 --- /dev/null +++ b/App_Resources/iOS/src/FaceclawSseRequest.m @@ -0,0 +1,153 @@ +#import "FaceclawSseRequest.h" +#import +#if TARGET_OS_IOS +#import +#endif + +@interface FaceclawSseRequest () +@property(nonatomic, strong) NSURLSession *session; +@property(nonatomic, strong) NSURLSessionDataTask *task; +@property(nonatomic, strong) NSMutableData *buffer; +@property(nonatomic, strong) NSMutableArray *events; +@property(nonatomic) NSUInteger queuedBytes; +@property(nonatomic) NSInteger status; +@property(nonatomic) BOOL finished; +@property(nonatomic) BOOL cancelled; +@property(nonatomic) BOOL firstLine; +#if TARGET_OS_IOS +@property(nonatomic) UIBackgroundTaskIdentifier backgroundTask; +#endif +@end + +@implementation FaceclawSseRequest +- (instancetype)initWithURL:(NSString *)url body:(NSString *)body headers:(NSString *)headersJson { + if ((self = [super init])) { + _buffer = [NSMutableData new]; _events = [NSMutableArray new]; _firstLine = YES; +#if TARGET_OS_IOS + _backgroundTask = UIBackgroundTaskInvalid; + dispatch_async(dispatch_get_main_queue(), ^{ + @synchronized(self) { + if (self.cancelled || self.finished) return; + self.backgroundTask = [UIApplication.sharedApplication beginBackgroundTaskWithName:@"Assistant response" expirationHandler:^{ + [self finish:@{@"kind": @"failure", @"text": @"iOS background time expired. Open Faceclaw and retry."}]; + [self endBackgroundTask]; + }]; + } + }); +#endif + NSURL *target = [NSURL URLWithString:url]; + if (!target || ![@[@"https", @"http"] containsObject:target.scheme.lowercaseString]) { + [self finish:@{@"kind": @"failure", @"text": @"Invalid streaming URL"}]; return self; + } + NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:target]; + request.HTTPMethod = @"POST"; + request.HTTPBody = [body dataUsingEncoding:NSUTF8StringEncoding]; + [request setValue:@"application/json; charset=utf-8" forHTTPHeaderField:@"Content-Type"]; + [request setValue:@"text/event-stream" forHTTPHeaderField:@"Accept"]; + NSDictionary *headers = [NSJSONSerialization JSONObjectWithData:[headersJson dataUsingEncoding:NSUTF8StringEncoding] options:0 error:nil]; + if ([headers isKindOfClass:NSDictionary.class]) for (NSString *name in headers) { + if ([headers[name] isKindOfClass:NSString.class]) [request setValue:headers[name] forHTTPHeaderField:name]; + } + NSURLSessionConfiguration *config = NSURLSessionConfiguration.ephemeralSessionConfiguration; + config.timeoutIntervalForRequest = 180; + config.timeoutIntervalForResource = 180; + _session = [NSURLSession sessionWithConfiguration:config delegate:self delegateQueue:nil]; + _task = [_session dataTaskWithRequest:request]; + [_task resume]; + } + return self; +} +- (void)endBackgroundTask { +#if TARGET_OS_IOS + dispatch_async(dispatch_get_main_queue(), ^{ + @synchronized(self) { + if (self.backgroundTask == UIBackgroundTaskInvalid) return; + [UIApplication.sharedApplication endBackgroundTask:self.backgroundTask]; + self.backgroundTask = UIBackgroundTaskInvalid; + } + }); +#endif +} +- (void)finish:(NSDictionary *)event { + @synchronized(self) { + if (_finished || _cancelled) return; + _finished = YES; [_events addObject:event]; + [_session invalidateAndCancel]; _session = nil; _task = nil; + [_buffer setLength:0]; + } +} +- (NSString *)takeEvents { + @synchronized(self) { + NSData *data = [NSJSONSerialization dataWithJSONObject:_events options:0 error:nil]; + [_events removeAllObjects]; _queuedBytes = 0; + if (_finished) [self endBackgroundTask]; + return [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding] ?: @"[]"; + } +} +- (void)cancel { + @synchronized(self) { + _cancelled = YES; + [_events removeAllObjects]; [_buffer setLength:0]; _queuedBytes = 0; + [_session invalidateAndCancel]; _session = nil; _task = nil; + [self endBackgroundTask]; + } +} +- (void)line:(NSData *)data { + NSString *line = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding]; + if (!line) { [self finish:@{@"kind": @"failure", @"text": @"Invalid UTF-8 in streaming response"}]; return; } + if (_firstLine && [line hasPrefix:@"\uFEFF"]) line = [line substringFromIndex:1]; + _firstLine = NO; + _queuedBytes += data.length; + if (_queuedBytes > 8 * 1024 * 1024 || _events.count >= 16384) { + [_events removeAllObjects]; + [self finish:@{@"kind": @"failure", @"text": @"Streaming response queue overflow"}]; return; + } + [_events addObject:@{@"kind": @"line", @"text": line}]; +} +- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)task didReceiveResponse:(NSURLResponse *)response completionHandler:(void (^)(NSURLSessionResponseDisposition))completionHandler { + @synchronized(self) { _status = [(NSHTTPURLResponse *)response statusCode]; } + completionHandler(NSURLSessionResponseAllow); +} +- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task willPerformHTTPRedirection:(NSHTTPURLResponse *)response newRequest:(NSURLRequest *)request completionHandler:(void (^)(NSURLRequest *))completionHandler { + // Never forward provider credentials to a redirected endpoint. + completionHandler(nil); +} +- (void)URLSession:(NSURLSession *)session dataTask:(NSURLSessionDataTask *)task didReceiveData:(NSData *)data { + @synchronized(self) { + if (_finished || _cancelled) return; + if (_status < 200 || _status >= 300) { + NSUInteger remaining = 65536 - _buffer.length; + [_buffer appendData:[data subdataWithRange:NSMakeRange(0, MIN(remaining, data.length))]]; + return; + } + [_buffer appendData:data]; + NSUInteger start = 0; + const uint8_t *bytes = _buffer.bytes; + for (NSUInteger i = 0; i < _buffer.length; i++) { + if (bytes[i] != '\r' && bytes[i] != '\n') continue; + if (bytes[i] == '\r' && i + 1 == _buffer.length) break; + [self line:[_buffer subdataWithRange:NSMakeRange(start, i - start)]]; + if (_finished) return; + if (bytes[i] == '\r' && bytes[i + 1] == '\n') i++; + start = i + 1; + } + if (start) [_buffer replaceBytesInRange:NSMakeRange(0, start) withBytes:NULL length:0]; + if (_buffer.length > 2 * 1024 * 1024) [self finish:@{@"kind": @"failure", @"text": @"Streaming response line too large"}]; + } +} +- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didCompleteWithError:(NSError *)error { + @synchronized(self) { + if (_finished || _cancelled) return; + if (error) { [self finish:@{@"kind": @"failure", @"text": error.localizedDescription}]; return; } + if (_status < 200 || _status >= 300) { + NSString *body = [[NSString alloc] initWithData:_buffer encoding:NSUTF8StringEncoding] ?: @""; + [self finish:@{@"kind": @"http-error", @"code": @(_status), @"text": body}]; return; + } + if (_buffer.length) { + if (((const uint8_t *)_buffer.bytes)[_buffer.length - 1] == '\r') [_buffer setLength:_buffer.length - 1]; + [self line:_buffer]; + } + [self finish:@{@"kind": @"complete"}]; + } +} +@end diff --git a/App_Resources/iOS/src/module.modulemap b/App_Resources/iOS/src/module.modulemap index 08938423..0f331e57 100644 --- a/App_Resources/iOS/src/module.modulemap +++ b/App_Resources/iOS/src/module.modulemap @@ -5,6 +5,7 @@ module FaceclawGraphics { header "FaceclawSocket.h" header "FaceclawLc3Decoder.h" header "FaceclawSpeech.h" + header "FaceclawSseRequest.h" header "FaceclawLocation.h" header "FaceclawConfigPort.h" header "FaceclawEvenHubWebView.h" diff --git a/app/apps/ai-chat/ai-chat-app.ts b/app/apps/ai-chat/ai-chat-app.ts index 195477a2..256c90af 100644 --- a/app/apps/ai-chat/ai-chat-app.ts +++ b/app/apps/ai-chat/ai-chat-app.ts @@ -1,7 +1,7 @@ import { GrayImage, type UiFont } from "../../graphics/image"; import { getDefaultSmallFont } from "../../graphics/ui-fonts"; import { truncateText, wrapText } from "../../graphics/textwrap"; -import { ASSISTANT_MODEL_VALUES, assistantModelLabel, resolveAssistantModel } from "../../assistant/models"; +import { ASSISTANT_MODEL_CHOICES, assistantModelLabel, resolveAssistantModel } from "../../assistant/models"; import type { AssistantTranscriptEntry } from "../../assistant/session"; import type { AssistantConversations, ReasoningLevel } from "../../assistant/conversations"; import { anthropicApiKeySetting, assistantBackendSetting, openAiApiKeySetting } from "../../ui/dashboard-settings"; @@ -102,7 +102,7 @@ class AiChatLayer implements Layer { } case "long-press": if (!this.conversations.current().session?.isTurnActive()) { - if (!shell.isAssistantAvailable()) { shell.showAlert("Set an API key or download the on-phone model in Settings."); return; } + if (!shell.isAssistantAvailable()) { shell.showAlert(global.isIOS ? "Set an OpenAI or Anthropic API key in Settings." : "Set an API key or download the on-phone model in Settings."); return; } void this.draft.start(); } return; @@ -126,7 +126,7 @@ class AiChatLayer implements Layer { onSelect: (ctx) => { if (this.conversations.select(item.id)) ctx.stack.clearToBase(); }, }))) }, { label: `Model: ${assistantModelLabel(record.model)}`, disabled: () => external || busy(), onSelect: (ctx) => submenu(ctx, "Model", - ASSISTANT_MODEL_VALUES.map((model) => ({ + ASSISTANT_MODEL_CHOICES.map((model) => ({ label: `${model === record.model ? "✓ " : ""}${assistantModelLabel(model)}`, disabled: () => !this.conversations.available(model, record.reasoning), onSelect: (ctx) => { if (this.conversations.configure(model, record.reasoning)) ctx.stack.clearToBase(); }, diff --git a/app/assistant/conversations.ts b/app/assistant/conversations.ts index 7e5df8f8..9d7dd7a3 100644 --- a/app/assistant/conversations.ts +++ b/app/assistant/conversations.ts @@ -1,5 +1,5 @@ import { AssistantSession, type AssistantBackendConfig, type AssistantSessionHistory } from "./session"; -import { ASSISTANT_MODEL_VALUES, type AssistantModel } from "./models"; +import { ASSISTANT_MODEL_VALUES, supportedAssistantModel, type AssistantModel } from "./models"; export type ReasoningLevel = "default" | "low" | "medium" | "high"; export type Conversation = { @@ -31,7 +31,7 @@ export class AssistantConversations { typeof record.id === "string" && ASSISTANT_MODEL_VALUES.includes(record.model) && ["default", "low", "medium", "high"].includes(record.reasoning) && Array.isArray(record.history?.messages) && Array.isArray(record.history?.transcript), - ).map((record) => ({ ...record, session: null })); + ).map((record) => ({ ...record, model: supportedAssistantModel(record.model), session: null })); this.selectedId = data.selectedId; } } catch { /* First launch or invalid saved state. */ } diff --git a/app/assistant/direct-backend.ts b/app/assistant/direct-backend.ts index 451abdf6..753a89cf 100644 --- a/app/assistant/direct-backend.ts +++ b/app/assistant/direct-backend.ts @@ -51,10 +51,13 @@ export class DirectAssistantBackend { let cancelled = false; let streamHandle: LlmStreamHandle | null = null; let priorText = ""; + let deadline: ReturnType | null = null; + const clearDeadline = () => { if (deadline !== null) clearTimeout(deadline); deadline = null; }; const finishError = (message: string) => { if (cancelled) return; cancelled = true; + clearDeadline(); streamHandle?.cancel(); streamHandle = null; options.callbacks.onError(message); }; @@ -102,10 +105,11 @@ export class DirectAssistantBackend { block.type === "tool_use", ); if (result.stopReason !== "tool_use" || toolUses.length === 0) { + clearDeadline(); options.callbacks.onTurnDone({ stopReason: result.stopReason }); return; } - void this.runToolCalls(toolUses, options) + void this.runToolCalls(toolUses, options, () => cancelled) .then((toolResults) => { // Always record the results, even if cancelled mid-flight: an // assistant tool_use with no matching tool_result would make the @@ -131,11 +135,13 @@ export class DirectAssistantBackend { : streamAnthropicMessage(streamOptions); }; + deadline = setTimeout(() => finishError("Assistant stopped: turn took too long"), MAX_TURN_MS); runIteration(0); return { cancel: () => { cancelled = true; + clearDeadline(); streamHandle?.cancel(); streamHandle = null; }, @@ -145,9 +151,14 @@ export class DirectAssistantBackend { private async runToolCalls( toolUses: Array>, options: DirectTurnOptions, + isCancelled: () => boolean, ): Promise { const results: LlmContentBlock[] = []; for (const toolUse of toolUses) { + if (isCancelled()) { + results.push({ type: "tool_result", tool_use_id: toolUse.id, content: "Cancelled", is_error: true }); + continue; + } const canonicalName = options.resolveToolName(toolUse.name); options.callbacks.onToolActivity(canonicalName); const result = await options.registry.callTool(canonicalName, toolUse.input); diff --git a/app/assistant/models.ts b/app/assistant/models.ts index f3cc792d..66d67670 100644 --- a/app/assistant/models.ts +++ b/app/assistant/models.ts @@ -13,6 +13,13 @@ export const ASSISTANT_MODEL_VALUES = [ ] as const; export type AssistantModel = (typeof ASSISTANT_MODEL_VALUES)[number]; +/** Keep saved model IDs portable, while offering only supported choices. */ +export const ASSISTANT_MODEL_CHOICES: readonly AssistantModel[] = + global.isIOS ? ASSISTANT_MODEL_VALUES.filter(value => value !== "qwen") : ASSISTANT_MODEL_VALUES; +export function supportedAssistantModel(value: AssistantModel): AssistantModel { + return global.isIOS && value === "qwen" ? "auto" : value; +} + export type AssistantProvider = "anthropic" | "openai" | "local"; export type AssistantApiKeys = { diff --git a/app/assistant/navigate-tools.ts b/app/assistant/navigate-tools.ts index 127cea41..feec02fc 100644 --- a/app/assistant/navigate-tools.ts +++ b/app/assistant/navigate-tools.ts @@ -4,7 +4,7 @@ * the app closed — so these always-available wrappers launch the app first, * wait for its tools to register, and forward the call. */ -import { ensureFineLocationPermission } from "../g2/android-permissions"; +import { ensureFineLocationPermission } from "../native/location-permissions"; import { toolRegistry, type ToolRegistry, type ToolResult } from "./tool-registry"; import { callAppToolWithLaunch } from "./launch-on-call"; diff --git a/app/assistant/system-tools.ts b/app/assistant/system-tools.ts index bc74f651..206a9555 100644 --- a/app/assistant/system-tools.ts +++ b/app/assistant/system-tools.ts @@ -20,7 +20,7 @@ export function registerSystemTools(registry: ToolRegistry = toolRegistry): void registered = true; // Keep a media listener warm so "what's playing" works without opening Music. - void mediaControllerBridge.start(); + if (!global.isIOS) void mediaControllerBridge.start(); registry.registerSystemTool( { @@ -54,6 +54,9 @@ export function registerSystemTools(registry: ToolRegistry = toolRegistry): void }, ); + // Calendar, phone media and notifications have no iOS backend yet. + if (global.isIOS) return; + registry.registerSystemTool( { name: "calendar.list_events", diff --git a/app/g2/ios-preview-controller.ts b/app/g2/ios-preview-controller.ts index dd4f927e..2fe50f27 100644 --- a/app/g2/ios-preview-controller.ts +++ b/app/g2/ios-preview-controller.ts @@ -1,3 +1,7 @@ +import { registerSystemTools } from '../assistant/system-tools' +import { registerWindowTools } from '../assistant/window-tools' +import { registerNavigateTools } from '../assistant/navigate-tools' +import { registerRoamTools } from '../assistant/roam-tools' import { IosNavigationSensors } from '../native/ios-navigation-sensors' import { Utils } from '@nativescript/core' import { bindCompassSession, receiveCompassEvent } from '../native/compass.ios' @@ -124,6 +128,11 @@ export class IosPreviewController { shell.registerWindow(launcher) shell.wake('window') shell.focusWindow(launcher.windowId) + registerSystemTools() + registerWindowTools({ apps: ALL_APPS.filter(app => !iosAppUnavailableReason(app.appId)), + launchApp: id => this.launchApp(id), requestShellRender: () => this.requestShellRender() }) + registerNavigateTools(id => this.launchApp(id)) + registerRoamTools(id => this.launchApp(id)) for (const app of ALL_APPS) if (app.appId !== 'launcher' && !iosAppUnavailableReason(app.appId)) app.boot?.(this.buildAppContext(app)) } diff --git a/app/native/anthropic.ts b/app/native/anthropic.ts index 725f81fc..071867cb 100644 --- a/app/native/anthropic.ts +++ b/app/native/anthropic.ts @@ -8,13 +8,13 @@ import type { LlmToolDefinition, } from "../assistant/llm-protocol"; -declare const com: any; +import { openSseRequest, type SseListener } from "./sse"; /** * Minimal streaming client for the Anthropic Messages API. There is no * official SDK for the NativeScript runtime, so this speaks raw HTTP/SSE via - * FaceclawSseRequest (okhttp on the Java side), which delivers the response - * body line by line on this isolate's thread. + * the platform transport (OkHttp on Android, URLSession on iOS), which + * delivers response lines on this isolate's thread. */ const ANTHROPIC_URL = "https://api.anthropic.com/v1/messages"; @@ -55,22 +55,19 @@ export function streamAnthropicMessage(options: AnthropicStreamOptions): Anthrop const fail = (message: string) => { if (settled) return; settled = true; + request?.cancel(); options.onError(message); }; const done = () => { if (settled) return; settled = true; + request?.cancel(); options.onDone({ text, content: finalizeBlocks(blocks), stopReason }); }; - if (!global.isAndroid) { - // Deferred so the caller gets its handle back before the callback runs. - setTimeout(() => fail("Anthropic API is only wired up on Android"), 0); - return { cancel: () => {} }; - } if (!apiKey) { setTimeout(() => fail("No Anthropic API key set"), 0); - return { cancel: () => {} }; + return { cancel: () => { settled = true; } }; } const body: any = { @@ -83,7 +80,7 @@ export function streamAnthropicMessage(options: AnthropicStreamOptions): Anthrop if (options.tools?.length) body.tools = options.tools; if (options.effort) body.output_config = { effort: options.effort }; - const listener = new com.faceclaw.app.FaceclawSseListener({ + const listener: SseListener = { onLine: (line: string) => { if (settled) return; const event = parseSseDataLine(String(line)); @@ -144,25 +141,19 @@ export function streamAnthropicMessage(options: AnthropicStreamOptions): Anthrop fail(describeHttpError(Number(code), String(errorBody))); }, onComplete: () => { - // Normally message_stop settles first; a clean EOF without it still - // resolves with whatever streamed. - done(); + // A transport EOF alone must not execute an unfinished tool call. + fail("Anthropic stream ended before the response completed"); }, onFailure: (message: string) => { fail(`Anthropic connection failed: ${String(message)}`); }, - }); + }; - const headers = Array.create("java.lang.String", 4) as string[]; - headers[0] = "x-api-key"; - headers[1] = apiKey; - headers[2] = "anthropic-version"; - headers[3] = ANTHROPIC_VERSION; try { - request = new com.faceclaw.app.FaceclawSseRequest(ANTHROPIC_URL, JSON.stringify(body), headers, listener); + request = openSseRequest(ANTHROPIC_URL, JSON.stringify(body), { "x-api-key": apiKey, "anthropic-version": ANTHROPIC_VERSION }, listener); } catch (error) { setTimeout(() => fail(`Anthropic request failed: ${String((error as Error)?.message ?? error)}`), 0); - return { cancel: () => {} }; + return { cancel: () => { settled = true; } }; } return { diff --git a/app/native/openai.ts b/app/native/openai.ts index cb178329..bba3b840 100644 --- a/app/native/openai.ts +++ b/app/native/openai.ts @@ -5,11 +5,11 @@ import type { LlmStreamOptions, } from "../assistant/llm-protocol"; -declare const com: any; +import { openSseRequest, type SseListener } from "./sse"; /** * Minimal streaming client for the OpenAI Responses API. NativeScript cannot - * use the Node SDK, so this shares the okhttp/SSE bridge used by Anthropic. + * use the Node SDK, so this shares the native streaming transport used by Anthropic. */ const OPENAI_RESPONSES_URL = "https://api.openai.com/v1/responses"; @@ -31,11 +31,13 @@ export function streamOpenAiResponse(options: LlmStreamOptions): LlmStreamHandle const fail = (message: string) => { if (settled) return; settled = true; + request?.cancel(); options.onError(message); }; const done = () => { if (settled) return; settled = true; + request?.cancel(); const content = finalizeOutputs(outputs); const hasToolUse = content.some((block) => block.type === "tool_use"); options.onDone({ @@ -45,13 +47,9 @@ export function streamOpenAiResponse(options: LlmStreamOptions): LlmStreamHandle }); }; - if (!global.isAndroid) { - setTimeout(() => fail("OpenAI API is only wired up on Android"), 0); - return { cancel: () => {} }; - } if (!apiKey) { setTimeout(() => fail("No OpenAI API key set"), 0); - return { cancel: () => {} }; + return { cancel: () => { settled = true; } }; } const body: any = { @@ -73,7 +71,7 @@ export function streamOpenAiResponse(options: LlmStreamOptions): LlmStreamHandle } if (options.effort) body.reasoning = { effort: options.effort }; - const listener = new com.faceclaw.app.FaceclawSseListener({ + const listener: SseListener = { onLine: (line: string) => { if (settled) return; const event = parseSseDataLine(String(line)); @@ -164,26 +162,19 @@ export function streamOpenAiResponse(options: LlmStreamOptions): LlmStreamHandle fail(describeHttpError(Number(code), String(errorBody))); }, onComplete: () => { - done(); + // A transport EOF alone must not execute an unfinished tool call. + fail("OpenAI stream ended before the response completed"); }, onFailure: (message: string) => { fail(`OpenAI connection failed: ${String(message)}`); }, - }); + }; - const headers = Array.create("java.lang.String", 2) as string[]; - headers[0] = "Authorization"; - headers[1] = `Bearer ${apiKey}`; try { - request = new com.faceclaw.app.FaceclawSseRequest( - OPENAI_RESPONSES_URL, - JSON.stringify(body), - headers, - listener, - ); + request = openSseRequest(OPENAI_RESPONSES_URL, JSON.stringify(body), { Authorization: `Bearer ${apiKey}` }, listener); } catch (error) { setTimeout(() => fail(`OpenAI request failed: ${String((error as Error)?.message ?? error)}`), 0); - return { cancel: () => {} }; + return { cancel: () => { settled = true; } }; } return { diff --git a/app/native/sse-types.ts b/app/native/sse-types.ts new file mode 100644 index 00000000..bc275c1e --- /dev/null +++ b/app/native/sse-types.ts @@ -0,0 +1,6 @@ +export type SseListener = { + onLine(line: string): void; + onHttpError(code: number, body: string): void; + onComplete(): void; + onFailure(message: string): void; +}; diff --git a/app/native/sse.ios.ts b/app/native/sse.ios.ts new file mode 100644 index 00000000..bd3e7284 --- /dev/null +++ b/app/native/sse.ios.ts @@ -0,0 +1,28 @@ +import { type SseListener } from './sse-types'; +import { withUserAgent } from '../util/http'; +export { type SseListener } from './sse-types'; +declare const FaceclawSseRequest: any; + +/** Drain native events on the requesting JS isolate, never on a URLSession thread. */ +export function openSseRequest(url: string, body: string, headers: Record, listener: SseListener): { cancel(): void } { + const native = FaceclawSseRequest.alloc().initWithURLBodyHeaders(url, body, JSON.stringify(withUserAgent(headers))); + let ended = false; + const cancel = () => { if (ended) return; ended = true; clearInterval(timer); native.cancel(); }; + const timer = setInterval(() => { + try { + for (const event of JSON.parse(native.takeEvents())) { + if (ended) break; + if (event.kind === 'line') listener.onLine(event.text); + else { + cancel(); + if (event.kind === 'complete') listener.onComplete(); + else if (event.kind === 'http-error') listener.onHttpError(event.code, event.text); + else listener.onFailure(event.text); + } + } + } catch (error) { + cancel(); listener.onFailure(String((error as Error)?.message ?? error)); + } + }, 25); + return { cancel }; +} diff --git a/app/native/sse.ts b/app/native/sse.ts new file mode 100644 index 00000000..1a7adabc --- /dev/null +++ b/app/native/sse.ts @@ -0,0 +1,11 @@ +import { type SseListener } from './sse-types'; +export { type SseListener } from './sse-types'; +declare const com: any; + +/** Android delivers callbacks on the requesting isolate's Looper. */ +export function openSseRequest(url: string, body: string, headers: Record, listener: SseListener): { cancel(): void } { + const entries = Object.entries(headers); + const nativeHeaders = Array.create('java.lang.String', entries.length * 2); + entries.forEach(([name, value], index) => { nativeHeaders[index * 2] = name; nativeHeaders[index * 2 + 1] = value; }); + return new com.faceclaw.app.FaceclawSseRequest(url, body, nativeHeaders, new com.faceclaw.app.FaceclawSseListener(listener)); +} diff --git a/app/ui/dashboard-settings.ts b/app/ui/dashboard-settings.ts index 2e32626f..b447ccb7 100644 --- a/app/ui/dashboard-settings.ts +++ b/app/ui/dashboard-settings.ts @@ -10,7 +10,7 @@ import { import { getDefaultSmallFont } from "~/graphics/ui-fonts"; import { wrapText } from "~/graphics/textwrap"; import { - ASSISTANT_MODEL_VALUES, + ASSISTANT_MODEL_CHOICES, assistantModelLabel, assistantModelProvider, type AssistantModel, @@ -595,7 +595,7 @@ export const assistantSkipConfirmationSetting = new ConfigSettingBoolean({ export type AssistantBackendKind = "direct" | "external"; const assistantBackendLabels: Record = { - direct: "On-phone", + direct: global.isIOS ? "Cloud API" : "On-phone", external: "My own agent (bridge)", }; @@ -604,10 +604,10 @@ export const assistantBackendSetting = new ConfigSettingEnum assistantBackendLabels[value] ?? value, description: - "Who answers assistant queries: an LLM called from the phone (a cloud API with your key, or the downloaded on-phone model), or your own long-running agent (e.g. OpenClaw) reached through the faceclaw-agent-bridge plugin.", + global.isIOS ? "Cloud models called with your OpenAI or Anthropic API key." : "Who answers assistant queries: an LLM called from the phone (a cloud API with your key, or the downloaded on-phone model), or your own long-running agent (e.g. OpenClaw) reached through the faceclaw-agent-bridge plugin.", }); export const assistantBridgeHostSetting = new ConfigSettingString({ @@ -700,7 +700,7 @@ export const assistantModelSetting = new ConfigSettingEnum({ label: "Assistant model", storageKey: "assistant.model", defaultValue: "auto", - values: ASSISTANT_MODEL_VALUES, + values: ASSISTANT_MODEL_CHOICES, formatValue: assistantModelLabel, isDisabled: (value) => { const provider = assistantModelProvider(value); @@ -710,7 +710,7 @@ export const assistantModelSetting = new ConfigSettingEnum({ return false; }, description: - "Model used by the voice assistant. Auto prefers Terra when an OpenAI key is set, then Sonnet when an Anthropic key is set, then the downloaded on-phone model.", + global.isIOS ? "Model used by the voice assistant. Auto prefers Terra with an OpenAI key, then Sonnet with an Anthropic key." : "Model used by the voice assistant. Auto prefers Terra when an OpenAI key is set, then Sonnet when an Anthropic key is set, then the downloaded on-phone model.", }); export const mapboxApiKeySetting = new ConfigSettingString({ diff --git a/app/ui/dashboard/settings-menus.ts b/app/ui/dashboard/settings-menus.ts index 147265d7..76399b10 100644 --- a/app/ui/dashboard/settings-menus.ts +++ b/app/ui/dashboard/settings-menus.ts @@ -130,14 +130,16 @@ function settingsSections(): SettingsSection[] { // On-phone LLM loop vs the user's own agent via the bridge plugin. enumSettingMenuItem(assistantBackendSetting), enumSettingMenuItem(assistantModelSetting), - localModelMenuItem(), + ...(!global.isIOS ? [localModelMenuItem()] : []), // When on, a wakeword utterance goes straight to the assistant with no // Send/Type menu step. toggleSettingMenuItem(assistantSkipConfirmationSetting), + ...(!global.isIOS ? [ textSettingMenuItem(assistantBridgeHostSetting), textSettingMenuItem(assistantBridgePortSetting), textSettingMenuItem(assistantBridgeTokenSetting), toggleSettingMenuItem(assistantAllowProactiveSetting), + ] : []), ], }, { diff --git a/app/ui/shell/shell.ts b/app/ui/shell/shell.ts index 2b36c08e..8f61baeb 100644 --- a/app/ui/shell/shell.ts +++ b/app/ui/shell/shell.ts @@ -1067,7 +1067,7 @@ class Shell { */ private buildVoiceSendTargets(): VoiceSendTarget[] { const targets: VoiceSendTarget[] = []; - if (!global.isIOS && this.isAssistantAvailable()) { + if (this.isAssistantAvailable()) { targets.push({ id: "assistant", label: "Send to Assistant", @@ -1254,7 +1254,7 @@ class Shell { this.showAlert( assistantBackendSetting.get() === "external" ? "Configure the agent bridge host and token in Settings." - : "Set an API key or download the on-phone model in Settings.", + : global.isIOS ? "Set an OpenAI or Anthropic API key in Settings." : "Set an API key or download the on-phone model in Settings.", ); return; } diff --git a/app/ui/shell/voice-input.ts b/app/ui/shell/voice-input.ts index fc45d90b..2e8832fe 100644 --- a/app/ui/shell/voice-input.ts +++ b/app/ui/shell/voice-input.ts @@ -224,7 +224,7 @@ export class VoiceInputLayer implements Layer { private menuRows(): Array<{ label: string; dim: boolean; onSelect: () => void }> { const text = this.displayText().trim(); const hasText = text.length > 0 && !this.stoppingCapture; - const hasLlmKey = !global.isIOS && anthropicApiKeySetting.get().trim().length > 0; + const hasLlmKey = anthropicApiKeySetting.get().trim().length > 0; const rows: Array<{ label: string; dim: boolean; onSelect: () => void }> = []; for (const target of this.sendTargets) { rows.push({ @@ -238,7 +238,7 @@ export class VoiceInputLayer implements Layer { }); } rows.push({ - label: global.isIOS ? "Continue (Not available on iOS)" : hasLlmKey ? "Continue" : "Continue (Needs LLM API key)", + label: hasLlmKey ? "Continue" : "Continue (Needs LLM API key)", dim: !hasLlmKey || this.stoppingCapture, onSelect: () => { if (hasLlmKey && !this.stoppingCapture) this.startContinuation(); diff --git a/tests/ai-chat.test.cjs b/tests/ai-chat.test.cjs index e4ded14a..1da80634 100644 --- a/tests/ai-chat.test.cjs +++ b/tests/ai-chat.test.cjs @@ -46,7 +46,7 @@ function conversations(saved = '') { const env = sessions(); const { AssistantConversations } = load('app/assistant/conversations.ts', { './session': { AssistantSession: env.AssistantSession }, - './models': { ASSISTANT_MODEL_VALUES: ['auto', 'terra', 'sonnet'] }, + './models': { supportedAssistantModel: value => value, ASSISTANT_MODEL_VALUES: ['auto', 'terra', 'sonnet'] }, }); let stored = ''; const store = new AssistantConversations((model, effort) => config(model, effort), () => 'terra', (value) => { stored = value; }, saved); diff --git a/tests/ios-app-host.test.cjs b/tests/ios-app-host.test.cjs index e7374bad..2aa4bc01 100644 --- a/tests/ios-app-host.test.cjs +++ b/tests/ios-app-host.test.cjs @@ -58,9 +58,9 @@ test('iOS worker frames preserve baked grayscale bytes through the message bound test('settings-driven repaint runs after font cache invalidation, regardless of subscription order', () => { const listeners = [], tasks = [], painted = []; let cachedFont = 'Light'; - const api = load('app/ui/dashboard-settings.ts', { + const api = load('app/ui/dashboard-settings.ts', { global: { isIOS: true }, require: id => id.includes('settings-store') ? { onSettingsStoreChanged: fn => listeners.push(fn) } - : { Layer: class {}, ASSISTANT_MODEL_VALUES: [] }, + : { Layer: class {}, ASSISTANT_MODEL_CHOICES: [] }, setTimeout: fn => tasks.push(fn), }); api.onAnySettingChanged(() => painted.push(cachedFont)); @@ -89,6 +89,10 @@ test('background glasses input still composites frames; phone resume preserves t } const settings = { onAnySettingChanged: () => () => {}, previewColorSetting: { get: () => 'white' } }; const modules = { + '../assistant/system-tools': { registerSystemTools() {} }, + '../assistant/window-tools': { registerWindowTools() {} }, + '../assistant/navigate-tools': { registerNavigateTools() {} }, + '../assistant/roam-tools': { registerRoamTools() {} }, "../native/ios-navigation-sensors": {}, '../native/compass.ios': { bindCompassSession() {}, receiveCompassEvent() {} }, '@nativescript/core': { File: { fromPath: () => ({ writeTextSync() {} }) }, knownFolders: { documents: () => ({ path: '/tmp' }) }, path }, @@ -158,6 +162,10 @@ test('iOS bandwidth footer toggles live, polls only in foreground and resets its on: (key, fn) => appEvents.set(key, fn), off: key => appEvents.delete(key) }, Button: View, Color: class {}, Dialogs: {}, GridLayout: View, Image: View, Label: View, Page: View, StackLayout: View }; const modules = { + '../assistant/system-tools': { registerSystemTools() {} }, + '../assistant/window-tools': { registerWindowTools() {} }, + '../assistant/navigate-tools': { registerNavigateTools() {} }, + '../assistant/roam-tools': { registerRoamTools() {} }, "../native/ios-navigation-sensors": {}, '../native/compass.ios': { bindCompassSession() {}, receiveCompassEvent() {} }, '@nativescript/core': core, diff --git a/tests/ios-assistant.test.cjs b/tests/ios-assistant.test.cjs new file mode 100644 index 00000000..310aafa6 --- /dev/null +++ b/tests/ios-assistant.test.cjs @@ -0,0 +1,129 @@ +const test = require('node:test'); +const assert = require('node:assert/strict'); +const { loader } = require('./helpers/load-typescript.cjs'); +const flush = () => new Promise(resolve => setImmediate(resolve)); + +function assistant(provider) { + const requests = [], calls = [], deltas = [], errors = [], done = []; + const registry = { listTools: () => [{ name: 'timer.set', description: 'Set a timer', inputSchema: { type: 'object' } }], + callTool: async (name, args) => { calls.push({ name, args }); return { ok: true, content: 'Timer set' }; } }; + const load = loader({ global: { isIOS: true, isAndroid: false }, setTimeout, clearTimeout }, { + './sse': { openSseRequest: (url, body, headers, listener) => { + const request = { url, body: JSON.parse(body), headers, listener, cancelled: false }; + requests.push(request); return { cancel: () => { request.cancelled = true; } }; + } }, + '../native/llama': { streamLocalQwen: () => assert.fail('iOS must not invoke a local LLM') }, + './bridge-client': { assistantBridge: {} }, './tool-registry': { toolRegistry: registry }, + '../prompts': { ASSISTANT_SYSTEM_PROMPT_BASE: 'test', buildAssistantSystemPrompt: () => 'test', describeAssistantContext: () => '' }, + }); + const { AssistantSession } = load('app/assistant/session.ts'); + const session = new AssistantSession({ kind: 'direct', llm: { selection: 'auto', provider, model: 'fixture-model', apiKey: 'fixture-key', effort: 'low' } }, registry); + const send = text => session.sendUtterance(text, {}, { onTextDelta: (_delta, full) => deltas.push(full), + onToolActivity() {}, onError: error => errors.push(error), onTurnDone: result => done.push(result) }); + const event = (request, event) => request.listener.onLine('data: ' + JSON.stringify(event)); + function text(request, value) { + if (provider === 'anthropic') { + event(request, { type: 'content_block_start', index: 0, content_block: { type: 'text', text: '' } }); + event(request, { type: 'content_block_delta', index: 0, delta: { type: 'text_delta', text: value } }); + } else event(request, { type: 'response.output_text.delta', output_index: 0, delta: value }); + } + function finish(request, tool = false) { + if (provider === 'anthropic') { + event(request, { type: 'message_delta', delta: { stop_reason: tool ? 'tool_use' : 'end_turn' } }); + event(request, { type: 'message_stop' }); + } else event(request, { type: 'response.completed' }); + } + function tool(request) { + if (provider === 'anthropic') { + event(request, { type: 'content_block_start', index: 1, content_block: { type: 'tool_use', id: 'tool-1', name: 'timer_set' } }); + event(request, { type: 'content_block_delta', index: 1, delta: { type: 'input_json_delta', partial_json: '{"seconds":' } }); + event(request, { type: 'content_block_delta', index: 1, delta: { type: 'input_json_delta', partial_json: '60}' } }); + } else { + event(request, { type: 'response.output_item.done', output_index: 1, item: { type: 'reasoning', id: 'reason', encrypted_content: 'opaque-fixture' } }); + event(request, { type: 'response.output_item.added', output_index: 2, item: { type: 'function_call', call_id: 'tool-1', id: 'item-1', name: 'timer_set', arguments: '' } }); + event(request, { type: 'response.function_call_arguments.delta', output_index: 2, delta: '{"seconds":' }); + event(request, { type: 'response.function_call_arguments.delta', output_index: 2, delta: '60}' }); + } + } + return { load, session, send, event, text, finish, tool, requests, calls, deltas, errors, done }; +} + +for (const provider of ['openai', 'anthropic']) { + test(`iOS ${provider} streams, calls shared tools, continues with results, and preserves follow-up history`, async () => { + const h = assistant(provider); h.send('Set a one-minute timer'); + const first = h.requests[0]; assert.equal(first.body.stream, true); + if (provider === 'openai') { assert.equal(first.headers.Authorization, 'Bearer fixture-key'); assert.equal(first.body.store, false); } + else assert.equal(first.headers['x-api-key'], 'fixture-key'); + h.text(first, 'Setting π 👓'); h.tool(first); h.finish(first, true); await flush(); + assert.equal(first.cancelled, true); assert.equal(h.calls[0].name, 'timer.set'); assert.equal(h.calls[0].args.seconds, 60); + assert.equal(h.requests.length, 2); + const second = h.requests[1]; + assert.match(JSON.stringify(second.body), /Timer set/); + if (provider === 'openai') assert.match(JSON.stringify(second.body), /opaque-fixture/); + h.text(second, 'Your timer is running.'); h.finish(second); + assert.equal(h.session.isTurnActive(), false); assert.equal(h.done.length, 1); assert.equal(h.errors.length, 0); + h.send('What did you set?'); + assert.match(JSON.stringify(h.requests[2].body), /Your timer is running/); + h.session.cancel(); assert.equal(h.requests[2].cancelled, true); + }); + test(`iOS ${provider} cancellation, HTTP errors and premature EOF never execute incomplete tools`, async () => { + const h = assistant(provider); h.send('test'); const first = h.requests[0]; h.session.cancel(); + h.text(first, 'late'); h.tool(first); h.finish(first, true); await flush(); + assert.equal(h.calls.length, 0); assert.equal(h.deltas.length, 0); + h.send('retry'); h.requests[1].listener.onHttpError(401, '{"error":{"message":"Invalid API key"}}'); + assert.equal(h.session.isTurnActive(), false); assert.match(h.errors[0], /key/i); + h.send('retry'); const third = h.requests[2]; h.text(third, 'Partial'); h.tool(third); third.listener.onComplete(); await flush(); + assert.match(h.errors.at(-1), /before.*completed/); assert.equal(h.calls.length, 0); assert.equal(third.cancelled, true); + }); +} + +test('iOS SSE adapter invokes listeners on its polling thread and stops polling at cancellation/EOF', () => { + const timers = new Set(), instances = [], seen = []; + const api = loader({ + setInterval: fn => { timers.add(fn); return fn; }, clearInterval: fn => timers.delete(fn), + FaceclawSseRequest: { alloc: () => ({ initWithURLBodyHeaders(url, body, headers) { + const instance = { events: [], cancelled: false, takeEvents() { const events = this.events; this.events = []; return JSON.stringify(events); }, cancel() { this.cancelled = true; } }; + instances.push(instance); assert.equal(JSON.parse(headers)['User-Agent'], 'fixture'); return instance; + } }) }, + }, { '../util/http': { withUserAgent: headers => ({ ...headers, 'User-Agent': 'fixture' }) } })('app/native/sse.ios.ts'); + const listener = { onLine: line => seen.push(line), onComplete: () => seen.push('complete'), onHttpError() {}, onFailure: error => assert.fail(error) }; + const handle = api.openSseRequest('https://fixture', '{}', {}, listener); + instances[0].events.push({ kind: 'line', text: 'first' }); assert.deepEqual(seen, []); + for (const tick of timers) tick(); assert.deepEqual(seen, ['first']); + handle.cancel(); assert.equal(timers.size, 0); assert.equal(instances[0].cancelled, true); + api.openSseRequest('https://fixture', '{}', {}, listener); + instances[1].events.push({ kind: 'line', text: 'last' }, { kind: 'complete' }); + for (const tick of [...timers]) tick(); assert.deepEqual(seen, ['first', 'last', 'complete']); assert.equal(timers.size, 0); +}); + +test('iOS only offers cloud assistant models and preserves old local-model conversations as Auto', () => { + const api = loader({ global: { isIOS: true } }, { '../native/llama': { LOCAL_MODEL: { label: 'Qwen', id: 'qwen' }, isLocalModelReady: () => false } })('app/assistant/models.ts'); + assert.equal(api.ASSISTANT_MODEL_CHOICES.includes('qwen'), false); + assert.equal(api.supportedAssistantModel('qwen'), 'auto'); + assert.equal(api.resolveAssistantModel('auto', { openai: 'key', anthropic: '' }).provider, 'openai'); + assert.equal(api.resolveAssistantModel('auto', { openai: '', anthropic: 'key' }).provider, 'anthropic'); + assert.equal(api.resolveAssistantModel('auto', { openai: '', anthropic: '' }), null); + const { AssistantConversations } = loader({}, { './models': api, './session': {} })('app/assistant/conversations.ts'); + const history = { messages: [], transcript: [{ role: 'user', text: 'Keep this conversation' }] }; + const saved = JSON.stringify({ selectedId: 'old', conversations: [{ id: 'old', model: 'qwen', reasoning: 'default', history }] }); + const conversations = new AssistantConversations(() => null, () => 'auto', () => {}, saved); + assert.equal(conversations.current().model, 'auto'); assert.equal(conversations.title(), 'Keep this conversation'); +}); + +test('cancelling during a tool prevents subsequent tool side effects and a stalled turn times out', async () => { + let stream, completeTool, deadline; + const calls = [], failures = []; + const { DirectAssistantBackend } = loader({ setTimeout: fn => { deadline = fn; return 1; }, clearTimeout() {} }, { + '../native/openai': { streamOpenAiResponse: options => { stream = options; return { cancel() {} }; } }, + '../native/anthropic': {}, '../native/llama': {}, + })('app/assistant/direct-backend.ts'); + const backend = new DirectAssistantBackend(); + const options = { provider: 'openai', messages: [], buildTools: () => [], resolveToolName: name => name, + registry: { callTool: name => { calls.push(name); return new Promise(resolve => { completeTool = resolve; }); } }, + callbacks: { onTextDelta() {}, onToolActivity() {}, onTurnDone() {}, onError: message => failures.push(message) } }; + const handle = backend.runTurn(options); + stream.onDone({ text: '', stopReason: 'tool_use', content: [1, 2].map(id => ({ type: 'tool_use', id: String(id), name: 'tool' + id, input: {} })) }); + handle.cancel(); completeTool({ ok: true, content: 'done' }); await flush(); + assert.deepEqual(calls, ['tool1']); + backend.runTurn({ ...options, messages: [] }); deadline(); assert.match(failures[0], /too long/); +}); diff --git a/tests/ios-glanceboard.test.cjs b/tests/ios-glanceboard.test.cjs index 86f8cadd..c90dc62f 100644 --- a/tests/ios-glanceboard.test.cjs +++ b/tests/ios-glanceboard.test.cjs @@ -68,6 +68,10 @@ function fixture() { paint: () => { boardStats.paints++; return new images.GrayImage(100, 80, 200); } }), }; const modules = { + '../assistant/system-tools': { registerSystemTools() {} }, + '../assistant/window-tools': { registerWindowTools() {} }, + '../assistant/navigate-tools': { registerNavigateTools() {} }, + '../assistant/roam-tools': { registerRoamTools() {} }, "../native/ios-navigation-sensors": {}, "../native/compass.ios": { bindCompassSession() {}, receiveCompassEvent() {} }, '@nativescript/core': { File: { fromPath: () => ({ writeTextSync() {} }) }, diff --git a/tests/ios-sse-native.cjs b/tests/ios-sse-native.cjs new file mode 100644 index 00000000..7b97c58e --- /dev/null +++ b/tests/ios-sse-native.cjs @@ -0,0 +1,45 @@ +const { execFileSync, spawn } = require('node:child_process'); +const { mkdtempSync, rmSync } = require('node:fs'); +const { tmpdir } = require('node:os'); +const { join, resolve } = require('node:path'); +const http = require('node:http'); +const assert = require('node:assert/strict'); +const root = resolve(__dirname, '..'), dir = mkdtempSync(join(tmpdir(), 'faceclaw-sse-')); +execFileSync('xcrun', ['clang', '-fobjc-arc', '-framework', 'Foundation', '-I', 'App_Resources/iOS/src', + 'tests/native/ios-sse-test.m', 'App_Resources/iOS/src/FaceclawSseRequest.m', '-o', join(dir, 'sse-test')], { cwd: root, stdio: 'inherit' }); +const server = http.createServer(async (request, response) => { + assert.notEqual(request.url, '/redirected', 'Credentials must not follow redirects'); + assert.equal(request.headers.authorization, 'Bearer fixture-key'); + assert.equal(request.headers['user-agent'], 'Faceclaw-test'); + assert.equal(request.method, 'POST'); + const chunks = []; for await (const chunk of request) chunks.push(chunk); + assert.deepEqual(JSON.parse(Buffer.concat(chunks)), { test: true }); + if (request.url === '/error') { response.writeHead(401); response.end('{"error":{"type":"invalid_api_key"}}'); return; } + if (request.url === '/redirect') { response.writeHead(302, { Location: '/redirected' }); response.end(); return; } + response.writeHead(200, { 'Content-Type': 'text/event-stream', ...(request.url === '/disconnect' ? { 'Content-Length': '1000' } : {}) }); + if (request.url === '/overflow') { response.end('x'.repeat(2 * 1024 * 1024 + 1)); return; } + if (request.url === '/disconnect') { + response.write('data: partial'); setTimeout(() => response.destroy(), 50); return; + } + if (request.url === '/cancel') { + response.write('data: first\n'); const timer = setTimeout(() => response.end('data: late\n'), 200); + response.on('close', () => clearTimeout(timer)); return; + } + // Split UTF-8 characters and CRLF boundaries across individual network writes. + const bytes = Buffer.from('\uFEFFdata: π 👓\r\n\r\n: ping\rdata: last'); + let index = 0; + const timer = setInterval(() => { + if (index === bytes.length) { clearInterval(timer); response.end(); } + else response.write(bytes.subarray(index, ++index)); + }, 2); + response.on('close', () => clearInterval(timer)); +}); +server.listen(0, '127.0.0.1', async () => { + try { + for (const mode of ['stream', 'error', 'redirect', 'cancel', 'overflow', 'disconnect']) await new Promise((resolve, reject) => { + const child = spawn(join(dir, 'sse-test'), [`http://127.0.0.1:${server.address().port}/${mode}`, mode], { stdio: 'inherit' }); + child.on('error', reject); child.on('exit', code => code === 0 ? resolve() : reject(new Error(`${mode}: exit ${code}`))); + }); + } catch (error) { console.error(error); process.exitCode = 1; } + finally { server.closeAllConnections(); server.close(); rmSync(dir, { recursive: true, force: true }); } +}); diff --git a/tests/native/ios-sse-test.m b/tests/native/ios-sse-test.m new file mode 100644 index 00000000..e4c8cb1d --- /dev/null +++ b/tests/native/ios-sse-test.m @@ -0,0 +1,38 @@ +#import +#import "FaceclawSseRequest.h" + +int main(int argc, const char **argv) { + @autoreleasepool { + NSString *mode = [NSString stringWithUTF8String:argv[2]]; + FaceclawSseRequest *request = [[FaceclawSseRequest alloc] initWithURL:[NSString stringWithUTF8String:argv[1]] + body:@"{\"test\":true}" headers:@"{\"Authorization\":\"Bearer fixture-key\",\"User-Agent\":\"Faceclaw-test\"}"]; + NSMutableArray *lines = [NSMutableArray new]; + NSDictionary *terminal = nil; + NSDate *deadline = [NSDate dateWithTimeIntervalSinceNow:10]; + while (!terminal && deadline.timeIntervalSinceNow > 0) { + NSArray *events = [NSJSONSerialization JSONObjectWithData:[[request takeEvents] dataUsingEncoding:NSUTF8StringEncoding] options:0 error:nil]; + for (NSDictionary *event in events) { + if ([event[@"kind"] isEqual:@"line"]) [lines addObject:event[@"text"]]; + else terminal = event; + } + if ([mode isEqual:@"cancel"] && lines.count) { + [request cancel]; + [[NSRunLoop currentRunLoop] runUntilDate:[NSDate dateWithTimeIntervalSinceNow:0.3]]; + if (![[request takeEvents] isEqual:@"[]"]) return 1; + puts("PASS native SSE cancellation suppresses later callbacks"); return 0; + } + [[NSRunLoop currentRunLoop] runUntilDate:[NSDate dateWithTimeIntervalSinceNow:0.01]]; + } + [request cancel]; + BOOL ok = NO; + if ([mode isEqual:@"stream"]) ok = [terminal[@"kind"] isEqual:@"complete"] && + [lines isEqual:@[@"data: π 👓", @"", @": ping", @"data: last"]]; + if ([mode isEqual:@"error"]) ok = [terminal[@"kind"] isEqual:@"http-error"] && + [terminal[@"code"] intValue] == 401 && [terminal[@"text"] containsString:@"invalid_api_key"]; + if ([mode isEqual:@"redirect"]) ok = [terminal[@"kind"] isEqual:@"http-error"] && [terminal[@"code"] intValue] == 302; + if ([mode isEqual:@"overflow"] || [mode isEqual:@"disconnect"]) ok = [terminal[@"kind"] isEqual:@"failure"]; + if (!ok) { NSLog(@"FAIL %@ lines=%@ terminal=%@", mode, lines, terminal); return 1; } + printf("PASS native SSE %s\n", mode.UTF8String); + } + return 0; +} From 7e58c7c05f905e1aa02d5925776c9b5b7f122a30 Mon Sep 17 00:00:00 2001 From: James Babcock Date: Sat, 19 Sep 2026 00:48:26 -0700 Subject: [PATCH 25/99] EvenHub compatibility for iOS --- App_Resources/iOS/Info.plist | 2 +- App_Resources/iOS/src/FaceclawCrypto.h | 4 + App_Resources/iOS/src/FaceclawCrypto.m | 12 ++ .../iOS/src/FaceclawEvenHubWebView.h | 3 +- .../iOS/src/FaceclawEvenHubWebView.m | 36 ++++-- App_Resources/iOS/src/FaceclawGraphics.h | 1 + App_Resources/iOS/src/FaceclawGraphics.m | 23 ++++ App_Resources/iOS/src/module.modulemap | 1 + app/apps/developer/developer-app.ts | 2 - app/apps/evenhub/compass-router.ts | 4 +- app/apps/evenhub/ehpk.ts | 63 ++++++---- app/apps/evenhub/even-api.ts | 44 +++---- app/apps/evenhub/even-platform.ios.ts | 17 +++ app/apps/evenhub/even-platform.ts | 17 +++ app/apps/evenhub/installed-apps.ts | 18 +-- app/apps/evenhub/manager.ts | 40 +++---- app/apps/evenhub/package-extraction.ts | 20 ++++ app/apps/evenhub/package-extraction.worker.ts | 9 ++ app/apps/evenhub/session.ts | 4 +- app/apps/evenhub/store-detail-layer.ts | 42 ++++--- app/apps/evenhub/store-layer.ts | 3 +- app/apps/evenhub/unpack-runtime.ios.ts | 21 ++++ app/apps/evenhub/unpack-runtime.ts | 5 + app/apps/evenhub/webview.ios.ts | 8 +- app/apps/files/files-app.ts | 2 +- app/apps/ios-availability.ts | 1 - app/apps/launcher/index.ts | 41 ++++--- app/g2/ios-preview-controller.ts | 52 +++++++-- app/native/binary-http.ios.ts | 10 ++ app/native/binary-http.ts | 15 +++ app/native/icon-image.ios.ts | 9 ++ app/native/icon-image.ts | 3 + app/phone-ui/main-page.ios.ts | 7 +- app/ui/layers.ts | 1 + tests/evenhub-install-performance.test.cjs | 109 ++++++++++++++++++ tests/ios-app-host.test.cjs | 34 ++++++ tests/ios-evenhub-native.cjs | 19 ++- tests/ios-evenhub.test.cjs | 82 +++++++++++-- tests/ios-glanceboard.test.cjs | 2 + tests/native/ios-evenhub-test.m | 19 ++- 40 files changed, 629 insertions(+), 176 deletions(-) create mode 100644 App_Resources/iOS/src/FaceclawCrypto.h create mode 100644 App_Resources/iOS/src/FaceclawCrypto.m create mode 100644 app/apps/evenhub/even-platform.ios.ts create mode 100644 app/apps/evenhub/even-platform.ts create mode 100644 app/apps/evenhub/package-extraction.ts create mode 100644 app/apps/evenhub/package-extraction.worker.ts create mode 100644 app/apps/evenhub/unpack-runtime.ios.ts create mode 100644 app/apps/evenhub/unpack-runtime.ts create mode 100644 app/native/binary-http.ios.ts create mode 100644 app/native/binary-http.ts create mode 100644 app/native/icon-image.ios.ts create mode 100644 app/native/icon-image.ts create mode 100644 tests/evenhub-install-performance.test.cjs diff --git a/App_Resources/iOS/Info.plist b/App_Resources/iOS/Info.plist index b79da82a..de7e7ba7 100644 --- a/App_Resources/iOS/Info.plist +++ b/App_Resources/iOS/Info.plist @@ -44,7 +44,7 @@ NSLocalNetworkUsageDescription - Faceclaw connects to the terminal servers you configure on your local network. + Faceclaw connects to the terminal servers and developer app URLs you configure on your local network. UILaunchScreen UISupportedInterfaceOrientations diff --git a/App_Resources/iOS/src/FaceclawCrypto.h b/App_Resources/iOS/src/FaceclawCrypto.h new file mode 100644 index 00000000..1ae03b25 --- /dev/null +++ b/App_Resources/iOS/src/FaceclawCrypto.h @@ -0,0 +1,4 @@ +#import +@interface FaceclawCrypto : NSObject ++ (NSString *)hmacSha256:(NSString *)secret message:(NSString *)message; +@end diff --git a/App_Resources/iOS/src/FaceclawCrypto.m b/App_Resources/iOS/src/FaceclawCrypto.m new file mode 100644 index 00000000..fe6b9362 --- /dev/null +++ b/App_Resources/iOS/src/FaceclawCrypto.m @@ -0,0 +1,12 @@ +#import "FaceclawCrypto.h" +#import +#import +@implementation FaceclawCrypto ++ (NSString *)hmacSha256:(NSString *)secret message:(NSString *)message { + NSData *key = [secret dataUsingEncoding:NSUTF8StringEncoding]; + NSData *data = [message dataUsingEncoding:NSUTF8StringEncoding]; + unsigned char digest[CC_SHA256_DIGEST_LENGTH]; + CCHmac(kCCHmacAlgSHA256, key.bytes, key.length, data.bytes, data.length, digest); + return [[NSData dataWithBytes:digest length:sizeof(digest)] base64EncodedStringWithOptions:0]; +} +@end diff --git a/App_Resources/iOS/src/FaceclawEvenHubWebView.h b/App_Resources/iOS/src/FaceclawEvenHubWebView.h index 04f3827d..0634e501 100644 --- a/App_Resources/iOS/src/FaceclawEvenHubWebView.h +++ b/App_Resources/iOS/src/FaceclawEvenHubWebView.h @@ -1,11 +1,12 @@ #import #import -/** One local EHPK runtime, retained by its TS session until its window closes. */ +/** One local or URL EvenHub runtime, retained by its TS session until its window closes. */ @interface FaceclawEvenHubWebView : NSObject @property(nonatomic, copy) void (^eventHandler)(NSString *json); @property(nonatomic, copy) NSString *packageIdentifier; - (void)start:(NSString *)directory entrypoint:(NSString *)entrypoint script:(NSString *)script; +- (void)startURL:(NSString *)url script:(NSString *)script; - (void)evaluate:(NSString *)script; - (void)showOnPhone; - (void)hideOnPhone; diff --git a/App_Resources/iOS/src/FaceclawEvenHubWebView.m b/App_Resources/iOS/src/FaceclawEvenHubWebView.m index f31b1cec..32f7bfd4 100644 --- a/App_Resources/iOS/src/FaceclawEvenHubWebView.m +++ b/App_Resources/iOS/src/FaceclawEvenHubWebView.m @@ -9,6 +9,7 @@ @property(nonatomic) UIButton *back; @property(nonatomic) NSTimer *timer; @property(nonatomic) NSString *directory; +@property(nonatomic) NSURL *remoteURL; @property(nonatomic) BOOL ticking; @property(nonatomic) BOOL destroyed; @end @@ -21,6 +22,20 @@ } - (void)start:(NSString *)directory entrypoint:(NSString *)entrypoint script:(NSString *)script { _directory = directory.stringByStandardizingPath.stringByResolvingSymlinksInPath; + NSURLComponents *url = [NSURLComponents new]; + url.scheme = @"faceclaw-ehpk"; url.host = @"app"; url.path = [@"/" stringByAppendingString:entrypoint]; + [self startRequest:url.URL script:script]; +} +- (void)startURL:(NSString *)url script:(NSString *)script { + NSURL *target = [NSURL URLWithString:url]; + if (!target.host.length || ![@[@"http", @"https"] containsObject:target.scheme.lowercaseString] || target.user || target.password) { + [self emit:@{@"kind": @"error", @"message": @"Invalid app URL."}]; return; + } + _remoteURL = target; + [self startRequest:target script:script]; +} +- (void)startRequest:(NSURL *)url script:(NSString *)script { + if (_destroyed) return; WKWebViewConfiguration *config = [WKWebViewConfiguration new]; // Isolate browser storage by package, retaining it across closing/reopening. // SDK storage also persists independently through the shared TS session. @@ -81,9 +96,7 @@ }]; }]; [NSRunLoop.mainRunLoop addTimer:_timer forMode:NSRunLoopCommonModes]; - NSURLComponents *url = [NSURLComponents new]; - url.scheme = @"faceclaw-ehpk"; url.host = @"app"; url.path = [@"/" stringByAppendingString:entrypoint]; - [_webView loadRequest:[NSURLRequest requestWithURL:url.URL]]; + [_webView loadRequest:[NSURLRequest requestWithURL:url]]; } - (void)evaluate:(NSString *)script { if (!_destroyed) [_webView evaluateJavaScript:script completionHandler:nil]; @@ -104,16 +117,25 @@ [_webView.configuration.userContentController removeAllUserScripts]; [_host removeFromSuperview]; _host = nil; _back = nil; _webView = nil; _eventHandler = nil; } +- (BOOL)allowsURL:(NSURL *)url { + if (!_remoteURL) return [url.scheme isEqual:@"faceclaw-ehpk"] && [url.host isEqual:@"app"]; + NSNumber *port = url.port ?: @([url.scheme.lowercaseString isEqual:@"https"] ? 443 : 80); + NSNumber *remotePort = _remoteURL.port ?: @([_remoteURL.scheme.lowercaseString isEqual:@"https"] ? 443 : 80); + return [url.scheme.lowercaseString isEqual:_remoteURL.scheme.lowercaseString] && + [url.host.lowercaseString isEqual:_remoteURL.host.lowercaseString] && [port isEqual:remotePort]; +} - (void)userContentController:(WKUserContentController *)controller didReceiveScriptMessage:(WKScriptMessage *)message { // Subframes and navigated third-party documents never receive host access. NSURL *url = message.frameInfo.request.URL; - if (!message.frameInfo.isMainFrame || ![url.scheme isEqual:@"faceclaw-ehpk"] || ![url.host isEqual:@"app"]) return; + if (!message.frameInfo.isMainFrame || ![self allowsURL:url]) return; if ([message.body isKindOfClass:NSDictionary.class]) [self emit:message.body]; } - (void)webView:(WKWebView *)webView decidePolicyForNavigationAction:(WKNavigationAction *)action decisionHandler:(void (^)(WKNavigationActionPolicy))decisionHandler { NSURL *url = action.request.URL; - BOOL local = [url.scheme isEqual:@"faceclaw-ehpk"] && [url.host isEqual:@"app"]; - decisionHandler(local && action.targetFrame.isMainFrame ? WKNavigationActionPolicyAllow : WKNavigationActionPolicyCancel); + BOOL allowed = [self allowsURL:url] && action.targetFrame.isMainFrame; + if (!allowed && action.targetFrame.isMainFrame) + [self emit:@{@"kind": @"error", @"message": @"Navigation outside the app origin is blocked. Open the destination as a separate app URL."}]; + decisionHandler(allowed ? WKNavigationActionPolicyAllow : WKNavigationActionPolicyCancel); } - (void)webView:(WKWebView *)webView didFinishNavigation:(WKNavigation *)navigation { [self emit:@{@"kind": @"loaded"}]; @@ -131,7 +153,7 @@ NSURL *url = task.request.URL; NSString *relative = [url.path stringByTrimmingCharactersInSet:[NSCharacterSet characterSetWithCharactersInString:@"/"]]; NSString *file = [[_directory stringByAppendingPathComponent:relative] stringByStandardizingPath].stringByResolvingSymlinksInPath; - BOOL allowed = !_destroyed && [url.host isEqual:@"app"] && + BOOL allowed = !_destroyed && _directory.length && !_remoteURL && [url.host isEqual:@"app"] && [file hasPrefix:[_directory stringByAppendingString:@"/"]]; NSData *data = allowed ? [NSData dataWithContentsOfFile:file options:NSDataReadingMappedIfSafe error:nil] : nil; NSString *ext = file.pathExtension.lowercaseString; diff --git a/App_Resources/iOS/src/FaceclawGraphics.h b/App_Resources/iOS/src/FaceclawGraphics.h index 333f6bc2..1a8eacf7 100644 --- a/App_Resources/iOS/src/FaceclawGraphics.h +++ b/App_Resources/iOS/src/FaceclawGraphics.h @@ -4,4 +4,5 @@ + (UIImage *)preview:(NSData *)gray width:(NSInteger)width height:(NSInteger)height green:(BOOL)green; + (NSData *)renderSVG:(NSString *)svg size:(NSInteger)size; + (NSData *)decodeImage:(NSData *)data width:(NSInteger)width height:(NSInteger)height; ++ (NSData *)decodeImageFile:(NSString *)path maxWidth:(NSInteger)maxWidth maxHeight:(NSInteger)maxHeight; @end diff --git a/App_Resources/iOS/src/FaceclawGraphics.m b/App_Resources/iOS/src/FaceclawGraphics.m index 361e7353..b66b7411 100644 --- a/App_Resources/iOS/src/FaceclawGraphics.m +++ b/App_Resources/iOS/src/FaceclawGraphics.m @@ -3,6 +3,29 @@ #import @implementation FaceclawGraphics ++ (NSData *)decodeImageFile:(NSString *)path maxWidth:(NSInteger)maxWidth maxHeight:(NSInteger)maxHeight { + if (maxWidth <= 0 || maxHeight <= 0 || maxWidth > 2048 || maxHeight > 2048) return nil; + NSURL *url = [NSURL fileURLWithPath:path]; + CGImageSourceRef source = CGImageSourceCreateWithURL((__bridge CFURLRef)url, NULL); + if (!source) return nil; + NSDictionary *properties = CFBridgingRelease(CGImageSourceCopyPropertiesAtIndex(source, 0, NULL)); + CFRelease(source); + double width = [properties[(id)kCGImagePropertyPixelWidth] doubleValue]; + double height = [properties[(id)kCGImagePropertyPixelHeight] doubleValue]; + if (width <= 0 || height <= 0) return nil; + NSInteger orientation = [properties[(id)kCGImagePropertyOrientation] integerValue]; + if (orientation >= 5 && orientation <= 8) { double swap = width; width = height; height = swap; } + double scale = MIN(1.0, MIN(maxWidth / width, maxHeight / height)); + NSInteger w = MAX(1, lround(width * scale)), h = MAX(1, lround(height * scale)); + NSData *bytes = [NSData dataWithContentsOfURL:url options:NSDataReadingMappedIfSafe error:nil]; + NSData *gray = [self decodeImage:bytes width:w height:h]; + if (!gray) return nil; + // Same dimensions + pixels packet used by the shared image adapter. + uint8_t dimensions[] = { w & 255, (w >> 8) & 255, h & 255, (h >> 8) & 255 }; + NSMutableData *packet = [NSMutableData dataWithBytes:dimensions length:4]; + [packet appendData:gray]; + return packet; +} + (NSData *)decodeImage:(NSData *)data width:(NSInteger)width height:(NSInteger)height { if (!data.length || width <= 0 || height <= 0 || width > 2048 || height > 2048) return nil; CGImageSourceRef source = CGImageSourceCreateWithData((__bridge CFDataRef)data, NULL); diff --git a/App_Resources/iOS/src/module.modulemap b/App_Resources/iOS/src/module.modulemap index 0f331e57..7c750302 100644 --- a/App_Resources/iOS/src/module.modulemap +++ b/App_Resources/iOS/src/module.modulemap @@ -9,5 +9,6 @@ module FaceclawGraphics { header "FaceclawLocation.h" header "FaceclawConfigPort.h" header "FaceclawEvenHubWebView.h" + header "FaceclawCrypto.h" export * } diff --git a/app/apps/developer/developer-app.ts b/app/apps/developer/developer-app.ts index 0ae11eef..1d68b04d 100644 --- a/app/apps/developer/developer-app.ts +++ b/app/apps/developer/developer-app.ts @@ -108,8 +108,6 @@ export function createDeveloperAppWindow(appContext: AppContext, options: InProc [ { label: "Load app from URL", - disabled: global.isIOS, - description: global.isIOS ? "Not available on iOS yet." : undefined, onSelect: (ctx) => { const layer = new LoadAppFromUrlLayer(appContext); ctx.stack.push(layer); diff --git a/app/apps/evenhub/compass-router.ts b/app/apps/evenhub/compass-router.ts index 0d8e7910..e9a33d46 100644 --- a/app/apps/evenhub/compass-router.ts +++ b/app/apps/evenhub/compass-router.ts @@ -80,7 +80,7 @@ class EvenHubCompassRouter { }); } if (!this.enabled) { - setCompassEnabled(true); + setCompassEnabled(true, "evenhub"); this.enabled = true; // Uses location only if the wearer already granted it; an app turning // on the compass is not a reason to raise a system permission prompt. @@ -88,7 +88,7 @@ class EvenHubCompassRouter { } } else { if (this.enabled) { - setCompassEnabled(false); + setCompassEnabled(false, "evenhub"); this.enabled = false; } this.unsubscribe?.(); diff --git a/app/apps/evenhub/ehpk.ts b/app/apps/evenhub/ehpk.ts index 28638f1a..e7f56bae 100644 --- a/app/apps/evenhub/ehpk.ts +++ b/app/apps/evenhub/ehpk.ts @@ -76,42 +76,55 @@ export function utf8Decode(bytes: Uint8Array): string { return out; } -export function parseEhpk(data: Uint8Array): EhpkArchive { - if (data.length < 20 || data[0] !== 0x45 || data[1] !== 0x48 || data[2] !== 0x50 || data[3] !== 0x4b) { +/** Index compressed records without expanding assets merely to read app.json. */ +export function openEhpk(data: Uint8Array) { + if (data.length < 20 || data[0] !== 0x45 || data[1] !== 0x48 || data[2] !== 0x50 || data[3] !== 0x4b) throw new Error("not an EHPK file"); - } const view = new DataView(data.buffer, data.byteOffset, data.byteLength); - const firstRecord = view.getUint32(8, true); - const files = new Map(); - - let p = firstRecord; + const records = new Map(); + const requireBytes = (offset: number, length: number) => { + if (offset < 20 || length < 0 || offset + length > data.length) throw new Error("ehpk: truncated record"); + }; + let p = view.getUint32(8, true); + requireBytes(p, 0); while (p < data.length) { + requireBytes(p, 4); const type = data[p]!; - if (data[p + 1] !== 0xba || data[p + 2] !== 0xa9 || data[p + 3] !== 0xba) { + if (data[p + 1] !== 0xba || data[p + 2] !== 0xa9 || data[p + 3] !== 0xba) throw new Error(`ehpk: bad record magic at ${p}`); - } if (type === RECORD_FILE) { - const compressedLength = view.getUint32(p + 4, true); - const uncompressedLength = view.getUint32(p + 8, true); + requireBytes(p, 16); + const compressed = view.getUint32(p + 4, true), size = view.getUint32(p + 8, true); const nameLength = view.getUint16(p + 14, true); + requireBytes(p + 16, nameLength + compressed); const name = utf8Decode(unxor(data, p + 16, nameLength)); if (!safeEhpkPath(name)) throw new Error(`ehpk: invalid file path ${name}`); - const blob = unxor(data, p + 16 + nameLength, compressedLength); - const content = decompress(blob, new Uint8Array(uncompressedLength)); - if (content.length !== uncompressedLength) { - throw new Error(`ehpk: ${name}: expected ${uncompressedLength} bytes, got ${content.length}`); - } - files.set(name, content); - p += 16 + nameLength + compressedLength; + records.set(name, { offset: p + 16 + nameLength, compressed, size }); + p += 16 + nameLength + compressed; } else if (type === RECORD_DIR) { - const nameLength = view.getUint16(p + 6, true); - p += 8 + nameLength; - } else if (type === RECORD_FOOTER) { - break; - } else { - throw new Error(`ehpk: unknown record type 0x${type.toString(16)} at ${p}`); - } + requireBytes(p, 8); + const length = view.getUint16(p + 6, true); + requireBytes(p + 8, length); p += 8 + length; + } else if (type === RECORD_FOOTER) break; + else throw new Error(`ehpk: unknown record type 0x${type.toString(16)} at ${p}`); } + return { files: { + keys: () => records.keys(), + has: (name: string) => records.has(name), + get: (name: string): Uint8Array | undefined => { + const record = records.get(name); + if (!record) return undefined; + const content = decompress(unxor(data, record.offset, record.compressed), new Uint8Array(record.size)); + if (content.length !== record.size) throw new Error(`ehpk: ${name}: expected ${record.size} bytes, got ${content.length}`); + return content; + }, + } }; +} +export type EhpkIndex = ReturnType; + +export function parseEhpk(data: Uint8Array): EhpkArchive { + const index = openEhpk(data), files = new Map(); + for (const name of index.files.keys()) files.set(name, index.files.get(name)!); return { files }; } diff --git a/app/apps/evenhub/even-api.ts b/app/apps/evenhub/even-api.ts index 971a10ec..932e008c 100644 --- a/app/apps/evenhub/even-api.ts +++ b/app/apps/evenhub/even-api.ts @@ -5,16 +5,17 @@ * it only discovers and downloads public .ehpk packages. Authentication is * the same signed-header scheme used by the firmware API. */ -import { Application } from "@nativescript/core"; +import { hmacSha256Base64, getPhoneOpenUdid } from "./even-platform"; +export { getPhoneOpenUdid } from "./even-platform"; import { getEvenHubToken, hasEvenHubCredentials, invalidateEvenHubToken, saveEvenHubSession, } from "./credentials"; +import { downloadBinary } from "../../native/binary-http"; import { fetchWithUserAgent } from "../../util/http"; -declare const android: any; const API_HOST = "https://api.evenrealities.com"; const PUBLIC_CDN_HOST = "https://cdn-pub.evenhub.evenrealities.com"; @@ -128,9 +129,9 @@ export class EvenHubApiClient { const url = typeof metadata.url === "string" ? metadata.url : ""; if (!url.startsWith("https://")) throw new Error("EvenHub returned no package download URL."); - const response = await fetchWithTimeout(url, {}, 60_000); - if (!response.ok) throw new Error(`EvenHub package download failed (HTTP ${response.status}).`); - const bytes = new Uint8Array(await response.arrayBuffer()); + const response = await downloadBinary(url, 60_000); + if (response.status < 200 || response.status >= 300) throw new Error(`EvenHub package download failed (HTTP ${response.status}).`); + const bytes = response.bytes; const expectedSize = finiteNumber(metadata.size); if (expectedSize > 0 && bytes.length !== expectedSize) { throw new Error(`EvenHub package was truncated (${bytes.length} of ${expectedSize} bytes).`); @@ -156,11 +157,11 @@ export class EvenHubApiClient { if (!/^prod\/[A-Za-z0-9._~!$&'()*+,;=:@%/-]+\.(?:svg|png|webp|jpe?g)$/i.test(cleanPath) || cleanPath.includes("..")) { throw new Error("EvenHub returned an invalid public asset path."); } - const response = await fetchWithTimeout(`${PUBLIC_CDN_HOST}/${cleanPath}`, {}, 30_000); - if (!response.ok) throw new Error(`EvenHub icon download failed (HTTP ${response.status}).`); - const contentLength = Number(response.headers.get("Content-Length") ?? 0); + const response = await downloadBinary(`${PUBLIC_CDN_HOST}/${cleanPath}`, 30_000); + if (response.status < 200 || response.status >= 300) throw new Error(`EvenHub icon download failed (HTTP ${response.status}).`); + const contentLength = response.contentLength; if (contentLength > 1_000_000) throw new Error("EvenHub icon is unexpectedly large."); - const bytes = new Uint8Array(await response.arrayBuffer()); + const bytes = response.bytes; if (bytes.length === 0 || bytes.length > 1_000_000) throw new Error("EvenHub icon is empty or too large."); const extension = cleanPath.toLowerCase().match(/\.([a-z0-9]+)$/)?.[1] ?? ""; return { bytes, extension: extension === "jpeg" ? "jpg" : extension }; @@ -287,9 +288,9 @@ function buildCommon(version: 1 | 3): string { buildTime: "26060821", appId: "1001", v: version, - // This is Android's app-scoped SSAID. Even's login endpoint registers a - // previously unseen value as a terminal, so Faceclaw does not need the - // official Even app's differently-scoped ID. + // Keep the established wire profile on both platforms. Even registers + // this installation-scoped terminal ID at login (SSAID on Android, + // a persisted random ID on iOS). openUdid: getPhoneOpenUdid(), os: "1", sn: "", @@ -333,13 +334,7 @@ function formEncode(value: string): string { } function hmacSign(message: string): string { - if (!global.isAndroid) throw new Error("The EvenHub storefront is currently available only on Android."); - const charset = java.nio.charset.StandardCharsets.UTF_8; - const key = new javax.crypto.spec.SecretKeySpec(new java.lang.String(SIGN_KEY).getBytes(charset), "HmacSHA256"); - const mac = javax.crypto.Mac.getInstance("HmacSHA256"); - mac.init(key); - const digest = mac.doFinal(new java.lang.String(message).getBytes(charset)); - return String(android.util.Base64.encodeToString(digest, android.util.Base64.NO_WRAP)); + return hmacSha256Base64(SIGN_KEY, message); } async function fetchWithTimeout(url: string, init: RequestInit, timeoutMs = REQUEST_TIMEOUT_MS): Promise { @@ -368,17 +363,6 @@ function unwrap(envelope: ApiEnvelope, httpStatus: number, path: string): unknow return envelope.data; } -/** Return this installation's Android ID, which Even calls `openUdid`. */ -export function getPhoneOpenUdid(): string { - if (!global.isAndroid) throw new Error("The EvenHub storefront is currently available only on Android."); - const resolver = Application.android.context?.getContentResolver(); - const openUdid = resolver - ? String(android.provider.Settings.Secure.getString(resolver, android.provider.Settings.Secure.ANDROID_ID) ?? "") - : ""; - if (!openUdid) throw new Error("Android did not provide a device ID for EvenHub authentication."); - return openUdid; -} - /** * Parse a list response. The leaderboard returns `{list, total, page, * page_size}`; the ranking/search endpoints were only recovered from the diff --git a/app/apps/evenhub/even-platform.ios.ts b/app/apps/evenhub/even-platform.ios.ts new file mode 100644 index 00000000..3753f1eb --- /dev/null +++ b/app/apps/evenhub/even-platform.ios.ts @@ -0,0 +1,17 @@ +import { getStringSetting, setStringSetting } from "../../native/settings-store"; +declare const FaceclawCrypto: any; + +export function hmacSha256Base64(secret: string, message: string): string { + return FaceclawCrypto.hmacSha256Message(secret, message); +} + +/** A stable random terminal ID, independent of phone hardware identifiers. */ +export function getPhoneOpenUdid(): string { + const key = "integrations.evenhub.terminalId"; + let id = getStringSetting(key, ""); + if (!id) { + id = NSUUID.UUID().UUIDString.replace(/-/g, "").slice(0, 16).toLowerCase(); + setStringSetting(key, id); + } + return id; +} diff --git a/app/apps/evenhub/even-platform.ts b/app/apps/evenhub/even-platform.ts new file mode 100644 index 00000000..bee53a2c --- /dev/null +++ b/app/apps/evenhub/even-platform.ts @@ -0,0 +1,17 @@ +import { Application } from "@nativescript/core"; + +export function hmacSha256Base64(secret: string, message: string): string { + const charset = java.nio.charset.StandardCharsets.UTF_8; + const key = new javax.crypto.spec.SecretKeySpec(new java.lang.String(secret).getBytes(charset), "HmacSHA256"); + const mac = javax.crypto.Mac.getInstance("HmacSHA256"); + mac.init(key); + const digest = mac.doFinal(new java.lang.String(message).getBytes(charset)); + return String(android.util.Base64.encodeToString(digest, android.util.Base64.NO_WRAP)); +} + +export function getPhoneOpenUdid(): string { + const resolver = Application.android.context?.getContentResolver(); + const id = resolver ? String(android.provider.Settings.Secure.getString(resolver, android.provider.Settings.Secure.ANDROID_ID) ?? "") : ""; + if (!id) throw new Error("Android did not provide a device ID for EvenHub authentication."); + return id; +} diff --git a/app/apps/evenhub/installed-apps.ts b/app/apps/evenhub/installed-apps.ts index f9743cde..ea05c4f1 100644 --- a/app/apps/evenhub/installed-apps.ts +++ b/app/apps/evenhub/installed-apps.ts @@ -13,10 +13,10 @@ import { writeBinaryFile, } from "../../native/file-access"; import { getStringSetting, setStringSetting } from "../../native/settings-store"; -import { loadImageFileAsGray } from "../../native/image-files"; +import { loadIconImage } from "../../native/icon-image"; import { renderSvgIcon } from "../../graphics/icons"; import { type GrayImage } from "../../graphics/image"; -import { parseEhpk, parseManifest, utf8Decode, type EhpkArchive, type EvenHubManifest } from "./ehpk"; +import { openEhpk, parseManifest, utf8Decode, type EhpkIndex, type EvenHubManifest } from "./ehpk"; const STORAGE_KEY = "evenhub.installedApps.v1"; const APP_ID_PREFIX = "evenhub-installed:"; @@ -209,7 +209,7 @@ export function renderInstalledEvenHubIcon( const svg = readTextFile(path); if (svg) image = renderSvgIcon(cacheKey, svg, size); } else { - image = loadImageFileAsGray(path, size, size); + image = loadIconImage(path, size, size); } renderedIconCache.set(cacheKey, image); return image; @@ -220,8 +220,8 @@ export function getInstalledEvenHubFingerprint(): string { return getStringSetting(STORAGE_KEY, ""); } -function inspectEhpk(bytes: Uint8Array): { archive: EhpkArchive; manifest: EvenHubManifest } { - const archive = parseEhpk(bytes); +function inspectEhpk(bytes: Uint8Array): { archive: EhpkIndex; manifest: EvenHubManifest } { + const archive = openEhpk(bytes); const appJson = archive.files.get("app.json"); if (!appJson) throw new Error("The EHPK package has no app.json manifest."); return { archive, manifest: parseManifest(utf8Decode(appJson)) }; @@ -242,7 +242,7 @@ function saveInstalledApps(apps: InstalledEvenHubApp[]): void { ); } -function findEmbeddedIcon(archive: EhpkArchive, manifest: EvenHubManifest): EvenHubInstallIcon | null { +function findEmbeddedIcon(archive: EhpkIndex, manifest: EvenHubManifest): EvenHubInstallIcon | null { const candidates: string[] = []; for (const key of ["icon", "icon_path", "iconPath", "app_icon", "appIcon"]) { const value = manifest.raw[key]; @@ -270,11 +270,11 @@ function findEmbeddedIcon(archive: EhpkArchive, manifest: EvenHubManifest): Even if (content && extension) return { bytes: content, extension }; } } - const fallback = Array.from(archive.files.entries()).find(([path]) => + const fallback = Array.from(archive.files.keys()).find((path) => /(?:^|\/)(?:app-?)?(?:icon|favicon)\.(?:svg|png|webp|jpe?g)$/i.test(path), ); - const extension = fallback ? iconExtension(fallback[0]) : null; - return fallback && extension ? { bytes: fallback[1], extension } : null; + const extension = fallback ? iconExtension(fallback) : null; + return fallback && extension ? { bytes: archive.files.get(fallback)!, extension } : null; } function normalizeInstallIcon(icon: EvenHubInstallIcon | undefined): EvenHubInstallIcon | null { diff --git a/app/apps/evenhub/manager.ts b/app/apps/evenhub/manager.ts index 036f9b3e..a247d98b 100644 --- a/app/apps/evenhub/manager.ts +++ b/app/apps/evenhub/manager.ts @@ -15,16 +15,16 @@ import { type AppContext } from "../app-definition"; import { appFilesDirPath, deletePathRecursively, - readBinaryFile, - writeBinaryFile, } from "../../native/file-access"; -import { parseEhpk, parseManifest, utf8Decode, type EvenHubManifest } from "./ehpk"; +import { type EvenHubManifest } from "./ehpk"; +import { unpackRuntime } from "./unpack-runtime"; import { type EvenHubPermission } from "./permissions"; import { EvenHubSession } from "./session"; import { createEvenHubWindow } from "./evenhub-window"; import { createEvenHubWebView, type EvenHubWebView } from "./webview"; import { shell } from "../../ui/shell/shell"; import { + readEvenHubPackageManifest, installedEvenHubAppId, installedEvenHubPackagePath, type InstalledEvenHubApp, @@ -64,17 +64,6 @@ export async function launchPackage( ehpkPath: string, options: { appId?: string; singleton?: boolean } = {}, ): Promise { - const data = readBinaryFile(ehpkPath); - if (!data) { - throw new Error('Could not read the EHPK file.'); - } - const archive = parseEhpk(data); - const appJson = archive.files.get("app.json"); - if (!appJson) { - throw new Error('The EHPK package has no app.json.'); - } - const manifest = parseManifest(utf8Decode(appJson)); - if (!archive.files.has(`dist/${manifest.entrypoint}`)) throw new Error('The EHPK entrypoint is missing from dist/.'); const appId = options.appId ?? "evenhub"; if (options.singleton) { const existing = Array.from(running.values()).find((app) => app.appId === appId); @@ -85,20 +74,19 @@ export async function launchPackage( } } - // Unpack fresh into app-private storage, keyed by package id. + const manifest = readEvenHubPackageManifest(ehpkPath); + if (!manifest) throw new Error('Could not read the EHPK manifest.'); + // Unpack off the iOS UI thread; reserve a unique directory before awaiting. const safeId = manifest.packageId.replace(/[^A-Za-z0-9._-]/g, "_"); if (!safeId || safeId === '.' || safeId === '..') throw new Error('Invalid EHPK package ID'); - const baseDir = `${appFilesDirPath()}/evenhub-apps/${safeId}${global.isIOS ? `-${Date.now()}-${nextSerial}` : ''}`; - deletePathRecursively(baseDir); - for (const [name, content] of Array.from(archive.files)) { - if (!writeBinaryFile(`${baseDir}/${name}`, content)) { - deletePathRecursively(baseDir); - throw new Error(`Could not unpack ${name}.`); - } - } - - try { await startApp(ctx, manifest, `${baseDir}/dist`, "", appId, global.isIOS ? () => deletePathRecursively(baseDir) : undefined); } - catch (error) { deletePathRecursively(baseDir); throw error; } + const baseDir = `${appFilesDirPath()}/evenhub-apps/${safeId}${global.isIOS ? `-${Date.now()}-${nextSerial++}` : ''}`; + const started = Date.now(); + ctx.appendLog(`evenhub: unpacking ${manifest.name}`); + try { + const loadedManifest = await unpackRuntime(ehpkPath, baseDir); + ctx.appendLog(`evenhub: unpacked ${loadedManifest.name} in ${Date.now() - started} ms`); + await startApp(ctx, loadedManifest, `${baseDir}/dist`, "", appId, global.isIOS ? () => deletePathRecursively(baseDir) : undefined); + } catch (error) { deletePathRecursively(baseDir); throw error; } } /** diff --git a/app/apps/evenhub/package-extraction.ts b/app/apps/evenhub/package-extraction.ts new file mode 100644 index 00000000..bbe9720c --- /dev/null +++ b/app/apps/evenhub/package-extraction.ts @@ -0,0 +1,20 @@ +import { deletePathRecursively, readBinaryFile, writeBinaryFile } from '../../native/file-access'; +import { openEhpk, parseManifest, utf8Decode, type EvenHubManifest } from './ehpk'; + +/** Called on a worker on iOS. Hold only one expanded asset at a time. */ +export function extractPackage(path: string, directory: string): EvenHubManifest { + try { + const bytes = readBinaryFile(path); + if (!bytes) throw new Error('Could not read the EHPK file.'); + const archive = openEhpk(bytes); + const json = archive.files.get('app.json'); + if (!json) throw new Error('The EHPK package has no app.json.'); + const manifest = parseManifest(utf8Decode(json)); + if (!archive.files.has(`dist/${manifest.entrypoint}`)) throw new Error('The EHPK entrypoint is missing from dist/.'); + deletePathRecursively(directory); + for (const name of archive.files.keys()) { + if (!writeBinaryFile(`${directory}/${name}`, archive.files.get(name)!)) throw new Error(`Could not unpack ${name}.`); + } + return manifest; + } catch (error) { deletePathRecursively(directory); throw error; } +} diff --git a/app/apps/evenhub/package-extraction.worker.ts b/app/apps/evenhub/package-extraction.worker.ts new file mode 100644 index 00000000..3d6d0adc --- /dev/null +++ b/app/apps/evenhub/package-extraction.worker.ts @@ -0,0 +1,9 @@ +import '@nativescript/core/globals'; +import { extractPackage } from './package-extraction'; + +global.onmessage = (event: { data: { path: string; directory: string } }) => { + try { + const manifest = extractPackage(event.data.path, event.data.directory); + global.postMessage({ manifest }); + } catch (error) { global.postMessage({ error: String((error as Error)?.message ?? error) }); } +}; diff --git a/app/apps/evenhub/session.ts b/app/apps/evenhub/session.ts index 318f7cd6..f9b073a3 100644 --- a/app/apps/evenhub/session.ts +++ b/app/apps/evenhub/session.ts @@ -61,7 +61,7 @@ import { type ImuReading } from "../../native/imu"; import { toolRegistry, type ToolResult, type ToolSpec } from "../../assistant/tool-registry"; import { getCurrentLocation } from "../../native/location"; import { LocationTracker, type TrackedLocation } from "../../native/location-tracker"; -import { ensureFineLocationPermission } from "../../g2/android-permissions"; +import { ensureFineLocationPermission } from "../../native/location-permissions"; const UPNG = require("upng-js"); @@ -642,7 +642,6 @@ export class EvenHubSession implements EvenHubMicClient, EvenHubImuClient, EvenH /** getAppLocation(): one-shot fix, or null on denial/error (SDK contract). */ private async getAppLocation(): Promise { - if (global.isIOS) return null; if (!this.declaresLocation()) return null; if (!(await ensureFineLocationPermission())) return null; try { @@ -666,7 +665,6 @@ export class EvenHubSession implements EvenHubMicClient, EvenHubImuClient, EvenH * Navigate app's foreground-service-backed tracking. */ private async startLocationUpdates(data: Record): Promise { - if (global.isIOS) return false; if (!this.declaresLocation()) return false; if (!(await ensureFineLocationPermission())) return false; if (this.closed) return false; diff --git a/app/apps/evenhub/store-detail-layer.ts b/app/apps/evenhub/store-detail-layer.ts index ab179023..f3b93803 100644 --- a/app/apps/evenhub/store-detail-layer.ts +++ b/app/apps/evenhub/store-detail-layer.ts @@ -133,24 +133,36 @@ export class EvenHubStoreDetailLayer implements Layer { } if (event.type !== "click") return; - await this.ensureDetail(ctx); + // Never hold the serialized input queue across network work or a dialog + // that needs a subsequent input to resolve. + void this.activate(ctx); + } - if (this.selectedIndex === 0) { - ctx.stack.push(new TextViewerLayer(this.app.description || "No description supplied.", "About")); - return; - } - if (this.selectedIndex === 1) { - ctx.stack.push(new TextViewerLayer(this.app.changelog || "No release notes supplied.", "What's New")); - return; - } + private async activate(ctx: LayerContext): Promise { + this.working = true; + try { + await this.ensureDetail(ctx); - const installed = getInstalledEvenHubApp(this.app.packageId); - if (installed && this.primaryActionLabel(installed) === "Launch") { - await this.options.launchApp(installedEvenHubAppId(installed.packageId)); - return; - } + if (this.selectedIndex === 0) { + ctx.stack.push(new TextViewerLayer(this.app.description || "No description supplied.", "About")); + return; + } + if (this.selectedIndex === 1) { + ctx.stack.push(new TextViewerLayer(this.app.changelog || "No release notes supplied.", "What's New")); + return; + } - await this.install(ctx); + const installed = getInstalledEvenHubApp(this.app.packageId); + if (installed && this.primaryActionLabel(installed) === "Launch") { + await this.options.launchApp(installedEvenHubAppId(installed.packageId)); + return; + } + + await this.install(ctx); + } catch (error) { + this.status = cleanError(error); + this.options.appendLog(`evenhub store: ${this.status}`); + } finally { this.working = false; ctx.actions.requestRender(); } } /** Install for a new app; Update / Reinstall when the installed copy is stale or gone. */ diff --git a/app/apps/evenhub/store-layer.ts b/app/apps/evenhub/store-layer.ts index 82df0fee..c2c044e6 100644 --- a/app/apps/evenhub/store-layer.ts +++ b/app/apps/evenhub/store-layer.ts @@ -674,6 +674,7 @@ export class EvenHubStoreLayer implements Layer { void this.submitCredentials(ctx); }, { setting: evenHubRememberMeSetting, label: "Remember me" }, + () => { this.phoneEditor = "none"; clearEvenHubLoginForm(); }, ); } @@ -684,7 +685,7 @@ export class EvenHubStoreLayer implements Layer { this.phoneEditor = "none"; if (this.closed) return; void this.runSearch(ctx, evenHubSearchQuerySetting.get()); - }); + }, undefined, () => { this.phoneEditor = "none"; }); } /** Close the phone editor if one is open (optionally only a given kind). */ diff --git a/app/apps/evenhub/unpack-runtime.ios.ts b/app/apps/evenhub/unpack-runtime.ios.ts new file mode 100644 index 00000000..478294a3 --- /dev/null +++ b/app/apps/evenhub/unpack-runtime.ios.ts @@ -0,0 +1,21 @@ +import type { EvenHubManifest } from './ehpk'; + +/** Paths and a small manifest cross isolates; package bytes never become JSON. */ +export function unpackRuntime(path: string, directory: string): Promise { + return new Promise((resolve, reject) => { + const worker = new Worker('./package-extraction.worker'); + let settled = false; + const finish = (error?: string, manifest?: EvenHubManifest) => { + if (settled) return; + settled = true; clearTimeout(timeout); worker.terminate(); + if (error) reject(new Error(error)); + else if (manifest) resolve(manifest); + else reject(new Error('The package worker returned no manifest.')); + }; + const timeout = setTimeout(() => finish('Unpacking the EvenHub app timed out.'), 180_000); + worker.onmessage = (event: MessageEvent) => finish(event.data.error, event.data.manifest); + worker.onerror = event => { finish(String(event.message ?? event)); return true; }; + try { worker.postMessage({ path, directory }); } + catch (error) { finish(String(error)); } + }); +} diff --git a/app/apps/evenhub/unpack-runtime.ts b/app/apps/evenhub/unpack-runtime.ts new file mode 100644 index 00000000..5d7ceab6 --- /dev/null +++ b/app/apps/evenhub/unpack-runtime.ts @@ -0,0 +1,5 @@ +import { extractPackage } from './package-extraction'; +import type { EvenHubManifest } from './ehpk'; +export async function unpackRuntime(path: string, directory: string): Promise { + return extractPackage(path, directory); +} diff --git a/app/apps/evenhub/webview.ios.ts b/app/apps/evenhub/webview.ios.ts index d4421b0a..e32ecdbd 100644 --- a/app/apps/evenhub/webview.ios.ts +++ b/app/apps/evenhub/webview.ios.ts @@ -21,7 +21,6 @@ window.__faceclawEvenHub = { postMessage: function(name, args, id) { ` export function createEvenHubWebView(session: EvenHubSession): EvenHubWebView { - if (session.remoteUrl) throw new Error('On iOS, open a local .ehpk package from Files.') const host = FaceclawEvenHubWebView.new() host.packageIdentifier = session.manifest.packageId host.eventHandler = (json: string) => { @@ -35,8 +34,11 @@ export function createEvenHubWebView(session: EvenHubSession): EvenHubWebView { } catch (error) { console.warn(`EvenHub bridge: ${error}`) } } // Defer loading until manager.ts has attached the session/window handles. - const loading = setTimeout(() => host.startEntrypointScript(session.distDir, session.manifest.entrypoint, - IOS_EVENHUB_TRANSPORT_SCRIPT + EVENHUB_BRIDGE_INJECT_SCRIPT + buildFaceclawExtensionsScript(`Faceclaw/${FACECLAW_VERSION}`)), 0) + const script = IOS_EVENHUB_TRANSPORT_SCRIPT + EVENHUB_BRIDGE_INJECT_SCRIPT + buildFaceclawExtensionsScript(`Faceclaw/${FACECLAW_VERSION}`) + const loading = setTimeout(() => { + if (session.remoteUrl) host.startURLScript(session.remoteUrl, script) + else host.startEntrypointScript(session.distDir, session.manifest.entrypoint, script) + }, 0) return { native: host, evaluateJs: js => host.evaluate(js), destroy: () => { clearTimeout(loading); host.destroy() }, showOnPhone: () => host.showOnPhone(), hideOnPhone: () => host.hideOnPhone() } diff --git a/app/apps/files/files-app.ts b/app/apps/files/files-app.ts index f628289d..615c8f9a 100644 --- a/app/apps/files/files-app.ts +++ b/app/apps/files/files-app.ts @@ -210,7 +210,7 @@ function fileOpenActions(entry: DirectoryEntry, options: FilesAppOptions): FileI }, }, ]; - return global.isIOS ? actions.slice(0, 1) : actions; + return actions; } if (isDecodableImageFile(entry.name)) { return [ diff --git a/app/apps/ios-availability.ts b/app/apps/ios-availability.ts index 52de7cfd..6b585eb1 100644 --- a/app/apps/ios-availability.ts +++ b/app/apps/ios-availability.ts @@ -5,7 +5,6 @@ const unavailable: Record = { transcribe: 'Voice capture and transcription are not available on iOS yet.', microphones: 'Glasses microphone capture is not available on iOS yet.', calendar: 'Calendar access is not available on iOS yet.', - evenhub: 'Open a local .ehpk file in Files to run an EvenHub app. The EvenHub store is not available on iOS yet.', } export function iosAppUnavailableReason(appId: string): string | null { return unavailable[appId] ?? null diff --git a/app/apps/launcher/index.ts b/app/apps/launcher/index.ts index 1d3786cc..1c16f4b9 100644 --- a/app/apps/launcher/index.ts +++ b/app/apps/launcher/index.ts @@ -7,6 +7,28 @@ import { renderInstalledEvenHubIcon, } from "../evenhub/installed-apps"; +/** Shared built-in and installed-app listing for both phone hosts. */ +export function launcherEntries(apps: readonly AppDefinition[]) { + return [ + ...apps + .filter((app) => app.showInLauncher !== false) + .map((app) => ({ + appId: app.appId, + label: app.title, + icon: app.icon, + renderIcon: app.renderIcon, + })), + ...getInstalledEvenHubApps().map((app) => ({ + appId: installedEvenHubAppId(app.packageId), + label: app.name, + icon: "package" as const, + renderIcon: (size: number) => renderInstalledEvenHubIcon(app.packageId, size, app), + iconKey: `${app.installedAt}:${app.iconFile ?? ""}`, + uninstallable: true, + })), + ]; +} + const launcherApp: AppDefinition = { appId: "launcher", title: "Apps", @@ -22,24 +44,7 @@ const launcherApp: AppDefinition = { ...ctx.actions, requestRender: () => shell.foregroundWindow()?.requestRender(), }, - apps: () => [ - ...ctx.apps - .filter((app) => app.showInLauncher !== false) - .map((app) => ({ - appId: app.appId, - label: app.title, - icon: app.icon, - renderIcon: app.renderIcon, - })), - ...getInstalledEvenHubApps().map((app) => ({ - appId: installedEvenHubAppId(app.packageId), - label: app.name, - icon: "package" as const, - renderIcon: (size: number) => renderInstalledEvenHubIcon(app.packageId, size, app), - iconKey: `${app.installedAt}:${app.iconFile ?? ""}`, - uninstallable: true, - })), - ], + apps: () => launcherEntries(ctx.apps), launchApp: (appId) => ctx.launchApp(appId), uninstallApp: (appId) => ctx.uninstallApp(appId), submitFrame: (planes, paintMs, frameId) => ctx.submitWindowFrame(LAUNCHER_SURFACE_ID, planes, paintMs, frameId), diff --git a/app/g2/ios-preview-controller.ts b/app/g2/ios-preview-controller.ts index 2fe50f27..8e211581 100644 --- a/app/g2/ios-preview-controller.ts +++ b/app/g2/ios-preview-controller.ts @@ -1,3 +1,8 @@ +import { launcherEntries } from '../apps/launcher' +import { getInstalledEvenHubAppById, installedEvenHubPackageId, uninstallEvenHubPackage } from '../apps/evenhub/installed-apps' +import { isInstalledPackagePresent } from '../apps/evenhub/updates' +import { openEvenHubStoreForPackage } from '../apps/evenhub' +import { launchInstalledPackage, closeRunningPackage } from '../apps/evenhub/manager' import { registerSystemTools } from '../assistant/system-tools' import { registerWindowTools } from '../assistant/window-tools' import { registerNavigateTools } from '../assistant/navigate-tools' @@ -91,9 +96,14 @@ export class IosPreviewController { startVoiceCapture: () => this.startVoiceCapture(), stopVoiceCapture: () => iosVoiceInput.stopPushToTalk(), startContinuousVoiceCapture: () => this.onError("Voice capture is not available on iOS yet."), - startTextSettingEdit: setting => this.editSetting(setting), - startTextSettingsEdit: async (settings, _title, finished) => { - for (const setting of settings) await this.editSetting(setting) + startTextSettingEdit: async setting => { await this.editSetting(setting) }, + startTextSettingsEdit: async (settings, title, finished, toggle, cancelled) => { + for (const setting of settings) if (!await this.editSetting(setting)) { cancelled?.(); return } + if (toggle) { + const choice = await Dialogs.action({ title, cancelButtonText: 'Cancel', actions: [toggle.label, 'This session only'] }) + if (choice === 'Cancel') { cancelled?.(); return } + toggle.setting.set(choice === toggle.label) + } finished?.() }, } @@ -116,11 +126,9 @@ export class IosPreviewController { }) const launcher = createLauncherWindow({ actions: this.actions, - apps: () => ALL_APPS.filter(app => app.showInLauncher !== false).map(app => ({ - appId: app.appId, label: app.title, icon: app.icon, renderIcon: app.renderIcon, - })), + apps: () => launcherEntries(ALL_APPS), launchApp: id => this.launchApp(id), - uninstallApp: () => {}, + uninstallApp: id => this.uninstallApp(id), submitFrame: planes => this.submit(LAUNCHER_SURFACE_ID, planes), setSurfaceVisible: visible => { this.compositor.setSurfaceVisible(LAUNCHER_SURFACE_ID, visible); this.scheduleFrame() }, }) @@ -293,7 +301,19 @@ export class IosPreviewController { } async launchApp(id: string, params?: AppLaunchParams): Promise { const app = ALL_APPS.find(app => app.appId === id) - if (!app) return + if (!app) { + const installed = getInstalledEvenHubAppById(id) + const host = ALL_APPS.find(app => app.appId === 'evenhub') + if (installed && host) { + try { + if (isInstalledPackagePresent(installed.packageId)) + await launchInstalledPackage(this.buildAppContext({ ...host, appId: id }), installed) + else await openEvenHubStoreForPackage(this.buildAppContext(host), installed) + } + catch (error) { this.fail(error) } + } + return + } try { const reason = iosAppUnavailableReason(id) if (reason) { @@ -306,10 +326,17 @@ export class IosPreviewController { console.log(`[ios-preview] Launched ${id}`) } catch (error) { this.fail(error) } } + private async uninstallApp(id: string): Promise { + const packageId = installedEvenHubPackageId(id) + if (!packageId) return + closeRunningPackage(packageId) + uninstallEvenHubPackage(packageId) + this.requestShellRender() + } private buildAppContext(app: AppDefinition): AppContext { return { appId: app.appId, apps: ALL_APPS, actions: this.actions, - launchApp: (id, params) => this.launchApp(id, params), uninstallApp: async () => {}, + launchApp: (id, params) => this.launchApp(id, params), uninstallApp: id => this.uninstallApp(id), launchInProcessApp: (id, surface, create) => this.launchInProcessApp(id, surface, create), ensureWorkerHost: create => this.ensureWorkerHost(app.appId, create), submitWindowFrame: (id, planes) => this.submit(id, planes), @@ -441,12 +468,13 @@ export class IosPreviewController { } catch (error) { this.fail(error) } finally { this.prompting = false } } - private async editSetting(setting: { editorTitle: string; get(): string; set(value: string): void }): Promise { - if (!this.active) { this.logBluetooth('Editing text settings requires opening Faceclaw on the phone'); return } - const result = await Dialogs.prompt({ title: setting.editorTitle, defaultText: setting.get(), okButtonText: 'Save', cancelButtonText: 'Cancel' }) + private async editSetting(setting: { editorTitle: string; inputKind?: string; get(): string; set(value: string): void }): Promise { + if (!this.active) { this.logBluetooth('Editing text settings requires opening Faceclaw on the phone'); return false } + const result = await Dialogs.prompt({ title: setting.editorTitle, defaultText: setting.get(), inputType: setting.inputKind, okButtonText: 'Save', cancelButtonText: 'Cancel' }) if (result.result) { setting.set(result.text) if (setting === nightscoutSiteUrlSetting || setting === nightscoutApiTokenSetting) await nightscoutBridge.refreshNow() } + return result.result } } diff --git a/app/native/binary-http.ios.ts b/app/native/binary-http.ios.ts new file mode 100644 index 00000000..d96d9aad --- /dev/null +++ b/app/native/binary-http.ios.ts @@ -0,0 +1,10 @@ +import { Http } from '@nativescript/core'; +import { withUserAgent } from '../util/http'; +import type { BinaryResponse } from './binary-http'; + +/** Bulk NSData -> ArrayBuffer; bypass fetch's Blob/FileReader copies. */ +export async function downloadBinary(url: string, timeoutMs: number): Promise { + const response = await Http.request({ url, method: 'GET', headers: withUserAgent(), timeout: timeoutMs }); + const length = Object.entries(response.headers).find(([name]) => name.toLowerCase() === 'content-length')?.[1]; + return { status: response.statusCode, bytes: new Uint8Array(response.content.toArrayBuffer()), contentLength: Number(length ?? 0) }; +} diff --git a/app/native/binary-http.ts b/app/native/binary-http.ts new file mode 100644 index 00000000..b70b832b --- /dev/null +++ b/app/native/binary-http.ts @@ -0,0 +1,15 @@ +import { fetchWithUserAgent } from '../util/http'; +export type BinaryResponse = { status: number; bytes: Uint8Array; contentLength: number }; +export async function downloadBinary(url: string, timeoutMs: number): Promise { + let timer: ReturnType; + const request = async () => { + const response = await fetchWithUserAgent(url); + return { status: response.status, bytes: new Uint8Array(await response.arrayBuffer()), + contentLength: Number(response.headers.get('Content-Length') ?? 0) }; + }; + try { + return await Promise.race([request(), new Promise((_, reject) => { + timer = setTimeout(() => reject(new Error('Download timed out.')), timeoutMs); + })]); + } finally { clearTimeout(timer!); } +} diff --git a/app/native/icon-image.ios.ts b/app/native/icon-image.ios.ts new file mode 100644 index 00000000..40282046 --- /dev/null +++ b/app/native/icon-image.ios.ts @@ -0,0 +1,9 @@ +import { grayImageFromPacket } from './image-files'; +import { fromData } from './kotlin-data'; +import type { GrayImage } from '../graphics/image'; +declare const FaceclawGraphics: any; + +export function loadIconImage(path: string, maxWidth: number, maxHeight: number): GrayImage | null { + const data = FaceclawGraphics.decodeImageFileMaxWidthMaxHeight(path, Math.round(maxWidth), Math.round(maxHeight)); + return data ? grayImageFromPacket(fromData(data)) : null; +} diff --git a/app/native/icon-image.ts b/app/native/icon-image.ts new file mode 100644 index 00000000..5e2145e4 --- /dev/null +++ b/app/native/icon-image.ts @@ -0,0 +1,3 @@ +import { loadImageFileAsGray } from './image-files'; +/** UI artwork uses flat grayscale, preserving its source aspect ratio. */ +export const loadIconImage = loadImageFileAsGray; diff --git a/app/phone-ui/main-page.ios.ts b/app/phone-ui/main-page.ios.ts index 6e50eac8..2c086ce9 100644 --- a/app/phone-ui/main-page.ios.ts +++ b/app/phone-ui/main-page.ios.ts @@ -1,5 +1,6 @@ import { Application, Button, Color, Dialogs, GridLayout, Image, Label, Page, StackLayout, type TouchGestureEventData } from '@nativescript/core' import { createConfigureDevicesPage } from './config-page.ios' +import { launcherEntries } from '../apps/launcher' import { ALL_APPS } from '../apps/all-apps' import { IosPreviewController } from '../g2/ios-preview-controller' import { PhoneGestureRecognizer } from './phone-gestures' @@ -107,9 +108,9 @@ export function createMainPage(): Page { } const sizeButton = button(controller.displayModeLabel, () => controller.cycleDisplayMode()) settings.addChild(button('Open app', () => { void (async () => { - const apps = ALL_APPS.filter(app => app.showInLauncher !== false).slice().sort((a, b) => a.title.localeCompare(b.title)) - const title = await Dialogs.action({ title: 'Open app', cancelButtonText: 'Cancel', actions: apps.map(app => app.title) }) - const app = apps.find(app => app.title === title) + const apps = launcherEntries(ALL_APPS).sort((a, b) => a.label.localeCompare(b.label)) + const title = await Dialogs.action({ title: 'Open app', cancelButtonText: 'Cancel', actions: apps.map(app => app.label) }) + const app = apps.find(app => app.label === title) if (app) { await controller.launchApp(app.appId); selectTab('watch') } })() })) settings.addChild(sizeButton) diff --git a/app/ui/layers.ts b/app/ui/layers.ts index 32315136..7bd79480 100644 --- a/app/ui/layers.ts +++ b/app/ui/layers.ts @@ -20,6 +20,7 @@ export type LayerActions = { title: string, onFinish?: () => void, toggle?: TextSettingsEditToggle, + onCancel?: () => void, ) => Promise | void; endTextSettingEdit: () => Promise | void; /** diff --git a/tests/evenhub-install-performance.test.cjs b/tests/evenhub-install-performance.test.cjs new file mode 100644 index 00000000..7422183e --- /dev/null +++ b/tests/evenhub-install-performance.test.cjs @@ -0,0 +1,109 @@ +const test = require('node:test'); +const assert = require('node:assert/strict'); +const { zstdCompressSync } = require('node:zlib'); +const { loader } = require('./helpers/load-typescript.cjs'); +const flush = () => new Promise(resolve => setImmediate(resolve)); +function pack(files) { + const key = Buffer.from('EVEN REALITIES'), xor = b => Buffer.from(b.map((v, i) => v ^ key[i % key.length])); + const header = Buffer.alloc(20); header.write('EHPK'); header.writeUInt32LE(20, 8); + return Buffer.concat([header, ...Object.entries(files).map(([name, value]) => { + const raw = Buffer.from(value), body = zstdCompressSync(raw), path = Buffer.from(name), h = Buffer.alloc(16); + h.writeUInt32LE(0xbaa9bae4); h.writeUInt32LE(body.length, 4); h.writeUInt32LE(raw.length, 8); h.writeUInt16LE(path.length, 14); + return Buffer.concat([h, xor(path), xor(body)]); + })]); +} +function packageFixture() { + const expanded = [], files = new Map(), settings = new Map(); + const bytes = pack({ 'app.json': JSON.stringify({ package_id: 'test.large', name: 'Large', permissions: [{ name: 'network' }] }), + 'dist/index.html': 'Test', 'dist/icon.svg': '', 'dist/engine.wasm': 'abcdef'.repeat(2_000_000) }); + const load = loader({ global: { isIOS: true } }, { + fzstd: { decompress: (input, output) => { expanded.push(output.length); return require('fzstd').decompress(input, output); } }, + '../../native/file-access': { readBinaryFile: path => files.get(path) ?? null, readTextFile() {}, appFilesDirPath: () => '/app', + writeBinaryFile: (path, bytes) => { files.set(path, bytes); return true; }, + deletePathRecursively: path => { for (const key of files.keys()) if (key.startsWith(path + '/')) files.delete(key); } }, + '../../native/settings-store': { getStringSetting: (key, fallback) => settings.get(key) ?? fallback, setStringSetting: (key, value) => settings.set(key, value) }, + '../../native/icon-image': {}, '../../graphics/icons': {}, '../../graphics/image': {}, + }); + files.set('/source.ehpk', bytes); + return { load, bytes, expanded, files }; +} + +test('permission inspection and installation never decompress the large app engine; extraction expands it once', () => { + const h = packageFixture(), installed = h.load('app/apps/evenhub/installed-apps.ts'); + assert.equal(installed.readEvenHubPackageManifestBytes(h.bytes).packageId, 'test.large'); + assert.equal(h.expanded.length, 1); + installed.installEvenHubPackageBytes(h.bytes); + assert.ok(h.expanded.every(size => size < 1024), 'Only manifest, HTML and icon are needed to install'); + h.load('app/apps/evenhub/package-extraction.ts').extractPackage('/source.ehpk', '/runtime'); + assert.equal(h.expanded.filter(size => size === 12_000_000).length, 1); + assert.equal(h.files.get('/runtime/dist/engine.wasm').length, 12_000_000); +}); + +test('store install releases serialized input before download and permission approval finish', async () => { + let completeDownload, dialog, installed = false, launched = false; + const download = new Promise(resolve => { completeDownload = resolve; }); + const manifest = { name: 'Test', packageId: 'test', permissions: [{ name: 'network' }], privacyPolicyUrl: '' }; + const load = loader({}, { + '../../graphics/ui-fonts': {}, '../../graphics/image': {}, '../../graphics/textwrap': {}, '../../ui/menu': {}, '../files/text-viewer': {}, '../../ui/metrics': {}, + './even-api': { evenHubApi: { getStoreAppDetail: async () => null, downloadApp: () => download } }, + './installed-apps': { getInstalledEvenHubApp: () => null, readEvenHubPackageManifestBytes: () => manifest, + readEvenHubPackageManifest: () => null, installedEvenHubPackagePath: () => '', installedEvenHubAppId: id => id, + installEvenHubPackageBytes: () => { installed = true; return { packageId: 'test', version: '1' }; } }, + './manager': { closeRunningPackage() {} }, './updates': {}, + './permission-dialog': { EvenHubPermissionDialogLayer: class { + constructor(_name, _permissions, _policy, allow) { this.allow = allow; } + handleInput() { this.allow(); } + } }, + }); + const { EvenHubStoreDetailLayer } = load('app/apps/evenhub/store-detail-layer.ts'); + const layer = new EvenHubStoreDetailLayer({ packageId: 'test', name: 'Test' }, { appendLog() {}, launchApp: () => { launched = true; } }); + const ctx = { actions: { requestRender() {} }, stack: { push: value => { dialog = value; } } }; + let queue = Promise.resolve(), returned = false; + queue = queue.then(() => layer.handleInput({ type: 'click' }, ctx)).then(() => { returned = true; }); + await flush(); assert.equal(returned, true, 'Input must return even while download is unresolved'); + completeDownload({ bytes: new Uint8Array(20), privacyPolicyUrl: '' }); + await flush(); assert.ok(dialog); assert.equal(installed, false); + queue = queue.then(() => dialog.handleInput({ type: 'click' }, ctx)); + await queue; await flush(); + assert.equal(installed, true); assert.equal(launched, true); +}); + +test('iOS extraction sends paths to a worker, leaves main responsive, and terminates on success or failure', async () => { + const workers = [], timers = new Map(); let serial = 0; + class Worker { + constructor() { workers.push(this); } postMessage(value) { this.request = value; } terminate() { this.terminated = true; } + } + const { unpackRuntime } = loader({ Worker, setTimeout: fn => { timers.set(++serial, fn); return serial; }, clearTimeout: id => timers.delete(id) })('app/apps/evenhub/unpack-runtime.ios.ts'); + const work = unpackRuntime('/source.ehpk', '/runtime'); + assert.deepEqual(JSON.parse(JSON.stringify(workers[0].request)), { path: '/source.ehpk', directory: '/runtime' }); + await flush(); // The JS loop remains runnable while extraction is outstanding. + workers[0].onmessage({ data: { manifest: { packageId: 'test' } } }); + assert.equal((await work).packageId, 'test'); assert.equal(workers[0].terminated, true); assert.equal(timers.size, 0); + const failed = unpackRuntime('/bad.ehpk', '/runtime'); + workers[1].onerror({ message: 'fixture failure' }); + await assert.rejects(failed, /fixture failure/); assert.equal(workers[1].terminated, true); +}); + +test('installed raster icons use the iOS decoder and retain decoded dimensions', () => { + const calls = []; + const iconLoader = loader({ global: { isIOS: true }, FaceclawGraphics: { + decodeImageFileMaxWidthMaxHeight: (path, width, height) => { + calls.push({ path, width, height }); + return path.endsWith('missing.png') ? null : new Uint8Array([2, 0, 1, 0, 80, 255]); + }, + } }, { './kotlin-data': { fromData: data => data } })('app/native/icon-image.ios.ts'); + const installed = loader({}, { + '../../native/icon-image': iconLoader, + '../../native/file-access': { appFilesDirPath: () => '/app' }, + '../../native/settings-store': {}, '../../graphics/icons': {}, fzstd: require('fzstd'), + })('app/apps/evenhub/installed-apps.ts'); + const record = { packageId: 'test', installedAt: 'today', iconFile: 'icon.png' }; + const image = installed.renderInstalledEvenHubIcon('test', 32, record); + assert.equal(image.width, 2); assert.equal(image.height, 1); + assert.deepEqual([...image.pixels], [80, 255]); + assert.equal(calls[0].path, '/app/evenhub-installed/test/icon.png'); + assert.equal(calls[0].width, 32); + assert.equal(installed.renderInstalledEvenHubIcon('test', 32, record), image); + assert.equal(calls.length, 1); + assert.equal(iconLoader.loadIconImage('/missing.png', 32, 32), null); +}); diff --git a/tests/ios-app-host.test.cjs b/tests/ios-app-host.test.cjs index 2aa4bc01..44435ca6 100644 --- a/tests/ios-app-host.test.cjs +++ b/tests/ios-app-host.test.cjs @@ -10,6 +10,38 @@ function load(file, context) { vm.runInNewContext(ts.transpileModule(source, { compilerOptions: { module: ts.ModuleKind.CommonJS, target: ts.ScriptTarget.ES2020 } }).outputText, sandbox); return sandbox.exports; } + +test('iOS installed apps launch, recover missing packages, and close before uninstall', async () => { + const calls = [], app = { packageId: 'test.app', name: 'Test' }; + let present = true; + const modules = { + '../apps/all-apps': { ALL_APPS: [{ appId: 'evenhub' }] }, + '../apps/evenhub/installed-apps': { getInstalledEvenHubAppById: id => id === 'installed' ? app : null, + installedEvenHubPackageId: id => id === 'installed' ? app.packageId : null, + uninstallEvenHubPackage: id => calls.push(['uninstall', id]) }, + '../apps/evenhub/updates': { isInstalledPackagePresent: () => present }, + '../apps/evenhub': { openEvenHubStoreForPackage: (_ctx, value) => calls.push(['reinstall', value.packageId]) }, + '../apps/evenhub/manager': { launchInstalledPackage: (ctx, value) => calls.push(['launch', ctx.appId, value.packageId]), + closeRunningPackage: id => calls.push(['close', id]) }, + }; + const { IosPreviewController } = load('app/g2/ios-preview-controller.ts', { require: id => modules[id] ?? {} }); + const host = Object.create(IosPreviewController.prototype); + host.buildAppContext = app => app; host.fail = assert.fail; host.requestShellRender = () => {}; + await host.launchApp('installed'); present = false; await host.launchApp('installed'); + await host.uninstallApp('installed'); + assert.deepEqual(calls, [['launch', 'installed', 'test.app'], ['reinstall', 'test.app'], ['close', 'test.app'], ['uninstall', 'test.app']]); +}); + +test('iOS settings prompts honor password input and report cancellation', async () => { + const prompts = [], writes = []; + const { IosPreviewController } = load('app/g2/ios-preview-controller.ts', { require: id => id === '@nativescript/core' ? { + Dialogs: { prompt: async options => { prompts.push(options); return { result: false, text: 'discarded' }; } }, + } : {} }); + const host = Object.create(IosPreviewController.prototype); host.active = true; + const accepted = await host.editSetting({ editorTitle: 'Password', inputKind: 'password', get: () => '', set: value => writes.push(value) }); + assert.equal(prompts[0].inputType, 'password'); + assert.equal(accepted, false); assert.deepEqual(writes, []); +}); test('iOS phone battery distinguishes unknown, charging, full and unplugged readings', () => { const device = { batteryLevel: -1, batteryState: 0 }; const api = load('app/native/phone-battery.ts', { require: () => ({}), global: { isIOS: true }, @@ -102,6 +134,7 @@ test('background glasses input still composites frames; phone resume preserves t './glance-host': { GlanceHost: class { dismiss() {} isVisible() { return false; } } }, './device-addresses': { loadDeviceAddresses: () => ({}) }, './ios-peripheral-identity': { deviceAddressError: () => null }, '../apps/launcher/launcher-app': { createLauncherWindow: () => window, LAUNCHER_SURFACE_ID: 'launcher' }, + '../apps/launcher': { launcherEntries: () => [] }, '../apps/all-apps': { ALL_APPS: [] }, '../ui/dashboard-settings': settings, '../native/phone-battery': { readPhoneBatteryState: () => ({ battery: 80, charging: false }) }, '../graphics/surface-compositor': { SurfaceCompositor: class { @@ -169,6 +202,7 @@ test('iOS bandwidth footer toggles live, polls only in foreground and resets its "../native/ios-navigation-sensors": {}, '../native/compass.ios': { bindCompassSession() {}, receiveCompassEvent() {} }, '@nativescript/core': core, + '../apps/launcher': { launcherEntries: () => [] }, '../apps/all-apps': { ALL_APPS: [] }, '../g2/ios-preview-controller': { IosPreviewController: class { resume() {} pause() {} } }, './phone-gestures': { PhoneGestureRecognizer: class { cancel() {} } }, diff --git a/tests/ios-evenhub-native.cjs b/tests/ios-evenhub-native.cjs index 209caffc..edb0b218 100644 --- a/tests/ios-evenhub-native.cjs +++ b/tests/ios-evenhub-native.cjs @@ -1,4 +1,5 @@ // Run the production WKWebView host in an isolated simulator app, no glasses. +const http = require('node:http'); const { execFileSync } = require('node:child_process'); const fs = require('node:fs'), path = require('node:path'), os = require('node:os'); const { loader } = require('./helpers/load-typescript.cjs'); @@ -25,11 +26,21 @@ if (!(await fetch('/%2e%2e/secret.txt')).ok) await call('traversal'); fs.writeFileSync(path.join(dist, 'module.js'), 'export const value = 42;'); fs.writeFileSync(path.join(dist, 'data.json'), '{"ok":true}'); fs.writeFileSync(path.join(dist, 'pixel.png'), Buffer.from('iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO+aBVkAAAAASUVORK5CYII=', 'base64')); -fs.writeFileSync(path.join(bundle, 'Info.plist'), `CFBundleIdentifiercom.faceclaw.evenhub-probeCFBundleExecutableEvenHubProbeCFBundleNameEvenHubProbeCFBundlePackageTypeAPPLCFBundleVersion1CFBundleShortVersionString1UILaunchScreenLSRequiresIPhoneOS`); +fs.writeFileSync(path.join(bundle, 'Info.plist'), `CFBundleIdentifiercom.faceclaw.evenhub-probeCFBundleExecutableEvenHubProbeCFBundleNameEvenHubProbeCFBundlePackageTypeAPPLCFBundleVersion1CFBundleShortVersionString1NSAppTransportSecurityNSAllowsLocalNetworkingUILaunchScreenLSRequiresIPhoneOS`); const sdk = execFileSync('xcrun', ['--sdk', 'iphonesimulator', '--show-sdk-path'], { encoding: 'utf8' }).trim(); execFileSync('xcrun', ['clang', '-fobjc-arc', '-target', `${process.arch === 'arm64' ? 'arm64' : 'x86_64'}-apple-ios15.1-simulator`, '-isysroot', sdk, '-framework', 'UIKit', '-framework', 'Foundation', '-framework', 'CoreGraphics', '-framework', 'WebKit', '-framework', 'UniformTypeIdentifiers', - '-I', 'App_Resources/iOS/src', 'tests/native/ios-evenhub-test.m', 'App_Resources/iOS/src/FaceclawEvenHubWebView.m', '-o', path.join(bundle, 'EvenHubProbe')], { cwd: root, stdio: 'inherit' }); + '-I', 'App_Resources/iOS/src', 'tests/native/ios-evenhub-test.m', 'App_Resources/iOS/src/FaceclawEvenHubWebView.m', 'App_Resources/iOS/src/FaceclawCrypto.m', '-o', path.join(bundle, 'EvenHubProbe')], { cwd: root, stdio: 'inherit' }); +const server = http.createServer((request, response) => { + if (request.url === '/redirect') { response.writeHead(302, { Location: `http://localhost:${server.address().port}/untrusted` }); response.end(); return; } + if (request.url === '/untrusted') { response.end(""); return; } + const file = path.join(dist, request.url === '/' ? 'index.html' : request.url.slice(1)); + if (!file.startsWith(dist + path.sep) || !fs.existsSync(file)) { response.writeHead(404); response.end(); return; } + response.setHeader('Content-Type', file.endsWith('.js') ? 'text/javascript' : file.endsWith('.json') ? 'application/json' : file.endsWith('.png') ? 'image/png' : 'text/html'); + response.end(fs.readFileSync(file)); +}); +server.listen(0, '127.0.0.1', () => { +fs.writeFileSync(path.join(bundle, 'remote.txt'), `http://127.0.0.1:${server.address().port}/`); const device = process.argv[2] || 'booted'; execFileSync('xcrun', ['simctl', 'install', device, bundle], { stdio: 'inherit' }); execFileSync('xcrun', ['simctl', 'launch', '--terminate-running-process', device, 'com.faceclaw.evenhub-probe'], { stdio: 'inherit' }); @@ -39,4 +50,6 @@ setTimeout(() => { const result = JSON.parse(fs.readFileSync(resultFile, 'utf8')); console.log(JSON.stringify({ work, ...result })); if (!result.passed) process.exitCode = 1; -}, 14000); + server.closeAllConnections(); server.close(); +}, 23000); +}); diff --git a/tests/ios-evenhub.test.cjs b/tests/ios-evenhub.test.cjs index 69953879..cea6b99b 100644 --- a/tests/ios-evenhub.test.cjs +++ b/tests/ios-evenhub.test.cjs @@ -52,7 +52,7 @@ test('EHPK entrypoints and extraction paths cannot escape their package director }); test('Files on iOS exposes Run app for EHPKs and passes the selected local path', () => { - let browserOptions, actions, opened; + let browserOptions, actions, opened, installed; const load = loader({ global: { isIOS: true } }, { '../../native/file-access': {}, '../../native/font-files': { isFontFile: () => false }, '../../graphics/installed-fonts': {}, '../../native/image-files': { isDecodableImageFile: () => false }, @@ -62,12 +62,13 @@ test('Files on iOS exposes Run app for EHPKs and passes the selected local path' './font-previewer': {}, './image-viewer': {}, './text-viewer': {}, '../../ui/shell/in-process-window': { createInProcessWindow: () => ({}) }, '../../ui/shell/shell': {}, }); - load('app/apps/files/files-app.ts').createFilesAppWindow({ openEhpkApp: path => { opened = path; } }); + load('app/apps/files/files-app.ts').createFilesAppWindow({ openEhpkApp: path => { opened = path; }, installEhpkApp: path => { installed = path; } }); assert.equal(browserOptions.isSupportedFile('test.EHPK'), true); const ctx = { stack: { push() {}, pop() {} } }; browserOptions.onFilePicked({ name: 'test.ehpk', path: '/Documents/test.ehpk' }, ctx); - assert.deepEqual(Array.from(actions, a => a.label), ['Run app']); + assert.deepEqual(Array.from(actions, a => a.label), ['Run app', 'Install']); actions[0].onSelect(ctx); assert.equal(opened, '/Documents/test.ehpk'); + actions[1].onSelect(ctx); assert.equal(installed, '/Documents/test.ehpk'); }); test('local package runtimes unpack independently and clean up after closing or a failed launch', async () => { @@ -82,7 +83,7 @@ test('local package runtimes unpack independently and clean up after closing or deletePathRecursively: path => { for (const key of files.keys()) if (key.startsWith(path + '/')) files.delete(key); } }, './session': { EvenHubSession: Session }, './evenhub-window': { createEvenHubWindow: () => ({}) }, './webview': { createEvenHubWebView: () => ({ evaluateJs() {}, destroy() {} }) }, - '../../ui/shell/shell': {}, './installed-apps': {}, + '../../ui/shell/shell': {}, './installed-apps': { readEvenHubPackageManifest: () => ({ packageId: 'test.app' }) }, }); const manager = load('app/apps/evenhub/manager.ts'), ctx = { appendLog() {}, launchInProcessApp: async () => {} }; await manager.launchPackage(ctx, '/test.ehpk'); await manager.launchPackage(ctx, '/test.ehpk'); @@ -97,7 +98,7 @@ test('local package runtimes unpack independently and clean up after closing or assert.equal(files.size, 0); }); -function sessionHarness() { +function sessionHarness(overrides = {}) { const settings = new Map(), logs = [], renders = []; const load = loader({ global: { isIOS: true }, setTimeout, clearTimeout, Promise }, { '@nativescript/core': { ApplicationSettings: { getString: (k, d) => settings.get(k) ?? d, setString: (k, v) => settings.set(k, v) } }, @@ -106,7 +107,7 @@ function sessionHarness() { '../../ui/dashboard-settings': {}, '../../ui/sound-effects': {}, './api-key-dialog': {}, './mic-router': { evenHubMicRouter: {} }, './imu-router': { evenHubImuRouter: {} }, './compass-router': { evenHubCompassRouter: {} }, '../../assistant/tool-registry': {}, - '../../native/location': {}, '../../native/location-tracker': {}, '../../g2/android-permissions': {}, + '../../native/location': {}, '../../native/location-tracker': {}, '../../native/location-permissions': {}, ...overrides, }); const api = load('app/apps/evenhub/session.ts'); const session = new api.EvenHubSession({ name: 'Probe', packageId: 'test.probe', permissions: [] }, '/test/dist', line => logs.push(line)); @@ -142,7 +143,7 @@ test('injected EvenHub RPC creates, updates and composites an image page with no test('iOS webview adapter defers loading until handles attach and destroys a not-yet-loaded app', () => { const timers = new Map(), calls = []; - const native = { startEntrypointScript: (...args) => calls.push(args), destroy: () => calls.push('destroy') }; + const native = { startEntrypointScript: (...args) => calls.push(args), startURLScript: (...args) => calls.push(args), destroy: () => calls.push('destroy') }; const load = loader({ FaceclawEvenHubWebView: { new: () => native }, setTimeout: fn => { timers.set(1, fn); return 1; }, clearTimeout: id => timers.delete(id) }, { './session': { EVENHUB_BRIDGE_INJECT_SCRIPT: 'BRIDGE', buildFaceclawExtensionsScript: () => 'EXT' }, '../../version': { FACECLAW_VERSION: 'test' }, @@ -152,5 +153,70 @@ test('iOS webview adapter defers loading until handles attach and destroys a not const host = createEvenHubWebView(session); assert.equal(calls.length, 0); timers.get(1)(); assert.equal(calls[0][0], '/app/dist'); assert.match(calls[0][2], /postMessage/); assert.match(calls[0][2], /BRIDGEEXT$/); host.destroy(); assert.equal(timers.size, 0); assert.equal(calls.at(-1), 'destroy'); - assert.throws(() => createEvenHubWebView({ ...session, remoteUrl: 'https://example.test' }), /local/); + const remote = createEvenHubWebView({ ...session, remoteUrl: 'https://example.test' }); + timers.get(1)(); assert.equal(calls.at(-1)[0], 'https://example.test'); + remote.destroy(); +}); + +test('EvenHub location uses the platform boundary and closes its subscription', async () => { + let permission = true, callback, starts = 0, stops = 0; + const fix = { latitude: 12, longitude: 34, accuracyMeters: 5, timestampMs: 1234 }; + const h = sessionHarness({ + '../../native/location-permissions': { ensureFineLocationPermission: async () => permission }, + '../../native/location': { getCurrentLocation: async () => fix }, + '../../native/location-tracker': { LocationTracker: class { + constructor(value) { callback = value; } start() { starts++; } stop() { stops++; } + } }, + }); + assert.equal(await h.call('getAppLocation'), null); // No manifest permission. + h.session.manifest.permissions.push({ name: 'location' }); + assert.deepEqual(JSON.parse(JSON.stringify(await h.call('getAppLocation'))), { + latitude: 12, longitude: 34, accuracy: 5, timestamp: 1234, + }); + permission = false; + assert.equal(await h.call('startAppLocationUpdates'), false); + permission = true; + assert.equal(await h.call('startAppLocationUpdates'), true); + assert.equal(starts, 1); + const events = []; + h.web._listenEvenAppMessage = value => events.push(typeof value === 'string' ? JSON.parse(value) : value); + callback.onLocation(fix); + assert.equal(events.at(-1).method, 'appLocationChanged'); + h.session.close(); + assert.equal(stops, 1); +}); + +test('iOS store terminal identity persists and signing crosses the native boundary', () => { + const settings = new Map(); + const api = loader({ NSUUID: { UUID: () => ({ UUIDString: '12345678-1234-5678-90AB-123456789ABC' }) }, + FaceclawCrypto: { hmacSha256Message: (key, body) => require('node:crypto').createHmac('sha256', key).update(body).digest('base64') }, + }, { '../../native/settings-store': { + getStringSetting: (key, fallback) => settings.get(key) ?? fallback, + setStringSetting: (key, value) => settings.set(key, value), + } })('app/apps/evenhub/even-platform.ios.ts'); + assert.equal(api.getPhoneOpenUdid(), '1234567812345678'); + assert.equal(api.getPhoneOpenUdid(), '1234567812345678'); + assert.equal(settings.size, 1); + assert.equal(api.hmacSha256Base64('key', 'The quick brown fox jumps over the lazy dog'), '97yD9DBThCSxMpjmqm+xQ+9NWaFJRhdZl0edvC0aPNg='); +}); + +test('store login and catalog requests use platform signing with the shared wire format', async () => { + const requests = [], signatures = []; + let token = ''; + const api = loader({ setTimeout, clearTimeout }, { + './even-platform': { getPhoneOpenUdid: () => 'fixture-terminal', hmacSha256Base64: (_key, value) => { signatures.push(value); return 'fixture-signature'; } }, + './credentials': { getEvenHubToken: () => token, hasEvenHubCredentials: () => !!token, + saveEvenHubSession: (_email, value) => { token = value; }, invalidateEvenHubToken() {} }, + '../../util/http': { fetchWithUserAgent: async (url, init) => { + requests.push({ url, ...init }); + return { status: 200, json: async () => ({ code: 0, data: url.endsWith('/login') ? { token: 'fixture-token' } : { list: [], total: 0 } }) }; + } }, + })('app/apps/evenhub/even-api.ts'); + await api.evenHubApi.signIn('test@example.invalid', 'fixture-password', false); + await api.evenHubApi.listApps(); + assert.equal(requests.length, 2); + assert.match(requests[0].headers.common, /openUdid=fixture-terminal/); + assert.equal(requests[1].headers.token, 'fixture-token'); + assert.equal(requests[1].headers.sign, 'fixture-signature'); + assert.equal(signatures[0], api.signingParts('POST', '/v2/g/login', requests[0].headers.common, '', '', requests[0].body)); }); diff --git a/tests/ios-glanceboard.test.cjs b/tests/ios-glanceboard.test.cjs index c90dc62f..0eb9e85e 100644 --- a/tests/ios-glanceboard.test.cjs +++ b/tests/ios-glanceboard.test.cjs @@ -82,6 +82,8 @@ function fixture() { '../native/nightscout-bridge': { nightscoutBridge: { async start() {}, async stop() {} } }, './glance-host': { GlanceHost }, './events': events, './device-addresses': { loadDeviceAddresses: () => ({}) }, './ios-peripheral-identity': { deviceAddressError: () => null }, + '../apps/launcher': { launcherEntries: () => [] }, + '../apps/evenhub/installed-apps': {}, '../apps/evenhub/manager': {}, '../apps/evenhub/updates': {}, '../apps/evenhub': {}, '../apps/launcher/launcher-app': { createLauncherWindow: () => window, LAUNCHER_SURFACE_ID: 'launcher' }, '../apps/all-apps': { ALL_APPS: [{ appId: 'glanceboard', glanceboard: provider }] }, '../ui/shell/worker-window': {}, '../ui/shell/in-process-window': {}, diff --git a/tests/native/ios-evenhub-test.m b/tests/native/ios-evenhub-test.m index 83c3230e..3a745d72 100644 --- a/tests/native/ios-evenhub-test.m +++ b/tests/native/ios-evenhub-test.m @@ -1,5 +1,6 @@ #import #import "FaceclawEvenHubWebView.h" +#import "FaceclawCrypto.h" @interface Probe : UIResponder @property(nonatomic) UIWindow *window; @@ -20,6 +21,8 @@ self.host.eventHandler = ^(NSString *json) { NSLog(@"EHPROBE %@", json); NSDictionary *event = [NSJSONSerialization JSONObjectWithData:[json dataUsingEncoding:NSUTF8StringEncoding] options:0 error:nil]; + if ([event[@"kind"] isEqual:@"error"] && [event[@"message"] containsString:@"outside the app origin"]) + [weakSelf.seen addObject:@"blocked-navigation"]; if ([event[@"kind"] isEqual:@"call"]) { [weakSelf.seen addObject:event[@"name"]]; [weakSelf.seen addObject:[NSString stringWithFormat:@"%ld:%@", (long)weakSelf.phase, event[@"name"]]]; @@ -31,19 +34,25 @@ dispatch_async(dispatch_get_main_queue(), ^{ [self.host start:[root stringByAppendingPathComponent:@"dist"] entrypoint:@"index.html" script:script]; }); - for (NSInteger phase = 2; phase <= 3; phase++) { + for (NSInteger phase = 2; phase <= 5; phase++) { dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (phase - 1) * 4 * NSEC_PER_SEC), dispatch_get_main_queue(), ^{ void (^handler)(NSString *) = self.host.eventHandler; [self.host showOnPhone]; [self.host hideOnPhone]; [self.host destroy]; self.phase = phase; self.host = [FaceclawEvenHubWebView new]; self.host.eventHandler = handler; self.host.packageIdentifier = phase == 2 ? package : [package stringByAppendingString:@".other"]; - [self.host start:[root stringByAppendingPathComponent:@"dist"] entrypoint:@"index.html" script:script]; + if (phase <= 3) [self.host start:[root stringByAppendingPathComponent:@"dist"] entrypoint:@"index.html" script:script]; + else { + NSString *url = [NSString stringWithContentsOfFile:[root stringByAppendingPathComponent:@"remote.txt"] encoding:NSUTF8StringEncoding error:nil]; + [self.host startURL:phase == 5 ? [url stringByAppendingString:@"redirect"] : url script:script]; + } }); } - dispatch_after(dispatch_time(DISPATCH_TIME_NOW, 12 * NSEC_PER_SEC), dispatch_get_main_queue(), ^{ - NSArray *required = @[@"early", @"module", @"fetch", @"image", @"timer", @"raf", @"wasm", @"traversal", @"1:stored", @"2:restored", @"3:stored"]; - BOOL passed = [[NSSet setWithArray:required] isSubsetOfSet:self.seen]; + dispatch_after(dispatch_time(DISPATCH_TIME_NOW, 21 * NSEC_PER_SEC), dispatch_get_main_queue(), ^{ + NSArray *required = @[@"early", @"module", @"fetch", @"image", @"timer", @"raf", @"wasm", @"traversal", @"1:stored", @"2:restored", @"3:stored", @"4:early", @"4:module", @"4:fetch", @"4:timer", @"blocked-navigation"]; + BOOL passed = [[NSSet setWithArray:required] isSubsetOfSet:self.seen] && ![self.seen containsObject:@"UNTRUSTED"]; + NSString *signature = [FaceclawCrypto hmacSha256:@"key" message:@"The quick brown fox jumps over the lazy dog"]; + passed &= [signature isEqual:@"97yD9DBThCSxMpjmqm+xQ+9NWaFJRhdZl0edvC0aPNg="]; [self.host showOnPhone]; [self.host hideOnPhone]; [self.host destroy]; NSDictionary *result = @{@"passed": @(passed), @"seen": self.seen.allObjects}; NSData *data = [NSJSONSerialization dataWithJSONObject:result options:0 error:nil]; From d1df4bf046172cafe1b308c699b20d567970f49c Mon Sep 17 00:00:00 2001 From: James Babcock Date: Sat, 19 Sep 2026 01:27:01 -0700 Subject: [PATCH 26/99] Fix missing EvenHub app icons; ungate Assistant section of settings --- App_Resources/iOS/src/FaceclawGraphics.m | 6 +++--- app/native/svg-rasterizer.ios.ts | 4 +++- app/ui/dashboard-settings.ts | 2 +- app/ui/dashboard/settings-menus.ts | 19 +++++++++---------- 4 files changed, 16 insertions(+), 15 deletions(-) diff --git a/App_Resources/iOS/src/FaceclawGraphics.m b/App_Resources/iOS/src/FaceclawGraphics.m index b66b7411..0c9e746c 100644 --- a/App_Resources/iOS/src/FaceclawGraphics.m +++ b/App_Resources/iOS/src/FaceclawGraphics.m @@ -96,9 +96,9 @@ NSMutableData *gray = [NSMutableData dataWithLength:size * size]; const uint8_t *src = rgba.bytes; uint8_t *dst = gray.mutableBytes; - for (NSInteger i = 0; i < size * size; i++) { - dst[i] = (uint8_t)round(0.2126 * src[i * 4] + 0.7152 * src[i * 4 + 1] + 0.0722 * src[i * 4 + 2]); - } + // Icons are monochrome coverage masks, matching Android IconRenderer. + // Source black/currentColor shapes must remain visible on black lenses. + for (NSInteger i = 0; i < size * size; i++) dst[i] = src[i * 4 + 3]; CGContextRelease(context); CGColorSpaceRelease(space); return gray; diff --git a/app/native/svg-rasterizer.ios.ts b/app/native/svg-rasterizer.ios.ts index 283045dd..41ed5d9a 100644 --- a/app/native/svg-rasterizer.ios.ts +++ b/app/native/svg-rasterizer.ios.ts @@ -2,7 +2,9 @@ import { rasterizeSvg as render } from './ios-graphics' export function rasterizeSvg(svg: string, size: number, strokeWidth: number) { // Shared icon sources rely on the Android renderer's white, rounded // stroke defaults. Supply those explicitly for a standards SVG renderer. - const source = svg.replace(/]*)>/, (_tag, attributes: string) => { + // Store icons use currentColor without a surrounding document/theme. + // Resolve it explicitly; SVGKit does not inherit a host CSS color here. + const source = svg.replace(/\bcurrentColor\b/gi, '#ffffff').replace(/]*)>/, (_tag, attributes: string) => { const defaults = { xmlns: 'http://www.w3.org/2000/svg', width: '24', height: '24', stroke: svg.includes('fill="none"') ? '#ffffff' : 'none', fill: '#ffffff', 'stroke-width': String(strokeWidth), 'stroke-linecap': 'round', 'stroke-linejoin': 'round' } diff --git a/app/ui/dashboard-settings.ts b/app/ui/dashboard-settings.ts index b447ccb7..95557747 100644 --- a/app/ui/dashboard-settings.ts +++ b/app/ui/dashboard-settings.ts @@ -607,7 +607,7 @@ export const assistantBackendSetting = new ConfigSettingEnum assistantBackendLabels[value] ?? value, description: - global.isIOS ? "Cloud models called with your OpenAI or Anthropic API key." : "Who answers assistant queries: an LLM called from the phone (a cloud API with your key, or the downloaded on-phone model), or your own long-running agent (e.g. OpenClaw) reached through the faceclaw-agent-bridge plugin.", + global.isIOS ? "Cloud models called with your OpenAI or Anthropic API key. Add your key in Settings > API Keys." : "Who answers assistant queries: an LLM called from the phone (a cloud API with your key, or the downloaded on-phone model), or your own long-running agent (e.g. OpenClaw) reached through the faceclaw-agent-bridge plugin.", }); export const assistantBridgeHostSetting = new ConfigSettingString({ diff --git a/app/ui/dashboard/settings-menus.ts b/app/ui/dashboard/settings-menus.ts index 76399b10..064c3965 100644 --- a/app/ui/dashboard/settings-menus.ts +++ b/app/ui/dashboard/settings-menus.ts @@ -127,18 +127,17 @@ function settingsSections(): SettingsSection[] { { label: "Assistant", items: [ - // On-phone LLM loop vs the user's own agent via the bridge plugin. + // iOS offers cloud APIs; Android also supports local models and the bridge. enumSettingMenuItem(assistantBackendSetting), enumSettingMenuItem(assistantModelSetting), - ...(!global.isIOS ? [localModelMenuItem()] : []), - // When on, a wakeword utterance goes straight to the assistant with no - // Send/Type menu step. - toggleSettingMenuItem(assistantSkipConfirmationSetting), + // iOS has no local LLM, wakeword event delivery, or agent bridge yet. ...(!global.isIOS ? [ - textSettingMenuItem(assistantBridgeHostSetting), - textSettingMenuItem(assistantBridgePortSetting), - textSettingMenuItem(assistantBridgeTokenSetting), - toggleSettingMenuItem(assistantAllowProactiveSetting), + localModelMenuItem(), + toggleSettingMenuItem(assistantSkipConfirmationSetting), + textSettingMenuItem(assistantBridgeHostSetting), + textSettingMenuItem(assistantBridgePortSetting), + textSettingMenuItem(assistantBridgeTokenSetting), + toggleSettingMenuItem(assistantAllowProactiveSetting), ] : []), ], }, @@ -243,7 +242,7 @@ function settingsSections(): SettingsSection[] { }, ]; if (!global.isIOS) return sections; - const deferred = new Set(["Assistant", "Navigate", "Watch"]); + const deferred = new Set(["Navigate", "Watch"]); return sections.map(section => { if (section.label === "Developer") return { ...section, items: [toggleSettingMenuItem(showBleBandwidthSetting)] }; if (section.label === "Voice") return { label: "Voice", items: [{ From 15a3e129b2e98709cdb8087c084c1e53c0005fe6 Mon Sep 17 00:00:00 2001 From: James Babcock Date: Sat, 19 Sep 2026 01:37:22 -0700 Subject: [PATCH 27/99] iOS wakeword support --- .../faceclaw/app/FaceclawVoiceController.java | 107 +----------------- App_Resources/iOS/src/FaceclawSpeech.h | 2 +- App_Resources/iOS/src/FaceclawSpeech.m | 11 +- app/g2/ble-protocol.ios.ts | 2 +- app/g2/ble-protocol.ts | 2 +- app/g2/ios-preview-controller.ts | 6 +- app/native/voice-control.ios.ts | 20 +++- app/ui/dashboard/settings-menus.ts | 10 +- .../com/faceclaw/app/VoiceEndpointDetector.kt | 66 +++++++++++ .../kotlin/com/faceclaw/app/IosNativeApi.kt | 2 +- tests/ai-chat.test.cjs | 41 ++++++- tests/ios-app-host.test.cjs | 67 +++++++++++ tests/ios-svg-icons.test.cjs | 29 +++++ tests/ios-voice.test.cjs | 22 +++- .../faceclaw/app/VoiceEndpointDetectorTest.kt | 42 +++++++ .../com/faceclaw/app/IosProtocolTest.kt | 16 +++ tests/voice-finalization.test.cjs | 33 +++++- 17 files changed, 341 insertions(+), 137 deletions(-) create mode 100644 native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/VoiceEndpointDetector.kt create mode 100644 tests/ios-svg-icons.test.cjs create mode 100644 tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/VoiceEndpointDetectorTest.kt diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawVoiceController.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawVoiceController.java index 37a53d58..de09ae61 100644 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawVoiceController.java +++ b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawVoiceController.java @@ -130,7 +130,7 @@ public class FaceclawVoiceController { private String lastTranscript = ""; private volatile boolean saveRecordings; private volatile boolean endpointing; - private final EndpointDetector endpointDetector = new EndpointDetector(); + private final VoiceEndpointDetector endpointDetector = new VoiceEndpointDetector(); private java.io.ByteArrayOutputStream recordingPcm; // Speaker verification against the enrolled wearer voice-print ("my voice // only" command gating). Configured before start(); the utterance PCM is @@ -1028,111 +1028,6 @@ public class FaceclawVoiceController { } } - /** - * Decides when a hands-free utterance is over, so "Hey Even" capture can - * stop without a button release. - * - * Runs on the decoded 16 kHz PCM, so it works the same in every input mode - * (the cloud path never sees the samples on this side, and the onboard - * recognizer's own endpointing only covers ONBOARD). - * - * Timing is measured on the sample clock rather than the wall clock: BLE - * delivers mic packets in bursts, so elapsed real time badly overestimates - * how much audio has actually been heard. - * - * The threshold is relative to a noise floor measured over the first - * {@link #CALIBRATE_MS} of the session, which is roughly the interval where - * the user is reacting to the dialog appearing and not yet speaking. - */ - private static final class EndpointDetector { - /** Audio used to estimate the room's noise floor. */ - private static final int CALIBRATE_MS = 300; - /** Speech must exceed this multiple of the noise floor to count as onset. */ - private static final double ONSET_FACTOR = 3.0; - /** Below this multiple of the noise floor counts as silence again. */ - private static final double RELEASE_FACTOR = 1.8; - /** Absolute floor, so a silent room can't make the threshold ~0. */ - private static final double MIN_RMS = 220.0; - /** Trailing silence that ends an utterance. */ - private static final int SILENCE_MS = 900; - /** If the user never speaks, give up rather than record forever. */ - private static final int LEAD_IN_MS = 6000; - /** Hard cap on a single utterance. */ - private static final int MAX_UTTERANCE_MS = 30000; - - private long totalSamples; - private double noiseAccum; - private int noisePackets; - private double threshold; - private boolean speechStarted; - private long silenceSamples; - private boolean fired; - - void reset() { - totalSamples = 0; - noiseAccum = 0; - noisePackets = 0; - threshold = 0; - speechStarted = false; - silenceSamples = 0; - fired = false; - } - - /** Returns true exactly once, on the packet that ends the utterance. */ - boolean accept(short[] pcm, int count) { - if (fired || count <= 0) { - return false; - } - totalSamples += count; - long elapsedMs = totalSamples * 1000L / SAMPLE_RATE; - - double sumSquares = 0; - for (int i = 0; i < count; i++) { - double s = pcm[i]; - sumSquares += s * s; - } - double rms = Math.sqrt(sumSquares / count); - - if (elapsedMs <= CALIBRATE_MS) { - noiseAccum += rms; - noisePackets++; - return false; - } - if (threshold == 0) { - double noiseFloor = noisePackets > 0 ? noiseAccum / noisePackets : 0; - threshold = Math.max(noiseFloor, MIN_RMS); - } - - if (!speechStarted) { - if (rms >= threshold * ONSET_FACTOR) { - speechStarted = true; - silenceSamples = 0; - } else if (elapsedMs >= LEAD_IN_MS) { - // Never heard anything; close the dialog rather than hang. - fired = true; - return true; - } - return false; - } - - if (rms < threshold * RELEASE_FACTOR) { - silenceSamples += count; - if (silenceSamples * 1000L / SAMPLE_RATE >= SILENCE_MS) { - fired = true; - return true; - } - } else { - silenceSamples = 0; - } - - if (elapsedMs >= MAX_UTTERANCE_MS) { - fired = true; - return true; - } - return false; - } - } - private void stopG2Audio() { FaceclawBleCommunicator currentCommunicator = communicator; if (currentCommunicator != null) { diff --git a/App_Resources/iOS/src/FaceclawSpeech.h b/App_Resources/iOS/src/FaceclawSpeech.h index 7474d225..49e14f8c 100644 --- a/App_Resources/iOS/src/FaceclawSpeech.h +++ b/App_Resources/iOS/src/FaceclawSpeech.h @@ -5,7 +5,7 @@ + (NSInteger)authorizationStatus; + (void)requestAuthorization:(void (^)(NSInteger status))completion; /** Returns an actionable error, or an empty string when capture starts. */ -- (NSString *)start; +- (NSString *)startWithEndpointing:(BOOL)endpointing; - (void)acceptPacket:(NSData *)packet; - (void)finish; - (void)cancel; diff --git a/App_Resources/iOS/src/FaceclawSpeech.m b/App_Resources/iOS/src/FaceclawSpeech.m index 631d6748..8da4da55 100644 --- a/App_Resources/iOS/src/FaceclawSpeech.m +++ b/App_Resources/iOS/src/FaceclawSpeech.m @@ -1,6 +1,7 @@ #import "FaceclawSpeech.h" #import "FaceclawLc3Decoder.h" #import "FaceclawSpeechTranscript.h" +#import #import #import #import @@ -16,6 +17,7 @@ @property(nonatomic) BOOL accepting; @property(nonatomic, copy) NSString *bestText; @property(nonatomic, strong) FaceclawSpeechTranscript *transcript; +@property(nonatomic, strong) FaceclawKitVoiceEndpointDetector *endpointDetector; @end @implementation FaceclawSpeech - (instancetype)init { @@ -33,7 +35,7 @@ NSData *json = [NSJSONSerialization dataWithJSONObject:event options:0 error:nil]; if (json) self.eventHandler([[NSString alloc] initWithData:json encoding:NSUTF8StringEncoding]); } -- (NSString *)start { +- (NSString *)startWithEndpointing:(BOOL)endpointing { [self cancel]; if (SFSpeechRecognizer.authorizationStatus != SFSpeechRecognizerAuthorizationStatusAuthorized) return @"Allow Speech Recognition for Faceclaw in iPhone Settings."; @@ -52,6 +54,7 @@ if (@available(iOS 16.0, *)) self.request.addsPunctuation = YES; self.bestText = @""; self.accepting = YES; self.transcript = [FaceclawSpeechTranscript new]; + self.endpointDetector = endpointing ? [FaceclawKitVoiceEndpointDetector new] : nil; NSUInteger generation = self.generation; __weak FaceclawSpeech *weakSelf = self; self.task = [self.recognizer recognitionTaskWithRequest:self.request resultHandler:^(SFSpeechRecognitionResult *result, NSError *error) { @@ -89,11 +92,13 @@ NSUInteger generation = self.generation; FaceclawLc3Decoder *decoder = self.decoder; SFSpeechAudioBufferRecognitionRequest *request = self.request; + FaceclawKitVoiceEndpointDetector *endpointDetector = self.endpointDetector; NSData *copy = [packet copy]; dispatch_async(self.audioQueue, ^{ @autoreleasepool { if (self.generation != generation) return; NSData *pcm = [decoder decodePacket:copy]; double rms = 0; + BOOL speechEnded = NO; if (pcm.length) { AVAudioFormat *format = [[AVAudioFormat alloc] initWithCommonFormat:AVAudioPCMFormatFloat32 sampleRate:16000 channels:1 interleaved:NO]; AVAudioPCMBuffer *buffer = [[AVAudioPCMBuffer alloc] initWithPCMFormat:format frameCapacity:(AVAudioFrameCount)(pcm.length / 2)]; @@ -105,11 +110,13 @@ } rms = sqrt(rms / buffer.frameLength); if (self.generation == generation) [request appendAudioPCMBuffer:buffer]; + speechEnded = [endpointDetector acceptLevelRms:rms * 32768.0 sampleCount:(int32_t)buffer.frameLength]; } NSUInteger packets = decoder.packets, errors = decoder.errors, missing = decoder.missing; dispatch_async(dispatch_get_main_queue(), ^{ if (self.generation != generation) return; self.pendingPackets--; + if (speechEnded && self.accepting) [self finish]; if (pcm.length && packets % 20 == 0) [self emit:@{@"kind":@"audio", @"packets":@(packets), @"seconds":@(packets * 0.05), @"rms":@(rms), @"missing":@(missing), @"errors":@(errors)}]; if (errors > 10 && !packets) [self complete:@"Could not decode glasses audio. Reconnect the glasses and retry."]; }); @@ -140,6 +147,6 @@ self.generation++; self.accepting = NO; self.pendingPackets = 0; [self.task cancel]; self.task = nil; self.request = nil; self.decoder = nil; self.recognizer = nil; - self.bestText = @""; self.transcript = nil; + self.bestText = @""; self.transcript = nil; self.endpointDetector = nil; } @end diff --git a/app/g2/ble-protocol.ios.ts b/app/g2/ble-protocol.ios.ts index e2cfaa80..fbf9adc4 100644 --- a/app/g2/ble-protocol.ios.ts +++ b/app/g2/ble-protocol.ios.ts @@ -52,7 +52,7 @@ export const readString = (data: Uint8Array, field: number): string => protocol. export function authenticationSucceeded(message: ProtocolMessage, magic: number): boolean { return message.sid === SID.auth && message.command === 4 && message.magic === magic && readBytes(message.payload, 3)?.length === 0 } -export type GlassesInput = { kind: 'sys-event' | 'list-click' | 'text-click' | 'display-wake'; eventType: number; eventSource: number; systemExitReasonCode: number; containerName: string; frameId: number } +export type GlassesInput = { kind: 'sys-event' | 'list-click' | 'text-click' | 'display-wake' | 'even-ai'; eventType: number; eventSource: number; systemExitReasonCode: number; containerName: string; frameId: number } function input(event: any): GlassesInput | null { return event ? { kind: event.kind === 'sys-event' && event.eventType === OsEventTypeList.HEAD_UP_EVENT ? 'display-wake' : event.kind, eventType: event.eventType, eventSource: event.eventSource, systemExitReasonCode: event.systemExitReasonCode, diff --git a/app/g2/ble-protocol.ts b/app/g2/ble-protocol.ts index e8115773..603e36d2 100644 --- a/app/g2/ble-protocol.ts +++ b/app/g2/ble-protocol.ts @@ -127,7 +127,7 @@ export function readString(data: Uint8Array, number: number): string { return Ar export function authenticationSucceeded(message: ProtocolMessage, magic: number): boolean { return message.sid === SID.auth && message.command === 4 && message.magic === magic && readBytes(message.payload, 3)?.length === 0 } -export type GlassesInput = { kind: 'sys-event' | 'list-click' | 'text-click' | 'display-wake'; eventType: number; eventSource: number; systemExitReasonCode: number; containerName: string; frameId: number } +export type GlassesInput = { kind: 'sys-event' | 'list-click' | 'text-click' | 'display-wake' | 'even-ai'; eventType: number; eventSource: number; systemExitReasonCode: number; containerName: string; frameId: number } export function decodeGlassesInput(message: ProtocolMessage): GlassesInput | null { if (message.sid !== SID.hub || ![1, 6].includes(message.flag)) return null const events = readBytes(message.payload, 13); if (!events) return null diff --git a/app/g2/ios-preview-controller.ts b/app/g2/ios-preview-controller.ts index 8e211581..f61fed99 100644 --- a/app/g2/ios-preview-controller.ts +++ b/app/g2/ios-preview-controller.ts @@ -93,7 +93,7 @@ export class IosPreviewController { ...noopLayerActions, requestRender: () => this.requestShellRender(), disconnect: () => this.disconnect(), - startVoiceCapture: () => this.startVoiceCapture(), + startVoiceCapture: endpointing => this.startVoiceCapture(endpointing), stopVoiceCapture: () => iosVoiceInput.stopPushToTalk(), startContinuousVoiceCapture: () => this.onError("Voice capture is not available on iOS yet."), startTextSettingEdit: async setting => { await this.editSetting(setting) }, @@ -437,9 +437,9 @@ export class IosPreviewController { if (!ready && this.active) this.onError(iosVoiceInput.statusText) return ready && this.session?.state.phase === 'connected' } - private async startVoiceCapture(): Promise { + private async startVoiceCapture(endpointing = false): Promise { if (!this.session || this.session.state.phase !== 'connected') return - await iosVoiceInput.startGlassesCapture(this.session, message => this.logBluetooth(message)) + await iosVoiceInput.startGlassesCapture(this.session, message => this.logBluetooth(message), endpointing) } private logBluetooth(message: string): void { const line = `${new Date().toISOString()} [${this.active ? 'foreground' : 'background'}${UIApplication.sharedApplication.protectedDataAvailable ? '' : ',protected-data-unavailable'}] ${message}` diff --git a/app/native/voice-control.ios.ts b/app/native/voice-control.ios.ts index 9aad3654..62c9df51 100644 --- a/app/native/voice-control.ios.ts +++ b/app/native/voice-control.ios.ts @@ -18,6 +18,8 @@ export class IosVoiceControlBridge { private session: IosMicrophoneSession | null = null private capturing = false private finalizing = false + private completion: Promise = Promise.resolve() + private resolveCompletion: (() => void) | null = null private audioTimer: ReturnType | null = null private packets = 0 private log: (message: string) => void = () => {} @@ -48,12 +50,13 @@ export class IosVoiceControlBridge { return true } get statusText(): string { return this.status } - async startGlassesCapture(session: IosMicrophoneSession, log: (message: string) => void): Promise { + async startGlassesCapture(session: IosMicrophoneSession, log: (message: string) => void, endpointing = false): Promise { this.stop() const generation = ++this.generation this.log = log; this.session = session; this.packets = 0; this.capturing = true - const error = String(this.ensureNative().start() ?? '') - if (error) { this.capturing = false; this.session = null; this.setStatus(error); this.emitEnd(); return } + this.completion = new Promise(resolve => { this.resolveCompletion = resolve }) + const error = String(this.ensureNative().startWithEndpointing(endpointing) ?? '') + if (error) { this.stop(); this.setStatus(error); this.emitEnd(); return } try { await session.setMicrophone(true, packet => { if (generation !== this.generation || !this.capturing) return @@ -74,16 +77,19 @@ export class IosVoiceControlBridge { this.stop(); this.setStatus(error instanceof Error ? error.message : String(error)); this.emitEnd() } } - stopPushToTalk(): void { - if (!this.capturing) return + stopPushToTalk(): Promise { + const completion = this.completion + if (!this.capturing) return completion this.capturing = false; this.finalizing = true this.clearAudioTimer(); this.releaseMicrophone() this.setStatus('Recognizing…'); this.native?.finish() + return completion } stop(): void { ++this.generation this.capturing = this.finalizing = false this.clearAudioTimer(); this.releaseMicrophone(); this.native?.cancel() + this.finishCompletion() } handleSessionEnded(): void { if (!this.capturing && !this.finalizing) return @@ -95,6 +101,9 @@ export class IosVoiceControlBridge { if (session) void session.setMicrophone(false).catch(error => this.log(`Voice microphone cleanup: ${error}`)) } private emitEnd(): void { for (const fn of [...this.ends]) fn() } + private finishCompletion(): void { + const resolve = this.resolveCompletion; this.resolveCompletion = null; resolve?.() + } private receive(event: { kind: string; text?: string; final?: boolean; message?: string; seconds?: number; packets?: number; rms?: number; missing?: number; errors?: number }): void { if (!this.capturing && !this.finalizing) return if (event.kind === 'transcript') { @@ -109,6 +118,7 @@ export class IosVoiceControlBridge { } else if (event.kind === 'ended') { this.capturing = this.finalizing = false this.clearAudioTimer(); this.releaseMicrophone() + this.finishCompletion() this.setStatus(event.message ?? 'Ready to send'); this.emitEnd() } } diff --git a/app/ui/dashboard/settings-menus.ts b/app/ui/dashboard/settings-menus.ts index 064c3965..c06aef99 100644 --- a/app/ui/dashboard/settings-menus.ts +++ b/app/ui/dashboard/settings-menus.ts @@ -130,10 +130,10 @@ function settingsSections(): SettingsSection[] { // iOS offers cloud APIs; Android also supports local models and the bridge. enumSettingMenuItem(assistantBackendSetting), enumSettingMenuItem(assistantModelSetting), - // iOS has no local LLM, wakeword event delivery, or agent bridge yet. + ...(!global.isIOS ? [localModelMenuItem()] : []), + toggleSettingMenuItem(assistantSkipConfirmationSetting), + // iOS has no local LLM or agent bridge yet. ...(!global.isIOS ? [ - localModelMenuItem(), - toggleSettingMenuItem(assistantSkipConfirmationSetting), textSettingMenuItem(assistantBridgeHostSetting), textSettingMenuItem(assistantBridgePortSetting), textSettingMenuItem(assistantBridgeTokenSetting), @@ -245,9 +245,9 @@ function settingsSections(): SettingsSection[] { const deferred = new Set(["Navigate", "Watch"]); return sections.map(section => { if (section.label === "Developer") return { ...section, items: [toggleSettingMenuItem(showBleBandwidthSetting)] }; - if (section.label === "Voice") return { label: "Voice", items: [{ + if (section.label === "Voice") return { label: "Voice", items: [enumSettingMenuItem(wakeWordActionSetting), { label: "On-device dictation (Apple)", disabled: true, onSelect: () => {}, - description: "Uses the glasses microphone and your iPhone's speech language. No API key needed. Open Voice from the phone or glasses menu, speak, then click to finish and send the text into an app.", + description: "Uses the glasses microphone and your iPhone's speech language. No transcription API key needed. Say Hey Even for hands-free input, or open Voice from the menu and click when finished.", }] }; if (deferred.has(section.label)) return { label: section.label, items: [{ label: "Not available on iOS yet", disabled: true, onSelect: () => {}, diff --git a/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/VoiceEndpointDetector.kt b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/VoiceEndpointDetector.kt new file mode 100644 index 00000000..c94a909f --- /dev/null +++ b/native/kotlin/shared/src/commonMain/kotlin/com/faceclaw/app/VoiceEndpointDetector.kt @@ -0,0 +1,66 @@ +package com.faceclaw.app + +import kotlin.math.max +import kotlin.math.sqrt + +/** Ends a hands-free utterance using the 16 kHz sample clock, not BLE arrival timing. + * Shared by Android's voice controller and iOS's native audio queue. + */ +class VoiceEndpointDetector { + private var totalSamples = 0L + private var noiseAccum = 0.0 + private var noisePackets = 0 + private var threshold = 0.0 + private var speechStarted = false + private var silenceSamples = 0L + private var fired = false + + fun reset() { + totalSamples = 0 + noiseAccum = 0.0 + noisePackets = 0 + threshold = 0.0 + speechStarted = false + silenceSamples = 0 + fired = false + } + + fun accept(pcm: ShortArray, count: Int): Boolean { + if (fired || count <= 0) return false + require(count <= pcm.size) + var squares = 0.0 + for (i in 0 until count) { + val sample = pcm[i].toDouble() + squares += sample * sample + } + return acceptLevel(sqrt(squares / count), count) + } + + /** RMS in PCM16 units. Allows native decoders to reuse their existing level calculation. */ + fun acceptLevel(rms: Double, sampleCount: Int): Boolean { + if (fired || sampleCount <= 0) return false + totalSamples += sampleCount + val elapsedMs = totalSamples * 1000 / 16000 + if (elapsedMs <= 300) { + noiseAccum += rms + noisePackets++ + return false + } + if (threshold == 0.0) threshold = max(if (noisePackets > 0) noiseAccum / noisePackets else 0.0, 220.0) + if (!speechStarted) { + if (rms >= threshold * 3.0) { + speechStarted = true + silenceSamples = 0 + } else if (elapsedMs >= 6000) { + fired = true + } + return fired + } + if (rms < threshold * 1.8) { + silenceSamples += sampleCount + if (silenceSamples * 1000 / 16000 >= 900) fired = true + } else silenceSamples = 0 + if (elapsedMs >= 30000) fired = true + return fired + } +} diff --git a/native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/app/IosNativeApi.kt b/native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/app/IosNativeApi.kt index 2c1b364f..2d3cb4ba 100644 --- a/native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/app/IosNativeApi.kt +++ b/native/kotlin/shared/src/iosMain/kotlin/com/faceclaw/app/IosNativeApi.kt @@ -128,7 +128,7 @@ class IosProtocol { BleProtocol.readStringFieldValue(data.byteArray(), field) fun glassesInput(data: NSData, sid: Int, flag: Int): G2Event? = - if (sid == BleProtocol.SID_EVENHUB && flag in intArrayOf(1, 6)) + if (sid in intArrayOf(BleProtocol.SID_EVENHUB, BleProtocol.SID_EVEN_AI) && flag in intArrayOf(1, 6)) G2Event.decodePayload(sid, data.byteArray()) else null diff --git a/tests/ai-chat.test.cjs b/tests/ai-chat.test.cjs index 1da80634..db028775 100644 --- a/tests/ai-chat.test.cjs +++ b/tests/ai-chat.test.cjs @@ -228,7 +228,7 @@ test('empty capture, rejection and closing never submit stale speech', async () } }); -function shellEnv() { +function shellEnv({ wakeAction = 'voice-input', skipConfirmation = false } = {}) { const gestures = load('app/ui/gestures.ts', {}); class Image { constructor(width = 576, height = 260) { this.width = width; this.height = height; } } const images = { GrayImage: Image, G2_LENS_WIDTH: 640, G2_LENS_HEIGHT: 480 }; @@ -244,11 +244,17 @@ function shellEnv() { paint(_ctx, below) { return below(); } handleInput(event, ctx) { if (event.type === 'double-click') ctx.stack.pop(); } } - const settings = { wakeWordActionSetting: { get: () => 'voice-input' }, brightnessSetting: { get: () => 'auto' } }; - const { shell } = load('app/ui/shell/shell.ts', { - '../../graphics/image': images, '../../graphics/plane': {}, '../../graphics/ui-fonts': {}, '../../g2/events': {}, + const voiceDialogs = []; + const settings = { wakeWordActionSetting: { get: () => wakeAction }, brightnessSetting: { get: () => 'auto' }, + assistantSkipConfirmationSetting: { get: () => skipConfirmation } }; + const { shell, rawInputEventToInputEvent } = load('app/ui/shell/shell.ts', { + '../../graphics/image': images, '../../graphics/plane': {}, '../../graphics/ui-fonts': {}, '../../g2/events': load('app/g2/events.ts', {}), '../gestures': gestures, '../layers': layers, '../menu': { MenuLayer: Menu }, - './voice-input': {}, './keyboard-input': {}, './voice-activity': {}, './assistant': {}, + './voice-input': { VoiceInputLayer: class { + constructor(options) { this.options = options; voiceDialogs.push(options); } + startCapture() {} + onRemoved() { this.options.onClosed(); } + } }, './keyboard-input': {}, './voice-activity': { voiceActivity: { setActive() {} } }, './assistant': {}, '../../assistant/conversations': {}, '../../assistant/models': {}, '../../native/settings-store': {}, '../notifications': {}, '../dashboard-settings': settings, './ambient-cards': {}, './chrome-layer': { ShellChromeLayer: class {} }, './modal-layer': {}, './tool-debug-layer': {}, @@ -280,9 +286,32 @@ function shellEnv() { }); shell.registerWindow(app.window); shell.focusWindow('ai-chat'); - return { shell, app, input, menus, microphone: () => microphone, event: (type) => gestures.makeInputEvent({ type }) }; + return { shell, app, input, menus, voiceDialogs, rawInputEventToInputEvent, microphone: () => microphone, event: (type) => gestures.makeInputEvent({ type }) }; } +test('wakeword wakes the shared shell, respects its action, and opens only one hands-free assistant dialog', async () => { + for (const wakeAction of ['off', 'turn-screen-on', 'voice-input']) { + const env = shellEnv({ wakeAction, skipConfirmation: true }); + env.shell.isAssistantAvailable = () => true; + env.shell.sleep(); + const event = env.rawInputEventToInputEvent({ kind: 'even-ai', eventType: 1, eventSource: 0 }); + assert.equal(event.type, 'wakeword'); + await env.shell.receiveInput(event); + await new Promise(resolve => setImmediate(resolve)); + assert.equal(env.shell.isScreenOn(), wakeAction !== 'off'); + assert.equal(env.voiceDialogs.length, wakeAction === 'voice-input' ? 1 : 0); + if (wakeAction === 'voice-input') { + const options = env.voiceDialogs[0]; + assert.equal(options.handsFree, true); + assert.equal(options.autoSend, true); + assert.equal(options.sendTargets[options.defaultTargetIndex].id, 'assistant'); + await env.shell.receiveInput(event); + assert.equal(env.voiceDialogs.length, 1); + } + env.shell.stack.clearToBase(); + } +}); + test('chat holds bypass the escape timer; release, menus and double tap follow the requested routing', async () => { const env = shellEnv(); await env.shell.receiveInput(env.event('long-press')); diff --git a/tests/ios-app-host.test.cjs b/tests/ios-app-host.test.cjs index 44435ca6..f67fcdcc 100644 --- a/tests/ios-app-host.test.cjs +++ b/tests/ios-app-host.test.cjs @@ -42,6 +42,73 @@ test('iOS settings prompts honor password input and report cancellation', async assert.equal(prompts[0].inputType, 'password'); assert.equal(accepted, false); assert.deepEqual(writes, []); }); + +test('iOS host forwards hands-free capture mode to the voice bridge', async () => { + const captures = []; + const { IosPreviewController } = load('app/g2/ios-preview-controller.ts', { require: id => id === '../native/ios-voice-input' + ? { iosVoiceInput: { startGlassesCapture: (_session, _log, endpointing) => captures.push(endpointing) } } : {} }); + const host = Object.create(IosPreviewController.prototype); + host.session = { state: { phase: 'connected' } }; + await host.startVoiceCapture(true); + await host.startVoiceCapture(); + assert.deepEqual(captures, [true, false]); +}); + +for (const isIOS of [true, false]) { + test(`${isIOS ? 'iOS' : 'Android'} Assistant settings expose supported controls and usable model choices`, () => { + const store = new Map(); + let picker; + const models = load('app/assistant/models.ts', { global: { isIOS }, require: () => ({ + LOCAL_MODEL: { label: 'Qwen', id: 'qwen' }, isLocalModelReady: () => false, + }) }); + const settings = load('app/ui/dashboard-settings.ts', { global: { isIOS }, require: id => { + if (id.includes('settings-store')) return { + onSettingsStoreChanged() {}, + getStringSetting: (key, fallback) => store.get(key) ?? fallback, + setStringSetting: (key, value) => store.set(key, value), + getBooleanSetting: (key, fallback) => store.get(key) ?? fallback, + setBooleanSetting: (key, value) => store.set(key, value), + }; + if (id === '~/assistant/models') return models; + return { Layer: class {}, isLocalModelReady: () => false, + openModalMenu: (_ctx, _title, items) => { picker = items; } }; + } }); + const menus = load('app/ui/dashboard/settings-menus.ts', { global: { isIOS }, require: id => { + if (id === '../dashboard-settings') return settings; + if (id === './settings-panel') return { SettingsPanelLayer: class { constructor(sections) { this.sections = sections; } } }; + return { LOCAL_MODEL: { sizeBytes: 1000 }, ASR_MODELS: { moonshine: {}, 'whisper-base-en': {} }, + uiFontPickerMenuItem: () => ({ label: 'Font' }), terminalFontPickerMenuItem: () => ({ label: 'Terminal font' }) }; + } }); + const sections = menus.createSettingsPanelLayer().sections; + const assistant = sections.find(section => section.label === 'Assistant'); + assert.equal(assistant.items.some(item => item.disabled === true), false); + const ctx = { stack: { pop() {} }, actions: { requestRender() {} } }; + const row = setting => assistant.items.find(item => item.label === setting.label); + row(settings.assistantBackendSetting).onSelect(ctx); + assert.deepEqual(Array.from(picker, item => item.label), isIOS ? ['Cloud API'] : ['On-phone', 'My own agent (bridge)']); + assert.equal(assistant.items.some(item => item.label === 'On-phone model'), !isIOS); + assert.equal(!!row(settings.assistantBridgeHostSetting), !isIOS); + assert.equal(!!row(settings.assistantAllowProactiveSetting), !isIOS); + row(settings.assistantModelSetting).onSelect(ctx); + assert.equal(picker.some(item => item.label.includes('Qwen')), !isIOS); + const terra = picker.find(item => item.label === 'Terra'); + assert.equal(terra.disabled(), true); + const keys = sections.find(section => section.label === 'API Keys').items; + assert.ok(keys.some(item => item.label === settings.openAiApiKeySetting.label)); + assert.ok(keys.some(item => item.label === settings.anthropicApiKeySetting.label)); + settings.openAiApiKeySetting.set('fixture-key'); + assert.equal(terra.disabled(), false); + terra.onSelect(ctx); + assert.equal(settings.assistantModelSetting.get(), 'terra'); + assert.equal(models.resolveAssistantModel(settings.assistantModelSetting.get(), { + openai: settings.openAiApiKeySetting.get(), anthropic: '', + }).provider, 'openai'); + row(settings.assistantSkipConfirmationSetting).onSelect(ctx); + assert.equal(settings.assistantSkipConfirmationSetting.get(), true); + assert.ok(sections.find(section => section.label === 'Voice').items.some(item => item.label === settings.wakeWordActionSetting.label)); + }); +} + test('iOS phone battery distinguishes unknown, charging, full and unplugged readings', () => { const device = { batteryLevel: -1, batteryState: 0 }; const api = load('app/native/phone-battery.ts', { require: () => ({}), global: { isIOS: true }, diff --git a/tests/ios-svg-icons.test.cjs b/tests/ios-svg-icons.test.cjs new file mode 100644 index 00000000..65ee588a --- /dev/null +++ b/tests/ios-svg-icons.test.cjs @@ -0,0 +1,29 @@ +const test = require('node:test'); +const assert = require('node:assert/strict'); +const { loader } = require('./helpers/load-typescript.cjs'); + +function renderSource(svg) { + let source; + const { rasterizeSvg } = loader({}, { './ios-graphics': { + rasterizeSvg: (value, size) => { source = value; assert.equal(size, 32); return 'rendered'; }, + } })('app/native/svg-rasterizer.ios.ts'); + assert.equal(rasterizeSvg(svg, 32, 2), 'rendered'); + return source; +} + +test('EvenHub currentColor SVG fills are resolved before handing them to SVGKit', () => { + // Same document shape as the Snake and Weather store icons copied from the phone. + const source = renderSource(''); + assert.match(source, /fill="#ffffff"/); + assert.doesNotMatch(source, /currentColor/i); + assert.equal((source.match(/fill=/g) || []).length, 1); + assert.match(source, /viewBox="0 0 24 24"/); +}); + +test('currentColor strokes/styles resolve without filling open Lucide shapes', () => { + const source = renderSource(''); + assert.match(source, /fill="none"/); + assert.match(source, /stroke="#ffffff"/); + assert.match(source, /style="stroke:#ffffff"/); + assert.match(source, /stroke-linecap="round"/); +}); diff --git a/tests/ios-voice.test.cjs b/tests/ios-voice.test.cjs index ec29c011..5e3a924e 100644 --- a/tests/ios-voice.test.cjs +++ b/tests/ios-voice.test.cjs @@ -4,7 +4,7 @@ const fs = require('node:fs'); const vm = require('node:vm'); const ts = require('typescript'); function harness() { - const native = { start: () => '', cancel() { this.cancels++; }, cancels: 0, finish() { this.finished = true; }, acceptPacket: p => audio.push(p) }; + const native = { startWithEndpointing(endpointing) { this.endpointing = endpointing; return ''; }, cancel() { this.cancels++; }, cancels: 0, finish() { this.finished = true; }, acceptPacket: p => audio.push(p) }; const audio = [], timers = new Map(), commands = [], text = []; let authorization = 3, permissionRequests = 0, release; const sandbox = { exports: {}, FaceclawSpeech: { new: () => native, authorizationStatus: () => authorization, @@ -61,3 +61,23 @@ test('missing microphone data ends the session and disables the mic with an acti for (const fn of h.timers.values()) fn(); assert.deepEqual(h.commands, [true, false]); assert.match(h.bridge.statusText, /No microphone audio/); }); + +test('hands-free endpointing releases the microphone and waits for the final transcript before completing', async () => { + const h = harness(); let ends = 0, completed = false; + h.bridge.onSpeechEnd(() => ends++); + const start = h.bridge.startGlassesCapture(h.session, () => {}, true); h.release(); await start; + assert.equal(h.native.endpointing, true); + h.event({ kind: 'transcript', text: 'Set a timer', final: false }); + h.event({ kind: 'finishing' }); + const completion = h.bridge.stopPushToTalk().then(() => { completed = true; }); + await Promise.resolve(); + assert.equal(completed, false); assert.equal(ends, 1); + assert.deepEqual(h.commands, [true, false]); + h.event({ kind: 'transcript', text: 'Set a timer for five minutes.', final: true }); + h.event({ kind: 'ended' }); await completion; + assert.equal(completed, true); + assert.equal(h.text.at(-1).text, 'Set a timer for five minutes.'); + const manual = h.bridge.startGlassesCapture(h.session, () => {}); h.release(); await manual; + assert.equal(h.native.endpointing, false); + const cancelled = h.bridge.stopPushToTalk(); h.bridge.stop(); await cancelled; +}); diff --git a/tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/VoiceEndpointDetectorTest.kt b/tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/VoiceEndpointDetectorTest.kt new file mode 100644 index 00000000..845cf711 --- /dev/null +++ b/tests/kotlin/src/commonTest/kotlin/com/faceclaw/app/VoiceEndpointDetectorTest.kt @@ -0,0 +1,42 @@ +package com.faceclaw.app + +import kotlin.test.* + +class VoiceEndpointDetectorTest { + @Test fun silenceEndsOnlyAfterSpeechAndFiresOnce() { + val detector = VoiceEndpointDetector() + repeat(6) { assertFalse(detector.acceptLevel(100.0, 800)) } + repeat(10) { assertFalse(detector.accept(ShortArray(800) { 2000 }, 800)) } + repeat(17) { assertFalse(detector.acceptLevel(100.0, 800)) } + assertTrue(detector.acceptLevel(100.0, 800)) + assertFalse(detector.acceptLevel(100.0, 800)) + detector.reset() + assertFalse(detector.acceptLevel(100.0, 800)) + } + + @Test fun pausesResetWhenSpeechResumesAndContinuousSpeechIsBounded() { + val detector = VoiceEndpointDetector() + repeat(6) { assertFalse(detector.acceptLevel(0.0, 800)) } + assertFalse(detector.acceptLevel(2000.0, 800)) + repeat(17) { assertFalse(detector.acceptLevel(0.0, 800)) } + assertFalse(detector.acceptLevel(2000.0, 800)) + repeat(17) { assertFalse(detector.acceptLevel(0.0, 800)) } + assertTrue(detector.acceptLevel(0.0, 800)) + detector.reset() + repeat(6) { assertFalse(detector.acceptLevel(0.0, 800)) } + repeat(593) { assertFalse(detector.acceptLevel(2000.0, 800)) } + assertTrue(detector.acceptLevel(2000.0, 800)) + } + + @Test fun quietRoomTimesOutOnSampleClockAndNoiseCalibrationIsRelative() { + val detector = VoiceEndpointDetector() + repeat(119) { assertFalse(detector.acceptLevel(0.0, 800)) } + assertTrue(detector.acceptLevel(0.0, 800)) + detector.reset() + repeat(6) { assertFalse(detector.acceptLevel(1000.0, 800)) } + repeat(20) { assertFalse(detector.acceptLevel(2000.0, 800)) } + assertFalse(detector.acceptLevel(4000.0, 800)) + repeat(17) { assertFalse(detector.acceptLevel(1000.0, 800)) } + assertTrue(detector.acceptLevel(1000.0, 800)) + } +} diff --git a/tests/kotlin/src/iosTest/kotlin/com/faceclaw/app/IosProtocolTest.kt b/tests/kotlin/src/iosTest/kotlin/com/faceclaw/app/IosProtocolTest.kt index 0afc74d4..436058b0 100644 --- a/tests/kotlin/src/iosTest/kotlin/com/faceclaw/app/IosProtocolTest.kt +++ b/tests/kotlin/src/iosTest/kotlin/com/faceclaw/app/IosProtocolTest.kt @@ -47,6 +47,22 @@ internal actual fun inflateRecords(records: List): List = } class IosProtocolTest { + @Test + fun wakewordPacketsReachTheSharedEventDecoder() { + val api = IosProtocol() + val ctrl = BleProtocol.encodeVarintField(1, 1) // EVEN_AI_WAKE_UP + val payload = (BleProtocol.encodeVarintField(1, BleProtocol.EVEN_AI_CMD_CTRL) + + BleProtocol.encodeBytesField(3, ctrl)).data() + for (flag in listOf(1, 6)) { + val event = assertNotNull(api.glassesInput(payload, BleProtocol.SID_EVEN_AI, flag)) + assertEquals("even-ai", event.kind) + assertEquals(1, event.eventType) + } + assertNull(api.glassesInput(payload, BleProtocol.SID_EVEN_AI, 2)) + assertNull(api.glassesInput(payload, 0xff, 1)) + assertNull(api.glassesInput(byteArrayOf().data(), BleProtocol.SID_EVEN_AI, 1)) + } + @Test fun platformClockAndWriteModes() { val before = IosProtocolPlatform.elapsedRealtimeMs() diff --git a/tests/voice-finalization.test.cjs b/tests/voice-finalization.test.cjs index ce879820..c656a94f 100644 --- a/tests/voice-finalization.test.cjs +++ b/tests/voice-finalization.test.cjs @@ -13,27 +13,29 @@ function load(file, deps, globals = {}) { return exports; } -function dialog({ autoSend = false, deferred = true, synchronousFinal } = {}) { +function dialog({ autoSend = false, deferred = true, synchronousFinal, isIOS = false, handsFree = false } = {}) { const listeners = new Set(), timers = new Map(), sent = [], refinements = []; - let complete, timerId = 0, starts = 0, frame; + let complete, timerId = 0, starts = 0, frame, speechEnd, endpointing; let completion = new Promise(resolve => { complete = resolve; }); const { VoiceInputLayer } = load('app/ui/shell/voice-input.ts', { '../../native/voice-control': { voiceControlBridge: { onTranscript(cb) { listeners.add(cb); return () => listeners.delete(cb); }, onStatus() { return () => {}; }, + onSpeechEnd(cb) { speechEnd = cb; return () => { speechEnd = null; }; }, + stop() {}, } }, '../../native/anthropic': { refineDictation(options) { refinements.push(options); return { cancel() {} }; } }, '../dashboard-settings': { anthropicApiKeySetting: { get: () => 'key' } }, '../gestures': { gestureHints: () => '' }, './input-dialog': { paintInputDialog(_image, options) { frame = options; } }, }, { - global: { isIOS: false }, + global: { isIOS }, setTimeout(cb) { const id = ++timerId; timers.set(id, cb); return id; }, clearTimeout(id) { timers.delete(id); }, }); const transcript = (text, isFinal = false) => { for (const cb of [...listeners]) cb({ text, isFinal }); }; - const layer = new VoiceInputLayer({ autoSend, onClosed() {}, dismiss: () => layer.onRemoved(), - actions: { requestRender() {}, startVoiceCapture() { starts++; }, stopVoiceCapture() { + const layer = new VoiceInputLayer({ autoSend, handsFree, onClosed() {}, dismiss: () => layer.onRemoved(), + actions: { requestRender() {}, startVoiceCapture(value) { starts++; endpointing = value; }, stopVoiceCapture() { if (synchronousFinal) transcript(synchronousFinal, true); return deferred ? completion : undefined; } }, @@ -41,6 +43,7 @@ function dialog({ autoSend = false, deferred = true, synchronousFinal } = {}) { }); layer.startCapture(); return { layer, sent, refinements, transcript, starts: () => starts, + endpoint: () => speechEnd?.(), endpointing: () => endpointing, input: type => layer.handleInput({ type }, {}), frame() { layer.paint({}, () => ({})); return frame; }, timeout() { for (const [id, cb] of [...timers]) { timers.delete(id); cb(); } }, @@ -50,6 +53,26 @@ function dialog({ autoSend = false, deferred = true, synchronousFinal } = {}) { }; } +for (const autoSend of [true, false]) { + test(`iOS wakeword silence completion ${autoSend ? 'auto-sends' : 'asks for confirmation'} only after final recognition`, async () => { + const env = dialog({ isIOS: true, handsFree: true, autoSend }); + assert.equal(env.endpointing(), true); + env.transcript('Set a timer'); + env.endpoint(); env.timeout(); + env.input('click'); // Cannot send a partial while native recognition drains. + assert.deepEqual(env.sent, []); + env.transcript('Set a timer for five minutes.', true); + await env.complete(); env.timeout(); + if (!autoSend) { + assert.deepEqual(env.sent, []); + env.input('click'); + } + assert.deepEqual(env.sent, ['Set a timer for five minutes.']); + env.endpoint(); env.timeout(); + assert.equal(env.sent.length, 1); + }); +} + for (const partial of ['', 'Set a timer']) { test(`auto-send waits for slow native recognition with ${partial ? 'a committed segment' : 'no partial'}`, async () => { const env = dialog({ autoSend: true }); From 0337470c05d96361ae48aafd3d7f0b47b2fed617 Mon Sep 17 00:00:00 2001 From: James Babcock Date: Sat, 19 Sep 2026 02:18:23 -0700 Subject: [PATCH 28/99] Mark stock firmware 2.3 as validated for installing custom firmware over --- CHANGELOG | 1 + app/g2/firmware-compat.ts | 2 +- tests/firmware-compat.test.cjs | 4 +++- 3 files changed, 5 insertions(+), 2 deletions(-) diff --git a/CHANGELOG b/CHANGELOG index 37d8432b..e81a64a5 100644 --- a/CHANGELOG +++ b/CHANGELOG @@ -2,6 +2,7 @@ ## 0.7.1 - Unreleased +* Mark stock firmware 2.3 as validated for installing custom firmware over * Add Wear OS watch battery indicator to the top bar and Glanceboard * Glanceboard tap setting includes a Disable option * Refinements to builtin games diff --git a/app/g2/firmware-compat.ts b/app/g2/firmware-compat.ts index 7a85eb00..3de376c2 100644 --- a/app/g2/firmware-compat.ts +++ b/app/g2/firmware-compat.ts @@ -36,7 +36,7 @@ const LEGACY_PREFIX = "EVENCFW"; // unrecognized (its layout may differ from what our patch set targets). export const BASE_STOCK_VERSION = [2, 2, 9, 22]; export const BASE_STOCK_VERSION_TEXT = BASE_STOCK_VERSION.join("."); -export const VALIDATED_STOCK_VERSION = [2, 2, 10, 10]; +export const VALIDATED_STOCK_VERSION = [2, 3, 0, 24]; export const VALIDATED_STOCK_VERSION_TEXT = VALIDATED_STOCK_VERSION.join("."); export type FirmwareExtension = diff --git a/tests/firmware-compat.test.cjs b/tests/firmware-compat.test.cjs index 1db8134f..24077d85 100644 --- a/tests/firmware-compat.test.cjs +++ b/tests/firmware-compat.test.cjs @@ -63,7 +63,9 @@ test("stock firmware classifies by base version and warns on the main screen", ( assert.equal(compat.classifyOnboardingFirmware(info("", "2.2.9.22", "2.2.9.22")).kind, "flashable-stock"); assert.equal(compat.classifyOnboardingFirmware(info("", "2.2.4.34", "")).kind, "flashable-stock"); assert.equal(compat.classifyOnboardingFirmware(info("", "2.2.10.10", "2.2.10.10")).kind, "newer-stock-validated"); - assert.equal(compat.classifyOnboardingFirmware(info("", "2.3.0.1", "2.3.0.1")).kind, "newer-stock-unvalidated"); + assert.equal(compat.classifyOnboardingFirmware(info("", "2.3.0.1", "2.3.0.1")).kind, "newer-stock-validated"); + assert.equal(compat.classifyOnboardingFirmware(info("", "2.3.0.24", "2.3.0.24")).kind, "newer-stock-validated"); + assert.equal(compat.classifyOnboardingFirmware(info("", "2.3.0.24", "2.3.0.25")).kind, "newer-stock-unvalidated"); // Faceclaw firmware on a newer base is still judged by its revision, not the base. assert.equal(compat.classifyOnboardingFirmware(info(`Faceclaw/${REQUIRED}`, "2.3.0.1", "2.3.0.1")).kind, "custom"); }); From 7d7dc78744ad00106f4fa5222db66dc248d2b175 Mon Sep 17 00:00:00 2001 From: James Babcock Date: Sat, 19 Sep 2026 02:24:27 -0700 Subject: [PATCH 29/99] Update CHANGELOG --- CHANGELOG | 17 +++++++++++++---- 1 file changed, 13 insertions(+), 4 deletions(-) diff --git a/CHANGELOG b/CHANGELOG index e81a64a5..de4d6d05 100644 --- a/CHANGELOG +++ b/CHANGELOG @@ -2,14 +2,23 @@ ## 0.7.1 - Unreleased +### Features + * Mark stock firmware 2.3 as validated for installing custom firmware over +* Add on-device Whisper as a voice transcription option * Add Wear OS watch battery indicator to the top bar and Glanceboard -* Glanceboard tap setting includes a Disable option * Refinements to builtin games -* Optimize bluetooth message transport * Short-the-long gesture from screen off activates the glanceboard -* Glanceboard has a 2x3 layout option -* Compass no longer discards calibration when off +* Compass: No longer discards calibration when off +* Glanceboard: Tap setting includes a Disable option +* Glanceboard: Add a 2x3 layout option + +### Technical + +* Custom bluetooth messages now use a new SID, rather than modifying the stock image-update message type +* Compression is done at the transport layer, rather than individual image data buffers +* Expand the texture cache to 256kb +* Convert a large chunk of the codebase from Android-specific Java to cross-platform Kotlin for iOS porting ## 0.7.0 - 2026-09-12 From e2b35ada1a20ae341fa464efb44aff9d2816fe7a Mon Sep 17 00:00:00 2001 From: James Babcock Date: Sat, 19 Sep 2026 02:55:13 -0700 Subject: [PATCH 30/99] Port lock screen to iOS --- app/g2/dashboard-controller.ts | 23 +------ app/g2/glasses-session.ts | 17 +++++- app/g2/ios-preview-controller.ts | 97 +++++++++++++++++++++++++++--- app/g2/lock-screen.ts | 24 ++++++++ app/g2/wear-protocol.ts | 15 +++++ app/native/voice-control.ios.ts | 4 +- app/ui/dashboard-settings.ts | 3 +- app/ui/dashboard/settings-menus.ts | 2 +- tests/ios-app-host.test.cjs | 4 +- tests/ios-ble.test.cjs | 45 +++++++++++++- tests/ios-glanceboard.test.cjs | 84 ++++++++++++++++++++++++-- tests/tsconfig.json | 1 + 12 files changed, 273 insertions(+), 46 deletions(-) create mode 100644 app/g2/lock-screen.ts create mode 100644 app/g2/wear-protocol.ts diff --git a/app/g2/dashboard-controller.ts b/app/g2/dashboard-controller.ts index a70a7c55..d4187363 100644 --- a/app/g2/dashboard-controller.ts +++ b/app/g2/dashboard-controller.ts @@ -51,8 +51,7 @@ import { voiceControlBridge } from "../native/voice-control"; import { G2_LENS_HEIGHT, G2_LENS_WIDTH, GrayImage } from "../graphics/image"; import { flattenPlanesWithDraws, planesFingerprint, type Plane } from "../graphics/plane"; import { prepareFrameDraws } from "../graphics/glyph-wire"; -import { getDefaultMediumFont } from "../graphics/ui-fonts"; -import { wrapText } from "../graphics/textwrap"; +import { createLockScreenImage, LOCK_SCREEN_SURFACE_ID } from "./lock-screen"; import { rawInputEventToInputEvent, shell, type ShellInputOutcome } from "../ui/shell/shell"; import { type InputEvent } from "../ui/gestures"; import { registerSystemTools } from "../assistant/system-tools"; @@ -141,8 +140,6 @@ type DashboardListener = (snapshot: DashboardSnapshot) => void; const SHELL_SURFACE_ID = "shell"; /** The shell chrome composites above every window surface (zOrder 0). */ const SHELL_SURFACE_Z_ORDER = 1; -const LOCK_SCREEN_SURFACE_ID = "lock-screen"; -const LOCK_SCREEN_MESSAGE = "Glasses locked; unlock the phone to unlock the glasses."; // Top-bar clock refresh; the phone-side preview polls the Java composite so // it reflects every app (including worker apps the TS side never renders). const SHELL_REFRESH_INTERVAL_MS = 60_000; @@ -172,24 +169,6 @@ function createInitialDisplayPreview(): ImageSource | null { return grayImageToPreviewSource(new GrayImage(G2_LENS_WIDTH, G2_LENS_HEIGHT, 0)); } -function createLockScreenImage(): GrayImage { - const image = new GrayImage(G2_LENS_WIDTH, G2_LENS_HEIGHT, 0); - const font = getDefaultMediumFont(); - const boxWidth = 480; - const boxHeight = 150; - const boxX = Math.round((G2_LENS_WIDTH - boxWidth) / 2); - const boxY = Math.round((G2_LENS_HEIGHT - boxHeight) / 2); - image.drawRoundedRect(boxX, boxY, boxWidth, boxHeight, 150, 12); - const lines = wrapText(font, LOCK_SCREEN_MESSAGE, boxWidth - 64); - const textHeight = lines.length * font.lineHeight; - const firstY = boxY + Math.round((boxHeight - textHeight) / 2); - lines.forEach((line, index) => { - const x = Math.round((G2_LENS_WIDTH - font.measureText(line)) / 2); - image.drawText(font, x, firstY + index * font.lineHeight, line, 230); - }); - return image; -} - function formatTimestamp(date: Date): string { return date.toISOString().slice(11, 23); } diff --git a/app/g2/glasses-session.ts b/app/g2/glasses-session.ts index d3aeca16..e7502923 100644 --- a/app/g2/glasses-session.ts +++ b/app/g2/glasses-session.ts @@ -6,6 +6,7 @@ import { CfwTransport, CFW_MAX_MESSAGE, parseCfwAcks } from './cfw-transport' import { hasCompatibleFirmware, firmwareIncompatibilityMessage, REQUIRED_FACECLAW_FIRMWARE_VERSION } from './firmware-compat' import { hexToBytes } from '../util/hex-util' import { deviceAddressError } from './ios-peripheral-identity' +import { decodeWearState, enableWearDetection, queryWearState } from './wear-protocol' declare function setTimeout(callback: () => void, ms: number): number declare function clearTimeout(id: number): void @@ -84,7 +85,8 @@ export class GlassesSession { private readonly onInput: (input: protocol.GlassesInput) => void, private readonly log: (message: string) => void = () => {}, private readonly onActivity: () => void = () => {}, - private readonly onCompass: (event: CompassEvent) => void = () => {}) { + private readonly onCompass: (event: CompassEvent) => void = () => {}, + private readonly onWearState: (wearing: boolean) => void = () => {}) { this.off = transport.onEvent(event => this.receive(event)) } private update(phase: SessionState['phase'], status: string): void { @@ -134,6 +136,7 @@ export class GlassesSession { await this.lease(true) await this.request('right', protocol.SID.hub, protocol.createLayout, 'Create display layout') this.check(generation); this.layoutCreated = true + await this.enableWearDetectionAndRequestState(); this.check(generation) this.lastHeartbeat = this.lastLease = this.lastSettings = Date.now() this.displayed = null; this.retryCount = 0 this.update('connected', 'Glasses connected') @@ -353,6 +356,8 @@ export class GlassesSession { } } if (message.sid === protocol.SID.settings) this.applySettings(message) + const wearing = decodeWearState(message) + if (wearing !== null) this.onWearState(wearing) if (event.identifier === this.ids.right) { if (this.state.phase === 'connected') { const compass = protocol.decodeCompassInput(message) @@ -389,6 +394,16 @@ export class GlassesSession { } this.onState({ ...this.state }) } + async enableWearDetectionAndRequestState(): Promise { + const generation = this.generation + // Like Android, a missing enable ACK must not suppress the current-state query. + try { await this.request('right', protocol.SID.settings, enableWearDetection, 'Enable wear detection') } + catch (error) { if (!(error instanceof AckTimeout)) throw error; this.log(this.message(error)) } + this.check(generation) + await this.send('right', protocol.SID.settings, 0x20, queryWearState()) + this.check(generation) + await this.send('left', protocol.SID.settings, 0x20, queryWearState()) + } setFrame(gray: Uint8Array): void { if (this.state.phase !== 'connected') return this.latest = protocol.packGray4(gray, 640, 480); this.schedule(0) diff --git a/app/g2/ios-preview-controller.ts b/app/g2/ios-preview-controller.ts index f61fed99..ac7be2db 100644 --- a/app/g2/ios-preview-controller.ts +++ b/app/g2/ios-preview-controller.ts @@ -16,6 +16,7 @@ import { iosVoiceInput } from '../native/ios-voice-input' import { nightscoutBridge } from '../native/nightscout-bridge' import { GlassesSession, type SessionState } from './glasses-session' import { GlanceHost, type GlanceDisplay } from './glance-host' +import { createLockScreenImage, LOCK_SCREEN_SURFACE_ID } from './lock-screen' import { OsEventTypeList } from './events' import { loadDeviceAddresses } from './device-addresses' import { deviceAddressError } from './ios-peripheral-identity' @@ -37,7 +38,7 @@ import { TextViewerLayer } from '../apps/files/text-viewer' import { shell, rawInputEventToInputEvent, type ShellWindow } from '../ui/shell/shell' import { appViewportRect, SIDEBAR_WIDTH, sidebarStripVisible } from '../ui/shell/geometry' import { DISPLAY_MODE_VALUES, displayModeLabel, displayModeSetting, onAnySettingChanged, - previewColorSetting } from '../ui/dashboard-settings' + previewColorSetting, lockScreenEnabledSetting } from '../ui/dashboard-settings' import type { PhoneGesture } from '../phone-ui/phone-gestures' /** iOS host for the shared app registry, shell, compositor and BLE session. */ @@ -60,7 +61,7 @@ export class IosPreviewController { private readonly glance = new GlanceHost({ getDisplay: () => this.glanceDisplay, getProvider: () => ALL_APPS.find(app => app.glanceboard)?.glanceboard ?? null, - canShow: () => this.runtimeNeeded, + canShow: () => this.runtimeNeeded && !this.glassesLocked, // iOS retains the EvenHub session while the shell sleeps. The board's // opaque first frame is ready before we unblank the compositor. ensureSessionActive: async () => { @@ -86,6 +87,11 @@ export class IosPreviewController { private readonly appHosts = new Map() private readonly inProcessApps = new Map() private readonly batteryObservers: any[] = [] + private readonly lockObservers: any[] = [] + private phoneLocked = false + private glassesWorn: boolean | null = null + private glassesLocked = false + private lockEnabled = lockScreenEnabledSetting.get() private session: GlassesSession | null = null private logLines: string[] = [] private logTimer: ReturnType | null = null @@ -112,6 +118,10 @@ export class IosPreviewController { private readonly onError: (message: string) => void, private readonly onConnectionState: (state: SessionState) => void = () => {}) { this.compositor.configureSurface('shell', { x: 0, y: 0, width: 640, height: 480, zOrder: 1, transparency: 'color-key' }) + this.compositor.configureSurface(LOCK_SCREEN_SURFACE_ID, { + x: 0, y: 0, width: G2_LENS_WIDTH, height: G2_LENS_HEIGHT, zOrder: 1000, transparency: 'opaque', + }) + this.compositor.setSurfaceVisible(LOCK_SCREEN_SURFACE_ID, false) shell.configure({ actions: this.actions, voiceInputEnabled: true, @@ -148,6 +158,7 @@ export class IosPreviewController { if (this.active) return this.active = true this.syncRuntime() + this.handlePhoneLockState(!UIApplication.sharedApplication.protectedDataAvailable) this.logBluetooth('Phone foreground') if (this.session) this.onConnectionState({ ...this.session.state }) this.session?.wake() @@ -178,6 +189,7 @@ export class IosPreviewController { this.compositor.setScreenBlanked(!shell.isScreenOn()) this.offSettings?.(); this.offSettings = null for (const observer of this.batteryObservers.splice(0)) NSNotificationCenter.defaultCenter.removeObserver(observer) + for (const observer of this.lockObservers.splice(0)) NSNotificationCenter.defaultCenter.removeObserver(observer) UIDevice.currentDevice.batteryMonitoringEnabled = false if (this.clockTimer !== null) clearInterval(this.clockTimer) if (this.renderTimer !== null) clearTimeout(this.renderTimer) @@ -185,6 +197,16 @@ export class IosPreviewController { return } UIDevice.currentDevice.batteryMonitoringEnabled = true + // Keep these observers alive while BLE owns the runtime, including background. + for (const [name, locked] of [ + [UIApplicationProtectedDataWillBecomeUnavailable, true], + [UIApplicationProtectedDataDidBecomeAvailable, false], + ] as const) { + this.lockObservers.push(NSNotificationCenter.defaultCenter.addObserverForNameObjectQueueUsingBlock( + name, null, NSOperationQueue.mainQueue, () => this.handlePhoneLockState(locked))) + } + this.handlePhoneLockState(!UIApplication.sharedApplication.protectedDataAvailable) + this.syncLockSetting() void nightscoutBridge.start().catch(error => this.fail(error)) for (const name of [UIDeviceBatteryLevelDidChangeNotification, UIDeviceBatteryStateDidChangeNotification]) { this.batteryObservers.push(NSNotificationCenter.defaultCenter.addObserverForNameObjectQueueUsingBlock(name, null, NSOperationQueue.mainQueue, () => this.requestShellRender())) @@ -192,12 +214,53 @@ export class IosPreviewController { const phone = readPhoneBatteryState() this.logBluetooth(`Phone battery ${phone.battery ?? "unknown"}% charging=${phone.charging}`) this.offSettings = onAnySettingChanged(() => { + this.syncLockSetting() this.relayout() shell.foregroundWindow()?.requestRender() this.requestShellRender() }) this.clockTimer = setInterval(() => this.refreshClock(), 60_000) } + private syncLockSetting(): void { + const enabled = lockScreenEnabledSetting.get() + if (enabled === this.lockEnabled) return + this.lockEnabled = enabled + if (!enabled) this.setGlassesLocked(false) + else { + if (this.phoneLocked && this.glassesWorn === false) this.setGlassesLocked(true) + if (this.session?.state.phase === 'connected') + void this.session.enableWearDetectionAndRequestState().catch(error => this.fail(error)) + } + } + private handlePhoneLockState(locked: boolean): void { + this.phoneLocked = locked + if (!locked) this.setGlassesLocked(false) + else if (this.lockEnabled && this.glassesWorn === false) this.setGlassesLocked(true) + } + private handleWearState(wearing: boolean): void { + // Sample false to catch a notification missed during suspension. Do not + // sample true here: WillBecomeUnavailable precedes the property transition. + if (!UIApplication.sharedApplication.protectedDataAvailable) this.handlePhoneLockState(true) + this.glassesWorn = wearing + this.logBluetooth(`Glasses wear state: ${wearing ? 'ON_HEAD' : 'OFF_HEAD'}`) + if (!wearing && this.phoneLocked && this.lockEnabled) this.setGlassesLocked(true) + } + private setGlassesLocked(locked: boolean): void { + if (locked === this.glassesLocked) return + if (locked) { + const image = createLockScreenImage() + this.compositor.submitSurfaceFrame(LOCK_SCREEN_SURFACE_ID, image.to8bppBuffer(), + { x: 0, y: 0, width: image.width, height: image.height }) + } + this.glassesLocked = locked + if (locked) { + this.glance.dismiss() + iosVoiceInput.handleSessionEnded('Glasses locked. Unlock your phone to start voice input again.') + } + this.compositor.setSurfaceVisible(LOCK_SCREEN_SURFACE_ID, locked) + this.logBluetooth(`Glasses ${locked ? 'locked' : 'unlocked'}`) + this.requestShellRender() + } private refreshClock(): void { const minute = Math.floor(Date.now() / 60_000) if (minute !== this.clockMinute) { this.clockMinute = minute; this.requestShellRender() } @@ -240,7 +303,7 @@ export class IosPreviewController { this.session?.setFrame(pixels) if (this.active) { const image = previewPixels(pixels, 640, 480, previewColorSetting.get() === 'green') - this.onFrame(image, this.glance.isVisible() ? 'Glanceboard' + this.onFrame(image, this.glassesLocked ? 'Glasses locked' : this.glance.isVisible() ? 'Glanceboard' : `${shell.foregroundWindow()?.title ?? 'Apps'} · ${shell.getFocus() === 'sidebar' ? 'App switcher' : 'App'}`) } } catch (error) { this.fail(error) } @@ -255,7 +318,7 @@ export class IosPreviewController { gesture(gesture: PhoneGesture, origin: 'watch' | 'ring' | 'mirror', nx = 0, ny = 0): void { this.inputQueue = this.inputQueue.then(async () => { if (!this.active) return - if (gesture === 'tap' && origin === 'mirror' && shell.isScreenOn()) { + if (gesture === 'tap' && origin === 'mirror' && shell.isScreenOn() && !this.glassesLocked) { await this.mirrorTap(nx, ny) } else { let type: string = ({ tap: 'click', 'double-tap': 'double-click' } as Record)[gesture] ?? gesture @@ -270,6 +333,16 @@ export class IosPreviewController { }).catch(error => this.fail(error)) } private async receiveInput(event: InputEvent, headTilt = false): Promise { + if (this.glassesLocked) { + // Preserve the locked display's sleep/wake controls without dispatching + // gestures to apps, shell menus, voice input or the Glanceboard. + if (event.type === 'double-click' && (event.source === 'ring' || event.source === 'watch')) { + if (shell.isScreenOn()) shell.sleep() + else shell.wake('sidebar') + } else if (event.type === 'display-wake' && !shell.isScreenOn()) shell.wake('sidebar') + this.requestShellRender() + return + } if (!shell.isScreenOn()) { const glanceEvent = this.glance.eventForGesture(headTilt ? 'head-tilt' : event.type) if (glanceEvent?.type === 'dismiss') this.glance.dismiss() @@ -409,6 +482,7 @@ export class IosPreviewController { if (error) { this.onError(error); return } if (!this.session) { this.session = new GlassesSession(iosBluetooth(), state => { + if (state.phase !== 'connected' && state.phase !== 'connecting') this.glassesWorn = null if (state.phase !== 'connected') iosVoiceInput.handleSessionEnded() shell.setBatteryLevels({ headset: state.battery, headsetCharging: state.charging }) this.syncRuntime() @@ -421,24 +495,28 @@ export class IosPreviewController { input.kind === 'display-wake' && input.eventType === OsEventTypeList.HEAD_UP_EVENT) this.logBluetooth(`Input ${input.eventType} source ${input.eventSource}`) }).catch(error => this.fail(error)) - }, message => this.logBluetooth(message), () => this.refreshClock(), receiveCompassEvent) + }, message => this.logBluetooth(message), () => { + if (!UIApplication.sharedApplication.protectedDataAvailable) this.handlePhoneLockState(true) + this.refreshClock() + }, receiveCompassEvent, wearing => this.handleWearState(wearing)) bindCompassSession(this.session) } await this.session.start(addresses) } async disconnect(): Promise { await this.session?.stop() } - startVoiceInput(): void { shell.startVoiceInput() } + startVoiceInput(): void { if (!this.glassesLocked) shell.startVoiceInput() } private async prepareVoiceCapture(): Promise { + if (this.glassesLocked) return false if (this.session?.state.phase !== 'connected') { if (this.active) this.onError('Connect the glasses to use their microphone.') return false } const ready = await iosVoiceInput.prepare(this.active) if (!ready && this.active) this.onError(iosVoiceInput.statusText) - return ready && this.session?.state.phase === 'connected' + return ready && !this.glassesLocked && this.session?.state.phase === 'connected' } private async startVoiceCapture(endpointing = false): Promise { - if (!this.session || this.session.state.phase !== 'connected') return + if (this.glassesLocked || !this.session || this.session.state.phase !== 'connected') return await iosVoiceInput.startGlassesCapture(this.session, message => this.logBluetooth(message), endpointing) } private logBluetooth(message: string): void { @@ -458,13 +536,14 @@ export class IosPreviewController { catch (error) { console.warn(`Bluetooth log: ${error}`) } } async typeIntoApp(): Promise { + if (this.glassesLocked) return if (!this.active) { this.logBluetooth('Text input requires opening Faceclaw on the phone'); return } if (this.prompting || !shell.foregroundWindow()?.receiveTextInput) return this.prompting = true try { const result = await Dialogs.prompt({ title: 'Type into ' + shell.foregroundWindow()?.title, message: 'Enter text to send to this app.', okButtonText: 'Send', cancelButtonText: 'Cancel' }) - if (result.result) shell.sendTextToForegroundWindow(result.text) + if (result.result && !this.glassesLocked) shell.sendTextToForegroundWindow(result.text) } catch (error) { this.fail(error) } finally { this.prompting = false } } diff --git a/app/g2/lock-screen.ts b/app/g2/lock-screen.ts new file mode 100644 index 00000000..485504bd --- /dev/null +++ b/app/g2/lock-screen.ts @@ -0,0 +1,24 @@ +import { GrayImage, G2_LENS_WIDTH, G2_LENS_HEIGHT } from "../graphics/image"; +import { getDefaultMediumFont } from "../graphics/ui-fonts"; +import { wrapText } from "../graphics/textwrap"; + +export const LOCK_SCREEN_SURFACE_ID = "lock-screen"; +const LOCK_SCREEN_MESSAGE = "Glasses locked; unlock the phone to unlock the glasses."; + +export function createLockScreenImage(): GrayImage { + const image = new GrayImage(G2_LENS_WIDTH, G2_LENS_HEIGHT, 0); + const font = getDefaultMediumFont(); + const boxWidth = 480; + const boxHeight = 150; + const boxX = Math.round((G2_LENS_WIDTH - boxWidth) / 2); + const boxY = Math.round((G2_LENS_HEIGHT - boxHeight) / 2); + image.drawRoundedRect(boxX, boxY, boxWidth, boxHeight, 150, 12); + const lines = wrapText(font, LOCK_SCREEN_MESSAGE, boxWidth - 64); + const textHeight = lines.length * font.lineHeight; + const firstY = boxY + Math.round((boxHeight - textHeight) / 2); + lines.forEach((line, index) => { + const x = Math.round((G2_LENS_WIDTH - font.measureText(line)) / 2); + image.drawText(font, x, firstY + index * font.lineHeight, line, 230); + }); + return image; +} diff --git a/app/g2/wear-protocol.ts b/app/g2/wear-protocol.ts new file mode 100644 index 00000000..4e06c1ef --- /dev/null +++ b/app/g2/wear-protocol.ts @@ -0,0 +1,15 @@ +import { bytes, concat, integer, readBytes, readInteger, type ProtocolMessage } from './ble-protocol' + +// Matches BleProtocol.buildSetWearDetection/buildFaceclawWakeControl on Android. +export const enableWearDetection = (magic: number): Uint8Array => concat( + integer(1, 1), integer(2, magic), bytes(3, bytes(5, integer(1, 1)))) +export const queryWearState = (): Uint8Array => concat( + integer(1, 1), integer(2, 0), bytes(101, new Uint8Array([70, 67, 1, 7, 0, 0]))) + +export function decodeWearState(message: ProtocolMessage): boolean | null { + if (message.sid !== 0x10 || message.command !== 3) return null + const event = readBytes(message.payload, 5) + if (!event || readInteger(event, 1, -1) !== 1) return null + const state = readInteger(event, 2, -1) + return state === 0 ? false : state === 1 ? true : null +} diff --git a/app/native/voice-control.ios.ts b/app/native/voice-control.ios.ts index 62c9df51..d6333bc3 100644 --- a/app/native/voice-control.ios.ts +++ b/app/native/voice-control.ios.ts @@ -91,9 +91,9 @@ export class IosVoiceControlBridge { this.clearAudioTimer(); this.releaseMicrophone(); this.native?.cancel() this.finishCompletion() } - handleSessionEnded(): void { + handleSessionEnded(message = 'Glasses disconnected. Start voice input again after reconnecting.'): void { if (!this.capturing && !this.finalizing) return - this.stop(); this.setStatus('Glasses disconnected. Start voice input again after reconnecting.'); this.emitEnd() + this.stop(); this.setStatus(message); this.emitEnd() } private clearAudioTimer(): void { if (this.audioTimer !== null) clearTimeout(this.audioTimer); this.audioTimer = null } private releaseMicrophone(): void { diff --git a/app/ui/dashboard-settings.ts b/app/ui/dashboard-settings.ts index 95557747..aed240dc 100644 --- a/app/ui/dashboard-settings.ts +++ b/app/ui/dashboard-settings.ts @@ -341,7 +341,8 @@ export const lockScreenEnabledSetting = new ConfigSettingBoolean({ storageKey: "display.lockScreenEnabled", defaultValue: true, description: - "Lock the glasses after they are taken off while the phone is locked. Unlocking the phone unlocks the glasses.", + "Lock the glasses after they are taken off while the phone is locked. Unlocking the phone unlocks the glasses." + + (global.isIOS ? " On iPhone, this requires a device passcode and follows iOS data-protection notifications, which may be delayed after the screen locks." : ""), }); // Phone display: the phone app's mirror of the glasses screen and the diff --git a/app/ui/dashboard/settings-menus.ts b/app/ui/dashboard/settings-menus.ts index c06aef99..938ba9df 100644 --- a/app/ui/dashboard/settings-menus.ts +++ b/app/ui/dashboard/settings-menus.ts @@ -254,7 +254,7 @@ function settingsSections(): SettingsSection[] { description: `${section.label} integration has not been ported to iOS.`, }] }; if (section.label === "Display") return { ...section, items: section.items.filter(item => - ![brightnessSetting.label, screenTimeoutSetting.label, lockScreenEnabledSetting.label].includes(item.label)) }; + ![brightnessSetting.label, screenTimeoutSetting.label].includes(item.label)) }; if (section.label === "Phone display") return { ...section, items: section.items.filter(item => item.label !== mirrorTouchSetting.label) }; return section; }); diff --git a/tests/ios-app-host.test.cjs b/tests/ios-app-host.test.cjs index f67fcdcc..657e7596 100644 --- a/tests/ios-app-host.test.cjs +++ b/tests/ios-app-host.test.cjs @@ -80,6 +80,7 @@ for (const isIOS of [true, false]) { uiFontPickerMenuItem: () => ({ label: 'Font' }), terminalFontPickerMenuItem: () => ({ label: 'Terminal font' }) }; } }); const sections = menus.createSettingsPanelLayer().sections; + assert.ok(sections.find(section => section.label === 'Display').items.some(item => item.label === settings.lockScreenEnabledSetting.label)); const assistant = sections.find(section => section.label === 'Assistant'); assert.equal(assistant.items.some(item => item.disabled === true), false); const ctx = { stack: { pop() {} }, actions: { requestRender() {} } }; @@ -186,7 +187,7 @@ test('background glasses input still composites frames; phone resume preserves t setFrame(pixels) { if (this.state.phase === 'connected') frames.push(pixels); } wake() {} } - const settings = { onAnySettingChanged: () => () => {}, previewColorSetting: { get: () => 'white' } }; + const settings = { lockScreenEnabledSetting: { get: () => true }, onAnySettingChanged: () => () => {}, previewColorSetting: { get: () => 'white' } }; const modules = { '../assistant/system-tools': { registerSystemTools() {} }, '../assistant/window-tools': { registerWindowTools() {} }, @@ -219,6 +220,7 @@ test('background glasses input still composites frames; phone resume preserves t setTimeout: fn => { tasks.set(++nextTask, fn); return nextTask; }, clearTimeout: id => tasks.delete(id), setInterval: () => ++nextTask, clearInterval() {}, UIDevice: { currentDevice: {} }, UIApplication: { sharedApplication: { protectedDataAvailable: true } }, + UIApplicationProtectedDataWillBecomeUnavailable: 'lock', UIApplicationProtectedDataDidBecomeAvailable: 'unlock', UIDeviceBatteryLevelDidChangeNotification: 'level', UIDeviceBatteryStateDidChangeNotification: 'state', NSNotificationCenter: { defaultCenter: { addObserverForNameObjectQueueUsingBlock() {}, removeObserver() {} } }, NSOperationQueue: { mainQueue: {} }, diff --git a/tests/ios-ble.test.cjs b/tests/ios-ble.test.cjs index 5d28078a..6ef67cb3 100644 --- a/tests/ios-ble.test.cjs +++ b/tests/ios-ble.test.cjs @@ -159,10 +159,10 @@ async function until(predicate) { assert.fail('Timed out waiting for test state'); } function harness(t, transport = new FakeTransport()) { - const states = [], input = [], compass = []; - const session = new GlassesSession(transport, state => states.push(state), event => input.push(event), undefined, undefined, event => compass.push(event)); + const states = [], input = [], compass = [], wear = []; + const session = new GlassesSession(transport, state => states.push(state), event => input.push(event), undefined, undefined, event => compass.push(event), wearing => wear.push(wearing)); t.after(async () => { transport.hold = false; await session.stop(); }); - return { transport, session, states, input, compass }; + return { transport, session, states, input, compass, wear }; } test('session authenticates both arms, checks firmware and sends acknowledged display data to L', async t => { const h = harness(t); await h.session.start({ ...addresses, ring: 'AA:BB:CC:DD:EE:03' }); @@ -511,3 +511,42 @@ test('compass notifications only come from the right arm and preserve diagnostic magneticAccuracy: 3, magneticAnomalies: 2, orientationSource: 3, flags: 140, sampleTimeMs: 0xfedcba98, } }, { command: 16, headingDegrees: -1 }, { command: 17, headingDegrees: -1 }]); }); + + +test('wear detection matches Android wire format and queries both arms on every connection', async t => { + const wear = require('../.test-build/app/g2/wear-protocol.js'); + assert.equal(hex(wear.enableWearDetection(42)), '0801102a1a042a020801'); + assert.equal(hex(wear.queryWearState()), '08011000aa0606464301070000'); + const h = harness(t); await h.session.start(addresses); + const queries = () => h.transport.sent.filter(({ message }) => hex(message.payload) === hex(wear.queryWearState())); + assert.deepEqual(queries().map(q => q.id).sort(), ['L', 'R']); + const enable = h.transport.sent.find(({ message }) => { + const body = p.readBytes(message.payload, 3); + return message.sid === p.SID.settings && message.command === 1 && body && p.readBytes(body, 5); + }); + assert.equal(enable.id, 'R'); assert.equal(enable.message.flag, 0x20); + await h.session.stop(); await h.session.start(addresses); + assert.equal(queries().length, 4); +}); + +test('wear notifications validate the event and peer and work during initial connection', async t => { + const h = harness(t); + const payload = state => p.concat(p.integer(1, 3), p.bytes(5, p.concat(p.integer(1, 1), p.integer(2, state)))); + const emit = (id, data, sid = 0x10) => h.transport.emit({ kind: 'notification', identifier: id, + characteristic: p.G2_NOTIFY, data: hex(p.concat(...p.frameMessage(data, sid, 1, 12))) }); + const originalWrite = h.transport.write.bind(h.transport); + h.transport.write = async (...args) => { + await originalWrite(...args); + if (h.transport.sent.at(-1)?.message.magic === 0) emit(args[0], payload(0)); + }; + await h.session.start(addresses); + assert.ok(h.wear.length >= 2); assert.ok(h.wear.every(value => value === false)); + h.wear.length = 0; + emit('stranger', payload(0)); emit('ring', payload(0)); emit('R', payload(2)); + emit('R', payload(0), p.SID.hub); emit('R', p.integer(1, 3)); + assert.deepEqual(h.wear, []); + emit('L', payload(0)); emit('R', payload(1)); + assert.deepEqual(h.wear, [false, true]); + await h.session.stop(); emit('R', payload(0)); + assert.deepEqual(h.wear, [false, true]); +}); diff --git a/tests/ios-glanceboard.test.cjs b/tests/ios-glanceboard.test.cjs index 0eb9e85e..75a16bc9 100644 --- a/tests/ios-glanceboard.test.cjs +++ b/tests/ios-glanceboard.test.cjs @@ -23,10 +23,12 @@ const planes = load('app/graphics/plane.ts', { './image': images }); const timings = load('app/native/frame-timings.ts', {}); function fixture() { + const observers = new Map(), phoneState = { protectedDataAvailable: true }; + let settingsChanged; let now = 1000, nextTask = 0, screenOn = true, shellOptions, session; const tasks = new Map(), sent = [], previews = [], received = [], errors = []; const boardStats = { starts: 0, stops: 0, paints: 0 }; - const settings = { enabled: true, tap: true, hold: true, tilt: true, duration: 3000 }; + const settings = { lock: true, enabled: true, tap: true, hold: true, tilt: true, duration: 3000 }; const clock = { Date: class extends Date { static now() { return now; } }, setTimeout: (fn, ms) => { tasks.set(++nextTask, { fn, at: now + ms }); return nextTask; }, clearTimeout: id => tasks.delete(id), setInterval: () => ++nextTask, clearInterval() {} }; @@ -54,7 +56,8 @@ function fixture() { }; class Session { state = { phase: 'disconnected' }; - constructor(_transport, onState, onInput) { session = this; this.onState = onState; this.onInput = onInput; } + constructor(_transport, onState, onInput, _log, _activity, _compass, onWear) { session = this; this.onState = onState; this.onInput = onInput; this.onWear = onWear; } + async enableWearDetectionAndRequestState() {} async start() { this.state = { phase: 'connected' }; this.onState(this.state); } async stop() { this.state = { phase: 'disconnected' }; this.onState(this.state); } setFrame(pixels) { if (this.state.phase === 'connected') sent.push(pixels); } @@ -81,13 +84,14 @@ function fixture() { './glasses-session': { GlassesSession: Session }, '../native/nightscout-bridge': { nightscoutBridge: { async start() {}, async stop() {} } }, './glance-host': { GlanceHost }, './events': events, + './lock-screen': { LOCK_SCREEN_SURFACE_ID: 'lock-screen', createLockScreenImage: () => new images.GrayImage(640, 480, 123) }, './device-addresses': { loadDeviceAddresses: () => ({}) }, './ios-peripheral-identity': { deviceAddressError: () => null }, '../apps/launcher': { launcherEntries: () => [] }, '../apps/evenhub/installed-apps': {}, '../apps/evenhub/manager': {}, '../apps/evenhub/updates': {}, '../apps/evenhub': {}, '../apps/launcher/launcher-app': { createLauncherWindow: () => window, LAUNCHER_SURFACE_ID: 'launcher' }, '../apps/all-apps': { ALL_APPS: [{ appId: 'glanceboard', glanceboard: provider }] }, '../ui/shell/worker-window': {}, '../ui/shell/in-process-window': {}, - '../ui/dashboard-settings': { onAnySettingChanged: () => () => {}, previewColorSetting: { get: () => 'white' } }, + '../ui/dashboard-settings': { lockScreenEnabledSetting: { get: () => settings.lock }, onAnySettingChanged: fn => { settingsChanged = fn; return () => {}; }, previewColorSetting: { get: () => 'white' } }, '../native/phone-battery': { readPhoneBatteryState: () => ({ battery: 80, charging: false }) }, '../apps/ios-availability': { iosAppUnavailableReason: () => null }, '../graphics/surface-compositor': { SurfaceCompositor }, '../graphics/plane': planes, '../graphics/image': images, @@ -103,9 +107,10 @@ function fixture() { }; const { IosPreviewController } = load('app/g2/ios-preview-controller.ts', modules, { ...clock, console: { log() {}, warn() {}, error: text => errors.push(text) }, - UIDevice: { currentDevice: {} }, UIApplication: { sharedApplication: { protectedDataAvailable: true } }, + UIDevice: { currentDevice: {} }, UIApplication: { sharedApplication: phoneState }, + UIApplicationProtectedDataWillBecomeUnavailable: 'lock', UIApplicationProtectedDataDidBecomeAvailable: 'unlock', UIDeviceBatteryLevelDidChangeNotification: 'level', UIDeviceBatteryStateDidChangeNotification: 'state', - NSNotificationCenter: { defaultCenter: { addObserverForNameObjectQueueUsingBlock() {}, removeObserver() {} } }, + NSNotificationCenter: { defaultCenter: { addObserverForNameObjectQueueUsingBlock(name, _object, _queue, fn) { observers.set(name, fn); return name; }, removeObserver(name) { observers.delete(name); } } }, NSOperationQueue: { mainQueue: {} }, }); const controller = new IosPreviewController((pixels, title) => previews.push({ pixels, title }), message => errors.push(message)); @@ -124,7 +129,7 @@ function fixture() { await render(); } async function phone(type, origin = 'ring') { controller.gesture(type, origin); await render(); } - return { controller, shell, settings, sent, previews, received, boardStats, hardware, phone, advance, render }; + return { controller, shell, settings, phoneState, observers, wear: wearing => session.onWear(wearing), settingsChanged: () => settingsChanged(), sent, previews, received, boardStats, hardware, phone, advance, render }; } const assertBlank = pixels => assert.ok(pixels.every(p => p === 0)); const assertBoard = pixels => { @@ -197,3 +202,70 @@ test('phone preview gestures use Glanceboard; losing runtime cleans up holds and f.controller.resume(); await f.render(); assertBlank(f.previews.at(-1).pixels); assert.equal(f.boardStats.starts, f.boardStats.stops); }); + + +test('iOS lock hides apps and Glanceboard, blocks input, and stays locked when put back on', async () => { + const f = fixture(); await f.controller.connect(); f.shell.sleep(); await f.hardware(0); + f.controller.pause(); + // The notification precedes the property change: do not immediately undo it. + f.observers.get('lock')(); f.wear(false); await f.render(); + assert.equal(f.controller.glassesLocked, true); + assert.equal(f.controller.glance.isVisible(), false); + await f.hardware(3); // wake the lock screen + assert.ok(f.sent.at(-1).every(p => p === 123)); + for (const type of [0, 1, 2, 9, 11]) await f.hardware(type); + f.wear(true); await f.render(); + assert.equal(f.received.length, 0); + assert.ok(f.sent.at(-1).every(p => p === 123)); + await f.hardware(3); assertBlank(f.sent.at(-1)); + await f.hardware(12, 1); assert.ok(f.sent.at(-1).every(p => p === 123)); + f.observers.get('unlock')(); await f.render(); + assert.equal(f.controller.glassesLocked, false); + assert.equal(f.sent.at(-1)[0], 75); + await f.hardware(0); assert.equal(f.received.length, 1); +}); + +test('iOS removal before phone lock, setting changes, and observer lifetime', async () => { + const f = fixture(); await f.controller.connect(); f.wear(false); await f.render(); + assert.equal(f.controller.glassesLocked, false); + f.observers.get('lock')(); await f.render(); + assert.equal(f.controller.glassesLocked, true); + f.settings.lock = false; f.settingsChanged(); await f.render(); + assert.equal(f.controller.glassesLocked, false); + f.settings.lock = true; f.settingsChanged(); await f.render(); + assert.equal(f.controller.glassesLocked, true); + f.controller.pause(); assert.ok(f.observers.has('unlock')); + await f.controller.disconnect(); assert.equal(f.observers.has('unlock'), false); + f.controller.resume(); await f.render(); + assert.equal(f.controller.glassesLocked, false); + assert.equal(f.observers.size, 4); +}); + +test('iOS wear notifications catch protected-data changes missed while suspended', async () => { + const f = fixture(); await f.controller.connect(); f.controller.pause(); + f.phoneState.protectedDataAvailable = false; f.wear(false); await f.render(); + assert.equal(f.controller.glassesLocked, true); + f.controller.resume(); await f.render(); + assert.equal(f.controller.glassesLocked, true); + f.controller.pause(); f.phoneState.protectedDataAvailable = true; + f.controller.resume(); await f.render(); + assert.equal(f.controller.glassesLocked, false); +}); + + +test('iOS locked phone controls cannot dispatch mirror, voice, or keyboard input', async () => { + const f = fixture(); await f.controller.connect(); f.wear(false); + f.observers.get('lock')(); await f.render(); + await f.phone('tap', 'mirror'); await f.phone('long-press', 'watch'); + f.controller.startVoiceInput(); + assert.equal(await f.controller.prepareVoiceCapture(), false); + await f.controller.startVoiceCapture(); await f.controller.typeIntoApp(); + assert.equal(f.received.length, 0); + assert.equal(f.controller.glassesLocked, true); + // Locked state also survives transport recovery until a phone unlock. + f.controller.session.onState({ phase: 'retrying' }); + f.controller.session.onState({ phase: 'connecting' }); + f.controller.session.onState({ phase: 'connected' }); + await f.render(); + assert.ok(f.sent.at(-1).every(p => p === 123)); +}); diff --git a/tests/tsconfig.json b/tests/tsconfig.json index 13a97140..037e5c2d 100644 --- a/tests/tsconfig.json +++ b/tests/tsconfig.json @@ -18,6 +18,7 @@ "../app/g2/ios-peripheral-identity.ts", "../app/g2/glasses-session.ts", "../app/graphics/surface-compositor.ts", + "../app/graphics/image.ts", "../app/phone-ui/phone-gestures.ts", "../app/g2/firmware-compat.ts", "../app/g2/glasses-hardware-identity.ts", From 68b459751e5b9a7818b4b60bc7251633a3c1b431 Mon Sep 17 00:00:00 2001 From: James Babcock Date: Sat, 19 Sep 2026 03:06:56 -0700 Subject: [PATCH 31/99] iOS QR scanning for opening EvenHub apps --- App_Resources/iOS/Info.plist | 2 + App_Resources/iOS/src/FaceclawQrScanner.h | 8 + App_Resources/iOS/src/FaceclawQrScanner.m | 186 ++++++++++++++++++++++ App_Resources/iOS/src/module.modulemap | 1 + app/apps/developer/developer-app.ts | 2 - app/apps/developer/load-app.ts | 29 ++-- app/native/qr-scan.ios.ts | 24 +++ app/native/qr-scan.ts | 4 + 8 files changed, 242 insertions(+), 14 deletions(-) create mode 100644 App_Resources/iOS/src/FaceclawQrScanner.h create mode 100644 App_Resources/iOS/src/FaceclawQrScanner.m create mode 100644 app/native/qr-scan.ios.ts diff --git a/App_Resources/iOS/Info.plist b/App_Resources/iOS/Info.plist index de7e7ba7..29862f9f 100644 --- a/App_Resources/iOS/Info.plist +++ b/App_Resources/iOS/Info.plist @@ -22,6 +22,8 @@ Faceclaw uses Bluetooth to connect to your glasses and ring, display your apps, and receive gestures. NSSpeechRecognitionUsageDescription Faceclaw turns audio from your glasses microphone into text for the app you choose. Dictation uses on-device recognition. + NSCameraUsageDescription + Faceclaw uses the camera to scan QR codes for app URLs you open in Developer. NSLocationWhenInUseUsageDescription Faceclaw uses your location for local weather, turn-by-turn navigation, and true north on the glasses compass. NSLocationTemporaryUsageDescriptionDictionary diff --git a/App_Resources/iOS/src/FaceclawQrScanner.h b/App_Resources/iOS/src/FaceclawQrScanner.h new file mode 100644 index 00000000..fd6f0c6a --- /dev/null +++ b/App_Resources/iOS/src/FaceclawQrScanner.h @@ -0,0 +1,8 @@ +#import + +/** A single foreground QR scan. Completion runs once, after the camera closes. */ +@interface FaceclawQrScanner : NSObject ++ (BOOL)isAvailable; +- (void)startWithCompletion:(void (^)(NSString *text, NSString *error))completion; +- (void)cancel; +@end diff --git a/App_Resources/iOS/src/FaceclawQrScanner.m b/App_Resources/iOS/src/FaceclawQrScanner.m new file mode 100644 index 00000000..5762f6af --- /dev/null +++ b/App_Resources/iOS/src/FaceclawQrScanner.m @@ -0,0 +1,186 @@ +#import "FaceclawQrScanner.h" +#import +#import + +@interface FaceclawQrScreen : UIViewController +@property(nonatomic) AVCaptureVideoPreviewLayer *preview; +@property(nonatomic, copy) void (^cancelHandler)(void); +@end + +@implementation FaceclawQrScreen +- (void)viewDidLoad { + [super viewDidLoad]; + self.view.backgroundColor = UIColor.blackColor; + self.title = @"Scan app QR code"; + self.navigationItem.leftBarButtonItem = [[UIBarButtonItem alloc] + initWithBarButtonSystemItem:UIBarButtonSystemItemCancel target:self action:@selector(cancelScan)]; + UILabel *instructions = [UILabel new]; + instructions.text = @"Point the camera at the app's QR code."; + instructions.textColor = UIColor.whiteColor; + instructions.backgroundColor = [UIColor.blackColor colorWithAlphaComponent:0.7]; + instructions.textAlignment = NSTextAlignmentCenter; + instructions.numberOfLines = 0; + instructions.font = [UIFont preferredFontForTextStyle:UIFontTextStyleBody]; + instructions.adjustsFontForContentSizeCategory = YES; + instructions.translatesAutoresizingMaskIntoConstraints = NO; + [self.view addSubview:instructions]; + [NSLayoutConstraint activateConstraints:@[ + [instructions.leadingAnchor constraintEqualToAnchor:self.view.safeAreaLayoutGuide.leadingAnchor constant:20], + [instructions.trailingAnchor constraintEqualToAnchor:self.view.safeAreaLayoutGuide.trailingAnchor constant:-20], + [instructions.bottomAnchor constraintEqualToAnchor:self.view.safeAreaLayoutGuide.bottomAnchor constant:-24], + ]]; +} +- (void)cancelScan { if (_cancelHandler) _cancelHandler(); } +- (void)viewDidLayoutSubviews { + [super viewDidLayoutSubviews]; + _preview.frame = self.view.bounds; + UIInterfaceOrientation orientation = self.view.window.windowScene.interfaceOrientation; + if (_preview.connection.isVideoOrientationSupported && orientation != UIInterfaceOrientationUnknown) + _preview.connection.videoOrientation = (AVCaptureVideoOrientation)orientation; +} +@end + +@interface FaceclawQrScanner () +@property(nonatomic) AVCaptureSession *session; +@property(nonatomic) AVCaptureMetadataOutput *output; +@property(nonatomic) dispatch_queue_t cameraQueue; +@property(nonatomic) FaceclawQrScreen *screen; +@property(nonatomic) UINavigationController *navigation; +@property(nonatomic, copy) void (^completion)(NSString *, NSString *); +@property(atomic) BOOL finished; +@property(nonatomic) BOOL presenting; +@property(nonatomic) BOOL stopped; +@property(nonatomic) BOOL closing; +@property(nonatomic) NSString *resultText; +@property(nonatomic) NSString *resultError; +@end + +@implementation FaceclawQrScanner ++ (BOOL)isAvailable { return [AVCaptureDevice defaultDeviceWithMediaType:AVMediaTypeVideo] != nil; } +- (void)startWithCompletion:(void (^)(NSString *, NSString *))completion { + NSAssert(NSThread.isMainThread, @"Start QR scanner on the main thread"); + if (_completion || _finished) { completion(nil, @"This QR scanner has already been used."); return; } + _completion = [completion copy]; + _cameraQueue = dispatch_queue_create("com.faceclaw.qr-camera", DISPATCH_QUEUE_SERIAL); + if (UIApplication.sharedApplication.applicationState != UIApplicationStateActive) { + [self finish:nil error:@"Open Faceclaw on your iPhone to scan a QR code."]; return; + } + if (![FaceclawQrScanner isAvailable]) { + [self finish:nil error:@"No camera is available on this device."]; return; + } + [NSNotificationCenter.defaultCenter addObserver:self selector:@selector(backgrounded:) + name:UIApplicationDidEnterBackgroundNotification object:nil]; + AVAuthorizationStatus status = [AVCaptureDevice authorizationStatusForMediaType:AVMediaTypeVideo]; + if (status == AVAuthorizationStatusNotDetermined) { + [AVCaptureDevice requestAccessForMediaType:AVMediaTypeVideo completionHandler:^(BOOL granted) { + dispatch_async(dispatch_get_main_queue(), ^{ + if (self.finished) return; + if (granted) [self presentScanner]; + else [self finish:nil error:@"Camera access denied. Allow Camera for Faceclaw in iPhone Settings, then scan again."]; + }); + }]; + } else if (status == AVAuthorizationStatusAuthorized) [self presentScanner]; + else [self finish:nil error:@"Camera access is unavailable. Check Camera permission for Faceclaw in iPhone Settings."]; +} +- (void)presentScanner { + if (_finished) return; + UIViewController *presenter = nil; + for (UIScene *scene in UIApplication.sharedApplication.connectedScenes) { + if (![scene isKindOfClass:UIWindowScene.class] || scene.activationState != UISceneActivationStateForegroundActive) continue; + for (UIWindow *window in ((UIWindowScene *)scene).windows) + if (window.isKeyWindow) presenter = window.rootViewController; + } + // NativeScript also supports the legacy, non-scene app lifecycle. + if (!presenter) presenter = UIApplication.sharedApplication.keyWindow.rootViewController; + while (presenter.presentedViewController) presenter = presenter.presentedViewController; + if (!presenter.view.window || presenter.isBeingDismissed || presenter.isBeingPresented || [presenter isKindOfClass:UIAlertController.class]) { + [self finish:nil error:@"Close the phone dialog and open Faceclaw to scan again."]; return; + } + _screen = [FaceclawQrScreen new]; + __weak FaceclawQrScanner *weakSelf = self; + _screen.cancelHandler = ^{ [weakSelf cancel]; }; + _navigation = [[UINavigationController alloc] initWithRootViewController:_screen]; + _navigation.modalPresentationStyle = UIModalPresentationFullScreen; + _navigation.overrideUserInterfaceStyle = UIUserInterfaceStyleDark; + _presenting = YES; + [presenter presentViewController:_navigation animated:YES completion:^{ + self.presenting = NO; + if (self.finished) [self closeScanner]; + else [self configureCamera]; + }]; +} +- (void)configureCamera { + _session = [AVCaptureSession new]; + _screen.preview = [AVCaptureVideoPreviewLayer layerWithSession:_session]; + _screen.preview.videoGravity = AVLayerVideoGravityResizeAspectFill; + [_screen.view.layer insertSublayer:_screen.preview atIndex:0]; + [_screen.view setNeedsLayout]; + [NSNotificationCenter.defaultCenter addObserver:self selector:@selector(cameraFailed:) + name:AVCaptureSessionRuntimeErrorNotification object:_session]; + [NSNotificationCenter.defaultCenter addObserver:self selector:@selector(cameraInterrupted:) + name:AVCaptureSessionWasInterruptedNotification object:_session]; + dispatch_async(_cameraQueue, ^{ + if (self.finished) return; + NSError *error = nil; + AVCaptureDevice *camera = [AVCaptureDevice defaultDeviceWithMediaType:AVMediaTypeVideo]; + AVCaptureDeviceInput *input = camera ? [AVCaptureDeviceInput deviceInputWithDevice:camera error:&error] : nil; + AVCaptureMetadataOutput *output = [AVCaptureMetadataOutput new]; + [self.session beginConfiguration]; + if (input && [self.session canAddInput:input]) [self.session addInput:input]; + if (self.session.inputs.count && [self.session canAddOutput:output]) [self.session addOutput:output]; + BOOL ready = [output.availableMetadataObjectTypes containsObject:AVMetadataObjectTypeQRCode]; + if (ready) { + self.output = output; + [output setMetadataObjectsDelegate:self queue:dispatch_get_main_queue()]; + output.metadataObjectTypes = @[AVMetadataObjectTypeQRCode]; + } + [self.session commitConfiguration]; + if (!ready) { + dispatch_async(dispatch_get_main_queue(), ^{ [self finish:nil error:error.localizedDescription ?: @"Could not start the QR camera. Try scanning again."]; }); + return; + } + dispatch_async(dispatch_get_main_queue(), ^{ [self.screen.view setNeedsLayout]; }); + if (!self.finished) [self.session startRunning]; + }); +} +- (void)metadataOutput:(AVCaptureMetadataOutput *)output didOutputMetadataObjects:(NSArray<__kindof AVMetadataObject *> *)objects fromConnection:(AVCaptureConnection *)connection { + for (AVMetadataObject *object in objects) { + if (![object.type isEqual:AVMetadataObjectTypeQRCode] || ![object isKindOfClass:AVMetadataMachineReadableCodeObject.class]) continue; + NSString *text = ((AVMetadataMachineReadableCodeObject *)object).stringValue; + if (text.length) { [self finish:text error:nil]; return; } + } +} +- (void)cameraFailed:(NSNotification *)notification { + dispatch_async(dispatch_get_main_queue(), ^{ [self finish:nil error:@"The camera stopped. Try scanning again."]; }); +} +- (void)cameraInterrupted:(NSNotification *)notification { + dispatch_async(dispatch_get_main_queue(), ^{ [self finish:nil error:@"Camera interrupted. Return to Faceclaw and scan again."]; }); +} +- (void)backgrounded:(NSNotification *)notification { [self cancel]; } +- (void)cancel { [self finish:nil error:nil]; } +- (void)finish:(NSString *)text error:(NSString *)error { + if (_finished) return; + self.finished = YES; + _resultText = text; _resultError = error; + [NSNotificationCenter.defaultCenter removeObserver:self]; + // Serialize teardown after any pending setup/start. Never block the UI. + dispatch_async(_cameraQueue, ^{ + [self.output setMetadataObjectsDelegate:nil queue:NULL]; + [self.session stopRunning]; + dispatch_async(dispatch_get_main_queue(), ^{ self.stopped = YES; [self closeScanner]; }); + }); +} +- (void)closeScanner { + if (!_stopped || _presenting || _closing) return; + _closing = YES; + void (^done)(void) = ^{ + void (^completion)(NSString *, NSString *) = self.completion; + self.completion = nil; + self.screen.preview.session = nil; + self.screen = nil; self.navigation = nil; self.session = nil; self.output = nil; + if (completion) completion(self.resultText, self.resultError); + }; + if (_navigation.presentingViewController) [_navigation dismissViewControllerAnimated:YES completion:done]; + else done(); +} +@end diff --git a/App_Resources/iOS/src/module.modulemap b/App_Resources/iOS/src/module.modulemap index 7c750302..30f457d4 100644 --- a/App_Resources/iOS/src/module.modulemap +++ b/App_Resources/iOS/src/module.modulemap @@ -10,5 +10,6 @@ module FaceclawGraphics { header "FaceclawConfigPort.h" header "FaceclawEvenHubWebView.h" header "FaceclawCrypto.h" + header "FaceclawQrScanner.h" export * } diff --git a/app/apps/developer/developer-app.ts b/app/apps/developer/developer-app.ts index 1d68b04d..2e58a42b 100644 --- a/app/apps/developer/developer-app.ts +++ b/app/apps/developer/developer-app.ts @@ -116,8 +116,6 @@ export function createDeveloperAppWindow(appContext: AppContext, options: InProc }, { label: "Load app from QR code", - disabled: global.isIOS, - description: global.isIOS ? "Not available on iOS yet." : undefined, onSelect: (ctx) => { const layer = new LoadAppFromQrLayer(appContext); ctx.stack.push(layer); diff --git a/app/apps/developer/load-app.ts b/app/apps/developer/load-app.ts index f8ac5c2f..ba6c9555 100644 --- a/app/apps/developer/load-app.ts +++ b/app/apps/developer/load-app.ts @@ -7,7 +7,7 @@ import { GESTURE_CLICK, GESTURE_DOUBLE_CLICK, type InputEvent } from "../../ui/g import { Layer, type LayerContext } from "../../ui/layers"; import { lineStep } from "../../ui/metrics"; import { developerAppUrlSetting } from "../../ui/dashboard-settings"; -import { isQrScannerAvailable, scanQrCode } from "../../native/qr-scan"; +import { cancelQrScan, isQrScannerAvailable, scanQrCode } from "../../native/qr-scan"; const MARGIN = 20; @@ -114,20 +114,23 @@ export class LoadAppFromUrlLayer implements Layer { } /** - * "Load app from QR code": hand off to an installed scanner app, then launch + * "Load app from QR code": open the phone's scanner, then launch * whatever URL it decodes. The scanned URL is kept in developerAppUrlSetting so * the URL page can reload it later without rescanning. */ export class LoadAppFromQrLayer implements Layer { private status = "Starting scanner..."; private busy = false; + private removed = false; constructor(private readonly ctx: AppContext) {} /** Launches the scanner; call right after pushing the layer. */ open(ctx: LayerContext): void { + if (this.busy || this.removed) return; if (!isQrScannerAvailable()) { - this.status = "No QR scanner on this phone (needs Play Services or a scanner app)."; + this.status = global.isIOS ? "No camera available. Scan using a physical iPhone." + : "No QR scanner on this phone (needs Play Services or a scanner app)."; ctx.actions.requestRender(); return; } @@ -135,6 +138,11 @@ export class LoadAppFromQrLayer implements Layer { void this.scan(ctx); } + onRemoved(): void { + this.removed = true; + if (this.busy) cancelQrScan(); + } + paint(ctx: LayerContext): GrayImage { const font = getDefaultSmallFont(); const { width, height } = ctx.stack.getBaseSize(); @@ -156,12 +164,7 @@ export class LoadAppFromQrLayer implements Layer { handleInput(event: InputEvent, ctx: LayerContext): void { switch (event.type) { case "click": - if (!this.busy && isQrScannerAvailable()) { - this.busy = true; - this.status = "Starting scanner..."; - ctx.actions.requestRender(); - void this.scan(ctx); - } + this.open(ctx); return; case "double-click": ctx.stack.pop(); @@ -176,6 +179,7 @@ export class LoadAppFromQrLayer implements Layer { this.status = "Point the phone camera at the QR code."; ctx.actions.requestRender(); const scanned = await scanQrCode(); + if (this.removed) return; if (scanned === null) { this.status = "Scan cancelled."; return; @@ -184,17 +188,18 @@ export class LoadAppFromQrLayer implements Layer { this.status = `Not a URL: ${scanned}`; return; } - developerAppUrlSetting.set(scanned); + developerAppUrlSetting.set(scanned.trim()); this.status = `Loading ${scanned}`; ctx.actions.requestRender(); await openEvenHubUrl(this.ctx, scanned); - ctx.stack.pop(); + if (!this.removed) ctx.stack.pop(); } catch (error) { + if (this.removed) return; this.status = cleanError(error); this.ctx.appendLog(`evenhub qr launch failed: ${this.status}`); } finally { this.busy = false; - ctx.actions.requestRender(); + if (!this.removed) ctx.actions.requestRender(); } } } diff --git a/app/native/qr-scan.ios.ts b/app/native/qr-scan.ios.ts new file mode 100644 index 00000000..bc74376a --- /dev/null +++ b/app/native/qr-scan.ios.ts @@ -0,0 +1,24 @@ +declare const FaceclawQrScanner: any + +let activeScanner: any = null + +export function isQrScannerAvailable(): boolean { return FaceclawQrScanner.isAvailable() } + +export function scanQrCode(): Promise { + if (activeScanner) return Promise.reject(new Error('A QR scan is already open.')) + return new Promise((resolve, reject) => { + const scanner = FaceclawQrScanner.new() + activeScanner = scanner + let settled = false + const finish = (text: string | null, error: string | null) => { + if (settled) return + settled = true + if (activeScanner === scanner) activeScanner = null + error ? reject(new Error(String(error))) : resolve(text == null ? null : String(text)) + } + try { scanner.startWithCompletion(finish) } + catch (error) { finish(null, String(error)) } + }) +} + +export function cancelQrScan(): void { activeScanner?.cancel() } diff --git a/app/native/qr-scan.ts b/app/native/qr-scan.ts index c91c7000..d415098f 100644 --- a/app/native/qr-scan.ts +++ b/app/native/qr-scan.ts @@ -22,6 +22,10 @@ const SCAN_ACTION = "com.google.zxing.client.android.SCAN"; // Arbitrary, only has to be distinct from other startActivityForResult callers. const SCAN_REQUEST_CODE = 0x51d0; +// Android's scanner is owned by Play Services or another app. The load layer +// ignores its late result if the user leaves; iOS also closes its own camera. +export function cancelQrScan(): void {} + function currentActivity(): any { return Application.android?.foregroundActivity ?? Application.android?.startActivity ?? null; } From 64bf600ef99e6aa28c0073e8284f7e3155461d95 Mon Sep 17 00:00:00 2001 From: James Babcock Date: Sat, 19 Sep 2026 09:19:26 -0700 Subject: [PATCH 32/99] Porting onboarding/flashing flow io iOS --- App_Resources/iOS/src/FaceclawCrypto.h | 1 + App_Resources/iOS/src/FaceclawCrypto.m | 7 + app/app.ios.css | 153 +++++++++++++++- app/bootstrap.ios.ts | 12 +- app/g2/firmware-builder.ts | 10 +- app/g2/firmware-ota.ts | 91 ++++++++++ app/g2/firmware-types.ts | 13 ++ app/g2/flash-prompt-protocol.ts | 18 ++ app/g2/glasses-session.ts | 2 +- app/g2/stock-connection.ts | 152 ++++++++++++++++ app/native/ble-permissions.ios.ts | 2 + app/native/ble-permissions.ts | 1 + app/native/device-discovery-common.ts | 52 ++++++ app/native/device-discovery.ios.ts | 52 ++++++ app/native/device-discovery.ts | 49 +----- app/native/device-info-probe.ios.ts | 68 ++++++++ app/native/firmware-files.ios.ts | 11 ++ app/native/firmware-files.ts | 3 + app/native/firmware-flasher.ios.ts | 83 +++++++++ app/native/firmware-flasher.ts | 14 +- app/native/flash-prompt-communicator.ios.ts | 88 ++++++++++ app/phone-ui/config-page-shared.ts | 13 ++ app/phone-ui/config-page.ios.ts | 69 +------- app/phone-ui/config-page.ts | 14 +- app/phone-ui/config-page.xml | 8 +- app/phone-ui/config-view-model.ts | 21 ++- app/phone-ui/main-page.ios.ts | 33 ++-- .../onboarding-firmware-check-page.ts | 6 + .../onboarding-firmware-check-page.xml | 2 +- .../onboarding-firmware-check-view-model.ts | 29 +++- app/phone-ui/onboarding-flash-page.ts | 6 + app/phone-ui/onboarding-flash-page.xml | 2 +- app/phone-ui/onboarding-flash-view-model.ts | 33 +++- app/phone-ui/onboarding-navigation.ts | 9 + app/phone-ui/onboarding-register.ios.ts | 19 ++ app/phone-ui/onboarding-unpair-page.xml | 2 +- app/phone-ui/onboarding-unpair-view-model.ts | 9 +- app/phone-ui/onboarding-view-model.ts | 6 +- app/phone-ui/pairing-view-model.ts | 16 +- app/phone-ui/permissions-view-model.ts | 16 +- tests/ios-app-host.test.cjs | 2 + tests/ios-onboarding-ota.test.cjs | 142 +++++++++++++++ tests/ios-onboarding.test.cjs | 164 ++++++++++++++++++ tests/ios-qr.test.cjs | 118 +++++++++++++ tests/tsconfig.json | 3 + webpack.config.js | 6 +- 46 files changed, 1419 insertions(+), 211 deletions(-) create mode 100644 app/g2/firmware-ota.ts create mode 100644 app/g2/firmware-types.ts create mode 100644 app/g2/flash-prompt-protocol.ts create mode 100644 app/g2/stock-connection.ts create mode 100644 app/native/ble-permissions.ios.ts create mode 100644 app/native/ble-permissions.ts create mode 100644 app/native/device-discovery-common.ts create mode 100644 app/native/device-discovery.ios.ts create mode 100644 app/native/device-info-probe.ios.ts create mode 100644 app/native/firmware-files.ios.ts create mode 100644 app/native/firmware-files.ts create mode 100644 app/native/firmware-flasher.ios.ts create mode 100644 app/native/flash-prompt-communicator.ios.ts create mode 100644 app/phone-ui/config-page-shared.ts create mode 100644 app/phone-ui/onboarding-navigation.ts create mode 100644 app/phone-ui/onboarding-register.ios.ts create mode 100644 tests/ios-onboarding-ota.test.cjs create mode 100644 tests/ios-onboarding.test.cjs create mode 100644 tests/ios-qr.test.cjs diff --git a/App_Resources/iOS/src/FaceclawCrypto.h b/App_Resources/iOS/src/FaceclawCrypto.h index 1ae03b25..c0eb02ba 100644 --- a/App_Resources/iOS/src/FaceclawCrypto.h +++ b/App_Resources/iOS/src/FaceclawCrypto.h @@ -1,4 +1,5 @@ #import @interface FaceclawCrypto : NSObject + (NSString *)hmacSha256:(NSString *)secret message:(NSString *)message; ++ (NSString *)sha256:(NSData *)data; @end diff --git a/App_Resources/iOS/src/FaceclawCrypto.m b/App_Resources/iOS/src/FaceclawCrypto.m index fe6b9362..6814fb3c 100644 --- a/App_Resources/iOS/src/FaceclawCrypto.m +++ b/App_Resources/iOS/src/FaceclawCrypto.m @@ -9,4 +9,11 @@ CCHmac(kCCHmacAlgSHA256, key.bytes, key.length, data.bytes, data.length, digest); return [[NSData dataWithBytes:digest length:sizeof(digest)] base64EncodedStringWithOptions:0]; } ++ (NSString *)sha256:(NSData *)data { + unsigned char digest[CC_SHA256_DIGEST_LENGTH]; + CC_SHA256(data.bytes, (CC_LONG)data.length, digest); + NSMutableString *hex = [NSMutableString stringWithCapacity:64]; + for (NSUInteger i = 0; i < sizeof(digest); i++) [hex appendFormat:@"%02x", digest[i]]; + return hex; +} @end diff --git a/app/app.ios.css b/app/app.ios.css index 71b27f3c..318a0809 100644 --- a/app/app.ios.css +++ b/app/app.ios.css @@ -1,3 +1,150 @@ +@import '@nativescript/theme/css/core.css'; + +.pairing-instructions { + color: #555555; + font-size: 14; +} + +.pairing-status { + font-size: 14; + margin-left: 8; +} + +.pairing-section { + font-size: 16; + font-weight: bold; + margin-bottom: 4; +} + +.pairing-empty { + color: #777777; + font-size: 14; + padding: 8 0; +} + +.pairing-row { + background-color: #f4f4f4; + border-color: #dddddd; + border-width: 1; + border-radius: 10; + padding: 10; + margin-bottom: 8; +} + +.pairing-row-selected { + background-color: #e6f0ff; + border-color: #3b6fd6; +} + +.pairing-row-incomplete { + background-color: #fafafa; + border-color: #e6e6e6; +} + +.pairing-art { + vertical-align: center; +} + +.pairing-title { + font-size: 16; + font-weight: bold; + color: #222222; +} + +.pairing-badge { + font-size: 11; + font-weight: bold; + color: #2a5bc4; + background-color: #dbe6fb; + border-radius: 9; + padding: 1 7; +} + +.pairing-variant { + font-size: 13; + font-weight: bold; + color: #333333; +} + +.pairing-proximity { + font-size: 12; + color: #666666; +} + +.pairing-proximity-immediate { + color: #2a5bc4; + font-weight: bold; +} + +.pairing-serial { + font-size: 12; + color: #666666; + font-family: monospace; +} + +.pairing-arms { + font-size: 12; + color: #444444; +} + +.pairing-warning { + font-size: 12; + color: #a33a1f; + margin-top: 4; +} + +.pairing-swatch-label { + font-size: 11; + color: #555555; +} + +.pairing-chevron { + font-size: 22; + color: #444444; + margin-left: 6; +} + +.pairing-selection { + background-color: #eef4ff; + border-radius: 10; + padding: 10; +} + +Button.pairing-link { + background-color: transparent; + color: #2a5bc4; + font-size: 14; + border-width: 0; +} + +/* + * Permissions screen (phone-ui/permissions-page). Cards reuse the pairing-row + * / pairing-title / pairing-badge look above; these add the explanation body + * and the already-granted checkmark. + */ +.permissions-description { + font-size: 13; + color: #555555; + margin-top: 2; +} + +.permissions-check { + font-size: 24; + color: #2e7d32; + margin-left: 10; +} + +/* Continue with required permissions still missing: looks disabled but stays + * tappable (the tap raises an are-you-sure prompt instead of being ignored). */ +Button.permissions-primary-dimmed { + opacity: 0.45; +} + + +.body-text { font-size: 18; } +.h1 { font-size: 28; font-weight: bold; } +.footer-link { color: #285c45; padding: 4 8; text-decoration: underline; } + Page { background-color: #f5f5f2; color: #202820; @@ -7,6 +154,8 @@ Button { background-color: #285c45; color: #ffffff; border-radius: 12; - padding: 16; - font-size: 17; + padding: 12 8; + margin-left: 4; + margin-right: 4; + font-size: 15; } diff --git a/app/bootstrap.ios.ts b/app/bootstrap.ios.ts index 599004a1..6897e8dc 100644 --- a/app/bootstrap.ios.ts +++ b/app/bootstrap.ios.ts @@ -1,4 +1,4 @@ -import { Application } from '@nativescript/core' +import { Application, Frame } from '@nativescript/core' import { runKotlinBridgeSmokeTest } from './native/kotlin-bridge' declare const FaceclawConfigPort: any declare const __DEV__: boolean; @@ -7,6 +7,10 @@ if (__DEV__) runKotlinBridgeSmokeTest() // Apply transferred preferences before settings getters or app workers load. FaceclawConfigPort.processPendingRequest() -const { createMainPage } = require('./phone-ui/main-page.ios') as typeof import('./phone-ui/main-page.ios') - -Application.run({ create: createMainPage }) +require('./phone-ui/onboarding-register.ios') +const { hasCompletedOnboarding } = require('./phone-ui/onboarding-state') as typeof import('./phone-ui/onboarding-state') +Application.run({ create: () => { + const frame = new Frame() + frame.navigate({ moduleName: hasCompletedOnboarding() ? 'phone-ui/main-page' : 'phone-ui/onboarding-page' }) + return frame +} }) diff --git a/app/g2/firmware-builder.ts b/app/g2/firmware-builder.ts index cd728af0..bf3eb4c3 100644 --- a/app/g2/firmware-builder.ts +++ b/app/g2/firmware-builder.ts @@ -23,7 +23,7 @@ import { fetchWithUserAgent } from "../util/http"; import { bytesToHex, hexToBytes as hexToBytesLenient } from "../util/hex-util"; import { EvenHubFont } from "../graphics/evenhub-font"; -declare const com: any; +import { firmwareSha256, writeFirmwareFile } from "../native/firmware-files"; // The CDN names firmware files by MD5. This must be the image whose SHA-256 is // CFW_PATCH_SET.baseSha256 — keep it in sync with FW_URL in g2flash/build_cfw.sh @@ -281,12 +281,12 @@ function tightBuffer(bytes: Uint8Array): ArrayBuffer { return bytes.slice().buffer; } -/** SHA-256 hex digest of an ArrayBuffer, via Android's MessageDigest. */ +/** SHA-256 hex digest using the platform's native crypto implementation. */ function sha256Hex(buffer: ArrayBuffer): string { - return String(com.faceclaw.app.FaceclawFirmwareUtil.sha256Hex(buffer)); + return firmwareSha256(buffer); } -/** Write an ArrayBuffer's bytes to `path`, via a native FileChannel write. */ +/** Persist the verified image using the platform's native file API. */ function writeFile(path: string, buffer: ArrayBuffer): void { - com.faceclaw.app.FaceclawFirmwareUtil.writeFile(path, buffer); + writeFirmwareFile(path, buffer); } diff --git a/app/g2/firmware-ota.ts b/app/g2/firmware-ota.ts new file mode 100644 index 00000000..78cc4701 --- /dev/null +++ b/app/g2/firmware-ota.ts @@ -0,0 +1,91 @@ +/** Stock EVENOTA validation and transfer, matching Android's flasher/g2flash.py. */ +import { StockConnection, OTA_WRITE, OTA_NOTIFY } from './stock-connection' +import { concat } from './ble-protocol' +import type { FlashProgress } from './firmware-types' + +export type FirmwareSegment = { offset: number; size: number; name: string } +const CRC_TABLE = Array.from({ length: 256 }, (_, b) => { + let c = b << 24 + for (let i = 0; i < 8; i++) c = c & 0x80000000 ? (c << 1) ^ 0x1edc6f41 : c << 1 + return c >>> 0 +}) +export function firmwareCrc(data: Uint8Array): number { + let crc = 0 + for (const byte of data) crc = (crc << 8) ^ CRC_TABLE[((crc >>> 24) ^ byte) & 255] + return crc >>> 0 +} +export function validateFirmware(image: Uint8Array): FirmwareSegment[] { + const u32 = (offset: number) => { + if (offset < 0 || offset + 4 > image.length) throw new Error('Firmware header is truncated.') + return new DataView(image.buffer, image.byteOffset, image.byteLength).getUint32(offset, true) + } + if (image.length < 0x40) throw new Error('File is too small to be a firmware image.') + const count = u32(8) + if (count < 5 || count > 6 || 0x40 + count * 16 > image.length) throw new Error('Expected 5–6 firmware components.') + const segments: FirmwareSegment[] = [] + for (let i = 0; i < count; i++) { + const toc = 0x40 + i * 16, offset = u32(toc + 4) + if (offset < 0x40 + count * 16 || offset + 128 > image.length) throw new Error('Firmware component header is out of bounds.') + const size = u32(offset + 8), end = offset + 128 + size + if (!size || end > image.length) throw new Error('Firmware component payload is truncated.') + if (segments.some(s => offset < s.offset + 128 + s.size && s.offset < end)) throw new Error('Firmware components overlap.') + const nameBytes = image.subarray(offset + 48, offset + 128) + const name = String.fromCharCode(...nameBytes.subarray(0, nameBytes.indexOf(0) < 0 ? 80 : nameBytes.indexOf(0))) + const crc = firmwareCrc(image.subarray(offset + 128, end)) + if (crc !== u32(toc + 12) || crc !== u32(offset + 12)) throw new Error(`Component ${name} CRC32C is stale (image not checksum-fixed).`) + segments.push({ offset, size, name }) + } + const mains = segments.filter(s => s.name === 'ota/s200_firmware_ota.bin') + if (mains.length !== 1) throw new Error('Required main firmware component is missing or duplicated.') + const main = mains[0], payload = main.offset + 128 + if (main.size < 32 || u32(payload + 0x14) !== 0x00438000 || (u32(payload) & 0xffffff) !== main.size) + throw new Error('Main-app preamble load address or length is invalid.') + if (0x00438000 + main.size - 32 > 0x007f0000) throw new Error('Main-app exceeds the safe MRAM ceiling — refusing to flash.') + return segments +} + +export async function flashLensImage(link: StockConnection, role: string, image: Uint8Array, segments: FirmwareSegment[], + progress: (value: FlashProgress) => void, log: (line: string) => void, + delay: (ms: number) => Promise): Promise { + let sequence = 0 + const ctrl = async (op: number, payload = new Uint8Array(), data?: Uint8Array): Promise => { + sequence = (sequence + 1) & 255 + const message = await link.exchange(role, 0xc0, concat(new Uint8Array([op]), payload), + message => message.command === op, data ? 4000 : 8000, OTA_WRITE, OTA_NOTIFY, 0, sequence, data) + return message.payload[1] + } + const accepted = (status: number) => [0, 8, 9].includes(status) + const begin = await ctrl(0) + if (!accepted(begin)) throw new Error(`OTA BEGIN rejected (status ${begin}).`) + const total = segments.reduce((sum, segment) => sum + segment.size, 0) + let before = 0 + for (const [index, segment] of segments.entries()) { + let verified = false, failure: unknown + for (let attempt = 0; attempt < 3; attempt++) { + link.check() + if (attempt) { log(`${segment.name}: re-flash attempt ${attempt + 1}/3`); await delay(1500) } + try { + const status = await ctrl(1, image.slice(segment.offset, segment.offset + 128)) + if (status !== 0) throw new Error(`FILE_CHECK rejected (status ${status}).`) + const blocks = Math.ceil(segment.size / 4096) + for (let block = 0; block < blocks; block++) { + const start = segment.offset + 128 + block * 4096 + const data = image.slice(start, Math.min(start + 4096, segment.offset + 128 + segment.size)) + let ok = false + for (let retry = 0; retry < 3; retry++) { + if (await ctrl(2, new Uint8Array(), data) === 0) { ok = true; break } + } + if (!ok) throw new Error(`Block ${block + 1} rejected three times.`) + if (block % 20 === 0 || block === blocks - 1) + progress({ lens: role, componentIndex: index + 1, componentCount: segments.length, blockIndex: block + 1, + blockCount: blocks, bytesSent: before + Math.min((block + 1) * 4096, segment.size), bytesTotal: total }) + } + const end = await ctrl(3) + if (!accepted(end)) throw new Error(`END verification failed (status ${end}).`) + log(`${role} ${segment.name}: END verify OK (status ${end})`); verified = true; break + } catch (error) { link.check(); failure = error } + } + if (!verified) throw new Error(`Component ${segment.name} failed after 3 attempts: ${failure}`) + before += segment.size + } +} diff --git a/app/g2/firmware-types.ts b/app/g2/firmware-types.ts new file mode 100644 index 00000000..e3503894 --- /dev/null +++ b/app/g2/firmware-types.ts @@ -0,0 +1,13 @@ +export type FlashState = "validating" | "connecting" | "flashing" | "rebooting" | "done" | "error"; + +export type FlashProgress = { + lens: string; + componentIndex: number; + componentCount: number; + blockIndex: number; + blockCount: number; + /** Bytes flashed so far across the whole lens image — the size-weighted progress signal. */ + bytesSent: number; + bytesTotal: number; +}; + diff --git a/app/g2/flash-prompt-protocol.ts b/app/g2/flash-prompt-protocol.ts new file mode 100644 index 00000000..d4e166e4 --- /dev/null +++ b/app/g2/flash-prompt-protocol.ts @@ -0,0 +1,18 @@ +import { bytes, concat, integer, readBytes, readInteger, readString, type ProtocolMessage } from './ble-protocol' +const text = (field: number, value: string) => bytes(field, new Uint8Array(Array.from(value, ch => ch.charCodeAt(0)))) +export function createFlashPrompt(magic: number, warning: string): Uint8Array { + const geometry = (y: number, height: number, id: number, name: string) => concat( + integer(1, 0), integer(2, y), integer(3, 280), integer(4, height), integer(9, id), text(10, name)) + const list = concat(geometry(150, 120, 2, 'flashmenu'), bytes(11, concat(integer(1, 2), integer(3, 1), text(4, 'No, cancel'), text(4, 'Yes, flash'))), integer(12, 1)) + const label = concat(geometry(0, 130, 1, 'flashwarn'), text(12, warning)) + return concat(integer(1, 0), integer(2, magic), bytes(3, concat(integer(1, 2), bytes(2, list), bytes(3, label), integer(5, 10000)))) +} +export function flashPromptSelection(message: ProtocolMessage): boolean | null { + if (message.sid !== 0xe0 || ![1, 6].includes(message.flag)) return null + const event = readBytes(message.payload, 13), list = event && readBytes(event, 1) + if (!list || readString(list, 2) !== 'flashmenu' || readInteger(list, 5, 0) !== 0) return null + const index = readInteger(list, 4, -1), name = readString(list, 3).toLowerCase() + if (index === 1 || name.startsWith('yes')) return true + if (index === 0 || name.startsWith('no')) return false + return null +} diff --git a/app/g2/glasses-session.ts b/app/g2/glasses-session.ts index e7502923..eb01f411 100644 --- a/app/g2/glasses-session.ts +++ b/app/g2/glasses-session.ts @@ -130,7 +130,7 @@ export class GlassesSession { this.applySettings(settings) const firmware = { leftVersion: this.state.leftVersion, rightVersion: this.state.rightVersion, extension: this.state.capabilities } if (!hasCompatibleFirmware(firmware)) - throw new Error((firmwareIncompatibilityMessage(firmware) || `The glasses must report Faceclaw firmware revision ${REQUIRED_FACECLAW_FIRMWARE_VERSION} or newer.`) + ' Flashing remains available on Android.') + throw new Error((firmwareIncompatibilityMessage(firmware) || `The glasses must report Faceclaw firmware revision ${REQUIRED_FACECLAW_FIRMWARE_VERSION} or newer.`) + ' Use Devices → Check firmware to install it.') this.update('connecting', 'Starting glasses display…') await this.request('right', protocol.SID.launch, () => protocol.prelude(), 'App launch', 3500, 0x20, 156) await this.lease(true) diff --git a/app/g2/stock-connection.ts b/app/g2/stock-connection.ts new file mode 100644 index 00000000..edce1b4f --- /dev/null +++ b/app/g2/stock-connection.ts @@ -0,0 +1,152 @@ +import * as p from './ble-protocol' +import type { SessionTransport, SessionAddresses, TransportEvent } from './glasses-session' +import { hexToBytes } from '../util/hex-util' + +declare function setTimeout(callback: () => void, ms: number): number +declare function clearTimeout(id: number): void + +export const OTA_WRITE = '00002760-08c2-11e1-9073-0e8ac72e0001' +export const OTA_NOTIFY = '00002760-08c2-11e1-9073-0e8ac72e0002' +export class StockTimeout extends Error {} +type Waiter = { role: string; characteristic: string; match: (message: p.ProtocolMessage) => boolean; + resolve: (message: p.ProtocolMessage) => void; reject: (error: Error) => void; timer: ReturnType | null } + +/** Exclusive, short-lived stock-protocol connection for onboarding/OTA. No display pump. */ +export class StockConnection { + ids: Record = {} + private limits: Record = {} + private receiver = new p.MessageReceiver() + private waiters = new Set() + private listeners = new Set<(role: string, message: p.ProtocolMessage) => void>() + private lost = new Set() + private writes = new Map>() + private closed = false + private magic = 0x60 + private sequence = 0 + private off: () => void + constructor(private transport: SessionTransport, private log: (line: string) => void = () => {}) { + this.off = transport.onEvent(event => this.receive(event)) + } + check(): void { if (this.closed) throw new Error('Cancelled.') } + isConnected(role: string): boolean { return !this.closed && !!this.limits[role] && !this.lost.has(role) } + async resolve(addresses: SessionAddresses): Promise { + this.ids = await this.transport.resolveDevices(addresses); this.check() + } + async connect(role: string, ota = false): Promise { + this.check(); this.lost.delete(role) + const id = this.ids[role] + if (!id) throw new Error(`No ${role} lens configured.`) + const details = await this.transport.connect(id) + if (this.closed) { this.transport.disconnect(id); this.check() } + this.limits[role] = details.maxWrite + for (const characteristic of [p.G2_WRITE, p.G2_NOTIFY, ...(ota ? [OTA_WRITE, OTA_NOTIFY] : [])]) + if (!details.characteristics.includes(characteristic)) throw new Error(`${role} lens is missing ${ota ? 'firmware update' : 'G2'} characteristics.`) + await this.transport.subscribe(id, p.G2_NOTIFY); this.check() + if (ota) { await this.transport.subscribe(id, OTA_NOTIFY); this.check() } + } + nextMagic(): number { this.magic = this.magic >= 0x7f ? 0x60 : this.magic + 1; return this.magic } + async authenticate(role: string): Promise { + for (let attempt = 0; attempt < 2; attempt++) { + const magic = this.nextMagic() + try { + await this.exchange(role, p.SID.auth, p.authentication(magic), + message => p.authenticationSucceeded(message, magic), 30_000, p.G2_WRITE, p.G2_NOTIFY, 0) + this.log(`Security authentication complete: ${role} lens`); return + } catch (error) { this.check(); if (!(error instanceof StockTimeout) || attempt === 1) throw error } + } + } + request(role: string, sid: number, build: (magic: number) => Uint8Array, timeout = 3500, fixedMagic?: number): Promise { + const magic = fixedMagic ?? this.nextMagic() + return this.exchange(role, sid, build(magic), message => message.sid === sid && message.magic === magic && ![1, 6].includes(message.flag), timeout) + } + write(role: string, sid: number, payload: Uint8Array, characteristic = p.G2_WRITE, flag = 0x20, sequence = ++this.sequence): Promise { + // Keep a fragmented control message together when the prompt heartbeat + // overlaps a settings request or shutdown. + const pending = (this.writes.get(role) ?? Promise.resolve()).catch(() => {}).then(async () => { + this.check() + for (const frame of p.frameMessage(payload, sid, flag, sequence, this.limits[role])) { + this.check() + if (this.lost.has(role)) throw new Error(`Lost connection to the ${role} lens.`) + await this.transport.write(this.ids[role], characteristic, frame) + } + this.check() + if (this.lost.has(role)) throw new Error(`Lost connection to the ${role} lens.`) + }) + this.writes.set(role, pending) + return pending + } + exchange(role: string, sid: number, payload: Uint8Array, match: Waiter['match'], timeout: number, + write = p.G2_WRITE, notify = p.G2_NOTIFY, flag = 0x20, sequence?: number, data?: Uint8Array): Promise { + this.check() + return new Promise((resolve, reject) => { + let written = false, reply: p.ProtocolMessage | null = null + const waiter: Waiter = { role, characteristic: notify, match, + resolve: message => { reply = message; if (written) resolve(message) }, reject, + timer: null } + this.waiters.add(waiter) + void (async () => { + await this.write(role, sid, payload, write, flag, sequence) + if (data) await this.write(role, 0xc1, data, write, flag, sequence) + this.check() + if (!reply && !this.waiters.has(waiter)) return + written = true + if (reply) resolve(reply) + else waiter.timer = setTimeout(() => { + this.waiters.delete(waiter) + reject(new StockTimeout(`No response from the ${role} lens (0x${sid.toString(16)}).`)) + }, timeout) + })().catch(error => { this.waiters.delete(waiter); if (waiter.timer !== null) clearTimeout(waiter.timer); reject(error) }) + }) + } + + onMessage(listener: (role: string, message: p.ProtocolMessage) => void): () => void { + this.listeners.add(listener); return () => this.listeners.delete(listener) + } + private receive(event: TransportEvent): void { + if (this.closed) return + const role = Object.keys(this.ids).find(role => this.ids[role] === event.identifier) + if (!role) return + if (event.kind === 'disconnected') { + this.lost.add(role) + for (const waiter of [...this.waiters]) if (waiter.role === role) { + this.waiters.delete(waiter); if (waiter.timer !== null) clearTimeout(waiter.timer); waiter.reject(new Error(`Lost connection to the ${role} lens.`)) + } + return + } + if (event.kind !== 'notification' || !event.data || ![p.G2_NOTIFY, OTA_NOTIFY].includes(event.characteristic!)) return + try { + const data = hexToBytes(event.data) + const messages = event.characteristic === OTA_NOTIFY ? decodeOtaAcks(data) : this.receiver.receive(event.identifier!, data) + for (const message of messages) { + for (const waiter of [...this.waiters]) if (waiter.role === role && waiter.characteristic === event.characteristic && waiter.match(message)) { + this.waiters.delete(waiter); if (waiter.timer !== null) clearTimeout(waiter.timer); waiter.resolve(message) + } + if (event.characteristic === p.G2_NOTIFY) for (const listener of this.listeners) listener(role, message) + } + } catch (error) { this.log(`Ignored malformed onboarding notification: ${error}`) } + } + disconnect(role: string): void { this.lost.add(role); if (this.ids[role]) this.transport.disconnect(this.ids[role]); this.receiver.clear() } + close(): void { + if (this.closed) return + this.closed = true; this.off(); this.transport.stopScan() + for (const waiter of this.waiters) { if (waiter.timer !== null) clearTimeout(waiter.timer); waiter.reject(new Error('Cancelled.')) } + this.waiters.clear(); this.listeners.clear() + for (const role of Object.keys(this.ids)) this.disconnect(role) + } +} + +/** OTA ACKs are raw opcode/status bytes, not protobuf; validate the aa21 CRC envelope. */ +export function decodeOtaAcks(data: Uint8Array): p.ProtocolMessage[] { + const messages: p.ProtocolMessage[] = [] + for (let offset = 0; offset + 8 <= data.length;) { + const n = data[offset + 3], end = offset + 8 + n + if (end > data.length) break + if (data[offset] === 0xaa && [0x12, 0x21].includes(data[offset + 1]) && data[offset + 4] === 1 && data[offset + 5] === 1 && n >= 4) { + const payload = data.slice(offset + 8, end - 2) + if (p.crc16(payload) === (data[end - 2] | data[end - 1] << 8)) + messages.push({ sid: data[offset + 6], flag: data[offset + 7], payload, command: payload[0], magic: -1 }) + } + offset = end + } + return messages +} diff --git a/app/native/ble-permissions.ios.ts b/app/native/ble-permissions.ios.ts new file mode 100644 index 00000000..233c368a --- /dev/null +++ b/app/native/ble-permissions.ios.ts @@ -0,0 +1,2 @@ +import { iosBluetooth } from './ios-bluetooth' +export async function ensureBlePermissions(): Promise { await iosBluetooth().ensureReady() } diff --git a/app/native/ble-permissions.ts b/app/native/ble-permissions.ts new file mode 100644 index 00000000..14a4b9ad --- /dev/null +++ b/app/native/ble-permissions.ts @@ -0,0 +1 @@ +export { ensureBlePermissions } from '../g2/android-permissions' diff --git a/app/native/device-discovery-common.ts b/app/native/device-discovery-common.ts new file mode 100644 index 00000000..6a5c4f37 --- /dev/null +++ b/app/native/device-discovery-common.ts @@ -0,0 +1,52 @@ +import { type RawAdvertisement } from "../g2/even-advertisement"; +import { DiscoveryAggregator } from "../g2/pairing-candidates"; +import type { DiscoveredAddressSet } from "./device-discovery"; + +/** + * Pick one address per role from a batch of raw advertisements — the manual + * address page's "load" helper and the flash flow's address resolution. + * + * Runs the batch through the same `DiscoveryAggregator` the pairing page + * uses, so left/right come from ONE serial-joined pair (the closest complete + * one) rather than from whichever arm of whatever pair advertised last — + * "latest per role" silently welded together arms of two different pairs. + * When no arm carries a serial at all (a bonded-device listing has no + * manufacturer data), there is nothing to join on and the latest arm per side + * is used as before. + */ +export function buildAddressSet(candidates: RawAdvertisement[]): DiscoveredAddressSet { + const aggregator = new DiscoveryAggregator(); + for (const raw of candidates) aggregator.ingest(raw); + const classified = aggregator.advertisements(); + const pairs = aggregator.pairs(); + + let left = ""; + let right = ""; + const completePair = pairs.find((pair) => pair.completeness === "complete"); + if (completePair) { + left = completePair.left!.address; + right = completePair.right!.address; + } else if (classified.every((candidate) => !candidate.serial)) { + for (const role of ["left", "right"] as const) { + const latest = classified + .filter((candidate) => candidate.role === role) + .sort((a, b) => b.seenAtMs - a.seenAtMs)[0]; + if (role === "left") left = latest?.address ?? ""; + else right = latest?.address ?? ""; + } + } + // Arms with serials but no complete pair: leave the addresses empty. The + // summary below names what was heard; guessing would defeat the serial join. + + const lines = classified.map((candidate) => { + const extras = [candidate.serial ? `serial ${candidate.serial}` : null, candidate.rssi != null ? `${candidate.rssi} dBm` : null].filter(Boolean); + return `${candidate.role}: ${candidate.name} ${candidate.address}${extras.length ? ` (${extras.join(", ")})` : ""}`; + }); + return { + left, + right, + ring: aggregator.rings()[0]?.advertisement.address ?? "", + summary: lines.length ? lines.join("\n") : "No matching devices found.", + }; +} + diff --git a/app/native/device-discovery.ios.ts b/app/native/device-discovery.ios.ts new file mode 100644 index 00000000..519cf51d --- /dev/null +++ b/app/native/device-discovery.ios.ts @@ -0,0 +1,52 @@ +import { iosBluetooth } from './ios-bluetooth' +import type { DiscoveryEvents } from './device-discovery' +import type { RawAdvertisement } from '../g2/even-advertisement' +export { buildAddressSet } from './device-discovery-common' + +export class DeviceDiscoveryBridge { + private ble = iosBluetooth() + private off: (() => void) | null = null + private generation = 0 + private cancelCollection: (() => void) | null = null + get bluetoothEnabled(): boolean { return this.ble.state === 5 } + get scanning(): boolean { return !!this.off && this.ble.scanning } + startScan(events: DiscoveryEvents): boolean { + this.stopScan() + const generation = this.generation + if (!this.bluetoothEnabled) return false + this.off = this.ble.onEvent(event => { + if (event.kind === 'device' && 'device' in event) events.onAdvertisement(event.device) + if (event.kind === 'state' && event.state !== 5) events.onScanFailed?.(event.state ?? 0, 'Bluetooth is unavailable. Turn it on, then tap Scan.') + }) + void this.ble.startScan(24 * 60 * 60 * 1000).catch(error => { + if (generation === this.generation) events.onScanFailed?.(-1, String(error.message ?? error)) + }) + return true + } + stopScan(): void { + ++this.generation; this.cancelCollection?.() + if (this.off) { this.off(); this.off = null; this.ble.stopScan() } + } + // CoreBluetooth does not expose the phone's bond list. Fresh advertisements + // supply both identity and the UUID mapping that iOS needs for connections. + emitBondedDevices(): void {} + async getBondedCandidates(): Promise { return [...this.ble.devices.values()] } + async scanCandidates(timeoutMs = 6000): Promise { + const generation = this.generation + await this.ble.ensureReady() + if (generation !== this.generation) throw new Error('Bluetooth scan cancelled.') + return new Promise((resolve, reject) => { + const samples: RawAdvertisement[] = [] + const finish = (error?: Error) => { + clearTimeout(timer); this.cancelCollection = null; this.stopScan() + if (error) reject(error); else resolve(samples) + } + const timer = setTimeout(() => finish(), timeoutMs) + if (!this.startScan({ onAdvertisement: sample => samples.push(sample), + onScanFailed: (_code, message) => finish(new Error(message)) })) { + finish(new Error('Bluetooth is unavailable.')); return + } + this.cancelCollection = () => { this.cancelCollection = null; clearTimeout(timer); reject(new Error('Bluetooth scan cancelled.')) } + }) + } +} diff --git a/app/native/device-discovery.ts b/app/native/device-discovery.ts index e35c13c0..08e3b131 100644 --- a/app/native/device-discovery.ts +++ b/app/native/device-discovery.ts @@ -1,7 +1,7 @@ import { Utils } from "@nativescript/core"; import { type RawAdvertisement } from "../g2/even-advertisement"; -import { DiscoveryAggregator } from "../g2/pairing-candidates"; +export { buildAddressSet } from "./device-discovery-common"; declare const com: any; @@ -108,53 +108,6 @@ export class DeviceDiscoveryBridge { } } -/** - * Pick one address per role from a batch of raw advertisements — the manual - * address page's "load" helper and the flash flow's address resolution. - * - * Runs the batch through the same `DiscoveryAggregator` the pairing page - * uses, so left/right come from ONE serial-joined pair (the closest complete - * one) rather than from whichever arm of whatever pair advertised last — - * "latest per role" silently welded together arms of two different pairs. - * When no arm carries a serial at all (a bonded-device listing has no - * manufacturer data), there is nothing to join on and the latest arm per side - * is used as before. - */ -export function buildAddressSet(candidates: RawAdvertisement[]): DiscoveredAddressSet { - const aggregator = new DiscoveryAggregator(); - for (const raw of candidates) aggregator.ingest(raw); - const classified = aggregator.advertisements(); - const pairs = aggregator.pairs(); - - let left = ""; - let right = ""; - const completePair = pairs.find((pair) => pair.completeness === "complete"); - if (completePair) { - left = completePair.left!.address; - right = completePair.right!.address; - } else if (classified.every((candidate) => !candidate.serial)) { - for (const role of ["left", "right"] as const) { - const latest = classified - .filter((candidate) => candidate.role === role) - .sort((a, b) => b.seenAtMs - a.seenAtMs)[0]; - if (role === "left") left = latest?.address ?? ""; - else right = latest?.address ?? ""; - } - } - // Arms with serials but no complete pair: leave the addresses empty. The - // summary below names what was heard; guessing would defeat the serial join. - - const lines = classified.map((candidate) => { - const extras = [candidate.serial ? `serial ${candidate.serial}` : null, candidate.rssi != null ? `${candidate.rssi} dBm` : null].filter(Boolean); - return `${candidate.role}: ${candidate.name} ${candidate.address}${extras.length ? ` (${extras.join(", ")})` : ""}`; - }); - return { - left, - right, - ring: aggregator.rings()[0]?.advertisement.address ?? "", - summary: lines.length ? lines.join("\n") : "No matching devices found.", - }; -} function parseRawArray(json: string): RawAdvertisement[] { const items = JSON.parse(json) as unknown[]; diff --git a/app/native/device-info-probe.ios.ts b/app/native/device-info-probe.ios.ts new file mode 100644 index 00000000..ac82157c --- /dev/null +++ b/app/native/device-info-probe.ios.ts @@ -0,0 +1,68 @@ +import { StockConnection, StockTimeout } from '../g2/stock-connection' +import * as p from '../g2/ble-protocol' +import { iosBluetooth } from './ios-bluetooth' +import type { DeviceInfo, DeviceInfoState } from './device-info-probe' +export type { DeviceInfo, DeviceInfoState } from './device-info-probe' + +export class DeviceInfoProbe { + private logs = new Set<(line: string) => void>() + private states = new Set<(state: DeviceInfoState, detail: string) => void>() + private link = new StockConnection(iosBluetooth(), line => { for (const fn of this.logs) fn(line) }) + constructor(private right: string, private left = '') {} + onLog(fn: (line: string) => void): () => void { this.logs.add(fn); return () => this.logs.delete(fn) } + onStateChange(fn: (state: DeviceInfoState, detail: string) => void): () => void { this.states.add(fn); return () => this.states.delete(fn) } + async run(): Promise { + const snapshots = new Map() + const parse = (message: p.ProtocolMessage): DeviceInfo => { + const values = p.readBytes(message.payload, 4) + return { leftVersion: values ? p.readString(values, 5) : '', rightVersion: values ? p.readString(values, 6) : '', extension: p.readString(message.payload, 100) } + } + const hasVersion = (info: DeviceInfo) => !!(info.leftVersion || info.rightVersion || info.extension) + // Some stock builds push settings using their own magic instead of the + // query's magic. Keep a valid snapshot as the Android probe does. + this.link.onMessage((role, message) => { + if (message.sid === p.SID.settings) { const info = parse(message); if (hasVersion(info)) snapshots.set(role, info) } + }) + try { + await this.link.resolve({ right: this.right, left: this.left, ring: '' }) + for (const role of ['right', ...(this.left ? ['left'] : [])]) { + await this.bringUp(role) + } + let lastError: unknown + for (const role of ['right', ...(this.left ? ['left'] : [])]) { + for (const fn of this.states) fn('querying', role) + try { + if (!this.link.isConnected(role)) await this.bringUp(role) + await this.link.request(role, p.SID.launch, p.prelude, 3500, 156) + for (let attempt = 0; attempt < 2; attempt++) { + try { + const message = await this.link.request(role, p.SID.settings, p.settingsQuery) + const info = parse(message) + if (hasVersion(info)) return info + } catch (error) { this.link.check(); lastError = error } + if (snapshots.has(role)) return snapshots.get(role)! + } + } catch (error) { this.link.check(); lastError = error } + } + throw lastError ?? new Error("Connected, but couldn't read a firmware version.") + } finally { this.close() } + } + private async bringUp(role: string): Promise { + for (let attempt = 0; ; attempt++) { + try { + for (const fn of this.states) fn('connecting', role) + await this.link.connect(role) + for (const fn of this.states) fn('authenticating', role) + // Version reads remain available on older stock builds without an auth ACK. + try { await this.link.authenticate(role) } catch (error) { if (!(error instanceof StockTimeout)) throw error } + return + } catch (error) { + this.link.check(); this.link.disconnect(role) + if (attempt === 2) throw error + await new Promise(resolve => setTimeout(resolve, 1500)); this.link.check() + } + } + } + cancel(): void { this.link.close() } + close(): void { this.link.close() } +} diff --git a/app/native/firmware-files.ios.ts b/app/native/firmware-files.ios.ts new file mode 100644 index 00000000..4dd8f2e5 --- /dev/null +++ b/app/native/firmware-files.ios.ts @@ -0,0 +1,11 @@ +import { toData, fromData } from './kotlin-data' +declare const FaceclawCrypto: any +export function firmwareSha256(buffer: ArrayBuffer): string { return String(FaceclawCrypto.sha256(toData(new Uint8Array(buffer)))) } +export function writeFirmwareFile(path: string, buffer: ArrayBuffer): void { + if (!toData(new Uint8Array(buffer)).writeToFileAtomically(path, true)) throw new Error('Could not save the verified firmware image.') +} +export function readFirmwareFile(path: string): Uint8Array { + const data = NSData.dataWithContentsOfFile(path) + if (!data) throw new Error('Could not read the prepared firmware image.') + return fromData(data) +} diff --git a/app/native/firmware-files.ts b/app/native/firmware-files.ts new file mode 100644 index 00000000..59236354 --- /dev/null +++ b/app/native/firmware-files.ts @@ -0,0 +1,3 @@ +declare const com: any +export function firmwareSha256(buffer: ArrayBuffer): string { return String(com.faceclaw.app.FaceclawFirmwareUtil.sha256Hex(buffer)) } +export function writeFirmwareFile(path: string, buffer: ArrayBuffer): void { com.faceclaw.app.FaceclawFirmwareUtil.writeFile(path, buffer) } diff --git a/app/native/firmware-flasher.ios.ts b/app/native/firmware-flasher.ios.ts new file mode 100644 index 00000000..bcbf8613 --- /dev/null +++ b/app/native/firmware-flasher.ios.ts @@ -0,0 +1,83 @@ +import { Application } from '@nativescript/core' +import { StockConnection } from '../g2/stock-connection' +import { flashLensImage, validateFirmware } from '../g2/firmware-ota' +import { CFW_PATCH_SET } from '../g2/firmware/cfw-patches' +import { firmwareSha256, readFirmwareFile } from './firmware-files.ios' +import { iosBluetooth } from './ios-bluetooth' +import type { FlashState, FlashProgress } from './firmware-flasher' +export type { FlashState, FlashProgress } from './firmware-flasher' + +export class FirmwareFlasher { + private logs = new Set<(line: string) => void>() + private states = new Set<(state: FlashState, detail: string) => void>() + private progresses = new Set<(value: FlashProgress) => void>() + private completes = new Set<(success: boolean, detail: string) => void>() + private link = new StockConnection(iosBluetooth(), line => this.log(line)) + private started = false + private cancelled = false + private sleeps = new Set<() => void>() + private foregroundError = '' + constructor(private addresses: { right: string; left: string }, private path: string) {} + onLog(fn: (line: string) => void): () => void { this.logs.add(fn); return () => this.logs.delete(fn) } + onStateChange(fn: (state: FlashState, detail: string) => void): () => void { this.states.add(fn); return () => this.states.delete(fn) } + onProgress(fn: (value: FlashProgress) => void): () => void { this.progresses.add(fn); return () => this.progresses.delete(fn) } + onComplete(fn: (success: boolean, detail: string) => void): () => void { this.completes.add(fn); return () => this.completes.delete(fn) } + private log(line: string): void { for (const fn of this.logs) fn(line) } + private state(state: FlashState, detail = ''): void { for (const fn of this.states) fn(state, detail) } + start(): void { if (!this.started) { this.started = true; void this.run() } } + private readonly backgrounded = () => { + this.foregroundError = 'Flashing was interrupted because Faceclaw left the foreground. Keep both lenses charged, return to Faceclaw, and retry both lenses.' + this.cancel() + } + private async run(): Promise { + const previousIdle = UIApplication.sharedApplication.idleTimerDisabled + UIApplication.sharedApplication.idleTimerDisabled = true + Application.on(Application.suspendEvent, this.backgrounded) + let success = false, detail = '' + try { + this.link.check() + if (UIApplication.sharedApplication.applicationState !== UIApplicationState.Active) throw new Error('Keep Faceclaw open on the iPhone while flashing.') + this.state('validating') + const image = readFirmwareFile(this.path) + const hash = firmwareSha256(image.buffer) + if (![CFW_PATCH_SET.outputSha256, CFW_PATCH_SET.baseSha256].includes(hash)) throw new Error('Prepared firmware failed SHA-256 verification. Prepare the firmware again before flashing.') + const segments = validateFirmware(image) + await this.link.resolve({ ...this.addresses, ring: '' }) + for (const role of ['left', 'right']) { + if (role === 'right') { + this.state('rebooting', 'Left lens done. Both lenses reboot briefly; reconnecting for the right lens.') + await this.delay(5000) + } + this.state('connecting', role) + const deadline = Date.now() + (role === 'left' ? 30_000 : 120_000) + for (;;) { + try { await this.link.connect(role, true); await this.link.authenticate(role); break } + catch (error) { this.link.check(); this.link.disconnect(role); if (Date.now() >= deadline) throw error; await this.delay(2500) } + } + await this.delay(2500) + this.state('flashing', role) + await flashLensImage(this.link, role, image, segments, value => { for (const fn of this.progresses) fn(value) }, line => this.log(line), ms => this.delay(ms)) + this.link.disconnect(role) + } + success = true; detail = 'Both lenses flashed. Your glasses are rebooting.' + } catch (error) { + detail = this.foregroundError || (this.cancelled ? 'Cancelled. Retry with both lenses powered on to complete installation.' : String((error as Error).message ?? error)) + } finally { + Application.off(Application.suspendEvent, this.backgrounded) + UIApplication.sharedApplication.idleTimerDisabled = previousIdle + this.link.close() + } + this.state(success ? 'done' : 'error', detail) + for (const fn of this.completes) fn(success, detail) + } + private delay(ms: number): Promise { + this.link.check() + return new Promise((resolve, reject) => { + const cancel = () => { clearTimeout(timer); this.sleeps.delete(cancel); reject(new Error('Cancelled.')) } + const timer = setTimeout(() => { this.sleeps.delete(cancel); resolve() }, ms) + this.sleeps.add(cancel) + }) + } + cancel(): void { this.cancelled = true; this.link.close(); for (const cancel of [...this.sleeps]) cancel() } + close(): void { this.cancel() } +} diff --git a/app/native/firmware-flasher.ts b/app/native/firmware-flasher.ts index cd75d0b7..ed9ac5f9 100644 --- a/app/native/firmware-flasher.ts +++ b/app/native/firmware-flasher.ts @@ -2,18 +2,8 @@ import { Utils } from "@nativescript/core"; declare const com: any; -export type FlashState = "validating" | "connecting" | "flashing" | "rebooting" | "done" | "error"; - -export type FlashProgress = { - lens: string; - componentIndex: number; - componentCount: number; - blockIndex: number; - blockCount: number; - /** Bytes flashed so far across the whole lens image — the size-weighted progress signal. */ - bytesSent: number; - bytesTotal: number; -}; +import type { FlashState, FlashProgress } from "../g2/firmware-types"; +export type { FlashState, FlashProgress } from "../g2/firmware-types"; /** * TS wrapper around the native FaceclawFirmwareFlasher — streams a verified diff --git a/app/native/flash-prompt-communicator.ios.ts b/app/native/flash-prompt-communicator.ios.ts new file mode 100644 index 00000000..bea0933f --- /dev/null +++ b/app/native/flash-prompt-communicator.ios.ts @@ -0,0 +1,88 @@ +import { StockConnection } from '../g2/stock-connection' +import { createFlashPrompt, flashPromptSelection } from '../g2/flash-prompt-protocol' +import * as p from '../g2/ble-protocol' +import { iosBluetooth } from './ios-bluetooth' +import type { FlashPromptBattery, FlashPromptState } from './flash-prompt-communicator' +export type { FlashPromptBattery, FlashPromptState } from './flash-prompt-communicator' + +export class FlashPromptCommunicator { + private logs = new Set<(line: string) => void>() + private states = new Set<(state: FlashPromptState, detail: string) => void>() + private results = new Set<(approved: boolean) => void>() + private batteries = new Set<(battery: FlashPromptBattery) => void>() + private link = new StockConnection(iosBluetooth(), line => { for (const fn of this.logs) fn(line) }) + private closed = false + private started = false + private heartbeat: ReturnType | null = null + private stopSelection: (() => void) | null = null + constructor(private addresses: { right: string; left: string }, private warning: string, private options?: { skipPrompt?: boolean }) {} + onLog(fn: (line: string) => void): () => void { this.logs.add(fn); return () => this.logs.delete(fn) } + onStateChange(fn: (state: FlashPromptState, detail: string) => void): () => void { this.states.add(fn); return () => this.states.delete(fn) } + onResult(fn: (approved: boolean) => void): () => void { this.results.add(fn); return () => this.results.delete(fn) } + onBattery(fn: (battery: FlashPromptBattery) => void): () => void { this.batteries.add(fn); return () => this.batteries.delete(fn) } + private state(state: FlashPromptState, detail = ''): void { for (const fn of this.states) fn(state, detail) } + start(): void { if (!this.started) { this.started = true; void this.run() } } + private async run(): Promise { + try { + this.state('connecting') + await this.link.resolve({ ...this.addresses, ring: '' }) + // Complete pairing for one peripheral before starting the other. + for (const role of ['right', 'left']) { + await this.link.connect(role) + if (role === 'right') this.state('connected') + await this.link.authenticate(role) + } + await this.link.request('right', p.SID.launch, p.prelude, 3500, 156) + if (!this.options?.skipPrompt) { + // Listen before creating the page: an immediate tap may precede its ACK. + const selection = this.selection() + // Attach a rejection handler immediately, even while create-page is pending. + void selection.catch(() => {}) + for (let attempt = 0; ; attempt++) { + try { await this.link.request('right', p.SID.hub, magic => createFlashPrompt(magic, this.warning)); break } + catch (error) { this.link.check(); if (attempt) throw error } + } + this.state('prompting') + this.heartbeat = setInterval(() => { + void this.link.write('right', p.SID.hub, p.heartbeat(this.link.nextMagic())).catch(error => { + if (!this.closed) this.state('error', String(error.message ?? error)) + this.close() + }) + }, 4000) + const approved = await selection + this.stopHeartbeat() + // Stock shutdown returns the glasses to their normal UI before OTA. + await this.link.write('right', p.SID.hub, p.concat(p.integer(1, 9), p.integer(2, this.link.nextMagic()), p.bytes(11, p.integer(1, 0)))) + if (!approved) { for (const fn of this.results) fn(false); return } + } + this.state('battery') + const battery: FlashPromptBattery = { right: null, left: null } + for (const role of ['right', 'left'] as const) { + for (let attempt = 0; attempt < 2; attempt++) { + try { + const message = await this.link.request(role, p.SID.settings, p.settingsQuery) + const values = p.readBytes(message.payload, 4), value = values ? p.readInteger(values, 12, -1) : -1 + if (value >= 0 && value <= 100) { battery[role] = value; break } + } catch (error) { this.link.check() } + } + } + for (const fn of this.batteries) fn(battery) + for (const fn of this.results) fn(true) + } catch (error) { if (!this.closed) this.state('error', String((error as Error).message ?? error)) } + finally { this.close() } + } + private selection(): Promise { + return new Promise((resolve, reject) => { + const cleanup = () => { clearTimeout(timer); off(); this.stopSelection = null } + const off = this.link.onMessage((role, message) => { + const result = role === 'right' ? flashPromptSelection(message) : null + if (result !== null) { cleanup(); resolve(result) } + }) + const timer = setTimeout(() => { cleanup(); reject(new Error('No response from the glasses.')) }, 120_000) + this.stopSelection = () => { cleanup(); reject(new Error('Cancelled.')) } + }) + } + private stopHeartbeat(): void { if (this.heartbeat) clearInterval(this.heartbeat); this.heartbeat = null } + cancel(): void { this.close() } + close(): void { this.closed = true; this.stopHeartbeat(); this.stopSelection?.(); this.link.close() } +} diff --git a/app/phone-ui/config-page-shared.ts b/app/phone-ui/config-page-shared.ts new file mode 100644 index 00000000..301d0039 --- /dev/null +++ b/app/phone-ui/config-page-shared.ts @@ -0,0 +1,13 @@ +import { NavigatedData, Page } from "@nativescript/core"; + +import { ConfigViewModel } from "./config-view-model"; + +export function navigatingTo(args: NavigatedData): void { + const page = args.object as Page; + // Preserve the model across back-navigation (returning from the firmware + // check page) so the onboarding "Continue" flow isn't lost. + if (!page.bindingContext) { + const context = (args.context as { onboarding?: boolean } | undefined) ?? undefined; + page.bindingContext = new ConfigViewModel({ onboarding: context?.onboarding ?? false }); + } +} diff --git a/app/phone-ui/config-page.ios.ts b/app/phone-ui/config-page.ios.ts index 7099ccbf..b242bfe6 100644 --- a/app/phone-ui/config-page.ios.ts +++ b/app/phone-ui/config-page.ios.ts @@ -1,68 +1 @@ -import { Button, Color, GridLayout, Label, Page, ScrollView, StackLayout, TextField } from '@nativescript/core' -import { loadDeviceAddresses, normalizeMacAddress, saveDeviceAddresses } from '../g2/device-addresses' -import { deviceAddressError, type IosDevice } from '../g2/ios-peripheral-identity' -import { iosBluetooth } from '../native/ios-bluetooth' - -export function createConfigureDevicesPage(): Page { - const page = new Page(); page.actionBarHidden = true - const root = new GridLayout(); root.rows = 'auto,*,auto'; root.padding = 16; page.content = root - const title = new Label(); title.text = 'Configure devices'; title.fontSize = 24; title.fontWeight = 'bold'; root.addChild(title) - const scroll = new ScrollView(); GridLayout.setRow(scroll, 1); root.addChild(scroll) - const form = new StackLayout(); scroll.content = form - const text = (value: string, size = 15) => { - const label = new Label(); label.text = value; label.fontSize = size; label.textWrap = true; label.marginTop = 12; form.addChild(label); return label - } - text('Enter the G2 arm MAC addresses and optional R1 ring address. Scan once so this iPhone can find the matching devices. Saving does not connect.') - const stored = loadDeviceAddresses() - const fields = {} as Record<'left' | 'right' | 'ring', TextField> - for (const role of ['right', 'left', 'ring'] as const) { - text(role === 'ring' ? 'R1 ring MAC (optional)' : `${role === 'left' ? 'Left' : 'Right'} arm MAC`) - const field = new TextField(); field.text = stored[role]; field.hint = 'AA:BB:CC:DD:EE:FF' - field.autocorrect = false; field.autocapitalizationType = 'allcharacters'; field.fontSize = 18 - field.padding = 10; field.backgroundColor = new Color('#ffffff'); field.accessibilityLabel = `${role} MAC address` - field.accessibilityIdentifier = `device-address-${role}`; form.addChild(field); fields[role] = field - } - const status = text('Addresses are saved only when you tap Save.'); status.color = new Color('#285c45') - const button = (label: string, action: () => void) => { - const view = new Button(); view.text = label; view.fontSize = 15; view.marginTop = 12; view.on('tap', action); return view - } - let off: (() => void) | null = null - let closed = false - const found = new StackLayout() - const rows = new Map() - const showDevice = (device: IosDevice) => { - if (device.connectable === false) return - let row = rows.get(device.address) - if (!row) { - row = button('', () => { fields[device.role].text = device.address; status.text = `${device.role} address selected. Tap Save to keep it.` }) - row.textWrap = true; row.fontSize = 13; rows.set(device.address, row); found.addChild(row) - } - row.text = `${device.role === 'ring' ? 'Ring' : device.role === 'left' ? 'Left arm' : 'Right arm'} · ${device.address}\n${device.serial || device.name} · ${device.rssi ?? '?'} dBm` - } - const scan = button('Scan for devices', () => { - for (const field of Object.values(fields)) field.dismissSoftInput() - const ble = iosBluetooth() - off?.(); off = ble.onEvent(event => { - if (closed) return - if (event.kind === 'device' && 'device' in event) showDevice(event.device) - if (event.kind === 'scan-stopped') { scan.isEnabled = true; status.text = rows.size ? 'Tap a device to fill its address, then Save.' : 'No matching devices found. Wake the glasses and disconnect other apps, then scan again.' } - }) - rows.clear(); found.removeChildren(); scan.isEnabled = false; status.text = 'Scanning… Allow Bluetooth if iOS asks.' - void ble.startScan().catch(error => { if (!closed) { status.text = String(error.message ?? error); scan.isEnabled = true } }) - }) - form.addChild(scan); form.addChild(found) - const footer = new GridLayout(); footer.columns = '*,*'; GridLayout.setRow(footer, 2); root.addChild(footer) - const close = () => { closed = true; off?.(); off = null; iosBluetooth().stopScan(); page.closeModal() } - const back = button('Back', close); footer.addChild(back) - const save = button('Save', () => { - const addresses = { right: normalizeMacAddress(fields.right.text), left: normalizeMacAddress(fields.left.text), ring: normalizeMacAddress(fields.ring.text) } - const error = deviceAddressError(addresses) - if (error) { status.text = error; return } - saveDeviceAddresses(addresses) - for (const role of ['left', 'right', 'ring'] as const) { fields[role].text = addresses[role]; fields[role].dismissSoftInput() } - status.text = 'Saved device addresses. Return to the main screen and choose Connect.' - }) - GridLayout.setColumn(save, 1); footer.addChild(save) - page.on('unloaded', () => { closed = true; off?.(); off = null; iosBluetooth().stopScan() }) - return page -} +export { navigatingTo } from "./config-page-shared"; diff --git a/app/phone-ui/config-page.ts b/app/phone-ui/config-page.ts index 301d0039..b242bfe6 100644 --- a/app/phone-ui/config-page.ts +++ b/app/phone-ui/config-page.ts @@ -1,13 +1 @@ -import { NavigatedData, Page } from "@nativescript/core"; - -import { ConfigViewModel } from "./config-view-model"; - -export function navigatingTo(args: NavigatedData): void { - const page = args.object as Page; - // Preserve the model across back-navigation (returning from the firmware - // check page) so the onboarding "Continue" flow isn't lost. - if (!page.bindingContext) { - const context = (args.context as { onboarding?: boolean } | undefined) ?? undefined; - page.bindingContext = new ConfigViewModel({ onboarding: context?.onboarding ?? false }); - } -} +export { navigatingTo } from "./config-page-shared"; diff --git a/app/phone-ui/config-page.xml b/app/phone-ui/config-page.xml index cffe6f9e..d1b7288d 100644 --- a/app/phone-ui/config-page.xml +++ b/app/phone-ui/config-page.xml @@ -16,21 +16,21 @@ -

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