1. הקדמה
The Waveshare Atmel-ICE Basic Kit is a powerful development tool designed for debugging and programming Atmel SAM and AVR microcontrollers that feature on-chip debug capabilities. This kit supports a wide range of interfaces including JTAG, SWD, PDI, TPI, aWire, SPI, and debugWIRE, making it versatile for various embedded development tasks. It is an essential tool for developers working with Atmel's ARM Cortex-M based SAM and AVR architectures.
2. שליסל פֿעיִקייטן
- Supports debugging and programming of Atmel ARM Cortex-M based Atmel SAM and AVR microcontrollers with on-chip debug capability.
- Compatible with JTAG, SWD, PDI, TPI, aWire, SPI, and debugWIRE interfaces.
- Utilizes all built-in hardware breakpoints available in the target microcontroller.
- Offers up to 128 software breakpoints for comprehensive debugging.
- Operates with target voltagעס איז פֿון 1.62 וו צו 5.5 וו.
- USB געטריבן פֿאַר באַקוועמלעכקייט.
- Provides both ARM Cortex Debug Connector (10-pin) pin-out and AVR JTAG connector pin-out.
3. קאַמפּאָונאַנץ ינקלודעד
The Waveshare Atmel-ICE Basic Kit (Atmel-ICE-B2) includes the following components:
- Atmel-ICE Unit
- וסב קאַבלע
- 10-pin 50-mil JTAG/SWD Cable
- 6-pin 100-mil AVR ISP/debugWIRE/PDI/aWire/TPI Cable
- אַדאַפּטער באָרד
- 6-pin to 10-pin ISP Cable

פיגורע 1: איבערview of the Waveshare Atmel-ICE Basic Kit components, including the Atmel-ICE unit, USB cable, various ribbon cables, and the adapter board.

פיגורע 2: נאָענט-אַרויף view of the Atmel-ICE unit, a compact white device with blue accents and indicator lights.

פיגורע 3: Various connection cables and the blue adapter board included in the kit, essential for connecting to different target microcontrollers.
4. סעטאַפּ און קאַנעקשאַן
Proper connection of the Atmel-ICE to your target microcontroller is crucial for successful debugging and programming. The kit includes an adapter board and various cables to facilitate connections to different pin-outs.
4.1 Adapter Board Overview

פיגורע 4: Top view of the adapter board, showing various headers for different connection types.

פיגורע 5: דנאָ view of the adapter board, illustrating the pin labels for JTAG, SWD, PDI, SPI, TPI, aWire, and SAM JTAG/SWD ינטערפייסיז.
4.2 קאַנעקשאַן אָפּציעס
The Atmel-ICE supports various connection configurations for SAM and AVR microcontrollers. Refer to the diagrams below for typical connection setups.

פיגורע 6: Detailed diagrams showing Atmel-ICE connection options for SAM and AVR targets, including pinout configurations for 10-pin AVR JTAG, 6-pin AVR ISP/debugWIRE/PDI/aWire/TPI, and 10-pin SAM JTAG/SWD headers.
באַמערקונג:
- When connecting the adapter board to a target, pay attention to Pin 1 (indicated by a white spot or square solder pad).
- The adapter board included in Atmel-ICE-B2 is compatible with the official one in the Atmel-ICE Full Kit.
5. Supported Software and Devices
The Atmel-ICE is designed to work seamlessly with industry-standard development environments and supports a broad range of Atmel microcontrollers.

פיגורע 7: Information on supported software (e.g., Atmel Studio 6.2 or higher, ICCAVR, CVAVR, IAR) and a list of supported Atmel AVR and SAM devices for programming and debugging.
5.1 Supported Software
- Perfectly supports Atmel Studio 6.2 or higher version.
- Directly supports ICCAVR or higher version.
- Supports programming HEX files generated by ICCAVR, CVAVR, IAR, etc.
5.2 שטיצט דעוויסעס
- Programming and on-chip debugging of all Atmel AVR 32-bit MCUs on both JTAG and aWire interfaces.
- Programming and on-chip debugging of all Atmel AVR XMEGA® family devices on both JTAG and PDI 2-wire interfaces.
- JTAG and SPI programming and debugging of all Atmel AVR 8-bit MCUs with OCD support on either JTAG or debugWIRE interfaces.
- Programming and debugging of all Atmel SAM ARM Cortex-M based MCUs on both SWD and JTAG ינטערפייסיז.
- Programming of all Atmel tinyAVR® 8-bit MCUs with support for the TPI interface.
6. אַפּערייטינג ינסטרוקטיאָנס
Once the Atmel-ICE is physically connected to your target device and powered via USB, you can begin debugging or programming using your chosen Integrated Development Environment (IDE), such as Atmel Studio. The specific steps will vary depending on your IDE and the target microcontroller, but generally involve:
- ינסטאַלירן דריווערס: Ensure all necessary drivers for the Atmel-ICE are installed on your computer. These are typically included with Atmel Studio.
- Connect Atmel-ICE: Connect the Atmel-ICE unit to your computer via the USB cable and to your target board using the appropriate ribbon cable and adapter.
- Power Target: Ensure your target microcontroller board is powered correctly.
- Open IDE: Launch your development environment (e.g., Atmel Studio).
- אויסקלייבן געצייג: In the IDE, select Atmel-ICE as your programming/debugging tool.
- Configure Project: Configure your project settings to match your target microcontroller and the desired interface (JTAG, SWD, etc.).
- אָנהייב סעסיע: Initiate a debugging session or program the device as required by your project.
7. וישאַלט
To ensure the longevity and reliable operation of your Atmel-ICE Basic Kit, follow these general maintenance guidelines:
- האַלטן ריין: Regularly clean the device and cables with a soft, dry cloth. Avoid using harsh chemicals or abrasive materials.
- סטאָר רעכט: האַלט דעם קיט אין אַ טרוקענער, שטויב-פֿרײַער סביבה ווען נישט אין באַנוץ.
- שעפּן מיט זאָרג: Avoid dropping the device or subjecting it to physical shock. Do not pull cables by the wire; always grasp the connector.
- ויסמיידן נעץ: באַשיצן די מיטל פון נעץ און עקסטרעם טעמפּעראַטורעס.
8. טראָובלעשאָאָטינג
If you encounter issues with your Atmel-ICE Basic Kit, consider the following troubleshooting steps:
- קשר טשעק: Verify all cables are securely connected to the Atmel-ICE, the adapter board, and the target microcontroller. Ensure Pin 1 alignment is correct.
- מאַכט צושטעלן: Confirm that both the Atmel-ICE (via USB) and the target board are properly powered.
- דרייווער ינסטאַלירונג: Ensure the latest drivers for the Atmel-ICE are installed on your computer. Reinstalling drivers can sometimes resolve connectivity issues.
- IDE Configuration: Double-check your IDE settings to ensure the correct programming/debugging tool (Atmel-ICE) and interface are selected for your target device.
- ציל וואָלtage: Verify that the target microcontroller's operating voltage is within the Atmel-ICE's supported range (1.62V to 5.5V).
- Firmware דערהייַנטיקן: Check if a firmware update is available for your Atmel-ICE unit through your IDE.
- באַראַטן זיך מיט די דאָקומענטאַציע: Refer to the official Atmel Studio documentation or Waveshare's online resources for specific error codes or advanced troubleshooting.
9. ספּעסאַפאַקיישאַנז
Detailed technical specifications for the Waveshare Atmel-ICE Basic Kit:
| שטריך | דעטאַל |
|---|---|
| סאָרט | וואַוועשאַרע |
| מאָדעל נומער | Atmel-ICE-B2 |
| צובינד וואָלtage | 1.62 וו - 5.5 וו |
| JTAG זייגער | 32KHz – 7.5MHz |
| PDI Clock | 32KHz – 7.5MHz |
| debugWIRE Baudrate | 4Kbit/s – 0.5Mbit/s |
| aWire Baudrate | 7.5Kbit/s – 7Mbit/s |
| ספּי זייגער | 8KHz – 5MHz |
| SWD זייגער | 32KHz – 2MHz |
| פּיסי צובינד | וסב 2.0 הויך גיכקייַט |
| קאַנעקטיוויטי טעכנאָלאָגיע | וסב |
| אַפּערייטינג סיסטעם קאַמפּאַטאַבילאַטי | Linux (and typically Windows with Atmel Studio) |
| פּונקט וואָג | 0.01 אונסעס |
| פּראָדוקט דימענשאַנז (LxWxH) | 7.09 X 3.94 X 3.54 אינטשעס |
| פאַבריקאַנט | וואַוועשאַרע |
10. Development Resources
For additional information, detailed guides, and community support, please visit the official Waveshare Wiki page for Atmel-ICE:
11. סעלעקציע גייד
The Atmel-ICE series offers different kits. The Atmel-ICE Basic Kit (Atmel-ICE-B2) provides essential functionality. For a comparison of the different Atmel-ICE versions, refer to the guide below:

פיגורע 8: Comparison table illustrating the components included in Atmel-ICE, Atmel-ICE-B2 (Basic Kit), and Atmel-ICE-C versions.
- Atmel-ICE: Includes everything in the official Atmel-ICE Full Kit, plus an extra free 6-pin to 10-pin ISP cable.
- Atmel-ICE-B2: Includes everything in the official Atmel ICE Basic Kit, and more adapter and cables from Waveshare, provides the same functions as Atmel-ICE Full Kit in lower price.
12. וואָראַנטי און שטיצן
For warranty information and technical support, please refer to the official Waveshare webזייטל אדער קאנטאקט זייער קאסטומער סערוויס גלייך. האלט אייער קויף קוויטל אלס באווייז פון קויפן פאר יעדע גאראנטיע טענות.





