Updating import statements¶

Previously, we recommended using one of the following as your import declaration:

import ev3dev.ev3 as ev3
import ev3dev.brickpi as ev3
import ev3dev.auto as ev3

We have re-arranged the library to provide more control over what gets imported. For all platforms, you will now import from individual modules for things like sensors and motors, like this:

from ev3dev2.motor import Motor, OUTPUT_A
from ev3dev2.sensor.lego import TouchSensor, UltrasonicSensor

The platform (EV3, BrickPi, etc.) will now be automatically determined.

You can omit import statements for modules you don’t need, and add any additional ones that you do require. With this style of import, members are globally available by their name, so you would now refer to the Motor class as simply Motor rather than ev3.Motor.

Remove references to connected attribute¶

In version 1 of the library, instantiating a device such as a motor or sensor would always succeed without an error. To see if the device connected successfully you would have to check the connected attribute. With the new version of the module, the constructor of device classes will throw an ev3dev2.DeviceNotConnected exception. You will need to remove any uses of the connected attribute.

Screen class has been renamed to Display¶

To match the name used by LEGO’s “EV3-G” graphical programming tools, we have renamed the Screen module to Display.

Reorganization of RemoteControl, BeaconSeeker and InfraredSensor¶

The RemoteControl and BeaconSeeker classes have been removed; you will now use InfraredSensor for all purposes.

Additionally, we have renamed many of the properties on the InfraredSensor class to make the meaning more obvious. Check out the InfraredSensor documentation for more info.

Re-designed Sound class¶

The names and interfaces of some of the Sound class methods have changed. Check out the Sound class docs for details.