==============================================================================
  󥳥ǥ` (One Coin Decoder X)  -  README.txt
==============================================================================
   (Author) : Nucky
  ޥ      : WCH CH32V003 ` (J4M6 / F4P6)
==============================================================================

1. Ҫ (Overview)
------------------------------------------------------------------------------
󥳥ǥ`ءϡǸܤWCHu늈R?ͥԥRISC-Vޥ
CH32V003äDCCǥ`ץȤǤ

1ĤΥ``Yb顢ѥ륹åޥxФ椨ǡ
¤4Nήʤ륿`åȥϩ`ɥ򤱥ե`०Ǥޤ

TARGET_8PIN_LOCO  : 8ԥޥʹäСͤ܇I?``ǥ`
TARGET_20PIN_LOCO : 20ԥޥʹäBEMFؓaե륹ڥåǥ`
TARGET_8PIN_FUNC  : ``ꡢ4_ե󥯥󣨥饤ȣåǥ`
TARGET_8PIN_POINT : ݥȥޥ󣨥ΥlӣäΥ`ǥ`


2. ʙCܤ؏ (Features)
------------------------------------------------------------------------------
܇IãLOCOͨCܡ
NMRAҎ˜ʒDCCźŽ`ȥɥ쥹󥰥ɥ쥹Ԅж
3ٶȥ`{Vstart, Vmid, Vhighå`ȡ󥿥ࣨӜp٣I
MзܞrԄһrֹͣܞݩ`Cܤˤ륮䱣o
Υ`PWMܲ32kHz8kHz2kHz500HzCVФ椨
ե󥯥ޥåԥ󥰣F0?F12ꡢCV33?46ˤܛʥԥ굱ƣ
CV8ؤΡ8zߤˤեȥ`ꥻåșCܡ
IOFx`ɣCV30=2ˤꡢ``F0ܞO·Ȥÿܡ

20ԥ܇Iã20PIN_LOCOÙCܡ
BEMFiȡPIDˤ`ɥڥ󥻩`󣨶У
ǤBEMFAĤ˜p˥륫åȥșCܣCV10

ݥã8PIN_POINTÙCܡ
ΥɟpֹΤͨ늕rgޣCV3PWMޣCV6
Ф椨ֱBAƤ륬`ɥOCV9
Դڶϕrˤǰؤ_ͨ״Bӛ?ԪCV64Ԅӱ棩


3. ե똋 (File Structure)
------------------------------------------------------------------------------
ץȤϡ¤ΥեǘɤƤޤ

main.c            : ȥ`ݥȡڻ1ms޹DCCޥɤΥѥåȽ
decoder_config.h  : ϩ`ɥ󻯣HALOxkԥ굱ƤһԪ
dcc_core.c / .h   : DCCźŤⲿzߣEXTIˤ륨åӋy?ӥåȽM?`ӥ`ɄI
motor_ctrl.c / .h : ``PWMBEMFy?PID㡢ե󥯥AckMݥlӡ
cv_manager.c / .h : CVΥå壨RAMFlashؤ16bitgλEEPROM?ڻ


4. _kh  ѥ뷽 (Development & Compilation)
------------------------------------------------------------------------------
եȥϡWCH繫ʽνy_khIDEMounRiver Studioʹä
ӥɤӥޥؤΕzߤФޤ

혡
1. MounRiver Studio ӤץȣCH32V003äCZץȣ_ޤ
2. decoder_config.h_ӥɤηN˺Ϥ碌ơ¤Τ줫1Ĥ
   xΥȥȤЄޤ3ĤϱؤȥȤƤ

      #define TARGET_8PIN_LOCO     // 8ԥ?Сͥ`ǥ`Έ
      //#define TARGET_20PIN_LOCO  // 20ԥ?ե륹ڥåBEMFУΈ
      //#define TARGET_8PIN_FUNC   // 8ԥ?ե󥯥äΈ
      //#define TARGET_8PIN_POINT  // 8ԥ?ݥȌäΈ

3. ʹä``ɥ饤ICˏꤸơͬdecoder_config.hڤǥåxkޤ
   ?TB67H450 ȣؓՓ?LowONʹä -> #define USE_TB67H450 Є
   ?BD6231 ȣՓ?HighONʹä -> #define USE_BD6231 Є

4. ĩ`Щ`ΡBuildܥ󣨥ϥީ`Υ󣩤򥯥åѥgФޤ
   `ӥ`˥󥰤0Ǥ뤳Ȥ_JƤ
5. WCH-LinkEȤΕzޥSWIOGNDVCCԥ˽ӾAޤ
6. ĩ`Щ`ΡDownloadܥ򥯥åޥ˥ե`०zߤޤ


5. ҪCVһE (Key Configuration Variables)
------------------------------------------------------------------------------
ǥ`ǥݩ`ȤƤĤCV˘ǤCV1?CV64ˌ꣩

܇I?ե󥯥ͨ
CV1  : `ȥɥ쥹 (ڂ: 3)
CV2  : Vstart / 늈R (ڂ: 0)
CV3  :  / 󥿥 (ڂ: 0)
CV4  : p / 󥿥 (ڂ: 0)
CV5  : Vhigh / 늈R (ڂ: 255)
CV6  : Vmid / g늈R (ڂ: 0 / 01Εrֱag)
CV8  : ``ID (156: Web Nucky) 8zȥեȥ`ꥻå
CV9  : `PWMܲ (0: 32kHz, 1: 8kHz, 2: 2kHz, 3: 500Hz)
CV29 : ե` (bit0:ܞ, bit1:28/128ƥå, bit5:󥰥ɥ쥹Є)
CV33-CV46 : ե󥯥ޥåԥ (F0 FWD, F0 REV, F1-F12)
CV47 : å`ȳ־Arg
CV48 : å`ȏ

20ԥ܇IBEMFvB
CV10 : BEMFåȥ (OٶȥƥåϤBEMFե`ɥȡ0ǟo)
CV50 : BEMFЄ/o (0: o, 1: Є)
CV51 : P / Ώ (ڂ: 10)
CV52 : I / eΏ (ڂ: 3)
CV53 : BEMFyrΥ֥󥭥󥰥 (ڂ: 14 = 140us)
CV54 : BEMFץ (ڂ: 20 = 20ms)

ݥȌá
CV1  : `ɥ쥹λ
CV2  : `ɥ쥹λ
CV3  : Υͨ늕rg (x10ms, ڂ: 5 = 50ms)
CV4  : O (bit01ΤȤͨ늽Kȫ`)
CV5  : ܞǥ쥤 (Ф椨ܸgH˄ӤޤǤW)
CV6  : PWM / Duty (ڂ: 127 = s50%ѥ`pֹ)
CV9  : `ɥ (Ф椨BAֹrgx100ms)
CV64 : sI_ͨӛ (0ޤ1ƥबԄӤiߕ)


6. ``ɤΥ饤󥹤ˤĤ
------------------------------------------------------------------------------
``ɤؤϷŗƤ餺٤Nuckyˎޤ
եȥϡ¤Υǥ奢饤󥹷ʽṩޤ

1. [GPL]
   ˤ⟵ģͤιǤáоĉɤǤ
   `ɤĉ䤷եȥ_?CϤˤϡGPLv3˻Ť
   ؤ``ɤ_xդޤ

2. []
   ``ɤ_ʤΤǤuƷ؜ӡؤνMzߵȤä
   ϣΈϤϡؤǰˤBjGPLȤτeå饤
   Commercial License򤴰ڤޤ

--- English Notice ---
This software is dual-licensed:
1. GPLv3: For personal, non-commercial, and open-source use.
2. Commercial License: REQUIRED for any commercial use or products 
   without source code disclosure. Please contact the author via the website.


7. ؟ (Disclaimer)
------------------------------------------------------------------------------
ץäˤäǥ`܇IΙCĤƓpߺϡ
ӤʤpˤĤƤ⡢ߤһФ؟Τؓͤޤ
⟵ģͤ늚ݵԤ褯⤷Ϥǡ؟ΤˤƤʹä

This program is distributed WITHOUT ANY WARRANTY. Use at your own risk.
==============================================================================