加速度模块/Acceleration¶

加速度传感器可以测量空间X，Y，Z轴的加速度/角加速度等物理参数。运用简单的数学知识还可以计算出倾角等其他有意义的数值。

常见应用场景

加速度检测：睡眠质量监测，拍手检测（震动），姿态检测等
倾角感应：倾斜控制器，检测物品是否水平等

获得X轴倾斜角¶

Acceleration.get_x_angle()¶

获取x轴倾斜角，单位 °

返回:	x轴加速度值，范围 -180~180 °
返回类型:	float

Examples

# 倾斜角显示案例

from wonderbits import Acceleration,Display
display1 = Display()
acceleration1 = Acceleration()

# 在显示屏上实时显示x轴加速度值
while True:
    display1.print(1, 1, acceleration1.get_x_angle())
    display1.print(2, 1, acceleration1.get_y_angle())

获得X轴倾斜角¶

Acceleration.get_y_angle()¶

获取x轴倾斜角，单位 °

返回: x轴加速度值，范围 -180~180 °

返回类型: float

range: -180~180 False 0,
Examples

未提供。可以参考 get_x_angle 的使用案例

校准加速度传感器¶

Acceleration.calibrate(block=True)¶
注意：校准过程中需确保加速度模块且保持静止不动，有汉字的一面朝上。

校准时，模块指示灯会变为黄色，等待指示灯变蓝说明校准完成了。

参数: block (bool) –
阻塞参数：

False表示不阻塞

True表示阻塞

default: True False 0,
Examples
# 加速度模块校准
from wonderbits import Acceleration, Display
acceleration1 = Acceleration()
display1 = Display()

display1.print(1,1,'calibrating..')

# 校准加速度传感器，校准时水平放在桌子上，观察模块上的指示灯变化
acceleration1.calibrate()

display1.print(1,1,'calibrated.  ')

获取x轴加速度值¶

Acceleration.get_x_acceleration()¶
获取x轴加速度值，单位 m/s²

返回: x轴加速度值，范围 -80~80 m/s²

返回类型: float

range: -80~80 False 0,
Examples
# 加速度值显示案例

from wonderbits import Acceleration,Display
display1 = Display()
acceleration1 = Acceleration()

# 在显示屏上实时显示x轴加速度值
while True:
    display1.print(1, 1, acceleration1.get_x_acceleration())

获取y轴加速度值¶

Acceleration.get_y_acceleration()¶

获取y轴加速度值，单位 m/s²

返回: y轴加速度值，范围 -80~80 m/s²

返回类型: float

range: -80~80 False 0,
Examples

未提供。可以参考 get_x_acceleration 的使用案例

获取z轴加速度值¶

Acceleration.get_z_acceleration()¶

获取z轴加速度值，单位 m/s²

返回: z轴加速度值，范围 -80~80 m/s²

返回类型: float

range: -80~80 False 0,
Examples

未提供。可以参考 get_x_acceleration 的使用案例

获取合加速度值¶

Acceleration.get_acceleration()¶

获取x、y、z轴合加速度值，单位 m/s²

返回: 合加速度，范围-80~80 m/s²

返回类型: float

range: -80~80 False 0,
Examples

未提供。可以参考 get_x_acceleration 的使用案例

获取x轴角速度值¶

Acceleration.get_x_angular_velocity()¶
获取x轴角速度值，单位 °/s

返回: x轴角速度值，范围-1000~1000 °/s

返回类型: float

range: -1000~1000 False 0,
Examples
# 角速度值显示案例
from wonderbits import Acceleration,Display
display1 = Display()
acceleration1 = Acceleration()

# 在显示屏上实时显示x轴角速度值
while True:
    display1.print(1, 1, acceleration1.get_x_angular_velocity())

获取y轴角速度值¶

Acceleration.get_y_angular_velocity()¶

获取y轴角速度值，单位 °/s

返回: y轴角速度值，范围-1000~1000 °/s

返回类型: float

range: -1000~1000 False 0,
Examples

未提供。可以参考 get_x_angular_velocity 的使用案例

获取z轴角速度值¶

Acceleration.get_z_angular_velocity()¶

获取z轴角速度值，单位 °/s

返回: z轴角速度值，范围-1000~1000 °/s

返回类型: float

range: -1000~1000 False 0,
Examples

未提供。可以参考 get_x_angular_velocity 的使用案例

当X轴倾斜¶

Acceleration.when_x_tilted()¶

当X轴倾斜时，执行被修饰的函数

Examples

# 当acceleration1X轴倾斜时会在display1模块中显示x轴倾角的值

from wonderbits import Acceleration,Display

display1 = Display()
acceleration1 = Acceleration()

@acceleration1.when_x_tilted()
def run1(val):
    display1.print(1, 1, val)

while True:
    pass

当Y轴倾斜¶

Acceleration.when_y_tilted()¶

当Y轴倾斜时，执行被修饰的函数

Examples

未提供。可以参考 when_x_tilted 的使用案例

事件源¶

Acceleration.Acceleration.source_x_acceleration¶

x轴加速度事件源

Acceleration.Acceleration.source_y_acceleration¶

y轴加速度事件源

Acceleration.Acceleration.source_z_acceleration¶

z轴加速度事件源

Acceleration.Acceleration.source_x_angular_velocity¶

x轴角速度事件源

Acceleration.Acceleration.source_y_angular_velocity¶

y轴角速度事件源

Acceleration.Acceleration.source_z_angular_velocity¶

z轴角速度事件源

Acceleration.Acceleration.source_x_angle¶

x轴倾斜角事件源

Acceleration.Acceleration.source_y_angle¶

y轴倾斜角事件源

Acceleration.Acceleration.source_acceleration¶

合加速度事件源