UNA Watch Documentation

Welcome to the official UNA Watch SDK documentation hub. This platform enables developers to create high-performance applications for the UNA Watch ecosystem.

The UNA Watch architecture is unique: apps run as pure machine code directly in the MCU memory, leveraging position-independent code (PIC) and a shared libc library for maximum efficiency and abstraction from the kernel.

🚀 Getting Started

• Platform Overview
  • Unique architecture
  • Platform Architecture
    • Core Concepts
      • Pure Machine Code Execution
      • Position-Independent Code (PIC)
      • Shared libc Integration
      • Dual-Process Model
      • IPC Mechanisms
      • Memory Management
      • Power Management
  • Next Steps
• SDK Setup and Build Overview
  • Prerequisites
  • Toolchain Setup
    • Linux Setup
      • Get required software
      • Prepare
      • Copy and Build an Existing Example
      • Optional (Linux)
    • Windows Setup
      • Get required software
      • Prepare
      • Copy and Build an Existing Example
      • Troubleshooting Windows Setup
  • CMake-Based Workflow Development
    • Examples/ Project Structure Overview
    • CMake Command Explanations
    • Creating New Apps
    • Building Apps Manually
  • Alternative Workflow: STM32CubeIDE
    • Creating New Apps in CubeIDE
  • TouchGFX (Windows-only for Designer)
    • Installation
    • Using TouchGFX Designer for Visual Editing
    • Integration with CMake
    • Modifying Generated Code Safely
  • Troubleshooting
• UNA-Watch Simulator
  • Getting Started
    • Need Components
    • Install UNA_SDK variable {#install-una-sdk-variable}
    • Start Simulator
      • TouchGFX Designer
      • Visual Studio
    • Simulation
      • Buttons
      • Buzzer
      • Backlight
      • Vibro
      • Sensors
    • Include Header & Source file
      • MSVS
      • GCC
    • Transfer Application {#transfer-application}

🧩 Tutorials

• HelloWorld - Introduction to UNA App Architecture
  • What You’ll Learn
  • Getting Started
    • Prerequisites
    • Building and Running HelloWorld
    • Running on Simulator
    • Working with TouchGFX GUI (Optional)
  • HelloWorld App Overview
    • The Service Layer (Backend)
    • The GUI Layer (Frontend)
    • Communication Between Layers
  • Understanding the Commented Code
  • Understanding UNA App Communication
    • SDK Custom Messages (Service → GUI)
    • AppTypes Events (GUI → Service)
  • Common Patterns and Best Practices
    • Sensor Integration
    • Message Design
    • GUI Updates
    • File Operations
  • Next Steps
  • Troubleshooting
    • Build Issues
    • Runtime Issues
    • Common Mistakes
• Buttons - Handling User Input and Navigation
  • What You’ll Learn
  • Getting Started
    • Prerequisites
    • Building and Running Buttons
    • Running on Simulator
  • Buttons App Overview
    • Navigation Flow
    • Architecture Components
      • The Service Layer (Backend)
      • The GUI Layer (Frontend)
      • Button Event Handling
      • Screen Updates
  • Buttons app creation process
  • Understanding Button Event Handling
    • Button Event Processing
    • Screen State Management
    • Exit Handling
  • Common Patterns and Best Practices
    • Button Handling
    • UI Updates
    • Code Organization
    • Performance Considerations
  • Key Code Insights for New Developers
    • MainView.cpp Structure
    • Button Configuration
    • State Tracking
  • Next Steps
  • Troubleshooting
    • Build Issues
    • Runtime Issues
    • Common Mistakes
• ScrollMenu - Creating Scrollable Lists and Menus
  • What You’ll Learn
  • Getting Started
    • Prerequisites
    • Building and Running ScrollMenu
    • Running on Simulator
  • ScrollMenu App Overview
    • Navigation Flow
    • Architecture Components
      • The Service Layer (Backend)
      • The GUI Layer (Frontend)
      • Button Event Handling
      • Menu Item Management
      • Screen Updates
  • ScrollMenu app creation process
  • Understanding Menu Navigation
    • Button Event Processing
    • Menu State Management
    • Exit Handling
  • Common Patterns and Best Practices
    • Button Handling
    • UI Updates
    • Code Organization
    • Performance Considerations
  • Key Code Insights for New Developers
    • MainView.cpp Structure
    • Menu Configuration
    • State Tracking
  • Next Steps
  • Troubleshooting
    • Build Issues
    • Runtime Issues
    • Common Mistakes
• Images - Working with Graphics and Assets
  • What You’ll Learn
  • Getting Started
    • Prerequisites
    • Building and Running Import Images
    • Running on Simulator
  • Images App Overview
    • Key Features Demonstrated
    • The Asset Pipeline
    • The GUI Layer (Frontend)
    • Image Management in UNA SDK
  • Image Import Process
    • Step 1: Create Your Image Asset
    • Step 2: Import into TouchGFX Designer
    • Step 3: Display the Image in Code
    • Step 4: Build and Test
  • Code Details
    • Understanding Bitmap IDs
    • Using Images in TouchGFX Widgets\n\nSuggested additional screenshots:\n- Static scaled image display\n- Image during custom jump animation (triggered by R1 button)\n- Toggle between scaled and animated modes\n\n
    • Image Memory Management
  • Best Practices
    • Image Creation
    • Import Optimization
    • Performance Considerations
    • File Organization
  • Next Steps
  • Troubleshooting
    • Import Issues
    • Display Problems
    • Build Errors
    • Performance Issues
• Sensors - Integrating Hardware Sensors
  • List of Implemented Sensors
  • Architecture Overview
  • Implementation Steps
    • Step 1: Define Custom Messages
    • Step 2: Service - Subscribe & Process Sensors
    • Step 3: GUI Model - Receive Messages
    • Step 4: MainView - Display & Controls
    • Additional Notes
    • Running on Simulator
• Files - Data Persistence and File Operations
  • Overview
  • Getting Started
    • Prerequisites
    • Building and Running Files
    • Running on Simulator
  • Settings System Architecture
    • Settings Data Model
      • 1. Decimal Counter (Float-based Setting)
      • 2. Activity Type (Enumeration Setting)
      • 3. Display Mode (Enumeration Setting)
    • JSON File Format
  • Message Passing System
    • Custom Message Types
      • GET_SETTINGS (0x00000002)
      • SET_SETTINGS (0x00000003)
      • SETTINGS_VALUES (0x00000004)
    • Message Flow Architecture
  • Service Layer Implementation
    • Service Class Structure
    • Settings File Operations
      • Loading Settings (loadSettings())
      • Saving Settings (saveSettings())
    • Message Handling in Service
  • GUI Layer Implementation
    • Model-View-Presenter Architecture
    • Model Implementation
      • Message Sending
      • Message Receiving
    • Presenter Implementation
    • View Implementation
      • Initialization
      • Settings Display Update
      • Button Event Handling
  • Button Control Scheme
    • Setting Selection Flow
  • Build System Integration
    • CMake Configuration
  • Error Handling and Recovery
    • File System Errors
    • Message Communication Errors
    • Data Validation
  • Key Learning Concepts
    • 1. Persistent Storage
    • 2. Inter-Process Communication
    • 3. MVP Architecture
    • 4. Error Recovery
    • 5. User Experience
  • Extension Points
• FitFiles - FIT File Creation and Sensor Logging Tutorial
  • Overview
  • Architecture
    • High-Level Components
    • Component Interaction
    • App Workflow
  • Service Backend
    • Core Classes and Structures
      • Service Class
      • Key Data Structures
    • Sensor Integration
    • Data Processing Pipeline
      • 1. Sensor Data Reception
      • 2. Session Management
      • 3. FIT File Creation and Management
      • 4. Custom Developer Fields
      • 4. Session and Activity Management
    • Data Persistence Strategy
      • FIT File Writing Process
      • Data Persistence Strategy
      • FIT File Writing Process
  • Glance UI Implementation
    • UI Components
    • Message Handling
  • Sensor Integration
    • Heart Rate and Step Counter Sensors
    • Sensor Data Flow
  • FIT File Format Implementation
    • FIT Protocol Overview
    • Message Types Used
    • Custom Developer Fields
  • Build and Setup
    • Build Configuration
    • Build Targets
    • Dependencies
  • Key Concepts Demonstrated
    • FIT File Creation
    • Sensor Data Logging
    • Session Management
    • File System Integration
  • Next Steps

📱 Example Apps

• Running - Fitness Tracking
  • Overview
  • Architecture
    • High-Level Components
    • Component Interaction
  • Service Backend
    • Core Classes and Structures
      • Service Class
      • Key Data Structures
    • Sensor Integration
    • Data Processing Pipeline
      • 1. Sensor Data Reception
      • 2. Data Filtering and Validation
      • 3. Counter System Architecture
      • 4. Track Processing Logic
      • 5. FIT File Recording
    • Activity State Management
    • Lap Management
    • Settings and Persistence
    • Activity Data Management and Persistence
      • FIT File Format Implementation
      • Activity Summary Persistence
      • Settings Persistence
      • File System Integration
      • Data Synchronization
  • GUI Implementation
    • Model-View-Presenter Pattern
    • Key GUI Components
      • Model Class
      • View Classes
    • Message Handling System
    • Screen Navigation and State Management
    • Custom Containers Implementation
    • Input Handling Architecture
    • Data Formatting and Units
    • Idle Timeout Management
    • User Interaction
    • Data Display
  • Sensor Integration
    • GPS Integration
    • Physiological Sensors
    • System Sensors
    • Sensor Data Processing Architecture
      • Parser Classes
      • Advanced Filtering Techniques
      • Counter System Implementation
      • Sensor Sampling Strategy
      • Error Handling and Data Validation
      • Power Management Integration
    • Sensor Connection Management
  • TouchGFX Port
    • TouchGFX Project Structure
    • GUI Architecture
    • TouchGFX Integration with UNA SDK
      • TouchGFXCommandProcessor
      • Kernel Provider Architecture
      • Custom Message System
      • Message Sender Classes
    • Asset Management
    • Code Generation
    • Simulator Support
  • Build and Setup
    • Build System Overview
    • Build Targets
    • Dependencies
    • Build Process
    • Development Setup
    • Simulator Build
  • Conclusion
• Alarm - Alarm Clock
  • Overview
  • Architecture
    • High-Level Components
    • Component Interaction
  • Service Backend
    • Core Classes and Structures
      • Service Class
      • Key Data Structures
    • Alarm Management
      • Time Monitoring and Alarm Checking
      • Snooze Management
    • Data Processing Pipeline
      • 1. Alarm List Management
      • 2. JSON Serialization
      • 3. File System Integration
    • Activity State Management
    • Settings and Persistence
  • GUI Implementation
    • Model-View-Presenter Pattern
    • Key GUI Components
      • Model Class
      • View Classes
    • Message Handling System
    • Screen Navigation and State Management
    • Custom Containers Implementation
    • Input Handling Architecture
    • Data Formatting and Units
  • Build and Setup
    • Build System Overview
    • Build Targets
    • Dependencies
    • Development Setup
    • Simulator Build
  • Conclusion
• Cycling - Cycling Activity Tracking
  • Overview
  • Architecture
    • High-Level Components
    • Component Interaction
  • Service Backend
    • Core Classes and Structures
      • Service Class
      • Key Data Structures
    • Sensor Integration
    • Data Processing Pipeline
      • 1. Sensor Data Reception
      • 2. Data Filtering and Validation
      • 3. Counter System Architecture
      • 4. Track Processing Logic
      • 5. FIT File Recording
    • Activity State Management
    • Lap Management
    • Settings and Persistence
    • Activity Data Management and Persistence
      • FIT File Format Implementation
      • Activity Summary Persistence
      • Settings Persistence
      • File System Integration
      • Data Synchronization
  • GUI Implementation
    • Model-View-Presenter Pattern
    • Key GUI Components
      • Model Class
      • View Classes
    • Message Handling System
    • Screen Navigation and State Management
    • Custom Containers Implementation
    • Input Handling Architecture
    • Data Formatting and Units
    • Idle Timeout Management
    • User Interaction
    • Data Display
  • Sensor Integration
    • GPS Integration
    • Physiological Sensors
    • System Sensors
    • Sensor Data Processing Architecture
      • Parser Classes
      • Advanced Filtering Techniques
      • Counter System Implementation
      • Sensor Sampling Strategy
      • Error Handling and Data Validation
      • Power Management Integration
    • Sensor Connection Management
  • TouchGFX Port
    • TouchGFX Project Structure
    • GUI Architecture
    • TouchGFX Integration with UNA SDK
      • TouchGFXCommandProcessor
      • Kernel Provider Architecture
      • Custom Message System
      • Message Sender Classes
    • Asset Management
    • Code Generation
    • Simulator Support
  • Build and Setup
    • Build System Overview
    • Build Targets
    • Dependencies
    • Build Process
    • Development Setup
    • Simulator Build
  • Conclusion
• Hiking - Hiking Activity Tracking
  • Overview
  • Architecture
    • High-Level Components
    • Component Interaction
  • Service Backend
    • Core Classes and Structures
      • Service Class
      • Key Data Structures
    • Sensor Integration
    • Data Processing Pipeline
      • 1. Sensor Data Reception
      • 2. Data Filtering and Validation
      • 3. Counter System Architecture
      • 4. Track Processing Logic
      • 5. FIT File Recording
    • Activity State Management
    • Lap Management
    • Settings and Persistence
    • Activity Data Management and Persistence
      • FIT File Format Implementation
      • Activity Summary Persistence
      • Settings Persistence
      • File System Integration
      • Data Synchronization
  • GUI Implementation
    • Model-View-Presenter Pattern
    • Key GUI Components
      • Model Class
      • View Classes
    • Message Handling System
    • Screen Navigation and State Management
    • Custom Containers Implementation
    • Input Handling Architecture
    • Data Formatting and Units
    • Idle Timeout Management
    • User Interaction
    • Data Display
  • Sensor Integration
    • GPS Integration
    • Physiological Sensors
    • Activity Sensors
    • System Sensors
    • Sensor Data Processing Architecture
      • Parser Classes
      • Advanced Filtering Techniques
      • Counter System Implementation
      • Sensor Sampling Strategy
      • Error Handling and Data Validation
      • Power Management Integration
    • Sensor Connection Management
  • TouchGFX Port
    • TouchGFX Project Structure
    • GUI Architecture
    • TouchGFX Integration with UNA SDK
      • TouchGFXCommandProcessor
      • Kernel Provider Architecture
      • Custom Message System
      • Message Sender Classes
    • Asset Management
    • Code Generation
    • Simulator Support
  • Build and Setup
    • Build System Overview
    • Build Targets
    • Dependencies
    • Build Process
    • Development Setup
    • Simulator Build
  • Conclusion
• HRMonitor - Heart Rate Monitor
  • Overview
  • Architecture
    • High-Level Components
    • Component Interaction
  • Service Backend
    • Core Classes and Structures
      • Service Class
      • Key Data Structures
    • Sensor Integration
    • Data Processing Pipeline
      • 1. Sensor Data Reception
      • 2. Data Validation and Filtering
      • 3. FIT File Recording
    • Activity State Management
    • Settings and Persistence
  • GUI Implementation
    • Model-View-Presenter Pattern
    • Key GUI Components
      • Model Class
      • View Classes
    • Message Handling System
    • Screen Navigation and State Management
    • Custom Containers Implementation
    • Input Handling Architecture
    • Data Formatting and Units
  • Sensor Integration
    • Heart Rate Sensor
    • Sensor Data Processing Architecture
      • Parser Classes
      • Data Validation
      • Sensor Sampling Strategy
  • TouchGFX Port
    • TouchGFX Project Structure
    • GUI Architecture
    • TouchGFX Integration with UNA SDK
      • Custom Message System
      • Message Sender Classes
    • Asset Management
  • Build and Setup
    • Build System Overview
    • Build Targets
    • Dependencies
    • Development Setup
    • Simulator Build
  • Conclusion
• GlanceHR - Heart Rate Glance
  • Overview
  • Architecture
    • High-Level Components
    • Component Interaction
  • Service Backend
    • Core Classes and Structures
      • Service Class
      • Key Data Structures
    • Sensor Integration
    • Data Processing Pipeline
      • 1. Sensor Data Reception
      • 2. Data Validation and Filtering
      • 3. Glance Update Logic
    • Activity State Management
    • Glance UI Management
    • Settings and Configuration
  • Sensor Integration
    • Heart Rate Sensor
    • Sensor Data Processing Architecture
      • Parser Classes
      • Data Validation
      • Sensor Sampling Strategy
      • Error Handling and Data Validation
    • Glance Framework Integration
      • Glance Message System
      • Control Types
    • Message Handling System
  • Build and Setup
    • Build System Overview
    • Build Targets
    • Dependencies
    • Build Process
    • Development Setup
  • Conclusion
• GlanceSteps - Step Counter Glance
  • Overview
  • Architecture
    • High-Level Components
    • Component Interaction
  • Service Backend
    • Core Classes and Structures
      • Service Class
      • Key Data Structures
    • Sensor Integration
    • Data Processing Pipeline
      • 1. Sensor Data Reception
      • 2. Data Validation and Filtering
      • 3. Glance Update Logic
    • Activity State Management
    • Glance UI Management
    • Settings and Configuration
  • Sensor Integration
    • Step Counter Sensor
    • Sensor Data Processing Architecture
      • Parser Classes
      • Data Validation
      • Sensor Sampling Strategy
      • Error Handling and Data Validation
    • Glance Framework Integration
      • Glance Message System
      • Control Types
    • Message Handling System
  • Build and Setup
    • Build System Overview
    • Build Targets
    • Dependencies
    • Build Process
    • Development Setup
  • Conclusion
• GlanceStrain - Daily Strain Logger
  • Problem Statement
  • Logic Flow Diagram
  • Program Architecture
    • 1) Kernel entry and service lifetime
    • 2) Kernel message loop
    • 3) UI layer (Glance)
    • 4) Sensor layer
    • 5) Core strain logic
    • 6) Persistence (FIT)
  • Implementation Walktrought
  • Common vs App-Specific Components
    • Common services and patterns (shared across glance apps)
    • GlanceStrain-specific services and logic
  • App ↔ Kernel Interaction / Execution Path
  • Key Interfaces and Data Structures
  • Behavior Details
    • Logging cadence
    • Persistence and recovery
    • Gating rules

🏗️ Architecture

• SDK Overview
  • Key Components
  • SDK Setup and Build Reference
  • SDK Project Structure
    • High-Level Utilities
      • GSModel & GSBridge (GUI-Service Communication)
      • Glance UI System
      • FitHelper (Fitness Data)
      • TrackMapBuilder (GPS Visualization)
      • Serialization (CBOR & JSON)
      • Signal Processing & Tools
    • App Merging Script (app_merging.py)
    • Build Integration Scripts
  • SDK Interfaces
    • IAppComm (Communication Interface)
    • ISystem (System Services Interface)
    • IFileSystem (Storage Interface)
    • ILogger (Debugging Interface)
    • ISensorManager (Sensor Interface)
    • IGlance (Glance Application Interface)
    • Message System Architecture
      • Message Types and Ranges
      • Key System Messages
      • Message Processing Pattern
  • Simulator Environment
    • Simulator Features
    • Simulator Architecture
    • Development Workflow with Simulator
  • Third-Party Libraries & Standard Library
    • Core Components
    • Integration Points
  • Development Best Practices
    • Memory Management
    • Performance Optimization
    • Error Handling
    • Testing
  • SDK Version Compatibility
    • Versioning Scheme
• Sensor Layer
  • Overview
  • Sensor Types
  • Connection API
  • Data Reception & Processing
  • Sensors
    • ACCELEROMETER (0x10)
    • ACCELEROMETER_RAW (0x11)
    • HEART_RATE (0x41)
    • HEART_RATE_METRICS (0x42)
    • STEP_DETECTOR (0x50)
    • STEP_COUNTER (0x51)
    • FLOOR_COUNTER (0x60)
    • AMBIENT_TEMPERATURE (0x70)
    • PRESSURE (0x80)
    • ALTIMETER (0x90)
    • WRIST_MOTION (0xA0)
    • MOTION_DETECT (0xB0)
    • ACTIVITY_RECOGNITION (0xC0)
    • ACTIVITY (0xE0)
    • GPS_LOCATION (0x110)
    • GPS_SPEED (0x111)
    • GPS_DISTANCE (0x112)
    • BATTERY_LEVEL (0x120)
    • BATTERY_CHARGING (0x121)
    • BATTERY_METRICS (0x122)
    • TOUCH_DETECT (0x140)
  • Workflow Diagram
  • Example: Multi-Sensor Service
  • Additional Messages
  • Full Example
• Platform Architecture
  • Core Concepts
    • Pure Machine Code Execution
    • Position-Independent Code (PIC)
    • Shared libc Integration
    • Dual-Process Model
    • IPC Mechanisms
    • Memory Management
    • Power Management
  • Technical Architecture Details
    • Detailed Implementation Analysis
      • 1. Backend Core Implementation (Backend.cpp)
      • Backend Event Processing Flow
      • Backend Interface Architecture
      • Backend State Management
      • Backend Communication Patterns
      • 3. Component Factory Implementation (ComponentFactory.cpp)
      • Hardware Component Detection Flow
      • Component Factory Interface Architecture
      • Component Lifecycle and Error Recovery
      • I2C Bus Probing and Component Identification
      • 4. Sensor Layer Implementation (SensorManager.cpp)
      • Sensor Resource Arbitration Architecture
      • Sensor Data Pipeline and Processing Flow
      • Sensor Error Handling and Recovery Mechanisms
      • Sensor Performance Monitoring and Optimization
      • 5. Settings Management Implementation (SettingsManager.cpp)
      • Settings Persistence and Recovery Flow
      • Settings Configuration State Machine
      • Settings Access Patterns and Concurrency
      • Settings Migration and Version Compatibility
      • 6. File System Implementation (FileSystem.cpp)
      • Multi-Volume File System Architecture
      • File System Operations Flow
      • Thread-Safe File Access State Machine
      • File System Error Recovery and Factory Reset Flow
      • Time Zone and DST Handling Architecture
    • System Initialization Sequence
      • Sequence Diagram: Detailed Backend Thread Initialization
      • System Initialization Flow
    • System Initialization from Multiple Perspectives
      • 1. Thread Perspective: RTOS Task Initialization
      • 2. Component Dependency Perspective: Initialization Order
      • 3. Timing Perspective: Initialization Timeline
      • 4. Memory Perspective: Allocation During Initialization
      • 5. Error Handling Perspective: Fault Recovery During Init
      • 6. Power Management Perspective: Energy During Initialization
      • 7. Data Flow Perspective: Information Movement During Init
    • Memory Management Patterns
    • Error Handling & Robustness
    • Core System Architecture
      • Backend Class Inheritance Diagram
      • 8. BLE Service Stack
      • BLE Service Architecture
      • 9. Settings Management (SettingsManagerBase.hpp)
      • 10. Power Management System
      • Power Management State Machine
    • System Initialization Sequence
    • Key Design Patterns
    • Static Component Architecture
      • Data Flow: User Input to App Response
• Development Workflow
  • Workflow Stages
    • 1. Planning
    • 2. Development
    • 3. Building
    • 4. Testing
    • 5. Debugging
    • 6. Packaging
    • 7. Deployment
    • 8. Maintenance
  • Technical Architecture Details
    • Application Framework Implementation
      • Application Framework Dual-Process Architecture
      • Dynamic Loading and Memory Management Flow
      • Application Message Processing Architecture
      • Sensor Integration and Data Flow
  • App Development Framework
    • App Architecture & Lifecycle
      • App Lifecycle & Management
    • SDK Interfaces for App Development
    • Message System Architecture
    • Sensor Layer Integration
      • Sensor Data Flow Architecture
    • App Development Workflow
    • App Capabilities System
    • App Deployment
      • App Development Data Flow
    • Building Individual Apps
    • App Installation
• Scripts
  • Script Usage Overview
  • Script: Utilities/Scripts/app_merging/app_merging.py {#script-utilities-scripts-app_merging-app_merging-py}
    • Overview
    • Purpose
    • Functionality
    • How It Works
    • Key Parameters
    • Dependencies
    • Usage Examples
    • Error Handling
    • Integration Context
  • Script: Utilities/Scripts/app_packer/app_packer.py {#script-utilities-scripts-app_packer-app_packer-py}
    • Overview
    • Purpose
    • Functionality
    • How It Works
    • Key Parameters
    • Dependencies
    • Usage Examples
    • Error Handling
    • Integration Context
  • Script: Utilities/Scripts/png2abgr2222/png2abgr2222.py {#script-utilities-scripts-png2abgr2222-png2abgr2222-py}
    • Overview
    • Purpose
    • Functionality
    • How It Works
    • Key Parameters
    • Dependencies
    • Usage Examples
    • Error Handling
    • Integration Context
  • Script: Utilities/Scripts/export-stm32-tools.ps1 {#script-utilities-scripts-export-stm32-tools-ps1}
    • Overview
    • Purpose
    • Functionality
    • How It Works
    • Key Parameters
    • Dependencies
    • Usage Examples
    • Error Handling
    • Integration Context
  • Script: Utilities/Scripts/build-cube/una-version.sh {#script-utilities-scripts-build-cube-una-version-sh}
    • Overview
    • Purpose
    • Functionality
    • How It Works
    • Key Parameters
    • Dependencies
    • Usage Examples
    • Error Handling
    • Integration Context
  • Script: Utilities/Scripts/build-cube/find-cube.sh {#script-utilities-scripts-build-cube-find-cube-sh}
    • Overview
    • Purpose
    • Functionality
    • How It Works
    • Key Parameters
    • Dependencies
    • Usage Examples
    • Error Handling
    • Integration Context
  • Script: Utilities/Scripts/build-cube/build-cube.sh {#script-utilities-scripts-build-cube-build-cube-sh}
    • Overview
    • Purpose
    • Functionality
    • How It Works
    • Key Parameters
    • Dependencies
    • Usage Examples
    • Error Handling
    • Integration Context
  • Script: Utilities/Scripts/build-cube/setup-environment.sh {#script-utilities-scripts-build-cube-setup-environment-sh}
    • Overview
    • Purpose
    • Functionality
    • How It Works
    • Key Parameters
    • Dependencies
    • Usage Examples
    • Error Handling
    • Integration Context
  • Script: .github/scripts/generate-tutorials-app-list.py {#script-github-scripts-generate-tutorials-app-list-py}
    • Overview
    • Purpose
    • Functionality
    • How It Works
    • Key Parameters
    • Dependencies
    • Usage Examples
    • Error Handling
    • Integration Context
  • Script: Examples/.github/scripts/generate-app-list.py {#script-examples-github-scripts-generate-app-list-py}
    • Overview
    • Purpose
    • Functionality
    • How It Works
    • Key Parameters
    • Dependencies
    • Usage Examples
    • Error Handling
    • Integration Context
• TouchGFX Port Architecture
  • Table of Contents
  • Overview
  • Definitions and Terminology
  • Structural Architecture
    • Class Hierarchy
    • Key Classes and Interfaces
      • TouchGFXHAL
      • TouchGFXCommandProcessor
      • HWButtonController
      • Generated and Stub Classes
    • Data Structures
  • API Structure
    • Public Interfaces
      • TouchGFXHAL
      • TouchGFXCommandProcessor
    • Configuration Functions
    • Key Relationships
    • Design Patterns
      • Singleton Pattern
      • Adapter Pattern
      • Template Method Pattern
      • Observer Pattern
      • Bridge Pattern
  • Behavioral Architecture
    • Initialization Flow
    • Rendering Flow
    • Input Handling
    • Lifecycle Management
    • Data Flows
      • Rendering Data Flow
      • Input Data Flow
      • Lifecycle Data Flow
      • VSync Synchronization
    • Advanced Configuration
  • Error Handling and Debugging
    • Common Issues and Troubleshooting
    • Debugging Techniques
    • Error Codes and Messages
  • Extensibility and Customization Guide
    • Adding Future Hardware Support
    • Custom Message Handling
    • Button Customization
    • Display Configuration
  • UNA-Specific System Integration Points
    • Overall Architecture Characteristics
      • Hardware Configuration
      • Performance Characteristics
      • Integration Approach
      • Extensibility Features
      • Limitations and Constraints
    • Core Integration Components
      • TouchGFXCommandProcessor
      • Kernel Message Processing
      • Hardware Abstraction Layer Extensions
      • Operating System Wrappers
    • Application Lifecycle Management
      • Lifecycle Callbacks
      • Custom Message Handling
    • Performance Implications and Optimizations
      • Memory Management
      • Synchronization Optimizations
      • Error Handling and Recovery
    • Additional Integration Points
      • Memory Management Integration
      • Error Handling and Diagnostics
      • Power Management Integration
  • Application Architecture Guidelines
    • Application Structure Best Practices
      • MVP Pattern Implementation
      • Screen Management
    • Performance Optimization Guidelines
      • Memory Management
      • Rendering Optimization
      • Input Handling Optimization
    • Integration Patterns
      • Service Layer Communication
      • Kernel Message Patterns
      • Resource Management
    • Development Workflow
      • TouchGFX Designer Integration
      • Build and Deployment
    • Common Pitfalls and Solutions
      • Memory Issues
      • Performance Problems
      • Input Lag
      • State Synchronization
  • Custom Message Communication
    • Message Architecture Overview
      • Message Types and Flow
      • Message Categories
    • Implementing Custom Messages
      • Message Definition
      • Service-Side Message Sending
      • GUI-Side Message Handling
    • Advanced Message Patterns
      • Request-Response Pattern
      • Bulk Data Transfer
      • Message Queue Management
    • Message Timing and Synchronization
      • Frame-Synchronized Updates
      • Rate Limiting
    • Error Handling and Reliability
      • Message Validation
      • Timeout and Retry Logic
    • Performance Considerations
      • Message Throughput
      • Memory Management
  • Project Structure and Build Integration
    • Directory Structure
      • Standard UNA TouchGFX Project Layout
    • CMake Build System Integration
      • Main CMakeLists.txt Structure
      • TouchGFX CMake Integration
    • Development Workflow
      • Initial Project Setup
      • TouchGFX Designer Workflow
      • Build Process
    • Asset Management
      • Image and Font Pipeline
      • Resource Organization
    • Version Control and Collaboration
      • Git Integration
      • Branching Strategy
    • Testing and Validation
      • Simulator Testing
      • Hardware Testing
      • Automated Testing
    • Deployment and Distribution
      • Application Packaging
      • OTA Update Support
    • Performance Monitoring
      • Build Metrics
      • Runtime Profiling
• TouchGFX Widgets
  • BatteryBig
    • Overview
    • Purpose
    • Components
    • Functionality
    • Usage in TouchGFX Designer
    • Usage in C++ Code
    • Advanced Features and Hidden Gems
    • Files Included
    • Dependencies
  • HrBar
    • Overview
    • Purpose
    • Components
    • Functionality
      • Core Features
      • Threshold Logic
    • Usage in TouchGFX Designer
    • Usage in C++ Code
      • Basic Setup
      • Setting Heart Rate
      • Integration Example
    • Advanced Features
      • Customizable Thresholds
      • Visual Design Considerations
      • Performance Notes
    • Technical Details
    • Best Practices
    • Limitations
  • Menu
    • Overview
    • Purpose
    • Components
    • Functionality
      • Core Features
      • Key Methods
    • Usage in TouchGFX Designer
    • Usage in C++ Code
      • Basic Setup
      • Navigation
      • Customization
    • Adding Actions and Event Handling
      • Handling Button Events
      • Navigation Handling
      • Animation Callbacks
      • Complete Example
    • Advanced Features and Hidden Gems
    • Technical Details
    • Best Practices
    • Limitations
  • MenuItemNotSelected
    • Overview
    • Purpose
    • Components
    • Functionality
      • Display Styles
      • Configuration Methods
      • Customization
    • Usage in TouchGFX Designer
    • Usage in C++ Code
      • Basic Configuration
      • Integration with Menu
      • Copying Items
    • Advanced Features and Hidden Gems
    • Technical Details
    • Best Practices
    • Limitations
  • MenuItemSelected
    • Overview
    • Purpose
    • Components
    • Functionality
      • Display Styles
      • Configuration Methods
      • Toggle Control
      • Customization
    • Usage in TouchGFX Designer
    • Usage in C++ Code
      • Basic Configuration
      • Integration with Menu
      • Toggle Interaction
      • Copying Items
    • Advanced Features and Hidden Gems
    • Technical Details
    • Best Practices
    • Limitations
  • SideBarBig
    • Overview
    • Purpose
    • Components
    • Functionality
      • Position Management
      • Animation Control
    • Usage in TouchGFX Designer
    • Usage in C++ Code
      • Basic Setup
      • Position Updates
      • Integration with Menu Systems
      • Dynamic Count Changes
    • Advanced Features and Hidden Gems
    • Technical Details
    • Best Practices
    • Limitations
  • SideBarSmall
    • Overview
    • Purpose
    • Components
    • Functionality
      • Position Management
      • Animation Control
    • Usage in TouchGFX Designer
    • Usage in C++ Code
      • Basic Setup
      • Position Updates
      • Integration with Menu Systems
      • Dynamic Count Changes
    • Advanced Features and Hidden Gems
    • Technical Details
    • Best Practices
    • Limitations
  • Title
    • Overview
    • Purpose
    • Components
    • Functionality
      • Text Setting
    • Usage in TouchGFX Designer
    • Usage in C++ Code
      • Basic Setup
      • Dynamic Text Updates
      • Integration with Screens
    • Advanced Features and Hidden Gems
    • Technical Details
    • Best Practices
    • Limitations
  • TitleInfo
    • Overview
    • Purpose
    • Components
    • Functionality
      • Text Setting Methods
    • Usage in TouchGFX Designer
    • Usage in C++ Code
    • Advanced Features and Hidden Gems
    • Files Included
  • Toggle
    • Overview
    • Purpose
    • Components
    • Functionality
    • Usage in TouchGFX Designer
    • Usage in C++ Code
    • Advanced Features and Hidden Gems
    • Files Included
    • Dependencies
  • TrackFace1
    • Overview
    • Purpose
    • Components
    • Functionality
    • Usage in TouchGFX Designer
    • Usage in C++ Code
    • Advanced Features and Hidden Gems
    • Files Included
    • Dependencies
  • TrackFace2
    • Overview
    • Purpose
    • Components
    • Functionality
    • Usage in TouchGFX Designer
    • Usage in C++ Code
    • Advanced Features and Hidden Gems
    • Files Included
    • Dependencies
  • TrackFace3
    • Overview
    • Purpose
    • Components
    • Functionality
    • Usage in TouchGFX Designer
    • Usage in C++ Code
    • Advanced Features and Hidden Gems
    • Files Included
    • Dependencies
  • TrackSummary
    • Overview
    • Purpose
    • Components
    • Functionality
    • Usage in TouchGFX Designer
    • Usage in C++ Code
    • Advanced Features and Hidden Gems
    • Files Included
    • Dependencies
  • TrackSummaryHR
    • Overview
    • Purpose
    • Components
    • Functionality
    • Usage in TouchGFX Designer
    • Usage in C++ Code
    • Advanced Features and Hidden Gems
    • Files Included
    • Dependencies
  • UnaButtons
    • Overview
    • Purpose
    • Components
    • Functionality
    • Usage in TouchGFX Designer
    • Usage in C++ Code
    • Advanced Features and Hidden Gems
    • Files Included
    • Dependencies
• FIT Files Structure
  • How to Read This Document
    • For New Developers: Getting Started Guide
      • Phase 1: Foundations (Essential - Read First)
      • Phase 2: Implementation (Core Development)
      • Phase 3: Customization (When You Need to Modify)
      • Phase 4: Advanced Topics (As Needed)
    • Key Sections for Different Tasks
    • Essential Headers and Includes
      • Core FIT Functionality
      • FIT SDK Headers (C-based)
      • Standard Library Headers
      • UNA SDK Logger (Optional but Recommended)
    • Quick Start Checklist
    • Navigation Tips
  • 🚀 Getting Started: Where to Find ActivityWriter
    • Location in UNA SDK
    • Available Implementations
    • Quick Copy Steps
    • Basic Usage (3 lines of code)
    • Need Help?
  • Table of Contents
  • Introduction to FIT
    • What is FIT?
    • Key Concepts for Beginners
    • FIT Protocol Versions
    • Why FIT in UNA SDK?
    • Prerequisites for Understanding
  • FIT File Format Basics
    • File Structure Overview
    • Byte Order and Endianness
    • Message Encoding
    • Data Types in FIT
    • Scaling and Units
  • ActivityWriter Class Overview
    • Class Purpose and Architecture
    • Constructor and Initialization
    • Public Interface Methods
    • Data Structures in ActivityWriter
      • AppInfo Struct
      • RecordData Struct
      • LapData and TrackData Structs
  • FitHelper Component Deep Dive
    • What is FitHelper?
    • Constructor Variants
    • Initialization Process
    • Writing Messages
    • Internal Mechanics
  • Step-by-Step FIT File Creation
    • 1. Initialization Phase
    • 2. Start Activity
    • 3. Record Data Points
    • 4. Add Laps
    • 5. Handle Pauses/Resumes
    • 6. Stop and Finalize
    • File Naming Convention
  • Message Types and Fields in Detail
    • File ID Message
    • Developer Data ID Message
    • Field Description Messages
    • Record Messages
    • Lap Messages
    • Session Messages
    • Event Messages
    • Activity Messages
  • Message Types and Fields
    • File ID Message
    • Developer Data ID Message
    • Field Description Messages
    • Record Messages
    • Lap Messages
    • Session Messages
    • Event Messages
    • Activity Messages
  • Activity-Specific Variations
    • Running (Examples/Apps/Running/)
    • Cycling (Examples/Apps/Cycling/)
    • Hiking (Examples/Apps/Hiking/)
    • HRMonitor (Examples/Apps/HRMonitor/)
  • Developer Fields Implementation
    • Overview
    • Battery Fields (Running, Cycling, Hiking)
    • Steps and Floors (Hiking)
    • Trust Level (HRMonitor)
    • Best Practices for Developer Fields
  • Visual Representations and Diagrams
    • Complete FIT File Structure
    • Message Definition Structure
    • Record Message Variants Tree
    • ActivityWriter Method Flow
  • Code Usage Examples and Walkthroughs
    • Constructor Deep Dive
    • start() Method Walkthrough
    • prepareRecordMsg() - Data Conversion
    • addRecord() - Variant Selection Logic
    • stop() Method - Finalization
  • Advanced Topics and Best Practices
    • FIT Timestamp Handling
    • Data Scaling and Precision
    • GPS Coordinate Conversion
    • CRC Calculation and Validation
    • File Header Management
    • Memory Management and Performance
  • Troubleshooting Common Issues
    • File Creation Failures
    • Invalid FIT Files
    • Data Scaling Errors
    • Developer Field Problems
    • Memory Issues
  • Extending ActivityWriter for New Activities
    • Adding a New Sport Type
    • Adding New Developer Fields
    • Creating New Record Variants
    • Best Practices for Extensions
  • FIT File Parsing and Validation
    • Using Garmin FIT SDK
    • Third-Party Libraries
    • Validation Tools
    • Common Parsing Errors
    • Debugging FIT Files
  • References and Resources
    • Official Documentation
    • Key FIT Documents
    • Community Resources
    • UNA SDK Specific
    • Books and Tutorials
    • Version History

🎋 Apps Sharing

• How to Deploy
  • Directly onto the Watch
    • Copy Your App into the Watch Memory via USB
    • Troubleshooting
  • Sharing the Apps
    • Via https://apps.unawatch.com for Closed Source Apps
    • Via PR to https://github.com/UNAWatch/una-apps for Open Source Apps
• App Config JSON
  • Revision History
  • Output Package
    • Package Content
    • Config File
  • Activity Data Format
    • General Format
    • Predefined Metrics
      • supportsLaps
      • supportsDistance
      • supportsTrack
      • supportsHeartbeat
      • supportsElevation
      • supportsStep
      • supportsSpeed
    • Custom Metrics
      • Custom Non-Time-Based Metric
      • Custom Time-Based Metric
  • Activity Data File Example

📚 API Reference

• API Reference
  • Core SDK Interfaces
    • SDK::Interface::IKernel
    • SDK::Interface::ISystem
      • exit()
      • getTimeMs()
      • delay()
      • yield()
    • SDK::Interface::ILogger
      • printf()
      • vprintf()
      • mvprintf()
    • SDK::Interface::IFileSystem
      • mkdir()
      • file()
      • dir()
      • exist()
      • remove()
      • rename()
      • copy()
      • objectInfo()
      • skMaxPathLen
      • SDK::Interface::IFileSystem::ObjectInfo
    • SDK::Interface::IAppMemory
      • malloc()
      • free()
      • realloc()
  • Application Communication (IPC)
    • SDK::Interface::IAppComm
      • getProcessId()
      • getMessage()
      • sendResponse()
      • releaseMessage()
      • sendMessage()
      • allocateMessage()
    • SDK::MessageBase
      • getType()
      • getResult()
      • getResultStr()
      • getProcessId()
      • needsResponse()
      • isCompleted()
      • getRefCount()
      • setResult()
      • setProcessId()
      • operator new()
      • operator new()
      • operator delete()
      • operator delete()
    • SDK::MessageGuard
  • Sensor Layer
    • SDK::Sensor::Connection
      • Connection()
      • Connection()
      • isValid()
      • connect()
      • connect()
      • isConnected()
      • disconnect()
      • matchesDriver()
    • SDK::SensorDataParser::Accelerometer
      • Field
      • Accelerometer()
      • isDataValid()
      • getX()
      • getY()
      • getZ()
      • getXYZ()
      • getTimestamp()
      • getTimestampUs()
      • getFieldsNumber()
    • SDK::SensorDataParser::HeartRate
      • HeartRate()
      • isDataValid()
      • getBpm()
      • getTrustLevel()
      • getTimestamp()
      • getTimestampUs()
      • getFieldsNumber()
    • SDK::SensorDataParser::GpsLocation
      • GpsLocation()
      • isDataValid()
      • getPrecision()
      • isCoordinatesValid()
      • getCoordinates()
      • getLatitude()
      • getLongitude()
      • getAltitude()
      • getTimestamp()
      • getTimestampUs()
      • getFieldsNumber()
    • SDK::SensorDataParser::BatteryLevel
      • BatteryLevel()
      • isDataValid()
      • getCharge()
      • getTimestamp()
      • getTimestampUs()
      • getFieldsNumber()
  • UI Framework
    • SDK::Interface::IApp
      • LaunchReason
      • Button
      • kFrameRate
    • SDK::TouchGFXCommandProcessor
  • Utilities
    • CircularBuffer
      • push()
      • push()
      • pop()
      • pushToFront()
      • pushToFront()
      • popFromBack()
    • SDK::JsonStreamReader
      • JsonStreamReader()
      • JsonStreamReader()
      • loadBuffer()
      • validate()
      • isValid()
      • getNull()
      • get()
      • get()
      • get()
      • get()
      • get()
      • getArrayLength()

🤝 Community & Support

• Community & Support

Indices and tables

• Index