SYD8811SDK

本程序版权属于成都盛芯微科技SYDTEK，更多内容请看官网：http://www.sydtek.com/

#注意:在开发产品之前建议详细阅读:SYDTEK入门指南.pdf 和SYDTEK_STUDIO软件的About栏目下的内容.

使用方法:

这里可以点击右上角的"Code"按钮然后点击"Download ZIP"进行下载
如果您的电脑上安装了Git工具,可以使用下面的方式进行克隆:
国内站点克隆:
git clone --recursive https://gitee.com/SydtekInc/SYD8811SDK.git
国外站点克隆:
git clone --recursive https://github.com/SydtekInc/SYD8811SDK.git

注意:GIT目录的调整(20200923 110431)

从该版本起不再<README.md>文件中追加更新内容,以后的内容更新都放在commit的详细内容中,方便管理以及简化readme.
从该版本起删除并且会增加子模块"SydtekInc inform"该子模块指向仓库"https://gitee.com/SydtekInc/SydtekInc_inform.git".
Studio release工具请从SydtekInc_inform/SYDTEK Studio release获取最新版本或者适合自己的版本
Studio factory工具请从SydtekInc_inform/SYDTEK Studio factory获取最新版本或者适合自己的版本
SydtekInc inform包含了官方所有工具的更新和一些公司的公告

工程简介:

Source Code\SYD8811_ble_peripheral目录中的工程说明

• 1.SYD8811_BLE_UART_notifyen_open_power 这是蓝牙透传的工程,作用是能够把手机APP通过BLE蓝牙发给SYD8811的数据通过串口发送出来给电脑或者其他MCU,同时也可以把电脑或者其他MCU串口发给SYD8811的数据通过BLE蓝牙发送给手机APP,相当于把蓝牙当成一种无线的通讯模块,其中notifyen_open_power的意思是在打开(或者说使能)notify后SYD8811设置UARTEN功能,在SYD8811平台上设置UARTEN功能后串口才能够正常工作,也就是说在未使能notify之前SYD8811是不能够正确接收串口的数据的
• 2.SYD8811_HID 这个是BLE的HID(人机交互)的工程,目前该工程并没有打开睡眠的功能,所以也没有上面关于uarten的设置,在蓝牙鼠标键盘以及遥控器都是基于该工程开发
• 3.SYD8811_BLE_UART_EVBOLED_notifyen_open_power 该工程基于上面的"1.SYD8811_BLE_UART_notifyen_open_power"工程,他们的区别是本工程会在开发板的OLED屏幕上显示一些打印信息,并且LED1会随着工程的运行翻转状态已之表示睡眠的频率
• 4.SYD8811_BLE_UART_GPIO_open_power 该工程基于"1.SYD8811_BLE_UART_notifyen_open_power"工程,这里GPIO_open_power的意思是串口这边增加一个GPIO来作为数据的开始结束信号.该信号默认是高电平;当电脑或者其他MCU要发送串口数据之前先拉低这个GPIO信号,然后发送串口数据;当串口数据发送完成后,拉高该GPIO.然后SYD8811根据这个GPIO来控制UARTEN.相对于"1.SYD8811_BLE_UART_notifyen_open_power"工程,本工程能够做到没有使能notify的时候也能够接收串口数据然后缓存.他们本质的区别是设置UARTEN的时基不同.
• 5.SYD8811_BLE_UART_EVBOLED_Scan 这个工程基于"3.SYD8811_BLE_UART_EVBOLED_notifyen_open_power"工程,他们的区别是本工程去掉广播的功能,改成扫描的功能,本工程也是扫描的例程
• 6.SYD8811_ANCS 这个是ANCS(苹果消息通知中心系统)的demo,用来获取IOS或者IPAD上面的消息,该工程基于Syd8811_ancs_lib.lib

Source Code\SYD8811_peripheral目录中的工程说明

• adc 单纯ADC的工程,适合用来测试ADC
• Capdet_Touch SYD8811/8810芯片内部触摸(Capdet)的例程,芯片内部一共有4个通道的单点触摸,本例程只使用了通道0(GPIO6)
• GPIO 该工程实现了简单的GPIO驱动,包含了4个按键的GPIO输入和4个LED的GPIO输出,在开发板上验证
• GPIO_IRQ 本工程在上面的GPIO工程上把按键4从原来的普通GPIO输出模式改成中断输入的模式
• I2C 本例程用I2C接口驱动一个Gsensor,作为I2C的简单应用和DEMO
• I2C 本例程用I2C接口驱动一个Gsensor(KX022),作为I2C的简单应用和DEMO(因为I2C需要从机配合)
• I2C_OLED12864 本例程用I2C接口驱动OLED(焊接在开发板上),作为驱动OLED的demo,能够在OLED上看到效果
• ISO7816 ISO7816是一个芯片卡的总线接口协议,本工程给了一个驱动卡的简单例程,实现了7816卡的读写
• PWM SYD8811/8810内部集成了3路单通道的低速PWM(PWMx/LEDx时钟源是低速的LPO或者外部晶振,频率是32.768KHZ,在睡眠的时候依旧可以工作)和一路四通道的高速PWM(时钟源和MCU一样,最高64MHZ,在睡眠是不工作),本例程介绍了高/低速PWM的使用
• RTC RTC作为驱动SYD8811/8810内部的RTC模块的例子,这个RTC是一个真正的RTC模块
• SPI_Master_FLASH 在开发板上有一个挂接在SPI1总线上的FLASH,这个是驱动例程
• timer 这个是驱动芯片内部的低速定时器的例,时钟源是低速的LPO或者外部晶振,频率是32.768KHZ,在睡眠的时候依旧可以工作
• wdt 这个是驱动芯片内部的看门狗的例程,看门狗超时芯片就会复位

Source Code\SYD8811_peripheral_misc目录中的工程说明

• adc_VBAT 该工程基于Source Code\SYD8811_peripheral目录下的adc工程,当一个小于3.6V的电池挂在VBAT管脚上的时候可以通过该工程测量电池的电压
• CLK_XO16_To_Gpio 该工程把XO的时钟拉到GPIO来,以便于观察或者其他模块使用,因为RF模块给32MXO晶振做了2分频,所以这里看到的是16MHZ
• flash peotect 该工程介绍了怎么保护代码
• flash_internal_custom_3k 该工程介绍了怎么使用内部协议栈未占用的一段3K的数据(存在flash中),也是所谓的profile_data
• flash_internal_custom_Anysize 该工程怎么使用自定义分配的flash空间，就是所谓的flashdata
• flash_internal_custom_CodeB 该工程把OTA备份区(代码区叫做CODEA,备份区是CODEB)当做一段存储空间给用户使用,最大空间是代码的最大大小减去16KB
• GPIO_Speed 该工程介绍怎么让GPIO的输出或者输入速度更快,主要是采用指针操作,让编译器编译出来的代码更加少
• I2C_OLED12864_buff_irq 该工程来自于Source Code\SYD8811_peripheral\I2C_OLED12864,介绍了怎么使用I2C的中断功能来进行数据发送,具体请看工程目录下的PDF
• SYD8811_BLE_UART_OTA_EX_FLASH 该工程增加OTA外部flash的功能，需要配合SYDTEK BLE V1.2.3版本以上的APK，连接上之后，需要勾选Ex Flash选项之后，才能去选择bin文件升级
• PWM_DUTY 该工程基于Source Code\SYD8811_peripheral目录下的PWM工程,这里增加了动态修改占空比duty的功能
• SYD8811_BLE_UART_QC40_CODE_greater_than_252kbyte 该工程基于Source Code\SYD8811_ble_peripheral目录下的"1.SYD8811_BLE_UART_notifyen_open_power"工程,用于测试QC40芯片配置CODE大小大于252KB的情况
• gpio_High_resistance 该工程介绍了怎么设置高阻态,其实是一种断码屏的应用
• SYD8811_BLE_UART_battary_service 该工程基于Source Code\SYD8811_ble_peripheral目录下的"1.SYD8811_BLE_UART_notifyen_open_power"工程,用于测试battary service,发送电池电量

下面是之前的README.MD的内容,将来不再更新:

2018-12-26
1.第一版

2019-1-24
1.修改触摸的驱动使其有自动校正的功能！

2019-3-22
1.更新SDK中各个工程的协议栈lib文档，涉及的文件如下： "SYD8811_SDK\Source Code\SYD8811_ble_peripheral\3.SYD8811_HID\ble\syd8811_ble_lib.lib" "SYD8811_SDK\Source Code\ble\syd8811_ble_lib.lib" "SYD8811_SDK\Source Code\SYD8811_ble_peripheral\1.SYD8811_UART original\ble\syd8811_ble_lib.lib" "SYD8811_SDK\Source Code\SYD8811_ble_peripheral\1.SYD8811_UART\ble\syd8811_ble_lib.lib" "SYD8811_SDK\SourceCode\SYD8811_ble_peripheral\2.SYD8811_UART_Capdet_Touch\ble\syd8811_ble_lib.lib"

2019-5-22
1、整理Source Code工程的架构，各个文件功能说明如下
A、Driver、Include、Rtt存放8811相关的外设驱动文件
<2>、BLE文件夹存放OTA升级相关文件
<3>、Lib文件夹存放协议栈lib、软件定时器lib、触摸lib
<4>、SYD8811_ble_peripheral文件夹存放8811 BLE相关例程（透传、HID）
<5>、SYD8811_peripheral文件夹存放8811外设相关例程（ADC、PWM、IIC、TIMER、RTC等）
2、更新协议栈lib "SYD8811_SDK\Source Code\Lib\syd8811_ble_lib.lib"
3、按照规定格式，整理SYD8811_ble_peripheral文件夹和SYD8811_peripheral文件夹的各个工程
4、更新Documentation文件下8811手册
<1>、《SYD8811_BLE_DS_v1p1_CN_20190508》
<2>、《SYD8811_BLE_DS_v1p2_EN_20190508》
5、更新tool文件夹下SYDTEK Studio tool
<1>、《SYDTEK Studio release20190521》
6.更新《SYD8811_SDK\Source Code\SYD8811_peripheral》目录下各工程头文件引索目录，比如ADC工程中把“..\adc”改成“..\”
7.修改《SYD8811_SDK\Source Code\SYD8811_peripheral》目录下各工程的《config.h》文件，增加“#define DEBUG”一句话，使用宏“DEBUG”让工程往UART输出log
8.删除《SYD8811_SDK\Source Code\Include\syd_type.h》文件以及各个工程对其的引用
9.增加文件："SYD8811_SDK\Documentation\SYD8811_pinmux_table_20190527.xlsx"，对SYD8811的pinmux进行介绍

2019-6-10
修改《SYDTEK Studio release20190610v3.5.0 》
1.这里务必使用最新的tool，原来的tool可能会出现意想不到的情况！
2.增加文章"SYD8811_SDK release\Documentation\SYD8811内存和代码的分布.pdf"
3.修改了所有带BLE的工程的“profile”文件夹，在OTA的服务中增加上“write without Rspone"属性
4.增加工程《SPI_Master_FLASH_limiting_speed》
5.增加工程《uart1_debug》
6.增加工程《4.SYD8811_BLE_UART_GPIO_open_power》
7.增加工程《5.SYD8811_BLE_UART_EVBOLED_Scan》
8.修改Hpwm的驱动，主要体现在：HPWM_IRQHandler和Hpwm_Init函数！

2019-7-5
1.增加工程《SYD8811_SDK\SourceCode\SYD8811_peripheral_misc\SYD8811_BLE_UART_EVBOLED_notifyen_open_power_XTAL》
2.修改RTT的驱动，使其能够输出浮点函数，替换
3.使用最新版本的《SYDTEK Studio》，版本号为《V3.8.9 20190628.7z》
4.增加工程《SYD8811_SDK\Source Code\SYD8811_peripheral_misc\CLK_XO16_To_Gpio》

2019-7-15
1.增加工程《"SYD8811_SDK\Source Code\SYD8811_peripheral_misc\flash_internal_custom_3k"》
2.增加工程《"SYD8811_SDK\Source Code\SYD8811_peripheral_misc\flash_internal_custom_Anysize"》
3.把涉及到BLE的项目使用timer0改为使用timer1，因为软件定时器系统也使用timer0，涉及到的项目有：
A.SYD8811_SDK\Source Code\SYD8811_ble_peripheral\1.SYD8811_BLE_UART_notifyen_open_power
B.SYD8811_SDK\Source Code\SYD8811_ble_peripheral\3.SYD8811_BLE_UART_EVBOLED_notifyen_open_power
C.SYD8811_SDK\Source Code\SYD8811_ble_peripheral\4.SYD8811_BLE_UART_GPIO_open_power
E.SYD8811_SDK\Source Code\SYD8811_ble_peripheral\5.SYD8811_BLE_UART_EVBOLED_Scan
F.SYD8811_SDK\Source Code\SYD8811_peripheral_misc\SYD8811_BLE_UART_EVBOLED_MAC
G.SYD8811_SDK\SourceCode\SYD8811_peripheral_misc\SYD8811_BLE_UART_EVBOLED_notifyen_open_power_verdor_datas
H.SYD8811_SDK\SourceCode\SYD8811_peripheral_misc\SYD8811_BLE_UART_EVBOLED_notifyen_open_power_XTAL
I.SYD8811_SDK\Source Code\SYD8811_peripheral_misc\SYD8811_BLE_UART_LowPower
J.SYD8811_SDK\SourceCode\SYD8811_peripheral_misc\SYD8811_BLE_UART_notifyen_open_power_restartadv
修改在send_to_master和timer_1_callback两个函数中

20190729
1.修改RTT驱动，让keil显示实际使用的内存，涉及到所有使用RTT的程序,修改的文件是"Source Code\Rtt\SEGGER_RTT.C""和"\Source Code\RTT\SEGGER_RTT_Conf.h"
2.更新最新版本的“SYDTEK_Studio”，版本号为V4.2.2

20190812
1.增加工程《"SYD8811_SDK\Source Code\SYD8811_ble_peripheral\6.SYD8811_ANCS"》
2.增加工程《"SYD8811_SDK\Source Code\SYD8811_peripheral_misc\SYD8811_UART_OTA"》
3.修改工程《“SYD8811_SDK\Source Code\SYD8811_ble_peripheral\2.SYD8811_HID”》

20190828 172839 1.增加工程《"SYD8811_SDK\Source Code\SYD8811_peripheral_misc\SYD8811_dtm_tx"》
2.增加工程《"SYD8811_SDK\Source Code\SYD8811_peripheral_misc\SYD8811_dtm_rx"》
3.修改RTC驱动Syd8811_softtimer_lib.lib
4.SYDTEK Studio更新到V4.4.8版本<SYDTEK Studio release V4.4.8 20190828 173034>

20190918 164058
1.增加工程《"SYD8811_SDK\Source Code\SYD8811_peripheral\GPIO_IRQ"》
2.增加文件《SYD8810_pinmux_table_20190917 144554》
3.在“Documentation”目录中增加SYD8810规格书并且更新SYD8811规格书
4.更新"tool"目录下，SYDTEK Studio版本到V4.6.2
5.增加工程“Source Code\SYD8811_peripheral_misc\flash peotect”
6.增加工程“flash_internal_custom_CodeB”
7.更新插件“SYD8811_512kB_Flash.FLM”

20191011 202207
1.更新"tool"目录下，SYDTEK Studio版本到V4.9.5
2.更新插件“SYD8811_512kB_Flash.FLM”
3.增加工程“Source Code\SYD8811_peripheral_misc\SYD8811_dtm_tx_adjust_power”
4.更新协议栈lib为“syd8811_ble_lib20191025.lib”
5.增加工程“Source Code\SYD8811_peripheral_misc\SYD8811_BLE_UART_OTA_FLASHDATA”
6.更新协议栈lib为“syd8811_ble_lib20191113.lib”
7.增加工程“Source Code\SYD8811_peripheral_misc\SYD8811_BLE_UART_BLE_Duplex

20191120 163458
1.更新协议栈lib为“syd8811_ble_lib20191115.lib”
2.修改各个带蓝牙OTA的工程，在睡眠前加上“if( ota_state == 1) ota_manage(); //OTA擦除命令到来，马上擦除”
3.更新协议栈lib为“syd881120191122.lib”
4.增加工程“Source Code\SYD8811_peripheral_misc\SYD8811_BLE_UART_OTA_FLASHDATA_size”
5.syd8811_ble_lib20191128.lib”
6.更新HID例程的Profilem,请看“\Source Code\SYD8811_ble_peripheral\2.SYD8811_HID”
7.增加工程“Source Code\SYD8811_peripheral_misc\adc_VBAT”并且更新gpadc.c文件，使之能够计算出VBAT

20191209 145405 1.更新协议栈lib为“syd8811_ble_lib20191209.lib”
2.修改ADC校准方式，涉及工程为“SYD8811_SDK\Source Code\SYD8811_peripheral\adc”和“SYD8811_SDK\Source Code\SYD8811_peripheral_misc\adc_VBAT”
3.增加工程“SYD8811_SDK\Source Code\SYD8811_peripheral_misc\SYD8811_BLE_UART_notifyen_open_power_RSSI”
4.增加工程“SYD8811_SDK\Source Code\SYD8811_peripheral_misc\SYD8811_HID_Music_play”
5.修改OTA.C文件，在ota_cmd函数中的“if(((int)p_cmd % 4)!=0)”及其else分子中把“if(ota_state==2)”条件改为“if((ota_state==2) || (ota_state==1))”，“if(ota_state==8)”条件改为“if((ota_state==8) || (ota_state==7))”，本次修改涉及到SDK中所有带有OTA功能的工程！
6.更新"tool"目录下，SYDTEK Studio版本到V4.9.8 20191213 145803
7.增加工程“SYD8811_SDK\Source Code\SYD8811_peripheral_misc\GPIO_Speed
8.更新文件“"Documentation\SYD8810_pinmux_table_20191225 144444.xlsx"”
9.增加工程“SYD8811_SDK\Source Code\SYD8811_peripheral_misc\SYD8811_BLE_calender”
10.更新"tool"目录下，SYDTEK Studio版本到SYDTEK Studio release v5.0.1 20191227 224019
11.更新协议栈lib为“syd8811_ble_lib20200110 182231.lib”
12.增加工程“SYD8811_SDK\Source Code\SYD8811_peripheral_misc\SYD8811_BLE_mixture_banding
13.更新"tool"目录下，SYDTEK Studio版本到SYDTEK Studio release V5.2.0 20200110 145356
14.更新"tool"目录下，SYD Service Utility版本到SYD Service Utility release V2.2 20200110 102733

20200114 155843 1.更新文件“SYD8810_pinmux_table_20200114 155902”、“SYD8811_pinmux_table_20200114 155924.xlsx”
2.增加工程“\Source Code\SYD8811_peripheral_misc\SYD8811_BLE_Reset_at_Gpio21”
3.在“Documentation”目录增加文件：SYD_8811_BLE_Library.pdf，SYD8811_Register_Discription_V1.xls
4.更新文档“SYD8811_pinmux_table.xlsx”和“SYD8810_pinmux_table.xlsx”
5.修改“lib.h”中的“SYSTEM_CLOCK_16M_XOSC”为“SYSTEM_CLOCK_32M_XOSC”
6.增加文件“SYD8810 透传硬件资料(layout未完成)20200304 104323.7z”和SYD8811 透传硬件资料20191106 164501.7z

20200305 201724 修改BLE工程中关于使用32.768KHz外部晶振的gpio管脚配置的bug，涉及到所有带BLE功能的工程，修改全部在gpio_init函数中，修改方式如下
#ifndef USER_32K_CLOCK_RCOSC
case GPIO_0:
case GPIO_1:
break;
#endif

20200307 182645 1.增加工程：Source Code\SYD8811_peripheral_misc\HPWM_Complementary_Output,实现高速PWM的互补和死区输出！并且去掉Hpwm_Init函数重得语句：NVIC_EnableIRQ(HPWM_IRQn)，原因如下 安装原来的驱动方式，会在HPWM_IRQHandler中断函数中动态修改占空比，这样不方便测试的时候看结果，这里把中断关闭后，显示的波形就是代码设置的波形
2.增加工程：Source Code\SYD8811_peripheral_misc\SYD8811_BLE_UART_TX,
3.修改SDK中透传工程中串口的bug，bug如下：
配置串口优先级，
打开定时器唤醒源
串口加上uart_0_ClrFiFo
涉及到的工程有：
\Source Code\SYD8811_peripheral_misc\SYD8811_BLE_UART_BLE_Duplex
Source Code\SYD8811_ble_peripheral\1.SYD8811_BLE_UART_notifyen_open_power
\Source Code\SYD8811_ble_peripheral\4.SYD8811_BLE_UART_GPIO_open_power
4.增加工程：Source Code\SYD8811_peripheral_misc\SYD8811_Who_Wackup,
5.修改文档“SYD8810_pinmux_table”和“SYD8811_pinmux_table”，把GPIO21的默认功能改成GPIO，而不是复位
6.增加工程：Source Code\SYD8811_peripheral_misc\SYD8811_HID_Service_Change,
7.更新协议栈lib文件，syd8811_ble_lib20200408 145619.lib
8.增加工程：Source Code\SYD8811_peripheral_misc\SYD8811_BLE_AES,注意这个工程只有在syd8811_ble_lib20200410 075415.lib之后的lib才有用
9.SYD8811SKD新增Freertos DEMO以及相关文件
10.增加用IO模拟的三线SPI："Source Code\SYD8811_peripheral_misc\SYD8811 LIS3DH Gsensor_3iospi"
11.增加硬件三线SPI也就是SPI0的工程："Source Code\SYD8811_peripheral_misc\ThreeTwo-wire SPI"