platform-ch32v icon indicating copy to clipboard operation
platform-ch32v copied to clipboard

Add documentation

Open maxgerhardt opened this issue 2 years ago • 7 comments

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.

maxgerhardt avatar Feb 19 '23 00:02 maxgerhardt

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 avatar Feb 27 '23 06:02 gicking

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?

gicking avatar Feb 27 '23 06:02 gicking

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 avatar Feb 27 '23 08:02 maxgerhardt

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 avatar Feb 27 '23 09:02 maxgerhardt

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 avatar Apr 01 '23 02:04 maxgerhardt

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

maxgerhardt avatar Mar 10 '24 15:03 maxgerhardt

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.

FPGA-Computer avatar Sep 04 '24 14:09 FPGA-Computer