Install Hassio On Docker

what's so cool about it..

Apr 22, 2020 All right, everything is ready, so you can now install Docker with: apt-get install docker-ce docker-ce-cli containerd.io Then, to verify that Docker was installed correctly, you can run the command: docker run hello-world The last thing that you want to do before installing Hass.io is to make sure that Docker starts when the server boots. Install python; Use python -version to be sure, that you are running python 3 or above! If you are NOT running 3.4 or higher, you need to install pip, too. Install dependencies with pip install pyserial intelhex; Download the cc2538-bsl.py file or just clone the repo. May 18, 2018 Now you just have to wait a good long while as HASSIO installs (well sorts out the docker images at least) Note: The first start of HASSIO will take some time, the entire process from scratch on my Pine64 (2GB RAM model) took around 30-40 minutes to get it all installed. Sometimes you have to execute commands on your Home Assistant server. For this, as in many other devices, there is the option of remote access by SSH (Secure Shell). This gives us the option to recover our server in the event of a failed configuration or execute commands at a low level to have greater control and be able to perform actions that would otherwise be impossible.

  • super tiny CC2652RB multiprotocol 2.4 GHz development stick
  • Ideal as ZigBee coordinator/router or as an OpenThread border router
  • Low power capable for building battery powered devices
  • Plug & Play, comes pre-flashed
  • Deadly easy programming, thanks to the automatic-bootloader thing! ;)
  • Made with here in Cologne

Install to SATA, eMMC, NAND or USB. (Document management system within Docker. Transmission lamp tvheadend plex-media-server openhab radarr ispconfig nas hassio.

projects realized..

The Stick¶

Get one¶

We are in stock!

  • Usually shipps within 1-2 day(s)
  • .. from within Europe, Germany, Cologne!
  • Pin-Headers are ONLY needed if you want to develop custom-firmware!

* taxes may apply
* excl. shipping-fees

We accept a ton of payment-methods. But if you preferr something else or it isn't working, just use the 'Pay later'-method. You will get an email afterwards, with additional options like bank transfer..

Resellers¶

Install Hassio On Docker

Or choose one of our Resellers in your country:

Netherlands


Thailand

  • also worth his YouTube channel


Antenna types¶

Dimensions¶

Fully assembled with the smallest antenna its around 7cm longs.

The whole stick itself measures around 50x14mm.

The CC2652RB breakout part will be around 18x14mm.

It's smaller than a CR2032 coin cell! And can easily powered by one for multiple years

Pinout¶

Nearly all free usable pins of the CC2652R are accessable through the pin-headers.

2x12 and 1x9 1.27mm pin-headers

LEDs¶

  • Blue: general purpose (GPIO6)
  • Orange: general purpose (GPIO7)
  • Green: power LED (3V3)

Antenna¶

It can be shipped in two antenna-options:

  • SMA-connector (female, whole) -> so you can use any SMA (male, pin) antenna!
  • on-chip antenna

ZigBee coordinator¶

Hint

Now officially listed on https://www.zigbee2mqtt.io/information/supported_adapters.html#slaeshs-cc2652rb-stick

Docker

It's easy to use with the popular zigbee2mqtt project from koenkk!
Many thanks to him and his awesome work!
After getting my fixed costs, we will reward him with every sold ZigBee-stick!

Info

You can just replace your less powerfull CC2531/CC2538 or what ever stick you used before..
.. with this new powerfull CC2652R device!

Warning

For the images the stick is plugged into the PC/Pi directly to show its dimensions. Better DO NOT do it like this, use a USB-Extension cable instead!!
See further explanation here.

Installation¶

Firmware¶

Download¶

If you already oredered it with the correct firmware, skip this and continue here.

Download the correct FW, using the z-stack firmware 3.x.0:

from koenkk¶

COORDINATOR

ROUTER

In both cases, we will need the CC2652 **RB file.**

Download and extract.

from me¶

This is just for debugging purposes.. Or if you like LED's ;D

Download this firmware file znp_CC2652RB_20200715.bin.

Main difference to koenkk's version:

  • LED's (blue and orange) are turned ON at startup.
  • the orange one will blink on each received UART character.
Flash¶

Use this guide below.

zigbee2mqtt¶

Just start it as usual. See the following documentation: https://www.zigbee2mqtt.io/#getting-started

Warning

When migrating from another dongle (e.g. CC2531), make sure to modify your pan_id in your configuration, otherwise Zigbee2mqtt won’t start.
If there is no entry pan_id, please create one using any other number than 0x1a62! This is the default one, if there is no one setup.
You have to re-pair your devices then, cause we created a new network.

Homeassistant / Hass.io¶

There is this super cool hassio add-on from danielwelch!

Which let's us use the zigbee2mqtt as an easy to use add-on.

Here is a really good installation guide.

Warning

As described above, we need to take care to use at least version 1.14.2 of koenkk's zigbee2mqtt!

Hint

Do not use /dev/ttyACMx. This will use different linux-drivers..

Warning

Another thing we need to take care of, is to use the 'long' serial-port names!
Do NOT use the syntax like /dev/ttyUSBx.
Instead use the one like /dev/serial/by-id/usb-Silicon_Labs_slae.sh_cc2652rb_stick_-_slaesh_s_iot_stuff_00_12_4B_00_21_A8_E3_95-if00-port0!
Why should we do this?
Cause the serial-port using the enumerated-syntax can (and may will) change!
Using the /dev/serial/by-id/.... syntax will never change.
And docker, or the running linux, will find the correct associated serial-port for our device! ;)
How can we check the correct name?
Go to the Hass.io/Supervisor-tab, go to System and click on the Hardware-button.
And please do this for all other USB-devices you are using, even in other add-on's. :)

OpenThread border router¶

You can also easily use it as a OpenThread border router!
Together with the use of wpantund you can control and publish your local OpenThread network.

wpantund will connect to the stick flashed with the OpenThread border router FW and will create a local network interface! this can then easily be used to communicate to OpenThread devices simply by using their IPv6 addresses

Installation¶

Just flash the following file:

as described here.

One of the LEDs will slowly blink while running.

Flashing¶

There are multiple ways to flash:

  • JelmerT's serial bootload toolrecommended
  • TI's flashing tool UniFlashv6.x.x or higher!
  • TI's flashing tool SmartRF Flash Programmer2
  • Using a JTAG-Adapter

Serial bootloader tool¶

automatic bootloader

You dont have to put the CC2652RB manually into the bootloader mode
Its done by the tool automatically!
So no need to reopen the enclosure for flashing..

Determine com-port¶

On windows, use this in a Powershell:

On linux, use this:

flash it¶

  • Install python
  • Use python --version to be sure, that you are running python 3 or above!
  • If you are NOT running 3.4 or higher, you need to install pip, too.
  • Install dependencies with pip install pyserial intelhex
  • Download the cc2538-bsl.py file or just clone the repo.
  • Open the directory containing the python-script
  • Open a command line there or just navigate into the folder
  • Type in this command to flash your image to the stick:

Info

-e will erase the chip
-w writes the file into flash
-v will verify the checksum

Smart RF Flash Programmer2¶

To use this tool, we need to put the Chip manually into the Bootloader.

This is done by pressing the buttons in a specific way:

  • Press and hold the bootloader-enable button (nearest to the chip, marked with small 'BL')
  • Just press/click the reset-button (nearest to the usb-connector, marked with small 'RST')
  • The bootloader-pin can be released.

The Chip will check during the startup the bootloader-enable-pin. If its 'set', the bootloader is executed. Otherwise the Application would start!

check disable bootloader checkbox

Do NEVER EVER click the Checkbox called 'disable bootloader'.
Otherwise we aren't able to flash again!
Please just take a quick look everytime, that it is NOT checked! ;)

Development¶

This stick is a great starting point if you want to get in touch with the 2.4 GHz technologies:

  • ZigBee
  • OpenThread
  • Bluetooth 5 (BLE)
  • any custom RF protocol based on IEEE 802.15.4

You can get ready in just a few minutes and send your first packets through the air!! =)
.. and thats really satisfying ;D

Enviroment¶

There is at least one way to programm and debug the CC2652R devices:

  • CCS - Code Composer Studio from TI

You can download the latest version here.

It shippes with so many example projects! For all possible protocols.

BOOTLOADER SETTINGS

TAKE CARE WHILE FLASHING!
To use the auto-bootloader and flashing via USB you need to take care that the embedded bootloader is enabled and the Backdoor-Pin is routed to GPIO-Pin 13 and active low !
Otherwise it's not possible to flash via USB!!

My blinky demo can be found here.

Trouble shooting¶

Checking the functionality and reading fw-version¶

To test the stick just run this scipt: https://github.com/slaesh/cc2652-stick/tree/master/coordinator-test.

Install Hassio On Docker Command

Maybe do it twice, if it fails the first time.

zigbee2mqtt isn't working¶

koenkk and i needed to add some code to work properly, cause of the auto bootloader schematic.

So first of all, check which version of zigbee2mqtt you are running currently! See those hints.

If updating is not resolving your issue, please download this firmware for the stick.

And flash it using the guide above.

This FW is a coordinator, too. But will turn both LED's (blue and orange) ON at startup!

The orange one will blink everytime the stick receives any character via UART.

So we can use this for debug purposes:

  • Plug the Stick -> LED's should be both ON!
  • Start zigbee2mqtt
  • If both LED's will turn off during starting zigbee2mqtt we don't have the correct version or some bad settings!
  • Check your configuration.yaml to NOT include rtscts: true in the advanced section.

Still struggling? just get in touch with us via Telegram !!

Install Hassio Docker Synology

can't get any serial debug messages¶

Your serial monitor need to release RTS and DTR.

Like on a unix-system, using miniterm:

Will open the ttyUSB1 with a baurdrate of 230400.

The RTS signal is connected to the RESET-Pin and DTR is connected to the Bootloader_Enable-Pin!
If you dont wan't this behavior, you can destroy/cut the solder-pads underneath..

HW files¶

Licenses¶

Install Hassio On Docker Raspbian

Hardware License: Solderpad 2.0
Software License: GPL v3
Documentation license: CC BY 4.0

Install Hassio Docker Raspberry Pi

Contact¶

Emails are hard to track and are getting messy real quickly..

Installing Hassio On Docker On Raspberry Pi

So just text us on Telegram for any requests and technical support!