Skip to content

feat: [UCR] Device functions#1288

Open
dmocek wants to merge 8 commits into
edgexfoundry:mainfrom
dmocek:device-functions
Open

feat: [UCR] Device functions#1288
dmocek wants to merge 8 commits into
edgexfoundry:mainfrom
dmocek:device-functions

Conversation

@dmocek

@dmocek dmocek commented Nov 7, 2023

Copy link
Copy Markdown

Add Device Functions UCR.

@jpwhitemn

Copy link
Copy Markdown
Member

@dmocek - you are getting a DCO failure because your commits don't have a flag to certificate of origin. See https://wiki.edgexfoundry.org/display/FA/Contributor%27s+Guide#Contributor'sGuide-SubmissionDCO

You just need to add a "-s" flag to your commit requests (ex: git commit -s -m "feat:my commit message").

It is also failing on Semantic PR labeling. In your commit message, you need to specify that this is new feature, bug fix, etc. In this case, it would be a feature (feat). So use "feat" in your commit message as I did in my example above. See https://github.com/edgexfoundry/edgex-docs/blob/main/.github/semantic.yml for the allowed options.

Comment thread docs_src/design/ucr/device-functions.md
@lenny-goodell lenny-goodell changed the title Device functions feat: [UCR] Device functions Nov 29, 2023
@lenny-goodell

Copy link
Copy Markdown
Member

@dmocek . you also need to add this UCR to the UCR TOC here: https://docs.edgexfoundry.org/3.1/design/TOC/
See this PR as example: #938

@dmocek

dmocek commented Dec 6, 2023

Copy link
Copy Markdown
Author

Added to TOC.

Signed-off-by: Darryl Mocek <darryl.mocek@oracle.com>
Signed-off-by: Darryl Mocek <darryl.mocek@oracle.com>
Signed-off-by: Darryl Mocek <darryl.mocek@oracle.com>
Signed-off-by: Darryl Mocek <darryl.mocek@oracle.com>
Signed-off-by: Darryl Mocek <darryl.mocek@oracle.com>
Signed-off-by: Darryl Mocek <darryl.mocek@oracle.com>
Signed-off-by: Darryl Mocek <darryl.mocek@oracle.com>
Signed-off-by: Darryl Mocek <darryl.mocek@oracle.com>
@dmocek

dmocek commented Dec 8, 2023

Copy link
Copy Markdown
Author

All issues have been fixed.

@lenny-goodell lenny-goodell left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A bit more tweaking of the requirements.

EdgeX supports setting attributes on a device. The workaround for calling device functions currently in EdgeX is to configure a device to call a function when setting at attribute, which isn't always feasible. For example, to call a 'reboot' device function on a device, a 'reboot' attribute would have to be created and it would have to be set to a value to invoke the reboot function on the device.

## Requirements
Each Device should have a function resource and its parameters defined to support calling the device function with appropriate parameters.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Each Device should have a function resource and its parameters defined to support calling the device function with appropriate parameters.
- Device Profiles shall have function resources which includes parameters defined to support calling the device function(s) with appropriate parameters.
- A new `Call` Command type shall be created to support calling the new function resources.

@cloudxxx8 cloudxxx8 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The use case looks good to me

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants