# py32f0-cmake

**Repository Path**: makeval/py32f0-cmake

## Basic Information

- **Project Name**: py32f0-cmake
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-11-15
- **Last Updated**: 2024-11-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

PY32F0 MCU CMake project template. Using GCC, cross-platform. You can use VSCode, CLion, etc. for development.

This project is in its early stage and may have many bugs or areas that are incomplete.

Most of the information for this project comes from Puya Semiconductor. Puya Semiconductor's information is in a semi-public state, and I have collected data such as chip manuals and libraries from various sources. Please refer to:

HAL, LL, CMSIS, BSP Drivers [decaday/PY32F0_Drivers](https://github.com/decaday/PY32F0_Drivers)

Datasheets, packs, reference manuals, etc. [decaday/PY32_Docs](https://github.com/decaday/PY32_Docs)

GCC startup and ldscript are from [IOsetting/py32f0-template](https://github.com/IOsetting/py32f0-template) (this repo uses makefile on Linux), thanks to the contributors to that project.

## Supported MCUs

### ---PY32F002B Series---

**Puya** PY32F002B

**Xinlinggo** XL32F001\*, XL32F002B\*

### ---PY32F0xx Series---

**Puya** PY32F002A, PY32F003, PY32F030

**Xinlinggo** XL32F003\*, XL32F002A\*

**Luat** AIR001

### ---PY32F07x Series---(TODO)

**Puya** PY32F040, PY32F(M)070*, PY32F071, PY32F072



*:Guessing based on chip specifications, haven’t tried it yet.

**:There are too many naming approaches for puya MCU, some MCUs such as PY32L020, PY32C613, etc. I didn't buy these chips, if you have them, please contribute relevant information. You can try above series with the same flash, ram, and clock speed, which may work because they are most likely produced from the same die.

## Steps

#### 1. Install gcc-arm-none-eabi

[Downloads | GNU Arm Embedded Toolchain Downloads – Arm Developer](https://developer.arm.com/downloads/-/gnu-rm)

Choose the appropriate package for your system and add `bin` to your environment variable (if you use the installer, it may have already been added automatically).

#### 2. Clone this template project

```
git clone --recursive https://github.com/decaday/py32f0_cmake_template.git
```

This repo has a submodule, so you need to add `--recursive`.

### 3. Edit the py32f0.cmake file.

```cmake
# project settings
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_C_STANDARD 11)

# Use HAL lib or LL lib
set(USE_HAL_OR_LL LL)

# MCU:
#   PY32F002Ax5
#   PY32F002Bx5
#   PY32F003x4, PY32F003x6, PY32F003x8
#   PY32F030x4, PY32F030x6, PY32F030x7, PY32F030x8
set(MCU_MODEL PY32F030x6)

# Enable printf float %f support
set(ENABLE_PRINTF_FLOAT OFF)

# Build with CMSIS DSP functions
set(USE_DSP OFF)

# Enable auto generation of Misc/pyocd.yaml if needed
set(AUTO_GENERATE_PYOCD_YAML ON)
```

#### Set MCU_MODEL

Puya's MCU naming can be a bit cumbersome, for example, `PY32F002AF15P6TU`.

`PY32F002A` is the Product type, `F1` is the 20 pins Pinout1, `5` is 20 Kbytes of code, `P` is Package TSSOP, `6` is Temperature range 6 = -40 to +85, `TU` is Tube Packing.

Therefore, you need to choose PY32F002Ax5.

If you are using AIR001, you can choose PY32F030x6. If you are using XL32, please choose the appropriate settings based on the core and flash size.

#### AUTO_GENERATE_PYOCD_YAML

I have written a script in CMake to automatically generate `Misc/pyocd.yaml`. For more information about debugging, please see below.

### 4. Compilation

You can use IDEs like VSCode, CLion, or compile from the command line.

### 5. Debugging and Flashing

Puya has several ISP tools and official debuggers. You can find some information about them here: [decaday/PY32_Docs](https://github.com/decaday/PY32_Docs). However, in reality, we can use a regular DAPlink. I don't have STlink or Jlink, but contributions to the documentation are welcome.

I recommend using [PyOCD](https://pyocd.io/) as it supports MDK PACK.

Please download and install PyOCD.

#### Clion PyOCD Configure

<img src="Docs/Images/image-20240121211255909.png" alt="image-20240121211255909" style="zoom: 80%;" />

<img src="Docs/Images/image-20240121211434382.png" alt="image-20240121211434382" style="zoom: 80%;" />

You can keep the default settings for now. Later on, we will configure the target ourselves.(Misc/pyocd.yaml)

<img src="Docs/Images/image-20240121211527071.png" alt="image-20240121211527071" style="zoom:80%;" />

<img src="Docs/Images/image-20240121211613733.png" alt="image-20240121211613733" style="zoom:80%;" />

```
gdbserver -p 33462 --config Misc\pyocd.yaml
```

#### VSCode Pyocd Configure

TODO

### 6.Use Examples

The examples are under ‘Drivers/Examples’. You need to copy the files to the outside to run and debug. These examples are from Puya, using scripts to delete the MDK project related files. You may need to make slight modifications to run normally.

## Compilation Reference Size

| Compiler        | MCU   | Project        | RAM     | FLASH   |
| --------------- | ----- | -------------- | ------- | ------- |
| GCC -Og -g      | F030  | HAL Toggle Pin | 1584 B  | 1720 B  |
| GCC -Og -g      | F030  | LL Toggle Pin  | 1568 B  | 1156 B  |
| GCC -Og -g      | F002B | HAL Toggle Pin | 816 B   | 1736 B  |
| GCC -O1         | F030  | HAL Toggle Pin | 1584 B  | 1692 B  |
| MDK ARMCC6  -O1 | F030  | HAL Toggle Pin | 1240 B* | 1448 B* |
| MDK ARMCC6  -O1 | F030  | LL Toggle Pin  | 1224 B* | 912 B*  |
|                 |       |                |         |         |

*RAM = ZI-data + RW-data

*Flash = Code + RO-data + RW-data

**GCC**:12.2mpacbti-rel1    **ARMCC**:v6.19

## Puya Naming Instructions

![image-20240121212122728](Docs/Images/image-20240121212122728.png)



| code | Flash memory |
| ---- | ------------ |
| 3    | 8 Kbytes     |
| 4    | 16 Kbytes    |
| 5    | 20/24 Kbytes |
| 6    | 32 Kbytes    |
| 8    | 64 Kbytes    |
| 9    | 96 Kbytes    |
| B    | 128 Kbytes   |