Bonus configuration parameter #6109

fabnavigator · 2023-08-01T16:08:39Z

fabnavigator
Aug 1, 2023

I've been working on adding some new configuration parameters to the Minoston / Mini Plug with Power Meter (MP21ZP / MP31ZP) driver. I'm testing with three devices, all with different firmware versions (1.10.1, 1.11.1, and 1.20.1). Everything looks good so far, except I see an extra configuration parameter (LED Indicator Brightness) assigned to the device on 1.10.1. I don't know where it is coming from. Any thoughts?

Driver:

{
	"manufacturer": "Minoston",
	"manufacturerId": "0x0312",
	"label": "MP21ZP / MP31ZP",
	"description": "Mini Plug with Power Meter",
	"devices": [
		{
			"productType": "0xff00",
			"productId": "0xff0e",
			"zwaveAllianceId": 4247
		}
	],
	"firmwareVersion": {
		"min": "0.0",
		"max": "255.255"
	},
	"paramInformation": [
		{
			"#": "1",
			"$import": "templates/minoston_template.json#led_indicator_four_options_inverted"
		},
		{
			"#": "9",
			"$if": "firmwareVersion >= 1.11.1",
			"$import": "templates/minoston_template.json#led_indicator_brightness"
		},
		{
			"#": "2",
			"$import": "templates/minoston_template.json#auto_off_timer"
		},
		{
			"#": "3",
			"$import": "templates/minoston_template.json#auto_on_timer"
		},
		{
			"#": "4",
			"$import": "~/templates/master_template.json#state_after_power_failure_prev_off_on"
		},
		{
			"#": "10",
			"$if": "firmwareVersion >= 1.11.1",
			"$import": "templates/minoston_template.json#power_reporting"
		},
		{
			"#": "5",
			"$import": "templates/minoston_template.json#power_reporting_threshold"
		},
		{
			"#": "6",
			"$import": "templates/minoston_template.json#power_reporting_interval"
		},
		{
			"#": "11",
			"$if": "firmwareVersion >= 1.11.1",
			"$import": "templates/minoston_template.json#current_reporting"
		},
		{
			"#": "7",
			"$import": "templates/minoston_template.json#current_reporting_threshold"
		},
		{
			"#": "12",
			"$if": "firmwareVersion >= 1.11.1",
			"$import": "templates/minoston_template.json#current_reporting_interval"
		},
		{
			"#": "8",
			"$import": "templates/minoston_template.json#energy_reporting_threshold"
		},
		{
			"#": "13",
			"$if": "firmwareVersion >= 1.11.1",
			"$import": "templates/minoston_template.json#voltage_reporting_interval"
		}
    ],
	"metadata": {
		"inclusion": "ADD or Remove the MP21ZP from the existing Z-Wave home control network with your primary controller.\n---Refer to your primary controller instructions to process the inclusion / exclusion setup procedure.\n---When prompted by your primary controller, click the PROG button Three times in one second.\nInclude MP21ZP to/from a Z-Wave Gateway with supporting Security.The MP21ZP can support the Primary Controller that implemented the\nNotice: Including a node ID allocated by Z-WaveTM Controller means “Add” or “Inclusion”. Excluding a node ID allocated by\nZ-WaveTM Controller means “Remove” or “Exclusion”",
		"exclusion": "ADD or Remove the MP21ZP from the existing Z-Wave home control network with your primary controller.\n---Refer to your primary controller instructions to process the inclusion / exclusion setup procedure.\n---When prompted by your primary controller, click the PROG button Three times in one second.\nInclude MP21ZP to/from a Z-Wave Gateway with supporting Security.The MP21ZP can support the Primary Controller that implemented the\nNotice: Including a node ID allocated by Z-WaveTM Controller means “Add” or “Inclusion”. Excluding a node ID allocated by\nZ-WaveTM Controller means “Remove” or “Exclusion”",
		"reset": "Press the button twice quickly and then press and hold the button 10S.device will reset\n(Node:Please use this procedure only when the network primary controller is missing or otherwise inoperable)",
		"manual": "https://products.z-wavealliance.org/ProductManual/File?folder=&filename=product_documents/4247/MP21ZP-manual-20210722.pdf"
	}
}

Template:

{
	"base_led_color": {
		"valueSize": 1,
		"minValue": 0,
		"maxValue": 6,
		"defaultValue": 1,
		"unsigned": true,
		"allowManualEntry": false,
		"options": [
			{
				"label": "White",
				"value": 0
			},
			{
				"label": "Blue",
				"value": 1
			},
			{
				"label": "Green",
				"value": 2
			},
			{
				"label": "Red",
				"value": 3
			},
			{
				"label": "Magenta",
				"value": 4
			},
			{
				"label": "Yellow",
				"value": 5
			},
			{
				"label": "Cyan",
				"value": 6
			}
		]
	},
	"base_led_color_mr40z": {
		"valueSize": 1,
		"minValue": 0,
		"maxValue": 6,
		"defaultValue": 0,
		"unsigned": true,
		"allowManualEntry": false,
		"options": [
			{
				"label": "White",
				"value": 0
			},
			{
				"label": "Purple",
				"value": 1
			},
			{
				"label": "Orange",
				"value": 2
			},
			{
				"label": "Cyan",
				"value": 3
			},
			{
				"label": "Red",
				"value": 4
			},
			{
				"label": "Green",
				"value": 5
			},
			{
				"label": "Blue",
				"value": 6
			}
		]
	},
	"auto_off_timer": {
		"$import": "~/templates/master_template.json#base_0-65535",
		"label": "Auto-Off Timer",
		"unit": "minutes",
		"options": [
			{
				"label": "Disable",
				"value": 0
			}
		]
	},
	"auto_on_timer": {
		"$import": "~/templates/master_template.json#base_0-65535",
		"label": "Auto-On Timer",
		"unit": "minutes",
		"options": [
			{
				"label": "Disable",
				"value": 0
			}
		]
	},
	"auto_off_timer_36000s": {
		"$import": "#auto_off_timer",
		"valueSize": 2,
		"unit": "seconds",
		"minValue": 0,
		"maxValue": 36000
	},
	"auto_off_timer_32767s": {
		"$import": "#auto_off_timer",
		"valueSize": 2,
		"unit": "seconds",
		"minValue": 0,
		"maxValue": 32767
	},
	"single_tap_function": {
		"label": "Single Tap Function",
		"valueSize": 1,
		"minValue": 0,
		"maxValue": 3,
		"defaultValue": 0,
		"unsigned": true,
		"allowManualEntry": false,
		"options": [
			{
				"label": "Last brightness level",
				"value": 0
			},
			{
				"label": "Value set in parameter 18",
				"value": 1
			},
			{
				"label": "Maximum brightness set in parameter 11",
				"value": 2
			},
			{
				"label": "Full brightness",
				"value": 3
			}
		]
	},
	"double_tap_function": {
		"label": "Double Tap Function",
		"valueSize": 1,
		"minValue": 0,
		"maxValue": 3,
		"defaultValue": 0,
		"unsigned": true,
		"allowManualEntry": false,
		"options": [
			{
				"label": "Full brightness",
				"value": 0
			},
			{
				"label": "Value set in parameter 18",
				"value": 1
			},
			{
				"label": "Maximum brightness set in parameter 11",
				"value": 2
			},
			{
				"label": "Disable",
				"value": 3
			}
		]
	},
	"association_reports_basic_binary": {
		"$import": "~/templates/master_template.json#base_options_nounit",
		"label": "Association Reports",
		"defaultValue": 1,
		"options": [
			{
				"label": "Binary Switch report (Z-Wave); Basic Set report (local control)",
				"value": 0
			},
			{
				"label": "Binary Switch report (all)",
				"value": 1
			}
		]
	},
	"association_reports_basic_multilevel": {
		"label": "Association Reports",
		"valueSize": 1,
		"minValue": 0,
		"maxValue": 2,
		"defaultValue": 2,
		"unsigned": true,
		"allowManualEntry": false,
		"options": [
			{
				"label": "Basic report (short/long press, with relay enabled); MultiLevel (Z-Wave); Multilevel, each level (long press with relay disabled)",
				"value": 0
			},
			{
				"label": "Basic report (local control); MultiLevel (Z-Wave)",
				"value": 1
			},
			{
				"label": "MultiLevel reports (all); Each level (long press, with relay disabled)",
				"value": 2
			}
		]
	},
	"report_state_when_local_control_disabled": {
		"$import": "~/templates/master_template.json#base_enable_disable",
		"label": "Suppress State Reporting When Local Control is Disabled"
	},
	"led_indicator_four_options_inverted": {
		"label": "LED Indicator",
		"valueSize": 1,
		"minValue": 0,
		"maxValue": 3,
		"defaultValue": 0,
		"unsigned": true,
		"allowManualEntry": false,
		"options": [
			{
				"label": "On when load is on",
				"value": 0
			},
			{
				"label": "On when load is off",
				"value": 1
			},
			{
				"label": "LED always off",
				"value": 2
			},
			{
				"label": "LED always on",
				"value": 3
			}
		]
	},
	"led_indicator_color": {
		"label": "LED Indicator: Color",
		"valueSize": 1,
		"minValue": 0,
		"maxValue": 3,
		"defaultValue": 1,
		"unsigned": true,
		"allowManualEntry": false,
		"options": [
			{
				"label": "White",
				"value": 0
			},
			{
				"label": "Blue",
				"value": 1
			},
			{
				"label": "Green",
				"value": 2
			},
			{
				"label": "Red",
				"value": 3
			}
		]
	},
	"led_indicator_color_upper": {
		"$import": "#base_led_color",
		"label": "LED Indicator: Upper Paddle Color"
	},
	"led_indicator_color_lower": {
		"$import": "#base_led_color",
		"label": "LED Indicator: Lower Paddle Color"
	},
	"led_indicator_color_first_button": {
		"$import": "#base_led_color_mr40z",
		"default": 0,
		"label": "LED Indicator: First Button"
	},
	"led_indicator_color_second_button": {
		"$import": "#base_led_color_mr40z",
		"default": 1,
		"label": "LED Indicator: Second Button"
	},
	"led_indicator_color_third_button": {
		"$import": "#base_led_color_mr40z",
		"default": 2,
		"label": "LED Indicator: Third Button"
	},
	"led_indicator_color_fourth_button": {
		"$import": "#base_led_color_mr40z",
		"default": 3,
		"label": "LED Indicator: Fourth Button"
	},
	"led_indicator_brightness": {
		"label": "LED Indicator: Brightness",
		"valueSize": 1,
		"minValue": 0,
		"maxValue": 2,
		"defaultValue": 1,
		"unsigned": true,
		"allowManualEntry": false,
		"options": [
			{
				"label": "High",
				"value": 0
			},
			{
				"label": "Medium",
				"value": 1
			},
			{
				"label": "Low",
				"value": 2
			}
		]
	},
	"led_indicator_brightness_mr40z": {
		"label": "LED Indicator: Brightness",
		"valueSize": 1,
		"minValue": 0,
		"maxValue": 10,
		"defaultValue": 5,
		"unsigned": true,
		"allowManualEntry": false,
		"options": [
			{
				"label": "Off",
				"value": 0
			},
			{
				"label": "10%",
				"value": 1
			},
			{
				"label": "20%",
				"value": 2
			},
			{
				"label": "30%",
				"value": 3
			},
			{
				"label": "40%",
				"value": 4
			},
			{
				"label": "50%",
				"value": 5
			},
			{
				"label": "60%",
				"value": 6
			},
			{
				"label": "70%",
				"value": 7
			},
			{
				"label": "80%",
				"value": 8
			},
			{
				"label": "90%",
				"value": 9
			},
			{
				"label": "100%",
				"value": 10
			}
		]
	},
	"night_mode_brightness": {
		"label": "Night Mode Brightness Level",
		"description": "Sets the dim level the device will turn on to when the button is held for two seconds",
		"valueSize": 1,
		"minValue": 0,
		"maxValue": 99,
		"defaultValue": 20,
		"unsigned": true
	},
	"external_switch_type_two_options": {
		"label": "External Switch Type",
		"valueSize": 1,
		"minValue": 0,
		"maxValue": 1,
		"defaultValue": 0,
		"unsigned": true,
		"allowManualEntry": false,
		"options": [
			{
				"label": "Toggle switch",
				"value": 0
			},
			{
				"label": "Momentary switch",
				"value": 1
			}
		]
	},
	"external_switch_type_four_options": {
		"label": "External Switch Type",
		"valueSize": 1,
		"minValue": 0,
		"maxValue": 3,
		"defaultValue": 0,
		"unsigned": true,
		"allowManualEntry": false,
		"options": [
			{
				"label": "Toggle switch",
				"value": 0
			},
			{
				"label": "Toggle switch - 2x (as set in parameter 12); 3x (dim in loop)",
				"value": 1
			},
			{
				"label": "Momentary switch - 2x (as set in parameter 12); Hold (dim in loop)",
				"value": 2
			},
			{
				"label": "Momentary switch - 2x (as set in parameter 12); Hold (dim in loop, but dim down only after double tap to full brightness)",
				"value": 3
			}
		]
	},
	"status_change_report_local_control": {
		"$import": "~/templates/master_template.json#base_enable_disable",
		"label": "Send Status Change Report: Local Control",
		"defaultValue": 1
	},
	"status_change_report_three_way": {
		"$import": "~/templates/master_template.json#base_enable_disable",
		"label": "Send Status Change Report: 3-Way",
		"defaultValue": 1
	},
	"status_change_report_zwave": {
		"$import": "~/templates/master_template.json#base_enable_disable",
		"label": "Send Status Change Report: Z-Wave",
		"defaultValue": 1
	},
	"status_change_report_timer": {
		"$import": "~/templates/master_template.json#base_enable_disable",
		"label": "Send Status Change Report: Timer",
		"defaultValue": 1
	},
	"power_reporting_threshold": {
		"label": "Power Reporting Threshold",
		"valueSize": 1,
		"unit": "W",
		"minValue": 5,
		"maxValue": 50,
		"defaultValue": 5
	},
	"power_reporting_interval": {
		"label": "Power Reporting Interval",
		"valueSize": 4,
		"unit": "minutes",
		"minValue": 1,
		"maxValue": 65535,
		"defaultValue": 5,
		"unsigned": true
	},
	"current_reporting_threshold": {
		"label": "Current Reporting Threshold",
		"valueSize": 1,
		"unit": "0.1 A",
		"minValue": 1,
		"maxValue": 10,
		"defaultValue": 1,
		"unsigned": true
	},
	"energy_reporting_threshold": {
		"label": "Energy Reporting Threshold",
		"valueSize": 1,
		"unit": "0.01 kWh",
		"minValue": 1,
		"maxValue": 100,
		"defaultValue": 1,
		"unsigned": true
	},
	"enable_local_control": {
		"$import": "~/templates/master_template.json#base_enable_disable",
		"label": "Local Control",
		"defaultValue": 1
	},
	"battery_report_threshold": {
		"label": "Battery Report Threshold",
		"valueSize": 1,
		"unit": "%",
		"minValue": 1,
		"maxValue": 20,
		"defaultValue": 10,
		"unsigned": true
	},
	"battery_alarm_report": {
		"label": "Low Battery Alarm Threshold",
		"valueSize": 1,
		"unit": "%",
		"minValue": 5,
		"maxValue": 20,
		"defaultValue": 5,
		"unsigned": true
	},
    "power_reporting": {
		"label": "Power Reporting",
		"valueSize": 1,
		"minValue": 0,
		"maxValue": 1,
		"defaultValue": 0,
		"unsigned": true,
        "allowManualEntry": false,
		"options": [
			{
				"label": "Enabled",
				"value": 0
			},
			{
				"label": "Disabled",
				"value": 1
			}
		]
    },
    "current_reporting": {
        "label": "Current Reporting",
		"valueSize": 1,
		"minValue": 0,
		"maxValue": 1,
		"defaultValue": 0,
		"unsigned": true,
        "allowManualEntry": false,
		"options": [
			{
				"label": "Enabled",
				"value": 0
			},
			{
				"label": "Disabled",
				"value": 1
			}
		]
    },
	"current_reporting_interval": {
		"label": "Current Reporting Interval",
		"valueSize": 4,
		"unit": "minutes",
		"minValue": 1,
		"maxValue": 65535,
		"defaultValue": 60,
		"unsigned": true
    },
	"voltage_reporting_interval": {
		"label": "Voltage Reporting Interval",
		"valueSize": 4,
		"unit": "minutes",
		"minValue": 1,
		"maxValue": 65535,
		"defaultValue": 60,
		"unsigned": true
    }
}

Answered by fabnavigator

Aug 2, 2023

Duplicate of #6097.

View full answer

kpine · 2023-08-01T17:28:57Z

kpine
Aug 1, 2023

Upgrade to Z-Wave JS 11.6.0 or later and re-interview the devices.

You can see the latest device config at https://devices.zwave-js.io/?jumpTo=0x0312:0xff00:0xff0e:0.0#. You'll notice there's no longer a parameter 9. Re-interviewing will correct the config parameters to match the device config.

If you click on "Edit File", then "Nothing more than a text editor" it will take you the the latest version of the file in GitHub. If you examine the file history, you'll see that last week PR #6056 updated the device config files for this device and others.

2 replies

fabnavigator Aug 1, 2023
Author

The changes I'm working on are additions to the current version of the file. The vendor added 5 parameters 9 - 13 for firmware version 1.11.1 that need to be supported. I've reinterviewed the device, and there is still a bogus parameter.

kpine Aug 1, 2023

Understood. The old file did not have those parameters, so I was mistaken anyways.

fabnavigator · 2023-08-02T11:13:55Z

fabnavigator
Aug 2, 2023
Author

Duplicate of #6097.

0 replies

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Bonus configuration parameter #6109

{{title}}

Replies: 2 comments 2 replies

{{title}}

{{title}}

{{title}}

{{editor}}'s edit

{{editor}}'s edit

{{title}}

{{editor}}'s edit

{{editor}}'s edit

Select a reply

Bonus configuration parameter #6109

fabnavigator Aug 1, 2023

Replies: 2 comments · 2 replies

kpine Aug 1, 2023

fabnavigator Aug 1, 2023 Author

kpine Aug 1, 2023

fabnavigator Aug 2, 2023 Author

fabnavigator
Aug 1, 2023

Replies: 2 comments 2 replies

kpine
Aug 1, 2023

fabnavigator Aug 1, 2023
Author

fabnavigator
Aug 2, 2023
Author