bme680_defs.h 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529
  1. /**
  2. * Copyright (C) 2017 - 2018 Bosch Sensortec GmbH
  3. *
  4. * Redistribution and use in source and binary forms, with or without
  5. * modification, are permitted provided that the following conditions are met:
  6. *
  7. * Redistributions of source code must retain the above copyright
  8. * notice, this list of conditions and the following disclaimer.
  9. *
  10. * Redistributions in binary form must reproduce the above copyright
  11. * notice, this list of conditions and the following disclaimer in the
  12. * documentation and/or other materials provided with the distribution.
  13. *
  14. * Neither the name of the copyright holder nor the names of the
  15. * contributors may be used to endorse or promote products derived from
  16. * this software without specific prior written permission.
  17. *
  18. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
  19. * CONTRIBUTORS "AS IS" AND ANY EXPRESS OR
  20. * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  21. * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  22. * DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDER
  23. * OR CONTRIBUTORS BE LIABLE FOR ANY
  24. * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
  25. * OR CONSEQUENTIAL DAMAGES(INCLUDING, BUT NOT LIMITED TO,
  26. * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  27. * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  28. * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
  29. * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  30. * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
  31. * ANY WAY OUT OF THE USE OF THIS
  32. * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE
  33. *
  34. * The information provided is believed to be accurate and reliable.
  35. * The copyright holder assumes no responsibility
  36. * for the consequences of use
  37. * of such information nor for any infringement of patents or
  38. * other rights of third parties which may result from its use.
  39. * No license is granted by implication or otherwise under any patent or
  40. * patent rights of the copyright holder.
  41. *
  42. * @file bme680_defs.h
  43. * @date 5 Jul 2017
  44. * @version 3.5.1
  45. * @brief
  46. *
  47. */
  48. /*! @file bme680_defs.h
  49. @brief Sensor driver for BME680 sensor */
  50. /*!
  51. * @defgroup BME680 SENSOR API
  52. * @brief
  53. * @{*/
  54. #ifndef BME680_DEFS_H_
  55. #define BME680_DEFS_H_
  56. /********************************************************/
  57. /* header includes */
  58. #ifdef __KERNEL__
  59. #include <linux/types.h>
  60. #else
  61. #include <stdint.h>
  62. #endif
  63. #ifdef __KERNEL__
  64. #if (LONG_MAX) > 0x7fffffff
  65. #define __have_long64 1
  66. #elif (LONG_MAX) == 0x7fffffff
  67. #define __have_long32 1
  68. #endif
  69. #if !defined(UINT8_C)
  70. #define INT8_C(x) x
  71. #if (INT_MAX) > 0x7f
  72. #define UINT8_C(x) x
  73. #else
  74. #define UINT8_C(x) x##U
  75. #endif
  76. #endif
  77. #if !defined(UINT16_C)
  78. #define INT16_C(x) x
  79. #if (INT_MAX) > 0x7fff
  80. #define UINT16_C(x) x
  81. #else
  82. #define UINT16_C(x) x##U
  83. #endif
  84. #endif
  85. #if !defined(INT32_C) && !defined(UINT32_C)
  86. #if __have_long32
  87. #define INT32_C(x) x##L
  88. #define UINT32_C(x) x##UL
  89. #else
  90. #define INT32_C(x) x
  91. #define UINT32_C(x) x##U
  92. #endif
  93. #endif
  94. #if !defined(INT64_C) && !defined(UINT64_C)
  95. #if __have_long64
  96. #define INT64_C(x) x##L
  97. #define UINT64_C(x) x##UL
  98. #else
  99. #define INT64_C(x) x##LL
  100. #define UINT64_C(x) x##ULL
  101. #endif
  102. #endif
  103. #endif
  104. /**@}*/
  105. /**\name C standard macros */
  106. #ifndef NULL
  107. #ifdef __cplusplus
  108. #define NULL 0
  109. #else
  110. #define NULL ((void *) 0)
  111. #endif
  112. #endif
  113. /** BME680 General config */
  114. #define BME680_POLL_PERIOD_MS UINT8_C(10)
  115. /** BME680 I2C addresses */
  116. #define BME680_I2C_ADDR_PRIMARY UINT8_C(0x76)
  117. #define BME680_I2C_ADDR_SECONDARY UINT8_C(0x77)
  118. /** BME680 unique chip identifier */
  119. #define BME680_CHIP_ID UINT8_C(0x61)
  120. /** BME680 coefficients related defines */
  121. #define BME680_COEFF_SIZE UINT8_C(0x41)
  122. #define BME680_COEFF_ADDR1_LEN UINT8_C(25)
  123. #define BME680_COEFF_ADDR2_LEN UINT8_C(16)
  124. /** BME680 field_x related defines */
  125. #define BME680_FIELD_LENGTH UINT8_C(15)
  126. #define BME680_FIELD_ADDR_OFFSET UINT8_C(17)
  127. /** Soft reset command */
  128. #define BME680_SOFT_RESET_CMD UINT8_C(0xb6)
  129. /** Error code definitions */
  130. #define BME680_OK INT8_C(0)
  131. /* Errors */
  132. #define BME680_E_NULL_PTR INT8_C(-1)
  133. #define BME680_E_COM_FAIL INT8_C(-2)
  134. #define BME680_E_DEV_NOT_FOUND INT8_C(-3)
  135. #define BME680_E_INVALID_LENGTH INT8_C(-4)
  136. /* Warnings */
  137. #define BME680_W_DEFINE_PWR_MODE INT8_C(1)
  138. #define BME680_W_NO_NEW_DATA INT8_C(2)
  139. /* Info's */
  140. #define BME680_I_MIN_CORRECTION UINT8_C(1)
  141. #define BME680_I_MAX_CORRECTION UINT8_C(2)
  142. /** Register map */
  143. /** Other coefficient's address */
  144. #define BME680_ADDR_RES_HEAT_VAL_ADDR UINT8_C(0x00)
  145. #define BME680_ADDR_RES_HEAT_RANGE_ADDR UINT8_C(0x02)
  146. #define BME680_ADDR_RANGE_SW_ERR_ADDR UINT8_C(0x04)
  147. #define BME680_ADDR_SENS_CONF_START UINT8_C(0x5A)
  148. #define BME680_ADDR_GAS_CONF_START UINT8_C(0x64)
  149. /** Field settings */
  150. #define BME680_FIELD0_ADDR UINT8_C(0x1d)
  151. /** Heater settings */
  152. #define BME680_RES_HEAT0_ADDR UINT8_C(0x5a)
  153. #define BME680_GAS_WAIT0_ADDR UINT8_C(0x64)
  154. /** Sensor configuration registers */
  155. #define BME680_CONF_HEAT_CTRL_ADDR UINT8_C(0x70)
  156. #define BME680_CONF_ODR_RUN_GAS_NBC_ADDR UINT8_C(0x71)
  157. #define BME680_CONF_OS_H_ADDR UINT8_C(0x72)
  158. #define BME680_MEM_PAGE_ADDR UINT8_C(0xf3)
  159. #define BME680_CONF_T_P_MODE_ADDR UINT8_C(0x74)
  160. #define BME680_CONF_ODR_FILT_ADDR UINT8_C(0x75)
  161. /** Coefficient's address */
  162. #define BME680_COEFF_ADDR1 UINT8_C(0x89)
  163. #define BME680_COEFF_ADDR2 UINT8_C(0xe1)
  164. /** Chip identifier */
  165. #define BME680_CHIP_ID_ADDR UINT8_C(0xd0)
  166. /** Soft reset register */
  167. #define BME680_SOFT_RESET_ADDR UINT8_C(0xe0)
  168. /** Heater control settings */
  169. #define BME680_ENABLE_HEATER UINT8_C(0x00)
  170. #define BME680_DISABLE_HEATER UINT8_C(0x08)
  171. /** Gas measurement settings */
  172. #define BME680_DISABLE_GAS_MEAS UINT8_C(0x00)
  173. #define BME680_ENABLE_GAS_MEAS UINT8_C(0x01)
  174. /** Over-sampling settings */
  175. #define BME680_OS_NONE UINT8_C(0)
  176. #define BME680_OS_1X UINT8_C(1)
  177. #define BME680_OS_2X UINT8_C(2)
  178. #define BME680_OS_4X UINT8_C(3)
  179. #define BME680_OS_8X UINT8_C(4)
  180. #define BME680_OS_16X UINT8_C(5)
  181. /** IIR filter settings */
  182. #define BME680_FILTER_SIZE_0 UINT8_C(0)
  183. #define BME680_FILTER_SIZE_1 UINT8_C(1)
  184. #define BME680_FILTER_SIZE_3 UINT8_C(2)
  185. #define BME680_FILTER_SIZE_7 UINT8_C(3)
  186. #define BME680_FILTER_SIZE_15 UINT8_C(4)
  187. #define BME680_FILTER_SIZE_31 UINT8_C(5)
  188. #define BME680_FILTER_SIZE_63 UINT8_C(6)
  189. #define BME680_FILTER_SIZE_127 UINT8_C(7)
  190. /** Power mode settings */
  191. #define BME680_SLEEP_MODE UINT8_C(0)
  192. #define BME680_FORCED_MODE UINT8_C(1)
  193. /** Delay related macro declaration */
  194. #define BME680_RESET_PERIOD UINT32_C(10)
  195. /** SPI memory page settings */
  196. #define BME680_MEM_PAGE0 UINT8_C(0x10)
  197. #define BME680_MEM_PAGE1 UINT8_C(0x00)
  198. /** Ambient humidity shift value for compensation */
  199. #define BME680_HUM_REG_SHIFT_VAL UINT8_C(4)
  200. /** Run gas enable and disable settings */
  201. #define BME680_RUN_GAS_DISABLE UINT8_C(0)
  202. #define BME680_RUN_GAS_ENABLE UINT8_C(1)
  203. /** Buffer length macro declaration */
  204. #define BME680_TMP_BUFFER_LENGTH UINT8_C(40)
  205. #define BME680_REG_BUFFER_LENGTH UINT8_C(6)
  206. #define BME680_FIELD_DATA_LENGTH UINT8_C(3)
  207. #define BME680_GAS_REG_BUF_LENGTH UINT8_C(20)
  208. #define BME680_GAS_HEATER_PROF_LEN_MAX UINT8_C(10)
  209. /** Settings selector */
  210. #define BME680_OST_SEL UINT16_C(1)
  211. #define BME680_OSP_SEL UINT16_C(2)
  212. #define BME680_OSH_SEL UINT16_C(4)
  213. #define BME680_GAS_MEAS_SEL UINT16_C(8)
  214. #define BME680_FILTER_SEL UINT16_C(16)
  215. #define BME680_HCNTRL_SEL UINT16_C(32)
  216. #define BME680_RUN_GAS_SEL UINT16_C(64)
  217. #define BME680_NBCONV_SEL UINT16_C(128)
  218. #define BME680_GAS_SENSOR_SEL UINT16_C(BME680_GAS_MEAS_SEL | BME680_RUN_GAS_SEL | BME680_NBCONV_SEL)
  219. /** Number of conversion settings*/
  220. #define BME680_NBCONV_MIN UINT8_C(0)
  221. #define BME680_NBCONV_MAX UINT8_C(10)
  222. /** Mask definitions */
  223. #define BME680_GAS_MEAS_MSK UINT8_C(0x30)
  224. #define BME680_NBCONV_MSK UINT8_C(0X0F)
  225. #define BME680_FILTER_MSK UINT8_C(0X1C)
  226. #define BME680_OST_MSK UINT8_C(0XE0)
  227. #define BME680_OSP_MSK UINT8_C(0X1C)
  228. #define BME680_OSH_MSK UINT8_C(0X07)
  229. #define BME680_HCTRL_MSK UINT8_C(0x08)
  230. #define BME680_RUN_GAS_MSK UINT8_C(0x10)
  231. #define BME680_MODE_MSK UINT8_C(0x03)
  232. #define BME680_RHRANGE_MSK UINT8_C(0x30)
  233. #define BME680_RSERROR_MSK UINT8_C(0xf0)
  234. #define BME680_NEW_DATA_MSK UINT8_C(0x80)
  235. #define BME680_GAS_INDEX_MSK UINT8_C(0x0f)
  236. #define BME680_GAS_RANGE_MSK UINT8_C(0x0f)
  237. #define BME680_GASM_VALID_MSK UINT8_C(0x20)
  238. #define BME680_HEAT_STAB_MSK UINT8_C(0x10)
  239. #define BME680_MEM_PAGE_MSK UINT8_C(0x10)
  240. #define BME680_SPI_RD_MSK UINT8_C(0x80)
  241. #define BME680_SPI_WR_MSK UINT8_C(0x7f)
  242. #define BME680_BIT_H1_DATA_MSK UINT8_C(0x0F)
  243. /** Bit position definitions for sensor settings */
  244. #define BME680_GAS_MEAS_POS UINT8_C(4)
  245. #define BME680_FILTER_POS UINT8_C(2)
  246. #define BME680_OST_POS UINT8_C(5)
  247. #define BME680_OSP_POS UINT8_C(2)
  248. #define BME680_RUN_GAS_POS UINT8_C(4)
  249. /** Array Index to Field data mapping for Calibration Data*/
  250. #define BME680_T2_LSB_REG (1)
  251. #define BME680_T2_MSB_REG (2)
  252. #define BME680_T3_REG (3)
  253. #define BME680_P1_LSB_REG (5)
  254. #define BME680_P1_MSB_REG (6)
  255. #define BME680_P2_LSB_REG (7)
  256. #define BME680_P2_MSB_REG (8)
  257. #define BME680_P3_REG (9)
  258. #define BME680_P4_LSB_REG (11)
  259. #define BME680_P4_MSB_REG (12)
  260. #define BME680_P5_LSB_REG (13)
  261. #define BME680_P5_MSB_REG (14)
  262. #define BME680_P7_REG (15)
  263. #define BME680_P6_REG (16)
  264. #define BME680_P8_LSB_REG (19)
  265. #define BME680_P8_MSB_REG (20)
  266. #define BME680_P9_LSB_REG (21)
  267. #define BME680_P9_MSB_REG (22)
  268. #define BME680_P10_REG (23)
  269. #define BME680_H2_MSB_REG (25)
  270. #define BME680_H2_LSB_REG (26)
  271. #define BME680_H1_LSB_REG (26)
  272. #define BME680_H1_MSB_REG (27)
  273. #define BME680_H3_REG (28)
  274. #define BME680_H4_REG (29)
  275. #define BME680_H5_REG (30)
  276. #define BME680_H6_REG (31)
  277. #define BME680_H7_REG (32)
  278. #define BME680_T1_LSB_REG (33)
  279. #define BME680_T1_MSB_REG (34)
  280. #define BME680_GH2_LSB_REG (35)
  281. #define BME680_GH2_MSB_REG (36)
  282. #define BME680_GH1_REG (37)
  283. #define BME680_GH3_REG (38)
  284. /** BME680 register buffer index settings*/
  285. #define BME680_REG_FILTER_INDEX UINT8_C(5)
  286. #define BME680_REG_TEMP_INDEX UINT8_C(4)
  287. #define BME680_REG_PRES_INDEX UINT8_C(4)
  288. #define BME680_REG_HUM_INDEX UINT8_C(2)
  289. #define BME680_REG_NBCONV_INDEX UINT8_C(1)
  290. #define BME680_REG_RUN_GAS_INDEX UINT8_C(1)
  291. #define BME680_REG_HCTRL_INDEX UINT8_C(0)
  292. /** Macro to combine two 8 bit data's to form a 16 bit data */
  293. #define BME680_CONCAT_BYTES(msb, lsb) (((uint16_t)msb << 8) | (uint16_t)lsb)
  294. /** Macro to SET and GET BITS of a register */
  295. #define BME680_SET_BITS(reg_data, bitname, data) \
  296. ((reg_data & ~(bitname##_MSK)) | \
  297. ((data << bitname##_POS) & bitname##_MSK))
  298. #define BME680_GET_BITS(reg_data, bitname) ((reg_data & (bitname##_MSK)) >> \
  299. (bitname##_POS))
  300. /** Macro variant to handle the bitname position if it is zero */
  301. #define BME680_SET_BITS_POS_0(reg_data, bitname, data) \
  302. ((reg_data & ~(bitname##_MSK)) | \
  303. (data & bitname##_MSK))
  304. #define BME680_GET_BITS_POS_0(reg_data, bitname) (reg_data & (bitname##_MSK))
  305. /** Type definitions */
  306. /*
  307. * Generic communication function pointer
  308. * @param[in] dev_id: Place holder to store the id of the device structure
  309. * Can be used to store the index of the Chip select or
  310. * I2C address of the device.
  311. * @param[in] reg_addr: Used to select the register the where data needs to
  312. * be read from or written to.
  313. * @param[in/out] reg_data: Data array to read/write
  314. * @param[in] len: Length of the data array
  315. */
  316. typedef int8_t (*bme680_com_fptr_t)(uint8_t dev_id, uint8_t reg_addr, uint8_t *data, uint16_t len);
  317. /*
  318. * Delay function pointer
  319. * @param[in] period: Time period in milliseconds
  320. */
  321. typedef void (*bme680_delay_fptr_t)(uint32_t period);
  322. /*!
  323. * @brief Interface selection Enumerations
  324. */
  325. enum bme680_intf {
  326. /*! SPI interface */
  327. BME680_SPI_INTF,
  328. /*! I2C interface */
  329. BME680_I2C_INTF
  330. };
  331. /* structure definitions */
  332. /*!
  333. * @brief Sensor field data structure
  334. */
  335. struct bme680_field_data {
  336. /*! Contains new_data, gasm_valid & heat_stab */
  337. uint8_t status;
  338. /*! The index of the heater profile used */
  339. uint8_t gas_index;
  340. /*! Measurement index to track order */
  341. uint8_t meas_index;
  342. /*! Temperature in degree celsius x100 */
  343. int16_t temperature;
  344. /*! Pressure in Pascal */
  345. uint32_t pressure;
  346. /*! Humidity in % relative humidity x1000 */
  347. uint32_t humidity;
  348. /*! Gas resistance in Ohms */
  349. uint32_t gas_resistance;
  350. };
  351. /*!
  352. * @brief Structure to hold the Calibration data
  353. */
  354. struct bme680_calib_data {
  355. /*! Variable to store calibrated humidity data */
  356. uint16_t par_h1;
  357. /*! Variable to store calibrated humidity data */
  358. uint16_t par_h2;
  359. /*! Variable to store calibrated humidity data */
  360. int8_t par_h3;
  361. /*! Variable to store calibrated humidity data */
  362. int8_t par_h4;
  363. /*! Variable to store calibrated humidity data */
  364. int8_t par_h5;
  365. /*! Variable to store calibrated humidity data */
  366. uint8_t par_h6;
  367. /*! Variable to store calibrated humidity data */
  368. int8_t par_h7;
  369. /*! Variable to store calibrated gas data */
  370. int8_t par_gh1;
  371. /*! Variable to store calibrated gas data */
  372. int16_t par_gh2;
  373. /*! Variable to store calibrated gas data */
  374. int8_t par_gh3;
  375. /*! Variable to store calibrated temperature data */
  376. uint16_t par_t1;
  377. /*! Variable to store calibrated temperature data */
  378. int16_t par_t2;
  379. /*! Variable to store calibrated temperature data */
  380. int8_t par_t3;
  381. /*! Variable to store calibrated pressure data */
  382. uint16_t par_p1;
  383. /*! Variable to store calibrated pressure data */
  384. int16_t par_p2;
  385. /*! Variable to store calibrated pressure data */
  386. int8_t par_p3;
  387. /*! Variable to store calibrated pressure data */
  388. int16_t par_p4;
  389. /*! Variable to store calibrated pressure data */
  390. int16_t par_p5;
  391. /*! Variable to store calibrated pressure data */
  392. int8_t par_p6;
  393. /*! Variable to store calibrated pressure data */
  394. int8_t par_p7;
  395. /*! Variable to store calibrated pressure data */
  396. int16_t par_p8;
  397. /*! Variable to store calibrated pressure data */
  398. int16_t par_p9;
  399. /*! Variable to store calibrated pressure data */
  400. uint8_t par_p10;
  401. /*! Variable to store t_fine size */
  402. int32_t t_fine;
  403. /*! Variable to store heater resistance range */
  404. uint8_t res_heat_range;
  405. /*! Variable to store heater resistance value */
  406. int8_t res_heat_val;
  407. /*! Variable to store error range */
  408. int8_t range_sw_err;
  409. };
  410. /*!
  411. * @brief BME680 sensor settings structure which comprises of ODR,
  412. * over-sampling and filter settings.
  413. */
  414. struct bme680_tph_sett {
  415. /*! Humidity oversampling */
  416. uint8_t os_hum;
  417. /*! Temperature oversampling */
  418. uint8_t os_temp;
  419. /*! Pressure oversampling */
  420. uint8_t os_pres;
  421. /*! Filter coefficient */
  422. uint8_t filter;
  423. };
  424. /*!
  425. * @brief BME680 gas sensor which comprises of gas settings
  426. * and status parameters
  427. */
  428. struct bme680_gas_sett {
  429. /*! Variable to store nb conversion */
  430. uint8_t nb_conv;
  431. /*! Variable to store heater control */
  432. uint8_t heatr_ctrl;
  433. /*! Run gas enable value */
  434. uint8_t run_gas;
  435. /*! Pointer to store heater temperature */
  436. uint16_t heatr_temp;
  437. /*! Pointer to store duration profile */
  438. uint16_t heatr_dur;
  439. };
  440. /*!
  441. * @brief BME680 device structure
  442. */
  443. struct bme680_dev {
  444. /*! Chip Id */
  445. uint8_t chip_id;
  446. /*! Device Id */
  447. uint8_t dev_id;
  448. /*! SPI/I2C interface */
  449. enum bme680_intf intf;
  450. /*! Memory page used */
  451. uint8_t mem_page;
  452. /*! Ambient temperature in Degree C*/
  453. int8_t amb_temp;
  454. /*! Sensor calibration data */
  455. struct bme680_calib_data calib;
  456. /*! Sensor settings */
  457. struct bme680_tph_sett tph_sett;
  458. /*! Gas Sensor settings */
  459. struct bme680_gas_sett gas_sett;
  460. /*! Sensor power modes */
  461. uint8_t power_mode;
  462. /*! New sensor fields */
  463. uint8_t new_fields;
  464. /*! Store the info messages */
  465. uint8_t info_msg;
  466. /*! Burst read structure */
  467. bme680_com_fptr_t read;
  468. /*! Burst write structure */
  469. bme680_com_fptr_t write;
  470. /*! Delay in ms */
  471. bme680_delay_fptr_t delay_ms;
  472. /*! Communication function result */
  473. int8_t com_rslt;
  474. };
  475. #endif /* BME680_DEFS_H_ */
  476. /** @}*/
  477. /** @}*/