B.10 HWSUPP - Conseil pour les développeurs de paquetage

Dans ce chapitre nous vous proposont une description pour ajouter une LED ou un bouton pour les développeurs qui veulent créer un paquetage^B.1.

B.10.1 Extension pour LED

B.10.1.1 Type de LED

Dans le fichier check/myopt.exp vous configurez une liste de plusieurs types de LEDs que vous pouvez indiquer dans la variable HWSUPP_LED_x.

Exemple :

+HWSUPP_LED_TYPE(OPT_MYOPT) = 'myopt' 
                            : ', myopt'

B.10.1.2 Contrôle de paramètre

Dans le fichier check/myopt.ext vous configurez les paramètres qui seront vérifiés, vous pouvez les indiquer dans la variable HWSUPP_LED_x_PARAM.

Exemple :

if (opt_hwsupp)
then
    depends on hwsupp version 4.0

    foreach i in hwsupp_led_n
    do
        set action=hwsupp_led_%[i]
        set param=hwsupp_led_%_param[i]
        if (action == "myopt")
        then
            if (!(param =~ "(RE:MYOPT_LED_PARAM)"))
            then
                error "When HWSUPP_LED_\${i}='myopt', ...
                       must be entered in HWSUPP_LED_\${i}_PARAM" 
            fi
        fi
    done
fi

B.10.1.3 affichage de la LED

Quand vous définissez une LED dans le script pour un paquetage (par ex. /usr/bin/<opt>_setled) la requête /usr/bin/hwsupp_setled <LED> <status>/ sera exécutée.

Le nombre de LED peut être lu dans le fichier /var/run/hwsupp.conf>.

L'état de la LED peut être off, on ou blink.

Exemple :

if [ -f /var/run/hwsupp.conf ]
then
    . /var/run/hwsupp.conf
    [ 0$hwsupp_led_n -eq 0 ] || for i in `seq 1 $hwsupp_led_n`
    do
        eval action=\$hwsupp_led_${i}
        eval param=\$hwsupp_led_${i}_param
        if [ "$action" = "<opt>" ]
        then
            if [ <myexpression> ]
            then
                /usr/bin/hwsupp_setled $i on
            else
                /usr/bin/hwsupp_setled $i off
            fi
        fi
    done
fi

L'état actuel d'une LED peut être demandé avec la requête /usr/bin/hwsupp_getled <LED>/. Le résultat sera off, on ou blink.

B.10.2 Extension pour le bouton

B.10.3 Action du bouton

Dans le fichier check/myopt.exp vous configurez une liste de plusieurs types de boutons que vous pouvez indiquer dans la variable HWSUPP_BUTTON_x.

Exemple :

+HWSUPP_BUTTON_TYPE(OPT_MYOPT) = 'myopt' 
                               : ', myopt'

B.10.3.1 Contrôle de paramètre

Dans le fichier check/myopt.ext vous configurez les paramètres qui seront vérifiés, vous pouvez les indiquer dans la variable HWSUPP_BUTTON_x_PARAM.

Exemple :

if (opt_hwsupp)
then
    depends on hwsupp version 4.0

    foreach i in hwsupp_button_n
    do
        set action=hwsupp_buttonn_%[i]
        set param=hwsupp_button_%_param[i]
        if (action == "myopt")
        then
            add_to_opt "files/usr/bin/myopt_keyprog" "mode=555 flags=sh"
            if (!(param =~ "(RE:MYOPT_BUTTON_PARAM)"))
            then
                error "When HWSUPP_BUTTON_\${i}='myopt', ...
                       must be entered in  HWSUPP_BUTTON_\${i}_PARAM" 
            fi
        fi
    done
fi

B.10.3.2 Fonction du bouton

Quand un bouton est pressé, le fichier script /usr/bin/myopt_keyprog sera exécuté.

La valeur de la variable HWSUPP_BUTTON_x_PARAM est transmis.

Exemple :

##TODO## exemple