如何使用OTA-远程升级组件_物联网终端操作系统(AliOS Things)-阿里云帮助中心

本文介绍OTA-远程升级组件所提供的相关方法说明，支持的硬件平台列表以及参考示例代码。

硬件平台

产品型号	是否支持	硬件类型	固件版本号
HaaS510	是	DTU	4.0.1
HaaS520	是	DTU	4.0.1
HaaS530	是	DTU	4.0.1
HaaS531	是	DTU	4.0.1
HaaS632-LT32V	是	蜂窝模组	4.0.1
HaaS600-EC600S	是	蜂窝模组	4.0.1
HaaS600-EC600N	是	蜂窝模组	4.0.1
HaaS600-EC600U	是	蜂窝模组	4.0.1
HaaS600-N715	是	蜂窝模组	4.0.1

open(Object option)

创建一个OTA实例。

入参

属性	类型	是否必填	描述
iot	Text	是	传入IoT组件的`device handle`。

OTA实例，返回空表示失败。

report(Object option)

上报版本号。

入参

属性	类型	是否必填	描述
device_handle	Number	是	传入IoT组件的`device handle`指针。
product_key	String	是	设备的产品密钥。
device_name	String	是	设备名称。
module_name	String	是	模块名称。
version	String	是	模块的版本号。

无。

OTA触发事件： new

上报属性

属性	类型	是否必填	描述
url	String	是	下载文件的URL。
length	Number	是	固件的大小。
module_name	String	是	模块名称。
version	String	是	固件的版本号。
hash	String	是	Hash值。
hash_type	String	是	Hash类型。

dowload(Object option, Function callback)

下载文件。

入参

属性	类型	是否必填	描述
url	String	是	下载文件的URL。
store_path	String	是	存储下载文件的路径包括文件名称。
callback	Function	是	下载完后的回调函数。

无。

verify(Object option, Function callback)

校验下载的文件。

入参

属性	类型	是否必填	描述
length	String	是	下载文件的长度。
hash_type	String	是	Hash类型。 md5。 sha256。
store_path	String	是	存储下载文件的路径。
callback	Functiom	是	校验结果的回调函数。

无。

upgrade(Object option, Function callback)

新脚本覆盖和加载。

入参

属性	类型	是否必填	描述
length	String	是	下载文件的长度。
store_path	String	是	存储下载文件的路径。
install_path	String	是	安装脚本的路径。
callback	Function	是	升级成功的回调函数。

无。

sysUpgrade(Object option, Function callback)

系统固件升级，当module_name = system时调用此函数。

入参

属性	类型	是否必填	描述
length	String	是	下载文件的长度。
hash_type	String	是	Hash类型。 md5。 sha256。
hash	String	是	固件Hash值。
module_name	Function	是	模块名称。
version	String	是	模块的版本号。
url	Function	是	下载文件的URL。

升级成功设备会重启，失败会返回非0值。

unpack(Object option, Function callback)

资源文件升级解包。

入参

属性	类型	是否必填	描述
length	String	是	下载文件的长度。
store_path	String	是	存储文件的路径。
unpack_path	String	是	要解压文件的路径。
callback	Functiom	是	解压完成的回调函数。

无。

failreport(Object option)

升级过程异常时，上报云端。

入参

属性	类型	是否必填	描述
device_handle	Number	是	下载文件的长度。
product_key	String	是	设备的产品密钥。
device_name	String	是	设备名称。
module_name	String	是	模块名称。
msg	String	是	异常原因。

0：表示成功。
其他：表示失败。

示例代码

import * as network from 'network';
import * as iot from 'iot';
import * as appota from 'appota'
import * as fs from 'fs'

/* device info */
var productKey = '';      /* your productKey */
var deviceName = '';      /* your deviceName */
var deviceSecret = '';  /* your deviceSecret */
var app_module_name = 'default';
var default_ver = '1.0.0';
var resource_module_name = 'resource';
var resource_ver = '0.0.0';
var resource_ver_file_path = 'jsamp/resource.json';

var ota;
var device;
var status;

/* download info */
var info = {
  url: '',
  store_path:'jsamp/pack.bin', 
  install_path:'jsamp/', 
  unpack_path:'jsamp/',
  length: 0,
  hashType: '',
  hash: ''
}

function createDevice(){
  if (!(iot && iot.device)) {
    throw new Error("iot: [failed] require(\'iot\')");
  }
  console.log('iot: [success] require(\'iot\')');
  
  device = iot.device({
    productKey: productKey,
    deviceName: deviceName,
    deviceSecret: deviceSecret,
    region: 'cn-shanghai',
  });
  
  device.on('connect', function() {
    console.log('iot device connected success!');
    var iotDeviceHandle = device.getDeviceHandle();
    ota = appota.open(iotDeviceHandle);
    var res = ota.report({
      device_handle: iotDeviceHandle,
      product_key: productKey,
      device_name: deviceName,
      module_name: app_module_name,
      version: default_ver
    });
    console.log('report resource module ver!');
    var fsize = fs.fileSize(resource_ver_file_path);
    if (fsize <= 0) {
      resource_ver = '0.0.0';
    }
    else {
      console.log('==================');
      var resource_info_value = fs.readSync(resource_ver_file_path);
      var sver = JSON.parse(resource_info_value);
      console.log('resource ver ' + sver.version);
      resource_ver = sver.version;
    }
    var res = ota.report({
      device_handle: iotDeviceHandle,
      product_key: productKey,
      device_name: deviceName,
      module_name: resource_module_name,
      version: resource_ver
    });
    ota.on('new', function(res) {
      console.log('length is ' + res.length);
      console.log('module_name is ' + res.module_name);
      console.log('version is ' + res.version);
      console.log('url is ' + res.url);
      console.log('hash is ' + res.hash);
      console.log('hash_type is ' + res.hash_type);
      
      info.url = res.url;
      info.length = res.length;
      info.module_name = res.module_name;
      info.version = res.version;
      info.hash = res.hash;
      info.hashType = res.hash_type;
      
      if (info.module_name == 'system')
      {
        console.log('download system bin.');
        ota.sysUpgrade({
          length: info.length,
          hash_type: info.hashType,
          hash: info.hash,
          module_name: info.module_name,
          version: info.version,
          url: info.url
        }, function(res) {
          if (res >= 0) {
            console.log('system upgrade success');
          } else {
            console.log('system upgrade failed.');
          }
        })
      }
      else if (info.module_name == 'default') {
        ota.download({
          url: info.url,
          store_path: info.store_path
        }, function(res) {
          if (res >= 0) {
            console.log('verify start');
            console.log(info.hashType);
            ota.verify({
              length: info.length,
              hash_type: info.hashType,
              hash: info.hash,
              store_path: info.store_path
            }, function(res) {
              if (res >= 0) {
                ota.upgrade({
                  length: info.length,
                  store_path: info.store_path,
                  install_path: info.install_path
                }, function(res) {
                  if (res < 0) {
                    console.log('upgrade success')
                  }
                })
              } else {
                console.log('verify failed');
              }
            })
          } else {
            console.log('download failed');
          }
        });
      }
      else if (info.module_name == 'resource') {
        console.log('module name:  resource, begin download');
        ota.download({
          url: info.url,
          store_path: info.store_path
        }, function(res) {
          if (res >= 0) {
            console.log('resource verify start');
            console.log(info.hashType);
            ota.verify({
              length: info.length,
              hash_type: info.hashType,
              hash: info.hash,
              store_path: info.store_path
            }, function(res) {
              if (res >= 0) {
                ota.unpack({
                  length: info.length,
                  store_path: info.store_path,
                  unpack_path: info.unpack_path
                }, function(res) {
                  if (res >= 0) {
                    console.log('unpack success');
                    var new_fsize = fs.fileSize(resource_ver_file_path);
                    if (new_fsize <= 0) {
                      console.log('new resource file ' + resource_ver_file_path + 'size is 0');
                    }
                    else {
                      console.log('==================');
                      var new_info_value = fs.readSync(resource_ver_file_path);
                      console.log('new resource ' + new_info_value);
                      var new_ver = JSON.parse(new_info_value);
                      console.log('new resource ver ' + new_ver.version);
                      resource_ver = new_ver.version;
                    }
                    var res = ota.report({
                      device_handle: iotDeviceHandle,
                      product_key: productKey,
                      device_name: deviceName,
                      module_name: resource_module_name,
                      version: resource_ver
                    });
                  }
                  else {
                    console.log('unpack fail');
                  }
                })
              } else {
                console.log('resource verify failed');
              }
            });
          } else {
            console.log('resource download failed');
          }
        });
        console.log('resource download finish');
      }
    });
  })
}

var net=network.openNetWorkClient();
var status=net.getStatus();
console.log('net status is: '+status);

if (status=='connect') {
  createDevice();
}else{
  net.on('connect',function(){
    console.log('net is connected success!');
    createDevice();
  });
}