unleashed-firmware/applications/plugins/protoview/view_build.c

248 lines
10 KiB
C

/* Copyright (C) 2022-2023 Salvatore Sanfilippo -- All Rights Reserved
* See the LICENSE file for information about the license. */
#include "app.h"
extern ProtoViewDecoder* Decoders[]; // Defined in signal.c.
/* Our view private data. */
#define USER_VALUE_LEN 64
typedef struct {
ProtoViewDecoder* decoder; /* Decoder we are using to create a
message. */
uint32_t cur_decoder; /* Decoder index when we are yet selecting
a decoder. Used when decoder is NULL. */
ProtoViewFieldSet* fieldset; /* The fields to populate. */
uint32_t cur_field; /* Field we are editing right now. This
is the index inside the 'fieldset'
fields. */
char* user_value; /* Keyboard input to replace the current
field value goes here. */
} BuildViewPrivData;
/* Not all the decoders support message bulding, so we can't just
* increment / decrement the cur_decoder index here. */
static void select_next_decoder(ProtoViewApp* app) {
BuildViewPrivData* privdata = app->view_privdata;
do {
privdata->cur_decoder++;
if(Decoders[privdata->cur_decoder] == NULL) privdata->cur_decoder = 0;
} while(Decoders[privdata->cur_decoder]->get_fields == NULL);
}
/* Like select_next_decoder() but goes backward. */
static void select_prev_decoder(ProtoViewApp* app) {
BuildViewPrivData* privdata = app->view_privdata;
do {
if(privdata->cur_decoder == 0) {
/* Go one after the last one to wrap around. */
while(Decoders[privdata->cur_decoder]) privdata->cur_decoder++;
}
privdata->cur_decoder--;
} while(Decoders[privdata->cur_decoder]->get_fields == NULL);
}
/* Render the view to select the decoder, among the ones that
* support message building. */
static void render_view_select_decoder(Canvas* const canvas, ProtoViewApp* app) {
BuildViewPrivData* privdata = app->view_privdata;
canvas_set_font(canvas, FontPrimary);
canvas_draw_str(canvas, 0, 9, "Signal creator");
canvas_set_font(canvas, FontSecondary);
canvas_draw_str(canvas, 0, 19, "up/down: select, ok: choose");
canvas_set_font(canvas, FontPrimary);
canvas_draw_str_aligned(
canvas, 64, 38, AlignCenter, AlignCenter, Decoders[privdata->cur_decoder]->name);
}
/* Render the view that allows the user to populate the fields needed
* for the selected decoder to build a message. */
static void render_view_set_fields(Canvas* const canvas, ProtoViewApp* app) {
BuildViewPrivData* privdata = app->view_privdata;
char buf[32];
snprintf(
buf,
sizeof(buf),
"%s field %d/%d",
privdata->decoder->name,
(int)privdata->cur_field + 1,
(int)privdata->fieldset->numfields);
canvas_set_color(canvas, ColorBlack);
canvas_draw_box(canvas, 0, 0, 128, 21);
canvas_set_color(canvas, ColorWhite);
canvas_set_font(canvas, FontPrimary);
canvas_draw_str(canvas, 1, 9, buf);
canvas_set_font(canvas, FontSecondary);
canvas_draw_str(canvas, 1, 19, "up/down: next field, ok: edit");
/* Write the field name, type, current content. */
canvas_set_color(canvas, ColorBlack);
ProtoViewField* field = privdata->fieldset->fields[privdata->cur_field];
snprintf(
buf, sizeof(buf), "%s %s:%d", field->name, field_get_type_name(field), (int)field->len);
buf[0] = toupper(buf[0]);
canvas_set_font(canvas, FontPrimary);
canvas_draw_str_aligned(canvas, 64, 30, AlignCenter, AlignCenter, buf);
canvas_set_font(canvas, FontSecondary);
/* Render the current value between "" */
unsigned int written = (unsigned int)field_to_string(buf + 1, sizeof(buf) - 1, field);
buf[0] = '"';
if(written + 3 < sizeof(buf)) memcpy(buf + written + 1, "\"\x00", 2);
canvas_draw_str_aligned(canvas, 63, 45, AlignCenter, AlignCenter, buf);
/* Footer instructions. */
canvas_draw_str(canvas, 0, 62, "Long ok: create, < > incr/decr");
}
/* Render the build message view. */
void render_view_build_message(Canvas* const canvas, ProtoViewApp* app) {
BuildViewPrivData* privdata = app->view_privdata;
if(privdata->decoder)
render_view_set_fields(canvas, app);
else
render_view_select_decoder(canvas, app);
}
/* Handle input for the decoder selection. */
static void process_input_select_decoder(ProtoViewApp* app, InputEvent input) {
BuildViewPrivData* privdata = app->view_privdata;
if(input.type == InputTypeShort) {
if(input.key == InputKeyOk) {
privdata->decoder = Decoders[privdata->cur_decoder];
privdata->fieldset = fieldset_new();
privdata->decoder->get_fields(privdata->fieldset);
/* If the currently decoded message was produced with the
* same decoder the user selected, let's populate the
* defaults with the current values. So the user will
* actaully edit the current message. */
if(app->signal_decoded && app->msg_info->decoder == privdata->decoder) {
fieldset_copy_matching_fields(privdata->fieldset, app->msg_info->fieldset);
}
/* Now we use the subview system in order to protect the
message editing mode from accidental < or > presses.
Since we are technically into a subview now, we'll have
control of < and >. */
InputEvent ii = {.type = InputTypePress, .key = InputKeyDown};
ui_process_subview_updown(app, ii, 2);
} else if(input.key == InputKeyDown) {
select_next_decoder(app);
} else if(input.key == InputKeyUp) {
select_prev_decoder(app);
}
}
}
/* Called after the user typed the new field value in the keyboard.
* Let's save it and remove the keyboard view. */
static void text_input_done_callback(void* context) {
ProtoViewApp* app = context;
BuildViewPrivData* privdata = app->view_privdata;
if(field_set_from_string(
privdata->fieldset->fields[privdata->cur_field],
privdata->user_value,
strlen(privdata->user_value)) == false) {
ui_show_alert(app, "Invalid value", 1500);
}
free(privdata->user_value);
privdata->user_value = NULL;
ui_dismiss_keyboard(app);
}
/* Handles the effects of < and > keys in field editing mode.
* Instead of force the user to enter the text input mode, delete
* the old value, enter the one, we allow to increment and
* decrement the current field in a much simpler way.
*
* The current filed is changed by 'incr' amount. */
static bool increment_current_field(ProtoViewApp* app, int incr) {
BuildViewPrivData* privdata = app->view_privdata;
ProtoViewFieldSet* fs = privdata->fieldset;
ProtoViewField* f = fs->fields[privdata->cur_field];
return field_incr_value(f, incr);
}
/* Handle input for fields editing mode. */
static void process_input_set_fields(ProtoViewApp* app, InputEvent input) {
BuildViewPrivData* privdata = app->view_privdata;
ProtoViewFieldSet* fs = privdata->fieldset;
if(input.type == InputTypeShort && input.key == InputKeyOk) {
/* Show the keyboard to let the user type the new
* value. */
if(privdata->user_value == NULL) privdata->user_value = malloc(USER_VALUE_LEN);
field_to_string(privdata->user_value, USER_VALUE_LEN, fs->fields[privdata->cur_field]);
ui_show_keyboard(app, privdata->user_value, USER_VALUE_LEN, text_input_done_callback);
} else if(input.type == InputTypeShort && input.key == InputKeyDown) {
privdata->cur_field = (privdata->cur_field + 1) % fs->numfields;
} else if(input.type == InputTypeShort && input.key == InputKeyUp) {
if(privdata->cur_field == 0)
privdata->cur_field = fs->numfields - 1;
else
privdata->cur_field--;
} else if(input.type == InputTypeShort && input.key == InputKeyRight) {
increment_current_field(app, 1);
} else if(input.type == InputTypeShort && input.key == InputKeyLeft) {
increment_current_field(app, -1);
} else if(input.type == InputTypeRepeat && input.key == InputKeyRight) {
// The reason why we don't use a large increment directly
// is that certain field types only support +1 -1 increments.
int times = 10;
while(times--) increment_current_field(app, 1);
} else if(input.type == InputTypeRepeat && input.key == InputKeyLeft) {
int times = 10;
while(times--) increment_current_field(app, -1);
} else if(input.type == InputTypeLong && input.key == InputKeyOk) {
// Build the message in a fresh raw buffer.
if(privdata->decoder->build_message) {
RawSamplesBuffer* rs = raw_samples_alloc();
privdata->decoder->build_message(rs, privdata->fieldset);
app->signal_decoded = false; // So that the new signal will be
// accepted as the current signal.
scan_for_signal(app, rs, 5);
raw_samples_free(rs);
ui_show_alert(app, "Done: press back key", 3000);
}
}
}
/* Handle input for the build message view. */
void process_input_build_message(ProtoViewApp* app, InputEvent input) {
BuildViewPrivData* privdata = app->view_privdata;
if(privdata->decoder)
process_input_set_fields(app, input);
else
process_input_select_decoder(app, input);
}
/* Enter view callback. */
void view_enter_build_message(ProtoViewApp* app) {
BuildViewPrivData* privdata = app->view_privdata;
// When we enter the view, the current decoder is just set to zero.
// Seek the next valid if needed.
if(Decoders[privdata->cur_decoder]->get_fields == NULL) {
select_next_decoder(app);
}
// However if there is currently a decoded message, and the
// decoder of such message supports message building, let's
// select it.
if(app->signal_decoded && app->msg_info->decoder->get_fields &&
app->msg_info->decoder->build_message) {
while(Decoders[privdata->cur_decoder] != app->msg_info->decoder) select_next_decoder(app);
}
}
/* Called on exit for cleanup. */
void view_exit_build_message(ProtoViewApp* app) {
BuildViewPrivData* privdata = app->view_privdata;
if(privdata->fieldset) fieldset_free(privdata->fieldset);
if(privdata->user_value) free(privdata->user_value);
}