PlatformIO support for HUADA HC32F460 Series DDL

This repository contains the HUADA HC32F460 Series DDL, adapted to work with PlatformIO and the hc32f46x platform.

Tip

if you're searching for arduino support for HC32F460, take a look at shadow578/framework-arduino-hc32f46x.

Note

while the primary use-case of this framework is for use with Marlin, other use-cases should work too.

Getting Started

to get started using the HC32F460 DDL, use the following in your platformio.ini:

current development version:

[env:my_env]
platform = https://github.com/shadow578/platform-hc32f46x.git
framework = ddl
board = generic_hc32f460

latest release versions:

[env:my_env]
platform = https://github.com/shadow578/platform-hc32f46x/archive/1.0.0.zip
platform_packages =
  framework-hc32f46x-ddl @ https://github.com/shadow578/framework-hc32f46x-ddl/archive/2.2.1.zip

framework = ddl
board = generic_hc32f460

Tip

when pinning the version, check you're using the latest release(s) to benefit from the latest improvements.

Examples

usage examples are available in the examples directory. note that most of the official examples given by HUADA should be able to run with this framework with minimal changes.

Configuration Options

the DDL framework supports multiple configuration options, which can be set in the platformio.ini file. see the following list for a list of available configuration options and their documentation.

• Device Driver Selection
• Middleware Selection
• Heap and Stack Configuration
• Boot Mode Configuration
• Linker Script Options
• Custom Build Flags
• Custom Interrupt Management

C APIs

the DDL framework adds some C apis to the standard DDL, the documentation for these can be found in the following files:

• Heap and Stack APIs

Files and Patches

mapping of HUADA DDL files to the files in this repository can be found in docs/FILES_MAPPING.md. more details on the patches applied to the DDL can be found in docs/patches/README.md.

License

new code added to the DDL framework is licensed under the GPL-3.0 license, while the original DDL code is licensed under the BSD 3-Clause license. files licensed under the BSD 3-Clause license have a header at the top of the file, specifying the license.

changes to the original DDL code are licensed under the GPL-3.0 license and documented in docs/patches/README.md.