YXRA-SDK教程 || 已持续更新到第18课，ADC/PWM/I2C/I2S/USB/CAN 都有了

Leorin***

第一课：YXRA-SDK集成工具安装

YXRA-SDK集成开发工具运行在Java的环境下。Java是一种跨操作系统的开发语言，YXRA-SDK集成开发工具正是看在这一点上而选择Java作为过渡阶段的开发语言。下面列出了一些市场上份额较大的操作系统支持的情况。注意：java为开发语言名称，java运行环境为jre，开发环境为jdk。一般开发环境会包括运行环境，即安装jdk时会要求安装jre，这两者会一同安装。我们常说的安装java或jdk版本均是指开发环境+运行环境。
    32位windows2000、windowsxp可正常运行，需要安装与之匹配的32位jdk16+；
    64位windows7、windows8、windows10、windows11等可正常运行，需要安装与之匹配的64位jdk18+；
    桌面版Linux（Ubuntu、Fedora、银河麒麟、统信UOS等）可正常运行，需要安装与之匹配的jdk16+；
    MacOS可正常运行，需要安装与之匹配的jdk18+，推荐jdk11版本；
    其他操作系统，如果能正常支持jdk16+，基本上可正常运行YXRA-SDK集成开发工具；

一、java如何安装？
    不同操作系统安装方法不一样。下面以windows为例。首先下载与操作系统匹配的jdk版本，一般是jdk18。虽然现在java版本已到2x甚到更高，对于YXRA-SDK开发工具而言，能正常运行即可，无须追求更高版本。到oracle官网上下载对于新手会有很多困难，纯英文可以调用浏览器上的自动翻译功能，主要是下载的网速慢，毕竟不在本土。可以考虑从镜像网站或是云盘等地方去下载。java现在依然是业务开发霸主的开发语言，获取开发环境应该不难。
    顺利下载完jdk后就是安装。windows下jdk18的大小大约是100M上下，其他版本会不一样。双击或以管理员运行，会弹出安装窗体。如果要求指定安装位置，对于新手一定要注意，java有时对空格或中文这些字符的支持力度是不够的，请将jdk安装到c:/jdk/下，至于jre环境的安装目录没有什么要求，因为jdk环境中已经存在jre。
    为什么在开发文档中建议jdk安装在c:/jdk/下？主要原因除java中文支持力度外，启动脚本中startup.bat指定的java目录就在这个目录下（也有可能为c:/jdk16/......）。
    安装完成后，我们来验证jdk安装是否成功。一般来说无须作任何配置，即可以在command窗体中输入java -version查看安装结果。如果提示没有找到命令，解决方法之一是需要配置java的path，在系统变量path中添加jdk的安装路径，这样可以让windows顺着这些路径找到java.exe并执行。解决方法之二是通过cd命令进入到jdk安装目录中，如果你是安装在c:/jdk/下，那么你需要进入c:/jdk/bin/这个目录，java.exe在这个目录下，同样设置path也是这个目录。如果可以看到java的版本，恭喜你成功安装了jdk了，可以进行下一步。

二、YXRA-SDK如何安装？
    YXRA-SDK安装包为一个绿色压缩文件，直接解压到指定目录下，解压完成后可以看到如下目录结构：
    classes目录：系统运行类以及资源
    startup.bat：windows下启动YXRA-SDK集成开发工具的脚本
    yxrastart.jar：Java启动YXRA-SDK程序
    *proplate.cfg：项目文件，初始安装不存在，需要创建项目才生成
    *yxraconfig.txt：系统关键配置信息，初始安装不存，需要运行后才生成
    jdk安装与YXRA-SDK没有先后关系，但必须正确安装jdk后才可以通过startup.bat运行YXRA-SDK。
    不同操作系统启动程序的方式可查看java程序运行。

三、如何运行YXRA-SDK开发工具？
    在打开YXRA-SDK开发工具之前，一定要确认jdk已成功安装，且版本不得低于jdk16，因为开发者是在jdk16上开发的，运行的jdk版本一定要大于等于这个版本。注意，jdk16+这个并不是一个具体的版本，而是指版本号大于等于jdk16。jdk已成功安装，下载YXRA-SDK开发工具压缩包，官方一般取名为yxrastart.zip，如果不包绿色版jdk（有时为了方便新手顺利安装，会将jdk的绿色版本一同压缩到文件中，这样只需要解压即完成了jdk安装和YXRA-SDK的解压），其大小一般在5M左右。开发工具压缩包建议解压到根目录，比如在c:，解压后的程序目录为c:/yxrastart/，方便查找也不会有空格等字符。打开解压所在的目录，双击或右击打开startup.bat，程序会首先打开command窗体，这是java.exe运行程序默认方式，是日志输出窗体。如果顺利，接着你就能看到YXRA-SDK开发工具的真面目了。

Leorin***

上述描述的比较罗嗦，简单说就是：


1、下载jdk16.exe，安装到c:\jdk下；
2、下载yxrastart.zip，解压到c:\下；
3、双击yxrastart\startup.bat，

如果能正常运行，就能看到YXRA-SDK界面了。

我心***

向***

请问都支持什么芯片啊

Leorin***

向钱看 发表于 2026-8-7 07:14
请问都支持什么芯片啊

支持STC32G12K128，Ai8051U没有测试，官方说Ai8051U与STC32G12K128的32位指令兼容

Leorin***

上一课告诉大家如何安装运行YXRA-SDK开发工具，这一课我们用这个强大的工具做一个跑马灯。
首先创建一个MCU-STC32G芯片的项目，内核版本选择单片机（这里系统没有给出选择，因为STC32G12K128的内存仅支持单片机内核，无法支持集合线程等），其它属性默认即可。创建项目成功后系统会自动打开设备视图。
接下来我们需要让LED亮起来，官方提供的STC32G实验箱是P4和P6两组GPIO控制8个LED，我们将P4和P6两组端口放到视图中，并设置IO端口模式为准双向口或推挽模式，设置初始值0x00。如果你的开发板上是Px，就把Px放到视图中。对此LED点亮这个功能就完成了，因为这是设备的初始化工作，不涉及业务代码。点击编译项目，并用官方的下载工具AiCube-ISP.exe下载运行，就可以看到8个LED都亮了。编译项目这个操作需要先选中项目或项目下的资源（创建项目后视图即被选中），点击菜单中的项目编译或工具栏上的项目编译按钮。大约1秒时间编译完成，可以看到日志输出结果。
LED已经点亮说明两个事情：第一个就是YXRA-SDK一切工具正常；第二个就是开发板上LED确实由Px控制。今天是第一个项目，我们直接在主程序中完成跑马灯的功能，简单明了，下节课我们用中断来实这个功能。
双击视图空白处或是在项目树上找到并打开OsAppLoader.yxra，在主程序方法mainMcuCode()中添加循环移位的代码。点击编译项目并下载到实验箱或开发板上运行。你的LED是不是开始循环的动起来了？如果要调整速度可调节AsmCode.delayAsmCodeTime(300);中的参数，如果要调整循环方向，将右移调成左移，并将最高位放到Px的最低位上。
友情提示一下：对于端口Px工作模式不太了解或记不住的同志们，你们可在设备视图中端口Px上右键菜单中点击开发文档，即可查看官方对端口的描述，这些是从官方文档中摘录出来。
希望大家在这一课中多练习一下，了解yxra开发语言相对c语言的区别，了解yxra-sdk与keil的区别。后面的开发将会让你觉得更加的快捷。
项目以附件的形式放在下面，直接导入项目即可。

wpy62***

LeoringYang 发表于 2026-8-6 16:57
上述描述的比较罗嗦，简单说就是：

java安装成功，双击yxrastart\startup.bat，command窗体闪一下，就没有反应了，什么原因？是不是还少东西？win10家庭版，两台笔记本都是一样的

Leorin***

wpy621206 发表于 2026-8-7 11:59
java安装成功，双击yxrastart\startup.bat，command窗体闪一下，就没有反应了，什么原因？是不是还少东西 ...

如果你解压在c:\下，打开c:\yxrastart\这个目录，在地址栏输入cmd回车，这时弹出黑色窗体。在里面输入startup.bat，这种方式运行会显示日志。一般是安装jdk的目录与startup.bat中指定的目录不一致造成。
前提：正确安装jdk，验证方法：打开jdk安装的目录/bin，这里可以看到java.exe程序，在地址栏输入cmd，弹出的黑窗体中输入java -version，能显示jdk版本，表示安装成功。
我下载测试了一下，startup.bat中是c:\jdk16\bin\java.exe，这是我本地jdk安装的路径，你应该是c:\jdk\bin\java.exe。我已经重新上传，调整为c:\jdk\bin\java.exe

神***

在同一个帖子中发，大家好集中了解，这样好跟进

Leorin***

神农鼎 发表于 2026-8-7 13:22
在同一个帖子中发，大家好集中了解，这样好跟进

每天发一帖，标题上会注明第N课