BBRemote is an Android application that allows your phone to be used as a input device for a Windows computer. It supports use of the phone as a touchpad, keyboard, or game controller. To use BBRemote, you need both the Android application as well as the Windows Driver installed.
- Install android apk from BBRemote/BBRemoteMobile/app/app-release.apk
- Turn on bluetooth on your android device
- Start the BBRemote app
- BB Remote uses custom drivers that are unsigned. In order to install unsigned drivers, you must boot up your computer with special settings. Hold down Shift and restart your computer. When the menu comes up, press:
- Troubleshoot
- Advanced Options
- Startup Settings
- Restart
- When prompted, press 7 (disable driver signature enforcements)
- The installer uses a command installed in the Windows Driver Kit. If you do not have this, you need to download it.
- Run the file "BBRemote\BBRemoteDesktop\install.bat" with Admin priveleges.
- If a warning pops up, click allow
- Open Device Manager
- If there is no section titled "BB Remote":
- Open a command prompt with Admin priveleges
- cd to "BBRemote\BBRemoteDesktop"
- run:
"C:\Program Files (x86)\Windows Kits\10\Tools\x64\devcon.exe" install BBRemoteDrivers\x64\Release\BBRemoteDrivers.inf Root\BBRemoteDrivers
- If a warning pops up, click allow
- In Device Manager, open the "BBRemote" list
- If there is a warning with the device:
- Right click the device
- Click "Update Driver Software..."
- Click "Browse my computer for driver software"
- Click "Browse..."
- Navigate to "BBRemoteDrivers\x64\Release"
- Click "OK"
- Click "Next"
- If a warning pops up, click allow.
- Run "BBRemote\BBRemoteDesktop\app\x64\Release\app.exe"
- Launch the desktop client's app.exe
- Launch the mobile client's BBRemote app
- Choose a paired device to connect to
- If there are no paired devices, choose an unpaired device to pair to
- Once paired, select the device to connect
- You will be taken to the Keyboard input mode
- Type in keyboard mode or use the menu in the top right corner to change input modes or change settings
- Select Customize Gamepad from top right menu
- Add inputs by using the top right menu to select Customize -> Add Input
- Select the input you want to add from the displayed list
- Move the input by dragging it around
- Resize the input by performing a pinch gesture on the screen
- Delete an input by long-clicking on an input without moving it
- Save the layout by pressing Customize -> Save Layout from the menu
- Input a name that does not include the word default or a space
- Press save
- Delete a layout that you saved or loaded
- Press Customize -> Delete Layout from the menu
- Confirm deletion
- Load a layout
- Press Customize -> Load Layout from the menu
- Choose layout to load
- Install Android Studio from http://developer.android.com/sdk/index.html
- Open SDK Manager from Tools -> Android -> SDK Manager
- Select SDK Platforms from API level 19 to 23
- Install all selected platforms
- Under SDK Tools select
- Android SDK Platform Tools
- Android Support Library
- Android SDK Build Tools
- Android SDK Tools
- Install all selected tools
- Open the BBRemoteMobile project
- On your android device
- Open developer options
- Enable USB debugging
- Disable Window animation scale
- Disable Transition animation scale
- Disable Animator duration scale
- Plug you android device into your computer via a USB cable
- In Android studio's project explorer got to app -> java -> com.example.bbschool.bbremotemobile(androidTest)
- Right click any test and choose to run it
- Test results will be displayed in the bottorm windows.
The tests for the windows client is composed of two sets:
- Unit tests for the app, for attempted statement coverage
- Functional tests for the drivers, covering use cases for the Mouse and Keyboard drivers
Setup and usage information for the tests are as follows:
- Install Visual Studio from https://www.visualstudio.com/en-us/downloads/download-visual-studio-vs.aspx
- Open BBRemoteDesktop\app\app.sln
- Set the solution configuration to Release and the Solution platform to x64
- Click Build -> Build Solution
- Open BBRemoteDesktop\BBDesktopAppUnitTests\BBDesktopAppUnitTests.sln
- In the Solution Explorer, right click BBDesktopAppUnitTests and click properties
- In Configuration Properties -> Linker -> Input, ensure that Additional Dependencies include the following:
ws2_32.lib Xinput.lib User32.lib ..\..\app\x64\Release\app.lib BluetoothReceiver.obj NoInputProxy.obj DriverProxy.obj KeyboardProxy.obj GlobalFile.obj ModeSwitcher.obj MouseProxy.obj GamepadProxy.obj
- Set the solution configuration to Release and the Solution platform to x64
- Under the tab Test, click Test Settings -> Default Processor Architecture -> x64
- Under the tab Test, click Windows -> Test Explorer
- In the test explorer, click Run All.
- Note that the tests rely on the state of your mouse and keyboard. Refrain from touching your mouse and keyboard while the tests are running.