Current File : //lib/python2.7/site-packages/salt/modules/sensehat.pyc
�
���^c @@ s d Z d d l m Z m Z m Z d d l Z y d d l m Z e Z Wn# e
e f k
rm d Z
e Z n Xe j e � Z d � Z d � Z d � Z d � Z d � Z e d
� Z d d d d d � Z d d d
� Z d � Z d d � Z d � Z d � Z d � Z d � Z d � Z d S( u
Module for controlling the LED matrix or reading environment data on the SenseHat of a Raspberry Pi.
.. versionadded:: 2017.7.0
:maintainer: Benedikt Werner <1benediktwerner@gmail.com>, Joachim Werner <joe@suse.com>
:maturity: new
:depends: sense_hat Python module
The rotation of the Pi can be specified in a pillar.
This is useful if the Pi is used upside down or sideways to correct the orientation of the image being shown.
Example:
.. code-block:: yaml
sensehat:
rotation: 90
i ( t absolute_importt unicode_literalst print_functionN( t SenseHatc C@ s~ t rt y
t � } Wn t k
r- t d f SXt d d d � } | d
k r` | j | t � n t j d | � t St d f S( u7
Only load the module if SenseHat is available
u? This module can only be used on a Raspberry Pi with a SenseHat.u
pillar.getu sensehat:rotationi iZ i� i u3 %s is not a valid rotation. Using default rotation.uW The SenseHat execution module cannot be loaded: 'sense_hat' python library unavailable.( i iZ i� i ( t
has_sense_hatR t OSErrort Falset __salt__t set_rotationt logt errort True( t _sensehatt rotation( ( s9 /usr/lib/python2.7/site-packages/salt/modules/sensehat.pyt __virtual__$ s
c C@ s t j | � i | d 6S( u�
Sets the entire LED matrix based on a list of 64 pixel values
pixels
A list of 64 ``[R, G, B]`` color values.
u pixels( R t
set_pixels( t pixels( ( s9 /usr/lib/python2.7/site-packages/salt/modules/sensehat.pyR 9 s
c C@ s
t j � S( u�
Returns a list of 64 smaller lists of ``[R, G, B]`` pixels representing the
the currently displayed image on the LED matrix.
.. note::
When using ``set_pixels`` the pixel values can sometimes change when
you read them again using ``get_pixels``. This is because we specify each
pixel element as 8 bit numbers (0 to 255) but when they're passed into the
Linux frame buffer for the LED matrix the numbers are bit shifted down
to fit into RGB 565. 5 bits for red, 6 bits for green and 5 bits for blue.
The loss of binary precision when performing this conversion
(3 bits lost for red, 2 for green and 3 for blue) accounts for the
discrepancies you see.
The ``get_pixels`` method provides an accurate representation of how the
pixels end up in frame buffer memory after you have called ``set_pixels``.
( R t
get_pixels( ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/sensehat.pyR D s c C@ s t j | | | � i | d 6S( u�
Sets a single pixel on the LED matrix to a specified color.
x
The x coordinate of the pixel. Ranges from 0 on the left to 7 on the right.
y
The y coordinate of the pixel. Ranges from 0 at the top to 7 at the bottom.
color
The new color of the pixel as a list of ``[R, G, B]`` values.
CLI Example:
.. code-block:: bash
salt 'raspberry' sensehat.set_pixel 0 0 '[255, 0, 0]'
u color( R t set_pixel( t xt yt color( ( s9 /usr/lib/python2.7/site-packages/salt/modules/sensehat.pyR Y s c C@ s t j | | � S( u4
Returns the color of a single pixel on the LED matrix.
x
The x coordinate of the pixel. Ranges from 0 on the left to 7 on the right.
y
The y coordinate of the pixel. Ranges from 0 at the top to 7 at the bottom.
.. note::
Please read the note for ``get_pixels``
( R t get_pixel( R R ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/sensehat.pyR n s c C@ s | t _ i | d 6S( u�
Sets the LED matrix to low light mode. Useful in a dark environment.
CLI Example:
.. code-block:: bash
salt 'raspberry' sensehat.low_light
salt 'raspberry' sensehat.low_light False
u low_light( R t low_light( R ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/sensehat.pyR } s g�������?c C@ s� | p d d d g } | p' d d d g } i d d d g d 6d d d g d 6d d d g d 6d d d g d 6} | | k r� | | } n t j | | | | � i | d 6S( ud
Displays a message on the LED matrix.
message
The message to display
msg_type
The type of the message. Changes the appearance of the message.
Available types are::
error: red text
warning: orange text
success: green text
info: blue text
scroll_speed
The speed at which the message moves over the LED matrix.
This value represents the time paused for between shifting the text
to the left by one column of pixels. Defaults to '0.1'.
text_color
The color in which the message is shown. Defaults to '[255, 255, 255]' (white).
back_color
The background color of the display. Defaults to '[0, 0, 0]' (black).
CLI Example:
.. code-block:: bash
salt 'raspberry' sensehat.show_message 'Status ok'
salt 'raspberry' sensehat.show_message 'Something went wrong' error
salt 'raspberry' sensehat.show_message 'Red' text_color='[255, 0, 0]'
salt 'raspberry' sensehat.show_message 'Hello world' None '[0, 0, 255]' '[255, 255, 0]' 0.2
i� i u errorid u warningu successu infou message( R t show_message( t messaget msg_typet
text_colort
back_colort scroll_speedt
color_by_type( ( s9 /usr/lib/python2.7/site-packages/salt/modules/sensehat.pyR � s #
c C@ sH | p d d d g } | p' d d d g } t j | | | � i | d 6S( u
Displays a single letter on the LED matrix.
letter
The letter to display
text_color
The color in which the letter is shown. Defaults to '[255, 255, 255]' (white).
back_color
The background color of the display. Defaults to '[0, 0, 0]' (black).
CLI Example:
.. code-block:: bash
salt 'raspberry' sensehat.show_letter O
salt 'raspberry' sensehat.show_letter X '[255, 0, 0]'
salt 'raspberry' sensehat.show_letter B '[0, 0, 255]' '[255, 255, 0]'
i� i u letter( R t show_letter( t letterR R ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/sensehat.pyR � s c C@ s
t j | � S( u�
Displays an 8 x 8 image on the LED matrix.
image
The path to the image to display. The image must be 8 x 8 pixels in size.
CLI Example:
.. code-block:: bash
salt 'raspberry' sensehat.show_image /tmp/my_image.png
( R t
load_image( t image( ( s9 /usr/lib/python2.7/site-packages/salt/modules/sensehat.pyt
show_image� s
c C@ s1 | d k r t j � n
t j | � i | d 6S( u�
Sets the LED matrix to a single color or turns all LEDs off.
CLI Example:
.. code-block:: bash
salt 'raspberry' sensehat.clear
salt 'raspberry' sensehat.clear '[255, 0, 0]'
u colorN( t NoneR t clear( R ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/sensehat.pyR% � s
c C@ s
t j � S( uK
Get the percentage of relative humidity from the humidity sensor.
( R t get_humidity( ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/sensehat.pyR& � s c C@ s
t j � S( uJ
Gets the current pressure in Millibars from the pressure sensor.
( R t get_pressure( ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/sensehat.pyR' s c C@ s
t j � S( u�
Gets the temperature in degrees Celsius from the humidity sensor.
Equivalent to calling ``get_temperature_from_humidity``.
If you get strange results try using ``get_temperature_from_pressure``.
( R t get_temperature( ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/sensehat.pyR(
s c C@ s
t j � S( uK
Gets the temperature in degrees Celsius from the humidity sensor.
( R t get_temperature_from_humidity( ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/sensehat.pyR) s c C@ s
t j � S( uK
Gets the temperature in degrees Celsius from the pressure sensor.
( R t get_temperature_from_pressure( ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/sensehat.pyR* s (! t __doc__t
__future__R R R t loggingt sense_hatR R R t ImportErrort NameErrorR$ R R t getLoggert __name__R R R R R R R R R R# R% R& R' R( R) R* ( ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/sensehat.pyt <module> s2
3
Mini Shell