「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)

在指定時間播放指定的筆記。

筆記是使用筆記名稱和 octave 指定。範例:A4, C5。

筆記名稱為 C、CS、D、DS、E、F、FS、G、GS、A、AS 和 B。

octave 號碼範圍為從 1 至 9（包含首尾）。

tone(frequency,time,tempo)

在指定的時間和節奏內播放指定頻率的音調。

此節奏定義了從 0 到 10 (含首尾）的每秒嗶聲數。

note("note",time,tempo)

在指定時間和節奏播放指定的音符。

筆記是使用筆記名稱和 octave 指定。範例:A4, C5。

筆記名稱為 C、CS、D、DS、E、F、FS、G、GS、A、AS 和 B。

octave 號碼範圍為從 1 至 9（包含首尾）。

節奏號碼範圍為從 0 至 10（含首尾）。

 

套裝 (Hub) 內建裝置 > 亮度感應器輸入

項目

說明

measurement()

讀取內建亮度（光源等級）感應器並傳回讀數。

預設範圍為 0 到 100。可以使用 range() 函數改變範圍大小。

range(min,max)

設定從光源等級感應器對應讀數的範圍。

如果兩者資料皆遺失，或是將值設定為「無」，則會將亮度範圍設定在 0 到 100 之間。

 

新增輸入裝置

此功能表有 ti_hub 模組支援的感應器清單（輸入裝置）。所有功能表項目都將貼上物件名稱，並且應該會有一個變數以及和感應器搭配使用的連接埠。每個感應器都有一個 measurement() 方法，可傳回感應器數值。

項目

說明

DHT（數位濕度與溫度）

傳回清單，內容包含目前溫度、濕度、感應器類型以及上次快取的讀取狀態。

距離感應器

從指定超音波距離感應器傳回目前的距離測量結果。

• measurement_time() - 傳回超音波訊號到達物件的時間 （「飛行時間」）。

亮度等級

從外部光源等級（亮度）感應器傳回光源等級。

溫度

從外部溫度感應器傳回溫度讀數。

預設配置可支援 IN 1、IN 2 或是 IN 3 連接埠的 Seeed 溫度感應器。

若要使用 TI-Innovator™ 套裝 (Hub) 麵包板套組中的 TI LM19 溫度感應器，請編輯使用中的 BB 針腳連接埠，並且使用選用引數「TIANALOG」。

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

濕度

傳回濕度感應器讀數。

磁性

偵測磁場是否存在。

確定磁場是否存在的閾值透過 trigger() 函數設定。

閾值的預設值為 150。

威尼爾

從指令中指定的威尼爾類比感應器讀取數值。

指令支援下列威尼爾感應器:

• temperature - 不銹鋼溫度感應器。
• lightlevel - TI 光源感應器。
• pressure - 原始氣壓感應器
• pressure - 較新的氣壓感應器。
• pH - pH 感應器。
• force10 - ±10 N 設定，雙範圍力感應器。
• force50 - ±50 N 設定，雙範圍力感應器。
• accelerometer - 低重力加速度計。
• generic - 允許未直接支援上述感應器的其他感應器設定，以及使用上方的 calibrate() API 設定方程式係數。

類比輸入

支援使用類比輸入通用裝置。

數位輸入

傳回連接至 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 連接埠針腳作為合併的數位輸入/輸出連接埠提供支援。

初始化函數包含選用的「mask」參數，可允許使用由 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(): 傳回 RGB 陣列正透過使用 TI-Innovator™使用的近似目前繪圖（單位為毫安）。
• pattern(pattern): 使用引數值作為 0 到 65535 範圍內的二進制值，數值 1 表示開啟像素。LED 已開啟，RED 的 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) 的函數。

這些函數與上述用於「sound」的函數相同。

功率

用於控制外部電源與 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(): 將繼電器設定為「開啟」狀態。
• 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)

在指定的秒數期間暫停執行程式。

從「time」模組匯入。

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

以指定的「align」將指定的「text」顯示在繪圖區域。

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 模組的部分。

 

連接埠

這些是 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