fanshim python

مروحة شيم للتوت بي

التثبيت

مكتبة مستقرة من PYPI:

• فقط قم بتشغيل sudo pip install fanshim

آخر مكتبة/تطوير من جيثب:

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

مرجع

يجب عليك أولاً إعداد مثيل لفئة FANShim ، على سبيل المثال:

 from fanshim import FanShim
fanshim = FanShim ()

معجب

قم بتشغيل المروحة مع:

 fanshim . set_fan ( True )

أطفئه مع:

 fanshim . set_fan ( False )

يمكنك أيضًا تبديل المروحة بـ:

 fanshim . toggle_fan ()

يمكنك التحقق من حالة المروحة مع:

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

قاد

تشمل Fan Shim واحد RGB APA-102 LED.

اضبطه على أي لون مع:

 fanshim . set_light ( r , g , b )

يجب أن تكون الحجج R و G و B أرقامًا بين 0 و 255 التي تصف اللون الذي تريده.

على سبيل المثال ، أحمر كامل:

 fanshim.set_light(255, 0, 0)

زر

يتضمن Fan Shim زرًا ، يمكنك ربط الإجراءات للضغط على الأحداث والإصدار والاحتفاظ بها.

افعل شيئًا عند الضغط على الزر:

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

أو عندما تم إصداره:

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

أو عندما يتم الضغط عليه لفترة طويلة بما يكفي لإعطاء:

 fanshim . set_hold_time ( 2.0 )

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

يتم تمرير الوظيفة التي ترتبط بها on_release() معلمة was_held ، وهذا يتيح لك معرفة ما إذا كان الزر قد تم تعليقه لفترة أطول من وقت الانتظار الذي تم تكوينه. إذا كنت ترغب في ربط إجراء بـ "الضغط" وآخر "للاحتفاظ" ، فيجب عليك التحقق من هذا العلامة وأداء الإجراء الخاص بك في معالج on_release() :

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

لتكوين مقدار الوقت الذي يجب أن يتم فيه عقد الزر (بالثواني) ، استخدم:

 fanshim . set_hold_time ( number_of_seconds )

إذا كنت بحاجة إلى إيقاف مروحة Shim من استطلاع الزر ، فاستخدم:

 fanshim . stop_polling ()

يمكنك البدء مرة أخرى مع:

 fanshim . start_polling ()

برنامج بديل

• مروحة Shim في C ، باستخدام TiringPI - https://github.com/flobernd/raspi-fanshim
• Fan Shim in C ++ ، باستخدام libgpiod - https://github.com/daviehh/fanshim-cpp