---
name: CH55x Series
mcu_type: 1
device_type: 0x11
support_usb: true
support_serial: true
support_net: false
description: CH55x (E8051) Series
config_registers:
  - offset: 0x00
    name: REVERSED
    description: Reversed 32-bit word
    reset: 0xFFFFFFFF
    type: u32
  - offset: 0x04
    name: WPROTECT
    reset: 0xFFFFFFFF
    type: u32
    fields:
      - bit_range: [0, 0]
        name: NO_KEY_SERIAL_DOWNLOAD
        description: Turn on No-key serial port download
        explaination:
          1: Enable
          0: Disable
      - bit_range: [1, 1]
        name: DOWNLOAD_CFG
        explaination:
          1: P4.6 / P15 / P3.6(Default set)
          0: P5.1 / P51 / P1.5
  - offset: 0x08
    name: GLOBAL_CFG
    reset: 0xFFFF4EFF
    type: u32
    fields:
      # Configuration Information, sec 6.2
      - bit_range: [15, 15]
        name: CODE_PROTECT
        explaination:
          0: Forbid code & data protection
          1: Readable
      - bit_range: [14, 14]
        name: NO_BOOT_LOAD
        explaination:
          0: Boot from 0x0000 Application
          1: Boot from 0xf400 Bootloader
      - bit_range: [13, 13]
        name: EN_LONG_RESET
        explaination:
          0: Short reset
          1: Wide reset, add 87ms reset time
      - bit_range: [12, 12]
        name: XT_OSC_STRONG
        explaination:
          0: Standard
          1: Enhanced
      - bit_range: [11, 11]
        name: EN_P5.7_RESET
        explaination:
          0: Forbid
          1: Enable reset
      - bit_range: [10, 10]
        name: EN_P0_PULLUP
        explaination:
          0: Forbid
          1: Enable
      - bit_range: [9, 8]
        name: RESERVED
        explaination:
          0b10: Default
          _: Error
      - bit_range: [7, 0]
        name: RESERVED
        explaination:
          0b11111111: Default
          _: Error
variants:
  - name: CH551
    chip_id: 0x51
    flash_size: 10K
    eeprom_size: 128
    eeprom_start_addr: 0xC000

  - name: CH552
    chip_id: 0x52
    # FIXME: 16K or 14K
    flash_size: 14K
    eeprom_size: 128
    eeprom_start_addr: 0xC000

  - name: CH554
    chip_id: 0x54
    flash_size: 14K
    eeprom_size: 128
    eeprom_start_addr: 0xC000

  - name: CH555
    chip_id: 0x55
    flash_size: 61440
    eeprom_size: 1K
    eeprom_start_addr: 61440

  - name: CH556
    chip_id: 0x56
    flash_size: 61440
    eeprom_size: 1K
    eeprom_start_addr: 61440

  - name: CH557
    chip_id: 0x57
    flash_size: 61440
    eeprom_size: 1024
    eeprom_start_addr: 61440

  - name: CH558
    chip_id: 0x58
    flash_size: 32768
    eeprom_size: 5120
    eeprom_start_addr: 0xE000

  - name: CH559
    chip_id: 0x59
    flash_size: 61440
    eeprom_size: 1024
    eeprom_start_addr: 61440