---
id: user-guide-firmware-management
title: Gestión de firmware
category: user-guide
version: 1.0
status: stable
audience:
  - user
  - administrator
  - developer
  - ai
updated_at: 2026-07-14
related:
  - artifacts-library
  - flasher-using-flasher
  - api-overview
tags:
  - firmware
  - multipart
  - merged
  - clone
  - delete
---

# Gestión de firmware

Firmware es una ficha distribuible. Artifact es un binario inmutable identificado por SHA-256. Firmware segment relaciona ambos y conserva nombre, orden y offset.

## Firmware simple

Un único archivo binario se registra con sus metadatos, tamaño y checksum. Puede descargarse y flashearse en la dirección configurada. Una imagen merged se comporta como firmware simple autónomo y se graba en 0x0.

## Paquete multiparte

Un paquete conserva chip, modo, frecuencia, tamaño de flash y segmentos con offsets. Antes de usarlo se validan rangos, solapamientos y archivos. Cada parte puede descargarse o sustituirse desde la ficha.

## Imagen unificada

Generar imagen unificada ejecuta esptool merge-bin en el backend. La imagen resultante puede publicarse como una ficha autónoma con trazabilidad descriptiva, descargarse y flashearse en 0x0. No sustituye al paquete multiparte original.

## Clonado, bloqueo y edición

Clonar crea una ficha nueva que comparte artifacts por SHA-256. Bloquear impide su selección operativa sin borrar datos. Editar permite cambiar metadatos y segmentos. Sustituir un segmento crea o reutiliza el artifact correspondiente.

## Eliminación segura

Eliminar firmware borra la ficha y relaciones. Nunca elimina directamente un artifact compartido. La limpieza física solo elimina artifacts huérfanos mediante una acción controlada.