[Mincka]

Add Sauter Smart Control realm (Server.SAUTER)

Why

Sauter Smart Control (the connected-appliance app for Sauter ovens, by Groupe
Brandt / Modulotech) runs on the same Overkiz backend and the same
smartcontrol-app.com cookie‑session middleware as Brandt Smart Control — but it
authenticates against a different partner/realm: sauter-electromenager
(Brandt uses brandt-electromenager).

Because of that, a Sauter account currently cannot be used: the Brandt flow returns
BrandtBadCredentialsError ("Password wrong password"), since the middleware session
login (POST /api/v1/sessions.json) is sent with the wrong partner. This is the
missing piece from #1202.

What

Adds first-class support so Sauter connected appliances (e.g. the SOP6615LB oven,
an Overkiz OGP gateway) can authenticate and be controlled:

• enums.Server.SAUTER
• const: SAUTER_PARTNER = "sauter-electromenager" and a Server.SAUTER
ServerConfig (endpoint https://ha3-1.overkiz.com/enduser-mobile-web/enduserAPI/,
  same host as Brandt)
• auth: BrandtAuthStrategy gains a partner class attribute (default
  BRANDT_PARTNER, so Brandt behaviour is unchanged); SauterAuthStrategy
  subclasses it with SAUTER_PARTNER; the factory wires Server.SAUTER
• tests mirroring the Brandt ones (constants + server entry, factory wiring, and the
  middleware login asserting partner=sauter-electromenager)

The only functional difference from Brandt is the partner value; everything else
(JWT fetch via the session cookie, then the Overkiz login with the jwt) is reused.

Testing

• ruff clean on the changed lines; full test suite green (513 passed, 2 skipped),
  including the 3 new Sauter tests.
• Verified end-to-end against a live Sauter account and a real SOP6615LB oven:
  Server.SAUTER logs in, lists the gateway + oven, reads states, and executes
  commands (e.g. stop).

Notes

• Server.SAUTER_COZYTOUCH (ha110-1) already exists but targets the Sauter heating /
  Cozytouch realm — this is the distinct Smart Control appliance realm (ha3-1).
• Context: the Sauter Smart Control app has been removed from the stores; this lets
  existing owners keep using their appliances via this library / Home Assistant.

Refs: #1202

[iMicknl]

Thanks for your contribution! Have you verified that this works for your account?

And are you planning to use this via the python-overkiz-api, or via Home Assistant? We don't support ovens there yet afaik.

[Mincka]

Hello,

Yes, tested on my own account. The only difference with Brandt is the partner field (sauter-electromenager), the rest of the flow is identical with Server.SAUTER login works, I get the gateway + the oven, and commands go through:

Server.SAUTER -> https://ha3-1.overkiz.com/enduser-mobile-web/enduserAPI/
LOGIN OK

GATEWAYS (1)
- id=XXXX-XXXX-XXXX  updateStatus=UP_TO_DATE  connectivity=OK  alive=True

DEVICES (2)
- 'Brandt_OGP_Gateway_HF005' [ogp:Gateway]  ogp://XXXX-XXXX-XXXX/16000210
- 'Four BNT8256'             [ogp:Oven]      ogp://XXXX-XXXX-XXXX/16000211

stop -> COMPLETED

On the HA side: that's the end goal, but I saw #177263 (climate for ogp:Oven) got closed after the author went inactive. You'd asked there for the full oven diagnostics. I have a real Sauter oven, so here's the structure from the live API:

ogp:Oven (uiClass: Oven)
Commands: activateOption(1), deactivateOption(1), identify(0), sendPrivate(1), setMode(1),
          setName(1), setRecipe(1), setTargetTemperature(1), setTargetTime(1),
          setTargetWeight(1), setTimezone(1), start(0), stop(0)
States:
- core:TargetTemperatureState = 180.0  (LowerBound 35.0 / UpperBound 250.0 / Recommended 180.0)
- core:TargetTemperatureReachedState = False
- core:ModeState = fanCooking
- core:AvailableModesState = [defrost, bottomHeat, bottomFan, conventional, conventionalFan,
    fannedGrill, keepingWarm, fanCooking, combinedHeat, bread, drying, pizza, eco, auto]
- core:RecipeState = custom
- core:AvailableRecipesState = [pizza, rareBeef, mediumRareBeef, wellDoneBeef, rareLamb,
    wellDoneLamb, pork, chicken, fish, vegetables, saltTart, sweetTart, cake, cookies, souffle]
- core:TargetWeightState = 0 ; core:TargetTimeState = 1800 ; core:RemainingTimeState = 1800
- core:RunningTimerState = False
- core:AvailableOptionsState = [remotedGuide, booster, demo] ; core:ActivatedOptionsState = []
- core:CycleStageSequenceState = [cooking, end] ; core:CurrentCycleStageState = end
- core:StartedStoppedState = stopped  (started/stopped)
- core:OpenClosedState = closed  (open/closed) ; core:LockedUnlockedState = unlocked  (locked/unlocked)
- core:IntensityState = 0 ; core:LightIntensityState = 0
- core:ErrorState = {"key":"internal","message":"NO_ERROR"}
- core:TimezoneState = Europe/Paris ; core:FirmwareRevisionState = 326
- ogp:UnavailableFeaturesState = [{"feature":"*","commands":["*"],
    "states":["recipe","intensity","targetWeight"],"cause":"localControl"}]

ogp:Gateway (uiClass: ProtocolGateway)
Commands: identify(0), reboot(0), sendPrivate(1), setName(1), update(0)
States: Availability, Status, SignalQuality, FirmwareRevision=4.13, ActivePartition, NewFirmwareAvailable

[iMicknl]

Thanks, and nice that you tested it on a real oven!

One thing outside the diff: add a Sauter Smart Control row to the supported hubs table in README.md and docs/index.md.

[iMicknl]

Thanks!

[Mincka]

Thanks a lot for merging this, @iMicknl, and for getting it into 2.3.0 so fast.

While I was at it I looked at exposing the oven itself in the HA integration and found #177263 (climate support for ogp:Oven). It went stale, and I saw your steer that an oven most likely can't be a climate entity, with the number/select/button approach from home-assistant/core#173326 being the way to go.

I'd be glad to pick that up and see it through review. I also have full diagnostics for a Sauter ogp:Oven (the structure you asked the previous author for): 13 commands, ~37 states, AvailableModes/AvailableRecipes, etc. Happy to post a redacted dump.

How would you recommend approaching it?

Thanks again!

[iMicknl]

@Mincka are you willing to create a PR on core with the required changes for your device? I won't be able to prioritize this and it is hard for me to build this without testing.

[Mincka]

I can give it a shot but I wanted your advice on the approach.
Should I propose something similar to home-assistant/core#173413 ?
I don't think the approach with the Climate entity from home-assistant/core#177263 makes sense IMHO.

[iMicknl]

Yes, take home-assistant/core#173326 (review) as guidance. Using the climate entity for ovens won't be accepted in core.