🤖
LinkIt 7697 BlocklyDuino 使用指南
  • LinkIt 7697 BlocklyDuino 使用指南
    • 認識 LinkIt 7697
    • 認識 BlocklyDuino
    • BlocklyDuino v2 & v3 比較
    • 安裝開發環境 (v2)
      • 安裝 Arduino 編輯器
      • 安裝驅動並連接開發板
      • 安裝 BlocklyDuino 編輯器
      • 連結兩個編輯器並上傳程式
    • 安裝開發環境 (v3)
    • BlocklyDuino 基礎操作
    • 實作範例教學
      • A01. 內建 LED 閃爍
      • A02. 外接 LED 閃爍
      • A03. 外接 LED 呼吸燈
      • A04. RGB LED 顏色變化
      • A05. 外部按鈕控制開關
      • A06. 蜂鳴器播放聲音
      • A07 .可變電阻控制電壓輸出
      • A08. 伺服馬達控制
      • A21. DHT: 溫濕度感應器
      • A22. HTU21D: 溫溼度感應器
      • A23. PMSX003: PM2.5 感測器
      • A24. HC-SR04P: 超音波測距
      • A25. ADXL345: 加速規(動態)
      • A26. ADXL345: 加速規(手勢)
      • A27. 1602/2004: 液晶顯示模組
      • A28. WS2812: RGB 彩色燈條
      • A29. MFRC522: RFID
      • B00. Grove 相關基礎知識
      • B01. Grove 光感應器
      • B02. Grove 超音波測距感應器
      • B03. Grove 溫溼度感應器
      • B04. Grove 繼電器
      • B05. Grove LED 燈條
      • B06. Grove OLED 顯示器
      • C01. 雲端控制 LED 開關
      • C02. 上傳溫溼度到雲端
      • D01. 手機透過 BLE 讀寫裝置資料
      • E01. 遙控器: 按鈕控制 LED
    • 資源鏈結
  • LinkIt 7697 - Arduino IDE 開發指南
    • 環境設定
      • 設定 Arduino IDE
      • 將 LinkIt 7697 連接到電腦
        • 在 Windows 上安裝 CP2102N 驅動程式
        • 在 macOS 上安裝 CP2102N 驅動程式
      • 執行第一個程式
    • 開發指南
      • GPIO
      • UART
      • ADC
      • EINT (外部中斷 / External Interrupt)
      • I2C
      • SPI
      • EEPROM
      • Timer
      • Flash (索引式儲存空間)
      • RTC (Real-Time Clock)
      • Software Serial
      • 使用 Wi-Fi 函式庫
      • 使用 MCS 函式庫
        • 連接到 MCS
        • 連接到 MCSLite
          • 建立可透過 MCS Lite 控制的 Beacon
        • MCS 函式庫 API 使用手冊
          • MCSDevice
          • MCSLiteDeviceMCSLiteDevice
          • MCSDataChannel 相關類別
      • 使用 BLE 低功耗藍牙
        • 藍牙信標
        • 主控裝置
        • 周邊裝置
        • 已知限制
        • LBLE API 指南
          • LBLE
          • LBLECentral
          • LBLEPeripheral
          • LBLEAdvertisementData
          • LBLEService
          • LBLECharacteristic
          • LBLEAddress
          • LBLEUuid
          • LBLEClient
      • 使用 LinkIt Remote
        • LRemote API
        • LRemote 控制元件 API
      • LinkIt 7697 腳位的初始狀態
      • LinkIt 7697 供電說明
      • 更新 Bootloader 與韌體
      • Flash 燒錄工具
      • FOTA 更新
      • LinkIt 7697 的功能限制
      • 自行編譯 Arduino Package
      • 回報問題
    • 週邊元件連接教學
      • SMD 按鈕
      • RGB 三色 LED
      • 可變電阻
      • 九軸感應器 (MPU-9250)
      • 溫度與濕度感應器 (AM2302)
      • 超音波距離感應器
      • 光感應器 (LM358)
      • 0.96 吋 OLED 顯示模組 (SSD1308Z)
      • 長條型 LED 顯示模組 (MY9221)
      • 繼電器
      • 伺服馬達 (EMAX 9g ES08A Servo)
      • 使用 74HC595 驅動七段顯示器
      • 使用 MAX7219 驅動七段顯示器
      • 使用 MAX7219 驅動 8x8 矩陣式顯示器
      • 使用 OLED 模組 (如 SH1106 / SSD1306... 等模組)
      • 使用 PCF8574 / PCF8574A 驅動 1602 LCD
    • 開發套件與擴充板
      • Grove Starter Kit
      • Robot Shield
        • OTTO97
    • 下載
    • 資源連結
    • BSP 版本更新資訊
  • LinkIt 7697 - Development Guide for Arduino IDE
    • Environment Setup
      • Setup Arduino IDE
      • Connecting LinkIt 7697 to Computer
        • Install CP2102N Driver on Windows
        • Install CP2102N Driver on macOS
      • Run Your First Sketch
    • Developer Guide
      • GPIO
      • UART
      • ADC
      • External Interrupt
      • I2C
      • SPI
      • EEPROM
      • Timer
      • Flash (Key-Pair Storage)
      • RTC (Real-Time Clock)
      • Software Serial
      • Using the Wi-Fi Library
      • Using MCS Library
        • Connecting to MCS
        • Connecting to MCSLite
          • Build a Beacon controlled by MCS Lite
        • MCS Library API Reference
          • MCSDevice
          • MCSLiteDevice
          • MCSDataChannel Classes
      • Using Bluetooth
        • Beacons
        • Central Devices
        • Peripheral Devices
        • Limitations of LBLE library
        • LBLE Library API Guide
          • LBLE
          • LBLECentral
          • LBLEPeripheral
          • LBLEAdvertisementData
          • LBLEService
          • LBLECharacteristic
          • LBLEAddress
          • LBLEUuid
          • LBLEClient
      • Using LinkIt Remote
        • LRemote
        • LRemote Control Classes
      • Initial Pin State of LinkIt 7697
      • Powering the LinkIt 7697
      • Update Bootloader and Firmware
      • Flash Uploading Tool
      • FOTA Update
      • Limitations of LinkIt 7697
      • Source Code of Arduino Package
      • Issue Report
    • Tutorial
      • SMD Buttons
      • RGB LED
      • Potentiometer
      • IMU 9DOF v2.0 (MPU-9250)
      • Temperature and Humidity Sensor Pro (AM2302)
      • Grove Ultrasonic Ranger
      • Light Sensor (LM358)
      • Grove OLED Display 0.96" (SSD1308Z)
      • LED Bar v2.0 (MY9221)
      • Relay
      • Mini Servo (EMAX 9g ES08A Servo)
      • Driving 7-segment Displays with 74HC595
      • Driving 7-segment Displays with MAX7219
      • Driving 8x8 Dot Matrices with MAX7219
      • Using OLED module (SH1106 / SSD1306... etc.)
      • Driving 1602 LCD with PCF8574 / PCF8574A
    • Kits and Shields
      • Grove Starter Kit
      • Robot Shield
        • OTTO97
    • Download
    • Resources
    • BSP Release Notes
Powered by GitBook
On this page
  • 所有類別均可使用的方法
  • 除了 LRemoteLabel 之外的類別均可使用的方法
  • 僅供 LRemoteSlider 使用的方法
  • 僅供 LRemoteLabel 使用的方法
  1. LinkIt 7697 - Arduino IDE 開發指南
  2. 開發指南
  3. 使用 LinkIt Remote

LRemote 控制元件 API

此頁面介紹各種控制元件的類別,可供開發者加入 LRemote 所創建的控制畫面之中:

  • LRemoteLabel: 靜態的單行文字標籤

  • LRemoteButton: 帶有文字標籤的簡單按鈕

  • LRemoteCircleButton: 帶有文字標籤的圓形按鈕

  • LRemoteSlider: 可設定初始值與數值範圍的滾動軸

  • LRemoteSwitch: 可切換開與關的按鈕

  • LRemoteJoystick: 類比搖桿

要使用這些類別之前,請確保將它們宣告為全域變數:

#include <LRemote.h>

LRemoteLabel label;
LRemoteButton button;
LRemoteSlider slider;
LRemoteSwitch switchButton;
LRemoteCircleButton bigButton;

void setup() {
}

接著可以設定控制元件的文字、大小、位置、顏色等等資訊,然後透過 LRemote.addControl() 將其加入控制畫面中。

void setup() {
  LRemote.setGrid(3, 5);
  
  // Add a push button
  button.setText("Press Me");
  button.setPos(1, 1);
  button.setSize(2, 1);
  button.setColor(RC_PINK);
  LRemote.addControl(button);
  
  LRemote.begin();
}

所有類別均可使用的方法

setText()

setColor()

setPos()

setSize()

設定控制元件的文字標籤

Syntax

text: 文字標籤

Returns

none

設定控制元件的顏色

Syntax

color: 元件的顏色,必須是下面列表的其中之一:

  • RC_ORANGE

  • RC_BLUE

  • RC_GREEN

  • RC_PINK

  • RC_GREY

  • RC_YELLOW

Returns

none

設定控制元件的位置。此位置的座標是用 LRemote.setGrid() API 來決定的。

要注意的是,畫面最左上角的座標為 (0, 0)。

Syntax

Parameters

x: 在 X 軸上面的位置,範圍從 0 到 (畫布的直欄數量 - 1 )

y: 在 Y 軸上面的位置,範圍從 0 到 (畫布的橫列數量 - 1)

Returns

none

設定控制元件的大小,單位是畫布網格的大小。

Syntax

Parameters

w: 控制元件的寬度,單位是一個畫布的網格中的一小格。

h: 控制元件的高度,單位是一個畫布的網格中的一小格。

Returns

none

除了 LRemoteLabel 之外的類別均可使用的方法

isValueChanged(

getValue()

檢查遠端的 LinkIt Remote 手機程式是否已經修改 UI control

Check if the LinkIt Remote app has made a change to the UI control

Syntax

isValueChanged()

Parameters

none

Returns

true 表示 LinkIt Remote 曾經傳送過指令給 LInkIt 7699。

false 表示,在上一次呼叫 LRemote.process() 之後,都沒有來自 LinkIt Remote 手機程式的指令。

取得控制元件當前的數值

Syntax

getValue()

Parameters

none

Returns

Control Type
Value

LRemoteSlider

當前捲動軸的數值

LRemoteButton

LRemoteCircleButton

1: 按鈕被按下

0: 按鈕被釋放

LRemoteSwitch

1: 開啟開關

0: 關閉開關

LRemoteJoystick

回傳一個 LRemoteDirection物件,開發者可以使用 .x 來存取 X 軸的數值,用 .y 來存取 Y 軸的數值。

回傳的數值介於 -100 到 100 之間。 -100 代表最左邊/下面,100代表最右邊/上面。

僅供 LRemoteSlider 使用的方法

setValueRange()

設定滾動軸允許的最小、最大值

Syntax

min_value: 滾動軸最左端代表的值。最小不能小於 -32767

max_value: 滾動值最右端代表的值。此值不能夠大於 32767

init_value: 滾動軸的初始值

Returns

none

僅供 LRemoteLabel 使用的方法

updateText()

改變文字標籤。即便 LinkIt Remote 程式已經連接了,還是可以用此方法更新文字標籤的內容。

Syntax

new_text: 要更新的文字標籤,長度不能夠超過 15 bytes。

Returns

none

PreviousLRemote APINextLinkIt 7697 腳位的初始狀態

Last updated 3 years ago