third_party/pigweed/repo/pw_hdlc_lite/py/pw_hdlc_lite/protocol.py

   1 # Copyright 2020 The Pigweed Authors
   2 #
   3 # Licensed under the Apache License, Version 2.0 (the "License"); you may not
   4 # use this file except in compliance with the License. You may obtain a copy of
   5 # the License at
   6 #
   7 #     https://www.apache.org/licenses/LICENSE-2.0
   8 #
   9 # Unless required by applicable law or agreed to in writing, software
  10 # distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
  11 # WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
  12 # License for the specific language governing permissions and limitations under
  13 # the License.
  14 """Module for low-level HDLC protocol features."""
  15
  16 import zlib
  17
  18 # Special flag character for delimiting HDLC frames.
  19 FLAG = 0x7E
  20
  21 # Special character for escaping other special characters in a frame.
  22 ESCAPE = 0x7D
  23
  24
  25 def escape(byte: int) -> int:
  26     """Escapes or unescapes a byte, which should have been preceeded by 0x7d."""
  27     return byte ^ 0x20
  28
  29
  30 def frame_check_sequence(data: bytes) -> bytes:
  31     return zlib.crc32(data).to_bytes(4, 'little')