Bluetooth HID Events

Overview

• All Bluetooth HID event module functions require hardware to use
• See Bluetooth HID setup in Advanced — Bluetooth HID Hardware: Bluetooth HID Hardware
• The module object prefix is bleEvent, e.g. bleEvent.click()

startConnect Connect Bluetooth Device

• Connect to a Bluetooth device
• Can be used without pre-configuring in app settings; this function scans, connects, and saves
• If you do not want per-device setup, use this function
• Requires EC Android 11.37.0+
• @param bleDeviceName Bluetooth device name; omit to read from app settings — last 8 chars of board MAC, lowercase
• @param save Save to app Bluetooth device name settings; set true to persist
• @param timeout Connection timeout in milliseconds
• @returns {string|null} null or empty on success; otherwise an error message

1
function main() {
2
    logd("connecting ble...")
3
    let cr = connect_ble();
4
    if (cr == null || cr == "") {
5
        logd("ble connected")
6
    } else {
7
        logw("ble connect failed " + cr)
8
        return
9
    }
10
    sleep(1000)
11
    // Enable pointer location in Developer Options to see tap effects
12
    logd("testing clickPoint")
13
    // let crc = bleEvent.clickPoint(399, 4525);
14
    // if (crc == null || crc == "") {
15
    // logd("click success ")
16
    // } else {
17
    // logd("click failed " + crc)
18
    // }
19
    // sleep(3000)
20
    // logd("testing press")
21
    // let crc2 = bleEvent.press(399, 455, 5000);
22
    // if (crc2 == null || crc2 == "") {
23
    // logd("press success ")
24
    // } else {
25
    // logd("press failed " + crc2)
26
    // }
27
    // sleep(6000)
28
    // sleep(1000)
29
    // logd("testing doubleClick")
30
    // let doubleClickr = bleEvent.doubleClick(666, 1000, 30);
31
    // if (doubleClickr == null || doubleClickr == "") {
32
    // logd("doubleClick success ")
33
    // } else {
34
    // logd("doubleClick failed " + doubleClickr)
35
    // }
36
    // sleep(6000)
37
    //
38
    // test_Swipe();
39
    // touchTest()
40
    // mtouch();
41
    test_Swipe();
42
    testSystemKey();
43

44
    // Input character a
45
    bleEvent.keyPressChar("","a")
46

47
    testPressKey();
48
    //bleEvent.stopConnect()
49
    sleep(100000)
50
    logd("0---end ");
51
}
52

53

54
function testPressKey() {
55
    sleep(1000)
56
    let press_a = bleEvent.keyPress("", 65);
57
    console.log("press_a {}", press_a)
58
}
59

60
function testSystemKey() {
61

62
    sleep(1000)
63

64
    logd("home " + bleEvent.home())
65
    sleep(1000)
66

67
    logd("back " + bleEvent.back())
68

69
    sleep(1000)
70
    logd("recents " + bleEvent.recents())
71

72
}
73

74
function test_Swipe() {
75
    sleep(1000)
76
    let td = bleEvent.swipe(300, 400, 500, 600, 5000)
77
    logd("swipe result: " + td)
78
    sleep(6000)
79
}
80

81
function mtouch() {
82
    sleep(1000)
83

84
    let data = [
85
        {"action": 0, "x": 250, "y": 1800, "pointer": 1, "delay": 100},
86
        {"action": 2, "x": 250, "y": 1700, "pointer": 1, "delay": 100},
87
        {"action": 2, "x": 330, "y": 1650, "pointer": 1, "delay": 200},
88
        {"action": 2, "x": 330, "y": 1640, "pointer": 1, "delay": 200},
89
        {"action": 2, "x": 330, "y": 1620, "pointer": 1, "delay": 200},
90
        {"action": 2, "x": 322, "y": 1500, "pointer": 1, "delay": 200},
91
        {"action": 2, "x": 322, "y": 1400, "pointer": 1, "delay": 200},
92
        {"action": 2, "x": 334, "y": 1000, "pointer": 1, "delay": 200},
93
        {"action": 2, "x": 339, "y": 1000, "pointer": 1, "delay": 200},
94
        {"action": 2, "x": 330, "y": 1000, "pointer": 1, "delay": 200},
95
        {"action": 2, "x": 453, "y": 1000, "pointer": 1, "delay": 200},
96
        {"action": 2, "x": 555, "y": 1000, "pointer": 1, "delay": 200},
97
        {"action": 2, "x": 557, "y": 600, "pointer": 1, "delay": 200},
98
        {"action": 1, "x": 600, "y": 400, "pointer": 1, "delay": 100}
99
    ]
100

101
    let tou = bleEvent.multiTouch(data, 1000)
102
    sleep(5000)
103
    if (tou == null) {
104
        logd("multi-touch success")
105
    } else {
106
        loge("multi-touch failed:" + tou);
107
        return false
108
    }
109
}
110

111
function touchTest() {
112
    sleep(6000)
113
    let td = bleEvent.touchDown(300, 400)
114
    console.log(" touchDown result " + td)
115
    sleep(1000)
116
    bleEvent.touchMove(350, 460)
117
    sleep(1000)
118
    bleEvent.touchMove(400, 500)
119
    sleep(1000)
120
    logd("touchUp " + bleEvent.touchUp(400, 500))
121
}
122

123

124
/**
125
 * Connect ble
126
 * @returns {null}
127
 */
128
function connect_ble() {
129
    if (bleEvent.isConnected()) {
130
        return null;
131
    }
132
    bleEvent.stopConnect();
133
    return bleEvent.startConnect("", false, 15000);
134

135
}
136

137
// Normal devices do not need this
138
// bleEvent.setWidthEqualsHeight(true)
139

140
main()

stopConnect Disconnect

• Disconnect
• Requires EC Android 11.37.0+
• @return {string} null on success; otherwise an error message

1
    // See startConnect function example

setHeartbeatTimeout Set Heartbeat Timeout

• Set heartbeat timeout
• If heartbeat exceeds the set time, connection is considered lost; default 30s
• @param tt Timeout in milliseconds
• Requires EC Android 11.37.0+

1
    // See startConnect function example

isConnected Connection Status

• Connection status
• Requires EC Android 11.37.0+
• @returns {boolean} true when connected, false when not

1
    // See startConnect function example

setWidthEqualsHeight Coordinate Width Equals Height

• Set coordinate system width equal to height
• Usually not needed; set if tap coordinates are wrong, e.g. iQOO series
• Requires EC Android 11.37.0+
• @param r true to enable
• @returns {string|null} null or empty on success; otherwise an error message

1
    // See startConnect function example

clickPoint Click

• Click
• Requires EC Android 11.37.0+
• @param x X coordinate
• @param y Y coordinate
• @returns {string|null} null or empty on success; otherwise an error message

1
    // See startConnect function example

press Long Press

• Long press
• Note: async with script; call sleep(delay) afterward to avoid event conflicts
• Requires EC Android 11.37.0+
• @param x X coordinate
• @param y Y coordinate
• @param delay Hold duration in milliseconds
• @returns {string|null} null or empty on success; otherwise an error message

1
    // See startConnect function example

doubleClick Double Click

• Double click
• Requires EC Android 11.37.0+
• @param x X coordinate
• @param y Y coordinate
• @returns {string|null} null or empty on success; otherwise an error message

1
    // See startConnect function example

touchDown Touch Down

• Touch down
• Requires EC Android 11.37.0+
• @param x X coordinate
• @param y Y coordinate
• @returns {string|null} null or empty on success; otherwise an error message

1
    // See startConnect function example

touchMove Touch Move

• Touch move
• Requires EC Android 11.37.0+
• @param x X coordinate
• @param y Y coordinate
• @returns {string|null} null or empty on success; otherwise an error message

1
    // See startConnect function example

touchUp Touch Up

• Touch up
• Requires EC Android 11.37.0+
• @param x X coordinate
• @param y Y coordinate
• @returns {string|null} null or empty on success; otherwise an error message

1
    // See startConnect function example

swipe Swipe

• Swipe
• Note: async with script; call sleep(delay) afterward to avoid event conflicts
• Requires EC Android 11.37.0+
• @param x Start X coordinate
• @param y Start Y coordinate
• @param ex End X coordinate
• @param ey End Y coordinate
• @param delay Total swipe duration in milliseconds
• @returns {string|null} null or empty on success; otherwise an error message

1
    // See startConnect function example

multiTouch Multi-Touch

• Multi-touch
• Note: async with script; sleep for total swipe duration to avoid event conflicts
• Requires EC Android 11.37.0+
• Touch parameters: action — 0 = down, 1 = up, 2 = move
• x: X coordinate
• y: Y coordinate
• pointer: Finger index 1, 2, 3, etc.
• delay: Delay before this action in ms; use >40ms to avoid coordinate drift
• @param touch1 Touch point array for finger 1, e.g. [{"action":0,"x":1,"y":1,"pointer":1,"delay":30},{"action":2,"x":1,"y":1,"pointer":1,"delay":30}]
• @param timeout Multi-touch execution timeout in milliseconds
• @returns {string|null} null or empty on success; otherwise an error message

1
    // See startConnect function example

systemKey System Key

• System key
• Requires EC Android 11.37.0+
• @param key Values: home, back, recents
• @returns {string|null} null or empty on success; otherwise an error message

1
    // See startConnect function example

recents Recents

• Recents / task list
• May not work on all devices (non-standard key)
• Requires EC Android 11.37.0+
• @returns {string|null} null or empty on success; otherwise an error message

1
    // See startConnect function example

back Back

• Back
• Requires EC Android 11.37.0+
• @returns {string|null} null or empty on success; otherwise an error message

1
    // See startConnect function example

home Home

• Home
• Requires EC Android 11.37.0+
• @returns {string|null} null or empty on success; otherwise an error message

1
    // See startConnect function example

keyPress Keyboard Key

• Keyboard key
• Requires EC Android 11.37.0+
• @param prefix Modifier prefix; omit or null for normal key: alt, ctrl, gui (Win), r_ctrl (right Ctrl), r_shift (right Shift), shift
• @param code ASCII code
• @returns {string|null} null or empty on success; otherwise an error message

1
    // See startConnect function example

keyPressChar Keyboard Character

• Keyboard character key
• Requires EC Android 11.37.0+
• @param prefix Modifier prefix; omit or null for normal key: alt, ctrl, gui (Win), r_ctrl (right Ctrl), r_shift (right Shift), shift
• @param c Single character, e.g. a; converted to ASCII internally. See https://tool.oschina.net/commons?type=4
• @returns {string|null} null or empty on success; otherwise an error message

1
    // See startConnect function example

hideBleName Hide Bluetooth Name

• Hide Bluetooth name to prevent discovery
• Requires EC Android 11.38.0+
• @returns {string|null} null or empty on success; otherwise an error message

1
    // Combined with startConnect example
2
    // Call after successful connection
3
    bleEvent.hideBleName();
4
    sleep(1000)
5
    // Call again
6
    let cr = bleEvent.hideBleName();
7
    if (cr == null || cr == "") {
8
        logd("hide success")
9
    } else {
10
        logw("hide failed " + cr)
11
        return
12
    }

showBleName Show Bluetooth Name

• Show Bluetooth name
• If BLE communication fails, display may fail — manually reset the board
• Requires EC Android 11.38.0+
• @returns {string|null} null or empty on success; otherwise an error message

1
    // Combined with startConnect example
2
    // Call after successful connection
3
    bleEvent.showBleName();
4
    sleep(1000)
5
    // Call again
6
    let cr = bleEvent.showBleName();
7
    if (cr == null || cr == "") {
8
        logd("success")
9
    } else {
10
        logw("failed " + cr)
11
        return
12
    }

getConfigBleName Get App-Configured Bluetooth Name

• Get the Bluetooth name configured in the app
• Requires EC Android 11.38.0+
• @returns {string|null} Name string

1
    let cr = bleEvent.getConfigBleName();
2
    logd("cr "+cr)

setWifi Set WiFi

• Set WiFi credentials
• Requires EC Android 11.39.0+
• Board must be restarted after setting to connect to network
• @param name WiFi SSID
• @param pwd WiFi password
• @returns {string|null} null or empty on success; otherwise an error message

1
    // Call after successful Bluetooth connection
2

3
    let cr = bleEvent.setWifi("112","333");
4
    logd("cr "+cr)

reset Reset Board

• Reset the development board
• Requires EC Android 11.39.0+
• @returns {string|null} null or empty on success; otherwise an error message

1
    // Call after successful Bluetooth connection
2
    let cr = bleEvent.reset();
3
    logd("cr "+cr)