mirror of
https://github.com/pybricks/pybricks-api.git
synced 2026-07-27 19:57:02 +00:00
176 lines
4.5 KiB
ReStructuredText
176 lines
4.5 KiB
ReStructuredText
.. pybricks-requirements:: movehub
|
|
|
|
Move Hub
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
.. _fig_movehub:
|
|
|
|
.. figure:: ../../main/diagrams/movehub.png
|
|
:width: 100%
|
|
|
|
.. blockimg:: pybricks_variables_set_move_hub_option0
|
|
|
|
.. blockimg:: pybricks_variables_set_move_hub_option4
|
|
|
|
.. autoclass:: pybricks.hubs.MoveHub
|
|
:no-members:
|
|
|
|
.. rubric:: Using the hub status light
|
|
|
|
.. blockimg:: pybricks_blockLightOnColor_movehub_on
|
|
|
|
.. automethod:: pybricks.hubs::MoveHub.light.on
|
|
|
|
.. blockimg:: pybricks_blockLightOnColor_movehub_off
|
|
|
|
.. automethod:: pybricks.hubs::MoveHub.light.off
|
|
|
|
.. automethod:: pybricks.hubs::MoveHub.light.blink
|
|
|
|
.. automethod:: pybricks.hubs::MoveHub.light.animate
|
|
|
|
.. rubric:: Using the IMU
|
|
|
|
.. blockimg:: pybricks_blockImuUp_MoveHub
|
|
|
|
.. automethod:: pybricks.hubs::MoveHub.imu.up
|
|
|
|
.. blockimg:: pybricks_blockTilt_MoveHub_imu.tilt.pitch
|
|
|
|
.. blockimg:: pybricks_blockTilt_MoveHub_imu.tilt.roll
|
|
|
|
.. automethod:: pybricks.hubs::MoveHub.imu.tilt
|
|
|
|
.. blockimg:: pybricks_blockImuAcceleration_MoveHub
|
|
|
|
.. automethod:: pybricks.hubs::MoveHub.imu.acceleration
|
|
|
|
.. versionchanged:: 3.2
|
|
|
|
Changed acceleration units from m/s² to mm/s².
|
|
|
|
.. rubric:: Using connectionless Bluetooth messaging
|
|
|
|
.. blockimg:: pybricks_blockBleBroadcast_PrimeHub
|
|
|
|
.. automethod:: pybricks.hubs::PrimeHub.ble.broadcast
|
|
|
|
.. blockimg:: pybricks_blockBleObserve_PrimeHub
|
|
|
|
.. automethod:: pybricks.hubs::PrimeHub.ble.observe
|
|
|
|
.. automethod:: pybricks.hubs::MoveHub.ble.signal_strength
|
|
|
|
.. automethod:: pybricks.hubs::MoveHub.ble.version
|
|
|
|
.. rubric:: Using the battery
|
|
|
|
.. blockimg:: pybricks_blockBatteryMeasure_MoveHub_battery.voltage
|
|
|
|
.. automethod:: pybricks.hubs::MoveHub.battery.voltage
|
|
|
|
.. blockimg:: pybricks_blockBatteryMeasure_MoveHub_battery.current
|
|
|
|
.. automethod:: pybricks.hubs::MoveHub.battery.current
|
|
|
|
.. rubric:: Button and system control
|
|
|
|
.. blockimg:: pybricks_blockButtonIsPressed_PrimeHub
|
|
|
|
.. automethod:: pybricks.hubs::MoveHub.buttons.pressed
|
|
|
|
.. automethod:: pybricks.hubs::MoveHub.system.info
|
|
|
|
.. blockimg:: pybricks_blockHubStopButton_MoveHub
|
|
|
|
.. blockimg:: pybricks_blockHubStopButton_MoveHub_none
|
|
|
|
.. automethod:: pybricks.hubs::MoveHub.system.set_stop_button
|
|
|
|
.. automethod:: pybricks.hubs::MoveHub.system.storage
|
|
|
|
You can store up to 128 bytes of data on this hub. The data is cleared
|
|
when you update the Pybricks firmware or if you restore the original
|
|
firmware.
|
|
|
|
.. automethod:: pybricks.hubs::MoveHub.system.reset_storage
|
|
|
|
.. blockimg:: pybricks_blockHubShutdown_MoveHub
|
|
|
|
.. automethod:: pybricks.hubs::MoveHub.system.shutdown
|
|
|
|
Status light examples
|
|
---------------------
|
|
|
|
Turning the light on and off
|
|
******************************
|
|
|
|
.. literalinclude::
|
|
../../../examples/pup/hub_common/build/light_off_movehub.py
|
|
|
|
Making the light blink
|
|
******************************
|
|
|
|
.. literalinclude::
|
|
../../../examples/pup/hub_common/build/light_blink_movehub.py
|
|
|
|
IMU examples
|
|
---------------
|
|
|
|
Testing which way is up
|
|
********************************
|
|
|
|
.. literalinclude::
|
|
../../../examples/pup/hub_common/build/imu_up_movehub.py
|
|
|
|
Reading acceleration
|
|
**************************************************
|
|
|
|
.. literalinclude::
|
|
../../../examples/pup/hub_movehub/imu_read_acceleration.py
|
|
|
|
|
|
Bluetooth examples
|
|
------------------
|
|
|
|
Broadcasting data to other hubs
|
|
*******************************
|
|
|
|
.. literalinclude::
|
|
../../../examples/pup/hub_common/build/ble_broadcast_movehub.py
|
|
|
|
Observing data from other hubs
|
|
******************************
|
|
|
|
.. literalinclude::
|
|
../../../examples/pup/hub_common/build/ble_observe_movehub.py
|
|
|
|
|
|
Button and system examples
|
|
----------------------------------
|
|
|
|
Using the stop button during your program
|
|
*****************************************
|
|
|
|
.. literalinclude::
|
|
../../../examples/pup/hub_common/build/button_single_movehub.py
|
|
|
|
Turning the hub off
|
|
*****************************************
|
|
|
|
.. literalinclude::
|
|
../../../examples/pup/hub_common/build/system_shutdown_movehub.py
|
|
|
|
Making random numbers
|
|
**************************************************
|
|
|
|
The Move Hub does not include the :mod:`urandom` module. If you need random
|
|
numbers in your application, you can try a variation of the following example.
|
|
|
|
To make it work better, change the initial value of ``_rand`` to something
|
|
that is truly random in your application. You could use the IMU acceleration
|
|
or a sensor value, for example.
|
|
|
|
.. literalinclude::
|
|
../../../examples/pup/hub_movehub/randint_implementation.py
|