git.sur5r.net Git - openocd/blob - src/hello.c

   1 /***************************************************************************
   2  *   Copyright (C) 2009 Zachary T Welch <zw@superlucidity.net>             *
   3  *                                                                         *
   4  *   This program is free software; you can redistribute it and/or modify  *
   5  *   it under the terms of the GNU General Public License as published by  *
   6  *   the Free Software Foundation; either version 2 of the License, or     *
   7  *   (at your option) any later version.                                   *
   8  *                                                                         *
   9  *   This program is distributed in the hope that it will be useful,       *
  10  *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
  11  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
  12  *   GNU General Public License for more details.                          *
  13  *                                                                         *
  14  *   You should have received a copy of the GNU General Public License     *
  15  *   along with this program; if not, write to the                         *
  16  *   Free Software Foundation, Inc.,                                       *
  17  *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
  18  ***************************************************************************/
  19
  20 #ifdef HAVE_CONFIG_H
  21 #include <config.h>
  22 #endif
  23 #include "log.h"
  24
  25 COMMAND_HANDLER(handle_foo_command)
  26 {
  27         if (CMD_ARGC < 1 || CMD_ARGC > 2)
  28         {
  29                 LOG_ERROR("%s: incorrect number of arguments", CMD_NAME);
  30                 return ERROR_COMMAND_SYNTAX_ERROR;
  31         }
  32
  33         uint32_t address;
  34         COMMAND_PARSE_NUMBER(u32, CMD_ARGV[0], address);
  35
  36         const char *msg = "<unchanged>";
  37         if (CMD_ARGC == 2)
  38         {
  39                 bool enable;
  40                 COMMAND_PARSE_ENABLE(CMD_ARGV[1], enable);
  41                 msg = enable ? "enable" : "disable";
  42         }
  43
  44         LOG_INFO("%s: address=0x%8.8" PRIx32 " enabled=%s", CMD_NAME, address, msg);
  45         return ERROR_OK;
  46 }
  47
  48 static bool foo_flag;
  49
  50 COMMAND_HANDLER(handle_flag_command)
  51 {
  52         return CALL_COMMAND_HANDLER(handle_command_parse_bool,
  53                         &foo_flag, "foo flag");
  54 }
  55
  56 int foo_register_commands(struct command_context *cmd_ctx)
  57 {
  58         // register several commands under the foo command
  59         struct command *cmd = COMMAND_REGISTER(cmd_ctx, NULL, "foo",
  60                         NULL, COMMAND_ANY, "foo: command handler skeleton");
  61
  62         COMMAND_REGISTER(cmd_ctx, cmd, "bar",
  63                         &handle_foo_command, COMMAND_ANY,
  64                         "<address> [enable|disable] - an example command");
  65         COMMAND_REGISTER(cmd_ctx, cmd, "baz",
  66                         &handle_foo_command, COMMAND_ANY,
  67                         "<address> [enable|disable] - a sample command");
  68
  69         COMMAND_REGISTER(cmd_ctx, cmd, "flag",
  70                         &handle_flag_command, COMMAND_ANY,
  71                         "[on|off] - set a flag");
  72
  73         return ERROR_OK;
  74 }
  75
  76 static COMMAND_HELPER(handle_hello_args, const char **sep, const char **name)
  77 {
  78         if (CMD_ARGC > 1)
  79         {
  80                 LOG_ERROR("%s: too many arguments", CMD_NAME);
  81                 return ERROR_COMMAND_SYNTAX_ERROR;
  82         }
  83         if (1 == CMD_ARGC)
  84         {
  85                 *sep = " ";
  86                 *name = CMD_ARGV[0];
  87         }
  88         else
  89                 *sep = *name = "";
  90
  91         return ERROR_OK;
  92 }
  93 COMMAND_HANDLER(handle_hello_command)
  94 {
  95         const char *sep, *name;
  96         int retval = CALL_COMMAND_HANDLER(handle_hello_args, &sep, &name);
  97         if (ERROR_OK == retval)
  98                 command_print(CMD_CTX, "Greetings%s%s!", sep, name);
  99         return retval;
 100 }
 101
 102 int hello_register_commands(struct command_context *cmd_ctx)
 103 {
 104         foo_register_commands(cmd_ctx);
 105
 106         struct command *cmd = COMMAND_REGISTER(cmd_ctx, NULL, "hello",
 107                         &handle_hello_command, COMMAND_ANY,
 108                         "[<name>] - prints a warm welcome");
 109         return cmd ? ERROR_OK : -ENOMEM;
 110 }