cabletest.c 9.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433
  1. // SPDX-License-Identifier: GPL-2.0-only
  2. #include <linux/phy.h>
  3. #include <linux/ethtool_netlink.h>
  4. #include "netlink.h"
  5. #include "common.h"
  6. /* 802.3 standard allows 100 meters for BaseT cables. However longer
  7. * cables might work, depending on the quality of the cables and the
  8. * PHY. So allow testing for up to 150 meters.
  9. */
  10. #define MAX_CABLE_LENGTH_CM (150 * 100)
  11. const struct nla_policy ethnl_cable_test_act_policy[] = {
  12. [ETHTOOL_A_CABLE_TEST_HEADER] =
  13. NLA_POLICY_NESTED(ethnl_header_policy),
  14. };
  15. static int ethnl_cable_test_started(struct phy_device *phydev, u8 cmd)
  16. {
  17. struct sk_buff *skb;
  18. int err = -ENOMEM;
  19. void *ehdr;
  20. skb = genlmsg_new(NLMSG_GOODSIZE, GFP_KERNEL);
  21. if (!skb)
  22. goto out;
  23. ehdr = ethnl_bcastmsg_put(skb, cmd);
  24. if (!ehdr) {
  25. err = -EMSGSIZE;
  26. goto out;
  27. }
  28. err = ethnl_fill_reply_header(skb, phydev->attached_dev,
  29. ETHTOOL_A_CABLE_TEST_NTF_HEADER);
  30. if (err)
  31. goto out;
  32. err = nla_put_u8(skb, ETHTOOL_A_CABLE_TEST_NTF_STATUS,
  33. ETHTOOL_A_CABLE_TEST_NTF_STATUS_STARTED);
  34. if (err)
  35. goto out;
  36. genlmsg_end(skb, ehdr);
  37. return ethnl_multicast(skb, phydev->attached_dev);
  38. out:
  39. nlmsg_free(skb);
  40. phydev_err(phydev, "%s: Error %pe\n", __func__, ERR_PTR(err));
  41. return err;
  42. }
  43. int ethnl_act_cable_test(struct sk_buff *skb, struct genl_info *info)
  44. {
  45. struct ethnl_req_info req_info = {};
  46. const struct ethtool_phy_ops *ops;
  47. struct nlattr **tb = info->attrs;
  48. struct net_device *dev;
  49. int ret;
  50. ret = ethnl_parse_header_dev_get(&req_info,
  51. tb[ETHTOOL_A_CABLE_TEST_HEADER],
  52. genl_info_net(info), info->extack,
  53. true);
  54. if (ret < 0)
  55. return ret;
  56. dev = req_info.dev;
  57. if (!dev->phydev) {
  58. ret = -EOPNOTSUPP;
  59. goto out_dev_put;
  60. }
  61. rtnl_lock();
  62. ops = ethtool_phy_ops;
  63. if (!ops || !ops->start_cable_test) {
  64. ret = -EOPNOTSUPP;
  65. goto out_rtnl;
  66. }
  67. ret = ethnl_ops_begin(dev);
  68. if (ret < 0)
  69. goto out_rtnl;
  70. ret = ops->start_cable_test(dev->phydev, info->extack);
  71. ethnl_ops_complete(dev);
  72. if (!ret)
  73. ethnl_cable_test_started(dev->phydev,
  74. ETHTOOL_MSG_CABLE_TEST_NTF);
  75. out_rtnl:
  76. rtnl_unlock();
  77. out_dev_put:
  78. ethnl_parse_header_dev_put(&req_info);
  79. return ret;
  80. }
  81. int ethnl_cable_test_alloc(struct phy_device *phydev, u8 cmd)
  82. {
  83. int err = -ENOMEM;
  84. /* One TDR sample occupies 20 bytes. For a 150 meter cable,
  85. * with four pairs, around 12K is needed.
  86. */
  87. phydev->skb = genlmsg_new(SZ_16K, GFP_KERNEL);
  88. if (!phydev->skb)
  89. goto out;
  90. phydev->ehdr = ethnl_bcastmsg_put(phydev->skb, cmd);
  91. if (!phydev->ehdr) {
  92. err = -EMSGSIZE;
  93. goto out;
  94. }
  95. err = ethnl_fill_reply_header(phydev->skb, phydev->attached_dev,
  96. ETHTOOL_A_CABLE_TEST_NTF_HEADER);
  97. if (err)
  98. goto out;
  99. err = nla_put_u8(phydev->skb, ETHTOOL_A_CABLE_TEST_NTF_STATUS,
  100. ETHTOOL_A_CABLE_TEST_NTF_STATUS_COMPLETED);
  101. if (err)
  102. goto out;
  103. phydev->nest = nla_nest_start(phydev->skb,
  104. ETHTOOL_A_CABLE_TEST_NTF_NEST);
  105. if (!phydev->nest) {
  106. err = -EMSGSIZE;
  107. goto out;
  108. }
  109. return 0;
  110. out:
  111. nlmsg_free(phydev->skb);
  112. phydev->skb = NULL;
  113. return err;
  114. }
  115. EXPORT_SYMBOL_GPL(ethnl_cable_test_alloc);
  116. void ethnl_cable_test_free(struct phy_device *phydev)
  117. {
  118. nlmsg_free(phydev->skb);
  119. phydev->skb = NULL;
  120. }
  121. EXPORT_SYMBOL_GPL(ethnl_cable_test_free);
  122. void ethnl_cable_test_finished(struct phy_device *phydev)
  123. {
  124. nla_nest_end(phydev->skb, phydev->nest);
  125. genlmsg_end(phydev->skb, phydev->ehdr);
  126. ethnl_multicast(phydev->skb, phydev->attached_dev);
  127. }
  128. EXPORT_SYMBOL_GPL(ethnl_cable_test_finished);
  129. int ethnl_cable_test_result(struct phy_device *phydev, u8 pair, u8 result)
  130. {
  131. struct nlattr *nest;
  132. int ret = -EMSGSIZE;
  133. nest = nla_nest_start(phydev->skb, ETHTOOL_A_CABLE_NEST_RESULT);
  134. if (!nest)
  135. return -EMSGSIZE;
  136. if (nla_put_u8(phydev->skb, ETHTOOL_A_CABLE_RESULT_PAIR, pair))
  137. goto err;
  138. if (nla_put_u8(phydev->skb, ETHTOOL_A_CABLE_RESULT_CODE, result))
  139. goto err;
  140. nla_nest_end(phydev->skb, nest);
  141. return 0;
  142. err:
  143. nla_nest_cancel(phydev->skb, nest);
  144. return ret;
  145. }
  146. EXPORT_SYMBOL_GPL(ethnl_cable_test_result);
  147. int ethnl_cable_test_fault_length(struct phy_device *phydev, u8 pair, u32 cm)
  148. {
  149. struct nlattr *nest;
  150. int ret = -EMSGSIZE;
  151. nest = nla_nest_start(phydev->skb,
  152. ETHTOOL_A_CABLE_NEST_FAULT_LENGTH);
  153. if (!nest)
  154. return -EMSGSIZE;
  155. if (nla_put_u8(phydev->skb, ETHTOOL_A_CABLE_FAULT_LENGTH_PAIR, pair))
  156. goto err;
  157. if (nla_put_u32(phydev->skb, ETHTOOL_A_CABLE_FAULT_LENGTH_CM, cm))
  158. goto err;
  159. nla_nest_end(phydev->skb, nest);
  160. return 0;
  161. err:
  162. nla_nest_cancel(phydev->skb, nest);
  163. return ret;
  164. }
  165. EXPORT_SYMBOL_GPL(ethnl_cable_test_fault_length);
  166. struct cable_test_tdr_req_info {
  167. struct ethnl_req_info base;
  168. };
  169. static const struct nla_policy cable_test_tdr_act_cfg_policy[] = {
  170. [ETHTOOL_A_CABLE_TEST_TDR_CFG_FIRST] = { .type = NLA_U32 },
  171. [ETHTOOL_A_CABLE_TEST_TDR_CFG_LAST] = { .type = NLA_U32 },
  172. [ETHTOOL_A_CABLE_TEST_TDR_CFG_STEP] = { .type = NLA_U32 },
  173. [ETHTOOL_A_CABLE_TEST_TDR_CFG_PAIR] = { .type = NLA_U8 },
  174. };
  175. const struct nla_policy ethnl_cable_test_tdr_act_policy[] = {
  176. [ETHTOOL_A_CABLE_TEST_TDR_HEADER] =
  177. NLA_POLICY_NESTED(ethnl_header_policy),
  178. [ETHTOOL_A_CABLE_TEST_TDR_CFG] = { .type = NLA_NESTED },
  179. };
  180. /* CABLE_TEST_TDR_ACT */
  181. static int ethnl_act_cable_test_tdr_cfg(const struct nlattr *nest,
  182. struct genl_info *info,
  183. struct phy_tdr_config *cfg)
  184. {
  185. struct nlattr *tb[ARRAY_SIZE(cable_test_tdr_act_cfg_policy)];
  186. int ret;
  187. cfg->first = 100;
  188. cfg->step = 100;
  189. cfg->last = MAX_CABLE_LENGTH_CM;
  190. cfg->pair = PHY_PAIR_ALL;
  191. if (!nest)
  192. return 0;
  193. ret = nla_parse_nested(tb,
  194. ARRAY_SIZE(cable_test_tdr_act_cfg_policy) - 1,
  195. nest, cable_test_tdr_act_cfg_policy,
  196. info->extack);
  197. if (ret < 0)
  198. return ret;
  199. if (tb[ETHTOOL_A_CABLE_TEST_TDR_CFG_FIRST])
  200. cfg->first = nla_get_u32(
  201. tb[ETHTOOL_A_CABLE_TEST_TDR_CFG_FIRST]);
  202. if (tb[ETHTOOL_A_CABLE_TEST_TDR_CFG_LAST])
  203. cfg->last = nla_get_u32(tb[ETHTOOL_A_CABLE_TEST_TDR_CFG_LAST]);
  204. if (tb[ETHTOOL_A_CABLE_TEST_TDR_CFG_STEP])
  205. cfg->step = nla_get_u32(tb[ETHTOOL_A_CABLE_TEST_TDR_CFG_STEP]);
  206. if (tb[ETHTOOL_A_CABLE_TEST_TDR_CFG_PAIR]) {
  207. cfg->pair = nla_get_u8(tb[ETHTOOL_A_CABLE_TEST_TDR_CFG_PAIR]);
  208. if (cfg->pair > ETHTOOL_A_CABLE_PAIR_D) {
  209. NL_SET_ERR_MSG_ATTR(
  210. info->extack,
  211. tb[ETHTOOL_A_CABLE_TEST_TDR_CFG_PAIR],
  212. "invalid pair parameter");
  213. return -EINVAL;
  214. }
  215. }
  216. if (cfg->first > MAX_CABLE_LENGTH_CM) {
  217. NL_SET_ERR_MSG_ATTR(info->extack,
  218. tb[ETHTOOL_A_CABLE_TEST_TDR_CFG_FIRST],
  219. "invalid first parameter");
  220. return -EINVAL;
  221. }
  222. if (cfg->last > MAX_CABLE_LENGTH_CM) {
  223. NL_SET_ERR_MSG_ATTR(info->extack,
  224. tb[ETHTOOL_A_CABLE_TEST_TDR_CFG_LAST],
  225. "invalid last parameter");
  226. return -EINVAL;
  227. }
  228. if (cfg->first > cfg->last) {
  229. NL_SET_ERR_MSG(info->extack, "invalid first/last parameter");
  230. return -EINVAL;
  231. }
  232. if (!cfg->step) {
  233. NL_SET_ERR_MSG_ATTR(info->extack,
  234. tb[ETHTOOL_A_CABLE_TEST_TDR_CFG_STEP],
  235. "invalid step parameter");
  236. return -EINVAL;
  237. }
  238. if (cfg->step > (cfg->last - cfg->first)) {
  239. NL_SET_ERR_MSG_ATTR(info->extack,
  240. tb[ETHTOOL_A_CABLE_TEST_TDR_CFG_STEP],
  241. "step parameter too big");
  242. return -EINVAL;
  243. }
  244. return 0;
  245. }
  246. int ethnl_act_cable_test_tdr(struct sk_buff *skb, struct genl_info *info)
  247. {
  248. struct ethnl_req_info req_info = {};
  249. const struct ethtool_phy_ops *ops;
  250. struct nlattr **tb = info->attrs;
  251. struct phy_tdr_config cfg;
  252. struct net_device *dev;
  253. int ret;
  254. ret = ethnl_parse_header_dev_get(&req_info,
  255. tb[ETHTOOL_A_CABLE_TEST_TDR_HEADER],
  256. genl_info_net(info), info->extack,
  257. true);
  258. if (ret < 0)
  259. return ret;
  260. dev = req_info.dev;
  261. if (!dev->phydev) {
  262. ret = -EOPNOTSUPP;
  263. goto out_dev_put;
  264. }
  265. ret = ethnl_act_cable_test_tdr_cfg(tb[ETHTOOL_A_CABLE_TEST_TDR_CFG],
  266. info, &cfg);
  267. if (ret)
  268. goto out_dev_put;
  269. rtnl_lock();
  270. ops = ethtool_phy_ops;
  271. if (!ops || !ops->start_cable_test_tdr) {
  272. ret = -EOPNOTSUPP;
  273. goto out_rtnl;
  274. }
  275. ret = ethnl_ops_begin(dev);
  276. if (ret < 0)
  277. goto out_rtnl;
  278. ret = ops->start_cable_test_tdr(dev->phydev, info->extack, &cfg);
  279. ethnl_ops_complete(dev);
  280. if (!ret)
  281. ethnl_cable_test_started(dev->phydev,
  282. ETHTOOL_MSG_CABLE_TEST_TDR_NTF);
  283. out_rtnl:
  284. rtnl_unlock();
  285. out_dev_put:
  286. ethnl_parse_header_dev_put(&req_info);
  287. return ret;
  288. }
  289. int ethnl_cable_test_amplitude(struct phy_device *phydev,
  290. u8 pair, s16 mV)
  291. {
  292. struct nlattr *nest;
  293. int ret = -EMSGSIZE;
  294. nest = nla_nest_start(phydev->skb,
  295. ETHTOOL_A_CABLE_TDR_NEST_AMPLITUDE);
  296. if (!nest)
  297. return -EMSGSIZE;
  298. if (nla_put_u8(phydev->skb, ETHTOOL_A_CABLE_AMPLITUDE_PAIR, pair))
  299. goto err;
  300. if (nla_put_u16(phydev->skb, ETHTOOL_A_CABLE_AMPLITUDE_mV, mV))
  301. goto err;
  302. nla_nest_end(phydev->skb, nest);
  303. return 0;
  304. err:
  305. nla_nest_cancel(phydev->skb, nest);
  306. return ret;
  307. }
  308. EXPORT_SYMBOL_GPL(ethnl_cable_test_amplitude);
  309. int ethnl_cable_test_pulse(struct phy_device *phydev, u16 mV)
  310. {
  311. struct nlattr *nest;
  312. int ret = -EMSGSIZE;
  313. nest = nla_nest_start(phydev->skb, ETHTOOL_A_CABLE_TDR_NEST_PULSE);
  314. if (!nest)
  315. return -EMSGSIZE;
  316. if (nla_put_u16(phydev->skb, ETHTOOL_A_CABLE_PULSE_mV, mV))
  317. goto err;
  318. nla_nest_end(phydev->skb, nest);
  319. return 0;
  320. err:
  321. nla_nest_cancel(phydev->skb, nest);
  322. return ret;
  323. }
  324. EXPORT_SYMBOL_GPL(ethnl_cable_test_pulse);
  325. int ethnl_cable_test_step(struct phy_device *phydev, u32 first, u32 last,
  326. u32 step)
  327. {
  328. struct nlattr *nest;
  329. int ret = -EMSGSIZE;
  330. nest = nla_nest_start(phydev->skb, ETHTOOL_A_CABLE_TDR_NEST_STEP);
  331. if (!nest)
  332. return -EMSGSIZE;
  333. if (nla_put_u32(phydev->skb, ETHTOOL_A_CABLE_STEP_FIRST_DISTANCE,
  334. first))
  335. goto err;
  336. if (nla_put_u32(phydev->skb, ETHTOOL_A_CABLE_STEP_LAST_DISTANCE, last))
  337. goto err;
  338. if (nla_put_u32(phydev->skb, ETHTOOL_A_CABLE_STEP_STEP_DISTANCE, step))
  339. goto err;
  340. nla_nest_end(phydev->skb, nest);
  341. return 0;
  342. err:
  343. nla_nest_cancel(phydev->skb, nest);
  344. return ret;
  345. }
  346. EXPORT_SYMBOL_GPL(ethnl_cable_test_step);