[tools] Move functions to utilities, add universal CRC16 class

tools/util/intbin.py

@@ -2,60 +2,138 @@
 
 
 def bswap(data: bytes) -> bytes:
+    """Reverse the byte array (big-endian <-> little-endian)."""
     return bytes(reversed(data))
 
 
 def betoint(data: bytes) -> int:
+    """Convert bytes to big-endian unsigned integer."""
     return int.from_bytes(data, byteorder="big")
 
 
 def letoint(data: bytes) -> int:
+    """Convert bytes to little-endian unsigned integer."""
     return int.from_bytes(data, byteorder="little")
 
 
 def betosint(data: bytes) -> int:
+    """Convert bytes to big-endian signed integer."""
     return int.from_bytes(data, byteorder="big", signed=True)
 
 
 def letosint(data: bytes) -> int:
+    """Convert bytes to little-endian signed integer."""
     return int.from_bytes(data, byteorder="little", signed=True)
 
 
+def inttobe32(data: int) -> bytes:
+    """Convert unsigned integer to 32 bits, big-endian."""
+    return data.to_bytes(length=4, byteorder="big")
+
+
 def inttole32(data: int) -> bytes:
+    """Convert unsigned integer to 32 bits, little-endian."""
     return data.to_bytes(length=4, byteorder="little")
 
 
+def inttobe24(data: int) -> bytes:
+    """Convert unsigned integer to 24 bits, big-endian."""
+    return data.to_bytes(length=3, byteorder="big")
+
+
 def inttole24(data: int) -> bytes:
+    """Convert unsigned integer to 24 bits, little-endian."""
     return data.to_bytes(length=3, byteorder="little")
 
 
+def inttobe16(data: int) -> bytes:
+    """Convert unsigned integer to 16 bits, big-endian."""
+    return data.to_bytes(length=2, byteorder="big")
+
+
 def inttole16(data: int) -> bytes:
+    """Convert unsigned integer to 16 bits, little-endian."""
     return data.to_bytes(length=2, byteorder="little")
 
 
 def intto8(data: int) -> bytes:
+    """Convert unsigned integer to 8 bits."""
     return data.to_bytes(length=1, byteorder="big")
 
 
+def sinttobe32(data: int) -> bytes:
+    """Convert signed integer to 32 bits, big-endian."""
+    return data.to_bytes(length=4, byteorder="big", signed=True)
+
+
 def sinttole32(data: int) -> bytes:
+    """Convert signed integer to 32 bits, little-endian."""
     return data.to_bytes(length=4, byteorder="little", signed=True)
 
 
+def sinttobe24(data: int) -> bytes:
+    """Convert signed integer to 24 bits, big-endian."""
+    return data.to_bytes(length=3, byteorder="big", signed=True)
+
+
 def sinttole24(data: int) -> bytes:
+    """Convert signed integer to 24 bits, little-endian."""
     return data.to_bytes(length=3, byteorder="little", signed=True)
 
 
+def sinttobe16(data: int) -> bytes:
+    """Convert signed integer to 16 bits, big-endian."""
+    return data.to_bytes(length=2, byteorder="big", signed=True)
+
+
 def sinttole16(data: int) -> bytes:
+    """Convert signed integer to 16 bits, little-endian."""
     return data.to_bytes(length=2, byteorder="little", signed=True)
 
 
 def sintto8(data: int) -> bytes:
+    """Convert signed integer to 8 bits."""
     return data.to_bytes(length=1, byteorder="little", signed=True)
 
 
 def align_up(x: int, n: int) -> int:
+    """Return x aligned up to block size of n."""
     return int((x - 1) // n + 1) * n
 
 
 def align_down(x: int, n: int) -> int:
+    """Return 'x' aligned down to block size of 'n'."""
     return int(x // n) * n
+
+
+def pad_up(x: int, n: int) -> int:
+    """Return how many bytes of padding is needed to align 'x'
+    up to block size of 'n'."""
+    return n - (x % n)
+
+
+def pad_data(data: bytes, n: int, char: int) -> bytes:
+    """Add 'char'-filled padding to 'data' to align to a 'n'-sized block."""
+    if len(data) % n == 0:
+        return data
+    return data + (bytes([char]) * pad_up(len(data), n))
+
+
+def uint8(val):
+    """Get only the least-significant 8 bits of the value."""
+    return val & 0xFF
+
+
+def uint16(val):
+    """Get only the least-significant 16 bits of the value."""
+    return val & 0xFFFF
+
+
+def uint32(val):
+    """Get only the least-significant 32 bits of the value."""
+    return val & 0xFFFFFFFF
+
+
+def uintmax(bits: int) -> int:
+    """Get maximum integer size for given bit width."""
+    return (2**bits) - 1