更新硬件SDK

sdk/合宙/air780e/csdk/luatos-soc-2022/doc/README.md

@@ -0,0 +1,104 @@
+# CSDK for ABCDEGF
+
+## 文档中心
+[CSDK软件开发资料](https://doc.openluat.com/wiki/37?wiki_page_id=4544)
+
+## 介绍
+CSDK for ABCDEGF, 适用于所有基于ABCDEGF的合宙模组, 例如Air780E系列, Air600E系列
+
+## 目录说明
+
+* PLAT 打包好的sdk, 含协议栈, 部分源码, 头文件, 打包工具
+* project 项目文件, 每个不同的项目代表不同的demo或者turnkey方案
+* xmake.lua 主编译脚本, 一般不需要修改
+
+## 编译说明
+
+1. 安装xmake, 选取加入PATH, 建议安装到C:\Program Files下，其他目录可能会出问题；
+   xmake下载地址：https://xmake.io/#/guide/installation
+   windows下可以直接访问：https://github.com/xmake-io/xmake/releases ,下载系统对应的xmake-2.7.3-win32.exe或者xmake-2.7.3-win64.exe即可. 比2.7.3更高的版本也是可以的.
+2. 如果编译example的话在本代码库的根目录执行`build.bat example`进行编译
+4. 生成的binpkg位于`out`目录, 日志数据库文件位于`PLAT`目录
+
+## 加入入口函数
+
+* 加入头文件common_api.h
+* 类似于`void main(void)`，但是可以任意名字，不能有入口参数和返回参数，同时允许多个入口
+* 通过INIT_HW_EXPORT INIT_DRV_EXPORT INIT_TASK_EXPORT这3个宏修饰后，系统初始化的时候会调用function，不同的宏涉及到调用顺序不同
+* 大优先级上`INIT_HW_EXPORT` > `INIT_DRV_EXPORT` > `INIT_TASK_EXPORT`
+* 这3个宏有统一用法`INIT_HW_EXPORT(function, level)`，其中function就是入口函数，level是小优先级，填"0","1","2"...(引号要写的)，引号里数字越小，优先级越高。
+
+* `INIT_HW_EXPORT`一般用于硬件初始化，GPIO之类的，可以没有
+* `INIT_DRV_EXPORT`一般用于外设驱动初始化，初始化外部器件之类的，打开电源，提供时钟之类的，可以没有
+* `INIT_TASK_EXPORT`一般用于初始化任务，用户代码基本上都是跑在任务里，原则上必须有
+
+## 加入自己的项目
+
+1. project新建目录，目录名称和项目名称一致，目录下新建xmake.lua，内容仿照着example写，核心是TARGET_NAME必须和项目名称一致
+2. 代码路径当然不是限制的，在SDK的任何目录，甚至电脑上的其他地方，前提是你会改project里xmake.lua内的源码路径
+3. 根目录执行build.bat 你的项目名称
+
+## 在SDK外存放项目文件的编译方法
+
+假设项目路径是 `D:\github\ABCDEGF-webabc` , 目录结构如下
+
+```
+D:\github
+    - ABCDEGF-webabc
+        - code
+            - xmake.lua
+            - src
+                app_main.c
+                task_mqtt.c
+            - inc
+                app_main.h
+                RTE_Device.h
+        - doc
+            - README.md
+```
+
+编译方式:
+
+```
+set PROJECT_DIR=D:\github\ABCDEGF-webabc\code
+build webabc
+```
+
+注意: code\xmake.lua里面的TARGET_NAME,对应命令行的项目名, `webabc`
+
+恢复到默认项目查找逻辑, 之后就能恢复到 project/xxx 查找xmake.lua
+
+```
+set PROJECT_DIR=
+build luatos
+```
+
+## 在不联网环境下初次编译的补充说明
+
+在有网的环境下, xmake会自行下载gcc工具链. 但如果无法联网, 或者网络受限的情况, 通常会有这种提示:
+
+```
+error: fatal: not a git repository
+```
+
+或者git/http连接失败的提示. 故这里提供离线gcc工具链下载和编译的方法
+
+1. 下载[gcc for arm工具链](http://cdndownload.openluat.com/xmake/toolchains/gcc-arm/gcc-arm-none-eabi-10.3-2021.10-win32.zip)
+2. 解压, 不要选太深的目录, 不要包含中文字符和特殊符号, 建议解压到`D盘根目录`, 压缩包内自带一层目录`gcc-arm-none-eabi-10.3-2021.10`
+3. 假设解压后的路径是 `D:\gcc-arm-none-eabi-10.3-2021.10`, 检查 `D:\gcc-arm-none-eabi-10.3-2021.10\bin\arm-none-eabi-g++.exe` 是否存在, 如果不存在, 那肯定是多一层目录.
+4. 用文本编辑器(例如vscode)打开 `本代码库` 的 `build.bat`, 修改内容如下
+
+```
+原本的内容:
+rem set GCC_PATH=E:\gcc_mcu
+修改成set开头的语句,注意是去掉rem并修改值.
+set GCC_PATH=D:\gcc-arm-none-eabi-10.3-2021.10
+```
+
+`重新打开`一个`命令行cmd`, 进入`本代码库`,执行 `build.bat` 即可正常编译.
+
+5. 测试ok后, 可以考虑将上述环境变量GCC_PATH放入系统的环境变量设置中, 然后还原`build.bat`
+
+## 授权协议
+
+[MIT License](LICENSE)

sdk/合宙/air780e/csdk/luatos-soc-2022/doc/如果chm文件打开内容为空，参考这里描述的解决方法.txt

@@ -0,0 +1,13 @@
+有时候下载了个chm文件，但是打开空白，也没显示什么内容，那么chm文件打开空白无内容怎么办，下面把解决办法分享出来供大家参考下。
+
+　　chm文件打开空白无内容的情况显示如下：
+
+　　如果这是一个很正规的文本，而且下载也没有损坏之类的。先关闭这个文件，右击这个文件，选择属性-查看。
+
+　　在常规里可以看到提示，这个文档来自其他计算机，可能被阻止以帮助保护计算机。
+
+　　如果信任这个文档，点击解除锁定 ，如果觉得不安全的话，那就放弃得了。解除之后就显示如下了：
+
+　　这时再重新打开这个文档测试到可以正常打开了，也正常显示里边的内容了。
+
+　　如果按这种方法还是打不开，排除一下是否文件有没有被损坏或者被杀毒软件禁止等因素。