Functions
	get_power_state ()

None	turn_off_lights ()

None	color_pos (int pos)

None	load_default_state ()

None	change_power_state (state)

Variables
Annotated	ENV_PATH

	dotenv_path

Annotated	WLED_HOST

Annotated	API = f"http://{WLED_HOST}/json"

Detailed Description

This module provides functions to interact with a WLED device via its JSON API.
It allows for turning off lights, setting colors at specific positions, loading default states,
changing power states, and retrieving the current power state of the WLED device.

Functions:
    turn_off_lights(): Sends a request to turn off the lights by setting the segment color to black.
    color_pos(pos): Sends a request to set the color of a specific position on a WLED device.
    load_default_state(): Sends a POST request to the WLED API to load the default state.
    change_power_state(state): Change the power state of the device.
    get_power_state(): Retrieves the power state of a WLED device.

Function Documentation

◆ change_power_state()

None wled_requests.change_power_state ( state )

Change the power state of the device.
Args:
    state (bool): The desired power state. True to turn on, False to turn off.
Returns:
    None

Definition at line 87 of file wled_requests.py.

def change_power_state(state) -> None:
    """
    Change the power state of the device.
    Args:
        state (bool): The desired power state. True to turn on, False to turn off.
    Returns:
        None
    """
    req = json.dumps({"on": state})
    requests.post(API, req, timeout=10)

◆ color_pos()

None wled_requests.color_pos ( int pos )

Sends a request to set the  color of a specific position on a WLED device.
Args:
    pos (int): The position to set the color for.
Returns:
    None

Definition at line 64 of file wled_requests.py.

def color_pos(pos: int) -> None:
    """
    Sends a request to set the  color of a specific position on a WLED device.
    Args:
        pos (int): The position to set the color for.
    Returns:
        None
    """
    req = json.dumps({"seg": {"i": [pos, "FF0000"]}})
    requests.post(API, req, timeout=10)
 
 

◆ get_power_state()

wled_requests.get_power_state ( )

Retrieves the power state of a WLED device.
Sends a GET request to the WLED device's JSON API endpoint to fetch the current state
Returns:
    bool: True if the WLED device is on, False otherwise. Returns None if the device is unreachable.

Definition at line 35 of file wled_requests.py.

def get_power_state():
    """
    Retrieves the power state of a WLED device.
    Sends a GET request to the WLED device's JSON API endpoint to fetch the current state
    Returns:
        bool: True if the WLED device is on, False otherwise. Returns None if the device is unreachable.
 
    """
    try:
        response = requests.get(f"http://{WLED_HOST}/json/state", timeout=3) # Timeout verkürzen
        response.raise_for_status()
        data = response.json()
        return data.get("on", False)
    except (requests.exceptions.RequestException, TimeoutError) as e:
        logger.error(f"WLED nicht erreichbar: {e}")
        return None
 

◆ load_default_state()

None wled_requests.load_default_state ( )

Sends a POST request to the WLED API to load the default state.
This function creates a JSON payload with a preset state identifier and sends it to the WLED API endpoint using a POST request.
Raises:
    requests.exceptions.RequestException: If there is an issue with the HTTP request.

Definition at line 76 of file wled_requests.py.

def load_default_state() -> None:
    """
    Sends a POST request to the WLED API to load the default state.
    This function creates a JSON payload with a preset state identifier and sends it to the WLED API endpoint using a POST request.
    Raises:
        requests.exceptions.RequestException: If there is an issue with the HTTP request.
    """
    req = json.dumps({"ps": 1})
    requests.post(API, req, timeout=10)
 
 

◆ turn_off_lights()

None wled_requests.turn_off_lights ( )

Sends a request to turn off the lights by setting the segment color to black.
This function creates a JSON payload to set the color of a segment of lights to black (hex code "000000")
and sends a POST request to the specified API endpoint to turn off the lights.
Raises:
    requests.exceptions.RequestException: If there is an issue with the HTTP request.

Definition at line 52 of file wled_requests.py.

def turn_off_lights() -> None:
    """
    Sends a request to turn off the lights by setting the segment color to black.
    This function creates a JSON payload to set the color of a segment of lights to black (hex code "000000")
    and sends a POST request to the specified API endpoint to turn off the lights.
    Raises:
        requests.exceptions.RequestException: If there is an issue with the HTTP request.
    """
    req = json.dumps({"seg": {"i": [0, 50, "000000"]}})
    requests.post(API, req, timeout=10)
 
 

Variable Documentation

◆ API

Annotated wled_requests.API = f"http://{WLED_HOST}/json"

Definition at line 33 of file wled_requests.py.

◆ dotenv_path

wled_requests.dotenv_path

Definition at line 26 of file wled_requests.py.

◆ ENV_PATH

Annotated wled_requests.ENV_PATH

Initial value:

=  os.path.join(
    os.path.dirname(__file__), "data/.env"
)

Definition at line 23 of file wled_requests.py.

◆ WLED_HOST

Annotated wled_requests.WLED_HOST