Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

fix(config): clean up auto-import for Shelly Wave 1PM #6289

Merged
merged 24 commits into from
Sep 21, 2023
Merged

fix(config): clean up auto-import for Shelly Wave 1PM #6289

merged 24 commits into from
Sep 21, 2023

Conversation

QubinoHelp
Copy link
Contributor

  • added name manufacturer
  • corrected Label & description
  • fixed product Type & productId
  • removed zwaveAllianceId (do not have one yet)
  • added parameters description and options
  • changed filename

@QubinoHelp
Copy link
Contributor Author

@AlCalzone Can you please review these errors? Some of the test files report errors although we did not use them. They go unused.

@AlCalzone
Copy link
Member

Will take a look tomorrow and let you know what needs to be changed.

- updated label
- updated description (product name)
- corrected the productType & productId
- added parameter descriptions
- added name manufacturer
- corrected Label & description
- removed zwaveAllianceId (do not have one yet)
- added parameters description and options
- added read only state to parameter 201, 202, 203
@zwave-js-assistant zwave-js-assistant bot added the config ⚙ Configuration issues or updates label Sep 20, 2023
@AlCalzone
Copy link
Member

AlCalzone commented Sep 20, 2023

Looks like you based your branch on the wrong branch from our repo - or maybe the merge messed it up. I fixed that, but I had to force-push to your branch.

Before doing any further changes, please reset your local copy of the branch to the one on Github. Assuming you did not rename the remote, and you are on the correct branch locally, this command should do it:

git reset --hard origin/import-config-1694608670

The file seems to be syntactically correct, I'll give you a more detailed style review now.

Copy link
Member

@AlCalzone AlCalzone left a comment

Choose a reason for hiding this comment

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

Thanks a lot! I have a few remarks, mostly related to consistency and following our style guide.
Feel free to ask if there is anything unclear or you need help.

"paramInformation": [
{
"#": "1",
"label": "Sw1 Switch Type",
"description": "0",
"description": "This parameter defines how the Device should treat the switch (which type) connected to the SW (SW1) terminal.",
Copy link
Member

Choose a reason for hiding this comment

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

We try to avoid parameter descriptions unless necessary for understanding what the parameter does, or to provide additional information like gaps in the allowed parameter range.
https://zwave-js.github.io/node-zwave-js/#/config-files/style-guide?id=parameter-descriptions

packages/config/config/devices/0x0460/qnsw-001P16.json Outdated Show resolved Hide resolved
packages/config/config/devices/0x0460/qnsw-001P16.json Outdated Show resolved Hide resolved
packages/config/config/devices/0x0460/qnsw-001P16.json Outdated Show resolved Hide resolved
packages/config/config/devices/0x0460/qnsw-001P16.json Outdated Show resolved Hide resolved
packages/config/config/devices/0x0460/qnsw-001P16.json Outdated Show resolved Hide resolved
packages/config/config/devices/0x0460/qnsw-001P16.json Outdated Show resolved Hide resolved
},
{
"#": "201",
"label": "Serial Number 1",
"description": "0",
"description": "This parameter contains a part of device’s serial number.\nThe parameter is Read-Only and cannot be changed.\nThe parameter is Advanced and may be hidden under the Advanced tag.",
Copy link
Member

Choose a reason for hiding this comment

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

I'd remove the description. That it is read-only is already included in the definition. And the last sentence doesn't give any useful information to the end user.

Copy link
Member

Choose a reason for hiding this comment

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

same for the next ones

packages/config/config/devices/0x0460/qnsw-001P16.json Outdated Show resolved Hide resolved
@QubinoHelp
Copy link
Contributor Author

Thank you very much for the detailed report of the configuration file. I will go trough all of the suggested changes.

What I did is practically took the descriptions from our database for the manuals. I will see what we can change in the actual database for the manuals to make them more compatible, most probably not everything can be done as suggested in this case I will have to add a new column in the database for the configuration files descriptions.

QubinoHelp and others added 12 commits September 20, 2023 11:17
@zwave-js-bot zwave-js-bot enabled auto-merge (squash) September 20, 2023 09:29
@AlCalzone AlCalzone disabled auto-merge September 20, 2023 09:29
@AlCalzone
Copy link
Member

Whoops, commented on the wrong PR

@AlCalzone AlCalzone changed the title fix(config): fixing bot add Shelly Wave 1PM fix(config): clean up auto-import for Shelly Wave 1PM Sep 21, 2023
@AlCalzone
Copy link
Member

I just did the remaining changes.

@AlCalzone AlCalzone enabled auto-merge (squash) September 21, 2023 14:12
@AlCalzone AlCalzone merged commit d827296 into zwave-js:import-config-1694608670 Sep 21, 2023
14 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
config ⚙ Configuration issues or updates
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants