19_ProTouch Simulator Plugins_EN

Plugins installation

Plugins are located in (surprise) “plugins” folder next to ProTouchSimulator executable. Plugin contains lib.dll(or .so) and resources.rcc in its folder(and probable some other files, but these 2 are core).

Example layout:

- ProTouchApiSimulator.exe
- plugins
-- PluginName1
--- lib.dll
--- resources.rcc
(...) other PluginName1's files
-- PluginName2
--- lib.dll
--- resources.rcc
(...) other PluginName2's files

If plugin has been put correctly in plugins folder, then it will be available on top bar, ex:

Plugins uses connection established in ProTouch API tab, so make sure to be connected to ProTouch before sending messages in plugin.

Plugins requires simulator that supports at least ProTouch API V2 (at least 8ef8c4b revision).

Scenario Plugin

Scenario plugin can be used to create repeatable scenarios over ProTouch Api. It can be also used for testing purposes, since you can build messages here freely. For example, it can be used for testing inclination by interleaving METER_COUNTER_STATUS_IND and INCLINATION_VALUE_STATUS_IND.

By default there are 3 messages with meter counter(with ProTouch Api V2 layout):

General schema is Record<string, Message>, where key is stringified integer which represents time to be send after clicking “Start Scenario” in milliseconds. So in example above there will be sent meter counter value of 1m, 2m and 3m in 1s, 2s and 3s.

Progress bar on top will show progress of given scenario and it will be ended when Start Scenario becomes available again.

Plugin is uploaded here as Scenario.zip for Windows and Scenario.tar.xz for Linux.