tag_create

Name

tag_create -- Create a new tag, or change an existing.

Parameter Format

The following table shows how the command is encoded for network transmission:

TypeNameDescription
uint8id = 18The command byte that identifies this command.
VNodeIDnode_idThe ID of the node being accessed.
uint16group_idThe ID of the tag group being accessed.
uint16tag_idSet to ~0 in a client-to-host request to create a new tag, which is then filled in by the host in the reponse. Can be set to the value of an existing tag to work as a rename or just to re-set a tag to a new value.
(End of address part of command, below is data payload)
string16nameThe name of the tag to create, or the new name for the tag if doing a rename (see above).
VNTagTypetypeThe value type of this tag.
VNTagtagThe desired tag value. The content of this union value is controlled by the type parameter, above.

Description

This command asks the host to create a new tag in the indicated group, with the given name and value.

It can also be used to change the value of an existing tag, or the name, by filling in known values for the ID and name parameters, respectively.