Build Instructions

Collapse

• 1

  get required software

  I assume you are familiar with the Arduino IDE and have it installed on your PC.

  Download CCLib from
  https://github.com/kirovilya/CCLib

  This is the firmware for your custom, ESP8266 based programmer
  

  Download CC2531 Firmware
  

  You can use either
  

  https://github.com/Koenkk/Z-Stack-firmware/raw/master/coordinator/CC2531/alternatives/max_devices/bin/CC2531ZNP-Prod_20181119.zip
  

  or

  https://raw.githubusercontent.com/kirovilya/files/master/CC2531ZNP-Pro-Secure_LinkKeyJoin_mod.hex
  

  On Linux, you can simply download it by typing

  wget https://raw.githubusercontent.com/kirovilya/files/master/CC2531ZNP-Pro-Secure_LinkKeyJoin_mod.hex

  I installed and verified both versions to be working. Hence I have attached them to this project.
  

  If you download the CC2531ZNP-Prod.hex from here (hackaday.io) you do not have to modify the file!
  

  Important note: 

  When using the arduino based CCLib_proxy debugger/programmer as described here, the custom firmware (CC2531ZNP-Prod_20181119.zip) from Koen Kanters, has to be modified. Otherwise you will not be able to flash it!

  The modification is really simple: 

  Unzip the archive and open the .hex file in a text editor of your choice.

  Scroll to the very bottom of the file and remove the second line from the bottom. In the .hex file above, the according line is

  :0400000500002D6F5B

   Just save the file and you are good to go.

  You will also need Python 2.7 or later installed to your system.
  

  Once you've downloaded/unzipped CCLib, open a terminal and change directory into the Python folder
   
  

  cd CCLib/Python/
  
  

  Now, install the required python modules by typing:
  
  

   pip install -r requirements.txt 

• 2

  Prepare your wemos d1 mini board

  Install the Arduino/CCLib library to your arduino IDE

  Open the CCLib_proxy.ino from CCLib/Arduino/CCLib/Examples/CCLib_proxy

  I have uploaded my modified version  of the arduino sketch to hackaday.io.
  If you have downloaded the CCLib_proxy.ino  linked above you can skip the following code modification.
  

  Modify the code:

  Specify the correct Pins for the ESP8266 / Wemos D1 mini
  

  This is important, since it makes a big difference which Pins you use! I was not able to make the programmer work when I initially used other pins. After more than an hour experimenting I found this configuration to be working flawlessly out of the box.
  

  See approx. line 37
  

  // Pinout configuration (Configured for wemos D1 mini)
  int CC_RST   = D5;
  int CC_DC    = D7;
  int CC_DD_I  = D6;
  int CC_DD_O  = D4; 

  
  Then, look for the first delay()  at approx. line 98 and increase the initial value (50) to 1000:

  Again. this is needed for the ESP8266 / wemos d1 mini / nodeMCU to get it working

  at approx. line 98:
  

    // Wait for chip to initialize
    delay(1000);

  When using an arduino uno/nano/... you probably don't have to change the delay.

  Once you have modified the code, compile and upload it.

• 3

  Connect your CC2531 Adapter

  Once you've compiled and  uploaded the CCLib_proxy to your wemos d1 mini board, unplug it from the USB bus.

  Now, get some (actually 5) jumper wires and connect your ESP board to the debug port of your CC2531 adapter. Since  the ESP uses 3.3v, you don't need a voltage divider!

  Please note:

  In contrast to your common breadboard / connector, the debug port on the CC2531 has a smaller spacing of 1mm. In order to connect your wires, you can either use the linked Debugger Cable or carefully connect your SMD probes to the tiny pins. I've seen a couple of people destroy their debug port / breaking pins by handling it too rough. These small pins are really pretty fragile! So take care when not using the small spaced connector cable.

  Note, that on the wemos/ESP side, D6 ( DD_I ) and D4 ( DD_O ) are connected together and go to Pin 4 ( DD / Debug Data ) on the CC2531 debug port.

  You only need to connect these four Pins on the CC2531:

  1 - GND
  

  3 - DC (Debug Clock)

  4 - DD (Debug Data)

  7 - Reset 
  

  If the stick lies in front of you, the USB-Port facing to the left, Pin 1 is the one on the top right of the 10 Pin programming header.
  

View all 6 instructions