Joe Kearney
7807ce0ece
This PR adds a new console command, "KEvent", which allows the sending of arbitrary events to the [state machine](https://ktag.clubk.club/Technology/SystemK/#state-machine). The events are specified by [ID](https://git.ktag.clubk.club/Software/SystemK/src/tag/SystemK_v01.01/Events/KEvents.h#L33-L86), which may change from release-to-release of SystemK. ``` KTag> KEvent Usage: KEvent <Event ID> <Event Data> (Note that IDs may be SystemK version-dependent.) ``` Co-authored-by: Joe Kearney <joe@clubk.club> Reviewed-on: #17
99 lines
No EOL
2.4 KiB
C
99 lines
No EOL
2.4 KiB
C
/*
|
|
* This program source code file is part of the KTag project, a DIY laser tag
|
|
* game with customizable features and wide interoperability.
|
|
*
|
|
* 🛡 <https://ktag.clubk.club> 🃞
|
|
*
|
|
* Copyright © 2026 Joseph P. Kearney and the KTag developers.
|
|
*
|
|
* This program is free software: you can redistribute it and/or modify it under
|
|
* the terms of the GNU Affero General Public License as published by the Free
|
|
* Software Foundation, either version 3 of the License, or (at your option) any
|
|
* later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful, but WITHOUT
|
|
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
|
|
* FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
|
|
* details.
|
|
*
|
|
* There should be a copy of the GNU Affero General Public License in the LICENSE
|
|
* file in the root of this repository. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#include <stdio.h>
|
|
#include <stdlib.h>
|
|
#include <stdint.h>
|
|
#include <errno.h>
|
|
#include <limits.h>
|
|
#include "esp_console.h"
|
|
#include "esp_log.h"
|
|
#include "SystemK.h"
|
|
|
|
static uint32_t parse_uint32(const char *str, bool *ok)
|
|
{
|
|
char *end;
|
|
errno = 0;
|
|
unsigned long val = strtoul(str, &end, 10);
|
|
|
|
if (errno != 0 || end == str || *end != '\0' || val > UINT32_MAX)
|
|
{
|
|
*ok = false;
|
|
return 0;
|
|
}
|
|
|
|
*ok = true;
|
|
return (uint32_t)val;
|
|
}
|
|
|
|
static void print_usage(void)
|
|
{
|
|
printf(
|
|
"Usage:\n"
|
|
" KEvent <Event ID> <Event Data>\n"
|
|
" (Note that IDs may be SystemK version-dependent.)\n");
|
|
}
|
|
|
|
static int cmd_KEvent(int argc, char **argv)
|
|
{
|
|
KEvent_T event;
|
|
uint32_t data;
|
|
|
|
if (argc < 2)
|
|
{
|
|
print_usage();
|
|
return 0;
|
|
}
|
|
|
|
if (Parse_KEvent_ID(argv[1], &event) == SYSTEMK_RESULT_SUCCESS)
|
|
{
|
|
bool ok;
|
|
data = parse_uint32(argv[2], &ok);
|
|
if (ok == true)
|
|
{
|
|
event.Data = (void *)data;
|
|
Post_KEvent(&event);
|
|
return 0;
|
|
}
|
|
else
|
|
{
|
|
printf("ERROR: Couldn't parse data!");
|
|
return (-1);
|
|
}
|
|
}
|
|
else
|
|
{
|
|
printf("ERROR: Couldn't parse SystemK event!");
|
|
return (-1);
|
|
}
|
|
}
|
|
|
|
void Register_KEvent_Command(void)
|
|
{
|
|
const esp_console_cmd_t cmd = {
|
|
.command = "KEvent",
|
|
.help = "Send arbitrary KEvents by ID",
|
|
.func = &cmd_KEvent,
|
|
};
|
|
|
|
ESP_ERROR_CHECK(esp_console_cmd_register(&cmd));
|
|
} |