2
0
mirror of https://github.com/edk2-porting/linux-next.git synced 2024-11-30 13:34:44 +08:00

ieee802154: Advertize coordinators discovery

Let's introduce the basics for advertizing discovered PANs and
coordinators, which is:
- A new "scan" netlink message group.
- A couple of netlink command/attribute.
- The main netlink helper to send a netlink message with all the
  necessary information to forward the main information to the user.

Two netlink attributes are proactively added to support future UWB
complex channels, but are not actually used yet.

Co-developed-by: David Girault <david.girault@qorvo.com>
Signed-off-by: David Girault <david.girault@qorvo.com>
Signed-off-by: Miquel Raynal <miquel.raynal@bootlin.com>
Acked-by: Alexander Aring <aahringo@redhat.com>
Link: https://lore.kernel.org/r/20221129135535.532513-2-miquel.raynal@bootlin.com
Signed-off-by: Stefan Schmidt <stefan@datenfreihafen.org>
This commit is contained in:
Miquel Raynal 2022-11-29 14:55:34 +01:00 committed by Stefan Schmidt
parent 2622e785f7
commit 51147284eb
4 changed files with 166 additions and 0 deletions

View File

@ -260,6 +260,24 @@ struct ieee802154_addr {
};
};
/**
* struct ieee802154_coord_desc - Coordinator descriptor
* @addr: PAN ID and coordinator address
* @page: page this coordinator is using
* @channel: channel this coordinator is using
* @superframe_spec: SuperFrame specification as received
* @link_quality: link quality indicator at which the beacon was received
* @gts_permit: the coordinator accepts GTS requests
*/
struct ieee802154_coord_desc {
struct ieee802154_addr addr;
u8 page;
u8 channel;
u16 superframe_spec;
u8 link_quality;
bool gts_permit;
};
struct ieee802154_llsec_key_id {
u8 mode;
u8 id;

View File

@ -72,6 +72,8 @@ enum nl802154_commands {
NL802154_CMD_NEW_SEC_LEVEL,
NL802154_CMD_DEL_SEC_LEVEL,
NL802154_CMD_SCAN_EVENT,
/* add new commands above here */
/* used to define NL802154_CMD_MAX below */
@ -131,6 +133,8 @@ enum nl802154_attrs {
NL802154_ATTR_PID,
NL802154_ATTR_NETNS_FD,
NL802154_ATTR_COORDINATOR,
/* add attributes here, update the policy in nl802154.c */
#ifdef CONFIG_IEEE802154_NL802154_EXPERIMENTAL
@ -216,6 +220,45 @@ enum nl802154_wpan_phy_capability_attr {
NL802154_CAP_ATTR_MAX = __NL802154_CAP_ATTR_AFTER_LAST - 1
};
/**
* enum nl802154_coord - Netlink attributes for a coord
*
* @__NL802154_COORD_INVALID: invalid
* @NL802154_COORD_PANID: PANID of the coordinator (2 bytes)
* @NL802154_COORD_ADDR: coordinator address, (8 bytes or 2 bytes)
* @NL802154_COORD_CHANNEL: channel number, related to @NL802154_COORD_PAGE (u8)
* @NL802154_COORD_PAGE: channel page, related to @NL802154_COORD_CHANNEL (u8)
* @NL802154_COORD_PREAMBLE_CODE: Preamble code used when the beacon was received,
* this is PHY dependent and optional (u8)
* @NL802154_COORD_MEAN_PRF: Mean PRF used when the beacon was received,
* this is PHY dependent and optional (u8)
* @NL802154_COORD_SUPERFRAME_SPEC: superframe specification of the PAN (u16)
* @NL802154_COORD_LINK_QUALITY: signal quality of beacon in unspecified units,
* scaled to 0..255 (u8)
* @NL802154_COORD_GTS_PERMIT: set to true if GTS is permitted on this PAN
* @NL802154_COORD_PAYLOAD_DATA: binary data containing the raw data from the
* frame payload, (only if beacon or probe response had data)
* @NL802154_COORD_PAD: attribute used for padding for 64-bit alignment
* @NL802154_COORD_MAX: highest coordinator attribute
*/
enum nl802154_coord {
__NL802154_COORD_INVALID,
NL802154_COORD_PANID,
NL802154_COORD_ADDR,
NL802154_COORD_CHANNEL,
NL802154_COORD_PAGE,
NL802154_COORD_PREAMBLE_CODE,
NL802154_COORD_MEAN_PRF,
NL802154_COORD_SUPERFRAME_SPEC,
NL802154_COORD_LINK_QUALITY,
NL802154_COORD_GTS_PERMIT,
NL802154_COORD_PAYLOAD_DATA,
NL802154_COORD_PAD,
/* keep last */
NL802154_COORD_MAX,
};
/**
* enum nl802154_cca_modes - cca modes
*

View File

@ -26,10 +26,12 @@ static struct genl_family nl802154_fam;
/* multicast groups */
enum nl802154_multicast_groups {
NL802154_MCGRP_CONFIG,
NL802154_MCGRP_SCAN,
};
static const struct genl_multicast_group nl802154_mcgrps[] = {
[NL802154_MCGRP_CONFIG] = { .name = "config", },
[NL802154_MCGRP_SCAN] = { .name = "scan", },
};
/* returns ERR_PTR values */
@ -216,6 +218,9 @@ static const struct nla_policy nl802154_policy[NL802154_ATTR_MAX+1] = {
[NL802154_ATTR_PID] = { .type = NLA_U32 },
[NL802154_ATTR_NETNS_FD] = { .type = NLA_U32 },
[NL802154_ATTR_COORDINATOR] = { .type = NLA_NESTED },
#ifdef CONFIG_IEEE802154_NL802154_EXPERIMENTAL
[NL802154_ATTR_SEC_ENABLED] = { .type = NLA_U8, },
[NL802154_ATTR_SEC_OUT_LEVEL] = { .type = NLA_U32, },
@ -1281,6 +1286,104 @@ static int nl802154_wpan_phy_netns(struct sk_buff *skb, struct genl_info *info)
return err;
}
static int nl802154_prep_scan_event_msg(struct sk_buff *msg,
struct cfg802154_registered_device *rdev,
struct wpan_dev *wpan_dev,
u32 portid, u32 seq, int flags, u8 cmd,
struct ieee802154_coord_desc *desc)
{
struct nlattr *nla;
void *hdr;
hdr = nl802154hdr_put(msg, portid, seq, flags, cmd);
if (!hdr)
return -ENOBUFS;
if (nla_put_u32(msg, NL802154_ATTR_WPAN_PHY, rdev->wpan_phy_idx))
goto nla_put_failure;
if (wpan_dev->netdev &&
nla_put_u32(msg, NL802154_ATTR_IFINDEX, wpan_dev->netdev->ifindex))
goto nla_put_failure;
if (nla_put_u64_64bit(msg, NL802154_ATTR_WPAN_DEV,
wpan_dev_id(wpan_dev), NL802154_ATTR_PAD))
goto nla_put_failure;
nla = nla_nest_start_noflag(msg, NL802154_ATTR_COORDINATOR);
if (!nla)
goto nla_put_failure;
if (nla_put(msg, NL802154_COORD_PANID, IEEE802154_PAN_ID_LEN,
&desc->addr.pan_id))
goto nla_put_failure;
if (desc->addr.mode == IEEE802154_ADDR_SHORT) {
if (nla_put(msg, NL802154_COORD_ADDR,
IEEE802154_SHORT_ADDR_LEN,
&desc->addr.short_addr))
goto nla_put_failure;
} else {
if (nla_put(msg, NL802154_COORD_ADDR,
IEEE802154_EXTENDED_ADDR_LEN,
&desc->addr.extended_addr))
goto nla_put_failure;
}
if (nla_put_u8(msg, NL802154_COORD_CHANNEL, desc->channel))
goto nla_put_failure;
if (nla_put_u8(msg, NL802154_COORD_PAGE, desc->page))
goto nla_put_failure;
if (nla_put_u16(msg, NL802154_COORD_SUPERFRAME_SPEC,
desc->superframe_spec))
goto nla_put_failure;
if (nla_put_u8(msg, NL802154_COORD_LINK_QUALITY, desc->link_quality))
goto nla_put_failure;
if (desc->gts_permit && nla_put_flag(msg, NL802154_COORD_GTS_PERMIT))
goto nla_put_failure;
/* TODO: NL802154_COORD_PAYLOAD_DATA if any */
nla_nest_end(msg, nla);
genlmsg_end(msg, hdr);
return 0;
nla_put_failure:
genlmsg_cancel(msg, hdr);
return -EMSGSIZE;
}
int nl802154_scan_event(struct wpan_phy *wpan_phy, struct wpan_dev *wpan_dev,
struct ieee802154_coord_desc *desc)
{
struct cfg802154_registered_device *rdev = wpan_phy_to_rdev(wpan_phy);
struct sk_buff *msg;
int ret;
msg = nlmsg_new(NLMSG_DEFAULT_SIZE, GFP_ATOMIC);
if (!msg)
return -ENOMEM;
ret = nl802154_prep_scan_event_msg(msg, rdev, wpan_dev, 0, 0, 0,
NL802154_CMD_SCAN_EVENT,
desc);
if (ret < 0) {
nlmsg_free(msg);
return ret;
}
return genlmsg_multicast_netns(&nl802154_fam, wpan_phy_net(wpan_phy),
msg, 0, NL802154_MCGRP_SCAN, GFP_ATOMIC);
}
EXPORT_SYMBOL_GPL(nl802154_scan_event);
#ifdef CONFIG_IEEE802154_NL802154_EXPERIMENTAL
static const struct nla_policy nl802154_dev_addr_policy[NL802154_DEV_ADDR_ATTR_MAX + 1] = {
[NL802154_DEV_ADDR_ATTR_PAN_ID] = { .type = NLA_U16 },

View File

@ -4,5 +4,7 @@
int nl802154_init(void);
void nl802154_exit(void);
int nl802154_scan_event(struct wpan_phy *wpan_phy, struct wpan_dev *wpan_dev,
struct ieee802154_coord_desc *desc);
#endif /* __IEEE802154_NL802154_H */