HAA V12 Merlin has some breaking changes from v11 Peregrine. These changes are mainly about GPIO definitions, meaning that scripts must be adapted to be compatible with new version.

Before, GPIOs configurations were taken directly from different parts of the script. Configurations about INPUT, OUTPUT, OPENDRAIN, PULL-UP, PWM, initial state, etc. Now, there is an unique section to do this, avoiding duplicity and confusions.

Since v12, GPIO declarations must be in an array "io":[...] into configuration "c":{...} section.

See GPIOs Configuration details.

Declarations of type "r":[{...}] into actions, that set a GPIO LOW or HIGH, to activate a relay, or a LED, for example, uses GPIO that must be declared into "io":[...] as Output. Same for status LED declared with "l": key and IR LED declared with "t": key in configuration section.

"r":[{"g":12}] will need the following declaration into "io":

"io":[
  [ [ 12 ], 2 ]
]

"r":[{"g":12},{"g":13,"v":1}] will need the following declaration into "io". Note that GPIOs 12 and 13 has same configuration:

"io":[
  [ [ 12, 13 ], 2 ]
]

"r":[{"g":5,"n":1}] and other action with "r":[{"g":4,"v":1}] will need the following declaration into "io".

"n":1 used to set GPIO 5 to HIGH must be removed, because initial state now is declared in "io":

"io":[
  [ [ 5 ], 2, 0, 1 ],
  [ [ 4 ], 2 ]
]

"l":13 status LED declaration will need the following declaration into "io":

"io":[
  [ [ 13 ], 3 ]
]

"t":16 IR LED declaration will need the following declaration into "io":

"io":[
  [ [ 16 ], 2 ]
]

Arrays of types "b":[...], "f[n]":[...] and "g[n]":[...] used to declare buttons, switches, binary sensors... have removed some options that now must be declared into "io": array.

Removed options from "b":[...], "f[n]":[...] and "g[n]":[...]:

These options must be removed, and set them into "io": array with type 6.

"b":[{"g":0,"t":5}] will need the following declaration into "io":

"io":[
  [ [ 0 ], 6, 1 ]
]

"b":[{"g":5,"p":0},{"g":5,"t":0}] will be "b":[{"g":5},{"g":5,"t":0}] ("p":0 is removed), and needs the following declaration into "io":

"io":[
  [ [ 5 ], 6 ]
]

"f4":[{"g":5,"p":0,"i":1}] will be "f4":[{"g":5}] ("p":0 and "i":1 are removed), and needs the following declaration into "io":

"io":[
  [ [ 5 ], 6, 0, 1 ]
]

"b":[{"g":3,"f":10}] will be "b":[{"g":3}] ("f":10 is removed), and needs the following declaration into "io":

"io":[
  [ [ 3 ], 6, 1, 0, 10 ]
]

"b":[{"g":13,"p":0},{"g":13,"t":0}] and "b":[{"g":5,"p":0},{"g":5,"t":0}] will be "b":[{"g":13},{"g":13,"t":0}] and "b":[{"g":5},{"g":5,"t":0}] ("p":0 is removed), and needs the following declaration into "io":

"io":[
  [ [ 5, 13 ], 6 ]
]

Lightbulb service using PWM has move these GPIOs options to "io":[...] array:

• Normal or open-drain output.
• Direct or inverted output.
• Dithering.
• Trailing or leading.

Then, "ld": and "di": must be removed from Lightbulb service because they are useless, and include their declarations into "io": array.

And most important, GPIOs into "g":[...] array must be declared into "io": array as PWM type.

Example 1:

"g":[15,13,12] will need the following declaration into "io":

"io":[
  [ [ 15, 13, 12 ], 7 ]
]

Example 2:

"g":[15,13,12,4],"ld":[0,1,0,1] will be only "g":[15,13,12,4] ("ld":[0,1,0,1] is removed), and needs the following declaration into "io":

"io":[
  [ [ 15, 12 ], 7,
  [ [ 13, 4 ], 7, 0, 0, 2 ]
]

Lightbulb Service using NRZ protocol uses a GPIO declared in "g":[...] array. This GPIO must be declared as output into "io":[...] array.

A Lightbulb Service {"t":30,"ty":8,"g":[5,1,6]} needs the following declaration into "io", declaring GPIO 5 as output:

"io":[
  [ [ 5 ], 2 ]
]

Some Services use special drivers with GPIO, and now they need to declare them into "io":[...] array.

"dt" : [ CF, CF1, Sel ]: Power Measure service with "n":1 or "n":2 needs to declare used CF and CF1 GPIOs as Input into "io":[...] array, and Sel GPIO as Output. See GPIOs Configuration

For example:

"dt" : [ 12, 13, 15 ] will need:

"io":[
  [ [ 12, 13 ], 1 ],
  [ [ 15 ], 2 ]
]

GPIOs from "g" : [ GPIO, Type, Pull-up, Trigger GPIO ] must be declared into "io":array.

Because Pull-up is declared into "io" array, it must be removed from "g":[...] array from Free Monitor, because in v12, declaration is "g" : [ GPIO, Type, Trigger GPIO ].

GPIO must be Input. If Pull-up is missing or 0, remove it from following declaration: [ [ GPIO ], 1, Pull-up ]

Trigger GPIO must be Output: [ [ Trigger GPIO ], 2 ]

For example:

"g" : [ 12, 1, 1, 16 ] will be "g" : [ 12, 1, 16 ], and needs:

"io":[
  [ [ 12 ], 1, 1],
  [ [ 16 ], 2 ]
]

In V12 Merlin, there are more log types to allow use of ESP32 UART2. Then, some old log types have a different value that must be modified as follow:

If UART logs are enabled in configuration section, like "o":1, in V12 Merlin it is needed to activate UART explicitly with an UART declaration.

A "c":{"o":1, ...} setting will be:

"c":{"o":1, "r":[{"n":0}], ...}

A "c":{"o":2, ...} setting will be:

"c":{"o":2, "r":[{"n":1}], ...}

Free Monitor Service using UART Receiver must activate receiver mode in UART configuration.

To activate UART receiver mode, simply change UART number "n": from "r":[{...}] UART configuration array according to this table:

If "ul:[min,Max] is used, remove it, and declare it into UART declaration with "l": key.

"c":{"ul":[15,20],"r":[{"n":0,"s":9600}]} will be:

"c":{"r":[{"n":10,"s":9600,"l":[15,20]}]}