pybricks.common.DCMotor: Finalize settings method.

Also add test for this setting.

Fixes pybricks/support#536

Author: laurensvalk

CHANGELOG.md

@@ -4,6 +4,9 @@
 
 ## [Unreleased]
 
+### Changed
+- Renamed new `DCMotor.dc_settings()` method to `DCMotor.settings()`.
+
 ## [3.1.0c1] - 2021-11-19
 
 ### Added

pybricks/common/pb_type_dcmotor.c

@@ -159,7 +159,7 @@ STATIC const mp_rom_map_elem_t common_DCMotor_locals_dict_table[] = {
     { MP_ROM_QSTR(MP_QSTR_dc), MP_ROM_PTR(&common_DCMotor_duty_obj) },
     { MP_ROM_QSTR(MP_QSTR_stop), MP_ROM_PTR(&common_DCMotor_stop_obj) },
     { MP_ROM_QSTR(MP_QSTR_brake), MP_ROM_PTR(&common_DCMotor_brake_obj) },
-    { MP_ROM_QSTR(MP_QSTR_dc_settings), MP_ROM_PTR(&common_DCMotor_dc_settings_obj) },
+    { MP_ROM_QSTR(MP_QSTR_settings), MP_ROM_PTR(&common_DCMotor_dc_settings_obj) },
 };
 MP_DEFINE_CONST_DICT(common_DCMotor_locals_dict, common_DCMotor_locals_dict_table);
 

pybricks/common/pb_type_motor.c

@@ -326,7 +326,7 @@ STATIC const mp_rom_map_elem_t common_Motor_locals_dict_table[] = {
     { MP_ROM_QSTR(MP_QSTR_dc), MP_ROM_PTR(&common_DCMotor_duty_obj) },
     { MP_ROM_QSTR(MP_QSTR_stop), MP_ROM_PTR(&common_DCMotor_stop_obj) },
     { MP_ROM_QSTR(MP_QSTR_brake), MP_ROM_PTR(&common_DCMotor_brake_obj) },
-    { MP_ROM_QSTR(MP_QSTR_dc_settings), MP_ROM_PTR(&common_DCMotor_dc_settings_obj) },
+    { MP_ROM_QSTR(MP_QSTR_settings), MP_ROM_PTR(&common_DCMotor_dc_settings_obj) },
     //
     // Methods specific to encoded motors
     //

tests/pup/motors/dcmotor.py

@@ -28,3 +28,10 @@
 motor.dc(100)
 wait(1000)
 motor.stop()
+wait(1000)
+
+# Run with voltage limit.
+motor.settings(max_voltage=5000)
+motor.dc(100)
+wait(1000)
+motor.stop()