mirror of
https://github.com/MCKero6423/uv-k5-v3-emulator.git
synced 2026-10-02 11:07:31 +00:00
mckero
c0a09827ed
Adds a QEMU machine for the Puya PY32F071 (Cortex-M0+) so Quansheng UV-K5 V3 firmware can run on a PC. The firmware boots to its main loop in about five seconds and the LCD contents are readable. Register layouts come from the vendor CMSIS header shipped with the firmware rather than guesswork. Modelled: RCC, GPIO, ADC, both SPI controllers, DMA1 and the PY25Q16 flash; everything else answers through a logging catch-all, which is how the next thing worth modelling gets identified. Seven things had to be right before it would boot, each found by watching where the firmware stopped: flash aliased at the application offset, clock ready bits, self-clearing ADC calibration, SPI transfer flags, DMA-driven flash reads, SysTick poll acceleration, and the bit-banged transceiver bus idling low. SysTick needs explanation. SYSTICK_DelayUs polls the counter and accumulates differences; under emulation a register read costs far more relative to guest time, so a measured 120 ms delay would have taken about 7.7 hours. Lowering the clock does not help because the bottleneck is loop iterations, not counter speed. Reporting a value that runs ahead of the real counter does, via a new poll-boost property on SysTick. Guest time therefore runs fast during delays: fine for exercising menus and control flow, wrong for judging signal timing. Also includes the host build of the CW timing chain (harness, stubs, shim, tests), which compiles app/cwkeyer.c and app/cwmacro.c unmodified against stub drivers with a virtual clock and scripted paddle input. Known gap: keypad rows reach the firmware's scan and KEYBOARD_Poll returns the right key code, but the UI does not react yet. Not modelled, and not intended to be: radio behaviour. The transceiver chip has no public datasheet, so keying envelopes and emissions need real hardware.
67 lines
2.4 KiB
C
67 lines
2.4 KiB
C
/* Firmware globals the CW chain reads, plus the few functions it calls that
|
|
* belong to subsystems outside the timing path.
|
|
*
|
|
* Kept separate from driver_stubs.c so the two seams stay legible: that file is
|
|
* "the driver layer", this one is "the rest of the firmware".
|
|
*/
|
|
|
|
#include <stdarg.h>
|
|
#include <stdbool.h>
|
|
#include <stdint.h>
|
|
#include <stdio.h>
|
|
#include <string.h>
|
|
|
|
#include "harness/sim_record.h"
|
|
#include "misc.h"
|
|
#include "py32f071_ll_gpio.h"
|
|
#include "settings.h"
|
|
|
|
// Backing storage for the fake GPIO ports. driver/gpio.h encodes a port as a
|
|
// numeric address inside an enum and casts it back with GPIO_PORT(), so the shim
|
|
// hands those addresses here rather than dereferencing them.
|
|
#define SIM_GPIO_PORT_COUNT 4
|
|
static GPIO_TypeDef s_gpio_ports[SIM_GPIO_PORT_COUNT];
|
|
|
|
GPIO_TypeDef *SIM_GpioPort(void *fake_address)
|
|
{
|
|
// Ports are spaced 0x100 apart by the shim (A=0x000, B=0x100, C=0x200,
|
|
// F=0x300). Anything unexpected lands on port 0 rather than faulting.
|
|
const uintptr_t index = ((uintptr_t)fake_address >> 8) & 0x3u;
|
|
return &s_gpio_ports[index];
|
|
}
|
|
|
|
// The real definition lives in misc.c / settings.c, which pull in most of the
|
|
// firmware. The CW chain only touches these fields.
|
|
EEPROM_Config_t gEeprom;
|
|
|
|
volatile CW_State_t gCW_State = CW_INACTIVE;
|
|
volatile bool gCW_KeyerUsingSD1 = false;
|
|
volatile bool gCW_KeyerManagesPtt = false;
|
|
volatile bool gCW_CrossMode = false;
|
|
// Types must match misc.h exactly, including qualifiers.
|
|
volatile uint32_t gCW_SuspendCounter_1ms;
|
|
volatile uint16_t gCW_TxDisplayHoldoff_10ms;
|
|
|
|
// gCW_Recording, the playback flags, gCW_TX_Display and the CW_*TxDisplay
|
|
// functions are all defined by app/cwmacro.c, which is compiled in as-is.
|
|
bool gCW_FlashlightSending;
|
|
bool gCW_CpoActive;
|
|
volatile bool gCW_PlayIndicatorOn; // owned by cwkeyer.c's playback path
|
|
bool gUpdateDisplay;
|
|
uint8_t gUpdateStatus; // uint8_t in misc.h, not bool
|
|
|
|
// The firmware uses a bundled printf implementation; the host's is fine here.
|
|
// Only reached from CW_KEYER_DEBUG tracing.
|
|
int sprintf_(char *buffer, const char *format, ...)
|
|
{
|
|
va_list args;
|
|
va_start(args, format);
|
|
const int n = vsprintf(buffer, format, args);
|
|
va_end(args);
|
|
return n;
|
|
}
|
|
|
|
// Decoded characters are captured by wrapping the real CW_AddToTxDisplay --
|
|
// see harness/sim_capture.c -- rather than replacing it, so cwmacro.c's own
|
|
// buffer management still runs.
|