VEE Porting Guide

• Introduction
  • Scope
  • Intended Audience
• MicroEJ Platform
  • Introduction
  • Build Process
  • Concepts
    • MicroEJ Platform Configuration
    • Modules
    • Low Level API Pattern
• MicroEJ Architecture
  • Naming Convention
  • Architectures Changelog
    • Notation
    • [8.0.0] - 2023-06-27
    • [7.20.1] - 2023-04-10
    • [7.20.0] - 2023-04-04
    • [7.19.0] - 2023-02-16
    • [7.18.1] - 2022-10-26
    • [7.18.0] - 2022-09-14
    • [7.17.0] - 2022-06-13
    • [7.16.0] - 2021-06-24
    • [7.15.1] - 2021-02-19
    • [7.15.0] - 2020-12-17
    • [7.14.1] - 2020-11-30
    • [7.14.0] - 2020-09-25
    • [7.13.3] - 2020-09-18
    • [7.13.2] - 2020-08-14
    • [7.13.1] - 2020-07-20
    • [7.13.0] - 2020-07-03
    • [7.12.0] - 2019-10-16
    • [7.11.0] - 2019-06-24
    • [7.10.1] - 2019-04-03
    • [7.10.0] - 2019-03-29
    • [7.9.1] - 2019-01-08
    • [7.9.0] - 2018-09-20
    • [7.8.0] - 2018-08-01
    • [7.7.0] - 2018-07-19
    • [7.6.0] - 2018-06-29
    • [7.5.0] - 2018-06-15
    • [7.4.0] - 2018-06-13
    • [7.3.0] - 2018-03-07
    • [7.2.0] - 2018-03-02
    • [7.1.2] - 2018-02-02
    • [maintenance/6.18.0] - 2017-12-15
    • [7.1.1] - 2017-12-08
    • [7.1.0] - 2017-12-08
    • [7.0.0] - 2017-11-07
    • [6.17.2] - 2017-10-26
    • [6.17.1] - 2017-10-25
    • [6.17.0] - 2017-10-10
    • [6.16.0] - 2017-09-27
    • [6.15.0] - 2017-09-12
    • [6.14.2] - 2017-08-24
    • [6.14.1] - 2017-08-02
    • [6.13.0] - 2017-07-21
    • [6.12.0] - 2017-07-07
    • [6.11.0] - 2017-06-13
    • [6.11.0-beta1] - 2017-06-02
    • [6.10.0] - 2017-06-02
    • [6.9.2] - 2017-06-02
    • [6.9.1] - 2017-05-29
    • [6.9.0] - 2017-03-15
• MicroEJ Packs
  • Overview
  • Naming Convention
    • Architecture Specific Pack
    • Generic Pack
• Platform Creation
  • Architecture Selection
  • Platform Configuration
  • Pack Import
  • Platform Build
  • Platform Module Configuration
  • Platform Customization
  • Platform Publication
  • BSP Connection
    • Principle
    • Options
    • Build Script File
    • Run Script File
• VEE Port Qualification
  • Introduction
  • VEE Port Qualification Tools Overview
  • VEE Port Test Suite
  • Create a VEE Port Test Suite
    • Create the Test Suite Module
    • Create the Test Suite Runner
  • Test Suite Versioning
    • Core Engine
    • UI Pack
    • FS Pack
    • BLUETOOTH Pack
    • NET Pack
    • EVENT QUEUE Pack
• MicroEJ Core Engine
  • Functional Description
  • Architecture
  • Capabilities
  • Implementation
    • Initialization
    • Scheduling
    • Idle Mode
    • Time
    • Error Codes
    • Example
    • Restart the Core Engine
    • Dump the States of the Core Engine
    • Check Internal Structure Integrity
  • Generic Output
  • Link
  • Dependencies
  • Installation
  • Abstraction Layer
  • Memory Considerations
  • Use
• Advanced Event Tracing
  • Principle
  • Platforms using GNU LD linker
  • Platforms using IAR ILINK linker
• Multi-Sandbox
  • Principle
  • Functional Description
  • Memory Considerations
  • Dependencies
  • Installation
  • Use
  • Feature Installation
    • Introduction
    • In-Place Installation
    • Custom Installation
    • Feature Persistency
    • Advanced Options
    • Determining the Amount of Required Memory
• Tiny-Sandbox
  • Principle
  • Installation
  • Limitations
• Native Interface Mechanisms
  • Simple Native Interface (SNI)
    • Principle
    • Functional Description
    • Example
    • Synchronization
    • Dependencies
    • Installation
    • Use
  • Shielded Plug (SP)
    • Principle
    • Functional Description
    • Shielded Plug Compiler
    • Example
    • Dependencies
    • Installation
    • Use
  • MicroEJ Java H
    • Principle
    • Functional Description
    • Dependencies
    • Installation
    • Use
• External Resources Loader
  • Functional Description
  • Implementations
    • Open a Resource
    • Resource Identifier
    • Resource Offset
    • Resource Inside the CPU Address Space Range
  • External Resources Folder
  • Dependencies
  • Installation
  • Use
• Serial Communications
  • ECOM
    • Principle
    • Functional Description
    • Device Management API
    • Dependencies
    • Installation
    • Use
  • ECOM Comm
    • Principle
    • Functional Description
    • Component Architecture
    • Comm Port Identifier
    • Dynamic Connections
    • Java API
    • Driver API
    • BSP File
    • XML File
    • ECOM Comm Mock
    • Dependencies
    • Installation
    • Use
• Graphical User Interface
  • Principle
  • UI Port
    • UI Port Configuration
    • Simulation
    • BSP Port
    • GPU Port
  • MicroUI
    • Principle
    • Architecture
    • Thread
    • Native Calls
    • Transparency
    • Installation
    • Use
  • Static Initialization
    • Principle
    • Functional Description
    • XML File
    • XML File Example
    • Dependencies
    • Installation
    • Use
  • Abstraction Layer API
    • Principle
    • Embedded VEE Port
    • Simulator
  • LED
    • Principle
    • Functional Description
    • Abstraction Layer API
    • Typical Implementation
    • Dependencies
    • Installation
    • Use
  • Input
    • Principle
    • Functional Description
    • Driver Listener
    • Static Initialization
    • Standard Event Generators
    • Generic Event Generators
    • Abstraction Layer API
    • Typical Implementation
    • Event Buffer
    • Dependencies
    • Installation
    • Use
  • Display
    • Principle
    • Functional Description
    • Display Configurations
    • Buffer Modes
    • Partial Buffer
    • Byte Layout
    • Memory Layout
    • Pixel Structure
    • Abstraction Layer API
    • Typical Implementations
    • Display Synchronization
    • GPU Synchronization
    • Antialiasing
    • CLUT
    • Image Pixel Conversion
    • Library ej.api.Drawing
    • Dependencies
    • Installation
    • Use
  • Drawings
    • Abstraction Layer
    • Destination Format
    • Graphics Engine Software Algorithms
    • MicroUI C Module
    • Simulation
    • Custom Drawing
    • Drawing Logs
  • Images
    • Overview
    • Image Format
    • Image Generator
    • Image Loader
    • Image Renderer
    • Buffered Image
  • Fonts
    • Overview
    • Font Characteristics
    • Font Generator
    • Font Loader
    • Font Renderer
  • C Modules
    • Principle
    • UI Pack
    • C Module: MicroUI
    • C Module: MicroUI Over DMA2D
    • C Module: MicroUI Over VGLite
    • C Module: MicroUI Over NemaGFX
    • Compatibility
  • Simulation
    • Principle
    • Module Dependencies
    • MicroUI Implementation
    • Widget Display
    • Inputs Extensions
    • Heap Simulation
    • Image Decoders
    • Drawings
    • Image Rendering
    • Buffered Image
    • Classpath
    • Dependencies
    • Installation
    • Use
  • Release Notes
    • MicroEJ Architecture Compatibility Version
    • Foundation Libraries
    • Abstraction Layer Interface
    • Front Panel API
    • Image Generator API
    • C Modules
  • Changelog
    • 13.7.0 (2023-10-23)
    • [13.6.2] (2023-09-20)
    • [13.6.1] (2023-07-26)
    • [13.6.0] (2023-07-17)
    • [13.5.1] (2023-06-08)
    • [13.5.0] (2023-05-03)
    • [13.4.1] (2023-02-06)
    • [13.4.0] - 2022-12-13
    • [13.3.1] - 2022-09-09
    • [13.3.0] - 2022-09-02
    • [13.2.0] - 2022-05-05
    • [13.1.0] - 2021-08-03
    • [13.0.7] - 2021-07-30
    • [13.0.6] - 2021-03-29
    • [13.0.5] - 2021-03-08
    • [13.0.4] - 2021-01-15
    • [13.0.3] - 2020-12-03
    • [13.0.2] - 2020-10-02
    • [13.0.1] - 2020-09-22
    • [13.0.0] - 2020-07-30
    • [12.1.5] - 2020-10-02
    • [12.1.4] - 2020-03-10
    • [12.1.3] - 2020-02-24
    • [12.1.2] - 2019-12-09
    • [12.1.1] - 2019-10-29
    • [(maint) 8.0.0] - 2019-10-18
    • [12.1.0] - 2019-10-16
    • [12.0.2] - 2019-09-23
    • [12.0.1] - 2019-07-25
    • [12.0.0] - 2019-06-24
    • [11.2.0] - 2019-02-01
    • [11.1.2] - 2018-08-10
    • [11.1.1] - 2018-08-02
    • [11.1.0] - 2018-07-27
    • [11.0.1] - 2018-06-05
    • [10.0.2] - 2018-02-15
    • [11.0.0] - 2018-02-02
    • [10.0.1] - 2018-01-03
    • [10.0.0] - 2017-12-22
    • [9.4.1] - 2017-11-24
    • [9.4.0] - 2017-11-23
    • [9.3.1] - 2017-09-28
    • [9.3.0] - 2017-08-24
    • [9.2.1] - 2017-08-14
    • [9.2.0] - 2017-07-21
    • [9.0.2] - 2017-04-21
    • [9.1.2] - 2017-03-16
    • [9.0.1] - 2017-03-13
    • [9.1.1] - 2017-02-14
    • [9.1.0] - 2017-02-13
    • [9.0.0] - 2017-02-02
    • [8.1.0] - 2016-12-24
    • [8.0.0] - 2016-11-17
    • [7.4.7] - 2016-06-14
    • [7.4.2] - 2016-05-25
    • [7.4.1] - 2016-05-10
    • [7.4.0] - 2016-04-29
    • [7.3.0] - 2016-04-25
    • [7.2.1] - 2016-04-18
    • [7.2.0] - 2016-04-05
    • [7.1.0] - 2016-03-02
    • [7.0.0] - 2016-01-20
    • [6.0.1] - 2015-12-17
    • [6.0.0] - 2015-11-12
  • Migration Guide
    • From 13.6.x to 13.7.x
    • From 13.5.x to 13.6.x
    • From 13.4.x to 13.5.x
    • From 13.3.x to 13.4.x
    • From 13.2.x to 13.3.x
    • From 13.1.x to 13.2.x
    • From 13.0.x to 13.1.x
    • From 12.x to 13.x
    • From 11.x to 12.x
    • From 10.x to 11.x
    • From 9.x to 10.x
    • From 8.x to 9.x
    • From 7.x to 8.x
• Vector Graphics
  • Principle
  • MicroVG
    • Principle
    • Architecture
    • Native Calls
    • Installation
    • Use
  • Abstraction Layer API
    • Principle
    • Embedded VEE Port
    • Simulator
  • Matrix
    • Principle
    • Functional Description
    • Abstraction Layer API
    • Use
  • Path
    • Principle
    • Functional Description
    • Abstraction Layer API
    • Use
  • Gradient
    • Principle
    • Functional Description
    • Abstraction Layer API
    • Use
  • Image
    • Principle
    • Compile-time Image
    • Resource Vector Image
    • Buffered Vector Image
    • Runtime Image
    • Rendering Engine
    • Abstraction Layer API
    • Simulation
    • Use
  • Font
    • Principle
    • Functional Description
    • Abstraction Layer API
    • External Memory
    • Use
  • C Modules
    • Principle
    • UI Pack & MicroUI C Modules
    • Library: Vivante VGLite
    • VG Pack
    • C Module: MicroVG
    • Library: FreeType
    • Library: Harfbuzz
    • C Module: MicroVG Over VGLite
    • Compatibility
  • Simulation
    • Principle
    • Installation
    • Use
  • Release Notes
    • UI Pack Compatibility Version
    • Foundation Libraries
    • C Modules Compatibility Version
  • Changelog
    • [1.4.2] - 2023-11-13
    • [1.4.1] - 2023-09-21
    • [1.4.0] - 2023-07-21
    • [1.3.0] - 2023-05-10
    • [1.2.1] - 2023-02-06
    • [1.2.0] - 2022-12-30
    • [1.1.0] - 2022-09-05
    • [1.0.1] - 2022-05-16
    • [1.0.0] - 2022-05-13
  • Migration Guide
    • From 1.3.x to 1.4.x
    • From 1.2.x to 1.3.x
• Networking
  • Principle
  • Network Core Engine
    • Principle
    • Functional Description
    • Dependencies
    • Installation
    • Use
  • SSL
    • Principle
    • Functional Description
    • Dependencies
    • Installation
    • Use
  • Network Interfaces Management
    • Overview
    • Dependencies
    • Installation
    • Use
  • Wi-Fi
    • Overview
    • Dependencies
    • Installation
    • Use
• Bluetooth
  • Principle
  • Functional Description
  • Overview
  • Dependencies
  • Installation
  • Use
• Event Queue
  • Principle
  • Dependencies
  • Installation
• File System
  • Principle
  • Functional Description
  • Dependencies
  • Installation
    • Properties File Template
  • Use
• Hardware Abstraction Layer
  • Principle
  • Functional Description
  • Identifier
    • Basic Rule
    • Generic Rules
  • Configuration
  • Dependencies
  • Installation
  • Use
• Device Information
  • Principle
  • Dependencies
  • Installation
  • Use
• Watchdog Timer
  • Overview
  • Principle
  • Mock Implementation
  • Dependencies
  • Installation
  • Use in an Application
  • Code example in Java
  • Use in C inside the BSP
  • Code example in C
• SystemView
  • Principle
  • References
  • Installation
  • MicroEJ Core Engine OS Task
  • OS Tasks and Java Threads Names
  • OS Tasks and Java Threads Priorities
  • Use
  • Troubleshooting
    • SystemView doesn’t see any activity in MicroEJ Tasks
    • OVERFLOW Events in SystemView
    • RTT Control Block Not Found
  • RTT block found by SystemView but no traces displayed
  • Bus hardfault when running SystemView without Java Virtual Machine (JVM)
  • SystemView for STM32 ST-Link Probe
• Simulation
  • Principle
  • Functional Description
  • Dependencies
  • Installation
  • Use
  • Mock
    • Principle
    • Functional Description
    • Example
    • Mocks Design Support
    • Dependencies
    • Installation
    • Use
    • JavaFX
  • Shielded Plug Mock
    • General Architecture
    • Configuration
  • Front Panel Mock
    • Principle
    • Functional Description
    • The Front Panel Project
    • Module Dependencies
    • Front Panel File
    • Widget
    • Installation
    • Use
  • Bluetooth LE Mock
    • Overview
    • Requirements
    • Usage
    • Troubleshooting
• Appendices
  • Low Level API
    • LLMJVM: MicroEJ Core Engine
    • LLKERNEL: Multi-Sandbox
    • LLSP: Shielded Plug
    • LLEXT_RES: External Resources Loader
    • LLCOMM: Serial Communications
    • LLUI_INPUT: Input
    • LLUI_DISPLAY: Display
    • LLUI_LED: LEDs
    • LLVG: VectorGraphics
    • LLVG_MATRIX: Matrix
    • LLVG_PATH: Vector Path
    • LLVG_GRADIENT: Vector Linear Gradient
    • LLVG_FONT: Vector Font
    • LLNET: Network
    • LLNET_SSL: SSL
    • LLECOM_NETWORK: Network Interfaces
    • LLECOM_WIFI: Wi-Fi Management
    • LLBLUETOOTH: Bluetooth
    • LLEVENT: Event Queue
    • LLFS: File System
    • LLHAL: Hardware Abstraction Layer
    • LLDEVICE: Device Information
    • LLWATCHDOG_TIMER: Watchdog Timer
    • LLSEC: Security
  • MicroEJ Foundation Libraries
    • EDC
    • SNI
    • KF
    • ECOM
    • ECOM Comm
    • FS
    • Net
    • SSL
  • Tools Options and Error Codes
    • Immutable Files Related Error Messages
    • SNI
    • SP Compiler
    • NLS Immutables Creator
    • MicroUI Static Initializer
    • Front Panel
    • HIL Engine
    • Heap Dumping
  • Architectures MCU / Compiler
    • Principle
    • Supported MicroEJ Core Engine Capabilities by Architecture Matrix
    • ARM Cortex-M0
    • ARM Cortex-M4
    • ARM Cortex-M7
    • ARMv7A (ARMv7-A without integer division extension: Cortex-A5/Cortex-A8/Cortex-A9)
    • ARMv7VE (ARMv7-A with integer division extension: Cortex-A7/Cortex-A15)
    • ESP32
    • IAR Linker Specific Options
    • GNU LD Specific Options
    • ARM Linker Specific Options
  • Former Platform Migration
    • Create an Architecture Repository
    • Import the Former Platform Sources
    • Install the Platform Configuration Additions
    • Update the Front Panel Configuration
    • Configure the BSP Connection
    • Add the Build and Run Scripts
    • Use the Platform in Module Projects
    • Going further
  • Architecture 7.x Migration
    • Update Platform Configuration Additions
    • Update BSP with new Sections Names
    • Remove LLBSP_IMPL_isInReadOnlyMemory
    • Migrate Built-in Modules
    • Migrate Your LLKERNEL Implementation
    • Migrate Trace C Library Usage
    • Migrate Legacy System Properties Files