nl802154.h 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451
  1. #ifndef __NL802154_H
  2. #define __NL802154_H
  3. /*
  4. * 802.15.4 netlink interface public header
  5. *
  6. * Copyright 2014 Alexander Aring <[email protected]>
  7. *
  8. * Permission to use, copy, modify, and/or distribute this software for any
  9. * purpose with or without fee is hereby granted, provided that the above
  10. * copyright notice and this permission notice appear in all copies.
  11. *
  12. * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  13. * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  14. * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  15. * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  16. * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  17. * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  18. * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  19. *
  20. */
  21. #include <linux/types.h>
  22. #define NL802154_GENL_NAME "nl802154"
  23. enum nl802154_commands {
  24. /* don't change the order or add anything between, this is ABI! */
  25. /* currently we don't shipping this file via uapi, ignore the above one */
  26. NL802154_CMD_UNSPEC,
  27. NL802154_CMD_GET_WPAN_PHY, /* can dump */
  28. NL802154_CMD_SET_WPAN_PHY,
  29. NL802154_CMD_NEW_WPAN_PHY,
  30. NL802154_CMD_DEL_WPAN_PHY,
  31. NL802154_CMD_GET_INTERFACE, /* can dump */
  32. NL802154_CMD_SET_INTERFACE,
  33. NL802154_CMD_NEW_INTERFACE,
  34. NL802154_CMD_DEL_INTERFACE,
  35. NL802154_CMD_SET_CHANNEL,
  36. NL802154_CMD_SET_PAN_ID,
  37. NL802154_CMD_SET_SHORT_ADDR,
  38. NL802154_CMD_SET_TX_POWER,
  39. NL802154_CMD_SET_CCA_MODE,
  40. NL802154_CMD_SET_CCA_ED_LEVEL,
  41. NL802154_CMD_SET_MAX_FRAME_RETRIES,
  42. NL802154_CMD_SET_BACKOFF_EXPONENT,
  43. NL802154_CMD_SET_MAX_CSMA_BACKOFFS,
  44. NL802154_CMD_SET_LBT_MODE,
  45. NL802154_CMD_SET_ACKREQ_DEFAULT,
  46. NL802154_CMD_SET_WPAN_PHY_NETNS,
  47. NL802154_CMD_SET_SEC_PARAMS,
  48. NL802154_CMD_GET_SEC_KEY, /* can dump */
  49. NL802154_CMD_NEW_SEC_KEY,
  50. NL802154_CMD_DEL_SEC_KEY,
  51. NL802154_CMD_GET_SEC_DEV, /* can dump */
  52. NL802154_CMD_NEW_SEC_DEV,
  53. NL802154_CMD_DEL_SEC_DEV,
  54. NL802154_CMD_GET_SEC_DEVKEY, /* can dump */
  55. NL802154_CMD_NEW_SEC_DEVKEY,
  56. NL802154_CMD_DEL_SEC_DEVKEY,
  57. NL802154_CMD_GET_SEC_LEVEL, /* can dump */
  58. NL802154_CMD_NEW_SEC_LEVEL,
  59. NL802154_CMD_DEL_SEC_LEVEL,
  60. /* add new commands above here */
  61. /* used to define NL802154_CMD_MAX below */
  62. __NL802154_CMD_AFTER_LAST,
  63. NL802154_CMD_MAX = __NL802154_CMD_AFTER_LAST - 1
  64. };
  65. enum nl802154_attrs {
  66. /* don't change the order or add anything between, this is ABI! */
  67. /* currently we don't shipping this file via uapi, ignore the above one */
  68. NL802154_ATTR_UNSPEC,
  69. NL802154_ATTR_WPAN_PHY,
  70. NL802154_ATTR_WPAN_PHY_NAME,
  71. NL802154_ATTR_IFINDEX,
  72. NL802154_ATTR_IFNAME,
  73. NL802154_ATTR_IFTYPE,
  74. NL802154_ATTR_WPAN_DEV,
  75. NL802154_ATTR_PAGE,
  76. NL802154_ATTR_CHANNEL,
  77. NL802154_ATTR_PAN_ID,
  78. NL802154_ATTR_SHORT_ADDR,
  79. NL802154_ATTR_TX_POWER,
  80. NL802154_ATTR_CCA_MODE,
  81. NL802154_ATTR_CCA_OPT,
  82. NL802154_ATTR_CCA_ED_LEVEL,
  83. NL802154_ATTR_MAX_FRAME_RETRIES,
  84. NL802154_ATTR_MAX_BE,
  85. NL802154_ATTR_MIN_BE,
  86. NL802154_ATTR_MAX_CSMA_BACKOFFS,
  87. NL802154_ATTR_LBT_MODE,
  88. NL802154_ATTR_GENERATION,
  89. NL802154_ATTR_CHANNELS_SUPPORTED,
  90. NL802154_ATTR_SUPPORTED_CHANNEL,
  91. NL802154_ATTR_EXTENDED_ADDR,
  92. NL802154_ATTR_WPAN_PHY_CAPS,
  93. NL802154_ATTR_SUPPORTED_COMMANDS,
  94. NL802154_ATTR_ACKREQ_DEFAULT,
  95. NL802154_ATTR_PAD,
  96. NL802154_ATTR_PID,
  97. NL802154_ATTR_NETNS_FD,
  98. /* add attributes here, update the policy in nl802154.c */
  99. #ifdef CONFIG_IEEE802154_NL802154_EXPERIMENTAL
  100. NL802154_ATTR_SEC_ENABLED,
  101. NL802154_ATTR_SEC_OUT_LEVEL,
  102. NL802154_ATTR_SEC_OUT_KEY_ID,
  103. NL802154_ATTR_SEC_FRAME_COUNTER,
  104. NL802154_ATTR_SEC_LEVEL,
  105. NL802154_ATTR_SEC_DEVICE,
  106. NL802154_ATTR_SEC_DEVKEY,
  107. NL802154_ATTR_SEC_KEY,
  108. #endif /* CONFIG_IEEE802154_NL802154_EXPERIMENTAL */
  109. __NL802154_ATTR_AFTER_LAST,
  110. NL802154_ATTR_MAX = __NL802154_ATTR_AFTER_LAST - 1
  111. };
  112. enum nl802154_iftype {
  113. NL802154_IFTYPE_UNSPEC = (~(__u32)0),
  114. NL802154_IFTYPE_NODE = 0,
  115. NL802154_IFTYPE_MONITOR,
  116. NL802154_IFTYPE_COORD,
  117. /* keep last */
  118. NUM_NL802154_IFTYPES,
  119. NL802154_IFTYPE_MAX = NUM_NL802154_IFTYPES - 1
  120. };
  121. /**
  122. * enum nl802154_wpan_phy_capability_attr - wpan phy capability attributes
  123. *
  124. * @__NL802154_CAP_ATTR_INVALID: attribute number 0 is reserved
  125. * @NL802154_CAP_ATTR_CHANNELS: a nested attribute for nl802154_channel_attr
  126. * @NL802154_CAP_ATTR_TX_POWERS: a nested attribute for
  127. * nl802154_wpan_phy_tx_power
  128. * @NL802154_CAP_ATTR_MIN_CCA_ED_LEVEL: minimum value for cca_ed_level
  129. * @NL802154_CAP_ATTR_MAX_CCA_ED_LEVEL: maxmimum value for cca_ed_level
  130. * @NL802154_CAP_ATTR_CCA_MODES: nl802154_cca_modes flags
  131. * @NL802154_CAP_ATTR_CCA_OPTS: nl802154_cca_opts flags
  132. * @NL802154_CAP_ATTR_MIN_MINBE: minimum of minbe value
  133. * @NL802154_CAP_ATTR_MAX_MINBE: maximum of minbe value
  134. * @NL802154_CAP_ATTR_MIN_MAXBE: minimum of maxbe value
  135. * @NL802154_CAP_ATTR_MAX_MINBE: maximum of maxbe value
  136. * @NL802154_CAP_ATTR_MIN_CSMA_BACKOFFS: minimum of csma backoff value
  137. * @NL802154_CAP_ATTR_MAX_CSMA_BACKOFFS: maximum of csma backoffs value
  138. * @NL802154_CAP_ATTR_MIN_FRAME_RETRIES: minimum of frame retries value
  139. * @NL802154_CAP_ATTR_MAX_FRAME_RETRIES: maximum of frame retries value
  140. * @NL802154_CAP_ATTR_IFTYPES: nl802154_iftype flags
  141. * @NL802154_CAP_ATTR_LBT: nl802154_supported_bool_states flags
  142. * @NL802154_CAP_ATTR_MAX: highest cap attribute currently defined
  143. * @__NL802154_CAP_ATTR_AFTER_LAST: internal use
  144. */
  145. enum nl802154_wpan_phy_capability_attr {
  146. __NL802154_CAP_ATTR_INVALID,
  147. NL802154_CAP_ATTR_IFTYPES,
  148. NL802154_CAP_ATTR_CHANNELS,
  149. NL802154_CAP_ATTR_TX_POWERS,
  150. NL802154_CAP_ATTR_CCA_ED_LEVELS,
  151. NL802154_CAP_ATTR_CCA_MODES,
  152. NL802154_CAP_ATTR_CCA_OPTS,
  153. NL802154_CAP_ATTR_MIN_MINBE,
  154. NL802154_CAP_ATTR_MAX_MINBE,
  155. NL802154_CAP_ATTR_MIN_MAXBE,
  156. NL802154_CAP_ATTR_MAX_MAXBE,
  157. NL802154_CAP_ATTR_MIN_CSMA_BACKOFFS,
  158. NL802154_CAP_ATTR_MAX_CSMA_BACKOFFS,
  159. NL802154_CAP_ATTR_MIN_FRAME_RETRIES,
  160. NL802154_CAP_ATTR_MAX_FRAME_RETRIES,
  161. NL802154_CAP_ATTR_LBT,
  162. /* keep last */
  163. __NL802154_CAP_ATTR_AFTER_LAST,
  164. NL802154_CAP_ATTR_MAX = __NL802154_CAP_ATTR_AFTER_LAST - 1
  165. };
  166. /**
  167. * enum nl802154_cca_modes - cca modes
  168. *
  169. * @__NL802154_CCA_INVALID: cca mode number 0 is reserved
  170. * @NL802154_CCA_ENERGY: Energy above threshold
  171. * @NL802154_CCA_CARRIER: Carrier sense only
  172. * @NL802154_CCA_ENERGY_CARRIER: Carrier sense with energy above threshold
  173. * @NL802154_CCA_ALOHA: CCA shall always report an idle medium
  174. * @NL802154_CCA_UWB_SHR: UWB preamble sense based on the SHR of a frame
  175. * @NL802154_CCA_UWB_MULTIPLEXED: UWB preamble sense based on the packet with
  176. * the multiplexed preamble
  177. * @__NL802154_CCA_ATTR_AFTER_LAST: Internal
  178. * @NL802154_CCA_ATTR_MAX: Maximum CCA attribute number
  179. */
  180. enum nl802154_cca_modes {
  181. __NL802154_CCA_INVALID,
  182. NL802154_CCA_ENERGY,
  183. NL802154_CCA_CARRIER,
  184. NL802154_CCA_ENERGY_CARRIER,
  185. NL802154_CCA_ALOHA,
  186. NL802154_CCA_UWB_SHR,
  187. NL802154_CCA_UWB_MULTIPLEXED,
  188. /* keep last */
  189. __NL802154_CCA_ATTR_AFTER_LAST,
  190. NL802154_CCA_ATTR_MAX = __NL802154_CCA_ATTR_AFTER_LAST - 1
  191. };
  192. /**
  193. * enum nl802154_cca_opts - additional options for cca modes
  194. *
  195. * @NL802154_CCA_OPT_ENERGY_CARRIER_OR: NL802154_CCA_ENERGY_CARRIER with OR
  196. * @NL802154_CCA_OPT_ENERGY_CARRIER_AND: NL802154_CCA_ENERGY_CARRIER with AND
  197. */
  198. enum nl802154_cca_opts {
  199. NL802154_CCA_OPT_ENERGY_CARRIER_AND,
  200. NL802154_CCA_OPT_ENERGY_CARRIER_OR,
  201. /* keep last */
  202. __NL802154_CCA_OPT_ATTR_AFTER_LAST,
  203. NL802154_CCA_OPT_ATTR_MAX = __NL802154_CCA_OPT_ATTR_AFTER_LAST - 1
  204. };
  205. /**
  206. * enum nl802154_supported_bool_states - bool states for bool capability entry
  207. *
  208. * @NL802154_SUPPORTED_BOOL_FALSE: indicates to set false
  209. * @NL802154_SUPPORTED_BOOL_TRUE: indicates to set true
  210. * @__NL802154_SUPPORTED_BOOL_INVALD: reserved
  211. * @NL802154_SUPPORTED_BOOL_BOTH: indicates to set true and false
  212. * @__NL802154_SUPPORTED_BOOL_AFTER_LAST: Internal
  213. * @NL802154_SUPPORTED_BOOL_MAX: highest value for bool states
  214. */
  215. enum nl802154_supported_bool_states {
  216. NL802154_SUPPORTED_BOOL_FALSE,
  217. NL802154_SUPPORTED_BOOL_TRUE,
  218. /* to handle them in a mask */
  219. __NL802154_SUPPORTED_BOOL_INVALD,
  220. NL802154_SUPPORTED_BOOL_BOTH,
  221. /* keep last */
  222. __NL802154_SUPPORTED_BOOL_AFTER_LAST,
  223. NL802154_SUPPORTED_BOOL_MAX = __NL802154_SUPPORTED_BOOL_AFTER_LAST - 1
  224. };
  225. #ifdef CONFIG_IEEE802154_NL802154_EXPERIMENTAL
  226. enum nl802154_dev_addr_modes {
  227. NL802154_DEV_ADDR_NONE,
  228. __NL802154_DEV_ADDR_INVALID,
  229. NL802154_DEV_ADDR_SHORT,
  230. NL802154_DEV_ADDR_EXTENDED,
  231. /* keep last */
  232. __NL802154_DEV_ADDR_AFTER_LAST,
  233. NL802154_DEV_ADDR_MAX = __NL802154_DEV_ADDR_AFTER_LAST - 1
  234. };
  235. enum nl802154_dev_addr_attrs {
  236. NL802154_DEV_ADDR_ATTR_UNSPEC,
  237. NL802154_DEV_ADDR_ATTR_PAN_ID,
  238. NL802154_DEV_ADDR_ATTR_MODE,
  239. NL802154_DEV_ADDR_ATTR_SHORT,
  240. NL802154_DEV_ADDR_ATTR_EXTENDED,
  241. NL802154_DEV_ADDR_ATTR_PAD,
  242. /* keep last */
  243. __NL802154_DEV_ADDR_ATTR_AFTER_LAST,
  244. NL802154_DEV_ADDR_ATTR_MAX = __NL802154_DEV_ADDR_ATTR_AFTER_LAST - 1
  245. };
  246. enum nl802154_key_id_modes {
  247. NL802154_KEY_ID_MODE_IMPLICIT,
  248. NL802154_KEY_ID_MODE_INDEX,
  249. NL802154_KEY_ID_MODE_INDEX_SHORT,
  250. NL802154_KEY_ID_MODE_INDEX_EXTENDED,
  251. /* keep last */
  252. __NL802154_KEY_ID_MODE_AFTER_LAST,
  253. NL802154_KEY_ID_MODE_MAX = __NL802154_KEY_ID_MODE_AFTER_LAST - 1
  254. };
  255. enum nl802154_key_id_attrs {
  256. NL802154_KEY_ID_ATTR_UNSPEC,
  257. NL802154_KEY_ID_ATTR_MODE,
  258. NL802154_KEY_ID_ATTR_INDEX,
  259. NL802154_KEY_ID_ATTR_IMPLICIT,
  260. NL802154_KEY_ID_ATTR_SOURCE_SHORT,
  261. NL802154_KEY_ID_ATTR_SOURCE_EXTENDED,
  262. NL802154_KEY_ID_ATTR_PAD,
  263. /* keep last */
  264. __NL802154_KEY_ID_ATTR_AFTER_LAST,
  265. NL802154_KEY_ID_ATTR_MAX = __NL802154_KEY_ID_ATTR_AFTER_LAST - 1
  266. };
  267. enum nl802154_seclevels {
  268. NL802154_SECLEVEL_NONE,
  269. NL802154_SECLEVEL_MIC32,
  270. NL802154_SECLEVEL_MIC64,
  271. NL802154_SECLEVEL_MIC128,
  272. NL802154_SECLEVEL_ENC,
  273. NL802154_SECLEVEL_ENC_MIC32,
  274. NL802154_SECLEVEL_ENC_MIC64,
  275. NL802154_SECLEVEL_ENC_MIC128,
  276. /* keep last */
  277. __NL802154_SECLEVEL_AFTER_LAST,
  278. NL802154_SECLEVEL_MAX = __NL802154_SECLEVEL_AFTER_LAST - 1
  279. };
  280. enum nl802154_frames {
  281. NL802154_FRAME_BEACON,
  282. NL802154_FRAME_DATA,
  283. NL802154_FRAME_ACK,
  284. NL802154_FRAME_CMD,
  285. /* keep last */
  286. __NL802154_FRAME_AFTER_LAST,
  287. NL802154_FRAME_MAX = __NL802154_FRAME_AFTER_LAST - 1
  288. };
  289. enum nl802154_cmd_frames {
  290. __NL802154_CMD_FRAME_INVALID,
  291. NL802154_CMD_FRAME_ASSOC_REQUEST,
  292. NL802154_CMD_FRAME_ASSOC_RESPONSE,
  293. NL802154_CMD_FRAME_DISASSOC_NOTIFY,
  294. NL802154_CMD_FRAME_DATA_REQUEST,
  295. NL802154_CMD_FRAME_PAN_ID_CONFLICT_NOTIFY,
  296. NL802154_CMD_FRAME_ORPHAN_NOTIFY,
  297. NL802154_CMD_FRAME_BEACON_REQUEST,
  298. NL802154_CMD_FRAME_COORD_REALIGNMENT,
  299. NL802154_CMD_FRAME_GTS_REQUEST,
  300. /* keep last */
  301. __NL802154_CMD_FRAME_AFTER_LAST,
  302. NL802154_CMD_FRAME_MAX = __NL802154_CMD_FRAME_AFTER_LAST - 1
  303. };
  304. enum nl802154_seclevel_attrs {
  305. NL802154_SECLEVEL_ATTR_UNSPEC,
  306. NL802154_SECLEVEL_ATTR_LEVELS,
  307. NL802154_SECLEVEL_ATTR_FRAME,
  308. NL802154_SECLEVEL_ATTR_CMD_FRAME,
  309. NL802154_SECLEVEL_ATTR_DEV_OVERRIDE,
  310. /* keep last */
  311. __NL802154_SECLEVEL_ATTR_AFTER_LAST,
  312. NL802154_SECLEVEL_ATTR_MAX = __NL802154_SECLEVEL_ATTR_AFTER_LAST - 1
  313. };
  314. /* TODO what is this? couldn't find in mib */
  315. enum {
  316. NL802154_DEVKEY_IGNORE,
  317. NL802154_DEVKEY_RESTRICT,
  318. NL802154_DEVKEY_RECORD,
  319. /* keep last */
  320. __NL802154_DEVKEY_AFTER_LAST,
  321. NL802154_DEVKEY_MAX = __NL802154_DEVKEY_AFTER_LAST - 1
  322. };
  323. enum nl802154_dev {
  324. NL802154_DEV_ATTR_UNSPEC,
  325. NL802154_DEV_ATTR_FRAME_COUNTER,
  326. NL802154_DEV_ATTR_PAN_ID,
  327. NL802154_DEV_ATTR_SHORT_ADDR,
  328. NL802154_DEV_ATTR_EXTENDED_ADDR,
  329. NL802154_DEV_ATTR_SECLEVEL_EXEMPT,
  330. NL802154_DEV_ATTR_KEY_MODE,
  331. NL802154_DEV_ATTR_PAD,
  332. /* keep last */
  333. __NL802154_DEV_ATTR_AFTER_LAST,
  334. NL802154_DEV_ATTR_MAX = __NL802154_DEV_ATTR_AFTER_LAST - 1
  335. };
  336. enum nl802154_devkey {
  337. NL802154_DEVKEY_ATTR_UNSPEC,
  338. NL802154_DEVKEY_ATTR_FRAME_COUNTER,
  339. NL802154_DEVKEY_ATTR_EXTENDED_ADDR,
  340. NL802154_DEVKEY_ATTR_ID,
  341. NL802154_DEVKEY_ATTR_PAD,
  342. /* keep last */
  343. __NL802154_DEVKEY_ATTR_AFTER_LAST,
  344. NL802154_DEVKEY_ATTR_MAX = __NL802154_DEVKEY_ATTR_AFTER_LAST - 1
  345. };
  346. enum nl802154_key {
  347. NL802154_KEY_ATTR_UNSPEC,
  348. NL802154_KEY_ATTR_ID,
  349. NL802154_KEY_ATTR_USAGE_FRAMES,
  350. NL802154_KEY_ATTR_USAGE_CMDS,
  351. NL802154_KEY_ATTR_BYTES,
  352. /* keep last */
  353. __NL802154_KEY_ATTR_AFTER_LAST,
  354. NL802154_KEY_ATTR_MAX = __NL802154_KEY_ATTR_AFTER_LAST - 1
  355. };
  356. #define NL802154_KEY_SIZE 16
  357. #define NL802154_CMD_FRAME_NR_IDS 256
  358. #endif /* CONFIG_IEEE802154_NL802154_EXPERIMENTAL */
  359. #endif /* __NL802154_H */