legoEv3/ev3dev2/sensor/__pycache__/__init__.cpython-35.pyc
[+ @ s d d l Z e j d k r' e d d d l Z d d l m Z d d l m Z d d l m Z m
Z
m Z e Z e d k r d d l
m Z m Z m Z m Z ne d
k r d d l m Z m Z m Z m Z n e d k r d d l m Z m Z m Z m Z n e d k r<d d l m Z m Z m Z m Z nr e d
k rmd d l m Z m Z m Z m Z nA e d k rd d l m Z m Z m Z m Z n e d e Gd d d e
Z e j d d Z Gd d d e Z d S) N z"Must be using Python 3.4 or higher)abspath)unpack)get_current_platformDevicelist_device_namesZev3)INPUT_1INPUT_2INPUT_3INPUT_4ZevbZpistormsZbrickpiZbrickpi3ZfakezUnsupported platform '%s'c s e Z d Z d Z d Z d Z d d d d d d d
d d d
d d d d g Z d e d f d d Z d d Z e d d Z
e d d Z e j d d Z e d d Z
e d d Z e d! d" Z e d# d$ Z e j d% d$ Z e d& d' Z e d( d) Z e d* d+ Z d, d- d. Z e d/ d0 Z d d1 d2 Z d3 d4 Z S)5Sensorzp
The sensor class provides a uniform interface for using most of the
sensors available for the EV3.
z lego-sensorzsensor*_address_command _commands _decimals _driver_name_mode_modes _num_values_units_value_bin_data_format_bin_data_size _bin_data _mode_scaleNFc s | d k r | | d <t t | j | j | | | d | _ d | _ d | _ d | _ d | _ d | _ d | _
d | _ d | _ d d d d d d d d g | _
d | _ d | _ d | _ i | _ d S)Naddress)superr
__init__SYSTEM_CLASS_NAMEr r r r r r r r r r r r r r )selfr name_pattern
name_exactkwargs) __class__ 9/usr/lib/python3/dist-packages/ev3dev2/sensor/__init__.pyr W s"
" ! zSensor.__init__c C s> | | j k r | j | } n d | j } | | j | <| S)zG
Returns value scaling coefficient for the given mode.
)r decimals)r modeZscaler% r% r& _scalem s
z
Sensor._scalec C s" | j | j d \ | _ } | S)z
Returns the name of the port that the sensor is connected to, e.g. `ev3:in1`.
I2C sensors also include the I2C address (decimal), e.g. `ev3:in1:i2c8`.
r )get_attr_stringr )r valuer% r% r& r y s zSensor.addressc C s t d d S)z0
Sends a command to the sensor.
z!command is a write-only property!N) Exception)r r% r% r& command s zSensor.commandc C s | j | j d | | _ d S)Nr. )set_attr_stringr )r r, r% r% r& r. s c C s" | j | j d \ | _ } | S)z
Returns a list of the valid commands for the sensor.
Returns -EOPNOTSUPP if no commands are supported.
commands) get_attr_setr )r r, r% r% r& r0 s zSensor.commandsc C s" | j | j d \ | _ } | S)z
Returns the number of decimal places for the values in the `value<N>`
attributes of the current mode.
r( ) get_attr_intr )r r, r% r% r& r( s zSensor.decimalsc C s" | j | j d \ | _ } | S)z
Returns the name of the sensor device/driver. See the list of [supported
sensors] for a complete list of drivers.
driver_name)r+ r )r r, r% r% r& r3 s zSensor.driver_namec C s" | j | j d \ | _ } | S)z
Returns the current mode. Writing one of the values returned by `modes`
sets the sensor to that mode.
r) )r+ r )r r, r% r% r& r) s z Sensor.modec C s | j | j d | | _ d S)Nr) )r/ r )r r, r% r% r& r) s c C s" | j | j d \ | _ } | S)zC
Returns a list of the valid modes for the sensor.
modes)r1 r )r r, r% r% r& r4 s z Sensor.modesc C s" | j | j d \ | _ } | S)zz
Returns the number of `value<N>` attributes that will return a valid value
for the current mode.
num_values)r2 r )r r, r% r% r& r5 s zSensor.num_valuesc C s" | j | j d \ | _ } | S)zo
Returns the units of the measured value for the current mode. May return
empty string
units)r+ r )r r, r% r% r& r6 s z Sensor.unitsr c C s@ t | } | j | j | d t | \ | j | <} | S)a.
Returns the value or values measured by the sensor. Check num_values to
see how many values there are. Values with N >= num_values will return
an error. The values are fixed point numbers, so check decimals to see
if you need to divide to get the actual value.
r, )intr2 r str)r nr, r% r% r& r, s 0z Sensor.valuec C s" | j | j d \ | _ } | S)a
Returns the format of the values in `bin_data` for the current mode.
Possible values are:
- `u8`: Unsigned 8-bit integer (byte)
- `s8`: Signed 8-bit integer (sbyte)
- `u16`: Unsigned 16-bit integer (ushort)
- `s16`: Signed 16-bit integer (short)
- `s16_be`: Signed 16-bit integer, big endian
- `s32`: Signed 32-bit integer (int)
- `float`: IEEE 754 32-bit floating point (float)
bin_data_format)r+ r )r r, r% r% r& r: s zSensor.bin_data_formatc C s | j d k rX d d d d d d d d d d d d
d d
i j | j d | j | _ d | j k ry | j d | _ | j j d
t | j j | j } | d k r | St | | S)a
Returns the unscaled raw values in the `value<N>` attributes as raw byte
array. Use `bin_data_format`, `num_values` and the individual sensor
documentation to determine how to interpret the data.
Use `fmt` to unpack the raw bytes into a struct.
Example::
>>> from ev3dev2.sensor.lego import InfraredSensor
>>> ir = InfraredSensor()
>>> ir.value()
28
>>> ir.bin_data('<b')
(28,)
Nu8 Zs8u16 Zs16Zs16_beZs32r floatbin_datar )
r getr: r5 r Z_attribute_file_openseek bytearrayreadr )r Zfmtrawr% r% r& r@ s zSensor.bin_datac C s | j | k r | | _ d S)N)r) )r r) r% r% r& _ensure_mode s zSensor._ensure_mode)__name__
__module__ __qualname____doc__r SYSTEM_DEVICE_NAME_CONVENTION __slots__r r* propertyr r. setterr0 r( r3 r) r4 r5 r6 r, r: r@ rF r% r% )r$ r& r
> sD 'r
c K s7 t t j d t j } d d t | | | D S)a
This is a generator function that enumerates all sensors that match the
provided arguments.
Parameters:
name_pattern: pattern that device name should match.
For example, 'sensor*'. Default value: '*'.
keyword arguments: used for matching the corresponding device
attributes. For example, driver_name='lego-ev3-touch', or
address=['in1', 'in3']. When argument value is a list,
then a match against any entry of the list is enough.
/c s s$ | ] } t d | d d Vq d S)r! r" TN)r
).0namer% r% r& <genexpr>% s z list_sensors.<locals>.<genexpr>)r r ZDEVICE_ROOT_PATHr
r r )r! r# Z
class_pathr% r% r& list_sensors s
rS c sy e Z d Z d Z e j Z d Z d e d f d d Z e d d Z e d d
Z
e
j d d
Z
S) I2cSensorz>
A generic interface to control I2C-type EV3 sensors.
zsensor*NFc s> t t | j | | | d d g | d | _ d | _ d S)Nr3 znxt-i2c-sensor)r rT r _fw_version_poll_ms)r r r! r" r# )r$ r% r& r 1 s ( zI2cSensor.__init__c C s" | j | j d \ | _ } | S)z
Returns the firmware version of the sensor if available. Currently only
I2C/NXT sensors support this.
fw_version)r+ rU )r r, r% r% r& rW 6 s zI2cSensor.fw_versionc C s" | j | j d \ | _ } | S)aI
Returns the polling period of the sensor in milliseconds. Writing sets the
polling period. Setting to 0 disables polling. Minimum value is hard
coded as 50 msec. Returns -EOPNOTSUPP if changing polling is not supported.
Currently only I2C/NXT sensors support changing the polling period.
poll_ms)r2 rV )r r, r% r% r& rX ? s zI2cSensor.poll_msc C s | j | j d | | _ d S)NrX )Z set_attr_intrV )r r, r% r% r& rX J s ) rG rH rI rJ r
r rK r rM rW rX rN r% r% )r$ r& rT ) s rT )r r ) sys version_info SystemErrorZnumbersos.pathr Zstructr Zev3dev2r r r platformZev3dev2._platform.ev3r r
r r Zev3dev2._platform.evbZev3dev2._platform.pistormsZev3dev2._platform.brickpiZev3dev2._platform.brickpi3Zev3dev2._platform.faker- r
rK rS rT r% r% r% r& <module> s. % % % % % %