Where is the documentation on the production configuration for Zigbee

[IanAber]

I found the utility to create the binary image of the production data for my Zigbee device but cannot find any documentation on how to incorporate the generated BIN file into my project using Segger Embedded Studio. I am new to Segger having just installed it to work with the nRF52840 but I suspect this information is more a Nordic SDK thing than a generic Segger configuration. In addition, the utility only seems to be provided in a Windows executable which makes it problematic to use in a Macintosh environment. 

First of all; Where can I find documentation or simple instructions on how to get the resultant BIN image into my HEX file for download to the nRF52840.

Secondly; Is the source code for the configuration utility available? I would be happy to take it and try to compile a version that will run on the Mac then provide you with the result. The best way would be to rewrite it in Java so it would run on anything.

In general I am having some real challenges with the documentation for the Zigbee stack. There are many places where the descriptions of the various functions are missing or so brief that they tell us nothing about what the intention of the function really is. There are many references to example code but searching the support and devzone sites reveals nothing matching the link or description provided. Am I missing something here? Is there some other document that goes into the API in a more informative way than simply a list of function names, typedefs and structure definitions? As an example there is a function called zb_zdo_bind_req which suggest that one should see the tp_zdo_bv-12 sample but I can fine no link to any such sample. The example code provided in the API documentation does not appear to work and when calling the function the system never returns. I am not at all sure if this is a function I should be trying to use but there is nothing in the documentation that would tell me what it is used for or what its limitations might be. Where can I find more on this? Should I be looking to the ZBOSS documentation and if so where can I find that?

tp_zdo_bv_09

[Jørgen Holmefjord]

Hi,

You should be able to convert the bin file into a hex file using the ARM GCC tool with the following command:

arm-none-eabi-objcopy -I binary -O ihex filename.bin filename.hex

You can then merge this with your application hex-file using mergehex tool from nRF5x Command Line Tools.

I do not think we have source code available for the configuration utility, but I will check with our Zigbee developers.

Best regards,
Jørgen

[IanAber]

If not the source code what about the spec for the actual hex file? It looks like a simple enough program that I could just create it from scratch.

Thanks for the hints though. Did I miss this in the documentation? I searched but failed to find it myself. I am still learning my way around your system.

[Jørgen Holmefjord]

I just heard back from our developers. The Production config tool have been re-implemented and can now be found in the master branch of nrfutil. Documentation is missing from GitHub, but I have included it here:

You can generate the production configuration hexfile with the `nrfutil` utility, which takes the production configuration yaml text file and generates the binary in Intel hex format out of it.

Example of yaml input

@code
channel_mask: 0x00100000
install_code: 83FED3407A939723A5C639B26916D505
extended_address: AABBCCDDEEFF0011
tx_power: 9
app_data: 01ABCD
\endcode

Apart from the system part parameters, the production configuration includes the application configuration `app_data` made of three bytes: 0x01, 0xAB, 0xCD.