settings_api.h 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480
  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. uint32_t ip;
  54. uint32_t mask;
  55. } WHITE_LIST_t;
  56. /**
  57. * @brief Описание устройства системный параметр SNMP
  58. */
  59. typedef struct
  60. {
  61. char description[160];
  62. uint16_t len;
  63. } SNMP_SYS_DESCR_t;
  64. /**
  65. * @brief Контактная информация системный параметр SNMP
  66. */
  67. typedef struct
  68. {
  69. char contact[50];
  70. uint16_t len;
  71. } SNMP_SYS_CONTACT_t;
  72. /**
  73. * @brief Название устройства системный параметр SNMP
  74. */
  75. typedef struct
  76. {
  77. char name[20];
  78. uint16_t len;
  79. } SNMP_SYS_NAME_t;
  80. /**
  81. * @brief Местоположение устройства системный параметр SNMP
  82. */
  83. typedef struct
  84. {
  85. char location[110];
  86. uint16_t len;
  87. } SNMP_SYS_LOCATION_t;
  88. /**
  89. * @brief Параметры SNMP
  90. */
  91. typedef struct
  92. {
  93. SNMP_SYS_DESCR_t sysDesc;
  94. char readCommunity[20];
  95. char writeCommunity[20];
  96. SNMP_SYS_CONTACT_t sysContact;
  97. SNMP_SYS_NAME_t sysName;
  98. SNMP_SYS_LOCATION_t sysLocation;
  99. char managerIP[20];
  100. char managerIP2[20];
  101. char managerIP3[20];
  102. char managerIP4[20];
  103. char managerIP5[20];
  104. } SNMP_t;
  105. /**
  106. * @brief Информация об устройстве
  107. */
  108. typedef struct
  109. {
  110. char productionData[40]; // Дата производства
  111. char mac[18]; // MAC адрес
  112. char serialNumber[16]; // Серийный номер
  113. char comments[110]; // Комментарии
  114. } DEVICE_INFO_t;
  115. /**
  116. * @brief Флаги, ключи и т.д.
  117. */
  118. typedef struct
  119. {
  120. bool netsettingsChanged; // Признак изменения сетевых настроек пользователем
  121. char testState[16]; // Статус производственного тестирования
  122. } FLAGS_t;
  123. /**
  124. * @brief Уровни пользователей Web.
  125. */
  126. typedef enum
  127. {
  128. ADMIN = 0,
  129. USER,
  130. MAX_USER_LEVELS
  131. } user_level_t;
  132. /**
  133. * @brief Настройки аутентификации.
  134. */
  135. typedef struct
  136. {
  137. user_level_t level;
  138. char login[MAX_WEB_LOGIN_LEN];
  139. char password[MAX_WEB_PASSWD_LEN];
  140. } AUTH_t;
  141. /**
  142. * @brief Параметры SNTP
  143. */
  144. typedef struct
  145. {
  146. bool sntpEnable; // Вкл/выкл
  147. char ip[16]; // Адрес SNTP сервера
  148. char data[30]; // Дата последней синхронизации
  149. float timeZone; // Часовой пояс
  150. } SNTP_t;
  151. /**
  152. * @brief Типы источников срабатывания реле
  153. */
  154. typedef enum
  155. {
  156. #if defined HARDWARE_BT6706
  157. AC_PRESENT = 1,
  158. DC_PRESENT,
  159. CHARGE_AKB,
  160. OFF_AKB,
  161. #elif HARDWARE_BT6702
  162. CRITICAL = 1,
  163. NON_CRITICAL,
  164. #endif
  165. SNMP_SET,
  166. RO_MAX_SOURCE
  167. } ro_type_source_t;
  168. /**
  169. * @brief Типы источников срабатывания реле
  170. */
  171. typedef enum
  172. {
  173. DI_DISCONN = 0,
  174. DI_CONN,
  175. DI_MAX_ACT
  176. } din_type_act_t;
  177. /**
  178. * @brief Настройки диапазона уровней Аварий.
  179. */
  180. typedef struct
  181. {
  182. float high;
  183. float low;
  184. float hyst;
  185. } ALARM_LEVEL_RANGE_t;
  186. /**
  187. * @brief Настройки Аварий.
  188. */
  189. typedef struct
  190. {
  191. ALARM_LEVEL_RANGE_t load_range;
  192. ALARM_LEVEL_RANGE_t ac_output_range;
  193. ALARM_LEVEL_RANGE_t Temprature_range;
  194. } ALARM_MNGR_t;
  195. typedef enum{
  196. ups_kestar,
  197. ups_voltronic,
  198. type_ups_max
  199. } typeUPSEnums_t;
  200. /**
  201. * @brief Настройки ИБП.
  202. */
  203. typedef struct
  204. {
  205. float Ucellmin;
  206. float Ucellmax;
  207. uint8_t type_ups;
  208. } UPS_Setting_t;
  209. #ifndef HARDWARE_BT6708
  210. /**
  211. * @brief Настройки входов/выходов.
  212. */
  213. typedef struct
  214. {
  215. ro_type_source_t ro_type_source[OUTPUTS_TOTAL_COUNT];
  216. din_type_act_t din_type_act[INPUTS_TOTAL_COUNT];
  217. } INOUTS_t;
  218. #endif
  219. /**
  220. * @brief Параметры RADIUS
  221. */
  222. typedef struct
  223. {
  224. bool Auth_enable;
  225. char ServerIP[16];
  226. char rds_password[17];
  227. bool RDSEnable; // 0 - отключен, 1 - включен
  228. uint32_t port;
  229. uint32_t key_access;
  230. } RADIUS_t;
  231. /**
  232. * @brief Параметры Telnet
  233. */
  234. typedef struct
  235. {
  236. bool TelnetEnable; // 0 - отключен, 1 - включен
  237. uint32_t port;
  238. } TELNET_t;
  239. /**
  240. * @brief Общая структура настроек
  241. */
  242. typedef struct
  243. {
  244. BOOT_PARAMS_t bootParams;
  245. WEB_PARAMS_t sWebParams;
  246. WEB_PARAMS_t sWebTempParams;
  247. DEVICE_INFO_t sInfo;
  248. uint32_t CritSecCRC;
  249. /* WARNING! До поля CritSecCRC включительно структура настроек должна быть
  250. * идентичной между бутлоадером и основным ПО и не должна изменяться при обновлении ПО.
  251. * Контроль целостности настроек внутри IAP выполняется только для критической секции,
  252. * т.к. контроль целостности всей структуры не имеет смысла
  253. * (структура настроек всегда будет отличаться внутри основного ПО).
  254. * В случае повреждения критического сектора, загружаются параметры по умолчанию. */
  255. FLAGS_t sFlags;
  256. SNMP_t sSnmp;
  257. AUTH_t sAuth[MAX_WEB_USERS];
  258. SNTP_t sSNTP;
  259. #ifndef HARDWARE_BT6708
  260. INOUTS_t sInOuts;
  261. #endif
  262. UPS_Setting_t UPS_Setting;
  263. ALARM_MNGR_t sAlarmManager;
  264. #ifdef HARDWARE_BT6702
  265. RADIUS_t sRADIUS;
  266. //char our_srv_crt[1205];
  267. char our_srv_crt[1705];
  268. #endif
  269. #if defined HARDWARE_BT6706 || HARDWARE_BT6708
  270. TELNET_t sTelnet;
  271. #endif
  272. #ifdef HARDWARE_BT6708
  273. WHITE_LIST_t sWhiteList[MAX_WHITE_LIST];
  274. WHITE_LIST_t sWhiteListTemp[MAX_WHITE_LIST];
  275. #endif
  276. uint32_t controlWorld; // Слово для контроля целостности структуры настроек
  277. } SETTINGS_t;
  278. /**
  279. * @brief
  280. * @retval
  281. */
  282. uint32_t SETTINGS_GetCritSecCRC(void);
  283. /**
  284. * @brief Установить параметры обновления ПО по умолчанию
  285. */
  286. void SETTINGS_SetBootParamsDef(void);
  287. /**
  288. * @brief Установить параметры сетевого подключения по умолчанию
  289. */
  290. void SETTINGS_SetWebParamsDef(void);
  291. /**
  292. * @brief Установить временные параметры сетевого подключения по умолчанию
  293. */
  294. void SETTINGS_SetTempWebParamsDef(void);
  295. /**
  296. * @brief Установить параметры SNMP по умолчанию
  297. */
  298. void SETTINGS_SetSnmpDef(void);
  299. /**
  300. * @brief Установить Информацию об устройстве по умолчанию
  301. */
  302. void SETTINGS_SetInfoDef(void);
  303. /**
  304. * @brief Установить наcтройки менеджера Аварий по умолчанию
  305. */
  306. void SETTINGS_SetAlarmManagerDef(void);
  307. /**
  308. * @brief Установить флаги по умолчанию
  309. */
  310. void SETTINGS_SetFlagsDef(void);
  311. /**
  312. * @brief Установить параметры SNTP по умолчанию
  313. */
  314. void SETTINGS_SetSntpDef(void);
  315. /**
  316. * @brief Установить параметры настроек сухих контактов / реле по умолчанию
  317. */
  318. #ifndef HARDWARE_BT6708
  319. void SETTINGS_SetINOUTSDef(void);
  320. #endif
  321. #ifdef HARDWARE_BT6702
  322. /**
  323. * @brief Установить параметры RADIUS по умолчанию
  324. */
  325. void SETTINGS_SetRADIUSDef(void);
  326. /**
  327. * @brief Установить параметры сертификата сервера по умолчанию
  328. */
  329. void SETTINGS_SetSSLcrtDef(void);
  330. #endif
  331. #if defined HARDWARE_BT6706 || HARDWARE_BT6708
  332. /**
  333. * @brief Установить параметры Telnet
  334. */
  335. void SETTINGS_SetTelnetDef(void);
  336. #endif
  337. #if defined HARDWARE_BT6708
  338. /**
  339. * @brief Установить параметры списка доверительных хостов
  340. */
  341. void SETTINGS_SetWhiteListDef(void);
  342. #endif
  343. /**
  344. * @brief Установить значение сервисных настроек по умолчанию
  345. */
  346. void SETTINGS_SetServiceDef(void);
  347. /**
  348. * @brief Очистка сектора настроек
  349. */
  350. void SETTINGS_EraseFlashSector(void);
  351. /**
  352. * @brief Сброс настроек в значения по умолчанию
  353. */
  354. void SETTINGS_SetDefault(void);
  355. /**
  356. * @brief Сброс всех настроек в значения по умолчанию кроме сетевых настроек
  357. */
  358. void SETTINGS_SetPartDefault(void);
  359. /**
  360. * @brief Сброс всех настроек в значения по умолчанию
  361. */
  362. void SETTINGS_SetAllDefault(void);
  363. /**
  364. * @brief Установка настроек для отладки
  365. */
  366. void SETTINGS_SetDefaultDebug(void);
  367. /**
  368. * @brief Запись структуры настроек во flesh
  369. */
  370. void SETTINGS_Save(void);
  371. /**
  372. * @brief Загрузка структуры настроек из flesh
  373. */
  374. void SETTINGS_Load(void);
  375. /**
  376. * @brief
  377. */
  378. void SETTINGS_WriteToFlash(uint8_t *data, uint32_t size);
  379. /**
  380. * @brief
  381. */
  382. void SETTINGS_ReadFromFlash(uint8_t *data, uint32_t size);
  383. /**
  384. * @brief
  385. */
  386. uint32_t SETTINGS_GetCRC(void);
  387. /**
  388. * @brief Сброс флага boottry и сохранение структуры настроек
  389. */
  390. void SETTINGS_ResetBootTry(void);
  391. /**
  392. * @brief Преобразует mac адрес строкового формата в массив uint8_t
  393. * @param mac - буфер для вывода mac адреса
  394. */
  395. void SETTINGS_GetMac(uint8_t *mac);
  396. /**
  397. * @brief Установить дату производства
  398. */
  399. void SETTINGS_SetProDate(char *proDate, uint8_t len);
  400. /**
  401. * @brief Установить статус тестирования "T2OK"
  402. */
  403. void SETTINGS_SetT2OK(void);
  404. /**
  405. * @brief Включить DHCP
  406. */
  407. void SETTINGS_SetDHCPOn(void);
  408. void init_settings(void);
  409. #endif /* #ifndef SETTINGS_API_H */
  410. /********************************* (C) РОТЕК **********************************/