Uso do WaveDrom para gerar diagramas de tempo
WaveDrom é um aplicativo JavaScript, que renderiza os diagramas de tempo diretamente no | navegador. O formato de descrição adotado é um JSON modificado WaveJSON, no qual a descrição de cada sinal digital é feito usando elemento signal O elemento "sinal" no qual se descreve em uma matriz de WaveLanes os sinais. Cada WaveLane possui um campo obrigatório: wave, e podem ser acrescentados os campos name e data. A documentação digital está disponível no | Hitchhiker's Guide to the WaveDrom. Também existe um bom documento digital que ilustra todo o processo | WaveDrom: Rendering Beautiful Waveforms from Plain Text Chapyzhenka, A. Probell, J.
Exemplo de uso do WaveDrom para a geração do diagrama de tempo de um somador e subtrator. Os valores com overflow e underflow estão sinalizados em vermelho e no bit de erro.
{signal: [ {name: 'ENTRADAS'}, {name: 'a (3 bits)', wave: 'x.2.2.2.2.x.', data: ['7','4','0','2']}, {name: 'b (3 bits)', wave: 'x.22222222x.', data: ['7','4','0','2','1','7','0','7']}, {}, {name: 'SOMADOR'}, {name: 'soma (6 bits)', wave: 'x.99222229x.', data: ['6','3','4','6','1','7','2','1']}, {name: 'erro overflow', wave: 'x.1.0....1x.'}, {}, {name: 'SUBTRATOR'}, {name: 'subtração (6 bits)', wave: 'x.22229929x.', data: ['0','3','4','2','7','1','2','3']}, {name: 'erro underflow', wave: 'x.0...1.01x.'}, ]}
Figura 1 - Diagrama de tempo de um somador de 4 bits
Uso dentro dos comentários do TerosHDL
O WaveDrom pode ser usado dentro do VScode em conjunto com o plugin teroHDL para documentar os sistemas digitais desenvolvidos. Neste caso os códigos WaveJSON devem estar em comentários --!.
--! {signal: [
--! {name: 'ENTRADAS'},
--! {name: 'a (3 bits)', wave: 'x.2.2.2.2.x.', data: ['7','4','0','2']},
--! {name: 'b (3 bits)', wave: 'x.22222222x.', data: ['7','4','0','2','1','7','0','7']},
--! {},
--! {name: 'SOMADOR'},
--! {name: 'soma (6 bits)', wave: 'x.99222229x.', data: ['6','3','4','6','1','7','2','1']},
--! {name: 'erro overflow', wave: 'x.1.0....1x.'},
--! {},
--! {name: 'SUBTRATOR'},
--! {name: 'subtração (6 bits)', wave: 'x.22229929x.', data: ['0','3','4','2','7','1','2','3']},
--! {name: 'erro underflow', wave: 'x.0...1.01x.'},
--! ]}