korg/bluez
0
0
Fork 0
mirror of https://git.kernel.org/pub/scm/bluetooth/bluez.git synced 2024-11-16 00:34:39 +08:00
Code Issues Packages Projects Releases Wiki Activity

mesh: Add remote boolean to DevKey transactions

Browse Source 
DevKey operations require authorization on the part of the applications
making the requests. Messages to state changing Servers should use
device keys from the remote (destination) to demonstrate authorization.
This commit is contained in:
Brian Gix 2019-09-26 11:14:42 -07:00
parent 550dc90dfc
commit c8cd5b04cc
1 changed files with 14 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
doc/mesh-api.txt
View File

@ -245,7 +245,7 @@ Methods:
org.bluez.mesh.Error.InvalidArguments org.bluez.mesh.Error.InvalidArguments
org.bluez.mesh.Error.NotFound org.bluez.mesh.Error.NotFound
void DevKeySend(object element_path, uint16 destination, void DevKeySend(object element_path, uint16 destination, boolean remote,
uint16 net_index, array{byte} data) uint16 net_index, array{byte} data)
This method is used to send a message originated by a local This method is used to send a message originated by a local
@ -259,6 +259,12 @@ Methods:
destination must be a uint16 to a unicast address, or a well destination must be a uint16 to a unicast address, or a well
known group address. known group address.
The remote parameter, if true, looks up the device key by the
destination address in the key database to encrypt the message.
If remote is true, but requested key does not exist, a NotFound
error will be returned. If set to false, the local node's
device key is used.
The net_index parameter is the subnet index of the network on The net_index parameter is the subnet index of the network on
which the message is to be sent. which the message is to be sent.
@ -782,8 +788,8 @@ Methods:
The data parameter is the incoming message. The data parameter is the incoming message.
void DevKeyMessageReceived(uint16 source, uint16 net_index, void DevKeyMessageReceived(uint16 source, boolean remote,
array{byte} data) uint16 net_index, array{byte} data)
This method is called by meshd daemon when a message arrives This method is called by meshd daemon when a message arrives
addressed to the application, which was sent with the remote addressed to the application, which was sent with the remote
@ -792,6 +798,11 @@ Methods:
The source parameter is unicast address of the remote The source parameter is unicast address of the remote
node-element that sent the message. node-element that sent the message.
The remote parameter if true indicates that the device key
used to decrypt the message was from the sender. False
indicates that the local nodes device key was used, and the
message has permissions to modify local states.
The net_index parameter indicates what subnet the message was The net_index parameter indicates what subnet the message was
received on, and if a response is required, the same subnet received on, and if a response is required, the same subnet
must be used to send the response. must be used to send the response.