BeeChat executable

BeeChat.jar v.0.1 - April 1st 2020


Dongle setup

Step 1: gather the parts.
From left to right: Sparkfun Dongle, XBee module, RP-SMA converter, 2.4Ghz antenna

Step 2: connect the Sparkfun dongle to the XBee module as pictured below.
NOTE: make sure the antenna connector is on the opposite direction of the USB port.

Step 3: connect the RP-SMA converter to the XBee module as pictured below.

Step 4: Connect the RP-SMA antenna of your choice to the XBee module.

Step 5: Download and install the XCTU configuration tool by Digi here.

Step 6: Open the newly installed XCTU program and click on the second button from the top left, as shown on the picture.

Step 7: XCTU should show something as in the picture below. If so, it means it has successfully found your XBee module and just click next.

Step 8: Select the settings as in the picture below and click Finish.

Step 9: XCTU should now show your module on the left. Click it.

Step 10: Wait for XCTU to load your XBee's settings.

Step 11: Set the PAN ID (Channel) to a number of your choosing. Also, set a device role for your module. If this is the first device in your area, select "Form network". If not, select "Join network".

Step 12: On the search bar at the top, type "AP" as shown on the first red arrow below. Then, change the AP to "API Mode without Escapes" as in the picture below.

Step 13: Write these changes to the XBee module by pressing the button as on the image below. After that, you are ready to use the BeeChat software!

BeeChat Software

Installation Guide

Linux installation



  1. Download & Install all requirements listed above.
  2. [OPTIONAL] If you want to try the DeepSpeech experimental feature, download the pre-trained AI models at the Mozilla DeepSpeech GitHub.You will need to extract the “deepspeech-0.6.1-models.tar.gz” file into a folder, and copy the files “trie”, “output_graph.tflite”, “output_graph.pbmm”, “output_graph.pb” and “lm.binary” into the BeeChat.jar. To do that, just open the BeeChat.jar with any file archiver that supports .jar files and drag the files into the .jar. That’s it! your BeeChat can now run DeepSpeech.
  3. [OPTIONAL] If you are using BeeChat through a Virtual Machine, you will have to make the following command on the terminal:

    sudo ln -s /dev/ttyS2 /dev/ttyUSB0

  4. Open the terminal in the folder where the BeeChat.jar is located and type in:

    java -jar BeeChat.jar

  5. That’s it! You should now follow the on-screen instructions.

If you are getting errors please post a new topic on the forum.

Windows installation

These instructions show you how to install a lightweight and intuitive
Linux OS so that you can use the device from within your Windows


  • Download & install the Oracle VirtualBox software: VirtualBox 6.1.4
  • Download the Drivers for your Windows Computer to detect your
    BeeChat Device. You can download the drivers here: Download FTDI VCP Drivers
  • Download Lubuntu or any lightweight Debian-based distro. 
  • Around 15 GB of free space (NOTE: the virtual machine may take up a lot less
    space, and it does not use up the space immediately upon creation).
  1. Set up the Virtual Machine. To do so, open the newly installed VirtualBox
    software, click on the “New” button. Now follow the steps. Be sure to give it
    around 15 GB of storage for proper functioning. If this is hard for you, click on
    the “Guided Mode” option instead of the Expert Mode, meant for easy setup.
  2. Once you have created the Virtual Machine, open up that machine’s Settings
    and navigate to Storage > Controller:IDE > Add optical drive. Now navigate to
    your downloaded Linux setup file. (it should be in .iso file format).
  3. Next, go to the Serial Port section in that Virtual Machine’s Settings.
    Check Enable Serial Port. It should look similar to the picture below:
  4. Now you are ready to:
    1. Start your Virtual Machine.
    2. Install your Linux OS.
    3. Download & Run the BeeChat software with the Linux
      instructions on the top of this page.