• 

  Leslie Community moderator

  • December 11, 2025 09:56

  Hello,

  I don't have the product in my installation, so I can't test. But according to the documentation it should be “target_orientation_float". I invite you to test : 

   

  JSON endpoints - setstate

  With set status we can control the shutter

  • Up / Down the shutter

  • Stop the shutter

  • Go to a position

   

   

   

  JSON keys	Authorized values	action
  “target_position": 30	100	Up
  	0	Down
  	-1	Stop
  	X % (1 → 99)	Go to X
  “target_orientation_float": 90.00	X	Change the slats orientation

   

  Have a good day,

  Leslie - Community Manager

  0
• 

  Omero

  • December 11, 2025 10:05

  Hi Leslie,

  Thanks for the informations. Do you think it will possible with the netamto API? Because I dont see this info about “target_orientation_float" on the following documentation: Netatmo Connect | Legrand API Documentation

  In which documentation can you actually find this detailed information?

  Because my goal is to be able to use the slat orientation inside Home Assistant using the Netatmo integration.

  Thank you very much for your help.

  0
• 

  Leslie Community moderator

  • December 11, 2025 13:50

  Hi again,

  Indeed, it's not documented on the developer portal (surely by mistake). I found it in our internal documentation. But I'm pretty sure that this parameter is available in the 3rd party API

  Concerning HA and the Netatmo integration, I'm not sure if they have integrated or no this feature as it's not documented. The best is to ask it directly to the HA community

  Have a good day,

  Leslie - Community Manager

  0
• 

  Omero

  • December 11, 2025 15:20

  Hi Leslie,

  Alright, I will check with the HA Community on Github concerning the Netatmo integration.

  Would you mind sharing the internal documentation in order to help the developers work on that?

  Thanks a lot.

  0
• 

  Leslie Community moderator

  • December 11, 2025 15:45

  Here is what I have regarding endpoints/parameters opened for 3rd party users : 

   

  How to interpret the position

  target_position / current_position	physical position
  100	open
  0	close

   

   

   

  target_orientation / current_orientation_float	physical position
  0.00°	The slats BSO are horizontally (open)
  90.00°	The slats pointing upwards (closed)

   

   

   

  For magellan products the step is 22.50° with 5 values possibles

  • 0.00°

  • 22.50°

  • 45.00°

  • 67.50°

  • 90.00°

  The magellan gateway supports two digit after the comma

   

  JSON endpoint homestatus

  With /homestatus we can get information about the shutter

  • The current position of the shutter

  • If the shutter is moving

  • The step of the shutter

  • if it is controllable with level

   

  JSON keys	Authorized values	Type	Comments

   

  JSON keys	Authorized values	Type	Comments
  “target_position": 30	0 → 100	INT	Represent the destination of the shutter, the last order.
  "target_position:step": 1,	1, 2, 4, 5, 10	INT	The step of the shutter 100: No level X: With level
  “current_position": 30	0 → 100	INT	represent the current position of the shutter. If the target_position != current_position, the shutter is moving.
  “target_orientation_float": 90.00	0.00° → 90.00°	FLOAT	Represent the destination of the BSO slats, the last order.
  “target_orientation_float:step": 22.50	0.00° → 180.00°	FLOAT	The step of the BSO, with 22.50 we have 5 possibles position values with this step: 0.00, 22.50, 45.00, 67.50, 90.00
  “target_orientation_float:min": 0	0° OR -90°	INT	The represents the orientation min. 0°: Magellan -90°: Velux and MX
  “target_orientation_float:max": 90	90°	INT	The represents the orientation max.
  “current_orientation_float": 0.00	0.00° → 90.00°	FLOAT	represent the current position of the slats. If the target_orientation != current_orientation, the slats are moving.

   

  Control the tilt and / or lift on a specific device, POST /setstate example

  { "home": { "modules": [ { "target_position": 0~100, "target_orientation_float": 0~90, "id": "XX:XX:XX:XX:XX:XX:XX:XX" } ] } }

   

   

  Have a good day,

  Leslie - Community Manager

  0
• 

  Omero

  • December 11, 2025 15:49

  Hi Leslie,

  That's really great information!

  Thanks a lot for your help and responsiveness!

  Have a nice day

  0

Please sign in to leave a comment.