vhdl-style-guide/docs/concurrent_rules.rst

367 lines
6.2 KiB
ReStructuredText

.. include:: includes.rst
Concurrent Rules
----------------
concurrent_001
##############
|phase_4| |error| |indent|
This rule checks the indent of concurrent assignments.
**Violation**
.. code-block:: vhdl
architecture RTL of FIFO is
begin
wr_en <= '0';
rd_en <= '1';
**Fix**
.. code-block:: vhdl
architecture RTL of FIFO is
begin
wr_en <= '0';
rd_en <= '1';
concurrent_002
##############
|phase_2| |error| |whitespace|
This rule checks for a single space after the **<=** operator.
|configuring_whitespace_rules_link|
**Violation**
.. code-block:: vhdl
wr_en <= '0';
rd_en <= '1';
**Fix**
.. code-block:: vhdl
wr_en <= '0';
rd_en <= '1';
concurrent_003
##############
|phase_5| |error| |alignment|
This rule checks alignment of multiline concurrent simple signal assignments.
Succesive lines should align to the space after the assignment operator.
However, there is a special case if there are parenthesis in the assignment.
If the parenthesis are not closed on the same line, then the next line will be aligned to the parenthesis.
Aligning to the parenthesis improves readability.
|configuring_multiline_indent_rules_link|
**Violation**
.. code-block:: vhdl
O_FOO <= (1 => q_foo(63 downto 32),
0 => q_foo(31 downto 0));
n_foo <= resize(unsigned(I_FOO) +
unsigned(I_BAR), q_foo'length);
**Fix**
.. code-block:: vhdl
O_FOO <= (1 => q_foo(63 downto 32),
0 => q_foo(31 downto 0));
n_foo <= resize(unsigned(I_FOO) +
unsigned(I_BAR), q_foo'length);
concurrent_004
##############
|phase_2| |error| |whitespace|
This rule checks for at least a single space before the **<=** operator.
|configuring_whitespace_rules_link|
**Violation**
.. code-block:: vhdl
wr_en<= '0';
**Fix**
.. code-block:: vhdl
wr_en <= '0';
concurrent_005
##############
|phase_1| |error| |structure|
This rule checks for labels on concurrent assignments.
Labels on concurrents are optional and do not provide additional information.
**Violation**
.. code-block:: vhdl
WR_EN_OUTPUT : WR_EN <= q_wr_en;
RD_EN_OUTPUT : RD_EN <= q_rd_en;
**Fix**
.. code-block:: vhdl
WR_EN <= q_wr_en;
RD_EN <= q_rd_en;
concurrent_006
##############
|phase_5| |error| |alignment|
This rule checks the alignment of the **<=** operator over multiple consecutive lines.
|configuring_keyword_alignment_rules_link|
**Violation**
.. code-block:: vhdl
wr_en <= '0';
rd_en <= '1';
data <= (others => '0');
**Fix**
.. code-block:: vhdl
wr_en <= '0';
rd_en <= '1';
data <= (others => '0');
concurrent_007
##############
This rule has been renamed to `conditional_waveforms_001 <conditional_waveforms_rules.html#conditional-waveforms-001>`_.
concurrent_008
##############
|phase_5| |error| |alignment|
This rule checks the alignment of inline comments in consecutive concurrent statements.
|configuring_keyword_alignment_rules_link|
**Violation**
.. code-block:: vhdl
wr_en <= '0'; -- Write enable
rd_en <= '1'; -- Read enable
data <= (others => '0'); -- Write data
**Fix**
.. code-block:: vhdl
wr_en <= '0'; -- Write enable
rd_en <= '1'; -- Read enable
data <= (others => '0'); -- Write data
concurrent_009
##############
|phase_5| |error| |alignment|
This rule checks alignment of multiline concurrent conditional signal statements.
|configuring_conditional_multiline_indent_rules_link|
**Violation**
.. code-block:: vhdl
wr_en <= '0' when q_wr_en = '1' else
'1';
w_foo <= I_FOO when ((I_BAR = '1') and
(I_CRUFT = '1')) else
'0';
**Fix**
.. code-block:: vhdl
wr_en <= '0' when q_wr_en = '1' else
'1';
w_foo <= I_FOO when ((I_BAR = '1') and
(I_CRUFT = '1')) else
'0';
concurrent_010
##############
|phase_3| |error| |blank_line|
This rule removes blank lines within concurrent signal assignments.
**Violation**
.. code-block:: vhdl
wr_en <= '0' when q_wr_en = '1' else
'1';
w_foo <= I_FOO when ((I_BAR = '1') and
(I_CRUFT = '1')) else
'0';
**Fix**
.. code-block:: vhdl
wr_en <= '0' when q_wr_en = '1' else
'1';
w_foo <= I_FOO when ((I_BAR = '1') and
(I_CRUFT = '1')) else
'0';
concurrent_011
##############
|phase_1| |error| |structure|
This rule checks the structure of simple and conditional concurrent statements.
|configuring_simple_multiline_structure_rules_link|
**Violation**
.. code-block:: vhdl
wr_en <=
'0' when q_wr_en = '1' else
'1';
w_foo <=
I_FOO when ((I_BAR = '1') and
(I_CRUFT = '1')) else
'0';
**Fix**
.. code-block:: vhdl
wr_en <= '0' when q_wr_en = '1' else
'1';
w_foo <= I_FOO when ((I_BAR = '1') and
(I_CRUFT = '1')) else
'0';
concurrent_012
##############
|phase_1| |error| |structure|
This rule checks the structure of multiline concurrent simple signal assignments that contain arrays.
|configuring_array_multiline_structure_rules_link|
**Violation**
.. code-block:: vhdl
wr_data <= (0, 65535, 32768);
**Fix**
.. code-block:: vhdl
wr_data <=
(
0,
65535,
32768
);
concurrent_400
##############
|phase_5| |error| |alignment|
This rule checks the alignment the => operator in record aggregates.
|configuring_keyword_alignment_rules_link|
**Violation**
.. code-block:: vhdl
interface <= (
write_words => 12,
read_words => 32
address => 57
);
**Fix**
.. code-block:: vhdl
interface <= (
write_words => 12,
read_words => 32
address => 57
);
concurrent_401
##############
|phase_5| |error| |alignment|
This rule checks the alignment of multiline concurrent simple signal assignments that contain arrays.
|configuring_multiline_indent_rules_link|
**Violation**
.. code-block:: vhdl
wr_data <=
(
0,
65535,
32768
);
**Fix**
.. code-block:: vhdl
wr_data <=
(
0,
65535,
32768
);