TI Hub 菜单

注: 创建使用此模块的新程序时，建议使用 Hub 项目程序类型。这将确保导入所有相关模块。

项目

说明

from ti_hub import *

从 ti_hub 模块导入所有方法。

 

Hub 内置设备 > 颜色输出

项目

说明

rgb(red,green,blue)

设置 RGB LED 的颜色。

blink(frequency,time)

设置所选颜色的闪烁频率和持续时间。

off()

关闭 RGB LED。

 

Hub 内置设备 > 亮度输出

项目

说明

on()

打开 LED。

off()

关闭 LED。

blink(frequency,time)

设置 LED 的闪烁频率和持续时间。

 

Hub 内置设备 > 声音输出

项目

说明

tone(frequency,time)

在指定的时间内播放指定频率的声音。

note("note",time)

在指定的时间内播放指定的音符。

使用音名和一个八度指定音符。例如:A4、C5。

音名为 C、CS、D、DS、E、F、FS、G、GS、A、AS 和 B。

八度编号范围为 1 到 9（含 1 和 9）。

tone(frequency,time,tempo)

在指定的时间和节拍内播放指定频率的声音。

节拍定义了 0 到 10（含 0 和 10）之间的每秒蜂鸣音次数。

note("note",time,tempo)

在指定的时间和节拍内播放指定的音符。

使用音名和一个八度指定音符。例如:A4、C5。

音名为 C、CS、D、DS、E、F、FS、G、GS、A、AS 和 B。

八度编号范围为 1 到 9（含 1 和 9）。

节拍编号范围为 0 到 10（含 0 和 10）。

 

Hub 内置设备 > 亮度输入

项目

说明

measurement()

读取内置 BRIGHTNESS（光级）传感器并返回读数。

默认范围为 0 到 100。可以使用 range() 函数对其进行更改。

range(min,max)

设置从光级传感器映射读数的范围。

如果两者都缺失，或设置为“无”值，则设置 0 到 100 的默认亮度范围。

 

添加输入设备

此菜单包含 ti_hub 模块支持的传感器（输入设备）列表。所有菜单项都会粘贴对象的名称，并预计有变量和与传感器一起使用的端口。每个传感器都有返回传感器值的 measurement() 方法。

项目

说明

DHT (Digital Humidity & Temp)

返回包含当前温度、湿度、传感器类型和最后缓存读取状态的列表。

测距仪

返回指定超声波测距仪的当前距离测量结果。

• measurement_time()——返回超声波信号到达对象所需的时间（“飞行时间”）。

亮度级

返回外部光级（亮度）传感器的亮度级别。

温度

返回外部温度传感器的温度读数。

默认配置是在 IN 1、IN 2 或 IN 3 端口中支持 Seeed 温度传感器。

要使用 TI-Innovator™ Hub 试验板包的 TI LM19 温度传感器，请编辑使用中的 BB 插针端口，并使用可选参数“TIANALOG”。

示例:mylm19=temperature("BB 5","TIANALOG")

湿度

返回湿度传感器读数。

磁性

检测磁场的存在。

通过 trigger() 函数设置确定磁场存在的阈值。

阈值的默认值为 150。

Vernier

读取命令中指定的 Vernier 模拟传感器的值。

该命令支持以下 Vernier 传感器:

• 温度 - 不锈钢温度传感器。
• lightlevel - TI 光级传感器。
• 压力 - 原装气压传感器
• 压力 - 新型气压传感器。
• pH - pH 传感器。
• force10 - 设置为 ±10 N、双力传感器。
• force50 - 设置为 ±50 N、双力传感器。
• 加速计 - 低重力加速计。
• 通用 - 允许设置上述不直接支持的其他传感器，并使用上述 calibrate() API 设置方程系数。

Analog In

支持使用模拟输入通用设备。

Digital In

返回连接到 DIGITAL 对象的数字插针的当前状态，或最近一次为对象设置的数字输出值的缓存状态。

电位计

支持电位计传感器。

传感器的范围可通过 range() 函数更改。

热敏电阻器

读取热敏电阻器传感器。

当与 10KΩ 固定电阻器配合使用时，默认系数专为与 TI-Innovator™ Hub 试验板包中包含的热敏电阻器匹配。

可使用 calibrate() 函数为热敏电阻器配置一组新的校准系数和参考电阻。

响度

支持声音响度传感器。

颜色输入

提供与 I2C 连接的颜色输入传感器的接口。

除了 I2C 端口外，还使用 bb_port 插针来控制颜色传感器上的 LED。

• color_number(): 返回介于 1 到 9 之间的值，该值代表传感器正在检测的颜色。

数字代表以下映射对应的颜色:

1: 红色

2: 绿色

3: 蓝色

4: 青色

5: 品红色

6: 黄色

7: 黑色

8: 白色

9: 灰色

• red(): 返回介于 0 到 255 之间的值，该值表示检测到的红色等级强度。
• green(): 返回介于 0 到 255 之间的值，该值表示检测到的绿色等级强度。
• blue(): 返回介于 0 到 255 之间的值，该值表示检测到的蓝色等级强度。
• gray(): 返回介于 0 到 255 之间的值，表示检测到的灰色等级，其中 0 为黑色，255 为白色。

BB 端口

支持将 10 个 BB 端口插针全部用作组合数字输入/输出端口。

初始化函数包含可选的“掩码”参数，允许使用 10 个插针的子集。

• read_port(): 读取 BB 端口输入插针上的当前值。
• write_port(value): 将输出插针值设置为指定值，其中值介于 0 到 1023 之间。请注意，如果提供了掩码，则该值也会根据 var=bbport (mask) 运算中的掩码值进行调整。

Hub 时间

提供对内部毫秒计时器的访问。

TI-RGB Array

提供用于对 TI-RGB 阵列进行编程的函数。

初始化函数接受可选的“LAMP”参数，为需要外部电源的 TI-RGB 阵列启用高亮度模式。

• set(led_position, r,g,b): 将特定的 led_position (0-15) 设置为指定的 r、g、b 值，其中 r、g、b 为 0 到 255 之间的值。
• set(led_list,red,green,blue): 将“led_list”中定义的 LED 设置为“red”、“green”、“blue”中指定的颜色。“led_list”是一个 Python 列表，包括 0 到 15 之间的 LED 索引。例如，set([0,2,4,6,15], 0, 0, 255) 会将 LED 0, 2, 4, 6 和 15 设置为蓝色。
• set_all(r,g,b): 将阵列中的所有 RGB LED 设置为相同的 r、g、b 值。
• all_off(): 关闭阵列中的所有 RGB。
• measurement(): 以毫安为单位从 TI-Innovator™ 返回 RGB 阵列正在使用的近似电流消耗。
• pattern(pattern): 使用参数值作为 0 到 65535 范围内的二进制值，打开表示中值为 1 的像素。LED 呈红色亮起，pwm 电平值为 255。
• pattern(value,red,green,blue): 将“pattern”定义的 LED 设置为“red”、“green”、“blue”指定的颜色。

 

添加输出设备

此菜单有 ti_hub 模块支持的输出设备列表。所有菜单项都会粘贴对象的名称，并预计有变量和与设备一起使用的端口。

项目

说明

LED

控制外部连接的 LED 的函数。

RGB

支持控制外部 RGB LED。

TI-RGB Array

提供用于对 TI-RGB 阵列进行编程的函数。

扬声器

通过 TI-Innovator™ Hub 支持外部扬声器的函数。

函数与上述的“声音”的函数相同。

功率

通过 TI-Innovator™ Hub 控制外部电源的函数。

• set(value): 将功率等级设置为介于 0 到 100 之间的指定值。
• on(): 将功率等级设置为 100。
• off(): 将功率等级设置为 0。

连续伺服

控制连续伺服电机的函数。

• set_cw(speed,time): 伺服电机将以指定的速度 (0-255) 在特定持续时间（以秒为单位）内顺时针旋转。
• set_ccw(speed,time): 伺服电机将以指定的速度 (0-255) 在特定持续时间（以秒为单位）内逆时针旋转。
• stop(): 停止连续伺服。

模拟输出

使用模拟输入通用设备的函数。

振动电机

控制振动电机的函数。

• set(val): 将振动电机强度设置为 "val" (0-255)。
• off(): 关闭振动电机。
• on(): 以最高等级打开振动电机。

继电器

控制用于控制继电器的接口。

• on(): 将继电器设置为 ON 状态。
• off(): 将继电器设置为 OFF 状态。

伺服

控制伺服电机的函数。

• set_position(pos): 将扫描伺服位置设置在 -90 到 +90 范围内。
• zero(): 将扫描伺服设置为零位置。

方波

生成方波的函数。

• set(frequency,duty,time): 设置输出方波，默认占空比为 50%（如果未指定占空比），且输出频率由“frequence”指定。频率可以是 1 到 500 Hz。如有指定，则占空比可为 0 到 100%。
• off(): 关闭方波。

数字输出

控制数字输出的接口。

• set(val): 将数字输出设置为“val”指定的值（0 或 1）。
• on(): 将数字输出的状态设置为高 (1)。
• off(): 将数字输出的状态设置为低 (0)。

BB 端口

提供用于对 TI-RGB 阵列进行编程的函数。

请参阅上述详情。

 

命令

项目

说明

sleep(seconds)

将程序暂停指定的秒数。

从“时间”模块导入。

text_at(row,"text","align")

在绘图区以指定的“对齐”显示指定的“文本”。

ti_plotlib 模块的一部分。

cls()

清除用于绘图的 Shell 屏幕。

ti_plotlib 模块的一部分。

while get_key() != "esc":

在“while”循环中运行命令，直到按下“esc”键。

get_key()

返回表示按下的按键的字符串。

“1”键返回“1”，“esc”返回“esc”，依此类推。

在没有任何参数的情况下调用 get_key()，它会立即返回。

在使用参数调用 get_key(1) 时，它会等待直到按下一个键。

ti_system 模块的一部分。

 

Ports

这些是 TI-Innovator™ Hub 上可用的输入和输出端口。

项目

OUT 1

OUT 2

OUT 3

IN 1

IN 2

IN 3

BB 1

BB 2

BB 3

BB 4

BB 5

BB 6

BB 7

BB 8

BB 9

BB 10

I2C