Skip to content

MSpa Binding ​

Connect your MSpa Pools with openHAB if you have them connected to your MSpa-Link IOS or Android app.

Check which account type fits best to connect your pool:

  • one owner-account: you registered one account with MSpa-Link app. This will steal your token and you're not able to operate openHAB and Smartphone MSpa-Link app in parallel.
  • two owner-account: you need to register two accounts with different email addresses to avoid stealing token - one used for Smartphone app and one for openHAB.
  • visitor-account: allow pool access with QR code provided by MSpa-Link app.

Supported Things ​

  • owner-account: Bridge connecting to your account with email and password credentials
  • visitor-account: Bridge connecting to your account with grantCode credentials
  • pool: Pool connected to your account

Discovery ​

Bridge owner-account or visitor-account needs to be setup manually with your credentials. Your pool is automatically detected after the bridge goes ONLINE. There's no automatic background scan. If you connect a new pool afterwards start discovery manually.

Thing Configuration ​

owner-account Bridge Configuration ​

NameTypeDescriptionDefaultRequired
emailtextEmail address of your accountN/Ayes
passwordtextPassword to access your accountN/Ayes
regiontextRegion where your country is locatedROWyes

Region options

  • ROW: Rest of world
  • US: United States
  • CH: China

visitor-account Bridge Configuration ​

NameTypeDescriptionDefaultRequired
visitorIdtextRandom 16 digit id with lower case hex charactersN/Ano/yes
grantCodetextGrant from QR code presented by MSpa-Link appN/Ayes
regiontextRegion where your country is locatedROWyes

The visitorId is generated if you create the first time a visitor-account via openHAB UI so it's not mandatory. Once generated don't lose it e.g. when deleting the account Thing because all grants are bound to this visitorId! If you use textual configuration you need to generate your own visitorId as 16 digit hex lower case characters.

The grantCode is a QR code provided by MSpa-Link app. On your main screen click on the gear top left, Devices and then share the spa which presents you a QR code. Scan it with a third party QR app and put the displayed String into the grantCode section and save configuration immediately. This grantCode is valid for a limited time to grant access.

Region options

  • ROW: Rest of world
  • US: United States
  • CH: China

pool Thing Configuration ​

NameTypeDescriptionDefaultRequiredAdvanced
deviceIdtextIdentification number of your deviceN/Ayesno
productIdtextProduct Id of your deviceN/Ayesno
refreshIntervalintegerRefresh interval in minutes15yesyes

The configuration parameters deviceId and productId cannot be determined manually in beforehand. They are detected after successful bridge creation or after granting access.

The refreshInterval minimum possible value is 5 minutes.

Channels ​

Channels for pool

ChannelTypeRead/WriteDescription
heaterSwitchRWControl water heating
temperatureNumber:TemperatureRCurrent water temperature
target-temperatureNumber:TemperatureRWTarget water temperature
jet-streamSwitchRWControl jet stream for massage
bubblesSwitchRWSwitch bubbles on/off
bubble-levelNumberRWIntensity of bubbles
circulationSwitchRWWater circulation for filtering
uvcSwitchRWEliminate germs with Ultraviolet-C water cleaning
ozoneSwitchRWDisinfect with Ozone water cleaning
lockSwitchRWLock physical panel for inputs
faultStringRFault code reported by the device

bubble-level options

  • 1 for Low
  • 2 for Medium
  • 3 for High

fault reports the device's fault code as-is (e.g. F1). It does not affect Thing status - the device stays ONLINE while a fault is reported. When no fault is set, the channel reports NONE. The device's warning field is deliberately not reflected here, since it is also set during normal operation and is not a reliable fault indicator.

fault known codes

CodeMeaning
F0 / E0Low ambient temperature
F1 / E1Water flow failure
F2 / E2Water level too low
F3 / E3Heater system failure
F4 / E4Temperature sensor fault
F5 / E5High limit overheating
CEFControl panel signal error
BBFBubble blower failure

Any other code is displayed as-is; the mapping above is used by the UI to show a readable label.

Full Example ​

demo.things Example ​

dsl
Bridge mspa:owner-account:4711  "MSpa Account"      [ email="YOUR_MAIL_ADDRESS", password="YOUR_PASSWORD", region="ROW"] {
         Thing pool 4712        "MSpa Pool OSLO"    [ deviceId="YOUR_DEVICE_ID", productId="YOUR_PRODUCT_ID"]
}

demo.items Example ​

dsl
Switch                  MSPA_OSLO_Heater                    {channel="mspa:pool:4711:4712:heater" }
Number:Temperature      MSPA_OSLO_Water_Temperature         {channel="mspa:pool:4711:4712:temperature" }
Number:Temperature      MSPA_OSLO_Target_Water_Temperature  {channel="mspa:pool:4711:4712:target-temperature" }
Switch                  MSPA_OSLO_Jet_Stream                {channel="mspa:pool:4711:4712:jet-stream" }
Switch                  MSPA_OSLO_Bubbles                   {channel="mspa:pool:4711:4712:bubbles" }
Number                  MSPA_OSLO_Bubble_Level              {channel="mspa:pool:4711:4712:bubble-level" }
Switch                  MSPA_OSLO_Circulation               {channel="mspa:pool:4711:4712:circulation" }
Switch                  MSPA_OSLO_UVC                       {channel="mspa:pool:4711:4712:uvc" }
Switch                  MSPA_OSLO_Ozone                     {channel="mspa:pool:4711:4712:ozone" }
Switch                  MSPA_OSLO_Lock                      {channel="mspa:pool:4711:4712:lock" }
String                  MSPA_OSLO_Fault                     {channel="mspa:pool:4711:4712:fault" }