# MaxIDE公开发布版本

**Repository Path**: wang-jinbin05/max-ide-release

## Basic Information

- **Project Name**: MaxIDE公开发布版本
- **Description**: 兼容Arduino的STM32开发环境, 使用GCC编译器, 长期项目验证, 稳定可靠. 
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 13
- **Created**: 2026-02-04
- **Last Updated**: 2026-02-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MaxIDE v1.7.0

MaxIDE 是一款专为 STM32 单片机开发设计的集成开发环境，基于 Arduino IDE 深度定制，让 STM32 开发变得像 Arduino 一样简单。而且经过多年的工业验证，稳定可靠。

## 主要特性

- **Arduino 兼容**: 使用熟悉的 Arduino API 进行 STM32 开发
- **支持多种 STM32 芯片**: 
  - STM32F1 系列: F103R8T6, F103RET6, F103VET6
  - STM32F4 系列: F407ZET6
- **集成烧录工具**: 内置 MaxLoader 自动烧录，无需额外配置
- **CPU 型号验证**: 上传前自动检测芯片型号，防止程序误烧到错误的芯片
- **中文界面**: 完整的中文本地化支持

## 系统要求

- Windows 7/8/10/11 (64位)
- Java Runtime Environment (已内置)
- USB 转串口驱动（CH340/CP2102/FT232等）

## 快速开始

### 1. 启动 MaxIDE

双击 `MaxDuino.exe` 启动 IDE。

### 2. 选择开发板

菜单栏 → **工具** → **开发板** → 选择你的 STM32 板卡型号

| 板卡名称 | 芯片型号 | Flash | RAM |
|----------|----------|-------|-----|
| F103R8T6 | STM32F103R8T6 | 64KB | 20KB |
| F103RET6 | STM32F103RET6 | 512KB | 64KB |
| F103VET6 | STM32F103VET6 | 512KB | 64KB |
| F407ZET6 | STM32F407ZET6 | 512KB | 192KB |

### 3. 选择串口

菜单栏 → **工具** → **端口** → 选择你的串口（如 COM2）

### 4. 编写程序

```cpp
void setup() {
    pinMode(LED_BUILTIN, OUTPUT);  // 设置LED引脚为输出
}

void loop() {
    digitalWrite(LED_BUILTIN, HIGH);  // 点亮LED
    delay(500);                        // 延时500ms
    digitalWrite(LED_BUILTIN, LOW);   // 熄灭LED
    delay(500);                        // 延时500ms
}
```

### 5. 编译上传

点击工具栏的 **上传** 按钮（→）或按 `Ctrl+U`

## 硬件连接

### USB 转串口连接

| USB转串口 | STM32 |
|-----------|-------|
| TXD | PA10 (USART1_RX) |
| RXD | PA9 (USART1_TX) |
| GND | GND |
| 3.3V/5V | VCC |

### 自动下载电路

MaxIDE 支持通过 DTR/RTS 信号自动控制 STM32 进入 Bootloader 模式：

| USB转串口 | STM32 |
|-----------|-------|
| DTR | BOOT0 (通过电容耦合) |
| RTS | NRST (通过电容耦合) |

## 常用函数

### 数字 I/O

```cpp
pinMode(pin, mode);           // 设置引脚模式 (INPUT/OUTPUT/INPUT_PULLUP)
digitalWrite(pin, value);     // 数字输出 (HIGH/LOW)
int val = digitalRead(pin);   // 数字读取
```

### 模拟 I/O

```cpp
int val = analogRead(pin);    // ADC读取 (0-4095, 12位)
analogWrite(pin, value);      // PWM输出 (0-255)
```

### 串口通信

```cpp
Serial.begin(115200);         // 初始化串口
Serial.println("Hello");      // 发送数据
if (Serial.available()) {     // 检查是否有数据
    char c = Serial.read();   // 读取数据
}
```

### 时间函数

```cpp
delay(ms);                    // 毫秒延时
delayMicroseconds(us);        // 微秒延时
unsigned long t = millis();   // 获取运行时间(ms)
unsigned long t = micros();   // 获取运行时间(us)
```

## 目录结构

```
MaxIDE/
├── MaxDuino.exe              # 主程序
├── lib/                      # Java库文件
├── hardware/
│   └── arduino/
│       ├── STM32F1/          # STM32F1 平台文件
│       │   ├── cores/        # 核心库
│       │   ├── variants/     # 板卡变体定义
│       │   ├── libraries/    # 内置库
│       │   └── uploader/     # 烧录工具
│       └── STM32F4/          # STM32F4 平台文件
├── examples/                 # 示例程序
└── java/                     # Java运行时
```

## 常见问题

### Q: 上传失败，提示"无法进入Bootloader"

**A:** 请检查：
1. 串口连接是否正确
2. BOOT0 和 NRST 的自动下载电路是否正确
3. 尝试手动按住 BOOT0 按钮，点击 RESET，然后松开 BOOT0

### Q: 上传时提示"CPU型号不匹配"

**A:** 选择的开发板型号与实际芯片不符。请在 **工具** → **开发板** 中选择正确的型号。

### Q: 编译报错"找不到头文件"

**A:** 确保已安装所需的库。可通过 **项目** → **加载库** → **管理库** 安装。

### Q: 程序上传成功但不运行

**A:** 
1. 检查 BOOT0 引脚是否接地（运行模式需要 BOOT0=0）
2. 按下 RESET 按钮复位

## 版本历史

### v1.7.0 (2026-02-01)
- 新增 CPU 型号验证功能，防止程序误烧
- 优化板卡命名，统一使用芯片型号命名
- 修复多个 BUG

### v1.6.5
- 初始版本

## 技术支持

- 问题反馈: 请在 GitHub 提交 Issue
- 硬件支持: 青岛市张彦欣单片机有限公司

## 许可证

本软件基于 Arduino IDE 开源项目开发，遵循 LGPL 许可证。

---

**MaxIDE** - 让 STM32 开发更简单！