feat: Add Client API to Support object value type in Set Command

clients/http/command.go

@@ -76,3 +76,13 @@ func (client *CommandClient) IssueSetCommandByName(ctx context.Context, deviceNa
 	}
 	return res, nil
 }
+
+// IssueSetCommandByNameWithObject issues the specified write command and the settings supports object value type
+func (client *CommandClient) IssueSetCommandByNameWithObject(ctx context.Context, deviceName string, commandName string, settings map[string]interface{}) (res dtoCommon.BaseResponse, err errors.EdgeX) {
+	requestPath := path.Join(common.ApiDeviceRoute, common.Name, url.QueryEscape(deviceName), url.QueryEscape(commandName))
+	err = utils.PutRequest(ctx, &res, client.baseUrl+requestPath, settings)
+	if err != nil {
+		return res, errors.NewCommonEdgeXWrapper(err)
+	}
+	return res, nil
+}

clients/http/command_test.go

@@ -64,3 +64,21 @@ func TestIssueIssueSetCommandByName(t *testing.T) {
 	require.NoError(t, err)
 	require.IsType(t, dtoCommon.BaseResponse{}, res)
 }
+
+func TestIssueIssueSetCommandByNameWithObject(t *testing.T) {
+	deviceName := "Simple-Device01"
+	cmdName := "SwitchButton"
+	settings := map[string]interface{}{
+		"SwitchButton": map[string]interface{}{
+			"kind":  "button",
+			"value": "on",
+		},
+	}
+	path := path.Join(common.ApiDeviceRoute, common.Name, deviceName, cmdName)
+	ts := newTestServer(http.MethodPut, path, dtoCommon.BaseResponse{})
+	defer ts.Close()
+	client := NewCommandClient(ts.URL)
+	res, err := client.IssueSetCommandByNameWithObject(context.Background(), deviceName, cmdName, settings)
+	require.NoError(t, err)
+	require.IsType(t, dtoCommon.BaseResponse{}, res)
+}

clients/http/deviceservicecommand.go

@@ -67,3 +67,14 @@ func (client *deviceServiceCommandClient) SetCommand(ctx context.Context, baseUr
 	}
 	return response, nil
 }
+
+// SetCommandWithObject invokes device service's set command API and the settings supports object value type
+func (client *deviceServiceCommandClient) SetCommandWithObject(ctx context.Context, baseUrl string, deviceName string, commandName string, queryParams string, settings map[string]interface{}) (dtoCommon.BaseResponse, errors.EdgeX) {
+	var response dtoCommon.BaseResponse
+	requestPath := path.Join(common.ApiDeviceRoute, common.Name, url.QueryEscape(deviceName), url.QueryEscape(commandName))
+	err := utils.PutRequest(ctx, &response, baseUrl+requestPath+"?"+queryParams, settings)
+	if err != nil {
+		return response, errors.NewCommonEdgeXWrapper(err)
+	}
+	return response, nil
+}

clients/http/deviceservicecommand_test.go

@@ -66,3 +66,22 @@ func TestSetCommand(t *testing.T) {
 	require.NoError(t, err)
 	assert.Equal(t, requestId, res.RequestId)
 }
+
+func TestSetCommandWithObject(t *testing.T) {
+	requestId := uuid.New().String()
+	expectedResponse := dtoCommon.NewBaseResponse(requestId, "", http.StatusOK)
+	ts := newTestServer(http.MethodPut, common.ApiDeviceRoute+"/"+common.Name+"/"+TestDeviceName+"/"+TestCommandName, expectedResponse)
+	defer ts.Close()
+	settings := map[string]interface{}{
+		"SwitchButton": map[string]interface{}{
+			"kind":  "button",
+			"value": "on",
+		},
+	}
+
+	client := NewDeviceServiceCommandClient()
+	res, err := client.SetCommandWithObject(context.Background(), ts.URL, TestDeviceName, TestCommandName, "", settings)
+
+	require.NoError(t, err)
+	assert.Equal(t, requestId, res.RequestId)
+}

clients/interfaces/command.go

@@ -28,4 +28,6 @@ type CommandClient interface {
 	IssueGetCommandByName(ctx context.Context, deviceName string, commandName string, dsPushEvent string, dsReturnEvent string) (*responses.EventResponse, errors.EdgeX)
 	// IssueSetCommandByName issues the specified write command referenced by the command name to the device/sensor that is also referenced by name.
 	IssueSetCommandByName(ctx context.Context, deviceName string, commandName string, settings map[string]string) (common.BaseResponse, errors.EdgeX)
+	// IssueSetCommandByNameWithObject issues the specified write command and the settings supports object value type
+	IssueSetCommandByNameWithObject(ctx context.Context, deviceName string, commandName string, settings map[string]interface{}) (common.BaseResponse, errors.EdgeX)
 }

clients/interfaces/deviceservicecommand.go

@@ -19,4 +19,6 @@ type DeviceServiceCommandClient interface {
 	GetCommand(ctx context.Context, baseUrl string, deviceName string, commandName string, queryParams string) (*responses.EventResponse, errors.EdgeX)
 	// SetCommand invokes device service's command API for issuing set(write) command
 	SetCommand(ctx context.Context, baseUrl string, deviceName string, commandName string, queryParams string, settings map[string]string) (common.BaseResponse, errors.EdgeX)
+	// SetCommandWithObject invokes device service's set command API and the settings supports object value type
+	SetCommandWithObject(ctx context.Context, baseUrl string, deviceName string, commandName string, queryParams string, settings map[string]interface{}) (common.BaseResponse, errors.EdgeX)
 }

dtos/deviceprofile.go

@@ -104,9 +104,9 @@ func ValidateDeviceProfileDTO(profile DeviceProfile) error {
 	// deviceResources validation
 	dupCheck := make(map[string]bool)
 	for _, resource := range profile.DeviceResources {
-		if (resource.Properties.ValueType == common.ValueTypeBinary || resource.Properties.ValueType == common.ValueTypeObject) &&
+		if resource.Properties.ValueType == common.ValueTypeBinary &&
 			strings.Contains(resource.Properties.ReadWrite, common.ReadWrite_W) {
-			return errors.NewCommonEdgeX(errors.KindContractInvalid, fmt.Sprintf("write permission not support %s and %s value type for resource '%s'", common.ValueTypeBinary, common.ValueTypeObject, resource.Name), nil)
+			return errors.NewCommonEdgeX(errors.KindContractInvalid, fmt.Sprintf("write permission not support %s value type for resource '%s'", common.ValueTypeBinary, resource.Name), nil)
 		}
 		// deviceResource name should not duplicated
 		if dupCheck[resource.Name] {

dtos/deviceprofile_test.go

@@ -97,9 +97,6 @@ func TestDeviceProfileDTOValidation(t *testing.T) {
 	binaryWithWritePermission := profileData()
 	binaryWithWritePermission.DeviceResources[0].Properties.ValueType = common.ValueTypeBinary
 	binaryWithWritePermission.DeviceResources[0].Properties.ReadWrite = common.ReadWrite_RW
-	objectWithWritePermission := profileData()
-	objectWithWritePermission.DeviceResources[0].Properties.ValueType = common.ValueTypeObject
-	objectWithWritePermission.DeviceResources[0].Properties.ReadWrite = common.ReadWrite_W
 
 	tests := []struct {
 		name        string
@@ -112,7 +109,6 @@ func TestDeviceProfileDTOValidation(t *testing.T) {
 		{"mismatched resource", mismatchedResource, true},
 		{"invalid ReadWrite permission", invalidReadWrite, true},
 		{"write permission not support Binary value type", binaryWithWritePermission, true},
-		{"write permission not support Object value type", objectWithWritePermission, true},
 	}
 
 	for _, tt := range tests {