Home > Uncategorized > Updating Raspbian to Make HubPiWi Blue work

Updating Raspbian to Make HubPiWi Blue work

November 28th, 2016

At the time of writing the native support for HUbPiWi Blue it is not included in Raspbian. We expect that it should become a part of the raspbian in near future, but we are not sure when. We highly recommend that you post this requirement to the SW group of the raspberry Pi foundation and into the Pi Zero forum which will hopefully speed up the process of native support in Raspbian.

In the meantime you will have to update the raspbian to make the HubPiWi Blue work.

You need a network access to be able to do that. You can possibly hook a USB Wifi dongle to the existing HubPiWi Blue to create Wifi Connectivity temporarily.

We understand that this is not a clean solution. We will propose some better solution, including a pre modified binary or a Pre Programmed SD Card on sale. But for now the tweak to the raspbian to make HubPiWi Blue work.

You will first need to update the current software

sudo apt-get update
sudo apt-get upgrade
sudo apt-get dist-upgrade
sudo reboot

HubPiWi Blue uses Realtek 8723BU chipset and the following set of commands are specific to it.

cd ~/
git clone https://github.com/Diagonactic/rtl8723bu.git
sudo apt-get install raspberrypi-kernel-headers
cd ~/rtl8723bu
sudo make install
sudo insmod 8723bu.ko

If you now run the commans


You should be able to find Wifi. Now remove the Wifi Dongle and reboot the Pi Zer and you should be able to see that the Wifi Work.

Bluetooth Support

You need to follow the following steps for bluetooth support.

cd ~/
git clone https://github.com/lwfinger/rtl8723au_bt.git –b kernel
cd rtl8723au_bt.git
sudo make install
sudo insmod btrtl.ko
sudo insmod btintel.ko
sudo insmod btbcm.ko
sudo insmod btusb.ko


Many thanks to Matthew Dippel for providing support for HubPiWi Blue. The Steps in this blog has been taken directly from his detailed blog here.


  1. Havensal
    November 30th, 2016 at 15:33 | #1

    I get the below error when trying to install BT

    pi@raspberrypi:~ $ git clone https://github.com/lwfinger/rtl8723au_bt.git –b kernel
    Too many arguments.

  2. Jim Z
    December 5th, 2016 at 20:48 | #2

    When I try to do the bluetooth support I get an error "too many arguments" when I do the

    git clone https://github.com/lwfinger/rtl8723au_bt.git –b kernel

  3. BHawthorne
    December 18th, 2016 at 20:07 | #3

    Under the Bluetooth Support needs fixed for errors:

    2 | git clone -b kernel https://github.com/lwfinger/rtl8723au_bt.git
    3 | cd rtl8723au_bt

  4. Bruce Ratoff
    December 22nd, 2016 at 16:33 | #4

    Installing the rtl8723bu wifi driver worked great and connected to my wlan.
    Two problems though:
    1 - Apparently two wlan interfaces get created - wlan1 connected to my ssid on my normal subnet, wlan0 connected to my router's maintenance address. How can I prevent this?
    2 - Everything stopped working when I added the bluetooth modules. The system would just keep searching for an AP and never find one. The system also seemed to be hanging for a few seconds every minute or so.

    And yes, I did upgrade in place to the latest distro as per the instructions.

    Any ideas/suggestions?

  5. Simon
    January 1st, 2017 at 10:37 | #5

    having a few problems, my pi zero running pixel is picking up wlan0 and wlan1?
    im able to use the desktop to connect to my WiFi but it never gets an IP address?
    and when i restart the pi zero too, then wifi icon then shows wlan0 and wlan1, both showing the same WiFi networks???

  6. Simon
    January 1st, 2017 at 13:48 | #6

    ive also found out too, that the WiFi Chip is setup for 2 wlans as default, one as client, one as access point, if you follow the original github repo - https://github.com/lwfinger/rtl8723bu you can change it to setup only 1 wlan as client

  7. February 10th, 2017 at 02:14 | #7

    Hi! I'm stuck... been trying many times, including reinstall Raspbian, trying older version of Raspbian... I stuck with this same error:

    make ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- -C /lib/modules/4.4.32-aufs/build M=/home/pi/rtl8723bu modules
    make[1]: Entering directory '/lib/modules/4.4.32-aufs/build'
    make[1]: Nothing to be done for 'modules'.
    make[1]: Leaving directory '/lib/modules/4.4.32-aufs/build'

    When I run "make"

  8. PRSenn
    April 3rd, 2017 at 10:45 | #8

    When I try to clone from github I get a request for username for https://github.com
    Is it asking for LW Finger's account, Matt Dippel's account or my account?

  9. admin
    May 10th, 2017 at 14:03 | #9

    It is your account. Create an account if you do not have one.

  10. Bruce R
    January 17th, 2018 at 16:35 | #10

    I can't get the drivers to build with Stretch (4.9.77+).
    Make gives the error "/lib/modules/4.9.77+/build: No such file or directory"

    I have already installed raspberrypi-kernel-headers to the latest version, but that doesn't create the "build" symbolic link. I could create the link if I knew what to point it to. Or is the problem elsewhere?

    Any ideas would be appreciated.

  11. Bruce R
    January 18th, 2018 at 11:15 | #11

    @Bruce R
    I dropped back down to 4.9.59+ and am able to build and install the rtl8723bu module. After a reboot, it connects to my network and I am able to run a browser for a few minutes, but then the WiFi adapter disappears from the USB device list. The USB hub remains connected and the devices plugged into the USB ports remain active, but the rtl8723bu is gone until the next reboot.

    Given the limitations of the Pi Zero and the fact that the browser consumes 100% of the processor most of the time, I wonder if the problem could be some sort of timeout in the USB protocol?

  12. Tchernobil
    March 26th, 2018 at 04:59 | #12

    Please, on this page, correct this line:
    git clone https://github.com/lwfinger/rtl8723au_bt.git –b kernel
    The "–" id not correct, it's suppose to be "-". (shorter dash)
    Thank you

  13. Tchernobil
    March 26th, 2018 at 05:01 | #13

    cd rtl8723au_bt.git
    is suppose to be
    cd rtl8723au_bt

  14. Tom2112
    April 3rd, 2018 at 13:15 | #14

    When installing the HubPiWi Blue on Raspian Stretch Lite, I found I had to install git:

    sudo apt-get git

    And then follow the directions from this webpage under #8 (right hand column):

    I struggled with a couple of the steps there. One of them was this command:
    sudo apt-get install git build-essential linux-headers-$(uname -r)

    When I entered that command, I got errors. So I tried it without the "-$(uname -r)" on the end, and Raspian told me to that I needed to be specific about which version to install and showed me the versions available. So I picked the highest version number and installed that one with this command:

    sudo apt-get install git build-essential linux-headers-3.10-3-rpi

    Also, one of the steps from that webpage that gave me trouble was the sed command to change the Makefile. I ended up editing the /rtl8723bu/Makefile in nano. About 21 lines down, put a # in front of this line:


    so that it reads:

    Just to mention it, when you run the "make" to compile the driver, it will take a LONG time. I didn't time it, but it was at least an hour on a Raspberry PiZero v1.2.

    I hope that helps anyone trying to get this interesting little pHAT running with their Pi. 🙂

  15. ko4xl
    March 18th, 2019 at 20:58 | #15

    @Tom2112 - to get the correct kernel headers from apt, the command you want is:

    sudo apt-get install raspberrypi-kernel-headers

    This will install the correct linux-headers-* for your environment.

  16. Tom
    April 27th, 2019 at 05:43 | #16

    Thank you!

  17. Tom
    April 27th, 2019 at 05:46 | #17

    For anyone stumbling across this page later (myself included because I keep forgetting how to do this), here are instructions how to get the HubPiWi Blue to work with the latest Raspian (April 8 2019, kernel v4.14):

    sudo apt-get update
    sudo apt-get upgrade
    sudo apt-get dist-upgrade
    sudo apt-get install raspberrypi-kernel-headers
    git clone https://github.com/lwfinger/rtl8723bu.git
    cd rtl8723bu
    nano Makefile

    Change the line that reads:
    Then save it.

    sudo make install
    sudo modprobe -v 8723bu
    sudo nano /etc/modprobe.d/50-rtl8xxxu.conf

    Enter this single line in the file you're creating, then save it:
    blacklist rtl8xxxu

    Reboot your raspberry pi.

  1. No trackbacks yet.