Author Topic: WCH PIOC documentation: Chinese PDFs to English?  (Read 708 times)

0 Members and 1 Guest are viewing this topic.

Offline Nominal AnimalTopic starter

  • Super Contributor
  • ***
  • Posts: 7132
  • Country: fi
    • My home page and email address
WCH PIOC documentation: Chinese PDFs to English?
« on: October 06, 2024, 08:11:23 am »
WCH ch32x033 and ch32x035 have a dedicated protocol I/O controller that I'd like to investigate, but the documentation is in Chinese at github.com/openwch/ch32x035/tree/main/EVT/EXAM/PIOC/Tool_Manual/Manual/: CHRISC8B.PDF (describing the WCH-RISC8B core and instruction set architecture) and PIOC.PDF (the subsystem and its interaction with the QingKe RISC-V core).  Comparing to e.g. RP2040, there are only two pins, but the instruction set is more complete.

Any suggestions on how to auto-translate these from Chinese to English?  It's only 8 + 10 pages.

I'm tempted to just recreate the documents in HTML, translating paragraph by paragraph using Google Translate, but that definitely is the Hard Way, but I do like the result being HTML (as opposed to PDF).  I haven't translated whole documents before, so I don't know what (free) tools are available for this, and what works best.
 

Offline SiliconWizard

  • Super Contributor
  • ***
  • Posts: 15683
  • Country: fr
Re: WCH PIOC documentation: Chinese PDFs to English?
« Reply #1 on: October 06, 2024, 08:43:26 am »
I tested this and it appears to work: https://www.onlinedoctranslator.com/en/translationform

Had a quick look at the PIOC translated document, not enough to figure out if we can really use it as a reference manual, but it looks readable. The Index doesn't look translated, but otherwise the content is.

 
The following users thanked this post: Nominal Animal

Offline nctnico

  • Super Contributor
  • ***
  • Posts: 28335
  • Country: nl
    • NCT Developments
Re: WCH PIOC documentation: Chinese PDFs to English?
« Reply #2 on: October 06, 2024, 05:23:51 pm »
I second the suggestion for https://www.onlinedoctranslator.com/en/  I have used it myself a couple of time with good succes for translating technical Chinese documents  (and even donated some money ;D )
I won't say the translation is 100% perfect as I can't check with the original but the English translation was more than good enough to get me an understanding of what the document is about.
« Last Edit: October 06, 2024, 05:26:11 pm by nctnico »
There are small lies, big lies and then there is what is on the screen of your oscilloscope.
 

Offline SiliconWizard

  • Super Contributor
  • ***
  • Posts: 15683
  • Country: fr
Re: WCH PIOC documentation: Chinese PDFs to English?
« Reply #3 on: October 06, 2024, 08:35:18 pm »
Could be useful. Now... I just found out that the EN version of these docs was there: https://github.com/openwch/ch32x035/tree/main/EVT/EXAM/PIOC
 
The following users thanked this post: Nominal Animal

Offline xvr

  • Frequent Contributor
  • **
  • Posts: 535
  • Country: ie
    • LinkedIn
Re: WCH PIOC documentation: Chinese PDFs to English?
« Reply #4 on: October 10, 2024, 06:21:57 pm »
Google Translate can translate documents, including pdf. It can slightly alter visual appearance of pdf document, but in general it works good.
 

Offline Nominal AnimalTopic starter

  • Super Contributor
  • ***
  • Posts: 7132
  • Country: fi
    • My home page and email address
Re: WCH PIOC documentation: Chinese PDFs to English?
« Reply #5 on: October 10, 2024, 06:48:48 pm »
Note that SiliconWizard in reply #3 linked to the English versions of these documents, so it turns out there is no need to translate these particular ones. :phew:
 

Offline SiliconWizard

  • Super Contributor
  • ***
  • Posts: 15683
  • Country: fr
Re: WCH PIOC documentation: Chinese PDFs to English?
« Reply #6 on: October 10, 2024, 08:38:33 pm »
I have taken a quick look, and haven't done anything with it yet. I wonder if the docs are enough to, say, write your own assembler? (Which may have been one of your goals, as the assembler tool looks like it's windows-only with no source code, at least that I've seen.)

Looking at the datasheet, just to get an idea of this PIOC thing, apparently it can control only up to 2 GPIOs. And they have implemented a full, yet minimal RISC core for that, as opposed to the RPi PIO, which is much simpler.
 

Offline tszaboo

  • Super Contributor
  • ***
  • Posts: 8169
  • Country: nl
  • Current job: ATEX product design
Re: WCH PIOC documentation: Chinese PDFs to English?
« Reply #7 on: October 10, 2024, 09:02:09 pm »
I have taken a quick look, and haven't done anything with it yet. I wonder if the docs are enough to, say, write your own assembler? (Which may have been one of your goals, as the assembler tool looks like it's windows-only with no source code, at least that I've seen.)

Looking at the datasheet, just to get an idea of this PIOC thing, apparently it can control only up to 2 GPIOs. And they have implemented a full, yet minimal RISC core for that, as opposed to the RPi PIO, which is much simpler.
Probably there for the USB-PD implementation. 2 pins sounds very useless for pretty much anything else. Maybe those blinkenlights.
 


Share me

Digg  Facebook  SlashDot  Delicious  Technorati  Twitter  Google  Yahoo
Smf