Adds support for Byron SX Doorbells.
Byron SX series doorbells
Homey app to receive signals from Byron SX doorbell pushbuttons; and to send signal to Byron SX doorbell chimes.
These devices are supported:
Doorbell push buttons: * SX30 tested * SX32 * SX33 * SX35 * SX38 * SX39
Doorbell chimes: * SX1i * SX4i * SX5i * SX6 * SX7 * SX8i * SX11i * SX14 * SX15 * SX15i * SX21 * SX20 * SX34i * SX40i * SX41i * SX55 * SX56 * SX60i * SX72 * SX80 tested * SX81 * SX83 * SX86 * SX102 * SX120 * SX201 * SX202 * SX204 * SX205 * SX209 * SX210i * SX212i * SX220 * SX222 * SX225 * SX226 * SX228 * SX245 * SX252 * SX823
Depending on the model, the list of possible sounds is adjusted.
Please tell me when you have a Byron SX device that is not listed here. Please tell me when you have a Byron SX device that is properly working with Homey, but which is not yet marked as ‘tested’ here.
Install the app and add the App to a flow. You can use the generic Byron SX application as a starting trigger, or as an action in a flow. In that case you are required to manually fill in the bell-id that is used. Better, you can pair a Byron SX button and/or a Byron SX ringer and use these in a flow.
When the card is added to the condition column, it detects a Byron SX push button being pushed. 3 parameters are added to the trigger: * buttonId: Contains the internal ID of the button that is pushed. This is a number between 0 and 255. This number is assigned randomly to a push button once the battery is inserted. * melodyNr: Contains the melody number of the melody that was chosen. This is a number between 1 and 8. These are the numbers that are listed in the manual that comes with the device. Some bells only support 4 melodies. Some bells support only 1 melody or are mechanical bells. * melodyId: Contains the internal ID of the melody that was chosen. This is a number between 0 and 15. But only 8 specific values seem to in use. This number can be changed by pushing the small button that is inside the push button.
When the card is added to the action column, it is able to send a signal to a Byron SX bell. There are separate cards for each category of bell. There are 6 categories. A 7th card is available, which allows all 16 melody IDs. The hint icon shows the exact models that are supported by that card. But you can also pick the card that has the list of ringtones that matches your Byron SX bell. This card takes a few parameters: * buttonId: Contains the internal ID of the button that is recognized by the bell. This is a number between 0 and 255. Typically, this is the same number as is sent by the push button. * melodyNr: Contains the melody that should be played by the bell. You can select the melody from a dropdown list. When you select the proper card, the list of melodies should exactly match with what is possible. This parameter is not available for bells that have only one melody. * melodyId: Contains the melody that should be played by the bell. You can select the melody by its internal number. Not that the internal numbers are not equal to the sequence number suggested by the dropdown lists.
You may create more complicated scenarios where you let the Homey flow decide whether or not to send a command to the bell. First pair be bell so that it has a known internal ID. Then remove the batteries from the push button and reinsert them. This gives the push button a new random internal ID. Unless you are unlucky, the push button now has a different internal ID than the bell. You can use this to let your Homey decide whether the bell should indeed ring.
The Byron SX series push buttons and bells all use the same 433MHz-based protocol. It uses a simple message consisting of 8 bits for the push button identification and 4 bits for the melody identification. This would suggest 256 possible IDs and 16 possible ringtones. Depending on the models of your push button and bell, less combinations may be in use.
Discussion and issues
Please report issues via GitHub. For other remarks and/or questions mail firstname.lastname@example.org.
- 1.1.0 Added support for pairing the buttons and bells with Homey
- 1.0.0 First Athom App Store release candidate
Copyright (c) 2018 Erwin Dondorp
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.