Skip to content

BluetoothAssistant is an Android application that bridges command line commands from Linux/Windows/Mac Operating Systems to Android devices over adb

Notifications You must be signed in to change notification settings

sgxgsx/BluetoothAssistant

Repository files navigation

Bluetooth assistant(蓝牙测试辅助)

BluetoothAssistant is an Android application that bridges command line commands from Linux/Windows/Mac Operating Systems to Android devices over adb. The tool was developed by morrowindxie and he agreed to share it. I have checked the code for possible vulnerabilities/backdoors and was not able to find any, but you are free to verify the code again.

Translated from Chinese

This is an Android application used to assist in testing Bluetooth devices.

It can receive instructions sent by adb shell and help the agent execute the Bluetooth function on the mobile phone:

  • (open) Turn on Bluetooth
  • (close)Turn off Bluetooth
  • (pair) Pair with the specified Bluetooth device Note
  • (unpair) Unpair the specified device
  • (discovery) Search whether the specified device is online
  • (rename) Modify the local Bluetooth name

Compilation method:

  • Download project code
  • Import into Android Studio, compile and run

Installation method (Win/Mac/Linux):

  • adb shell install -r [path to apk]

How to use (Win/Mac/Linux):

  • Open the terminal on your computer and enter any of the following commands:
    • Open adb shell am start -n xie.morrowind.tool.btassist/.MainActivity -e test open
    • Close adb shell am start -n xie.morrowind.tool.btassist/.MainActivity -e test close
    • Pair adb shell am start -n xie.morrowind.tool.btassist/.MainActivity -e test pair -e device [device name]
    • Unpair adb shell am start -n xie.morrowind.tool.btassist/.MainActivity -e test unpair -e device [device name]
    • Search adb shell am start -n xie.morrowind.tool.btassist/.MainActivity -e test discovery -e device [device name]
    • Name adb shell am start -n xie.morrowind.tool.btassist/.MainActivity -e test rename -e name [new name]

Where [device name] is the name of the Bluetooth device that needs to be paired/depaired/searched; [new name] is the name that you want to rename.

  • After entering the command on the terminal, the terminal will immediately return to the command prompt. At this time, you can loop to check whether the result file (/sdcard/bluetooth.txt) is generated on the mobile phone's memory card. If there is no such file, it means that the command is still being executed. Otherwise, it means that the command has been executed and the execution results will be stored in the following format. In this file:
    • First line: command name;
    • The second line: execution result, success is 1, failure is 0;
    • The third line: additional information, such as the reason for failure, etc., may be empty.

Note: The pair matching function needs to meet the following conditions before it can be used:

  • Re-sign the apk using the phone's system signature (the default compiled signature is the one that comes with the SDK).

Original in Chinese

这是一个安卓应用,用来辅助测试蓝牙设备。

它可接收adb shell发送的指令,帮忙代理执行手机上的蓝牙功能:

  • (open)开启蓝牙
  • (close)关闭蓝牙
  • (pair)与指定的蓝牙设备配对
  • (unpair)解除与指定设备的配对
  • (discovery)搜索指定的设备是否在线
  • (rename)修改本机蓝牙名称

编译方法:

  • 下载工程代码
  • 导入Android Studio编译运行即可

安装方法(Win/Mac/Linux):

  • adb shell install -r [apk的路径]

使用方法(Win/Mac/Linux):

  • 打开电脑上的终端,输入如下任意指令:
    • 打开 adb shell am start -n xie.morrowind.tool.btassist/.MainActivity -e test open
    • 关闭 adb shell am start -n xie.morrowind.tool.btassist/.MainActivity -e test close
    • 配对 adb shell am start -n xie.morrowind.tool.btassist/.MainActivity -e test pair -e device [device name]
    • 解配 adb shell am start -n xie.morrowind.tool.btassist/.MainActivity -e test unpair -e device [device name]
    • 搜索 adb shell am start -n xie.morrowind.tool.btassist/.MainActivity -e test discovery -e device [device name]
    • 命名 adb shell am start -n xie.morrowind.tool.btassist/.MainActivity -e test rename -e name [new name]

其中[device name]为需要配对/解配/搜索的蓝牙设备名称;[new name]为想要重命名的名字。

  • 在终端上输入命令后,终端会立刻返回命令提示符。此时,可以循环检查手机存储卡上是否生成了结果文件(/sdcard/bluetooth.txt),若无此文件,说明命令还在执行中,否则说明命令已经执行完毕,执行结果会按如下格式存储在此文件中:
    • 第一行:指令名称;
    • 第二行:执行结果,成功为1,失败为0;
    • 第三行:额外信息,譬如失败的原因等,可能为空。

:pair配对功能,需要满足如下条件才可使用:

  • 使用手机的系统签名对apk进行重新签名(默认编译出来是sdk自带的签名)。

About

BluetoothAssistant is an Android application that bridges command line commands from Linux/Windows/Mac Operating Systems to Android devices over adb

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published