settings_api.h 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392
  1. /********************************* (C) РОТЕК ***********************************
  2. * @module settings_api
  3. * @file settings_api.h
  4. * @version 1.0.0
  5. * @date XX.XX.XXXX
  6. * $brief settings_api
  7. *******************************************************************************
  8. * @history Version Author Comment
  9. * XX.XX.XXXX 1.0.0 Telenkov D.A. First release.
  10. *******************************************************************************
  11. */
  12. /* Define to prevent recursive ----------------------------------------------*/
  13. #ifndef SETTINGS_API_H
  14. #define SETTINGS_API_H
  15. #include "stm32f4xx.h"
  16. #include <stdbool.h>
  17. #include "d_inouts.h"
  18. /* Максимальная длинна логина и пароля для входа в Web */
  19. #define MAX_WEB_LOGIN_LEN 11
  20. #define MAX_WEB_PASSWD_LEN 11
  21. #define MAX_WEB_COOKIE_LEN 16
  22. /* Максимальная длинна строки параметра, передаваемого в Web */
  23. #define MAX_WEB_PARAM_LEN 64
  24. /* Max WEB users in the system/
  25. * First users are always ADMIN.
  26. * Others are USER */
  27. #define MAX_WEB_USERS 2
  28. #define MAX_WHITE_LIST 5
  29. /**
  30. * @brief Параметры обновления ПО
  31. */
  32. typedef struct
  33. {
  34. uint8_t loadMode; // 0 - основная прошивка, 1 - режим обновления ПО
  35. uint8_t bootTry; // Признак
  36. } BOOT_PARAMS_t;
  37. /**
  38. * @brief Параметры сетевого подключения
  39. */
  40. typedef struct
  41. {
  42. char ip[16];
  43. char gate[16];
  44. char mask[16];
  45. uint8_t dhcpEnable; // 0 - DHCP отключен, 1 - включен
  46. } WEB_PARAMS_t;
  47. /**
  48. * @brief Параметры сетевого подключения
  49. */
  50. typedef struct
  51. {
  52. char ip_range[19];
  53. } WHITE_LIST_t;
  54. /**
  55. * @brief Параметры SNMP
  56. */
  57. typedef struct
  58. {
  59. char sysDescr[160];
  60. char readCommunity[20];
  61. char writeCommunity[20];
  62. char sysContact[50];
  63. char sysName[20];
  64. char sysLocation[110];
  65. char managerIP[20];
  66. char managerIP2[20];
  67. char managerIP3[20];
  68. char managerIP4[20];
  69. char managerIP5[20];
  70. } SNMP_t;
  71. /**
  72. * @brief Информация об устройстве
  73. */
  74. typedef struct
  75. {
  76. char productionData[40]; // Дата производства
  77. char mac[18]; // MAC адрес
  78. char serialNumber[16]; // Серийный номер
  79. char comments[110]; // Комментарии
  80. } DEVICE_INFO_t;
  81. /**
  82. * @brief Флаги, ключи и т.д.
  83. */
  84. typedef struct
  85. {
  86. bool netsettingsChanged; // Признак изменения сетевых настроек пользователем
  87. char testState[16]; // Статус производственного тестирования
  88. } FLAGS_t;
  89. /**
  90. * @brief Уровни пользователей Web.
  91. */
  92. typedef enum
  93. {
  94. ADMIN = 0,
  95. USER,
  96. MAX_USER_LEVELS
  97. } user_level_t;
  98. /**
  99. * @brief Настройки аутентификации.
  100. */
  101. typedef struct
  102. {
  103. user_level_t level;
  104. char login[MAX_WEB_LOGIN_LEN];
  105. char password[MAX_WEB_PASSWD_LEN];
  106. } AUTH_t;
  107. /**
  108. * @brief Параметры SNTP
  109. */
  110. typedef struct
  111. {
  112. bool sntpEnable; // Вкл/выкл
  113. char ip[16]; // Адрес SNTP сервера
  114. char data[30]; // Дата последней синхронизации
  115. float timeZone; // Часовой пояс
  116. } SNTP_t;
  117. /**
  118. * @brief Типы источников срабатывания реле
  119. */
  120. typedef enum
  121. {
  122. #if defined HARDWARE_BT6706 || HARDWARE_BT6708
  123. AC_PRESENT = 1,
  124. DC_PRESENT,
  125. CHARGE_AKB,
  126. OFF_AKB,
  127. #elif HARDWARE_BT6702
  128. CRITICAL = 1,
  129. NON_CRITICAL,
  130. #endif
  131. SNMP_SET,
  132. RO_MAX_SOURCE
  133. } ro_type_source_t;
  134. /**
  135. * @brief Типы источников срабатывания реле
  136. */
  137. typedef enum
  138. {
  139. DI_DISCONN = 0,
  140. DI_CONN,
  141. DI_MAX_ACT
  142. } din_type_act_t;
  143. /**
  144. * @brief Настройки входов/выходов.
  145. */
  146. typedef struct
  147. {
  148. ro_type_source_t ro_type_source[OUTPUTS_TOTAL_COUNT];
  149. din_type_act_t din_type_act[INPUTS_TOTAL_COUNT];
  150. } INOUTS_t;
  151. /**
  152. * @brief Параметры RADIUS
  153. */
  154. typedef struct
  155. {
  156. bool Auth_enable;
  157. char ServerIP[16];
  158. char rds_password[17];
  159. bool RDSEnable; // 0 - отключен, 1 - включен
  160. uint32_t port;
  161. uint32_t key_access;
  162. } RADIUS_t;
  163. /**
  164. * @brief Параметры Telnet
  165. */
  166. typedef struct
  167. {
  168. bool TelnetEnable; // 0 - отключен, 1 - включен
  169. uint32_t port;
  170. } TELNET_t;
  171. /**
  172. * @brief Общая структура настроек
  173. */
  174. typedef struct
  175. {
  176. BOOT_PARAMS_t bootParams;
  177. WEB_PARAMS_t sWebParams;
  178. WEB_PARAMS_t sWebTempParams;
  179. DEVICE_INFO_t sInfo;
  180. uint32_t CritSecCRC;
  181. /* WARNING! До поля CritSecCRC включительно структура настроек должна быть
  182. * идентичной между бутлоадером и основным ПО и не должна изменяться при обновлении ПО.
  183. * Контроль целостности настроек внутри IAP выполняется только для критической секции,
  184. * т.к. контроль целостности всей структуры не имеет смысла
  185. * (структура настроек всегда будет отличаться внутри основного ПО).
  186. * В случае повреждения критического сектора, загружаются параметры по умолчанию. */
  187. FLAGS_t sFlags;
  188. SNMP_t sSnmp;
  189. AUTH_t sAuth[MAX_WEB_USERS];
  190. SNTP_t sSNTP;
  191. INOUTS_t sInOuts;
  192. #ifdef HARDWARE_BT6702
  193. RADIUS_t sRADIUS;
  194. //char our_srv_crt[1205];
  195. char our_srv_crt[1705];
  196. #endif
  197. #if defined HARDWARE_BT6706 || HARDWARE_BT6708
  198. TELNET_t sTelnet;
  199. #endif
  200. #ifdef HARDWARE_BT6708
  201. WHITE_LIST_t sWhiteList[MAX_WHITE_LIST];
  202. #endif
  203. uint32_t controlWorld; // Слово для контроля целостности структуры настроек
  204. } SETTINGS_t;
  205. /**
  206. * @brief
  207. * @retval
  208. */
  209. uint32_t SETTINGS_GetCritSecCRC(void);
  210. /**
  211. * @brief Установить параметры обновления ПО по умолчанию
  212. */
  213. void SETTINGS_SetBootParamsDef(void);
  214. /**
  215. * @brief Установить параметры сетевого подключения по умолчанию
  216. */
  217. void SETTINGS_SetWebParamsDef(void);
  218. /**
  219. * @brief Установить временные параметры сетевого подключения по умолчанию
  220. */
  221. void SETTINGS_SetTempWebParamsDef(void);
  222. /**
  223. * @brief Установить параметры SNMP по умолчанию
  224. */
  225. void SETTINGS_SetSnmpDef(void);
  226. /**
  227. * @brief Установить Информацию об устройстве по умолчанию
  228. */
  229. void SETTINGS_SetInfoDef(void);
  230. /**
  231. * @brief Установить флаги по умолчанию
  232. */
  233. void SETTINGS_SetFlagsDef(void);
  234. /**
  235. * @brief Установить параметры SNTP по умолчанию
  236. */
  237. void SETTINGS_SetSntpDef(void);
  238. /**
  239. * @brief Установить параметры настроек сухих контактов / реле по умолчанию
  240. */
  241. void SETTINGS_SetINOUTSDef(void);
  242. #ifdef HARDWARE_BT6702
  243. /**
  244. * @brief Установить параметры RADIUS по умолчанию
  245. */
  246. void SETTINGS_SetRADIUSDef(void);
  247. /**
  248. * @brief Установить параметры сертификата сервера по умолчанию
  249. */
  250. void SETTINGS_SetSSLcrtDef(void);
  251. #endif
  252. #if defined HARDWARE_BT6706 || HARDWARE_BT6708
  253. /**
  254. * @brief Установить параметры Telnet
  255. */
  256. void SETTINGS_SetTelnetDef(void);
  257. #endif
  258. #if defined HARDWARE_BT6708
  259. /**
  260. * @brief Установить параметры списка доверительных хостов
  261. */
  262. void SETTINGS_SetWhiteListDef(void);
  263. #endif
  264. /**
  265. * @brief Установить значение сервисных настроек по умолчанию
  266. */
  267. void SETTINGS_SetServiceDef(void);
  268. /**
  269. * @brief Очистка сектора настроек
  270. */
  271. void SETTINGS_EraseFlashSector(void);
  272. /**
  273. * @brief Сброс настроек в значения по умолчанию
  274. */
  275. void SETTINGS_SetDefault(void);
  276. /**
  277. * @brief Сброс всех настроек в значения по умолчанию кроме сетевых настроек
  278. */
  279. void SETTINGS_SetPartDefault(void);
  280. /**
  281. * @brief Сброс всех настроек в значения по умолчанию
  282. */
  283. void SETTINGS_SetAllDefault(void);
  284. /**
  285. * @brief Установка настроек для отладки
  286. */
  287. void SETTINGS_SetDefaultDebug(void);
  288. /**
  289. * @brief Запись структуры настроек во flesh
  290. */
  291. void SETTINGS_Save(void);
  292. /**
  293. * @brief Загрузка структуры настроек из flesh
  294. */
  295. void SETTINGS_Load(void);
  296. /**
  297. * @brief
  298. */
  299. void SETTINGS_WriteToFlash(uint8_t *data, uint32_t size);
  300. /**
  301. * @brief
  302. */
  303. void SETTINGS_ReadFromFlash(uint8_t *data, uint32_t size);
  304. /**
  305. * @brief
  306. */
  307. uint32_t SETTINGS_GetCRC(void);
  308. /**
  309. * @brief Сброс флага boottry и сохранение структуры настроек
  310. */
  311. void SETTINGS_ResetBootTry(void);
  312. /**
  313. * @brief Преобразует mac адрес строкового формата в массив uint8_t
  314. * @param mac - буфер для вывода mac адреса
  315. */
  316. void SETTINGS_GetMac(uint8_t *mac);
  317. /**
  318. * @brief Установить дату производства
  319. */
  320. void SETTINGS_SetProDate(char *proDate, uint8_t len);
  321. /**
  322. * @brief Установить статус тестирования "T2OK"
  323. */
  324. void SETTINGS_SetT2OK(void);
  325. /**
  326. * @brief Включить DHCP
  327. */
  328. void SETTINGS_SetDHCPOn(void);
  329. void init_settings(void);
  330. #endif /* #ifndef SETTINGS_API_H */
  331. /********************************* (C) РОТЕК **********************************/