Add unaligned attribute to suppress warning when not relevant.

Author: BsAtHome

docs/src/man/man1/mesambccc.1.adoc

@@ -591,6 +591,14 @@ Recognized '<commands>/<command>' attributes:
   should be emitted when it does. This differs from 'noanswer' in that a reply
   may be expected within the timeout period but not after the timeout expires.
   This may be required for flaky devices. Default false.
+*unaligned* [Boolean]::
+  Set to true to suppress the alignment warning in multi-register reads or
+  writes where 32-bit or 64-bit values are not aligned to their natural Modbus
+  address boundaries. This is useful for devices that do not care about
+  alignment or do not use Modbus addresses in conventional ways. +
+  Setting 'unaligned' is purely a cosmetic attribute to suppress console
+  clutter when compiling the mbccs file. It has no functional effect on the
+  communication with the device. Default false.
 *writeflush* [Boolean]::
   The override the 'writeflush' value. See '<mesamodbus>[writeflush]' for
   details. Default '<mesamodbus>[writeflush]'.

src/hal/drivers/mesa-hostmot2/mesambccc.py

@@ -317,10 +317,10 @@ def mbtType(mtype):
                'txdelay',  'writeflush' ]
 
 # Allowed attributes in <commands>/<command>
-CMDSATTRIB = [ 'address',    'bcanswer',    'clamp',    'count',   'delay',
-               'device',     'disabled',    'function', 'haltype', 'interval',
-               'modbustype', 'name',        'noanswer', 'resend',  'scale',
-               'timeout',    'timeoutbits', 'timesout', 'writeflush' ]
+CMDSATTRIB = [ 'address',    'bcanswer',    'clamp',    'count',     'delay',
+               'device',     'disabled',    'function', 'haltype',   'interval',
+               'modbustype', 'name',        'noanswer', 'resend',    'scale',
+               'timeout',    'timeoutbits', 'timesout', 'unaligned', 'writeflush' ]
 
 # Allowed attributes in <commands>/<command>/<pin>
 PINSATTRIB = [ 'clamp', 'name', 'haltype', 'modbustype', 'scale' ]
@@ -1323,8 +1323,9 @@ def handleCommands(commands):
 
             if ((mbtOrderSize(pmtype[0]) == 4 and 0 != ((address + regofs) & 1))
                 or (mbtOrderSize(pmtype[0]) == 8 and 0 != ((address + regofs) & 3))):
-                pwarn("Multi-register type '{0}' not aligned to natural boundary (address={1}/0x{1:04x}, regoffset={2}/0x{2:02x}) in {3}"
-                        .format(MBNAMES[pmtype[0]], address, regofs, lpl))
+                if not getBoolean(cmd.attrib, 'unaligned'):
+                    pwarn("Multi-register type '{0}' not aligned to natural boundary (address={1}/0x{1:04x}, regoffset={2}/0x{2:02x}) in {3}"
+                            .format(MBNAMES[pmtype[0]], address, regofs, lpl))
 
             pinlist.append({'pin': pintag, 'mtype': pmtype[0], 'htype': phtype, 'flags': pf, 'regofs': regofs})
             pinlistall.append(pintag)