-
什么是和唐智能手环固件升级 SDK ?
-
适用范围
需要个性化定制自己的 iOS 智能手环 APP 的合作伙伴。 -
兼容性
- 手环固件升级(不包括空中升级远程下载固件的部分)；
版本V1.3.0 Build202212300001
发布日期：2022年12月30日
功能更新：
1.更新错误码翻译
2.升级Realtek固件升级程序调用方式
3.新增越南语
版本V1.2.9 Build202206300001
发布日期：2022年06月30日
功能更新：
1.升级Realtek固件升级程序，修复固件升级依旧慢的问题
版本V1.2.8 Build202206060001
发布日期：2022年06月06日
功能更新：
1.升级Realtek固件升级程序，修复固件升级慢的问题
版本V1.2.7 Build202206010001
发布日期：2022年06月01日
功能更新：
1. 修正OnStartDFUSuccess没有回调的问题
版本V1.2.6 Build202201260001
发布日期：2022年01月26日
功能更新：
1.升级Realtek固件升级程序，修复固件升级有可能报错的问题
2.升级Realtek固件升级程序，支持8763E平台
3.新增印地语
版本V1.2.5 Build202112180001
发布日期：2021年12月18日
功能更新：
1、升级Realtek固件升级程序，修复固件升级慢的问题。
版本V1.2.4 Build202108230001
发布日期：2021年08月23日
功能更新：
1、修正表盘推送可能失败的问题。
版本V1.2.3 Build202108040001
发布日期：2021年08月04日
功能更新：
1、修正iOS11.4系统固件升级失败的问题。
版本V1.2.2 Build202106040001
发布日期：2021年06月04日
功能更新：
1、Nordic固件升级支持。
版本V1.2.1 Build202102250001
发布日期：2021年02月25日
功能更新：
1、升级Realtek固件升级程序，支持8762D平台。
版本V1.2.0 Build202009280001
发布日期：2020年09月28日
功能更新：
1、新增土耳其语/乌克兰语。
版本V1.1.9 Build202008140001
发布日期：2020年08月14日
功能更新：
1、新增克罗地亚语/阿尔巴尼亚语。
版本V1.1.8 Build202007100001
发布日期：2020年07月10日
功能更新：
1、修正繁体中文翻译。
版本V1.0.7 Build201911220001
发布日期：2019年11月22日
功能更新：
1、新增斯洛伐克语。
版本V1.0.6 Build201911210001
发布日期：2019年11月21日
功能更新：
1、支持非连接状态的外设固件升级。
2、提升升级过程可靠性。
版本V1.0.5 Build201910180001
发布日期：2019年10月18日
功能更新：
1、 修正UI文件升级过程有可能无法进入静默模式的问题。
版本V1.0.4 Build201910160001
发布日期：2019年10月16日
功能更新：
1、 修正iOS13闪退的问题。
版本V1.0.3 Build201909300001
发布日期：2019年09月30日
功能更新：
1、 支持UI文件升级。
版本V1.0.0 Build201905010001
发布日期：2019年05月01日
功能更新：
1、 首次发布SDK版本。
目前尚未开放 APPID 和 APPKEY，暂时无需申请。
方法一：FitCloudDFUKit 支持通过 CocoaPods 安装. 您只需要在您的 Podfile 文件中简单地加上下面这行:
pod 'FitCloudDFUKit'
如果你想集成 beta 测试版，则 Podfile 文件中应该使用如下配置：
pod 'FitCloudDFUKit', git: 'https://github.com/htangsmart/FitCloudPro-SDK-iOS.git'
方法二：从 Github 上下载 FitCloudDFUKit，手动集成到您的项目中。
- FitCloudDFUKit SDK开发包含：
-
FitCloudDFUKit.xcframework 静态库，智能手环固件升级开发套件核心framework
-
FitCloudDFUKit.bundle 智能手环固件升级开发套件核心资源包
-
RTKLEFoundation.xcframework
-
RTKOTASDK.xcframework
-
RTKLocalPlaybackSDK.xcframework
-
将framework添加到项目中;
-
将bundle资源包添加到项目中;
-
添加其他系统依赖库支持：
-
CoreGraphics.framework
-
CoreBluetooth.framework
-
-
在Podfile中添加
pod 'iOSDFULibrary', '4.11.0'
在项目的Info.plist中设置以下隐私权限使用描述，实际描述内容各项目自行设置
#import <FitCloudDFUKit/FitCloudDFUKit.h>[FitCloudDFUKit setDebugMode:YES];
[FitCloudDFUKit setDelegate:self];/**
* @brief 成功启动DFU回调
*/
-(void) OnStartDFUSuccess
{
NSLog(@"成功进入DFU模式, 请勿退出当前界面...");
}
/**
* @brief 启动DFU失败
* @param error 错误信息
*/
-(void) OnStartDFUFailureWithError:(NSError*)error
{
NSString *msg = APP_GET_ERROR_MSG(error);
NSLog(@"固件升级失败，%@...", msg);
}
/**
* @brief 升级进度回调
* @param progress 升级进度百分比(0~100)
* @param index 当前镜像索引，下标从0开始
* @param total 所有镜像数量
*/
-(void) OnDFUProgress:(CGFloat)progress imageIndex:(NSInteger)index total:(NSInteger)total
{
NSLog(@"当前固件升级进度：%2ld%%", (long)roundf(progress));
}
/**
* @brief 意外终止回调
* @param error 错误信息
*/
-(void) OnAbortWithError:(NSError*)error
{
NSString *msg = APP_GET_ERROR_MSG(error);
NSLog(@"固件升级终止，%@...", msg);
}
/**
* @brief 升级完成回调
* @param speed 速度
*/
-(void) OnDFUFinishWithSpeed:(CGFloat)speed
{
NSLog(@"固件升级成功...");
}
/**
*@brief 日志信息回调
*@param message 日志信息
*@param level 日志等级
*/
-(void) OnDFULogMessage:(NSString*)message level:(FCDFUKLogLevel)level
{
//您可以根据实际需要处理日志逻辑
}BOOL silentMode = FALSE;
if([FitCloudKit allConfig].firmware.hardwareSupported & FITCLOUDHARDWARE_DFUSHOULDSILENTMODE)
{
silentMode = TRUE;
}
FITCLOUDDFUCHIPVENDOR chipVendor = FITCLOUDDFUCHIPVENDOR_REALTEK;
[FitCloudDFUKit startWithPeripheral:dfuPeripheral firmware:self.selectedPath chipVendor:chipVendor silentMode:silentMode];Step 1
检查手表的电量，并获得升级的 dfuPeripheral，如果失败，我想你不应该继续接下来的流程。
[FitCloudKit enterDFUModeWithBlock:^(BOOL succeed, CBPeripheral *dfuPeripheral, FITCLOUDCHIPVENDOR chipVendor, NSError *error) {
}Step 2
启动升级，silentMode 参数代表不同类型的升级。
普通固件升级:
BOOL silentMode = FALSE;
if([FitCloudKit allConfig].firmware.hardwareSupported & FITCLOUDHARDWARE_DFUSHOULDSILENTMODE)
{
silentMode = TRUE;
}
UI固件升级/表盘推送/运动推送:
BOOL silentMode = YES;
之后调用：
[FitCloudDFUKit startWithPeripheral:dfuPeripheral firmware:self.selectedPath chipVendor:chipVendor silentMode:silentMode];处理 delegate 与日志回调信息。当升级成功或失败，您需要监听 DFU 模式下的回连通知，就像这样：
[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(OnReconnectWithDFUMode:) name:FITCLOUDEVENT_PERIPHERAL_RECONNECTEDWITHDFUMODE_NOTIFY object:nil];
}
-(void)OnReconnectWithDFUMode:(NSNotification*)notification
{
NSLog(@"%@", APP_LOG_STRING(@"手表重启成功，此次推送%@。", _lastDFUSucceed ? @"成功" : @"失败"));
}Step 3
当您决定不再接着固件升级或者打算退出升级模式时，您需要调用以下方法，回到正常模式，当然此时会断开并重新连接手表。
[FitCloudKit exitDFUModeWithBlock:nil];如果您是对接我们表盘服务器的客户，您可能需要从 SDK 里获得一些参数传给我们的服务器，当然获得这项能力您需要联系我们的商务。
- hardwareInfo
FitCloudAllConfigObject *allConfig = [FitCloudKit allConfig];
FitCloudFirmwareVersionObject* firmware = allconfig.firmware;
NSString* hardwareInfo = [firmware description];- lcd
[FitCloudKit getWatchfaceUIInformationWithBlock:^(BOOL succeed, FitCloudWatchfaceUIInfo* faceUI, NSError* error) {
NSInteger lcd = faceUI.lcd;
}];- toolVersion
[FitCloudKit getWatchfaceUIInformationWithBlock:^(BOOL succeed, FitCloudWatchfaceUIInfo* faceUI, NSError* error) {
NSString* toolVersion = faceUI.toolVersion;
}];Q: 现在支持哪些芯片厂商的固件升级？
A: SDK 已经集成了
Realtek和Nordic厂商的固件升级程序，但由于目前所有手环其实只使用了Realtek的芯片，因此在实际使用过程中，您目前只会使用到Realtek芯片的固件升级。
Q: 普通固件升级与UI升级有什么不同？
A: 通常没有界面的固件升级称之为普通固件升级，涉及界面升级则为UI升级，当然推送表盘属于UI升级。
和唐智能
戴工 / iOS Developer