Troubleshooting & FAQs

• General
  • The part number (PN) printed on my module does not match with the one on the website
• Power & Hardware
  • I’m powering through a USB port and my array is behaving strangely or constantly rebooting
  • I don’t see the LED indicator blinking when I power my module
  • I reversed power connection on my module.. Is it dead?
  • I applied more than 3.5V on my module.. Is it dead?
  • Can I power my module from a single-cell Lipo (Lithium) battery?
  • I’m using H04R1x (2 x coin cells in parallel) to power my module and it’s acting strangely
  • How do I reset my module MCU without removing power?
• Updating Firmware
  • How do I know if my module has already a firmware on it?
  • How do I find out which firmware version is installed on my module?
  • Where can I find latest firmware?
  • Where can I find older firmware releases?
  • Firmware update failed / my module has a broken firmware. Is it dead?
  • ST Flash Loader software cannot connect with the factory bootloader
  • How do I update firmware on a module if bootloader programming port is not accessible?
  • Can I update firmware on the entire array at once?
  • Remote update is not working
  • How can I update module firmware by booting into ST factory bootloader?
• Command Line Interface (CLI)
  • Does using the CLI affect normal module operation and inter-array communication?
  • Q: Can I open more than one CLI in my module and my array?
  • Can I use the CLI at a lower baud rate?
  • Can I delete a letter I entered in the CLI?
  • If I create a new module group, where can I see group name and members?
  • If I named a module, where can I see its alias name?
  • Are CLI commands case-sensitive?
  • How do I change the order of execution for command snippets?
• Array Exploration & Topology
  • How do I make my modules talk to each other?
  • How do I know if my module is a part of a defined array?
  • Can I use “explore” if a fixed topology is defined?
  • Array exploration failed
  • Do I need to repeat exploration each time I use the array?
  • Does the array auto-detect changes its topology?
• Array Communication
  • What criteria is used in routing messages?
  • How do I execute a CLI command on a remote module?
  • How do I execute an API on a remote module?
  • Can I send a message to a group of non-adjacent modules?
  • What happens if I send a message with a wrong message code?
  • What happens if I send a message with wrong parameters?
  • How do I reduce message collisions?
  • What is the appropriate delay between two consecutive messages?
• Writing Code
  • Where should I add my code?
  • What are the best practices to keep my code easily portable to future releases?
  • Do I need to understand MCU hardware and Hexabitz backend to write my own application code?
  • Do I need to understand FreeRTOS to write my own application code?
• Cloning Firmware
  • I cloned/downloaded module repository but the BOS and Thirdparty folders are empty
  • Do I need to clone BOS and Thirdparty git repositories?
  • The firmware I cloned does not compile correctly
• Compiling Firmware
  • What are the preprocessor compiler constants I need to define if I’m using a different tool chain?
• Debugging Firmware
  • The debugger is not able to connect to my module
  • Sometimes the debugger does not stop on my break points
  • I can’t add a variable to “watch” window
  • My code is stuck in the for loop inside vApplicationStackOverflowHook() function
  • My code is stuck in the for loop inside vApplicationMallocFailedHook() function
  • How can I find current stack usage for a particular task?