settings_api.h 10 KB

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