gpio_map_routes.cpp

Go to the documentation of this file.

// Copyright (C) 2026 Douglas Quigg (dstroy0) <dquigg123@gmail.com>
// SPDX-License-Identifier: AGPL-3.0-or-later
 
/**
 * @file gpio_map_routes.cpp
 * @brief GPIO pin-mapper routes (GET serves the JSON, POST drives an output).
 *
 * Separated from the host-testable core (gpio_map.cpp) so the serializer + control
 * parser unit-test without pulling in the server. The pin table is caller-owned.
 */
 
#include "services/system/gpio_map/gpio_map.h"
 
#if PC_ENABLE_GPIO_MAP
 
#include "protocore.h"
#include "shared_primitives/mime.h"
 
// All gpio-map-routes state, owned by one instance (internal linkage): the server handle plus
// the pin table pointer and count, grouped so it is one named owner, unreachable cross-TU.
// (The route handlers are fixed-signature callbacks, so they reach this single owner directly.)
struct GpioRoutesCtx
{
    PC *srv = nullptr;
    pc_gpio_pin *pins = nullptr;
    uint8_t count = 0;
};
static GpioRoutesCtx s_gpior;
 
static void gpio_get_handler(uint8_t slot_id, HttpReq *req)
{
    (void)req;
    pc_gpio_read(s_gpior.pins, s_gpior.count);
    char buf[PC_GPIO_JSON_BUF];
    pc_gpio_json(s_gpior.pins, s_gpior.count, buf, sizeof(buf));
    if (s_gpior.srv)
    {
        s_gpior.srv->send(slot_id, 200, PC_MIME_JSON, buf);
    }
}
 
static void gpio_post_handler(uint8_t slot_id, HttpReq *req)
{
    if (!s_gpior.srv)
    {
        return;
    }
    uint8_t pin;
    uint8_t level;
    if (!pc_gpio_parse_set((const char *)req->body, req->body_len, &pin, &level))
    {
        s_gpior.srv->send(slot_id, 400, PC_MIME_TEXT_PLAIN, "bad request");
        return;
    }
    if (!pc_gpio_is_output(s_gpior.pins, s_gpior.count, pin))
    {
        s_gpior.srv->send(slot_id, 403, PC_MIME_TEXT_PLAIN, "pin not a mapped output");
        return;
    }
    pc_gpio_write(pin, level);
    pc_gpio_read(s_gpior.pins, s_gpior.count);
    char buf[PC_GPIO_JSON_BUF];
    pc_gpio_json(s_gpior.pins, s_gpior.count, buf, sizeof(buf));
    s_gpior.srv->send(slot_id, 200, PC_MIME_JSON, buf);
}
 
void pc_gpio_map_begin(PC &server, const char *path, pc_gpio_pin *pins, uint8_t count)
{
    s_gpior.srv = &server;
    s_gpior.pins = pins;
    s_gpior.count = count;
    pc_gpio_begin_pins(pins, count);
    const char *p = (path && path[0]) ? path : "/gpio";
    server.on(p, HttpMethod::HTTP_GET, gpio_get_handler);
    server.on(p, HttpMethod::HTTP_POST, gpio_post_handler);
}
 
#endif // PC_ENABLE_GPIO_MAP