| 12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364 |
- /*
- * File : rt_fota.h
- * COPYRIGHT (C) 2012-2018, Shanghai Real-Thread Technology Co., Ltd
- *
- * Change Logs:
- * Date Author Notes
- * 2019-09-22 warfalcon the first version
- */
- #ifndef _RT_FOTA_H_
- #define _RT_FOTA_H_
- #ifdef __CC_ARM /* ARM Compiler */
- #define RT_FOTA_WEAK __weak
- #elif defined (__IAR_SYSTEMS_ICC__) /* for IAR Compiler */
- #define RT_FOTA_WEAK __weak
- #elif defined (__GNUC__) /* GNU GCC Compiler */
- #define RT_FOTA_WEAK __attribute__((weak))
- #endif /* __CC_ARM */
- /**
- * FOTA firmware encryption algorithm and compression algorithm
- */
- enum rt_fota_algo
- {
- RT_FOTA_CRYPT_ALGO_NONE = 0x0L, /**< no encryption algorithm and no compression algorithm */
- RT_FOTA_CRYPT_ALGO_XOR = 0x1L, /**< XOR encryption */
- RT_FOTA_CRYPT_ALGO_AES256 = 0x2L, /**< AES256 encryption */
- RT_FOTA_CMPRS_ALGO_GZIP = 0x1L << 8, /**< Gzip: zh.wikipedia.org/wiki/Gzip */
- RT_FOTA_CMPRS_ALGO_QUICKLZ = 0x2L << 8, /**< QuickLZ: www.quicklz.com */
- RT_FOTA_CMPRS_ALGO_FASTLZ = 0x3L << 8, /**< FastLZ: fastlz.org/ */
- RT_FOTA_CRYPT_STAT_MASK = 0xFL,
- RT_FOTA_CMPRS_STAT_MASK = 0xFL << 8,
- };
- typedef enum rt_fota_algo rt_fota_algo_t;
- /* FOTA error code */
- typedef enum {
- RT_FOTA_NO_ERR = 0,
- RT_FOTA_GENERAL_ERR = -1, /* general error */
- RT_FOTA_CHECK_FAILED = -2, /* check failed */
- RT_FOTA_ALGO_NOT_SUPPORTED = -3, /* firmware algorithm not supported */
- RT_FOTA_COPY_FAILED = -4, /* copy firmware to destination partition failed */
- RT_FOTA_FW_VERIFY_FAILED = -5, /* firmware verify failed */
- RT_FOTA_NO_MEM_ERR = -6, /* no memory */
- RT_FOTA_PART_READ_ERR = -7, /* partition read error */
- RT_FOTA_PART_WRITE_ERR = -8, /* partition write error */
- RT_FOTA_PART_ERASE_ERR = -9, /* partition erase error */
- } rt_fota_err_t;
- #endif /* _RT_FOTA_H_ */
- int rt_fota_start_application(void);
- /* v1.3.0 升级回滚接口(main.c 的 uart4 屏幕命令 backupapp / dbg_restore / resetapp 亦使用) */
- int rt_fota_backup_app_to_df(void);
- int rt_fota_restore_app_from_df(int consume_backup);
- /* 喂 IWDG(仅在其已被 syswatch 启动时生效):供长耗时 flash 擦/写循环调用 */
- void rt_fota_wdt_feed(void);
- /* v1.3.5:NOR 可用性快速检查(读 JEDEC ID)。返回 0 表示器件无响应,
- * 调用方应跳过 EasyFlash 初始化,避免其对 768 个扇区逐一无效格式化。 */
- int rt_fota_nor_ready(void);
|