本帖最后由 洁月明 于 2022-1-11 23:34 编辑
#申请原创#
首先，庆祝一下，demo例程终于顺利下载进去了，灯亮了，屏幕显示变成demo名称了，再也不是开机语音播报好像是欢迎使用YOC吧同时显示RISC-V
然后，为什么说下载一个demo也要庆祝一下呢？有什么值得庆祝的呢？接下来就是我的吐槽时间：明明10几20分钟局可以搞定的事情，硬是花了我2-3个小时。为什么会这样呢？1.这个开发板的资料真的是太有限了；2.这些文档全是一些概念说明性的文档，对实际开发本人觉得参考价值有限、实用价值基本没有吧，反而让人越看越搞不懂；3.就是相应的资源太分散，可以系统分类，但也很有必要对应产品专门的分类吧，哪怕是放个链接也行啊；4.就是有些note类的提示真的是有点片面，反而会误导开发过程，要不就说明白点、全面点。也许是本人水平有限，无法领会这些资源的分类及内容哈，一家之言，吐槽而已，接下来具体说一下这些槽点以及一点点建议。本人写东西喜欢啰嗦，不喜欢的可以直接点击跳转到总结。好吧，没办法交叉引用，那就劳驾滑到最后看一下干货吧。- 开发资料有限：有图有真相
，我们可以看到这个开发板相关的资料就是这些分类。a)产品详情：开发板的硬件简介；b)资源下载：是这样的
请问你看了有什么感觉，要点击哪一个呢，肯定是点开发板，对吧，那些方案就是本次主题说到的demo也可以下载下来先看下效果对吧，但是能想到最上边的那个芯片也是可以点的，真的是醉了，我是刚刚在描述现在的东西时才发现的，而且发现的这些资料反驳了我的槽点3，但是方案属于开发板里边的分类可以理解，可是开发板属于芯片这个就。。。我觉得开发板可以和芯片属于同一级别，这样再有此芯片的开发板时再往下并，芯片放到同类别的第一个没问题，至少我会点一下知道它的里边是有内容的。c)在线视频:
就一个这个，当时的直播视频；d)博文：就是一些开箱贴和一些功能的开发记录；e)评论：里边就是一些相关的讨论。以上是一些简单介绍，希望对一些新上手的开发者有一点参考，在上手过程中可提高一点效率。说回主题，开发资源有限，我们重点说一下资源下载，我当时没看到芯片里边的资源，然后我下载了开发板相关的资料，想要开发原理图肯定要有的，用户手册肯定得参考嘛，还有一个SDK当时并不知道这是什么，文件也不是很大就一起下载下来了，
，结果用户手册和就是原理图的文字说明版，可以说是硬件说明并没有开发板使用说明，可能我习惯了arm开发板的资料形式，对于这种我觉得不够完善，然后我就开始在社区各种逛、找资源，最终下载的就是这些
，这些文档我都看了一遍除了刚下载的数据手册哈，然后我知道得有一个平头哥自己的IDE才可以开发，仅此而已，至于是什么IDE，这就不得不说一下槽点2了。 - 文档实用价值待提高：也许是我做单片机的开发习惯了，总感觉这些文档都是一些软件方向的描述，当然这是我的第一感觉哈，感觉看完给的不够直接，当然我后来看进去了还是有参考价值的。作为一个第一次接触平头哥的小白，一看CDK快速上手指南，什么感觉？当然是赶紧瞄一瞄，快速上手，一看目录
哎，还不错哦，有介绍、有如何创建工程等那就说干就干，结果看完一脸懵逼，是工程框架搭好了，然后呢？没了，留下不知所措的我在原地画圈圈。那就接着找资料吧，当时内心是有好多小动物奔腾而过的，就这还1520？哈哈，当然前边也提到了是花了点时间但也没那么不堪一击，只是当时那一刻的心情，我觉得既然是快速上手，那就整个全套的啦，后边跟一个demo的实例演示不香吗？可能看STM的习惯了硬件、软件和例程一体的参考资料，跟着走一遍基本就了解了，而平头哥的文档很有针对性，当然就少了一些综合性，各有千秋吧，只不过对于一个小白来说快感没有那么快找到。
- 资源分散：其实前两个槽点已经反复再说了，因为每篇文档都有针对性导致整体把握不太容易，同时这些资源没有统一放在对应的资源下载这一大类的子分支下，而是放在一些文档中的链接或者就没有，比如
，通过链接我找到了CDK软件下载的位置，但是我同时看到了CDS，然后就是我在找资料的是时候貌似在哪里看到过这两个软件的大概描述，大体印象就是CDS是一个包含CDK功能的软件，那我岂不是使用CDS就可以了，but，在这之前我忘了是在直播的时候还是哪里，好像说这个RV2601只支持CDK，这我就困惑了，那怎么办，就全下下来再说，然后就是一通问，在交流群里得到了解惑，这个区别我在总结再说，再次先按下不表。如果说这两个软件还好，槽点2说了，我看到的东西感觉都是概念性的，刚一接触只有懵逼，接下来就不得不说一下槽点4了，因为这些提醒、说明类的文字，导致我搞不清状况同时还容易犯一些低级错误。
- note提示片面：接着上边说的两个软件的问题，其实还有一个概念也搞得我和这两个软件混淆，注意这里
操作系统可以理解，开发工具可以理解，YOC软件平台是什么鬼？我以为也是一个IDE，当然这是吐槽哈，是我这方面鄙陋了，长接触这方面的可能都懂，对于这开发板我是小白，相关的信息都是第一次了解。接着说，demo的创建、下载我是从这个链接里搞成的，这是这个链接网页内容的截图，
我忘记从哪个文档看到的这链接了哈。但是我之前下载了那些文档，也没搞清楚这些demo怎么编译通过并下载进开发板，却是看着这个文档搞成的，当然也不是那么顺利，这还要归功于开发板使用手册，插个槽点，我从资源下载里边下载的demo根本就编译不通过，提示我网络错误啥的，然后就是cos下的文件都找不到，后来在生成的demo的过程中大概了解到这些属于package里边的都是现下载的热乎的，demo里是没有的，但是怎么下载直接从demo打开截止我现在这篇帖子我也没搞清楚。接着说这个note问题，我只是写当时的心情，并不一定都对哈，我现在写的时候不得不说是我自己没理解好，
我就是看到建议选用UART口USB供电，供电log二合一，log我理解成下载了，我以为是直接通过串口下载核心文件这种方式，供电烧录一个口都办了，等我上电后还纳闷那两个状态指示灯不对啊，怎么一直是err灯闪，BSY灯不亮，但是开机工作也都工作正常啊，有语音，有显示，也没太在意，等我编译完demo下载的时候，诡异的事情出现了写入CKLINK失败的问题，我还一本正经的在交流群问有没有出现这种问题的小伙伴，或者技术给解答一下，后来我才反应过来，犯了这么低级的一个错误，没连接debug当然找不到，等我换成debug那个USB接口的时候我就感觉成了，首先BSY绿灯亮了，然后我一个单击demo下载进去了，当时开发板是没反应的，我明白没有找到配置下载后重启的东东，估计是上电重启，我就默默的插拔了一下USB线，哎，OLED 屏幕显示变了，没有语音了，同时RGB指示灯开始闪烁，当然我的红灯可能是个残废，蓝灯和绿灯亮的好好的，轮到红灯的时候就是沉默，什么等都不亮，还没量是不是灯坏了，大概瞄了一下代码，和另外两个灯配置一样，代码应该没问题，但无伤大雅，和搞软件的先写“helloWord”一样，搞硬件的就喜欢点个流水灯啥的宣示一下我要开始搞你了。。。。
- 我就喜欢唠叨哈，对不对的都想写写，写这些东西比我调板子花的时间都多。但没办法，接下我们来点干货，总结一下这个CH2601的上手过程，就以这个demo运行起来为例。
- 总结：点亮流水灯的准备，分三步走
1）硬件准备： 开发板，这是开发的根本，申请试用或购买；
开发板原理图，丢个板子，没原理图，那个灯干什么的？跳线帽怎么插？接那个USB口？都不清楚。资源下载里边我觉得这个开发板用户手册就够了，别的要不重复，要不就是没什么下载的必要，IDE里边都有，demo下载下来也不一定可以直接用。这个是文档连接
https://occ-oss-prod.oss-cn-hangzhou.aliyuncs.com/userFiles/3706713731985244160/resource/37067137319852441601615475227781dm4cDSePeY.pdf
2）软件准备：
在这里我要解释一下上边槽点2里的三个概念，CDS、CDK和YOC平台。这些名词的解释要感谢技术交流群里的蒋龙和平头哥的吴嘉祺，感谢他们的解答。 首先是CDK，叫做剑池集成开发环境，简单来说和ARM里边的keil和IAR差不多，开发裸板程序或者跑个RTOS可能就够了，我觉得实时性要求没那么高的应用开发CDK就够用了；然后是CDS，就是集成开发环境没看到命名，蒋龙的说法是类似于Eclipse开发界面，CDK支持的他都支持，而且还支持嵌入式Linux操作系统应用程序开发，这个我虽然下载了但是还没有安装，具体的体验不好说；最后是YOC平台，叫YUN on chip，简单来说就是操作系统并不是一个开发或者交流什么的平台，我也只是了解这些，目前对我来说了解就可以了，还没有深入应用的需要，知道他是个操作系统就OK了。
好了，上边槽点的坑填上了，我们继续说软件准备，这个首先要有一台联网的电脑，因为即便是安装好了他的一些支持包也还是需要联网下载的。首先是安装包的下载，这个是下载链接https://occ.t-head.cn/community/download?id=575997419775328256 选择一个最新的版本下载、安装就OK了。
当然你也可以下个软件说明看看，看看概念性的介绍，实际参考价值有限，了解一下可以。这个是链接
https://occ.t-head.cn/community/download?id=3862555628233105408
3）demo验证：
我们知道了这个板子的硬件组成，也有了开发环境，那么要如何下个demo看看效果呢？如果你和我一样是个小白的话，我觉得第一反应是打开那个在开发 板资源下载里边的SDK，然后就会发现打开的时候报错，具体我就不截图了，就是关于联网的错误，我现在也不知道怎么解决这个问题，所以为了快速上手不至 于被无所谓的烦恼困扰，我建议按照这个链接里的步骤操作，就可以自己下载创建一个demo，他同时会给你把支持包下载下来，不用配置联网相关的东西。
https://yoc.docs.t-head.cn/yocbook/Chapter2-%E5%BF%AB%E9%80%9F%E4%B8%8A%E6%89%8B%E6%8C%87%E5%BC%95/YocTools.html
参考链接里的步骤，不到两页的说明可以让你快速上手，找到成就感。还想吐槽一下，这个软件真大，3.6个多G吧，而且打开速度也很感人，等你嗑个瓜子， 喝口水他可能还在那里启动，可能是功能设计比较复杂，但还是希望简约一点，少占点内存，启动速度快点。
当代码编译链接通过以后，我继续说明一下如何下载验证。以RGB流水灯为例，首先我们把开发板的USB线连上，给开发板上电，默认跳线帽都是连好的， debug和UART都是和2601连接，不用动。这里我说明一下因为开发板带了两根USB，如果条件允许的话可以都接上，虽然我没试过但这样应该就可以避免我只用一根USB线出现的问题，当我按照开发手册只连接一个接串口的USB时，你会发现状态指示灯是ERR红灯亮，别担心，这不是芯片运行错误的意思，只是没有 连接debug的提示，当你插到JTAG那个USB时，BSY绿灯就亮了，同时不用担心电脑USB接口供电不足，烧了USB口，因为我已经替你试过了。我到现在也没看到这个开发板的供电电流要求，我看到有喇叭，所以先使用适配器供电，果然一上电喇叭就工作了，手头没有电流源所以不知道电流多大，我就开始看原理图和开发说明，这也没个说明书，但是字里行间透露着可以直接接电脑，由于我一直用一根USB线，同时先入为主的以为串口和JTAG一样也可以下代码，就没想同时用两根USB一个供电一个debug，我一狠心，大不了废个U口，如果主板烧了我就找平头哥去，哈哈。先用USB集线器供电是不行的，开发板一直重启，说 明供电不足，因为我这个集线器还接着鼠标和键盘，然后单独给他一个USB口就好了。将USB线连接电脑USB口和开发板的有JTAG丝印的USB口，然后将编译完 成的demo下载进去就好了，当然你不会马上看到效果，因为他不支持下载完自动运行，重新上电或者按一下复位按键就看到demo的效果了。
说这么多，在总结一下：拿到开发板跳线帽默认不用动，用USB线将有JTAG丝印的接口连接到电脑USB口，这样硬件就准备好了，你会看到电源指示灯和 BSY绿色状态指示灯亮了，然后语音播报同时OLED 屏幕显示RISC-V，这是初始程序，然后将编译好的RGB流水灯程序下载进行，然后重新上电或者按一下复位 按键就看到demo的效果了。
最后，是我的一些疑问，待下次发帖的时候我会找到答案，同时也希望有大神回帖解决我的疑问，提高我上手的效率。
疑问1：就是那个直接下载的SDK demo如何配置联网去下载支持包，我发现就是没有package？
疑问2：现在虽然可以下载demo了，但是我看了一下代码，这些函数都对我来说都是新的，怎么写，怎么用？这些函数的说明哪里有介绍，比如IO等外设配置，我可以参考demo来写，但是有没有系统讲解？
疑问3：这些应用的开发指南有没有，怎么一步步搭建框架，怎么添加子文件，头文件都有哪些，自己创建的文件怎么添加，什么是一个完整的结构，要想编译 通过都需要那些文件，而不是简单的创建一个空SDK，创建一个flash算法等，如果有现成的文档或视频资料麻烦大神留言，因为我还没有找这些资料，可以节省点时间，谢谢。
|
楼主
标题置顶
标题高亮
