Diagrammi di pacchetto in Confluence
Un diagramma di pacchetto mostra la struttura di un messaggio binario, bit per bit.
Ultimo aggiornamento
Quando usarlo
Usa un diagramma di pacchetto nella specifica di un protocollo o di un formato di file: quali bit contengono la versione, i flag, la lunghezza, il contenuto. Ogni campo è un intervallo di bit con un’etichetta, disegnato in righe da 32 bit.
Esempio
Questo è il codice del modello Binary header: la disposizione dei bit dell’intestazione di un messaggio binario.
packet
title Binary message header
0-3: "Version"
4: "ACK"
5: "ENC"
6: "FRAG"
7: "RSV"
8-15: "Message type"
16-31: "Payload length"
+32: "Device ID"
+32: "Checksum"
Vellnar Diagrams lo disegna così:
Cambia una riga e il diagramma cambia con lei. A nessuno serve il file originale del disegno, perché non esiste: il codice è il diagramma.
Aggiungerlo a una pagina di Confluence
- Modifica una pagina di Confluence e scrivi
/mermaiddove vuoi il diagramma. - Seleziona Mermaid diagram. Si apre l’editor con l’elenco dei modelli.
- Scegli un modello, oppure Start blank e incolla il codice qui sopra. L’anteprima segue ogni tasto.
- Scegli Save. Il diagramma compare nella pagina.
La documentazione spiega l’editor, le impostazioni e le esportazioni.
Modelli
Il pulsante Templates dell’editor ha un modello pronto per questo tipo:
- Binary header: La disposizione dei bit dell’intestazione di un messaggio binario.
Sintassi
Il codice inizia con packet. La documentazione di Mermaid (in inglese) descrive ogni elemento della sintassi. Vellnar Diagrams lo disegna con Mermaid 12.3; se una riga ha un errore, l’editor segna la riga e tiene a schermo l’ultimo diagramma valido.
Altro
- Mermaid in Confluence: come funzionano i diagrammi scritti come codice in una pagina, e tutti i tipi di diagramma.
- Sicurezza: l’app non chiede nessun permesso e non manda nulla fuori da Atlassian.