1. Overview
The CH583M-EVT is an evaluation board designed for developing with the CH583 RISC-V Core BLE5.3 Wireless Microcontroller. It provides a robust platform for testing and verifying basic functions, equipped with a BLE antenna, indicator LED, USB interfaces, and extension connectors. The board supports development using the MountRiver compiler and the ISP tool, with application reference examples and demonstrations available for various chip resources.


2. Specifications
2.1. Microcontroller Features (CH583)
- 32-bit RISC processor, Qingke V4A.
- RV32IMAC instruction sets, hardware multiplication and division.
- 32KB SRAM, 512KB Flash. Supports ICP, ISP, IAP, and OTA wireless upgrade.
- Built-in 2.4GHz RF transceiver with band and link control. BLE5.3 compliant.
- Supports 2Mbps, 1Mbps, 500Kbps, and 125Kbps data rates.
- -98dBm receiving sensitivity, programmable +7dBm transfer power.
- Integrated protocol stack and API.
- Built-in temperature sensor.
- Built-in RTC (Real-Time Clock), supporting two modes: timing and trigger.
- 2 USB2.0 full-speed Host/Device interfaces.
- 14-channel touch-key.
- 14-channel 12-bit ADC.
- 4 UARTs, 2 SPIs, 12-channel PWM, and 1-channel IIC.
- 40 GPIO ports, with 4 ports supporting 5V signal input.
- Minimum power supply of 1.7V.
- Built-in AES-128 encryption/decryption unit, unique ID.
- Package: QFN48.

2.2. Evaluation Board Functional Components
- Switch (S1): Supply switch, used to connect or disconnect external 5V supply or USB supply.
- RESET Button: Used for external manual reset. Note: The manual reset function of the chip needs to be enabled.
- DOWNLOAD Button: Used when downloading firmware with the ISP tool.
- USB Interfaces: Two USB communication interfaces for the main chip, supporting both Host and Device functions.
- Extension Connectors (P2/P3): Includes chip functional pins, power pins, and LED load operation pins.

3. Setup Instructions
3.1. Hardware Connection
- Ensure the S1 switch is in the OFF position before connecting power.
- Connect the CH583M-EVT board to your computer via a USB cable. This will provide power to the board.
- Alternatively, an external 5V power supply can be connected. Use the S1 switch to select the desired power source.
- For development, connect the board to your PC via a serial port (e.g., COM1) for communication and debugging, if required by your application.
3.2. Antenna Design Considerations
The CH583 utilizes a 2.4GHz small-size PCB antenna. For optimal performance, consider the following:
- Impedance Matching: A 50Ω impedance is required when wiring from the chip pins to the antenna feed point (Area 'A' in antenna design diagrams). Parameters like wiring width, distance between 'A' and 'B', PCB thickness, dielectric constant, copper thickness, and green oil thickness affect coupling.
- Reference Ground: Area 'B' serves as a coplanar reference ground. Ensure sufficient area and number of ground holes.
- Ground Pad: Area 'C' is the ground pad at the bottom of the chip. Good grounding and heat dissipation (via multiple ground holes) are crucial.
- Interference: Keep the RF part away from potential interference sources such as crystals, power components, and switching power supplies.
- The PCB thickness of the evaluation board's antenna is 0.8mm. For detailed antenna sizes, refer to the PCB design documentation provided by the manufacturer.

4. Software Development
4.1. EVT Packet Directory Structure
The EVT (Evaluation) packet typically contains the following structure:
CH583EVT(Root Directory)PUB: Contains evaluation board manuals and schematics (e.g.,CH583EVT Evaluation Board Manual.pdf,CH583SCH.pdf).EXAM: Contains CH583 controller software development drivers and examples, categorized by peripherals. Each peripheral folder includes functional application routine folders.

4.2. Opening a Project
- Navigate to the
EXAMfolder and select any peripheral project. For instance, double-click on thePeripheralfolder to open the BLE slave routine. - Double-click the
Peripheral.wvprojfile to open the project in MounRiver Studio. - If importing an existing project, use the 'Import' menu option in MounRiver Studio, then select 'Existing Projects into Workspace' and browse to the project folder.

4.3. Compiling the Project
In MounRiver Studio:
- Click the 'Build' button (usually marked '1' for incremental build) to compile modified parts quickly.
- Alternatively, click the 'Rebuild' button (usually marked '2' for global rebuild) to compile the entire selected project.
- After successful compilation, an executable file with a
.hexsuffix will be created. This.hexfile is ready for download to the evaluation board. - Refer to the 'MounRiver Studio Help Manual' for details on compilation settings, project file directories, linker, and optimization levels.

4.4. Downloading Firmware (ISP)
The CH583 supports In-System Programming (ISP) via both serial port and USB interface. It is recommended to use USB for faster downloads, especially for larger codebases.
4.4.1. ISP Tool Setup
Download the WCHISPTool software from the official WCH website: http://wch.cn/downloads/WCHISPTool_Setup_exe.html.
4.4.2. Download via Serial Port
- Open the
WCHISPTool.exesoftware. - Select the chip model: CH583.
- Choose SerialPort as the download type and select the appropriate COM port.
- Connect pin PB22 of the MCU to GND. Ensure the MCU is not powered on during this connection.
- Supply power to the board.
- The PC tool should detect available serial ports. If not, verify your serial port connection.
- Click the Download button to begin burning the firmware.
- Monitor the Download record for burning results. User codes will run immediately after successful download. You can also re-power or reset the board to run the new code. If burning fails, repeat steps 4-5.
4.4.3. Download via USB
- Open the
WCHISPTool.exesoftware. - Select the chip model: CH583.
- Choose USB as the download type.
- Connect pin PB22 of the MCU to GND. Ensure the MCU is not powered on during this connection.
- Supply power to the board.
- The PC tool should detect USB devices. If not, verify your USB connection and repeat steps 1-3.
- Click the Download button to begin burning the firmware.
- Monitor the Download record for burning results. User codes will run immediately after successful download. You can also re-power or reset the board to run the new code. If burning fails, repeat steps 4-5.


5. Operating Instructions: BLE Peripheral Routine
This section outlines the steps to run a basic BLE Peripheral routine on the CH583M-EVT board.
- Prepare the Routine:
Open the routine located atCH583EVT\EXAM\BLE\Peripheral\Peripheral.wvprojin MounRiver Studio. Compile the project. - Download Firmware:
Open the generatedPeripheral.hexfile with the WCHISPTool. Press the DOWNLOAD button on the board to power it, and connect the board to your PC via serial port (COM1 by default). - Monitor COM Output:
Open a COMTransmit tool (or similar serial terminal) and configure it with a baud rate of 115200, 8 data bits, 1 stop bit, and no parity. Download the program. The COMTransmit tool window should display:CH58x_BLE_LIB_V1.11 Initialized. Advertising...This indicates the board has started BLE advertising. - Scan with BLE Debug Tool:
Open the 'BLE Debug Tool' application on your mobile device or PC. Click the SCAN button to find BLE devices. You should see a device named "Simple Peripheral". This represents the BLE device simulated by the routine. - Connect to Device:
Click on "Simple Peripheral" to connect. Upon successful connection, the serial port will output "Connected.". The APP will display the connection completion window, showing services like "Generic Access", "Generic Attribute", "Device Information", and "Unknown Service". - Explore Unknown Service (0xFFE0):
The "Unknown Service" is a custom communication service (UUID 0xFFE0). Click on it to view its characteristics: "0xFFE1", "0xFFE2", "0xFFE3", "0xFFE4", and "0xFFE5", along with their properties. - Interact with 0xFFE1 (READ/WRITE):
Click on the "0xFFE1" characteristic. It supports READ and WRITE properties. Enter a single byte in the Transmit Input box and click Send. The board will transmit "profile ChangeCB CHAR1...". Click Read to verify the byte sent. - Interact with 0xFFE2 (READ):
Return to the previous level ("Unknown Characteristic's communication"). The "0xFFE2" service has a READ property, allowing read operations. - Interact with 0xFFE3 (WRITE):
The "0xFFE3" service has a WRITE property, allowing write operations. - Interact with 0xFFE4 (NOTIFY):
The "0xFFE4" service has a NOTIFY property, meaning it actively transmits data to the host. Switch on the "Receive notification data" option in the operation window. The device will send a byte (e.g., "0x30") which will be received in the receiving box. Remember to close the notification when finished. - Interact with 0xFFE5 (AUTHENTICATION/READ):
The "0xFFE5" service has authentication and read properties. It can only be read after entering the pairing key. Click Read in the Receive/Transmit window. The BLE pairing window will appear. The default pairing code is "000000". Select PIN code and click OK to pair. Once paired, the service can be operated; otherwise, the device may disconnect.




6. Maintenance
To ensure the longevity and proper functioning of your CH583M-EVT Development Board:
- Keep the board clean and free from dust and debris. Use a soft, dry cloth for cleaning.
- Avoid exposing the board to extreme temperatures, humidity, or direct sunlight.
- Store the board in an anti-static bag when not in use to prevent electrostatic discharge damage.
- Handle the board by its edges to avoid touching sensitive components.
7. Troubleshooting
- Firmware Download Failure: If firmware burning fails via serial or USB, ensure pin PB22 is correctly connected to GND before powering the board. Double-check the selected chip model and download type in WCHISPTool. Repeat the download steps carefully.
- Serial Port Not Detected: If the required serial port is not found during ISP or COM monitoring, verify the USB-to-serial driver installation and check the physical connection of the serial cable.
- BLE Device Disconnection/Pairing Issues: During BLE pairing, if the device disconnects or fails to pair, ensure the correct pairing code ("000000" by default) is entered. Note that pairing behavior may vary across different mobile devices.
- General Connectivity Issues: Ensure all cables are securely connected. Check power supply to the board.
8. User Tips
- Wireless Applications: This development board is ideal for various wireless applications, especially those leveraging BLE5.3 capabilities.
- Development Environment: Familiarize yourself with MounRiver Studio and the WCHISPTool for efficient development and debugging.
- Pin Configuration: Always refer to the detailed pinout diagrams and functional specifications when connecting external components to the extension connectors (P2/P3) to avoid damage.
- Power Management: Be mindful of the power source (USB or external 5V) and ensure stable power delivery, especially during firmware flashing.
9. Support
For further technical support, detailed documentation, and the latest software downloads, please refer to the official WCH website: http://wch.cn.
If you encounter issues not covered in this manual, please contact the seller for assistance.





