---
# System prepended metadata

title: Register Description Files

---

## Unparseable files

These register description files are not parseable by [regdesc], and neeed to be modified by hand in order to get them parsing.

**Possible solution:** Set up some CI pipeline to verify that [regdesc] is able to parse the files prior to them being uploaded to GDVS.

[regdesc]: https://gitlab.espressif.cn:6688/idf/regdesc

- ESP32-C2 `apb_saradc_reg.csv`: A number of field names contained spaces, which resulted in parsing errors.
- ESP32-C3 `assist_debug.csv`: This file was comma-delimited instead of semicolon-delimited, resulting in an unrecoverable parsing error.
- ESP32-P4 `pwm_reg.csv`: This file contained a repeat name `MCPWM_TZ$n_F$n_OST`, which resulted in an error; this was manually changed to `MCPWM_TZ$n_F0_OST` instead.

## Missing Register Description files

- The `twai_reg.csv` file was not provided for the ESP32, ESP32-C3, or ESP32-S3.
  - This peripheral is consistent enough across devices that I was able to adapt it for each chip, however this required manually going through each TRM and verifying registers/fields as there were some minor differences.
- The `usb_wrap_for_trm.csv` file was not provided for the ESP32-S2
  - This file was copied from the ESP32-S3 for the ESP32-S2, which seems to work.

## Missing registers/fields

- ESP32-C6/H2: A number of the `GPIO_FUNC$n_IN_SEL_CFG_REG` registers were missing altogether, and needed to be added manually.
  - Relevant patches:
    - [esp32c6]
    - [esp32h2]

[esp32c6]: https://gitlab.espressif.cn:6688/idf/regdesc-data/-/blob/master/esp32c6/__init__.py?ref_type=heads#L76-93
[esp32h2]: https://gitlab.espressif.cn:6688/idf/regdesc-data/-/blob/master/esp32h2/__init__.py?ref_type=heads#L68-85

## Other Issues

- Duplicate registers in `TIMG0` for the ESP32-P4
  - [Relevant patch]
  - (Sorry, forget which regsisters, forgot to make a note of it)

[Relevant patch]: https://gitlab.espressif.cn:6688/idf/regdesc-data/-/blob/master/esp32p4/__init__.py?ref_type=heads#L146-159
