UDEC.CX

EVC_FW

Progetto hardware e firmware del sistema di controllo di un ascensore domestico a trazione (TTF) di LiftingItalia s.r.l. Quattro schede basate su STM32F446, collegate in CAN; il motore è comandato da un VFD.

Struttura

Firmware TTF-Base

Super-loop con timer software e macchina a stati, in C (STM32CubeIDE/HAL). Moduli principali in TTF-Base/Firmware/TTF-Base/Core/:

• run_mode.c: macchina a stati del movimento (NORMAL, UP, DOWN, OPEN_DOOR, CLOSE_DOOR, STUCK_UP, FALL_TEST, WAIT_FOR_CALL_RELEASE) e sequenza di abilitazione.
• door.c: ciclo porte (apertura, chiusura, blocco, sblocco).
• pmode.c, battery.c, npb.c, ltc2959.c: commutazione caricabatteria/VFD, gestione e misura della batteria.
• vfd.c: comando dell'azionamento (CANopen).
• trips.c, trip_list.h: gestione degli errori (inattivo, attivo, memorizzato).
• udec_c.c, udec_cx.c, l2d.c, can.c: comunicazione CAN con le altre schede.
• HMI.c, HMI_menu.c, lcd_hd44780_i2c.c: display LCD e menu.

Le modifiche recenti sono descritte in TTF-Base/Firmware/TTF-Base/Changelog.

Documentazione

• docs/registro_issue.md: documento base del lavoro. Tutte le osservazioni, le proposte di correzione, le verifiche e il loro stato. Si aggiorna a ogni issue risolta; il controllo di coerenza è python3 docs/check_registro.py.
• docs/analisi.md: analisi di partenza (panoramica, revisione del codice di sicurezza, catena delle sicurezze, confronto con i manuali).
• I diagrammi stanno in docs/diagrammi/, numerati 01-05; gli script che li generano restano in docs/.
• docs/diagrammi/02.diagramma_funzionale.svg (e .png): diagramma funzionale della macchina (stati del movimento, ciclo porta, alimentazione, batteria, sicurezze, comunicazioni), con i riquadri rossi che rimandano agli ID del registro. Si rigenera con python3 docs/gen_diagramma_funzionale.py docs/diagrammi/02.diagramma_funzionale.svg.
• docs/diagrammi/03.diagramma_funzionale_light.svg (e .png): versione del diagramma funzionale per il dipartimento commerciale (blocchi, una corsa passo per passo, stati, sicurezze, dati di prodotto). Si rigenera con python3 docs/gen_diagramma_light.py docs/diagrammi/03.diagramma_funzionale_light.svg.
• docs/diagrammi/04.diagramma_energia_light.svg (e .png): diagramma per il commerciale su ciclo della batteria, contrappesi, autonomia e costi (numeri di esempio con ipotesi dichiarate). Si rigenera con python3 docs/gen_diagramma_energia.py docs/diagrammi/04.diagramma_energia_light.svg.
• docs/diagrammi/05.diagramma_energia_sintesi.svg (e .png): versione sintetica e visuale del diagramma energia, in valutazione. Si rigenera con python3 docs/gen_diagramma_energia_sintesi.py docs/diagrammi/05.diagramma_energia_sintesi.svg.
• docs/diagrammi/01.schema_funzionale.svg (e .png): schema funzionale elettrico con la catena delle sicurezze. Si rigenera con python3 docs/gen_schema_funzionale.py docs/diagrammi/01.schema_funzionale.svg.
• CLAUDE.md: regole di lavoro per questo repository.

Strumenti

• Schemi e PCB: KiCad.
• Firmware: STM32CubeIDE, progetti configurati con file .ioc (CubeMX).
• Simulazioni: LTspice (UDEC.CX/LTSpice/).
• Modelli meccanici: FreeCAD.

Note

• Drivers/ e Middlewares/ (HAL e USB di ST) sono inclusi nel repo, così il firmware compila senza rigenerare il codice.
• Cache, file di lock, backup e output di build sono esclusi dal .gitignore.
• Il sistema ha funzioni di sicurezza (paracadute, catena di sicurezze, bypass, extracorsa): ogni modifica va validata secondo le norme di prodotto.