Message forwarding options

Message forwarding options include:

  • This option takes two arguments:
    resend_errordb -m meta_file_name

    This resends from the error database, but with modified metadata from a file. This file takes the same format as the SMAT metadata temp file.

    The message IDs that are used in the resend come from the metadata file. When using metadata, resend_errordb also supports resending multiple messages.

  • This option takes four arguments:
    resend_errordb -m meta_file_name msgfile_name len10|nl|eof

    This performs an error database resend using both message data and metadata from files. As with resend, if the number of messages in both files do not match, the command returns an error without resending any messages.

    If two or four arguments are used, then the first option must be -m or the command returns an error.

    Because resend_errordb takes from one to four arguments, the full form that is called from hcicmd is:

    hcicmd -p process_name -c ". resend_errordb mid"
    hcicmd -p process_name> -c ". resend_errordb -m meta_file_name"
    hcicmd -p process_name -c ". resend_errordb mid msgfile_name len10|nl|eof"
    hcicmd -p process_name -c ". resend_errordb -m meta_file_name 
    msgfile_name len10|nl|eof"
  • -n metadata_file_name option:

    hcidbdump enables dumping metadata from the error database into a file of the necessary format. The option for this is -n metadata_file_name.

    hcidbdump -n metadata_file_name -e -m mid output_file_name

    For example:

    hcidbdump -n meta.txt -e -m 0.0.1:0.0.9999 out.txt

    This generates the metadata file. This is meta.txt in the example. You can modify and use this as the second argument to resend_errordb.

  • Message encoding option:

    The message encoding option permits you to specify the encoding for the data file. If there is no encoding specified, then the API keeps the old behavior.

    If you only specify an MID to resend, then it is unnecessary to specify the encoding. The engine uses UTF-8 to do the resend.

    This command resends the message content in the specified format into the specified process. The run resend command line is:

    hcicmd -p process_name -c ". resend_errordb mid msgContent len10|nl|eof
    [-e msg_encoding]" 
  • save_start starts saving protocol messages:
    conn save_start {in|out} file
  • save_stop stops saving protocol messages:
    conn save_stop {in|out} 
  • save_cycle cycles the save message file:
    conn save_cycle {in|out}
  • show displays information about the alerts that are currently loaded by hcimonitord.
    show type

    Where type is one of:

    • all shows all loaded alerts.
    • alert name shows the alert named name.
    • group groupname shows alerts belonging to group groupname.
    • config file_name shows alerts loaded from the configuration file file_name. For example, default.alrt.
    • disabled shows alerts currently disabled by hcicmd commands.
    • enabled shows enabled alerts that have not been disabled by hcicmd commands.
    • window shows alerts currently in their active window.
    • window_not shows alerts currently not in their active window.
    • active shows alerts that are armed or fired.
  • THREADCTL controls the thread remotely. Uppercase is required.
    THREADCTL process_name threadname
  • xhold_post holds the post-xlate queue.
    xlt xhold_post conn 
  • xrel_post releases the post-xlate queue.
    xlt xrel_post conn

    To use these commands in a non-interactive manner, use-c with hcicmd.