Starting with Tasmota version 6.5, devices can be configured by users using a Template.

These are intended to be an easy way for users to create and share configurations for devices that are unsupported in Tasmota but have common characteristics with existing modules. We encourage everyone who creates a template for a new unknown device to add it to the database with an image of the device, links to the manufacturer or where it can be found and, of course, the template for it.

To provide easy processing by Tasmota, a user template is written as a JSON text and could look like this:

{"NAME":"UserModule1","GPIO":[17,148,29,149,7,255,255,255,138,255,139,255,255],"FLAG":0,"BASE":18}

More about template properties at the bottom of the article.

Go to Configuration - Configure Template ...

... and you'll end up looking at this screen.

Time to create your template.

1. Change the template name (also defines the name for Module 0).
2. Select a module to BASE your template on. If you're not sure, Module 18 is the best choice. In this example the device is based on Blitzwolf SHP (45) module.
3. Configure the GPIOs to match your device. If you do not know what pins your device uses, employ the new device configuration procedure to determine the correct pin assignments.

Explanation of ADC0

4. Click on Save.

5. Select Module 0 in Configuration - Configure Module.

In the example dropdown menu you see the template name that is defined in step 1 (in this case RGB Smart Plug) always followed by (0).

After clicking Save, your device will reboot with the new settings.

Now that you've set up your previously unsupported device in Tasmota it is time to share the knowledge:

1. Check that Module 0 is selected in the Configuration - Configure Module menu.
2. Open up Console and issue command Template which will output a string with the configuration of your currently active template. Our example gives the following:

MQT: stat/sonoff/RESULT = {"NAME":"RGB Smart Plug","GPIO":[37,0,39,0,38,134,0,0,131,17,132,21,0],"FLAG":0,"BASE":45}

Copy the string {"NAME":"RGB Smart Plug","GPIO":[37,0,39,0,38,134,0,0,131,17,132,21,0],"FLAG":0,"BASE":45} and share it on our device repository page.

You can set up your device in module Configuration - Configure Module and use command Template 255 to merge the settings from Configure Module with current template into a new Template named "Merged".

Go to Configuration - Configure Other

When there:

1. Paste your template into the Template field
2. Make sure you check Activate
3. Click on Save.

The device will reboot with a name reflecting your template name and Module 0 selected which has your new template stored.

A user provided template can be stored in Sonoff-Tasmota using the Template command. It has the following parameters.

Template {"NAME":"UserModule1","GPIO":[17,148,29,149,7,255,255,255,138,255,139,255,255],"FLAG":0,"BASE":18} stores a complete template based on the Generic module

Template {"NAME":"AnotherModuleName"} updates the name of a stored template

Template {"FLAG":1} updates the flag of a stored template

Template {"BASE":0} updates the base of a stored template to Generic

After setting a template in command line it is necessary to issue Module 0 command if the device doesn't reboot on its own.

Let's look again at our example template

{"NAME":"UserModule1","GPIO":[17,148,29,149,7,255,255,255,138,255,139,255,255],"FLAG":0,"BASE":18}

The four properties with UPPERCASE property names have the following functionality:

GPIO# |00| 01|02| 03|04| 05| 09| 10| 12| 13| 14| 15| 16|  
CODE  [17,148,29,149,52,255,255,255,138,255,139,255,255] 

The GPIO functionality numbers are the same as shown by command GPIOs. In addition code 255 is added to select a GPIO as user configurable via the GUI Configure Module menu.

example

In our example GPIO00 has the number 17 which corresponds to Button1 according to the following table. If you change that to 9 in your template it would then become a Switch1.

Google Sheet with the GPIOS sorted by number or alphabetically.

The FLAG value is an 8-bit mask where each bit controls a feature. Add FLAG values to set multiple bits.

BASE is the starting module setup for the custom template. Some modules, not all, include special programming. If your device is similar to an existing built-in module it is best to use that as a starting point. When you're not sure which BASE module is suitable for your device use the Generic (18) module.

example

In the RGB Smart Plug template we used the BlitzWolf SHP (45) module as BASE since the power monitoring circuitry is identical but GPIO00, GPIO02 were changed and an unused GPIO04 was added to enable the RGB LED function. Using that specific module we took advantage of that module's calibrated power monitoring special programming which the Generic (18) module does not use.

The following table lists hard-coded device specific functionality.