search

Community-PIO-CH32V / platform-ch32v

PlatformIO platform for CH32V RISC-V chips (CH32V003, CH32V103, CH32V20x, CH32V30x, CH32X035) and CH56x, CH57x, CH58x, CH59x
Apache License 2.0
203 stars 34 forks source link

Add documentation #12

Open maxgerhardt opened 1 year ago

maxgerhardt commented 1 year ago

It should be documented what exact MCUs / eval / dev boards we support and what configuration options the framework each have.

Also how to get started with eval boards. Not setting the BOOT0/1 jumpers both to GND made me have some hickups in original bringup.

gicking commented 1 year ago

just a note: AFAIK the CH32V00x devices don't have a built-in USB/UART bootloader, and have to be flashed via debugger.

Sorry, wrong information: the CH32V003 DS v1.2 states on p.1 that it does feature a bootloader. However, no further information is provided

gicking commented 1 year ago

Question: do you know where I can find the bootloader protocol? Are you currently using the WCH tool? If yes, is that also available for Non-Win platforms?

maxgerhardt commented 1 year ago

I'm trying to integrate the program wchisp (Open Source) for USB DFU uploads at #14, however it's not quite working for me yet. Not sure if also implements the UART upload.

Once that program has proven itself to at least work on my board, it'll be available cross-platform.

maxgerhardt commented 1 year ago

I currently use the WCH-Link + OpenOCD combination to upload to my chip, which is already uploaded for most OS'es (#2), works great for upload and debugging.

maxgerhardt commented 1 year ago

I've registered for a readthedocs.io website, now we have

https://pio-ch32v.readthedocs.io/en/latest/

being created from https://github.com/Community-PIO-CH32V/docs. No real docs were added yet though, but the page stands.

maxgerhardt commented 6 months ago

Needs docs for "How to convert MounRiverStudio project to PlatformIO" desperately, see #53.

FPGA-Computer commented 1 week ago

Sorry, wrong information: the CH32V003 DS v1.2 states on p.1 that it does feature a bootloader. However, no further information is provided

The chip doesn't have a Boot pin to select Bootloader externally. Instead there is a non-volatile Mode bit that can be set to either jump to user code or bootload upon Reset. (16.3.4 OBKEY register)

See SystemReset_StartMode(uint32_t Mode) under /EXAM/SRC/Peripheral/src/ch32v00x_flash.c in the EVT application code example.