unleashed-firmware/lib/digital_signal/digital_signal.h

#pragma once

#include <stdint.h>
#include <stdlib.h>
#include <stdbool.h>

#include <furi_hal_gpio.h>

#ifdef __cplusplus
extern "C" {
#endif

/* helper for easier signal generation */
#define DIGITAL_SIGNAL_MS(x) ((x)*100000000UL)
#define DIGITAL_SIGNAL_US(x) ((x)*100000UL)
#define DIGITAL_SIGNAL_NS(x) ((x)*100UL)
#define DIGITAL_SIGNAL_PS(x) ((x) / 10UL)

/* using an anonymous type for the internals */
typedef struct DigitalSignalInternals DigitalSignalInternals;

/* and a public one for accessing user-side fields */
typedef struct DigitalSignal {
    bool start_level;
    uint32_t edge_cnt;
    uint32_t edges_max_cnt;
    uint32_t* edge_timings;
    uint32_t* reload_reg_buff; /* internal, but used by unit tests */
    DigitalSignalInternals* internals;
} DigitalSignal;

typedef struct DigitalSequence DigitalSequence;

DigitalSignal* digital_signal_alloc(uint32_t max_edges_cnt);

void digital_signal_free(DigitalSignal* signal);

void digital_signal_add(DigitalSignal* signal, uint32_t ticks);

void digital_signal_add_pulse(DigitalSignal* signal, uint32_t ticks, bool level);

bool digital_signal_append(DigitalSignal* signal_a, DigitalSignal* signal_b);

void digital_signal_prepare_arr(DigitalSignal* signal);

bool digital_signal_get_start_level(DigitalSignal* signal);

uint32_t digital_signal_get_edges_cnt(DigitalSignal* signal);

uint32_t digital_signal_get_edge(DigitalSignal* signal, uint32_t edge_num);

void digital_signal_send(DigitalSignal* signal, const GpioPin* gpio);

DigitalSequence* digital_sequence_alloc(uint32_t size, const GpioPin* gpio);

void digital_sequence_free(DigitalSequence* sequence);

void digital_sequence_set_signal(
    DigitalSequence* sequence,
    uint8_t signal_index,
    DigitalSignal* signal);

void digital_sequence_set_sendtime(DigitalSequence* sequence, uint32_t send_time);

void digital_sequence_add(DigitalSequence* sequence, uint8_t signal_index);

bool digital_sequence_send(DigitalSequence* sequence);

void digital_sequence_clear(DigitalSequence* sequence);

void digital_sequence_timebase_correction(DigitalSequence* sequence, float factor);

#ifdef __cplusplus
}
#endif