settings_api.h 16 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663
  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. #include "common_config.h"
  19. #include "lwip/opt.h"
  20. #include "lwip/ip.h"
  21. /* Предельные границы настроек */
  22. #define MAX_VOLT_CELL_RANGE 3.0
  23. #define MIN_VOLT_CELL_RANGE 0
  24. #define MAX_VAC_MAX_RANGE 250
  25. #define MAX_VAC_MIN_RANGE 220
  26. #define MIN_VAC_MAX_RANGE 200
  27. #define MIN_VAC_MIN_RANGE 110
  28. #define HIST_VAC_MAX_RANGE 30
  29. #define HIST_VAC_MIN_RANGE 10
  30. #define MAX_TEMP_MAX_RANGE 80
  31. #define MAX_TEMP_MIN_RANGE 40
  32. #define MIN_TEMP_MAX_RANGE 0
  33. #define MIN_TEMP_MIN_RANGE -40
  34. #define HIST_TEMP_MAX_RANGE 2
  35. #define HIST_TEMP_MIN_RANGE 0.5
  36. #define MAX_LOAD_MAX_RANGE 120
  37. #define MAX_LOAD_MIN_RANGE 60
  38. #define HIST_LOAD_MAX_RANGE 2
  39. #define HIST_LOAD_MIN_RANGE 0.5
  40. #define LIFETIME_MIN_RANGE 1
  41. #define LIFETIME_MAX_RANGE 10
  42. #define CAPACITY_MIN_RANGE 1
  43. #define CAPACITY_MAX_RANGE 200
  44. #define AKB_VOLTAGE_MIN_RANGE 12
  45. #define AKB_VOLTAGE_MAX_RANGE 240
  46. #define UPS_POWER_MIN_RANGE 400
  47. #define UPS_POWER_MAX_RANGE 10000
  48. /* Максимальная длинна логина и пароля для входа в Web */
  49. #define MAX_WEB_LOGIN_LEN 11
  50. #define MAX_WEB_PASSWD_LEN 11
  51. #define MAX_WEB_COOKIE_LEN 16
  52. /* Максимальная длинна строки параметра, передаваемого в Web */
  53. #define MAX_WEB_PARAM_LEN 64
  54. /* Max WEB users in the system/
  55. * First users are always ADMIN.
  56. * Others are USER */
  57. #define MAX_WEB_USERS 2
  58. #define MAX_WHITE_LIST 5
  59. /**
  60. * @brief Уровни пользователей Web.
  61. */
  62. typedef enum
  63. {
  64. ALL_DEFAULT = 0,
  65. PART_DEFAULT_1,
  66. PART_DEFAULT_2,
  67. MAX_RESET_SETTINGS_TYPES
  68. } reset_settings_type_t;
  69. /**
  70. * @brief Параметры обновления ПО
  71. */
  72. typedef struct
  73. {
  74. uint8_t loadMode; // 0 - основная прошивка, 1 - режим обновления ПО
  75. uint8_t bootTry; // Признак
  76. } BOOT_PARAMS_t;
  77. /**
  78. * @brief Параметры сетевого подключения
  79. */
  80. typedef struct
  81. {
  82. char ip[16];
  83. char gate[16];
  84. char mask[16];
  85. uint8_t dhcpEnable; // 0 - DHCP отключен, 1 - включен
  86. } WEB_PARAMS_t;
  87. /**
  88. * @brief Параметры сетевого подключения
  89. */
  90. typedef struct
  91. {
  92. char ip_range[19];
  93. uint32_t ip;
  94. uint32_t mask;
  95. } WHITE_LIST_t;
  96. /**
  97. * @brief Описание устройства системный параметр SNMP
  98. */
  99. typedef struct
  100. {
  101. char description[160];
  102. uint16_t len;
  103. } SNMP_SYS_DESCR_t;
  104. /**
  105. * @brief Контактная информация системный параметр SNMP
  106. */
  107. typedef struct
  108. {
  109. char contact[50];
  110. uint16_t len;
  111. } SNMP_SYS_CONTACT_t;
  112. /**
  113. * @brief Название устройства системный параметр SNMP
  114. */
  115. typedef struct
  116. {
  117. char name[20];
  118. uint16_t len;
  119. } SNMP_SYS_NAME_t;
  120. /**
  121. * @brief Местоположение устройства системный параметр SNMP
  122. */
  123. typedef struct
  124. {
  125. char location[110];
  126. uint16_t len;
  127. } SNMP_SYS_LOCATION_t;
  128. /**
  129. * @brief Параметры SNMP
  130. */
  131. typedef struct
  132. {
  133. SNMP_SYS_DESCR_t sysDesc;
  134. char readCommunity[20];
  135. char writeCommunity[20];
  136. SNMP_SYS_CONTACT_t sysContact;
  137. SNMP_SYS_NAME_t sysName;
  138. SNMP_SYS_LOCATION_t sysLocation;
  139. char managerIP[20];
  140. char managerIP2[20];
  141. char managerIP3[20];
  142. char managerIP4[20];
  143. char managerIP5[20];
  144. } SNMP_t;
  145. /**
  146. * @brief Информация об устройстве
  147. */
  148. typedef struct
  149. {
  150. char productionData[40]; // Дата производства
  151. char mac[18]; // MAC адрес
  152. char serialNumber[16]; // Серийный номер
  153. char comments[110]; // Комментарии
  154. } DEVICE_INFO_t;
  155. /**
  156. * @brief Флаги, ключи и т.д.
  157. */
  158. typedef struct
  159. {
  160. bool netsettingsChanged; // Признак изменения сетевых настроек пользователем
  161. char testState[16]; // Статус производственного тестирования
  162. } FLAGS_t;
  163. /**
  164. * @brief Уровни пользователей Web.
  165. */
  166. typedef enum
  167. {
  168. ADMIN = 0,
  169. USER,
  170. MAX_USER_LEVELS
  171. } user_level_t;
  172. /**
  173. * @brief Настройки аутентификации.
  174. */
  175. typedef struct
  176. {
  177. user_level_t level;
  178. char login[MAX_WEB_LOGIN_LEN];
  179. char password[MAX_WEB_PASSWD_LEN];
  180. } AUTH_t;
  181. /**
  182. * @brief Параметры SNTP
  183. */
  184. typedef struct
  185. {
  186. bool sntpEnable; // Вкл/выкл
  187. char ip[16]; // Адрес SNTP сервера
  188. char data[30]; // Дата последней синхронизации
  189. float timeZone; // Часовой пояс
  190. } SNTP_t;
  191. /**
  192. * @brief Типы источников срабатывания реле
  193. */
  194. typedef enum
  195. {
  196. #ifdef RELAY_AC_PRESENT
  197. AC_PRESENT = 1,
  198. #endif
  199. #ifdef RELAY_DC_PRESENT
  200. DC_PRESENT,
  201. #endif
  202. #ifdef RELAY_ALARM_AKB
  203. ALARM_AKB,
  204. #endif
  205. #ifdef RELAY_CHARGE_AKB
  206. CHARGE_AKB,
  207. #endif
  208. #ifdef RELAY_OFF_AKB
  209. OFF_AKB,
  210. #endif
  211. #ifdef TYPE_CRITICAL_ALARM_MONITOR
  212. CRITICAL = 1,
  213. NON_CRITICAL,
  214. #endif
  215. SNMP_SET,
  216. RO_MAX_SOURCE
  217. } ro_type_source_t;
  218. /**
  219. * @brief Типы источников срабатывания реле
  220. */
  221. typedef enum
  222. {
  223. DI_DISCONN = 0,
  224. DI_CONN,
  225. DI_MAX_ACT
  226. } din_type_act_t;
  227. /**
  228. * @brief Настройки сухих контактов.
  229. */
  230. typedef struct
  231. {
  232. char name[21];
  233. din_type_act_t din_type_act;
  234. } DIN_Settings_t;
  235. /**
  236. * @brief Настройки диапазона уровней Аварий.
  237. */
  238. typedef struct
  239. {
  240. float high;
  241. float low;
  242. float hyst;
  243. } ALARM_LEVEL_RANGE_t;
  244. /**
  245. * @brief Настройки Аварий.
  246. */
  247. typedef struct
  248. {
  249. ALARM_LEVEL_RANGE_t load_range;
  250. #ifdef VAC_IN_MONITOR
  251. ALARM_LEVEL_RANGE_t ac_input_range;
  252. #endif
  253. ALARM_LEVEL_RANGE_t ac_output_range;
  254. ALARM_LEVEL_RANGE_t Temprature_range;
  255. #ifndef HARDWARE_BT6709
  256. ALARM_LEVEL_RANGE_t Temprature_cabinet_range;
  257. #endif
  258. } ALARM_MNGR_t;
  259. typedef enum{
  260. ups_kestar,
  261. ups_voltronic,
  262. ups_offline,
  263. type_ups_max
  264. } typeUPSEnums_t;
  265. typedef enum{
  266. ups_1_0_power,
  267. ups_1_5_power,
  268. ups_2_0_power,
  269. ups_3_0_power,
  270. ups_6_0_power,
  271. ups_10_0_power,
  272. ups_power_num_max
  273. } upsPowerEnums_t;
  274. /**
  275. * @brief Настройки ИБП.
  276. */
  277. typedef struct
  278. {
  279. float Ucellmin;
  280. float Ucellmax;
  281. float Uakb;
  282. float ups_power;
  283. uint32_t life_time;
  284. uint32_t set_data;
  285. uint32_t common_capacity;
  286. uint8_t type_ups;
  287. uint32_t serial;
  288. } UPS_Setting_t;
  289. typedef struct {
  290. ip_addr_t server_ip;
  291. u16_t server_port;
  292. char remote_path[100];
  293. #define SETTINGS_FIELD_MAX_LEN 100
  294. char user[30];
  295. char pass[30];
  296. } FTP_Update_t;
  297. typedef struct {
  298. bool enabled;
  299. ip_addr_t server_ip;
  300. u16_t server_port;
  301. } Syslog_Settings_t;
  302. /**
  303. * @brief Настройки реле.
  304. */
  305. typedef struct
  306. {
  307. ro_type_source_t ro_type_source;
  308. } RELAY_Settings_t;
  309. /**
  310. * @brief Параметры RADIUS
  311. */
  312. typedef struct
  313. {
  314. bool Auth_enable;
  315. char ServerIP[16];
  316. char rds_password[17];
  317. bool RDSEnable; // 0 - отключен, 1 - включен
  318. uint32_t port;
  319. uint32_t key_access;
  320. } RADIUS_t;
  321. /**
  322. * @brief Параметры Telnet
  323. */
  324. typedef struct
  325. {
  326. bool TelnetEnable; // 0 - отключен, 1 - включен
  327. uint32_t port;
  328. } TELNET_t;
  329. /**
  330. * @brief Параметры SSH
  331. */
  332. typedef struct
  333. {
  334. bool SSHEnable; // 0 - отключен, 1 - включен
  335. uint32_t port;
  336. } SSH_t;
  337. /**
  338. * @brief Типы транспорта прозрачного порта
  339. */
  340. typedef enum
  341. {
  342. GW_UDP = 0,
  343. GW_TCP,
  344. MAX_TRANS_TYPES
  345. } gwtrans_t;
  346. /**
  347. * @brief Режим прозрачного порта
  348. */
  349. typedef enum
  350. {
  351. GW_SERVER = 0,
  352. GW_CLIENT,
  353. MAX_MODE_TYPES
  354. } gwmode_t;
  355. /**
  356. * @brief Четность прозрачного порта
  357. */
  358. typedef enum
  359. {
  360. GW_NO_PAR = 0,
  361. GW_ODD_PAR,
  362. GW_EVEN_PAR,
  363. MAX_PARITY_TYPES
  364. } gwparity_t;
  365. /**
  366. * @brief Настройки прозрачного порта
  367. */
  368. typedef struct
  369. {
  370. bool enabled; /* Вкл/Откл */
  371. gwtrans_t transtype; /* Тип транспорта */
  372. gwmode_t mode; /* Режим: Клиент/Сервер */
  373. char ip[16]; /* IP-адрес сервера (для клиента) */
  374. uint16_t port; /* Порт */
  375. uint32_t baud; /* Скорость порта */
  376. gwparity_t parity; /* Четность */
  377. uint8_t databits; /* Число бит данных */
  378. uint8_t stopbits; /* Число стоп-бит */
  379. uint8_t timeout; /* Таймаут ответа от устройства */
  380. uint16_t quota; /* Максимальное время занятия порта */
  381. } PORTGW_t;
  382. /**
  383. * @brief Место измерения датчика температуры
  384. */
  385. typedef enum
  386. {
  387. TS_NONE = 0,
  388. TS_CABINET,
  389. TS_AKB
  390. } ts_location_type_t;
  391. /**
  392. * @brief Параметры контроля температуры
  393. */
  394. typedef struct
  395. {
  396. ts_location_type_t type_sensor; //размещение датчика температуры
  397. } TEMP_COTROL_t;
  398. /**
  399. * @brief Общая структура настроек
  400. */
  401. typedef struct
  402. {
  403. BOOT_PARAMS_t bootParams;
  404. WEB_PARAMS_t sWebParams;
  405. WEB_PARAMS_t sWebTempParams;
  406. DEVICE_INFO_t sInfo;
  407. uint32_t CritSecCRC;
  408. /* WARNING! До поля CritSecCRC включительно структура настроек должна быть
  409. * идентичной между бутлоадером и основным ПО и не должна изменяться при обновлении ПО.
  410. * Контроль целостности настроек внутри IAP выполняется только для критической секции,
  411. * т.к. контроль целостности всей структуры не имеет смысла
  412. * (структура настроек всегда будет отличаться внутри основного ПО).
  413. * В случае повреждения критического сектора, загружаются параметры по умолчанию. */
  414. FLAGS_t sFlags;
  415. #define XSETTING(type, name, setter, type_reset) type name;
  416. SETTINGS_TABLE
  417. #undef XSETTING
  418. uint32_t controlWorld; // Слово для контроля целостности структуры настроек
  419. } SETTINGS_t;
  420. extern SETTINGS_t sSettings;
  421. /**
  422. * @brief
  423. * @retval
  424. */
  425. uint32_t SETTINGS_GetCritSecCRC(void);
  426. /**
  427. * @brief Установить параметры обновления ПО по умолчанию
  428. */
  429. void SETTINGS_SetBootParamsDef(void);
  430. /**
  431. * @brief Установить параметры сетевого подключения по умолчанию
  432. */
  433. void SETTINGS_SetWebParamsDef(void);
  434. /**
  435. * @brief Установить временные параметры сетевого подключения по умолчанию
  436. */
  437. void SETTINGS_SetTempWebParamsDef(void);
  438. /**
  439. * @brief Установить параметры SNMP по умолчанию
  440. */
  441. void SETTINGS_SetSnmpDef(void);
  442. /**
  443. * @brief Настройки ИБП по умолчанию
  444. */
  445. void SETTINGS_SetUPSSettingsDef(void);
  446. /**
  447. * @brief Настройки серийного номера ИБП по умолчанию
  448. */
  449. void SETTINGS_SetUPSSerialSettingsDef(void);
  450. /**
  451. * @brief Установить Информацию об устройстве по умолчанию
  452. */
  453. void SETTINGS_SetInfoDef(void);
  454. /**
  455. * @brief Установить наcтройки менеджера Аварий по умолчанию
  456. */
  457. void SETTINGS_SetAlarmManagerDef(void);
  458. /**
  459. * @brief Установить флаги по умолчанию
  460. */
  461. void SETTINGS_SetFlagsDef(void);
  462. /**
  463. * @brief Установить параметры SNTP по умолчанию
  464. */
  465. void SETTINGS_SetSntpDef(void);
  466. /**
  467. * @brief Установить параметры настроек сухих контактов по умолчанию
  468. */
  469. void SETTINGS_SetDINSDef(void);
  470. /**
  471. * @brief Установить параметры настроек реле по умолчанию
  472. */
  473. void SETTINGS_SetRelaysDef(void);
  474. /**
  475. * @brief Установить значение настроек прозрачного порта по умолчанию
  476. */
  477. void SETTINGS_SetPortGwDef(void);
  478. /**
  479. * @brief Установить параметры RADIUS по умолчанию
  480. */
  481. void SETTINGS_SetRADIUSDef(void);
  482. /**
  483. * @brief Установить параметры сертификата сервера по умолчанию
  484. */
  485. void SETTINGS_SetSSLcrtDef(void);
  486. /**
  487. * @brief Установить параметры Telnet
  488. */
  489. void SETTINGS_SetTelnetDef(void);
  490. /**
  491. * @brief Установить параметры SSH
  492. */
  493. void SETTINGS_SetSSHDef(void);
  494. /**
  495. * @brief Установить параметры списка доверительных хостов
  496. */
  497. void SETTINGS_SetWhiteListDef(void);
  498. /**
  499. * @brief Установить параметры датчиков температуры
  500. */
  501. void SETTINGS_SetTempControlDef(void);
  502. /**
  503. * @brief Установить параметры разрешения уведомлений по умолчанию
  504. */
  505. void SETTINGS_SetFlagNotificationDef(void);
  506. void SETTINGS_SetFTPUpdateDef(void);
  507. void SETTINGS_SetSyslogDef(void);
  508. /**
  509. * @brief Установить значение сервисных настроек по умолчанию
  510. */
  511. void SETTINGS_SetServiceDef(void);
  512. /**
  513. * @brief Очистка сектора настроек
  514. */
  515. void SETTINGS_EraseFlashSector(void);
  516. /**
  517. * @brief Сброс всех настроек в значения по умолчанию кроме сетевых настроек
  518. */
  519. void SETTINGS_SetPartDefault(void);
  520. /**
  521. * @brief Сброс всех настроек в значения по умолчанию
  522. */
  523. void SETTINGS_SetAllDefault(void);
  524. /**
  525. * @brief Установка настроек для отладки
  526. */
  527. void SETTINGS_SetDefaultDebug(void);
  528. /**
  529. * @brief Запись структуры настроек во flesh
  530. */
  531. void SETTINGS_Save(void);
  532. /**
  533. * @brief Загрузка структуры настроек из flesh
  534. */
  535. void SETTINGS_Load(void);
  536. /**
  537. * @brief
  538. */
  539. void SETTINGS_WriteToFlash(uint8_t *data, uint32_t size);
  540. /**
  541. * @brief
  542. */
  543. void SETTINGS_ReadFromFlash(uint8_t *data, uint32_t size);
  544. /**
  545. * @brief
  546. */
  547. uint32_t SETTINGS_GetCRC(void);
  548. /**
  549. * @brief Сброс флага boottry и сохранение структуры настроек
  550. */
  551. void SETTINGS_ResetBootTry(void);
  552. /**
  553. * @brief Преобразует mac адрес строкового формата в массив uint8_t
  554. * @param mac - буфер для вывода mac адреса
  555. */
  556. void SETTINGS_GetMac(uint8_t *mac);
  557. /**
  558. * @brief Установить дату производства
  559. */
  560. void SETTINGS_SetProDate(char *proDate, uint8_t len);
  561. /**
  562. * @brief Установить статус тестирования "T2OK"
  563. */
  564. void SETTINGS_SetT2OK(void);
  565. /**
  566. * @brief Включить DHCP
  567. */
  568. void SETTINGS_SetDHCPOn(void);
  569. void init_settings(void);
  570. #endif /* #ifndef SETTINGS_API_H */
  571. /********************************* (C) РОТЕК **********************************/