myStrom Button Max Tool beta User Guide

myStrom Button Max Tool beta

Product Information

The myStrom Button Max Tool is a Swiss innovation that allows you to customize the functionality of your myStrom Button Max. By installing the Button Max Custom Firmware, you can create personalized screens and define actions for your button. The tool is designed to simplify your smart home experience.

Specifications

• Tool Name : myStrom Button Max Tool (beta)
• Tool Version : Custom Firmware
• Supported Devices : myStrom Button Max

Usage Instructions

1. Step 1: Install Button Max Custom Firmware
   To begin using the myStrom Button Max Tool, you need to install the Button Max Custom Firmware on your device. You can download the firmware from the official myStrom website here. Follow the instructions provided by myStrom to install the firmware on your device.

2. Step 2: Connect myStrom Button Max Tool with a Button Max
   Make sure that both your myStrom Button Max Tool and your Button Max are connected to the same network as your PC/Mac. This is necessary for them to communicate with each other.

3. Step 3: Add your first screen
   To start customizing your myStrom Button Max, right-click on the tool interface to display further options. You can add screens and define their properties such as name, icon, and text. Screens can be part of a slideshow.

4. Step 4: Define an icon
   You can add icons to your screens by selecting the “Add an icon” option. Custom icons need to be 1-bit, black & white .bmp files. The file size and name conventions are as follows:

   • Small : 44 x 44 px, file name ends in -small
   • Medium : 132 x 132 px, file name ends in -medium
   • Large : 200 x 200 px, file name ends in -large
     You can find the custom icon folder where you store your icons by clicking on the “Show directory” option.

5. Step 5: Define an interaction
   For each screen, you can define an interaction that occurs when the myStrom Button Max is pressed. This can be done by selecting the desired action from the available options such as going to another screen or making an HTTP request.

6. Step 6: Define a Button action
   To define a Button action, choose the HTTP option from the available actions. This allows you to send an HTTP command when the myStrom Button Max is pressed.

7. Step 7: Choose an HTTP method
   Select the appropriate HTTP method for your command. The available options are GET and POST.

8. Step 8: Enter your command
   Enter the command that you want to execute when the myStrom Button Max is pressed. Depending on the device you are controlling, different commands may be required. You can find a list of commands for myStrom devices at api.mystrom.ch

9. Step 9: Sync your configuration
   To save your configuration and synchronize it with your myStrom Button Max, press CTRL-P / CMD-P or click on the sync button provided in the tool interface.

FAQ

Q: What are the requirements for custom icons?
A: Custom icons need to be 1-bit, black & white .bmp files.

The file size and name conventions are as follows

• Small : 44 x 44 px, file name ends in -small
• Medium : 132 x 132 px, file name ends in -medium
• Large: 200 x 200 px, file name ends in -large

Q: How can I find the custom icon folder?
A: You can find the custom icon folder by clicking on the “Show directory” option in the tool interface.

• Q: How do I sync my configuration with my myStrom Button Max?
  A: To save your configuration and synchronize it with your myStrom Button Max, press CTRL-P / CMD-P or click on the sync button provided in the tool interface.

• Q: Where can I find a list of commands for myStrom devices?
  A: You can find a complete list of commands for myStrom devices at api.mystrom.ch

myStrom Button Max Tool (beta)

Get myStrom Button Max Tool + Button Max Custom Firmware here https://mystrom.ch/de/support/mystrom-button-max-tool/

Install Button Max Custom Firmware

• Download the Firmware on https://mystrom.ch/de/support/mystrom-button-max-tool/
• Power Button Max
• If you haven’t done it already: Add Button Max to your WiFi via myStrom App, myStrom Troubleshooting Tool or its Web UI
• Access Button Max Web UI by entering its IP address in a web browser
• Select “Firmware Upgrade” in Burger Menu
• Select “Downloaded File“, select the Custom Firmware, start firmware upgrade
• Wait for Firmware upgrade to finish > Button Max reboots
• Button Max is now available in myStrom Button Max Tool
• Connect myStrom Button Max Tool with a Button Max. They have to be on the same network as your PC/Mac.
• Add your first screen.
• This displays the screen’s settings. Every screen has Content (graphics – icons and text) and Buttons (interactions).
• This displays the screen’s settings. Every screen has Content (graphics – icons and text) and Buttons (interactions).
• Add an icon.
• Show directory displays the custom icon folder where you store your custom icons.
• Now let’s define a Button action. Choose HTTP.
• Choose an HTTP method.
• This will make Button 1 toggle a myStrom WiFi Switch. List of commands at the end.
• Sync. Et voilà, your own custom Button Max.

Commands for myStrom devices

• Switches
  Use HTTP GET method. Replace the IP with the IP of your device.

• Toggle
  http://192.168.254.1/toggle

• Switch OFF
  http://192.168.254.1/relay?state=0

• Switch ON
  http://192.168.254.1/relay?state=1
  You can find a complete list of commands on api.mystrom.ch

• Bulbs & Strips
  Use HTTP POST method. Replace the IP with the IP of your device. Replace the MAC with the MAC of your device.

• URL
  http://192.168.254.1/api/v1/device/ag45h5h3

• PAYLOAD

  • color=00FF0000&action=on&ramp=100
  • color : WRGB value
  • action : on, off, toggle
  • ramp : transition time from one color to another

Have fun!

• mystrom.ch
• ©2023 myStrom AG | mystrom.ch

References

• myStrom
• myStrom.ch | Innovations For Your Home. Designed in Switzerland.
• Support | myStrom Button Max Tool (beta)

Read User Manual Online (PDF format)

Download This Manual (PDF format)

Download this manual  >>