fanshim python

Ventilador de la cuña para Raspberry Pi

Instalación

Biblioteca estable de Pypi:

• Simplemente ejecute sudo pip install fanshim

Última/biblioteca de desarrollo de Github:

• apt install git python3-pip
• git clone https://github.com/pimoroni/fanshim-python
• cd fanshim-python
• sudo ./install.sh

Referencia

Primero debe configurar una instancia de la clase FANShim , por ejemplo:

 from fanshim import FanShim
fanshim = FanShim ()

Admirador

Enciende el ventilador con:

 fanshim . set_fan ( True )

Apagarlo con:

 fanshim . set_fan ( False )

También puedes alternar el ventilador con:

 fanshim . toggle_fan ()

Puede verificar el estado del ventilador con:

 fanshim . get_fan () # returns 1 for 'on', 0 for 'off' 

CONDUJO

Fan Shim incluye un LED RGB APA-102.

Establecer en cualquier color con:

 fanshim . set_light ( r , g , b )

Los argumentos R, G y B deben ser números entre 0 y 255 que describen el color que desea.

Por ejemplo, rojo completo:

 fanshim.set_light(255, 0, 0)

Botón

Fan Shim incluye un botón, puede vincular acciones para presionar, lanzar y mantener presionados eventos.

Haga algo cuando se presione el botón:

 @ fanshim . on_press ()
def button_pressed ():
    print ( "The button has been pressed!" )

O cuando se ha lanzado:

 @ fanshim . on_release ()
def button_released ( was_held ):
    print ( "The button has been pressed!" )

O cuando se ha presionado lo suficiente como para activar una retención:

 fanshim . set_hold_time ( 2.0 )

@ fanshim . on_hold ()
def button_held ():
    print ( "The button was held for 2 seconds" )

La función que se une a on_release() se pasa como un parámetro was_held , esto le permite saber si el botón se mantuvo presionado por más tiempo que el tiempo de retención configurado. Si desea unir una acción para "presionarse" y otra para "mantener", debe verificar este indicador y realizar su acción en el controlador on_release() :

 @ fanshim . on_release ()
def button_released ( was_held ):
    if was_held :
        print ( "Long press!" )
    else :
        print ( "Short press!" )

Para configurar la cantidad de tiempo que se debe mantener el botón (en segundos), use:

 fanshim . set_hold_time ( number_of_seconds )

Si necesita evitar que la cuña del ventilador vaya al botón, use:

 fanshim . stop_polling ()

Puedes comenzar de nuevo con:

 fanshim . start_polling ()

Software alternativo

• Fan Shim in C, usando WiringPi - https://github.com/flobernd/raspi-fanshim
• Fan Shim en C ++, usando libgpiod - https://github.com/daviehh/fanshim-cpp