C8051F336-GMR

C8051F336/7/8/9 Mixed-Signal Byte-Programmable EPROM MCU Analog Peripherals - 10-Bit ADC (‘F336/8 only) - Up to 200 ksps Up to 20 external single-ended or differential inputs VREF from on-chip VREF, external pin or VDD Internal or external start of conversion source Built-in temperature sensor Sectors (512 bytes are reserved) Digital Peripherals - 21 or 17 Port I/O; All 5 V tolerant with high sink 10-Bit Current Output DAC (‘F336/8 only) Comparator • • - Programmable hysteresis and response time Configurable as interrupt or reset source On-Chip Debug - On-chip debug circuitry facilitates full speed, non- - intrusive in-system debug (no emulator required) Provides breakpoints, single stepping, inspect/modify memory and registers Superior performance to emulation systems using ICE-chips, target pods, and sockets Low cost, complete development kit - Temperature Range: –40 to +85 °C - DIGITAL I/O 10-bit Current DAC + ‘F336/8 Only 80/20/40/10 kHz low-frequency, low-power oscillator External oscillator: Crystal, RC, C, or clock (1 or 2 pin modes) Can switch between clock sources on-the-fly; useful in power saving modes 20 or 24-Pin QFN (4 x 4 mm) ANALOG PERIPHERALS TEMP SENSOR Supports crystal-less UART operation Low-power suspend mode with fast wake time • • instructions in 1 or 2 system clocks Up to 25 MIPS throughput with 25 MHz clock Expanded interrupt handler 10-bit 200 ksps ADC Hardware enhanced UART, SMBus™ (I2C compatible), and enhanced SPI™ serial ports Four general purpose 16-bit counter/timers 16-Bit programmable counter array (PCA) with three capture/compare modules and enhanced PWM functionality Real time clock mode using timer and crystal Clock Sources - 24.5 MHz ±2% Oscillator Supply Voltage 2.7 to 3.6 V - Built-in voltage supply monitor High-Speed 8051 µC Core - Pipelined instruction architecture; executes 70% of A M U X current Pin-compatible with C8051F330 family of MCUs – VOLTAGE COMPARATOR 24.5 MHz PRECISION INTERNAL OSCILLATOR UART SMBus SPI PCA Timer 0 Timer 1 Timer 2 Timer 3 CROSSBAR • • • • • Memory - 768 bytes internal data RAM (256 + 512) - 16 kB Flash; In-system programmable in 512-byte Port 0 Port 1 P2.0– P2.3* P2.4* *P2.1–2.4 QFN24 Only LOW FREQUENCY INTERNAL OSCILLATOR HIGH-SPEED CONTROLLER CORE 16 kB ISP FLASH FLEXIBLE INTERRUPTS Rev. 1.0 9/08 8051 CPU (25 MIPS) DEBUG CIRCUITRY 768 B SRAM POR Copyright © 2008 by Silicon Laboratories WDT C8051F336/7/8/9 C8051F336/7/8/9 2 Rev. 1.0 C8051F336/7/8/9 Table of Contents 1. System Overview ..................................................................................................... 15 2. Ordering Information ............................................................................................... 18 3. Pin Definitions.......................................................................................................... 19 4. QFN-20 Package Specifications ............................................................................. 23 5. QFN-24 Package Specifications ............................................................................. 25 6. Electrical Characteristics ........................................................................................ 27 6.1. Absolute Maximum Specifications..................................................................... 27 6.2. Electrical Characteristics ................................................................................... 28 6.3. Typical Performance Curves ............................................................................. 36 7. 10-Bit ADC (ADC0, C8051F336/8 only)................................................................... 37 7.1. Output Code Formatting .................................................................................... 38 7.2. Modes of Operation ........................................................................................... 38 7.2.1. Starting a Conversion................................................................................ 38 7.2.2. Tracking Modes......................................................................................... 39 7.2.3. Settling Time Requirements...................................................................... 40 7.3. Programmable Window Detector....................................................................... 44 7.3.1. Window Detector In Single-Ended Mode .................................................. 46 7.3.2. Window Detector In Differential Mode....................................................... 47 7.4. ADC0 Analog Multiplexer (C8051F336/8 only).................................................. 48 8. Temperature Sensor (C8051F336/8 only) .............................................................. 51 9. 10-Bit Current Mode DAC (IDA0, C8051F336/8 only) ............................................ 52 9.1. IDA0 Output Scheduling .................................................................................... 52 9.1.1. Update Output On-Demand ...................................................................... 52 9.1.2. Update Output Based on Timer Overflow ................................................. 53 9.1.3. Update Output Based on CNVSTR Edge ................................................. 53 9.2. IDAC Output Mapping ....................................................................................... 53 10. Voltage Reference (C8051F336/8 only) ................................................................ 56 11. Comparator0........................................................................................................... 58 11.1. Comparator Multiplexer ................................................................................... 63 12. CIP-51 Microcontroller........................................................................................... 65 12.1. Instruction Set.................................................................................................. 66 12.1.1. Instruction and CPU Timing .................................................................... 66 12.2. CIP-51 Register Descriptions .......................................................................... 71 13. Memory Organization ............................................................................................ 74 13.1. Program Memory............................................................................................. 75 13.1.1. MOVX Instruction and Program Memory ................................................ 75 13.2. Data Memory ................................................................................................... 75 13.2.1. Internal RAM ........................................................................................... 75 13.2.1.1. General Purpose Registers ............................................................ 76 13.2.1.2. Bit Addressable Locations .............................................................. 76 13.2.1.3. Stack ............................................................................................ 76 13.2.2. External RAM .......................................................................................... 76 Rev.1.0 3 C8051F336/7/8/9 14. Special Function Registers................................................................................... 78 15. Interrupts ................................................................................................................ 82 15.1. MCU Interrupt Sources and Vectors................................................................ 83 15.1.1. Interrupt Priorities.................................................................................... 83 15.1.2. Interrupt Latency ..................................................................................... 83 15.2. Interrupt Register Descriptions ........................................................................ 84 15.3. External Interrupts /INT0 and /INT1................................................................. 89 16. Flash Memory......................................................................................................... 91 16.1. Programming The Flash Memory .................................................................... 91 16.1.1. Flash Lock and Key Functions ................................................................ 91 16.1.2. Flash Erase Procedure ........................................................................... 91 16.1.3. Flash Write Procedure ............................................................................ 92 16.2. Non-volatile Data Storage ............................................................................... 92 16.3. Security Options .............................................................................................. 93 16.4. Flash Write and Erase Guidelines ................................................................... 95 16.4.1. VDD Maintenance and the VDD monitor .................................................. 95 16.4.2. PSWE Maintenance ................................................................................ 95 16.4.3. System Clock .......................................................................................... 96 17. Reset Sources ...................................................................................................... 100 17.1. Power-On Reset ............................................................................................ 101 17.2. Power-Fail Reset / VDD Monitor ................................................................... 102 17.3. External Reset ............................................................................................... 103 17.4. Missing Clock Detector Reset ....................................................................... 103 17.5. Comparator0 Reset ....................................................................................... 104 17.6. PCA Watchdog Timer Reset ......................................................................... 104 17.7. Flash Error Reset .......................................................................................... 104 17.8. Software Reset .............................................................................................. 104 18. Power Management Modes................................................................................. 106 18.1. Idle Mode....................................................................................................... 106 18.2. Stop Mode ..................................................................................................... 107 18.3. Suspend Mode .............................................................................................. 107 19. Oscillators and Clock Selection ......................................................................... 109 19.1. System Clock Selection................................................................................. 109 19.2. Programmable Internal High-Frequency (H-F) Oscillator .............................. 111 19.2.1. Internal Oscillator Suspend Mode ......................................................... 111 19.3. Programmable Internal Low-Frequency (L-F) Oscillator ............................... 113 19.3.1. Calibrating the Internal L-F Oscillator.................................................... 113 19.4. External Oscillator Drive Circuit..................................................................... 114 19.4.1. External Crystal Example...................................................................... 116 19.4.2. External RC Example............................................................................ 117 19.4.3. External Capacitor Example.................................................................. 118 20. Port Input/Output ................................................................................................. 119 20.1. Port I/O Modes of Operation.......................................................................... 120 20.1.1. Port Pins Configured for Analog I/O...................................................... 120 20.1.2. Port Pins Configured For Digital I/O...................................................... 120 4 Rev.1.0 C8051F336/7/8/9 20.1.3. Interfacing Port I/O to 5V Logic ............................................................. 121 20.2. Assigning Port I/O Pins to Analog and Digital Functions............................... 122 20.2.1. Assigning Port I/O Pins to Analog Functions ........................................ 122 20.2.2. Assigning Port I/O Pins to Digital Functions.......................................... 122 20.2.3. Assigning Port I/O Pins to External Event Trigger Functions................ 123 20.3. Priority Crossbar Decoder ............................................................................. 124 20.4. Port I/O Initialization ...................................................................................... 126 20.5. Port Match ..................................................................................................... 129 20.6. Special Function Registers for Accessing and Configuring Port I/O ............. 131 21. SMBus................................................................................................................... 138 21.1. Supporting Documents .................................................................................. 139 21.2. SMBus Configuration..................................................................................... 139 21.3. SMBus Operation .......................................................................................... 139 21.3.1. Transmitter Vs. Receiver....................................................................... 140 21.3.2. Arbitration.............................................................................................. 140 21.3.3. Clock Low Extension............................................................................. 140 21.3.4. SCL Low Timeout.................................................................................. 140 21.3.5. SCL High (SMBus Free) Timeout ......................................................... 141 21.4. Using the SMBus........................................................................................... 141 21.4.1. SMBus Configuration Register.............................................................. 141 21.4.2. SMB0CN Control Register .................................................................... 145 21.4.2.1. Software ACK Generation ............................................................ 145 21.4.2.2. Hardware ACK Generation ........................................................... 145 21.4.3. Hardware Slave Address Recognition .................................................. 147 21.4.4. Data Register ........................................................................................ 150 21.5. SMBus Transfer Modes................................................................................. 151 21.5.1. Write Sequence (Master) ...................................................................... 151 21.5.2. Read Sequence (Master) ...................................................................... 152 21.5.3. Write Sequence (Slave) ........................................................................ 153 21.5.4. Read Sequence (Slave) ........................................................................ 154 21.6. SMBus Status Decoding................................................................................ 154 22. UART0 ................................................................................................................... 159 22.1. Enhanced Baud Rate Generation.................................................................. 160 22.2. Operational Modes ........................................................................................ 161 22.2.1. 8-Bit UART ............................................................................................ 161 22.2.2. 9-Bit UART ............................................................................................ 162 22.3. Multiprocessor Communications ................................................................... 163 23. Enhanced Serial Peripheral Interface (SPI0) ..................................................... 167 23.1. Signal Descriptions........................................................................................ 168 23.1.1. Master Out, Slave In (MOSI)................................................................. 168 23.1.2. Master In, Slave Out (MISO)................................................................. 168 23.1.3. Serial Clock (SCK) ................................................................................ 168 23.1.4. Slave Select (NSS) ............................................................................... 168 23.2. SPI0 Master Mode Operation ........................................................................ 169 23.3. SPI0 Slave Mode Operation .......................................................................... 170 Rev.1.0 5 C8051F336/7/8/9 23.4. SPI0 Interrupt Sources .................................................................................. 171 23.5. Serial Clock Phase and Polarity .................................................................... 171 23.6. SPI Special Function Registers ..................................................................... 173 24. Timers ................................................................................................................... 180 24.1. Timer 0 and Timer 1 ...................................................................................... 182 24.1.1. Mode 0: 13-bit Counter/Timer ............................................................... 182 24.1.2. Mode 1: 16-bit Counter/Timer ............................................................... 183 24.1.3. Mode 2: 8-bit Counter/Timer with Auto-Reload..................................... 184 24.1.4. Mode 3: Two 8-bit Counter/Timers (Timer 0 Only)................................ 185 24.2. Timer 2 .......................................................................................................... 190 24.2.1. 16-bit Timer with Auto-Reload............................................................... 190 24.2.2. 8-bit Timers with Auto-Reload............................................................... 191 24.2.3. Low-Frequency Oscillator (LFO) Capture Mode ................................... 192 24.3. Timer 3 .......................................................................................................... 196 24.3.1. 16-bit Timer with Auto-Reload............................................................... 196 24.3.2. 8-bit Timers with Auto-Reload............................................................... 197 24.3.3. Low-Frequency Oscillator (LFO) Capture Mode ................................... 198 25. Programmable Counter Array............................................................................. 202 25.1. PCA Counter/Timer ....................................................................................... 203 25.2. PCA0 Interrupt Sources................................................................................. 204 25.3. Capture/Compare Modules ........................................................................... 205 25.3.1. Edge-triggered Capture Mode............................................................... 206 25.3.2. Software Timer (Compare) Mode.......................................................... 207 25.3.3. High-Speed Output Mode ..................................................................... 208 25.3.4. Frequency Output Mode ....................................................................... 209 25.3.5. 8-bit, 9-bit, 10-bit and 11-bit Pulse Width Modulator Modes ................ 209 25.3.5.1. 8-bit Pulse Width Modulator Mode............................................... 210 25.3.5.2. 9/10/11-bit Pulse Width Modulator Mode..................................... 211 25.3.6. 16-Bit Pulse Width Modulator Mode..................................................... 212 25.4. Watchdog Timer Mode .................................................................................. 213 25.4.1. Watchdog Timer Operation ................................................................... 213 25.4.2. Watchdog Timer Usage ........................................................................ 214 25.5. Register Descriptions for PCA0..................................................................... 215 26. C2 Interface .......................................................................................................... 221 26.1. C2 Interface Registers................................................................................... 221 26.2. C2 Pin Sharing .............................................................................................. 224 Document Change List............................................................................................. 225 Contact Information.................................................................................................. 226 6 Rev.1.0 C8051F336/7/8/9 List of Figures 1. System Overview Figure 1.1. C8051F336/7 Block Diagram ................................................................ 16 Figure 1.2. C8051F338/9 Block Diagram ................................................................ 17 2. Ordering Information 3. Pin Definitions Figure 3.1. QFN-20 Pinout Diagram (Top View) ..................................................... 21 Figure 3.2. QFN-24 Pinout Diagram (Top View) ..................................................... 22 4. QFN-20 Package Specifications Figure 4.1. QFN-20 Package Drawing .................................................................... 23 Figure 4.2. QFN-20 Recommended PCB Land Pattern .......................................... 24 5. QFN-24 Package Specifications Figure 5.1. QFN-24 Package Drawing .................................................................... 25 Figure 5.2. QFN-24 Recommended PCB Land Pattern .......................................... 26 6. Electrical Characteristics Figure 6.1. Normal Mode Digital Supply Current vs. Frequency ............................. 36 Figure 6.2. Idle Mode Digital Supply Current vs. Frequency ................................... 36 7. 10-Bit ADC (ADC0, C8051F336/8 only) Figure 7.1. ADC0 Functional Block Diagram ........................................................... 37 Figure 7.2. 10-Bit ADC Track and Conversion Example Timing ............................. 39 Figure 7.3. ADC0 Equivalent Input Circuits ............................................................. 40 Figure 7.4. ADC Window Compare Example: Right-Justified Single-Ended Data .. 46 Figure 7.5. ADC Window Compare Example: Left-Justified Single-Ended Data ..... 46 Figure 7.6. ADC Window Compare Example: Right-Justified Differential Data ....... 47 Figure 7.7. ADC Window Compare Example: Left-Justified Differential Data ......... 47 Figure 7.8. ADC0 Multiplexer Block Diagram .......................................................... 48 8. Temperature Sensor (C8051F336/8 only) Figure 8.1. Temperature Sensor Transfer Function ................................................ 51 9. 10-Bit Current Mode DAC (IDA0, C8051F336/8 only) Figure 9.1. IDA0 Functional Block Diagram ............................................................ 52 Figure 9.2. IDA0 Data Word Mapping ..................................................................... 53 10. Voltage Reference (C8051F336/8 only) Figure 10.1. Voltage Reference Functional Block Diagram ..................................... 56 11. Comparator0 Figure 11.1. Comparator0 Functional Block Diagram ............................................. 58 Figure 11.2. Comparator Hysteresis Plot ................................................................ 59 Figure 11.3. Comparator Input Multiplexer Block Diagram ...................................... 63 12. CIP-51 Microcontroller Figure 12.1. CIP-51 Block Diagram ......................................................................... 65 13. Memory Organization Figure 13.1. C8051F336/7/8/9 Memory Map ........................................................... 74 Figure 13.2. Flash Program Memory Map ............................................................... 75 14. Special Function Registers Rev.1.0 7 C8051F336/7/8/9 15. Interrupts 16. Flash Memory Figure 16.1. Security Byte Decoding ....................................................................... 93 17. Reset Sources Figure 17.1. Reset Sources ................................................................................... 100 Figure 17.2. Power-On and VDD Monitor Reset Timing ....................................... 101 18. Power Management Modes 19. Oscillators and Clock Selection Figure 19.1. Oscillator Options .............................................................................. 109 Figure 19.2. External 32.768 kHz Quartz Crystal Oscillator Connection Diagram 117 20. Port Input/Output Figure 20.1. Port I/O Functional Block Diagram .................................................... 119 Figure 20.2. Port I/O Cell Block Diagram .............................................................. 121 Figure 20.3. Port I/O Overdrive Current ................................................................ 121 Figure 20.4. Crossbar Priority Decoder - Possible Pin Assignments .................... 124 Figure 20.5. Crossbar Priority Decoder Example .................................................. 125 21. SMBus Figure 21.1. SMBus Block Diagram ...................................................................... 138 Figure 21.2. Typical SMBus Configuration ............................................................ 139 Figure 21.3. SMBus Transaction ........................................................................... 140 Figure 21.4. Typical SMBus SCL Generation ........................................................ 142 Figure 21.5. Typical Master Write Sequence ........................................................ 151 Figure 21.6. Typical Master Read Sequence ........................................................ 152 Figure 21.7. Typical Slave Write Sequence .......................................................... 153 Figure 21.8. Typical Slave Read Sequence .......................................................... 154 22. UART0 Figure 22.1. UART0 Block Diagram ...................................................................... 159 Figure 22.2. UART0 Baud Rate Logic ................................................................... 160 Figure 22.3. UART Interconnect Diagram ............................................................. 161 Figure 22.4. 8-Bit UART Timing Diagram .............................................................. 161 Figure 22.5. 9-Bit UART Timing Diagram .............................................................. 162 Figure 22.6. UART Multi-Processor Mode Interconnect Diagram ......................... 163 23. Enhanced Serial Peripheral Interface (SPI0) Figure 23.1. SPI Block Diagram ............................................................................ 167 Figure 23.2. Multiple-Master Mode Connection Diagram ...................................... 169 Figure 23.3. 3-Wire Single Master and 3-Wire Single Slave Mode Connection Diagram 170 Figure 23.4. 4-Wire Single Master Mode and 4-Wire Slave Mode Connection Diagram 170 Figure 23.5. Master Mode Data/Clock Timing ....................................................... 172 Figure 23.6. Slave Mode Data/Clock Timing (CKPHA = 0) ................................... 172 Figure 23.7. Slave Mode Data/Clock Timing (CKPHA = 1) ................................... 173 Figure 23.8. SPI Master Timing (CKPHA = 0) ....................................................... 177 Figure 23.9. SPI Master Timing (CKPHA = 1) ....................................................... 177 Figure 23.10. SPI Slave Timing (CKPHA = 0) ....................................................... 178 8 Rev.1.0 C8051F336/7/8/9 Figure 23.11. SPI Slave Timing (CKPHA = 1) ....................................................... 178 24. Timers Figure 24.1. T0 Mode 0 Block Diagram ................................................................. 183 Figure 24.2. T0 Mode 2 Block Diagram ................................................................. 184 Figure 24.3. T0 Mode 3 Block Diagram ................................................................. 185 Figure 24.4. Timer 2 16-Bit Mode Block Diagram ................................................. 190 Figure 24.5. Timer 2 8-Bit Mode Block Diagram ................................................... 191 Figure 24.6. Timer 2 Low-Frequency Oscillation Capture Mode Block Diagram ... 192 Figure 24.7. Timer 3 16-Bit Mode Block Diagram ................................................. 196 Figure 24.8. Timer 3 8-Bit Mode Block Diagram ................................................... 197 Figure 24.9. Timer 3 Low-Frequency Oscillation Capture Mode Block Diagram ... 198 25. Programmable Counter Array Figure 25.1. PCA Block Diagram ........................................................................... 202 Figure 25.2. PCA Counter/Timer Block Diagram ................................................... 203 Figure 25.3. PCA Interrupt Block Diagram ............................................................ 204 Figure 25.4. PCA Capture Mode Diagram ............................................................. 206 Figure 25.5. PCA Software Timer Mode Diagram ................................................. 207 Figure 25.6. PCA High-Speed Output Mode Diagram ........................................... 208 Figure 25.7. PCA Frequency Output Mode ........................................................... 209 Figure 25.8. PCA 8-Bit PWM Mode Diagram ........................................................ 210 Figure 25.9. PCA 9, 10 and 11-Bit PWM Mode Diagram ...................................... 211 Figure 25.10. PCA 16-Bit PWM Mode ................................................................... 212 Figure 25.11. PCA Module 2 with Watchdog Timer Enabled ................................ 213 26. C2 Interface Figure 26.1. Typical C2 Pin Sharing ...................................................................... 224 Rev.1.0 9 C8051F336/7/8/9 List of Tables 1. System Overview 2. Ordering Information Table 2.1. Product Selection Guide ......................................................................... 18 3. Pin Definitions Table 3.1. Pin Definitions for the C8051F336/7/8/9 ................................................. 19 4. QFN-20 Package Specifications Table 4.1. QFN-20 Package Dimensions ................................................................ 23 Table 4.2. QFN-20 PCB Land Pattern Dimesions ................................................... 24 5. QFN-24 Package Specifications Table 5.1. QFN-24 Package Dimensions ................................................................ 25 Table 5.2. QFN-24 PCB Land Pattern Dimesions ................................................... 26 6. Electrical Characteristics Table 6.1. Absolute Maximum Ratings .................................................................... 27 Table 6.2. Global Electrical Characteristics ............................................................. 28 Table 6.3. Port I/O DC Electrical Characteristics ..................................................... 29 Table 6.4. Reset Electrical Characteristics .............................................................. 30 Table 6.5. Flash Electrical Characteristics ............................................................... 30 Table 6.6. Internal High-Frequency Oscillator Electrical Characteristics ................. 31 Table 6.7. Internal Low-Frequency Oscillator Electrical Characteristics .................. 31 Table 6.8. ADC0 Electrical Characteristics .............................................................. 32 Table 6.9. Temperature Sensor Electrical Characteristics ...................................... 33 Table 6.10. Voltage Reference Electrical Characteristics ........................................ 33 Table 6.11. IDAC Electrical Characteristics ............................................................. 34 Table 6.12. Comparator Electrical Characteristics .................................................. 35 7. 10-Bit ADC (ADC0, C8051F336/8 only) 8. Temperature Sensor (C8051F336/8 only) 9. 10-Bit Current Mode DAC (IDA0, C8051F336/8 only) 10. Voltage Reference (C8051F336/8 only) 11. Comparator0 12. CIP-51 Microcontroller Table 12.1. CIP-51 Instruction Set Summary .......................................................... 67 13. Memory Organization 14. Special Function Registers Table 14.1. Special Function Register (SFR) Memory Map .................................... 78 Table 14.2. Special Function Registers ................................................................... 79 15. Interrupts Table 15.1. Interrupt Summary ................................................................................ 84 16. Flash Memory Table 16.1. Flash Security Summary ....................................................................... 94 17. Reset Sources 18. Power Management Modes 19. Oscillators and Clock Selection 20. Port Input/Output Rev.1.0 10 C8051F336/7/8/9 Table 20.1. Port I/O Assignment for Analog Functions ......................................... 122 Table 20.2. Port I/O Assignment for Digital Functions ........................................... 122 Table 20.3. Port I/O Assignment for External Event Trigger Functions ................. 123 21. SMBus Table 21.1. SMBus Clock Source Selection .......................................................... 142 Table 21.2. Minimum SDA Setup and Hold Times ................................................ 143 Table 21.3. Sources for Hardware Changes to SMB0CN ..................................... 147 Table 21.4. Hardware Address Recognition Examples (EHACK = 1) ................... 148 Table 21.5. SMBus Status Decoding With Hardware ACK Generation Disabled (EHACK = 0) ....................................................................................... 155 Table 21.6. SMBus Status Decoding With Hardware ACK Generation Enabled (EHACK = 1) ....................................................................................... 157 22. UART0 Table 22.1. Timer Settings for Standard Baud Rates Using The Internal 24.5 MHz Oscillator .............................................. 166 Table 22.2. Timer Settings for Standard Baud Rates Using an External 22.1184 MHz Oscillator ......................................... 166 23. Enhanced Serial Peripheral Interface (SPI0) Table 23.1. SPI Slave Timing Parameters ............................................................ 179 24. Timers 25. Programmable Counter Array Table 25.1. PCA Timebase Input Options ............................................................. 203 Table 25.2. PCA0CPM and PCA0PWM Bit Settings for PCA Capture/Compare Modules ..................................................................................................... 205 Table 25.3. Watchdog Timer Timeout Intervals1 ................................................... 214 26. C2 Interface 11 Rev.1.0 C8051F336/7/8/9 List of Registers SFR Definition 7.1. ADC0CF: ADC0 Configuration ...................................................... 41 SFR Definition 7.2. ADC0H: ADC0 Data Word MSB .................................................... 42 SFR Definition 7.3. ADC0L: ADC0 Data Word LSB ...................................................... 42 SFR Definition 7.4. ADC0CN: ADC0 Control ................................................................ 43 SFR Definition 7.5. ADC0GTH: ADC0 Greater-Than Data High Byte .......................... 44 SFR Definition 7.6. ADC0GTL: ADC0 Greater-Than Data Low Byte ............................ 44 SFR Definition 7.7. ADC0LTH: ADC0 Less-Than Data High Byte ................................ 45 SFR Definition 7.8. ADC0LTL: ADC0 Less-Than Data Low Byte ................................. 45 SFR Definition 7.9. AMX0P: AMUX0 Positive Channel Select ..................................... 49 SFR Definition 7.10. AMX0N: AMUX0 Negative Channel Select ................................. 50 SFR Definition 9.1. IDA0CN: IDA0 Control ................................................................... 54 SFR Definition 9.2. IDA0H: IDA0 Data Word MSB ....................................................... 55 SFR Definition 9.3. IDA0L: IDA0 Data Word LSB ......................................................... 55 SFR Definition 10.1. REF0CN: Reference Control ....................................................... 57 SFR Definition 11.1. CPT0CN: Comparator0 Control ................................................... 61 SFR Definition 11.2. CPT0MD: Comparator0 Mode Selection ..................................... 62 SFR Definition 11.3. CPT0MX: Comparator0 MUX Selection ...................................... 64 SFR Definition 12.1. DPL: Data Pointer Low Byte ........................................................ 71 SFR Definition 12.2. DPH: Data Pointer High Byte ....................................................... 71 SFR Definition 12.3. SP: Stack Pointer ......................................................................... 72 SFR Definition 12.4. ACC: Accumulator ....................................................................... 72 SFR Definition 12.5. B: B Register ................................................................................ 72 SFR Definition 12.6. PSW: Program Status Word ........................................................ 73 SFR Definition 13.1. EMI0CN: External Memory Interface Control .............................. 77 SFR Definition 15.1. IE: Interrupt Enable ...................................................................... 85 SFR Definition 15.2. IP: Interrupt Priority ...................................................................... 86 SFR Definition 15.3. EIE1: Extended Interrupt Enable 1 .............................................. 87 SFR Definition 15.4. EIP1: Extended Interrupt Priority 1 .............................................. 88 SFR Definition 15.5. IT01CF: INT0/INT1 Configuration ................................................ 90 SFR Definition 16.1. PSCTL: Program Store R/W Control ........................................... 97 SFR Definition 16.2. FLKEY: Flash Lock and Key ........................................................ 98 SFR Definition 16.3. FLSCL: Flash Scale ..................................................................... 99 SFR Definition 17.1. VDM0CN: VDD Monitor Control ................................................ 103 SFR Definition 17.2. RSTSRC: Reset Source ............................................................ 105 SFR Definition 18.1. PCON: Power Control ................................................................ 108 SFR Definition 19.1. CLKSEL: Clock Select ............................................................... 110 SFR Definition 19.2. OSCICL: Internal H-F Oscillator Calibration .............................. 111 SFR Definition 19.3. OSCICN: Internal H-F Oscillator Control ................................... 112 SFR Definition 19.4. OSCLCN: Internal L-F Oscillator Control ................................... 113 SFR Definition 19.5. OSCXCN: External Oscillator Control ........................................ 115 SFR Definition 20.1. XBR0: Port I/O Crossbar Register 0 .......................................... 127 SFR Definition 20.2. XBR1: Port I/O Crossbar Register 1 .......................................... 128 SFR Definition 20.3. P0MASK: Port 0 Mask Register ................................................. 129 Rev.1.0 12 C8051F336/7/8/9 SFR Definition 20.4. P0MAT: Port 0 Match Register .................................................. 130 SFR Definition 20.5. P1MASK: Port 1 Mask Register ................................................. 130 SFR Definition 20.6. P1MAT: Port 1 Match Register .................................................. 131 SFR Definition 20.7. P0: Port 0 ................................................................................... 132 SFR Definition 20.8. P0MDIN: Port 0 Input Mode ....................................................... 132 SFR Definition 20.9. P0MDOUT: Port 0 Output Mode ................................................ 133 SFR Definition 20.10. P0SKIP: Port 0 Skip ................................................................. 133 SFR Definition 20.11. P1: Port 1 ................................................................................. 134 SFR Definition 20.12. P1MDIN: Port 1 Input Mode ..................................................... 134 SFR Definition 20.13. P1MDOUT: Port 1 Output Mode .............................................. 135 SFR Definition 20.14. P1SKIP: Port 1 Skip ................................................................. 135 SFR Definition 20.15. P2: Port 2 ................................................................................. 136 SFR Definition 20.16. P2MDIN: Port 2 Input Mode ..................................................... 136 SFR Definition 20.17. P2MDOUT: Port 2 Output Mode .............................................. 137 SFR Definition 20.18. P2SKIP: Port 2 Skip ................................................................. 137 SFR Definition 21.1. SMB0CF: SMBus Clock/Configuration ...................................... 144 SFR Definition 21.2. SMB0CN: SMBus Control .......................................................... 146 SFR Definition 21.3. SMB0ADR: SMBus Slave Address ............................................ 148 SFR Definition 21.4. SMB0ADM: SMBus Slave Address Mask .................................. 149 SFR Definition 21.5. SMB0DAT: SMBus Data ............................................................ 150 SFR Definition 22.1. SCON0: Serial Port 0 Control .................................................... 164 SFR Definition 22.2. SBUF0: Serial (UART0) Port Data Buffer .................................. 165 SFR Definition 23.1. SPI0CFG: SPI0 Configuration ................................................... 174 SFR Definition 23.2. SPI0CN: SPI0 Control ............................................................... 175 SFR Definition 23.3. SPI0CKR: SPI0 Clock Rate ....................................................... 176 SFR Definition 23.4. SPI0DAT: SPI0 Data ................................................................. 176 SFR Definition 24.1. CKCON: Clock Control .............................................................. 181 SFR Definition 24.2. TCON: Timer Control ................................................................. 186 SFR Definition 24.3. TMOD: Timer Mode ................................................................... 187 SFR Definition 24.4. TL0: Timer 0 Low Byte ............................................................... 188 SFR Definition 24.5. TL1: Timer 1 Low Byte ............................................................... 188 SFR Definition 24.6. TH0: Timer 0 High Byte ............................................................. 189 SFR Definition 24.7. TH1: Timer 1 High Byte ............................................................. 189 SFR Definition 24.8. TMR2CN: Timer 2 Control ......................................................... 193 SFR Definition 24.9. TMR2RLL: Timer 2 Reload Register Low Byte .......................... 194 SFR Definition 24.10. TMR2RLH: Timer 2 Reload Register High Byte ...................... 194 SFR Definition 24.11. TMR2L: Timer 2 Low Byte ....................................................... 194 SFR Definition 24.12. TMR2H Timer 2 High Byte ....................................................... 195 SFR Definition 24.13. TMR3CN: Timer 3 Control ....................................................... 199 SFR Definition 24.14. TMR3RLL: Timer 3 Reload Register Low Byte ........................ 200 SFR Definition 24.15. TMR3RLH: Timer 3 Reload Register High Byte ...................... 200 SFR Definition 24.16. TMR3L: Timer 3 Low Byte ....................................................... 200 SFR Definition 24.17. TMR3H Timer 3 High Byte ....................................................... 201 SFR Definition 25.1. PCA0CN: PCA Control .............................................................. 215 SFR Definition 25.2. PCA0MD: PCA Mode ................................................................ 216 13 Rev.1.0 C8051F336/7/8/9 SFR Definition 25.3. PCA0PWM: PCA PWM Configuration ....................................... 217 SFR Definition 25.4. PCA0CPMn: PCA Capture/Compare Mode .............................. 218 SFR Definition 25.5. PCA0L: PCA Counter/Timer Low Byte ...................................... 219 SFR Definition 25.6. PCA0H: PCA Counter/Timer High Byte ..................................... 219 SFR Definition 25.7. PCA0CPLn: PCA Capture Module Low Byte ............................. 220 SFR Definition 25.8. PCA0CPHn: PCA Capture Module High Byte ........................... 220 C2 Register Definition 26.1. C2ADD: C2 Address ...................................................... 221 C2 Register Definition 26.2. DEVICEID: C2 Device ID ............................................... 222 C2 Register Definition 26.3. REVID: C2 Revision ID .................................................. 222 C2 Register Definition 26.4. FPCTL: C2 Flash Programming Control ........................ 223 C2 Register Definition 26.5. FPDAT: C2 Flash Programming Data ............................ 223 Rev.1.0 14 C8051F336/7/8/9 1. System Overview C8051F336/7/8/9 devices are fully integrated mixed-signal System-on-a-Chip MCUs. Highlighted features are listed below. Refer to Section “2. Ordering Information” on page 18 for specific product feature selection and part ordering numbers.             High-speed pipelined 8051-compatible microcontroller core (up to 25 MIPS) In-system, full-speed, non-intrusive debug interface (on-chip) True 10-bit 200 ksps 20-channel single-ended/differential ADC with analog multiplexer 10-bit Current Output DAC Precision programmable 24.5 MHz internal oscillator Low-power, low-frequency oscillator 16 kB of on-chip Flash memory—512 bytes are reserved 768 bytes of on-chip RAM SMBus/I2C, Enhanced UART, and Enhanced SPI serial interfaces implemented in hardware Four general-purpose 16-bit timers Programmable Counter/Timer Array (PCA) with three capture/compare modules and Watchdog Timer function On-chip Power-On Reset, VDD Monitor, and Temperature Sensor  On-chip Voltage Comparator  21 or 17 Port I/O (5 V tolerant)  Low-power suspend mode with fast wake-up time With on-chip Power-On Reset, VDD monitor, Watchdog Timer, and clock oscillator, the C8051F336/7/8/9 devices are truly stand-alone System-on-a-Chip solutions. The Flash memory can be reprogrammed even in-circuit, providing non-volatile data storage, and also allowing field upgrades of the 8051 firmware. User software has complete control of all peripherals, and may individually shut down any or all peripherals for power savings. The on-chip Silicon Labs 2-Wire (C2) Development Interface allows non-intrusive (uses no on-chip resources), full speed, in-circuit debugging using the production MCU installed in the final application. This debug logic supports inspection and modification of memory and registers, setting breakpoints, single stepping, run and halt commands. All analog and digital peripherals are fully functional while debugging using C2. The two C2 interface pins can be shared with user functions, allowing in-system debugging without occupying package pins. Each device is specified for 2.7 to 3.6 V operation over the industrial temperature range (–40 to +85 °C). The Port I/O and RST pins are tolerant of input signals up to 5 V. The C8051F336/7 are available in a 20pin QFN package and the C8051F338/9 are available in a 24-pin QFN package. Both package options are lead-free and RoHS compliant. See Section “2. Ordering Information” on page 18 for ordering information. Block diagrams are included in Figure 1.1 and Figure 1.2. Rev.1.0 15 C8051F336/7/8/9 Power On Reset Reset C2CK/RST Debug / Programming Hardware Port I/O Configuration CIP-51 8051 Controller Core Port 0 Drivers P0.0/VREF P0.1/IDA0 P0.2/XTAL1 P0.3/XTAL2 P0.4/TX P0.5/RX P0.6/CNVSTR P0.7 Port 1 Drivers P1.0 P1.1 P1.2 P1.3 P1.4 P1.5 P1.6 P1.7 Digital Peripherals 16k Byte ISP Flash Program Memory UART 256 Byte SRAM Timers 0, 1, 2, 3 512 Byte XRAM PCA/ WDT C2D Priority Crossbar Decoder SMBus VDD SPI Power Net SYSCLK Crossbar Control SFR Bus GND Precision 24.5 MHz Oscillator Analog Peripherals 10-bit IDAC VDD Low-Freq. Oscillator XTAL1 XTAL2 External Oscillator Circuit IDA0 VREF A M U X 10-bit 200 ksps ADC VDD VREF Temp Sensor GND C8051F336 Only CP0, CP0A System Clock Configuration + - Comparator Figure 1.1. C8051F336/7 Block Diagram 16 Rev.1.0 Port 2 Drivers P2.0/C2D C8051F336/7/8/9 Power On Reset Reset C2CK/RST Debug / Programming Hardware Port I/O Configuration CIP-51 8051 Controller Core Port 0 Drivers P0.0/VREF P0.1/IDA0 P0.2/XTAL1 P0.3/XTAL2 P0.4/TX P0.5/RX P0.6/CNVSTR P0.7 Port 1 Drivers P1.0 P1.1 P1.2 P1.3 P1.4 P1.5 P1.6 P1.7 Port 2 Drivers P2.0 P2.1 P2.2 P2.3 P2.4/C2D Digital Peripherals 16 kB ISP Flash Program Memory UART 256 Byte SRAM Timers 0, 1, 2, 3 512 Byte XRAM PCA/ WDT C2D Priority Crossbar Decoder SMBus VDD SPI Power Net SYSCLK Crossbar Control SFR Bus GND Precision 24.5 MHz Oscillator Analog Peripherals 10-bit IDAC VDD Low-Freq. Oscillator XTAL1 XTAL2 External Oscillator Circuit System Clock Configuration IDA0 VREF A M U X 10-bit 200 ksps ADC VDD VREF Temp Sensor GND C8051F338 Only CP0, CP0A + - Comparator Figure 1.2. C8051F338/9 Block Diagram Rev.1.0 17 Calibrated Internal 24.5 MHz Oscillator Internal 80 kHz Oscillator SMBus/I2C Enhanced SPI UART Timers (16-bit) RTC OPeration Programmable Counter Array Digital Port I/Os C8051F336-GM 25 16 768 Y Y Y Y Y 4 Y Y 17 C8051F337-GM 25 16 768 Y Y Y Y Y 4 Y Y 17 — — — — Y Y QFN-20 C8051F338-GM 25 16 768 Y Y Y Y Y 4 Y Y 21 Y Y Y QFN-24 C8051F339-GM 25 16 768 Y Y Y Y Y 4 Y Y 21 — — — — Y Y QFN-24 Rev.1.0 10-bit 200ksps ADC 10-bit Current Output DAC Internal Voltage Reference Temperature Sensor Analog Comparator Lead-Free / RoHS Compliant Package RAM (bytes) Flash Memory (kB) MIPS (Peak) Ordering Part Number C8051F336/7/8/9 2. Ordering Information Table 2.1. Product Selection Guide Y Y Y Y Y Y QFN-20 Y Y Y 18 C8051F336/7/8/9 3. Pin Definitions Table 3.1. Pin Definitions for the C8051F336/7/8/9 Name Pin ’F336/7 Pin ’F338/9 VDD 3 4 Power Supply Voltage. GND 2 3 Ground. This ground connection is required. The center pad may optionally be connected to ground also. RST/ 4 5 C2CK C2D 5 6 P0.0/ 1 2 VREF P0.1 20 1 24 XTAL1 P0.3/ Device Reset. Open-drain output of internal POR or VDD monitor. An external source can initiate a system reset by driving this pin low for at least 10 µs. D I/O Clock signal for the C2 Debug Interface. D I/O Bi-directional data signal for the C2 Debug Interface. Shared with P2.0 on 20-pin packaging and P2.4 on 24-pin packaging. D I/O or Port 0.0. A In 23 XTAL2 IDA0 Output. D I/O or Port 0.2. A In A In 18 External VREF input. D I/O or Port 0.1. A In A Out 19 Description D I/O A In IDA0 P0.2/ Type External Clock Input. This pin is the external oscillator return for a crystal or resonator. D I/O or Port 0.3. A In A I/O or External Clock Output. For an external crystal or resonator, this pin is the excitation driver. This pin is the external clock D In input for CMOS, capacitor, or RC oscillator configurations. P0.4 17 22 D I/O or Port 0.4. A In P0.5 16 21 D I/O or Port 0.5. A In P0.6/ 15 20 D I/O or Port 0.6. A In CNVSTR D In ADC0 External Convert Start or IDA0 Update Source Input. Rev.1.0 19 C8051F336/7/8/9 Table 3.1. Pin Definitions for the C8051F336/7/8/9 (Continued) 20 Name Pin ’F336/7 Pin ’F338/9 Type P0.7 14 19 D I/O or Port 0.7. A In P1.0 13 18 D I/O or Port 1.0. A In P1.1 12 17 D I/O or Port 1.1. A In P1.2 11 16 D I/O or Port 1.2. A In P1.3 10 15 D I/O or Port 1.3. A In P1.4 9 14 D I/O or Port 1.4. A In P1.5 8 13 D I/O or Port 1.5. A In P1.6 7 12 D I/O or Port 1.6. A In P1.7 6 11 D I/O or Port 1.7. A In P2.0 5 10 D I/O or Port 2.0. (Also C2D on 20-pin Packaging) A In P2.1 — 9 D I/O or Port 2.1. A In P2.2 — 8 D I/O or Port 2.2. A In P2.3 — 7 D I/O or Port 2.3. A In P2.4 — 6 D I/O Description Port 2.4. (Also C2D on 24-pin Packaging) Rev.1.0 P0.1 P0.2 P0.3 P0.4 P0.5 20 19 18 17 16 C8051F336/7/8/9 P0.0 1 15 P0.6 GND 2 14 P0.7 VDD 3 13 P1.0 /RST/C2CK 4 12 P1.1 P2.0/C2D 5 11 P1.2 C8051F336/7 Top View 8 9 10 P1.4 P1.3 7 P1.6 P1.5 6 P1.7 GND (optional) Figure 3.1. QFN-20 Pinout Diagram (Top View) Rev.1.0 21 19 P0.7 20 P0.6 21 P0.5 22 P0.4 23 P0.3 24 P0.2 C8051F336/7/8/9 P0.1 1 18 P1.0 P0.0 2 17 P1.1 GND 3 16 P1.2 VDD 4 15 P1.3 /RST/C2CK 5 14 P1.4 P2.4/C2D 6 13 P1.5 C8051F338/9 Top View P1.6 12 P1.7 11 P2.0 10 9 8 P2.2 P2.1 7 P2.3 GND (optional) Figure 3.2. QFN-24 Pinout Diagram (Top View) 22 Rev.1.0 C8051F336/7/8/9 4. QFN-20 Package Specifications Figure 4.1. QFN-20 Package Drawing Table 4.1. QFN-20 Package Dimensions Dimension Min Typ Max Dimension Min Typ Max A A1 b D D2 e E E2 0.80 0.00 0.18 0.90 0.02 0.25 4.00 BSC. 2.15 0.50 BSC. 4.00 BSC. 2.15 1.00 0.05 0.30 L L1 aaa bbb ddd eee Z Y 0.45 0.00 — — — — — — 0.55 — — — — — 0.43 0.18 0.65 0.15 0.15 0.10 0.05 0.08 — — 2.00 2.00 2.25 2.25 Notes: 1. All dimensions shown are in millimeters (mm) unless otherwise noted. 2. Dimensioning and Tolerancing per ANSI Y14.5M-1994. 3. This drawing conforms to the JEDEC Solid State Outline MO-220, variation VGGD except for custom features D2, E2, Z, Y, and L which are toleranced per supplier designation. 4. Recommended card reflow profile is per the JEDEC/IPC J-STD-020C specification for Small Body Components. Rev.1.0 23 C8051F336/7/8/9 Figure 4.2. QFN-20 Recommended PCB Land Pattern Table 4.2. QFN-20 PCB Land Pattern Dimesions Dimension C1 C2 E X1 Min Max Dimension Min Max X2 Y1 Y2 2.15 0.90 2.15 2.25 1.00 2.25 3.70 3.70 0.50 0.20 0.30 Notes: General 1. All dimensions shown are in millimeters (mm) unless otherwise noted. 2. Dimensioning and Tolerancing is per the ANSI Y14.5M-1994 specification. 3. This Land Pattern Design is based on the IPC-7351 guidelines. Solder Mask Design 4. All metal pads are to be non-solder mask defined (NSMD). Clearance between the solder mask and the metal pad is to be 60μm minimum, all the way around the pad. Stencil Design 5. A stainless steel, laser-cut and electro-polished stencil with trapezoidal walls should be used to assure good solder paste release. 6. The stencil thickness should be 0.125mm (5 mils). 7. The ratio of stencil aperture to land pad size should be 1:1 for all perimeter pins. 8. A 2x2 array of 0.95mm openings on a 1.1mm pitch should be used for the center pad to assure the proper paste volume (71% Paste Coverage). Card Assembly 9. A No-Clean, Type-3 solder paste is recommended. 10. The recommended card reflow profile is per the JEDEC/IPC J-STD-020C specification for Small Body Components. 24 Rev.1.0 C8051F336/7/8/9 5. QFN-24 Package Specifications Figure 5.1. QFN-24 Package Drawing Table 5.1. QFN-24 Package Dimensions Dimension Min Typ Max Dimension Min Typ Max A A1 b D D2 e E E2 0.70 0.00 0.18 0.75 0.02 0.25 4.00 BSC. 2.70 0.50 BSC. 4.00 BSC. 2.70 0.80 0.05 0.30 L L1 aaa bbb ddd eee Z Y 0.30 0.00 — — — — — — 0.40 — — — — — 0.24 0.18 0.50 0.15 0.15 0.10 0.05 0.08 — — 2.55 2.55 2.80 2.80 Notes: 1. All dimensions shown are in millimeters (mm) unless otherwise noted. 2. Dimensioning and Tolerancing per ANSI Y14.5M-1994. 3. This drawing conforms to JEDEC Solid State Outline MO-220, variation WGGD except for custom features D2, E2, Z, Y, and L which are toleranced per supplier designation. 4. Recommended card reflow profile is per the JEDEC/IPC J-STD-020C specification for Small Body Components. Rev.1.0 25 C8051F336/7/8/9 Figure 5.2. QFN-24 Recommended PCB Land Pattern Table 5.2. QFN-24 PCB Land Pattern Dimesions Dimension Min Max Dimension Min Max C1 C2 E X1 3.90 3.90 4.00 4.00 X2 Y1 Y2 2.70 0.65 2.70 2.80 0.75 2.80 0.50 BSC 0.20 0.30 Notes: General 1. All dimensions shown are in millimeters (mm) unless otherwise noted. 2. This Land Pattern Design is based on the IPC-7351 guidelines. Solder Mask Design 3. All metal pads are to be non-solder mask defined (NSMD). Clearance between the solder mask and the metal pad is to be 60μm minimum, all the way around the pad. Stencil Design 4. A stainless steel, laser-cut and electro-polished stencil with trapezoidal walls should be used to assure good solder paste release. 5. The stencil thickness should be 0.125mm (5 mils). 6. The ratio of stencil aperture to land pad size should be 1:1 for all perimeter pads. 7. A 2x2 array of 1.10mm x 1.10mm openings on a 1.30mm pitch should be used for the center pad. Card Assembly 8. A No-Clean, Type-3 solder paste is recommended. 9. The recommended card reflow profile is per the JEDEC/IPC J-STD-020C specification for Small Body Components. 26 Rev.1.0 C8051F336/7/8/9 6. Electrical Characteristics 6.1. Absolute Maximum Specifications Table 6.1. Absolute Maximum Ratings Parameter Conditions Min Typ Max Units Ambient temperature under bias –55 — 125 °C Storage Temperature –65 — 150 °C Voltage on any Port I/O Pin or RST with respect to GND –0.3 — 5.8 V Voltage on VDD with respect to GND –0.3 — 4.2 V Maximum Total current through VDD or GND — — 500 mA Maximum output current sunk by RST or any Port pin — — 100 mA Note: Stresses above those listed under “Absolute Maximum Ratings” may cause permanent damage to the device. This is a stress rating only and functional operation of the devices at those or any other conditions above those indicated in the operation listings of this specification is not implied. Exposure to maximum rating conditions for extended periods may affect device reliability. Rev.1.0 27 C8051F336/7/8/9 6.2. Electrical Characteristics Table 6.2. Global Electrical Characteristics –40 to +85 °C, 25 MHz system clock unless otherwise specified. Parameter Conditions Min Typ Max Units Digital Supply Voltage Normal Operation VRST1 3.0 3.6 V 2.7 3.0 3.6 V Digital Supply RAM Data Retention Voltage — 1.5 — V SYSCLK (System Clock) (Note 2) 0 — 25 MHz TSYSH (SYSCLK High Time) 18 — — ns TSYSL (SYSCLK Low Time) 18 — — ns Specified Operating Temperature Range –40 — +85 °C Writing or Erasing Flash Memory Digital Supply Current—CPU Active (Normal Mode, fetching instructions from Flash) IDD (Note 3) VDD = 3.6 V, F = 25 MHz — 11.0 13.0 mA VDD = 3.0 V, F = 25 MHz — 8.0 10.0 mA VDD = 3.6 V, F = 1 MHz — 0.56 — mA VDD = 3.0 V, F = 1 MHz — 0.42 — mA VDD = 3.0 V, F = 80 kHz — 35 — µA Digital Supply Current—CPU Inactive (Idle Mode, not fetching instructions from Flash) IDD (Note 3) Digital Supply Current (Stop or Suspend Mode, shutdown) VDD = 3.6 V, F = 25 MHz — 5.0 6.0 mA VDD = 3.0 V, F = 25 MHz — 4.1 5.0 mA VDD = 3.6 V, F = 1 MHz — 0.20 — mA VDD = 3.0 V, F = 1 MHz — 0.16 — mA VDD = 3.0 V, F = 80 kHz — 13 — µA Oscillator not running, VDD Monitor Disabled — < 0.1 — µA Notes: 1. Given in Table 6.4 on page 30. 2. SYSCLK must be at least 32 kHz to enable debugging. 3. Based on device characterization data; Not production tested. 28 Rev.1.0 C8051F336/7/8/9 Table 6.3. Port I/O DC Electrical Characteristics VDD = 2.7 to 3.6 V, –40 to +85 °C unless otherwise specified. Parameters Conditions Output High Voltage IOH = –3 mA, Port I/O push-pull IOH = –10 µA, Port I/O push-pull IOH = –10 mA, Port I/O push-pull Output Low Voltage IOL = 8.5 mA IOL = 10 µA IOL = 25 mA Input High Voltage Input Low Voltage Input Leakage Weak Pullup Off Current Weak Pullup On, VIN = 0 V Rev.1.0 Min Typ Max Units VDD – 0.7 VDD – 0.1 — — — — 2.0 — — — — — VDD – 0.8 — — 1.0 — — — 50 — — — 0.6 0.1 — — 0.8 ±1 100 V V V V V V V V µA µA 29 C8051F336/7/8/9 Table 6.4. Reset Electrical Characteristics –40 to +85 °C unless otherwise specified. Parameter Conditions Min Typ Max Units RST Output Low Voltage IOL = 8.5 mA, VDD = 2.7 V to 3.6 V — — 0.6 V — — 0.6 — 50 100 2.40 2.55 2.70 V 100 220 600 µs — — 40 µs Minimum RST Low Time to Generate a System Reset 15 — — µs VDD Monitor Turn-on Time 100 — — µs — 20 40 µA RST Input Low Voltage RST Input Pullup Current RST = 0.0 V VDD POR Threshold (VRST) Missing Clock Detector Timeout Time from last system clock rising edge to reset initiation Reset Time Delay Delay between release of any reset source and code execution at location 0x0000 VDD Monitor Supply Current µA Table 6.5. Flash Electrical Characteristics VDD = 2.7 to 3.6 V; –40 to +85 ºC unless otherwise specified. Parameter Flash Size Endurance Erase Cycle Time Write Cycle Time Conditions 25 MHz System Clock 25 MHz System Clock Note: 512 bytes at addresses 0x3E00 to 0x3FFF are reserved. 30 Rev.1.0 Min Typ Max Units 16384* 20 k 10 40 — 100 k 15 55 — — 20 70 bytes Erase/Write ms µs C8051F336/7/8/9 Table 6.6. Internal High-Frequency Oscillator Electrical Characteristics VDD = 2.7 to 3.6 V; TA = –40 to +85 °C unless otherwise specified; Using factory-calibrated settings. Parameter Conditions Min Typ Max Units Oscillator Frequency Oscillator Supply Current (from VDD) IFCN = 11b 25 °C, VDD = 3.0 V, OSCICN.7 = 1, OCSICN.5 = 0 Constant Temperature Constant Supply 24 — 24.5 450 25 600 MHz µA — — 0.12 60 — — %/V ppm/°C Power Supply Sensitivity Temperature Sensitivity Table 6.7. Internal Low-Frequency Oscillator Electrical Characteristics VDD = 2.7 to 3.6 V; TA = –40 to +85 °C unless otherwise specified; Using factory-calibrated settings. Parameter Conditions Min Typ Max Units Oscillator Frequency Oscillator Supply Current (from VDD) Power Supply Sensitivity Temperature Sensitivity OSCLD = 11b 25 °C, VDD = 3.0 V, OSCLCN.7 = 1 Constant Temperature Constant Supply 72 — 80 5.5 88 10 kHz µA — — 2.4 30 — — %/V ppm/°C Rev.1.0 31 C8051F336/7/8/9 Table 6.8. ADC0 Electrical Characteristics VDD = 3.0 V, VREF = 2.40 V (REFSL=0), –40 to +85 °C unless otherwise specified. Parameter Conditions Min Typ Max Units — — –12 –5 — 10 ±0.5 ±0.5 3 1 3 ±1 ±1 12 5 — bits LSB LSB LSB LSB ppm/°C DC Accuracy Resolution Integral Nonlinearity Differential Nonlinearity Offset Error Full Scale Error Offset Temperature Coefficient Guaranteed Monotonic Dynamic performance (10 kHz sine-wave single-ended input, 1 dB below Full Scale, 200 ksps) Signal-to-Noise Plus Distortion Total Harmonic Distortion Spurious-Free Dynamic Range Up to the 5th harmonic 53 — — 58 –75 75 — — — dB dB dB — 13 300 — — — — — 3.125 — — 200 MHz clocks ns ksps 0 –VREF 0 — — VREF VREF VDD V V V — — 5 5 — — pF kΩ — 500 900 µA — 3 — mV/V Conversion Rate SAR Conversion Clock Conversion Time in SAR Clocks Track/Hold Acquisition Time Throughput Rate Analog Inputs ADC Input Voltage Range Single Ended (AIN+ – GND) Differential (AIN+ – AIN–) Absolute Pin Voltage with respect Single Ended or Differential to GND Sampling Capacitance (CSAMPLE) Input Multiplexer Impedance (RMUX) Power Specifications Power Supply Current (VDD supplied to ADC0) Power Supply Rejection 32 Operating Mode, 200 ksps Rev.1.0 C8051F336/7/8/9 Table 6.9. Temperature Sensor Electrical Characteristics VDD = 3.0 V, –40 to +85 °C unless otherwise specified. Parameter Linearity Slope Slope Error* Offset Offset Error* Conditions Min Typ Max Units Temp = 0 °C Temp = 0 °C — — — — — ± 0.2 2.25 23 785 11.6 — — — — — °C mV/°C µV/°C mV mV Note: Represents one standard deviation from the mean. Table 6.10. Voltage Reference Electrical Characteristics VDD = 3.0 V; –40 to +85 °C unless otherwise specified. Parameter Conditions Min Typ Max Units 2.35 2.42 2.50 V VREF Short-Circuit Current — — 10 mA VREF Temperature Coefficient — 30 — ppm/°C Internal Reference (REFBE = 1) Output Voltage 25 °C ambient Load Regulation Load = 0 to 200 µA to AGND — 3 — µV/µA VREF Turn-on Time 1 4.7 µF tantalum, 0.1 µF ceramic bypass — 7.5 — ms VREF Turn-on Time 2 0.1 µF ceramic bypass — 200 — µs — –0.6 — mV/V 0 — VDD V Sample Rate = 200 ksps; VREF = 3.0 V — 3 — µA REFBE = ‘1’ or TEMPE = ‘1’ — 30 50 µA Power Supply Rejection External Reference (REFBE = 0) Input Voltage Range Input Current Power Specifications Reference Bias Generator Rev.1.0 33 C8051F336/7/8/9 Table 6.11. IDAC Electrical Characteristics –40 to +85 °C, VDD = 3.0 V Full-scale output current set to 2 mA unless otherwise specified. Parameter Conditions Min Typ Max Units Static Performance Resolution 10 Integral Nonlinearity bits — ±0.5 ±2 LSB — ±0.5 ±1 LSB Output Compliance Range 0 — VDD – 1.2 V Offset Error — 0 — µA — 0 ±30 µA Full Scale Error Tempco — 30 — ppm/°C VDD Power Supply Rejection Ratio — 6 — µA/V Output Settling Time to 1/2 IDA0H:L = 0x3FF to 0x000 LSB — 5 — µs Startup Time — 5 — µs 1 mA Full Scale Output Current — ±1 — % 0.5 mA Full Scale Output Current — ±1 — % — 2100 — µA — 1100 — µA — 600 — µA Differential Nonlinearity Full Scale Error Guaranteed Monotonic 2 mA Full Scale Output Current Dynamic Performance Gain Variation Power Consumption Power Supply Current (VDD 2 mA Full Scale Output Current supplied to IDAC) 1 mA Full Scale Output Current 0.5 mA Full Scale Output Current 34 Rev.1.0 C8051F336/7/8/9 Table 6.12. Comparator Electrical Characteristics VDD = 3.0 V, –40 to +85 °C unless otherwise noted. Parameter Conditions Min Response Time Mode 0, Vcm* = 1.5 V CP0+ – CP0– = 100 mV — 100 — ns CP0+ – CP0– = –100 mV — 200 — ns Response Time Mode 1, Vcm* = 1.5 V CP0+ – CP0– = 100 mV — 250 — ns CP0+ – CP0– = –100 mV — 350 — ns Response Time Mode 2, Vcm* = 1.5 V CP0+ – CP0– = 100 mV — 400 — ns CP0+ – CP0– = –100 mV — 800 — ns Response Time Mode 3, Vcm* = 1.5 V CP0+ – CP0– = 100 mV — 1100 — ns CP0+ – CP0– = –100 mV — 5000 — ns Common-Mode Rejection Ratio Typ Max Units — 1.25 5 mV/V Positive Hysteresis 1 CP0HYP1–0 = 00 — 0 1 mV Positive Hysteresis 2 CP0HYP1–0 = 01 1 5 10 mV Positive Hysteresis 3 CP0HYP1–0 = 10 6 10 20 mV Positive Hysteresis 4 CP0HYP1–0 = 11 12 20 30 mV Negative Hysteresis 1 CP0HYN1–0 = 00 0 1 mV Negative Hysteresis 2 CP0HYN1–0 = 01 1 5 10 mV Negative Hysteresis 3 CP0HYN1–0 = 10 6 10 20 mV Negative Hysteresis 4 CP0HYN1–0 = 11 12 20 30 mV –0.25 — VDD + 0.25 V Input Capacitance — 4 — pF Input Bias Current — 0.001 — nA Input Offset Voltage –5 — +5 mV Power Supply Rejection — 0.1 — mV/V Power-up Time — 10 — µs Inverting or Non-Inverting Input Voltage Range Power Supply Supply Current at DC Mode 0 — 10 20 µA Mode 1 — 4 10 µA Mode 2 — 2 5 µA Mode 3 — 0.4 2.5 µA Note: Vcm is the common-mode voltage on CP0+ and CP0–. Rev.1.0 35 C8051F336/7/8/9 6.3. Typical Performance Curves VDD = 3.6V VDD = 3.3V VDD = 3.0V VDD = 2.7V 12.0 10.0 IDD (mA) 8.0 6.0 4.0 2.0 0.0 0 5 10 15 20 25 SYSCLK (MHz) Figure 6.1. Normal Mode Digital Supply Current vs. Frequency VDD = 3.6V VDD = 3.3V VDD = 3.0V VDD = 2.7V 6.0 5.0 IDD (mA) 4.0 3.0 2.0 1.0 0.0 0 5 10 15 20 SYSCLK (MHz) Figure 6.2. Idle Mode Digital Supply Current vs. Frequency 36 Rev.1.0 25 C8051F336/7/8/9 7. 10-Bit ADC (ADC0, C8051F336/8 only) The ADC0 on the C8051F336/8 is a 200 ksps, 10-bit successive-approximation-register (SAR) ADC with integrated track-and-hold and programmable window detector. The ADC is fully configurable under software control via Special Function Registers. The ADC0 operates in both Single-ended and Differential modes, and may be configured to measure various different signals using the analog multiplexer described in Section “7.4. ADC0 Analog Multiplexer (C8051F336/8 only)” on page 48. The voltage reference for the ADC is selected as described in Section “8. Temperature Sensor (C8051F336/8 only)” on page 51. The ADC0 subsystem is enabled only when the AD0EN bit in the ADC0 Control register (ADC0CN) is set to logic 1. The ADC0 subsystem is in low power shutdown when this bit is logic 0. AD0CM0 AD0CM1 AD0CM2 AD0WINT AD0INT AD0BUSY AD0EN AD0TM ADC0CN VDD ADC0L Start Conversion 10-Bit SAR AIN+ From AMUX0 Timer 0 Overflow Timer 2 Overflow Timer 1 Overflow CNVSTR Input 101 Timer 3 Overflow REF SYSCLK AD0SC0 AD0LJST AD0SC1 AD0SC2 AD0SC3 AD0SC4 ADC0CF AD0BUSY (W) 001 010 011 100 ADC0H ADC AIN- 000 AD0WINT 32 ADC0LTH ADC0LTL Window Compare Logic ADC0GTH ADC0GTL Figure 7.1. ADC0 Functional Block Diagram Rev.1.0 37 C8051F336/7/8/9 7.1. Output Code Formatting The ADC is in Single-ended mode when the negative input is connected to GND. The ADC will be in Differential mode when the negative input is connected to any other option. The output code format differs between Single-ended and Differential modes. The registers ADC0H and ADC0L contain the high and low bytes of the output conversion code from the ADC at the completion of each conversion. Data can be rightjustified or left-justified, depending on the setting of the AD0LJST. When in Single-ended Mode, conversion codes are represented as 10-bit unsigned integers. Inputs are measured from ‘0’ to VREF x 1023/1024. Example codes are shown below for both right-justified and left-justified data. Unused bits in the ADC0H and ADC0L registers are set to ‘0’. Input Voltage Right-Justified ADC0H:ADC0L (AD0LJST = 0) Left-Justified ADC0H:ADC0L (AD0LJST = 1) VREF x 1023/1024 VREF x 512/1024 VREF x 256/1024 0 0x03FF 0x0200 0x0100 0x0000 0xFFC0 0x8000 0x4000 0x0000 When in Differential Mode, conversion codes are represented as 10-bit signed 2’s complement numbers. Inputs are measured from –VREF to VREF x 511/512. Example codes are shown below for both right-justified and left-justified data. For right-justified data, the unused MSBs of ADC0H are a sign-extension of the data word. For left-justified data, the unused LSBs in the ADC0L register are set to ‘0’. Input Voltage Right-Justified ADC0H:ADC0L (AD0LJST = 0) Left-Justified ADC0H:ADC0L (AD0LJST = 1) VREF x 511/512 VREF x 256/512 0 –VREF x 256/512 –VREF 0x01FF 0x0100 0x0000 0xFF00 0xFE00 0x7FC0 0x4000 0x0000 0xC000 0x8000 7.2. Modes of Operation ADC0 has a maximum conversion speed of 200 ksps. The ADC0 conversion clock is a divided version of the system clock, determined by the AD0SC bits in the ADC0CF register. 7.2.1. Starting a Conversion A conversion can be initiated in one of six ways, depending on the programmed states of the ADC0 Start of Conversion Mode bits (AD0CM2–0) in register ADC0CN. Conversions may be initiated by one of the following: 1. Writing a ‘1’ to the AD0BUSY bit of register ADC0CN 2. A Timer 0 overflow (i.e., timed continuous conversions) 3. A Timer 2 overflow 4. A Timer 1 overflow 5. A rising edge on the CNVSTR input signal (pin P0.6) 6. A Timer 3 overflow Writing a ‘1’ to AD0BUSY provides software control of ADC0 whereby conversions are performed "ondemand". During conversion, the AD0BUSY bit is set to logic 1 and reset to logic 0 when the conversion is 38 Rev.1.0 C8051F336/7/8/9 complete. The falling edge of AD0BUSY triggers an interrupt (when enabled) and sets the ADC0 interrupt flag (AD0INT). Note: When polling for ADC conversion completions, the ADC0 interrupt flag (AD0INT) should be used. Converted data is available in the ADC0 data registers, ADC0H:ADC0L, when bit AD0INT is logic 1. Note that when Timer 2 or Timer 3 overflows are used as the conversion source, Low Byte overflows are used if Timer 2/3 is in 8-bit mode; High byte overflows are used if Timer 2/3 is in 16-bit mode. See Section “24. Timers” on page 180 for timer configuration. Important Note About Using CNVSTR: The CNVSTR input pin also functions as Port pin P0.6. When the CNVSTR input is used as the ADC0 conversion source, Port pin P0.6 should be skipped by the Digital Crossbar. To configure the Crossbar to skip P0.6, set to ‘1’ Bit6 in register P0SKIP. See Section “20. Port Input/Output” on page 119 for details on Port I/O configuration. 7.2.2. Tracking Modes Each ADC0 conversion must be preceded by a minimum tracking time in order for the converted result to be accurate. Refer to Section “6. Electrical Characteristics” on page 27 for minimum tracking time specifications. The AD0TM bit in register ADC0CN controls the ADC0 track-and-hold mode. In its default state, the ADC0 input is continuously tracked, except when a conversion is in progress. When the AD0TM bit is logic 1, ADC0 operates in low-power track-and-hold mode. In this mode, each conversion is preceded by a tracking period of 3 SAR clocks (after the start-of-conversion signal). When the CNVSTR signal is used to initiate conversions in low-power tracking mode, ADC0 tracks only when CNVSTR is low; conversion begins on the rising edge of CNVSTR (see Figure 7.2). Tracking can also be disabled (shutdown) when the device is in low power standby or sleep modes. Low-power track-and-hold mode is also useful when AMUX settings are frequently changed, due to the settling time requirements described in Section “7.2.3. Settling Time Requirements” on page 40. A. ADC0 Timing for External Trigger Source CNVSTR (AD0CM[2:0]=100) 1 2 3 4 5 6 7 8 9 10 11 12 13 14 SAR Clocks AD0TM=1 AD0TM=0 Write '1' to AD0BUSY, Timer 0, Timer 2, Timer 1, Timer 3 Overflow (AD0CM[2:0]=000, 001,010 011, 101) Low Power or Convert Track Track or Convert Convert Low Power Mode Convert Track B. ADC0 Timing for Internal Trigger Source 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 SAR Clocks AD0TM=1 Low Power Track or Convert Convert Low Power Mode 1 2 3 4 5 6 7 8 9 10 11 12 13 14 SAR Clocks AD0TM=0 Track or Convert Convert Track Figure 7.2. 10-Bit ADC Track and Conversion Example Timing Rev.1.0 39 C8051F336/7/8/9 7.2.3. Settling Time Requirements A minimum tracking time is required before each conversion to ensure that an accurate conversion is performed. This tracking time is determined by any series impedance, including the AMUX0 resistance, the the ADC0 sampling capacitance, and the accuracy required for the conversion. Note that in low-power tracking mode, three SAR clocks are used for tracking at the start of every conversion. For many applications, these three SAR clocks will meet the minimum tracking time requirements. Figure 7.3 shows the equivalent ADC0 input circuits for both Differential and Single-ended modes. Notice that the equivalent time constant for both input circuits is the same. The required ADC0 settling time for a given settling accuracy (SA) may be approximated by Equation 7.1. When measuring the Temperature Sensor output or VDD with respect to GND, RTOTAL reduces to RMUX. See Section “6. Electrical Characteristics” on page 27 for ADC0 minimum settling time requirements as well as the mux impedance and sampling capacitor values. n 2 t = ln  ------- × R TOTAL C SAMPLE  SA Equation 7.1. ADC0 Settling Time Requirements Where: SA is the settling accuracy, given as a fraction of an LSB (for example, 0.25 to settle within 1/4 LSB) t is the required settling time in seconds RTOTAL is the sum of the AMUX0 resistance and any external source resistance. n is the ADC resolution in bits (10). Differential Mode Single-Ended Mode MUX Select MUX Select Px.x Px.x RMUX RMUX CSAMPLE CSAMPLE RCInput= RMUX * CSAMPLE RCInput= RMUX * CSAMPLE CSAMPLE Px.x RMUX MUX Select Figure 7.3. ADC0 Equivalent Input Circuits 40 Rev.1.0 C8051F336/7/8/9 SFR Definition 7.1. ADC0CF: ADC0 Configuration Bit 7 6 5 4 3 2 1 0 Name AD0SC[4:0] AD0LJST Type R/W R/W R R 0 0 0 Reset 1 1 1 1 1 SFR Address = 0xBC Bit Name 7:3 AD0SC[4:0] Function ADC0 SAR Conversion Clock Period Bits. SAR Conversion clock is derived from system clock by the following equation, where AD0SC refers to the 5-bit value held in bits AD0SC4–0. SAR Conversion clock requirements are given in the ADC specification table. SYSCLK AD0SC = ----------------------- – 1 CLK SAR 2 AD0LJST ADC0 Left Justify Select. 0: Data in ADC0H:ADC0L registers are right-justified. 1: Data in ADC0H:ADC0L registers are left-justified. 1:0 UNUSED Unused. Read = 00b; Write = don’t care. Rev.1.0 41 C8051F336/7/8/9 SFR Definition 7.2. ADC0H: ADC0 Data Word MSB Bit 7 6 5 4 3 Name ADC0H[7:0] Type R/W Reset 0 0 0 0 0 SFR Address = 0xBE Bit Name 2 1 0 0 0 0 Function 7:0 ADC0H[7:0] ADC0 Data Word High-Order Bits. For AD0LJST = 0: Bits 7–2 are the sign extension of Bit1. Bits 1–0 are the upper 2 bits of the 10-bit ADC0 Data Word. For AD0LJST = 1: Bits 7–0 are the most-significant bits of the 10-bit ADC0 Data Word. SFR Definition 7.3. ADC0L: ADC0 Data Word LSB Bit 7 6 5 4 3 Name ADC0L[7:0] Type R/W Reset 0 0 0 0 SFR Address = 0xBD Bit Name 7:0 42 0 2 1 0 0 0 0 Function ADC0L[7:0] ADC0 Data Word Low-Order Bits. For AD0LJST = 0: Bits 7–0 are the lower 8 bits of the 10-bit Data Word. For AD0LJST = 1: Bits 7–6 are the lower 2 bits of the 10-bit Data Word. Bits 5–0 will always read ‘0’. Rev.1.0 C8051F336/7/8/9 SFR Definition 7.4. ADC0CN: ADC0 Control Bit 7 6 5 4 3 Name AD0EN AD0TM AD0INT Type R/W R/W R/W R/W R/W Reset 0 0 0 0 0 AD0BUSY AD0WINT SFR Address = 0xE8; Bit-Addressable Bit Name 7 AD0EN 2 1 0 AD0CM[2:0] R/W 0 0 0 Function ADC0 Enable Bit. 0: ADC0 Disabled. ADC0 is in low-power shutdown. 1: ADC0 Enabled. ADC0 is active and ready for data conversions. 6 AD0TM ADC0 Track Mode Bit. 0: Normal Track Mode: When ADC0 is enabled, tracking is continuous unless a conversion is in progress. Conversion begins immediately on start-of-conversion event, as defined by AD0CM[2:0]. 1: Low-power Track Mode: For AD0CM[2:0] = 100, ADC is tracking when CNVSTR is low, and conversion begins immediately on rising edge of CNVSTR. For all other values of AD0CM[2:0], tracking is initiated on start-of-conversion event, and lasts 3 SAR Clock cycles. The conversion immediately follows this tracking phase. 5 AD0INT ADC0 Conversion Complete Interrupt Flag. 0: ADC0 has not completed a data conversion since AD0INT was last cleared. 1: ADC0 has completed a data conversion. 4 3 AD0BUSY AD0WINT ADC0 Busy Bit. Read: Write: 0: ADC0 conversion is not in progress. 1: ADC0 conversion is in progress. 0: No Effect. 1: Initiates ADC0 Conversion if AD0CM[2:0] = 000b ADC0 Window Compare Interrupt Flag. 0: ADC0 Window Comparison Data match has not occurred since this flag was last cleared. 1: ADC0 Window Comparison Data match has occurred. 2:0 AD0CM[2:0] ADC0 Start of Conversion Mode Select. 000: ADC0 start-of-conversion source is write of ‘1’ to AD0BUSY. 001: ADC0 start-of-conversion source is overflow of Timer 0. 010: ADC0 start-of-conversion source is overflow of Timer 2. 011: ADC0 start-of-conversion source is overflow of Timer 1. 100: ADC0 start-of-conversion source is rising edge of external CNVSTR. 101: ADC0 start-of-conversion source is overflow of Timer 3. 11x: Reserved. Rev.1.0 43 C8051F336/7/8/9 7.3. Programmable Window Detector The ADC Programmable Window Detector continuously compares the ADC0 output registers to user-programmed limits, and notifies the system when a desired condition is detected. This is especially effective in an interrupt-driven system, saving code space and CPU bandwidth while delivering faster system response times. The window detector interrupt flag (AD0WINT in register ADC0CN) can also be used in polled mode. The ADC0 Greater-Than (ADC0GTH, ADC0GTL) and Less-Than (ADC0LTH, ADC0LTL) registers hold the comparison values. The window detector flag can be programmed to indicate when measured data is inside or outside of the user-programmed limits, depending on the contents of the ADC0 Less-Than and ADC0 Greater-Than registers. SFR Definition 7.5. ADC0GTH: ADC0 Greater-Than Data High Byte Bit 7 6 5 4 3 Name ADC0GTH[7:0] Type R/W Reset 1 1 1 1 1 SFR Address = 0xC4 Bit Name 2 1 0 1 1 1 2 1 0 1 1 1 Function 7:0 ADC0GTH[7:0] ADC0 Greater-Than Data Word High-Order Bits. SFR Definition 7.6. ADC0GTL: ADC0 Greater-Than Data Low Byte Bit 7 6 5 4 3 Name ADC0GTL[7:0] Type R/W Reset 1 1 1 1 SFR Address = 0xC3 Bit Name 7:0 44 1 Function ADC0GTL[7:0] ADC0 Greater-Than Data Word Low-Order Bits. Rev.1.0 C8051F336/7/8/9 SFR Definition 7.7. ADC0LTH: ADC0 Less-Than Data High Byte Bit 7 6 5 4 3 Name ADC0LTH[7:0] Type R/W Reset 0 0 0 0 0 SFR Address = 0xC6 Bit Name 7:0 2 1 0 0 0 0 2 1 0 0 0 0 Function ADC0LTH[7:0] ADC0 Less-Than Data Word High-Order Bits. SFR Definition 7.8. ADC0LTL: ADC0 Less-Than Data Low Byte Bit 7 6 5 4 3 Name ADC0LTL[7:0] Type R/W Reset 0 SFR Address = 0xC5 Bit Name 7:0 0 0 0 0 Function ADC0LTL[7:0] ADC0 Less-Than Data Word Low-Order Bits. Rev.1.0 45 C8051F336/7/8/9 7.3.1. Window Detector In Single-Ended Mode Figure 7.4 shows two example window comparisons for right-justified, single-ended data, with ADC0LTH:ADC0LTL = 0x0080 (128d) and ADC0GTH:ADC0GTL = 0x0040 (64d). In single-ended mode, the input voltage can range from ‘0’ to VREF x (1023/1024) with respect to GND, and is represented by a 10-bit unsigned integer value. In the left example, an AD0WINT interrupt will be generated if the ADC0 conversion word (ADC0H:ADC0L) is within the range defined by ADC0GTH:ADC0GTL and ADC0LTH:ADC0LTL (if 0x0040 < ADC0H:ADC0L < 0x0080). In the right example, and AD0WINT interrupt will be generated if the ADC0 conversion word is outside of the range defined by the ADC0GT and ADC0LT registers (if ADC0H:ADC0L < 0x0040 or ADC0H:ADC0L > 0x0080). Figure 7.5 shows an example using left-justified data with the same comparison values. ADC0H:ADC0L ADC0H:ADC0L Input Voltage (Px.x - GND) VREF x (1023/ 1024) Input Voltage (Px.x - GND) 0x03FF VREF x (1023/ 1024) 0x03FF AD0WINT not affected AD0WINT=1 0x0081 VREF x (128/1024) 0x0080 0x0081 ADC0LTH:ADC0LTL VREF x (128/1024) 0x007F 0x0080 0x007F AD0WINT=1 0x0041 VREF x (64/1024) 0x0040 0x0041 ADC0GTH:ADC0GTL VREF x (64/1024) 0x003F 0x0040 ADC0GTH:ADC0GTL AD0WINT not affected ADC0LTH:ADC0LTL 0x003F AD0WINT=1 AD0WINT not affected 0 0x0000 0 0x0000 Figure 7.4. ADC Window Compare Example: Right-Justified Single-Ended Data ADC0H:ADC0L ADC0H:ADC0L Input Voltage (Px.x - GND) VREF x (1023/ 1024) Input Voltage (Px.x - GND) VREF x (1023/ 1024) 0xFFC0 0xFFC0 AD0WINT not affected AD0WINT=1 0x2040 VREF x (128/1024) 0x2000 0x2040 ADC0LTH:ADC0LTL VREF x (128/1024) 0x1FC0 0x2000 0x1FC0 AD0WINT=1 0x1040 VREF x (64/1024) 0x1000 0x1040 ADC0GTH:ADC0GTL VREF x (64/1024) 0x0FC0 0x1000 AD0WINT not affected ADC0LTH:ADC0LTL 0x0FC0 AD0WINT=1 AD0WINT not affected 0 ADC0GTH:ADC0GTL 0x0000 0 0x0000 Figure 7.5. ADC Window Compare Example: Left-Justified Single-Ended Data 46 Rev.1.0 C8051F336/7/8/9 7.3.2. Window Detector In Differential Mode Figure 7.6 shows two example window comparisons for right-justified, differential data, with ADC0LTH:ADC0LTL = 0x0040 (+64d) and ADC0GTH:ADC0GTH = 0xFFFF (–1d). In differential mode, the measurable voltage between the input pins is between –VREF and VREF x (511/512). Output codes are represented as 10-bit 2s complement signed integers. In the left example, an AD0WINT interrupt will be generated if the ADC0 conversion word (ADC0H:ADC0L) is within the range defined by ADC0GTH:ADC0GTL and ADC0LTH:ADC0LTL (if 0xFFFF (–1d) < ADC0H:ADC0L < 0x0040 (64d)). In the right example, an AD0WINT interrupt will be generated if the ADC0 conversion word is outside of the range defined by the ADC0GT and ADC0LT registers (if ADC0H:ADC0L < 0xFFFF (–1d) or ADC0H:ADC0L > 0x0040 (+64d)). Figure 7.7 shows an example using left-justified data with the same comparison values. ADC0H:ADC0L ADC0H:ADC0L Input Voltage (Px.x - Px.x) VREF x (511/512) Input Voltage (Px.x - Px.x) 0x01FF VREF x (511/512) 0x01FF AD0WINT not affected AD0WINT=1 0x0041 VREF x (64/512) 0x0040 0x0041 ADC0LTH:ADC0LTL VREF x (64/512) 0x003F 0x0040 0x003F AD0WINT=1 VREF x (-1/512) 0x0000 0xFFFF ADC0GTH:ADC0GTL VREF x (-1/512) 0xFFFE 0x0000 0xFFFF ADC0GTH:ADC0GTL AD0WINT not affected ADC0LTH:ADC0LTL 0xFFFE AD0WINT=1 AD0WINT not affected -VREF 0x0200 -VREF 0x0200 Figure 7.6. ADC Window Compare Example: Right-Justified Differential Data ADC0H:ADC0L ADC0H:ADC0L Input Voltage (Px.x - Px.x) VREF x (511/512) Input Voltage (Px.x - Px.y) 0x7FC0 VREF x (511/512) 0x7FC0 AD0WINT not affected AD0WINT=1 0x1040 VREF x (64/512) 0x1000 0x1040 ADC0LTH:ADC0LTL VREF x (64/512) 0x0FC0 0x1000 0x0FC0 AD0WINT=1 0x0000 VREF x (-1/512) 0xFFC0 0x0000 ADC0GTH:ADC0GTL VREF x (-1/512) 0xFF80 0xFFC0 0x8000 AD0WINT not affected ADC0LTH:ADC0LTL 0xFF80 AD0WINT=1 AD0WINT not affected -VREF ADC0GTH:ADC0GTL -VREF 0x8000 Figure 7.7. ADC Window Compare Example: Left-Justified Differential Data Rev.1.0 47 C8051F336/7/8/9 48 Rev.1.0 C8051F336/7/8/9 7.4. ADC0 Analog Multiplexer (C8051F336/8 only) ADC0 on the C8051F336/8 has two analog multiplexers, referred to collectively as AMUX0. AMUX0 selects the positive and negative inputs to the ADC. Any of the following may be selected as the positive input: Port I/O pins, the on-chip temperature sensor, or the positive power supply (VDD). Any of the following may be selected as the negative input: Port I/O pins, VREF, or GND. When GND is selected as the negative input, ADC0 operates in Single-ended Mode; all other times, ADC0 operates in Differential Mode. The ADC0 input channels are selected in the AMX0P and AMX0N registers as described in SFR Definition 7.9 and SFR Definition 7.10. P0.0 AMX0P1 AMX0P0 AMX0N0 AMX0P2 AMX0N1 AMX0P3 AMX0P4 AMX0P AMUX P2.3* Temp Sensor VDD AIN+ ADC0 AIN- P0.0 AMUX VREF GND AMX0N2 P2.3* AMX0N3 AMX0N4 AMX0N *P2.0-P2.3 Only available as inputs on QFN24 Packaging Figure 7.8. ADC0 Multiplexer Block Diagram Important Note About ADC0 Input Configuration: Port pins selected as ADC0 inputs should be configured as analog inputs, and should be skipped by the Digital Crossbar. To configure a Port pin for analog input, set to ‘0’ the corresponding bit in register PnMDIN. To force the Crossbar to skip a Port pin, set to ‘1’ the corresponding bit in register PnSKIP. See Section “20. Port Input/Output” on page 119 for more Port I/O configuration details. Rev.1.0 48 C8051F336/7/8/9 SFR Definition 7.9. AMX0P: AMUX0 Positive Channel Select Bit 7 6 5 4 3 1 0 1 1 AMX0P[4:0] Name Type R R R Reset 0 0 0 R/W 1 SFR Address = 0xBB Bit Name 1 Function 7:5 UNUSED Unused. Read = 000b; Write = Don’t Care. 4:0 AMX0P[4:0] AMUX0 Positive Input Selection. 00000: 00001: 00010: 00011: 00100: 00101: 00110: 00111: 01000: 01001: 01010: 01011: 01100: 01101: 01110: 01111: 10000: 10001: 10010: 10011: 10100: 10101: 10110 – 11111: 49 2 P0.0 P0.1 P0.2 P0.3 P0.4 P0.5 P0.6 P0.7 P1.0 P1.1 P1.2 P1.3 P1.4 P1.5 P1.6 P1.7 Temp Sensor VDD P2.0 (C8051F338/9 Only) P2.1 (C8051F338/9 Only) P2.2 (C8051F338/9 Only) P2.3 (C8051F338/9 Only) no input selected Rev.1.0 1 C8051F336/7/8/9 SFR Definition 7.10. AMX0N: AMUX0 Negative Channel Select Bit 7 6 5 4 3 2 1 0 1 1 AMX0N[4:0] Name Type R R R Reset 0 0 0 SFR Address = 0xBA Bit Name R/W 1 1 1 Function 7:5 UNUSED Unused. Read = 000b; Write = Don’t Care. 4:0 AMX0N[4:0] AMUX0 Negative Input Selection. 00000: 00001: 00010: 00011: 00100: 00101: 00110: 00111: 01000: 01001: 01010: 01011: 01100: 01101: 01110: 01111: 10000: 10001: 10010: 10011: 10100: 10101: 10110 – 11111: P0.0 P0.1 P0.2 P0.3 P0.4 P0.5 P0.6 P0.7 P1.0 P1.1 P1.2 P1.3 P1.4 P1.5 P1.6 P1.7 VREF GND (ADC in Single-Ended Mode) P2.0 (C8051F338/9 Only) P2.1 (C8051F338/9 Only) P2.2 (C8051F338/9 Only) P2.3 (C8051F338/9 Only) no input selected Rev.1.0 50 C8051F336/7/8/9 8. Temperature Sensor (C8051F336/8 only) An on-chip temperature sensor is included on the C8051F336/8 which can be directly accessed via the ADC multiplexer in single-ended configuration. To use the ADC to measure the temperature sensor, the positive ADC mux channel should be configured to connect to the temperature sensor and the negative ADC mux channel should be configured to connect to GND. The temperature sensor transfer function is shown in Figure 8.1. The output voltage (VTEMP) is the positive ADC input when the ADC multiplexer is set correctly. The TEMPE bit in register REF0CN enables/disables the temperature sensor, as described in SFR Definition 10.1. While disabled, the temperature sensor defaults to a high impedance state and any ADC measurements performed on the sensor will result in meaningless data. Refer to Section “6. Electrical Characteristics” on page 27 for the slope and offset parameters of the temperature sensor. VTEMP = (Slope x TempC) + Offset Voltage TempC = (VTEMP - Offset) / Slope Slope (V / deg C) Offset (V at 0 Celsius) Temperature Figure 8.1. Temperature Sensor Transfer Function Rev.1.0 51 C8051F336/7/8/9 9. 10-Bit Current Mode DAC (IDA0, C8051F336/8 only) The C8051F336/8 device includes a 10-bit current-mode Digital-to-Analog Converter (IDAC). The maximum current output of the IDAC can be adjusted for three different current settings; 0.5 mA, 1 mA, and 2 mA. The IDAC is enabled or disabled with the IDA0EN bit in the IDA0 Control Register (see SFR Definition 9.1). When IDA0EN is set to 0, the IDAC port pin (P0.1) behaves as a normal GPIO pin. When IDA0EN is set to 1, the digital output drivers and weak pullup for the IDAC pin are automatically disabled, and the pin is connected to the IDAC output. An internal bandgap bias generator is used to generate a reference current for the IDAC whenever it is enabled. When using the IDAC, bit 1 in the P0SKIP register should be set to 1, to force the Crossbar to skip the IDAC pin. 9.1. IDA0 Output Scheduling IDA0 features a flexible output update mechanism which allows for seamless full-scale changes and supports jitter-free updates for waveform generation. Three update modes are provided, allowing IDAC output updates on a write to IDA0H, on a Timer overflow, or on an external pin edge. 9.1.1. Update Output On-Demand CNVSTR Timer 3 Timer 2 Timer 1 Timer 0 IDA0H IDA0EN IDA0CM2 IDA0CM1 IDA0CM0 IDA0H IDA0OMD1 IDA0OMD0 8 IDA0L 2 10 IDA0 Latch IDA0CN In its default mode (IDA0CN.[6:4] = 111) the IDA0 output is updated “on-demand” on a write to the highbyte of the IDA0 data register (IDA0H). It is important to note that writes to IDA0L are held in this mode, and have no effect on the IDA0 output until a write to IDA0H takes place. If writing a full 10-bit word to the IDAC data registers, the 10-bit data word is written to the low byte (IDA0L) and high byte (IDA0H) data registers. Data is latched into IDA0 after a write to the IDA0H register, so the write sequence should be IDA0L followed by IDA0H if the full 10-bit resolution is required. The IDAC can be used in 8-bit mode by initializing IDA0L to the desired value (typically 0x00), and writing data to only IDA0H (see Section 9.2 for information on the format of the 10-bit IDAC data word within the 16-bit SFR space). IDA0 Figure 9.1. IDA0 Functional Block Diagram Rev.1.0 52 C8051F336/7/8/9 9.1.2. Update Output Based on Timer Overflow Similar to the ADC operation, in which an ADC conversion can be initiated by a timer overflow independently of the processor, the IDAC outputs can use a Timer overflow to schedule an output update event. This feature is useful in systems where the IDAC is used to generate a waveform of a defined sampling rate by eliminating the effects of variable interrupt latency and instruction execution on the timing of the IDAC output. When the IDA0CM bits (IDA0CN.[6:4]) are set to 000, 001, 010 or 011, writes to both IDAC data registers (IDA0L and IDA0H) are held until an associated Timer overflow event (Timer 0, Timer 1, Timer 2 or Timer 3, respectively) occurs, at which time the IDA0H:IDA0L contents are copied to the IDAC input latches, allowing the IDAC output to change to the new value. 9.1.3. Update Output Based on CNVSTR Edge The IDAC output can also be configured to update on a rising edge, falling edge, or both edges of the external CNVSTR signal. When the IDA0CM bits (IDA0CN.[6:4]) are set to 100, 101, or 110, writes to both IDAC data registers (IDA0L and IDA0H) are held until an edge occurs on the CNVSTR input pin. The particular setting of the IDA0CM bits determines whether IDAC outputs are updated on rising, falling, or both edges of CNVSTR. When a corresponding edge occurs, the IDA0H:IDA0L contents are copied to the IDAC input latches, allowing the IDAC output to change to the new value. 9.2. IDAC Output Mapping The IDAC data registers (IDA0H and IDA0L) are left-justified, meaning that the eight MSBs of the IDAC output word are mapped to bits 7–0 of the IDA0H register, and the two LSBs of the IDAC output word are mapped to bits 7 and 6 of the IDA0L register. The data word mapping for the IDAC is shown in Figure 9.2. B9 B8 B7 IDA0H B6 B5 IDA0L B4 B3 B2 B1 B0 Input Data Word (IDA09–IDA00) Output Current IDA0OMD[1:0] = 1x Output Current IDA0OMD[1:0] = 01 Output Current IDA0OMD[1:0] = 00 0x000 0x001 0x200 0x3FF 0 mA 1/1024 x 2 mA 512/1024 x 2 mA 1023/1024 x 2 mA 0 mA 1/1024 x 1 mA 512/1024 x 1 mA 1023/1024 x 1 mA 0 mA 1/1024 x 0.5 mA 512/1024 x 0.5 mA 1023/1024 x 0.5 mA Figure 9.2. IDA0 Data Word Mapping The full-scale output current of the IDAC is selected using the IDA0OMD bits (IDA0CN[1:0]). By default, the IDAC is set to a full-scale output current of 2 mA. The IDA0OMD bits can also be configured to provide full-scale output currents of 1 mA or 0.5 mA, as shown in SFR Definition 9.1. 53 Rev.1.0 C8051F336/7/8/9 SFR Definition 9.1. IDA0CN: IDA0 Control Bit 7 6 5 Name IDA0EN IDA0CM[2:0] Type R/W R/W Reset 0 1 1 4 3 IDA0EN 1 0 IDA0OMD[1:0] 1 SFR Address = 0xB9 Bit Name 7 2 R R 0 0 R/W 1 0 Function IDA0 Enable. 0: IDA0 Disabled. 1: IDA0 Enabled. 6:4 IDA0CM[2:0] IDA0 Update Source Select bits. 000: DAC output updates on Timer 0 overflow. 001: DAC output updates on Timer 1 overflow. 010: DAC output updates on Timer 2 overflow. 011: DAC output updates on Timer 3 overflow. 100: DAC output updates on rising edge of CNVSTR. 101: DAC output updates on falling edge of CNVSTR. 110: DAC output updates on any edge of CNVSTR. 111: DAC output updates on write to IDA0H. 3:2 Unused Unused. Read = 00b. Write = Don’t care. 1:0 IDA0OMD[1:0] IDA0 Output Mode Select bits. 00: 0.5 mA full-scale output current. 01: 1.0 mA full-scale output current. 1x: 2.0 mA full-scale output current. Rev.1.0 54 C8051F336/7/8/9 SFR Definition 9.2. IDA0H: IDA0 Data Word MSB Bit 7 6 5 4 Name IDA0[9:2] Type R/W Reset 0 0 0 0 SFR Address = 0x97 Bit Name 7:0 IDA0[9:2] 3 2 1 0 0 0 0 0 Function IDA0 Data Word High-Order Bits. Upper 8 bits of the 10-bit IDA0 Data Word. SFR Definition 9.3. IDA0L: IDA0 Data Word LSB Bit 7 6 Name IDA0[1:0] Type R/W Reset 0 0 5 4 3 2 1 0 R R R R R R 0 0 0 0 0 0 SFR Address = 0x96 Bit Name 7:6 IDA0[1:0] Function IDA0 Data Word Low-Order Bits. Lower 2 bits of the 10-bit IDA0 Data Word. 5:0 55 Unused Unused. Read = 000000b. Write = Don’t care. Rev.1.0 C8051F336/7/8/9 10. Voltage Reference (C8051F336/8 only) The Voltage reference multiplexer for the ADC is configurable to use an externally connected voltage reference, the on-chip reference voltage generator routed to the VREF pin, or the VDD power supply voltage (see Figure 10.1). The REFSL bit in the Reference Control register (REF0CN, SFR Definition 10.1) selects the reference source for the ADC. For an external source or the on-chip reference, REFSL should be set to ‘0’ to select the VREF pin. To use VDD as the reference source, REFSL should be set to ‘1’. The BIASE bit enables the internal voltage bias generator, which is used by many of the analog peripherals on the device. This bias is automatically enabled when any peripheral which requires it is enabled, and it does not need to be enabled manually. The bias generator may be enabled manually by writing a ‘1’ to the BIASE bit in register REF0CN. The electrical specifications for the voltage reference circuit are given in Section “6. Electrical Characteristics” on page 27. The on-chip voltage reference circuit consists of a 1.2 V, temperature stable bandgap voltage reference generator and a gain-of-two output buffer amplifier. The on-chip voltage reference can be driven on the VREF pin by setting the REFBE bit in register REF0CN to a ‘1’. The maximum load seen by the VREF pin must be less than 200 µA to GND. Bypass capacitors of 0.1 µF and 4.7 µF are recommended from the VREF pin to GND. If the on-chip reference is not used, the REFBE bit should be cleared to ‘0’. Important Note about the VREF Pin: When using either an external voltage reference or the on-chip reference circuitry, the VREF pin should be configured as an analog pin and skipped by the Digital Crossbar. Refer to Section “20. Port Input/Output” on page 119 for the location of the VREF pin, as well as details of how to configure the pin in analog mode and to be skipped by the crossbar. REFSL TEMPE BIASE REFBE REF0CN EN VDD To ADC, IDAC, Internal Oscillators IOSCE N External Voltage Reference Circuit R1 Bias Generator EN VREF Temp Sensor To Analog Mux 0 VREF (to ADC) GND VDD 1 REFBE 4.7μF + 0.1μF Recommended Bypass Capacitors EN Internal Reference Figure 10.1. Voltage Reference Functional Block Diagram Rev.1.0 56 C8051F336/7/8/9 SFR Definition 10.1. REF0CN: Reference Control Bit 7 6 5 4 Name 3 2 1 0 REFSL TEMPE BIASE REFBE Type R R R R R/W R/W R/W R/W Reset 0 0 0 0 0 0 0 0 SFR Address = 0xD1 Bit Name 7:4 3 Function UNUSED Unused. Read = 0000b; Write = don’t care. REFSL Voltage Reference Select. This bit selects the ADCs voltage reference. 0: VREF pin used as voltage reference. 1: VDD used as voltage reference. 2 TEMPE Temperature Sensor Enable Bit. 0: Internal Temperature Sensor off. 1: Internal Temperature Sensor on. 1 BIASE Internal Analog Bias Generator Enable Bit. 0: Internal Bias Generator off. 1: Internal Bias Generator on. 0 REFBE On-chip Reference Buffer Enable Bit. 0: On-chip Reference Buffer off. 1: On-chip Reference Buffer on. Internal voltage reference driven on the VREF pin. 57 Rev.1.0 C8051F336/7/8/9 11. Comparator0 C8051F336/7/8/9 devices include an on-chip programmable voltage comparator, Comparator0, shown in Figure 11.1. The Comparator offers programmable response time and hysteresis, an analog input multiplexer, and two outputs that are optionally available at the Port pins: a synchronous “latched” output (CP0), or an asynchronous “raw” output (CP0A). The asynchronous CP0A signal is available even when the system clock is not active. This allows the Comparator to operate and generate an output with the device in STOP mode. When assigned to a Port pin, the Comparator output may be configured as open drain or push-pull (see Section “20.4. Port I/O Initialization” on page 126). Comparator0 may also be used as a reset source (see Section “17.5. Comparator0 Reset” on page 104). The Comparator0 inputs are selected by the comparator input multiplexer, as detailed in Section “11.1. Comparator Multiplexer” on page 63. CPT0CN CP0EN CP0OUT CP0RIF CP0FIF CP0HYP1 CP0HYP0 CP0HYN1 CP0HYN0 VDD CP0 + + Comparator Input Mux CP0 - CP0 D - SET CLR D Q Q SET CLR Q Q Crossbar (SYNCHRONIZER) CP0A GND CPT0MD CP0FIE CP0RIE CP0MD1 CP0MD0 Reset Decision Tree CP0RIF CP0FIF 0 CP0EN EA 1 0 0 0 1 1 CP0 Interrupt 1 Figure 11.1. Comparator0 Functional Block Diagram The Comparator output can be polled in software, used as an interrupt source, and/or routed to a Port pin. When routed to a Port pin, the Comparator output is available asynchronous or synchronous to the system clock; the asynchronous output is available even in STOP mode (with no system clock active). When disabled, the Comparator output (if assigned to a Port I/O pin via the Crossbar) defaults to the logic low state, and the power supply to the comparator is turned off. See Section “20.3. Priority Crossbar Decoder” on page 124 for details on configuring Comparator outputs via the digital Crossbar. Comparator inputs can be Rev.1.0 58 C8051F336/7/8/9 externally driven from –0.25 V to (VDD) + 0.25 V without damage or upset. The complete Comparator electrical specifications are given in Section “6. Electrical Characteristics” on page 27. The Comparator response time may be configured in software via the CPT0MD register (see SFR Definition 11.2). Selecting a longer response time reduces the Comparator supply current. VIN+ VIN- CP0+ CP0- + CP0 _ OUT CIRCUIT CONFIGURATION Positive Hysteresis Voltage (Programmed with CP0HYP Bits) VIN- INPUTS Negative Hysteresis Voltage (Programmed by CP0HYN Bits) VIN+ VOH OUTPUT VOL Negative Hysteresis Disabled Positive Hysteresis Disabled Maximum Negative Hysteresis Maximum Positive Hysteresis Figure 11.2. Comparator Hysteresis Plot The Comparator hysteresis is software-programmable via its Comparator Control register CPT0CN. The user can program both the amount of hysteresis voltage (referred to the input voltage) and the positive and negative-going symmetry of this hysteresis around the threshold voltage. The Comparator hysteresis is programmed using Bits3–0 in the Comparator Control Register CPT0CN (shown in SFR Definition 11.1). The amount of negative hysteresis voltage is determined by the settings of the CP0HYN bits. As shown in Figure 11.2, settings of 20, 10 or 5 mV of negative hysteresis can be programmed, or negative hysteresis can be disabled. In a similar way, the amount of positive hysteresis is determined by the setting the CP0HYP bits. Comparator interrupts can be generated on both rising-edge and falling-edge output transitions. (For Interrupt enable and priority control, see Section “15.1. MCU Interrupt Sources and Vectors” on page 83). The CP0FIF flag is set to logic 1 upon a Comparator falling-edge occurrence, and the CP0RIF flag is set to logic 1 upon the Comparator rising-edge occurrence. Once set, these bits remain set until cleared by software. The Comparator rising-edge interrupt mask is enabled by setting CP0RIE to a logic 1. The Comparator0 falling-edge interrupt mask is enabled by setting CP0FIE to a logic 1. 59 Rev.1.0 C8051F336/7/8/9 The output state of the Comparator can be obtained at any time by reading the CP0OUT bit. The Comparator is enabled by setting the CP0EN bit to logic 1, and is disabled by clearing this bit to logic 0. Note that false rising edges and falling edges can be detected when the comparator is first powered on or if changes are made to the hysteresis or response time control bits. Therefore, it is recommended that the rising-edge and falling-edge flags be explicitly cleared to logic 0 a short time after the comparator is enabled or its mode bits have been changed. Rev.1.0 60 C8051F336/7/8/9 SFR Definition 11.1. CPT0CN: Comparator0 Control Bit 7 6 5 4 Name CP0EN CP0OUT CP0RIF CP0FIF CP0HYP[1:0] CP0HYN[1:0] Type R/W R R/W R/W R/W R/W Reset 0 0 0 0 SFR Address = 0x9B Bit Name 7 CP0EN 3 2 0 0 1 0 0 0 Function Comparator0 Enable Bit. 0: Comparator0 Disabled. 1: Comparator0 Enabled. 6 CP0OUT Comparator0 Output State Flag. 0: Voltage on CP0+ < CP0–. 1: Voltage on CP0+ > CP0–. 5 CP0RIF Comparator0 Rising-Edge Flag. Must be cleared by software. 0: No Comparator0 Rising Edge has occurred since this flag was last cleared. 1: Comparator0 Rising Edge has occurred. 4 CP0FIF Comparator0 Falling-Edge Flag. Must be cleared by software. 0: No Comparator0 Falling-Edge has occurred since this flag was last cleared. 1: Comparator0 Falling-Edge has occurred. 3:2 CP0HYP[1:0] Comparator0 Positive Hysteresis Control Bits. 00: Positive Hysteresis Disabled. 01: Positive Hysteresis = 5 mV. 10: Positive Hysteresis = 10 mV. 11: Positive Hysteresis = 20 mV. 1:0 CP0HYN[1:0] Comparator0 Negative Hysteresis Control Bits. 00: Negative Hysteresis Disabled. 01: Negative Hysteresis = 5 mV. 10: Negative Hysteresis = 10 mV. 11: Negative Hysteresis = 20 mV. 61 Rev.1.0 C8051F336/7/8/9 SFR Definition 11.2. CPT0MD: Comparator0 Mode Selection Bit 7 6 Name 5 4 3 CP0RIE CP0FIE 2 R R R/W R/W R R Reset 0 0 0 0 0 0 R/W 1 0 Function 7:6 5 Unused CP0RIE Unused. Read = 00b, Write = Don’t Care. 4 CP0FIE Comparator0 Falling-Edge Interrupt Enable. 0: Comparator0 Falling-edge interrupt disabled. 1: Comparator0 Falling-edge interrupt enabled. 3:2 1:0 0 CP0MD[1:0] Type SFR Address = 0x9D Bit Name 1 Comparator0 Rising-Edge Interrupt Enable. 0: Comparator0 Rising-edge interrupt disabled. 1: Comparator0 Rising-edge interrupt enabled. Unused Unused. Read = 00b, Write = don’t care. CP0MD[1:0] Comparator0 Mode Select. These bits affect the response time and power consumption for Comparator0. 00: Mode 0 (Fastest Response Time, Highest Power Consumption) 01: Mode 1 10: Mode 2 11: Mode 3 (Slowest Response Time, Lowest Power Consumption) Rev.1.0 62 C8051F336/7/8/9 11.1. Comparator Multiplexer C8051F336/7/8/9 devices include an analog input multiplexer to connect Port I/O pins to the comparator inputs. The Comparator0 inputs are selected in the CPT0MX register (SFR Definition 11.3). The CMX0P1– CMX0P0 bits select the Comparator0 positive input; the CMX0N1–CMX0N0 bits select the Comparator0 negative input. Important Note About Comparator Inputs: The Port pins selected as comparator inputs should be configured as analog inputs in their associated Port configuration register, and configured to be skipped by the Crossbar (for details on Port configuration, see Section “20.6. Special Function Registers for Accessing and Configuring Port I/O” on page 131). CPT0MX CMX0N3 CMX0N2 CMX0N1 CMX0N0 CMX0P3 CMX0P2 CMX0P1 CMX0P0 P0.0 P0.2 P0.4 P0.6 P1.0 P1.2 P1.4 P1.6 P2.0* P2.2* P0.1 P0.3 P0.5 P0.7 P1.1 P1.3 P1.5 P1.7 P2.1* P2.3* VDD CP0 + + CP0 - GND *P2.0-P2.3 Only available as inputs on QFN24 Packaging Figure 11.3. Comparator Input Multiplexer Block Diagram Rev.1.0 63 C8051F336/7/8/9 SFR Definition 11.3. CPT0MX: Comparator0 MUX Selection Bit 7 6 5 4 3 2 1 Name CMX0N[3:0] CMX0P[3:0] Type R/W R/W Reset 1 1 1 1 SFR Address = 0x9F Bit Name 7:4 P0.1 P0.3 P0.5 P0.7 P1.1 P1.3 P1.5 P1.7 P2.1 (C8051F338/9 Only) P2.3 (C8051F338/9 Only) None CMX0P[3:0] Comparator0 Positive Input MUX Selection. 0000: 0001: 0010: 0011: 0100: 0101: 0110: 0111: 1000: 1001: 1010-1111: 64 Function CMX0N[3:0] Comparator0 Negative Input MUX Selection. 0000: 0001: 0010: 0011: 0100: 0101: 0110: 0111: 1000: 1001: 1010-1111: 3:0 1 P0.0 P0.2 P0.4 P0.6 P1.0 P1.2 P1.4 P1.6 P2.0 (C8051F338/9 Only) P2.2 (C8051F338/9 Only) None Rev.1.0 1 1 0 1 C8051F336/7/8/9 12. CIP-51 Microcontroller The MCU system controller core is the CIP-51 microcontroller. The CIP-51 is fully compatible with the MCS-51™ instruction set; standard 803x/805x assemblers and compilers can be used to develop software. The MCU family has a superset of all the peripherals included with a standard 8051. The CIP-51 also includes on-chip debug hardware (see description in Section 26), and interfaces directly with the analog and digital subsystems providing a complete data acquisition or control-system solution in a single integrated circuit. The CIP-51 Microcontroller core implements the standard 8051 organization and peripherals as well as additional custom peripherals and functions to extend its capability (see Figure 12.1 for a block diagram). The CIP-51 includes the following features: Fully Reset 25 Compatible with MCS-51 Instruction Set MIPS Peak Throughput with 25 MHz Clock 0 to 25 MHz Clock Frequency Extended Interrupt Handler Power Input Management Modes On-chip Debug Logic Program and Data Memory Security Performance The CIP-51 employs a pipelined architecture that greatly increases its instruction throughput over the standard 8051 architecture. In a standard 8051, all instructions except for MUL and DIV take 12 or 24 system clock cycles to execute, and usually have a maximum system clock of 12 MHz. By contrast, the CIP-51 core executes 70% of its instructions in one or two system clock cycles, with no instructions taking more than eight system clock cycles. D8 D8 ACCUMULATOR STACK POINTER TMP1 TMP2 SRAM ADDRESS REGISTER PSW D8 D8 D8 ALU SRAM D8 DATA BUS B REGISTER D8 D8 D8 DATA BUS DATA BUS SFR_ADDRESS BUFFER D8 DATA POINTER D8 D8 SFR BUS INTERFACE SFR_CONTROL SFR_WRITE_DATA SFR_READ_DATA DATA BUS PC INCREMENTER PROGRAM COUNTER (PC) PRGM. ADDRESS REG. MEM_ADDRESS D8 MEM_CONTROL A16 MEMORY INTERFACE MEM_WRITE_DATA MEM_READ_DATA PIPELINE RESET D8 CONTROL LOGIC SYSTEM_IRQs CLOCK D8 STOP IDLE POWER CONTROL REGISTER INTERRUPT INTERFACE EMULATION_IRQ D8 Figure 12.1. CIP-51 Block Diagram Rev.1.0 65 C8051F336/7/8/9 With the CIP-51's maximum system clock at 25 MHz, it has a peak throughput of 25 MIPS. The CIP-51 has a total of 109 instructions. The table below shows the total number of instructions that require each execution time. Clocks to Execute 1 2 2/3 3 3/4 4 4/5 5 8 Number of Instructions 26 50 5 14 7 3 1 2 1 12.1. Instruction Set The instruction set of the CIP-51 System Controller is fully compatible with the standard MCS-51™ instruction set. Standard 8051 development tools can be used to develop software for the CIP-51. All CIP-51 instructions are the binary and functional equivalent of their MCS-51™ counterparts, including opcodes, addressing modes and effect on PSW flags. However, instruction timing is different than that of the standard 8051. 12.1.1. Instruction and CPU Timing In many 8051 implementations, a distinction is made between machine cycles and clock cycles, with machine cycles varying from 2 to 12 clock cycles in length. However, the CIP-51 implementation is based solely on clock cycle timing. All instruction timings are specified in terms of clock cycles. Due to the pipelined architecture of the CIP-51, most instructions execute in the same number of clock cycles as there are program bytes in the instruction. Conditional branch instructions take one less clock cycle to complete when the branch is not taken as opposed to when the branch is taken. Table 12.1 is the CIP-51 Instruction Set Summary, which includes the mnemonic, number of bytes, and number of clock cycles for each instruction. 66 Rev.1.0 C8051F336/7/8/9 Table 12.1. CIP-51 Instruction Set Summary Mnemonic Description Bytes Clock Cycles Add register to A Add direct byte to A Add indirect RAM to A Add immediate to A Add register to A with carry Add direct byte to A with carry Add indirect RAM to A with carry Add immediate to A with carry Subtract register from A with borrow Subtract direct byte from A with borrow Subtract indirect RAM from A with borrow Subtract immediate from A with borrow Increment A Increment register Increment direct byte Increment indirect RAM Decrement A Decrement register Decrement direct byte Decrement indirect RAM Increment Data Pointer Multiply A and B Divide A by B Decimal adjust A 1 2 1 2 1 2 1 2 1 2 1 2 1 1 2 1 1 1 2 1 1 1 1 1 1 2 2 2 1 2 2 2 1 2 2 2 1 1 2 2 1 1 2 2 1 4 8 1 AND Register to A AND direct byte to A AND indirect RAM to A AND immediate to A AND A to direct byte AND immediate to direct byte OR Register to A OR direct byte to A OR indirect RAM to A OR immediate to A OR A to direct byte OR immediate to direct byte Exclusive-OR Register to A Exclusive-OR direct byte to A Exclusive-OR indirect RAM to A Exclusive-OR immediate to A Exclusive-OR A to direct byte 1 2 1 2 2 3 1 2 1 2 2 3 1 2 1 2 2 1 2 2 2 2 3 1 2 2 2 2 3 1 2 2 2 2 Arithmetic Operations ADD A, Rn ADD A, direct ADD A, @Ri ADD A, #data ADDC A, Rn ADDC A, direct ADDC A, @Ri ADDC A, #data SUBB A, Rn SUBB A, direct SUBB A, @Ri SUBB A, #data INC A INC Rn INC direct INC @Ri DEC A DEC Rn DEC direct DEC @Ri INC DPTR MUL AB DIV AB DA A Logical Operations ANL A, Rn ANL A, direct ANL A, @Ri ANL A, #data ANL direct, A ANL direct, #data ORL A, Rn ORL A, direct ORL A, @Ri ORL A, #data ORL direct, A ORL direct, #data XRL A, Rn XRL A, direct XRL A, @Ri XRL A, #data XRL direct, A Rev.1.0 67 C8051F336/7/8/9 Table 12.1. CIP-51 Instruction Set Summary (Continued) Mnemonic Description Bytes Clock Cycles XRL direct, #data CLR A CPL A RL A RLC A RR A RRC A SWAP A Exclusive-OR immediate to direct byte Clear A Complement A Rotate A left Rotate A left through Carry Rotate A right Rotate A right through Carry Swap nibbles of A 3 1 1 1 1 1 1 1 3 1 1 1 1 1 1 1 Move Register to A Move direct byte to A Move indirect RAM to A Move immediate to A Move A to Register Move direct byte to Register Move immediate to Register Move A to direct byte Move Register to direct byte Move direct byte to direct byte Move indirect RAM to direct byte Move immediate to direct byte Move A to indirect RAM Move direct byte to indirect RAM Move immediate to indirect RAM Load DPTR with 16-bit constant Move code byte relative DPTR to A Move code byte relative PC to A Move external data (8-bit address) to A Move A to external data (8-bit address) Move external data (16-bit address) to A Move A to external data (16-bit address) Push direct byte onto stack Pop direct byte from stack Exchange Register with A Exchange direct byte with A Exchange indirect RAM with A Exchange low nibble of indirect RAM with A 1 2 1 2 1 2 2 2 2 3 2 3 1 2 2 3 1 1 1 1 1 1 2 2 1 2 1 1 1 2 2 2 1 2 2 2 2 3 2 3 2 2 2 3 3 3 3 3 3 3 2 2 1 2 2 2 Clear Carry Clear direct bit Set Carry Set direct bit Complement Carry Complement direct bit 1 2 1 2 1 2 1 2 1 2 1 2 Data Transfer MOV A, Rn MOV A, direct MOV A, @Ri MOV A, #data MOV Rn, A MOV Rn, direct MOV Rn, #data MOV direct, A MOV direct, Rn MOV direct, direct MOV direct, @Ri MOV direct, #data MOV @Ri, A MOV @Ri, direct MOV @Ri, #data MOV DPTR, #data16 MOVC A, @A+DPTR MOVC A, @A+PC MOVX A, @Ri MOVX @Ri, A MOVX A, @DPTR MOVX @DPTR, A PUSH direct POP direct XCH A, Rn XCH A, direct XCH A, @Ri XCHD A, @Ri Boolean Manipulation CLR C CLR bit SETB C SETB bit CPL C CPL bit 68 Rev.1.0 C8051F336/7/8/9 Table 12.1. CIP-51 Instruction Set Summary (Continued) Mnemonic Description Bytes Clock Cycles ANL C, bit ANL C, /bit ORL C, bit ORL C, /bit MOV C, bit MOV bit, C JC rel JNC rel JB bit, rel JNB bit, rel JBC bit, rel AND direct bit to Carry AND complement of direct bit to Carry OR direct bit to carry OR complement of direct bit to Carry Move direct bit to Carry Move Carry to direct bit Jump if Carry is set Jump if Carry is not set Jump if direct bit is set Jump if direct bit is not set Jump if direct bit is set and clear bit 2 2 2 2 2 2 2 2 3 3 3 2 2 2 2 2 2 2/3 2/3 3/4 3/4 3/4 Absolute subroutine call Long subroutine call Return from subroutine Return from interrupt Absolute jump Long jump Short jump (relative address) Jump indirect relative to DPTR Jump if A equals zero Jump if A does not equal zero Compare direct byte to A and jump if not equal Compare immediate to A and jump if not equal Compare immediate to Register and jump if not equal Compare immediate to indirect and jump if not equal Decrement Register and jump if not zero Decrement direct byte and jump if not zero No operation 2 3 1 1 2 3 2 1 2 2 3 3 3 3 4 5 5 3 4 3 3 2/3 2/3 3/4 3/4 3/4 3 4/5 2 3 1 2/3 3/4 1 Program Branching ACALL addr11 LCALL addr16 RET RETI AJMP addr11 LJMP addr16 SJMP rel JMP @A+DPTR JZ rel JNZ rel CJNE A, direct, rel CJNE A, #data, rel CJNE Rn, #data, rel CJNE @Ri, #data, rel DJNZ Rn, rel DJNZ direct, rel NOP Rev.1.0 69 C8051F336/7/8/9 Notes on Registers, Operands and Addressing Modes: Rn - Register R0–R7 of the currently selected register bank. @Ri - Data RAM location addressed indirectly through R0 or R1. rel - 8-bit, signed (twos complement) offset relative to the first byte of the following instruction. Used by SJMP and all conditional jumps. direct - 8-bit internal data location’s address. This could be a direct-access Data RAM location (0x00–0x7F) or an SFR (0x80–0xFF). #data - 8-bit constant #data16 - 16-bit constant bit - Direct-accessed bit in Data RAM or SFR addr11 - 11-bit destination address used by ACALL and AJMP. The destination must be within the same 2 kB page of program memory as the first byte of the following instruction. addr16 - 16-bit destination address used by LCALL and LJMP. The destination may be anywhere within the 8 kB program memory space. There is one unused opcode (0xA5) that performs the same function as NOP. All mnemonics copyrighted © Intel Corporation 1980. 70 Rev.1.0 C8051F336/7/8/9 12.2. CIP-51 Register Descriptions Following are descriptions of SFRs related to the operation of the CIP-51 System Controller. Reserved bits should always be written to the value indicated in the SFR description. Future product versions may use these bits to implement new features in which case the reset value of the bit will be the indicated value, selecting the feature's default state. Detailed descriptions of the remaining SFRs are included in the sections of the data sheet associated with their corresponding system function. SFR Definition 12.1. DPL: Data Pointer Low Byte Bit 7 6 5 4 Name DPL[7:0] Type R/W Reset 0 0 0 0 SFR Address = 0x82 Bit Name 7:0 DPL[7:0] 3 2 1 0 0 0 0 0 3 2 1 0 0 0 0 0 Function Data Pointer Low. The DPL register is the low byte of the 16-bit DPTR. SFR Definition 12.2. DPH: Data Pointer High Byte Bit 7 6 5 4 Name DPH[7:0] Type R/W Reset 0 0 0 SFR Address = 0x83 Bit Name 7:0 DPH[7:0] 0 Function Data Pointer High. The DPH register is the high byte of the 16-bit DPTR. Rev.1.0 71 C8051F336/7/8/9 SFR Definition 12.3. SP: Stack Pointer Bit 7 6 5 4 Name SP[7:0] Type R/W Reset 0 0 0 0 SFR Address = 0x81 Bit Name 7:0 SP[7:0] 3 2 1 0 0 1 1 1 Function Stack Pointer. The Stack Pointer holds the location of the top of the stack. The stack pointer is incremented before every PUSH operation. The SP register defaults to 0x07 after reset. SFR Definition 12.4. ACC: Accumulator Bit 7 6 5 4 Name ACC[7:0] Type R/W Reset 0 0 0 0 SFR Address = 0xE0; Bit-Addressable Bit Name 7:0 ACC[7:0] 3 2 1 0 0 0 0 0 Function Accumulator. This register is the accumulator for arithmetic operations. SFR Definition 12.5. B: B Register Bit 7 6 5 4 Name B[7:0] Type R/W Reset 0 0 0 0 SFR Address = 0xF0; Bit-Addressable Bit Name 7:0 B[7:0] 3 2 1 0 0 0 0 0 Function B Register. This register serves as a second accumulator for certain arithmetic operations. 72 Rev.1.0 C8051F336/7/8/9 SFR Definition 12.6. PSW: Program Status Word Bit 7 6 5 Name CY AC F0 Type R/W R/W R/W Reset 0 0 0 SFR Address = 0xD0; Bit-Addressable Bit Name 7 CY 4 3 2 1 0 RS[1:0] OV F1 PARITY R/W R/W R/W R 0 0 0 0 0 Function Carry Flag. This bit is set when the last arithmetic operation resulted in a carry (addition) or a borrow (subtraction). It is cleared to logic 0 by all other arithmetic operations. 6 AC Auxiliary Carry Flag. This bit is set when the last arithmetic operation resulted in a carry into (addition) or a borrow from (subtraction) the high order nibble. It is cleared to logic 0 by all other arithmetic operations. 5 F0 User Flag 0. This is a bit-addressable, general purpose flag for use under software control. 4:3 RS[1:0] Register Bank Select. These bits select which register bank is used during register accesses. 00: Bank 0, Addresses 0x00-0x07 01: Bank 1, Addresses 0x08-0x0F 10: Bank 2, Addresses 0x10-0x17 11: Bank 3, Addresses 0x18-0x1F 2 OV Overflow Flag. This bit is set to 1 under the following circumstances: An ADD, ADDC, or SUBB instruction causes a sign-change overflow. MUL instruction results in an overflow (result is greater than 255). A DIV instruction causes a divide-by-zero condition. A The OV bit is cleared to 0 by the ADD, ADDC, SUBB, MUL, and DIV instructions in all other cases. 1 F1 User Flag 1. This is a bit-addressable, general purpose flag for use under software control. 0 PARITY Parity Flag. This bit is set to logic 1 if the sum of the eight bits in the accumulator is odd and cleared if the sum is even. Rev.1.0 73 C8051F336/7/8/9 13. Memory Organization The memory organization of the CIP-51 System Controller is similar to that of a standard 8051. There are two separate memory spaces: program memory and data memory. Program and data memory share the same address space but are accessed via different instruction types. The memory organization of the C8051F336/7/8/9 device family is shown in Figure 13.1 PROGRAM/DATA MEMORY (FLASH) DATA MEMORY (RAM) INTERNAL DATA ADDRESS SPACE 0xFF 0x3E00 RESERVED 0x3DFF 0x80 0x7F (Direct and Indirect Addressing) 16 K FLASH (In-System Programmable in 512 Byte Sectors) Upper 128 RAM (Indirect Addressing Only) 0x30 0x2F 0x20 0x1F 0x00 Bit Addressable Special Function Register's (Direct Addressing Only) Lower 128 RAM (Direct and Indirect Addressing) General Purpose Registers 0x0000 EXTERNAL DATA ADDRESS SPACE 0xFFFF Same 512 bytes as from 0x0000 to 0x01FF, wrapped on 512-byte boundaries 0x0200 0x01FF 0x0000 XRAM - 512 Bytes (accessable using MOVX instruction) Figure 13.1. C8051F336/7/8/9 Memory Map Rev.1.0 74 C8051F336/7/8/9 13.1. Program Memory The CIP-51 core has a 64 kB program memory space. The C8051F336/7/8/9 implements 16 kB of this program memory space as in-system, re-programmable Flash memory, organized in a contiguous block from addresses 0x0000 to 0x3DFF. The address 0x3DFF serves as the security lock byte for the device, and addresses above 0x3DFF are reserved. 0x3FFF Reserved Area 0x3DFF 0x3DFE Lock Byte Page 0x3C00 Flash Memory Space FLASH memory organized in 512-byte pages 0x3E00 Lock Byte 0x0000 Figure 13.2. Flash Program Memory Map 13.1.1. MOVX Instruction and Program Memory The MOVX instruction in an 8051 device is typically used to access external data memory. On the C8051F336/7/8/9 devices, the MOVX instruction is normally used to read and write on-chip XRAM, but can be re-configured to write and erase on-chip Flash memory space. MOVC instructions are always used to read Flash memory, while MOVX write instructions are used to erase and write Flash. This Flash access feature provides a mechanism for the C8051F336/7/8/9 to update program code and use the program memory space for non-volatile data storage. Refer to Section “16. Flash Memory” on page 91 for further details. 13.2. Data Memory The C8051F336/7/8/9 device family includes 768 bytes of RAM data memory. 256 bytes of this memory is mapped into the internal RAM space of the 8051. 512 bytes of this memory is on-chip “external” memory. The data memory map is shown in Figure 13.1 for reference. 13.2.1. Internal RAM There are 256 bytes of internal RAM mapped into the data memory space from 0x00 through 0xFF. The lower 128 bytes of data memory are used for general purpose registers and scratch pad memory. Either direct or indirect addressing may be used to access the lower 128 bytes of data memory. Locations 0x00 through 0x1F are addressable as four banks of general purpose registers, each bank consisting of eight byte-wide registers. The next 16 bytes, locations 0x20 through 0x2F, may either be addressed as bytes or as 128 bit locations accessible with the direct addressing mode. The upper 128 bytes of data memory are accessible only by indirect addressing. This region occupies the same address space as the Special Function Registers (SFR) but is physically separate from the SFR 75 Rev.1.0 C8051F336/7/8/9 space. The addressing mode used by an instruction when accessing locations above 0x7F determines whether the CPU accesses the upper 128 bytes of data memory space or the SFRs. Instructions that use direct addressing will access the SFR space. Instructions using indirect addressing above 0x7F access the upper 128 bytes of data memory. Figure 13.1 illustrates the data memory organization of the C8051F336/7/8/9. 13.2.1.1. General Purpose Registers The lower 32 bytes of data memory, locations 0x00 through 0x1F, may be addressed as four banks of general-purpose registers. Each bank consists of eight byte-wide registers designated R0 through R7. Only one of these banks may be enabled at a time. Two bits in the program status word, RS0 (PSW.3) and RS1 (PSW.4), select the active register bank (see description of the PSW in SFR Definition 12.6). This allows fast context switching when entering subroutines and interrupt service routines. Indirect addressing modes use registers R0 and R1 as index registers. 13.2.1.2. Bit Addressable Locations In addition to direct access to data memory organized as bytes, the sixteen data memory locations at 0x20 through 0x2F are also accessible as 128 individually addressable bits. Each bit has a bit address from 0x00 to 0x7F. Bit 0 of the byte at 0x20 has bit address 0x00 while bit7 of the byte at 0x20 has bit address 0x07. Bit 7 of the byte at 0x2F has bit address 0x7F. A bit access is distinguished from a full byte access by the type of instruction used (bit source or destination operands as opposed to a byte source or destination). The MCS-51™ assembly language allows an alternate notation for bit addressing of the form XX.B where XX is the byte address and B is the bit position within the byte. For example, the instruction: MOV C, 22.3h moves the Boolean value at 0x13 (bit 3 of the byte at location 0x22) into the Carry flag. 13.2.1.3. Stack A programmer's stack can be located anywhere in the 256-byte data memory. The stack area is designated using the Stack Pointer (SP) SFR. The SP will point to the last location used. The next value pushed on the stack is placed at SP+1 and then SP is incremented. A reset initializes the stack pointer to location 0x07. Therefore, the first value pushed on the stack is placed at location 0x08, which is also the first register (R0) of register bank 1. Thus, if more than one register bank is to be used, the SP should be initialized to a location in the data memory not being used for data storage. The stack depth can extend up to 256 bytes. 13.2.2. External RAM There are 512 bytes of on-chip RAM mapped into the external data memory space. All of these address locations may be accessed using the external move instruction (MOVX) and the data pointer (DPTR), or using MOVX indirect addressing mode. If the MOVX instruction is used with an 8-bit address operand (such as @R1), then the high byte of the 16-bit address is provided by the External Memory Interface Control Register (EMI0CN as shown in SFR Definition 13.1). Note: the MOVX instruction is also used for writes to the Flash memory. See Section “16. Flash Memory” on page 91 for details. The MOVX instruction accesses XRAM by default. For a 16-bit MOVX operation (@DPTR), the upper 7 bits of the 16-bit external data memory address word are "don't cares". As a result, the 512-byte RAM is mapped modulo style over the entire 64 k external data memory address range. For example, the XRAM byte at address 0x0000 is shadowed at addresses 0x0200, 0x0400, 0x0600, 0x0800, etc. This is a useful feature when performing a linear memory fill, as the address pointer doesn't have to be reset when reaching the RAM block boundary. Rev.1.0 76 C8051F336/7/8/9 SFR Definition 13.1. EMI0CN: External Memory Interface Control Bit 7 6 5 4 3 2 1 0 PGSEL Name Type R/W R/W R/W R/W R/W R/W R/W R/W Reset 0 0 0 0 0 0 0 0 SFR Address = 0xAA Bit Name 7:1 0 UNUSED PGSEL Function Unused. Read = 0000000b; Write = Don’t Care XRAM Page Select. The EMI0CN register provides the high byte of the 16-bit external data memory address when using an 8-bit MOVX command, effectively selecting a 256-byte page of RAM. Since the upper (unused) bits of the register are always zero, the PGSEL determines which page of XRAM is accessed. For Example: If EMI0CN = 0x01, addresses 0x0100 through 0x01FF will be accessed. 77 Rev.1.0 C8051F336/7/8/9 14. Special Function Registers The direct-access data memory locations from 0x80 to 0xFF constitute the special function registers (SFRs). The SFRs provide control and data exchange with the C8051F336/7/8/9's resources and peripherals. The CIP-51 controller core duplicates the SFRs found in a typical 8051 implementation as well as implementing additional SFRs used to configure and access the sub-systems unique to the C8051F336/7/8/9. This allows the addition of new functionality while retaining compatibility with the MCS51™ instruction set. Table 14.1 lists the SFRs implemented in the C8051F336/7/8/9 device family. The SFR registers are accessed anytime the direct addressing mode is used to access memory locations from 0x80 to 0xFF. SFRs with addresses ending in 0x0 or 0x8 (e.g. P0, TCON, SCON0, IE, etc.) are bitaddressable as well as byte-addressable. All other SFRs are byte-addressable only. Unoccupied addresses in the SFR space are reserved for future use. Accessing these areas will have an indeterminate effect and should be avoided. Refer to the corresponding pages of the data sheet, as indicated in Table 14.2, for a detailed description of each register. Table 14.1. Special Function Register (SFR) Memory Map F8 F0 E8 E0 D8 D0 C8 C0 B8 B0 A8 A0 98 90 88 80 SPI0CN PCA0L PCA0H PCA0CPL0 PCA0CPH0 P0MAT P0MASK VDM0CN B P0MDIN P1MDIN P2MDIN EIP1 PCA0PWM ADC0CN PCA0CPL1 PCA0CPH1 PCA0CPL2 PCA0CPH2 P1MAT P1MASK RSTSRC ACC XBR0 XBR1 OSCLCN IT01CF EIE1 SMB0ADM PCA0CN PCA0MD PCA0CPM0 PCA0CPM1 PCA0CPM2 PSW REF0CN P0SKIP P1SKIP P2SKIP SMB0ADR TMR2CN TMR2RLL TMR2RLH TMR2L TMR2H SMB0CN SMB0CF SMB0DAT ADC0GTL ADC0GTH ADC0LTL ADC0LTH IP IDA0CN AMX0N AMX0P ADC0CF ADC0L ADC0H OSCXCN OSCICN OSCICL FLSCL FLKEY IE CLKSEL EMI0CN P2 SPI0CFG SPI0CKR SPI0DAT P0MDOUT P1MDOUT P2MDOUT SCON0 SBUF0 CPT0CN CPT0MD CPT0MX P1 TMR3CN TMR3RLL TMR3RLH TMR3L TMR3H IDA0L IDA0H TCON TMOD TL0 TL1 TH0 TH1 CKCON PSCTL P0 SP DPL DPH PCON 0(8) 1(9) 2(A) 3(B) 4(C) 5(D) 6(E) 7(F) Note: SFR Addresses ending in 0x0 or 0x8 are bit-addressable locations and can be used with bitwise instructions. Rev.1.0 78 C8051F336/7/8/9 Table 14.2. Special Function Registers SFRs are listed in alphabetical order. All undefined SFR locations are reserved Register Address Description Page ACC 0xE0 Accumulator 72 ADC0CF 0xBC ADC0 Configuration 41 ADC0CN 0xE8 ADC0 Control 43 ADC0GTH 0xC4 ADC0 Greater-Than Compare High 44 ADC0GTL 0xC3 ADC0 Greater-Than Compare Low 44 ADC0H 0xBE ADC0 High 42 ADC0L 0xBD ADC0 Low 42 ADC0LTH 0xC6 ADC0 Less-Than Compare Word High 45 ADC0LTL 0xC5 ADC0 Less-Than Compare Word Low 45 AMX0N 0xBA AMUX0 Negative Channel Select 50 AMX0P 0xBB AMUX0 Positive Channel Select 49 B 0xF0 B Register 72 CKCON 0x8E Clock Control 181 CLKSEL 0xA9 Clock Select 110 CPT0CN 0x9B Comparator0 Control 61 CPT0MD 0x9D Comparator0 Mode Selection 62 CPT0MX 0x9F Comparator0 MUX Selection 64 DPH 0x83 Data Pointer High 71 DPL 0x82 Data Pointer Low 71 EIE1 0xE6 Extended Interrupt Enable 1 87 EIP1 0xF6 Extended Interrupt Priority 1 88 EMI0CN 0xAA External Memory Interface Control 77 FLKEY 0xB7 Flash Lock and Key 98 FLSCL 0xB6 Flash Scale 99 IDA0CN 0xB9 Current Mode DAC0 Control 54 IDA0H 0x97 Current Mode DAC0 High 55 IDA0L 0x96 Current Mode DAC0 Low 55 IE 0xA8 Interrupt Enable 85 IP 0xB8 Interrupt Priority 86 IT01CF 0xE4 INT0/INT1 Configuration 90 OSCICL 0xB3 Internal Oscillator Calibration 111 OSCICN 0xB2 Internal Oscillator Control 112 OSCLCN 0xE3 Low-Frequency Oscillator Control 113 79 Rev.1.0 C8051F336/7/8/9 Table 14.2. Special Function Registers (Continued) SFRs are listed in alphabetical order. All undefined SFR locations are reserved Register Address Description Page OSCXCN 0xB1 External Oscillator Control 115 P0 0x80 Port 0 Latch 132 P0MASK 0xFE Port 0 Mask Configuration 129 P0MAT 0xFD Port 0 Match Configuration 130 P0MDIN 0xF1 Port 0 Input Mode Configuration 132 P0MDOUT 0xA4 Port 0 Output Mode Configuration 133 P0SKIP 0xD4 Port 0 Skip 133 P1 0x90 Port 1 Latch 134 P1MASK 0xEE Port 1Mask Configuration 130 P1MAT 0xED Port 1 Match Configuration 131 P1MDIN 0xF2 Port 1 Input Mode Configuration 134 P1MDOUT 0xA5 Port 1 Output Mode Configuration 135 P1SKIP 0xD5 Port 1 Skip 135 P2 0xA0 Port 2 Latch 136 P2MDIN 0xF3 Port 2 Input Mode Configuration 136 P2MDOUT 0xA6 Port 2 Output Mode Configuration 137 P2SKIP 0xD6 Port 2 Skip 137 PCA0CN 0xD8 PCA Control 215 PCA0CPH0 0xFC PCA Capture 0 High 220 PCA0CPH1 0xEA PCA Capture 1 High 220 PCA0CPH2 0xEC PCA Capture 2 High 220 PCA0CPL0 0xFB PCA Capture 0 Low 220 PCA0CPL1 0xE9 PCA Capture 1 Low 220 PCA0CPL2 0xEB PCA Capture 2 Low 220 PCA0CPM0 0xDA PCA Module 0 Mode Register 218 PCA0CPM1 0xDB PCA Module 1 Mode Register 218 PCA0CPM2 0xDC PCA Module 2 Mode Register 218 PCA0H 0xFA PCA Counter High 219 PCA0L 0xF9 PCA Counter Low 219 PCA0MD 0xD9 PCA Mode 216 PCA0PWM 0xF7 PCA PWM Configuration 217 PCON 0x87 Power Control 108 PSCTL 0x8F Program Store R/W Control 97 PSW 0xD0 Program Status Word 73 Rev.1.0 80 C8051F336/7/8/9 Table 14.2. Special Function Registers (Continued) SFRs are listed in alphabetical order. All undefined SFR locations are reserved Register Address REF0CN 0xD1 Voltage Reference Control 57 RSTSRC 0xEF Reset Source Configuration/Status 105 SBUF0 0x99 UART0 Data Buffer 165 SCON0 0x98 UART0 Control 164 SMB0ADM 0xE7 SMBus Slave Address Mask 149 SMB0ADR 0xD7 SMBus Slave Address 148 SMB0CF 0xC1 SMBus Configuration 144 SMB0CN 0xC0 SMBus Control 146 SMB0DAT 0xC2 SMBus Data 150 SP 0x81 Stack Pointer 72 SPI0CFG 0xA1 SPI Configuration 174 SPI0CKR 0xA2 SPI Clock Rate Control 176 SPI0CN 0xF8 SPI Control 175 SPI0DAT 0xA3 SPI Data 176 TCON 0x88 Timer/Counter Control 186 TH0 0x8C Timer/Counter 0 High 189 TH1 0x8D Timer/Counter 1 High 189 TL0 0x8A Timer/Counter 0 Low 188 TL1 0x8B Timer/Counter 1 Low 188 TMOD 0x89 Timer/Counter Mode 187 TMR2CN 0xC8 Timer/Counter 2 Control 193 TMR2H 0xCD Timer/Counter 2 High 195 TMR2L 0xCC Timer/Counter 2 Low 194 TMR2RLH 0xCB Timer/Counter 2 Reload High 194 TMR2RLL 0xCA Timer/Counter 2 Reload Low 194 TMR3CN 0x91 Timer/Counter 3Control 199 TMR3H 0x95 Timer/Counter 3 High 201 TMR3L 0x94 Timer/Counter 3Low 200 TMR3RLH 0x93 Timer/Counter 3 Reload High 200 TMR3RLL 0x92 Timer/Counter 3 Reload Low 200 VDM0CN 0xFF VDD Monitor Control 103 XBR0 0xE1 Port I/O Crossbar Control 0 127 XBR1 0xE2 Port I/O Crossbar Control 1 128 81 Description Page Rev.1.0 C8051F336/7/8/9 15. Interrupts The C8051F336/7/8/9 includes an extended interrupt system supporting a total of 14 interrupt sources with two priority levels. The allocation of interrupt sources between on-chip peripherals and external input pins varies according to the specific version of the device. Each interrupt source has one or more associated interrupt-pending flag(s) located in an SFR. When a peripheral or external source meets a valid interrupt condition, the associated interrupt-pending flag is set to logic 1. If interrupts are enabled for the source, an interrupt request is generated when the interrupt-pending flag is set. As soon as execution of the current instruction is complete, the CPU generates an LCALL to a predetermined address to begin execution of an interrupt service routine (ISR). Each ISR must end with an RETI instruction, which returns program execution to the next instruction that would have been executed if the interrupt request had not occurred. If interrupts are not enabled, the interrupt-pending flag is ignored by the hardware and program execution continues as normal. (The interrupt-pending flag is set to logic 1 regardless of the interrupt's enable/disable state.) Each interrupt source can be individually enabled or disabled through the use of an associated interrupt enable bit in an SFR (IE–EIE1). However, interrupts must first be globally enabled by setting the EA bit (IE.7) to logic 1 before the individual interrupt enables are recognized. Setting the EA bit to logic 0 disables all interrupt sources regardless of the individual interrupt-enable settings. Note: Any instruction that clears a bit to disable an interrupt should be immediately followed by an instruction that has two or more opcode bytes. Using EA (global interrupt enable) as an example: // in 'C': EA = 0; // clear EA bit. EA = 0; // this is a dummy instruction with two-byte opcode. ; in assembly: CLR EA ; clear EA bit. CLR EA ; this is a dummy instruction with two-byte opcode. For example, if an interrupt is posted during the execution phase of a "CLR EA" opcode (or any instruction which clears a bit to disable an interrupt source), and the instruction is followed by a single-cycle instruction, the interrupt may be taken. However, a read of the enable bit will return a '0' inside the interrupt service routine. When the bit-clearing opcode is followed by a multi-cycle instruction, the interrupt will not be taken. Some interrupt-pending flags are automatically cleared by the hardware when the CPU vectors to the ISR. However, most are not cleared by the hardware and must be cleared by software before returning from the ISR. If an interrupt-pending flag remains set after the CPU completes the return-from-interrupt (RETI) instruction, a new interrupt request will be generated immediately and the CPU will re-enter the ISR after the completion of the next instruction. Rev.1.0 82 C8051F336/7/8/9 15.1. MCU Interrupt Sources and Vectors The C8051F336/7/8/9 MCUs support 14 interrupt sources. Software can simulate an interrupt by setting any interrupt-pending flag to logic 1. If interrupts are enabled for the flag, an interrupt request will be generated and the CPU will vector to the ISR address associated with the interrupt-pending flag. MCU interrupt sources, associated vector addresses, priority order and control bits are summarized in Table 15.1. Refer to the datasheet section associated with a particular on-chip peripheral for information regarding valid interrupt conditions for the peripheral and the behavior of its interrupt-pending flag(s). 15.1.1. Interrupt Priorities Each interrupt source can be individually programmed to one of two priority levels: low or high. A low priority interrupt service routine can be preempted by a high priority interrupt. A high priority interrupt cannot be preempted. Each interrupt has an associated interrupt priority bit in an SFR (IP or EIP1) used to configure its priority level. Low priority is the default. If two interrupts are recognized simultaneously, the interrupt with the higher priority is serviced first. If both interrupts have the same priority level, a fixed priority order is used to arbitrate, given in Table 15.1. 15.1.2. Interrupt Latency Interrupt response time depends on the state of the CPU when the interrupt occurs. Pending interrupts are sampled and priority decoded each system clock cycle. Therefore, the fastest possible response time is 5 system clock cycles: 1 clock cycle to detect the interrupt and 4 clock cycles to complete the LCALL to the ISR. If an interrupt is pending when a RETI is executed, a single instruction is executed before an LCALL is made to service the pending interrupt. Therefore, the maximum response time for an interrupt (when no other interrupt is currently being serviced or the new interrupt is of greater priority) occurs when the CPU is performing an RETI instruction followed by a DIV as the next instruction. In this case, the response time is 18 system clock cycles: 1 clock cycle to detect the interrupt, 5 clock cycles to execute the RETI, 8 clock cycles to complete the DIV instruction and 4 clock cycles to execute the LCALL to the ISR. If the CPU is executing an ISR for an interrupt with equal or higher priority, the new interrupt will not be serviced until the current ISR completes, including the RETI and following instruction. 83 Rev.1.0 C8051F336/7/8/9 Interrupt Vector Priority Order Pending Flag Reset 0x0000 Top None External Interrupt 0 (/INT0) Timer 0 Overflow External Interrupt 1 (/INT1) Timer 1 Overflow UART0 0x0003 0 IE0 (TCON.1) N/A N/A Always Always Enabled Highest Y Y EX0 (IE.0) PX0 (IP.0) 0x000B 0x0013 1 2 TF0 (TCON.5) IE1 (TCON.3) Y Y Y Y ET0 (IE.1) PT0 (IP.1) EX1 (IE.2) PX1 (IP.2) 0x001B 0x0023 3 4 Y Y Y N ET1 (IE.3) PT1 (IP.3) ES0 (IE.4) PS0 (IP.4) Timer 2 Overflow 0x002B 5 Y N ET2 (IE.5) PT2 (IP.5) SPI0 0x0033 6 Y N ESPI0 (IE.6) SMB0 0x003B 7 TF1 (TCON.7) RI0 (SCON0.0) TI0 (SCON0.1) TF2H (TMR2CN.7) TF2L (TMR2CN.6) SPIF (SPI0CN.7) WCOL (SPI0CN.6) MODF (SPI0CN.5) RXOVRN (SPI0CN.4) SI (SMB0CN.0) Y N Port Match 0x0043 8 None ADC0 Window Compare ADC0 Conversion Complete Programmable Counter Array 0x004B 9 0x0053 10 AD0WINT (ADC0CN.3) AD0INT (ADC0CN.5) 0x005B 11 Comparator0 0x0063 12 RESERVED Timer 3 Overflow 0x006B 0x0073 13 14 Cleared by HW? Interrupt Source Bit addressable? Table 15.1. Interrupt Summary Enable Flag ESMB0 (EIE1.0) N/A N/A EMAT (EIE1.1) Y N EWADC0 (EIE1.2) Y N EADC0 (EIE1.3) Y N EPCA0 (EIE1.4) CF (PCA0CN.7) CCFn (PCA0CN.n) COVF (PCA0PWM.6) CP0FIF (CPT0CN.4) N N CP0RIF (CPT0CN.5) N/A N/A N/A TF3H (TMR3CN.7) N N TF3L (TMR3CN.6) ECP0 (EIE1.5) N/A ET3 (EIE1.7) Priority Control PSPI0 (IP.6) PSMB0 (EIP1.0) PMAT (EIP1.1) PWADC0 (EIP1.2) PADC0 (EIP1.3) PPCA0 (EIP1.4) PCP0 (EIP1.5) N/A PT3 (EIP1.7) 15.2. Interrupt Register Descriptions The SFRs used to enable the interrupt sources and set their priority level are described in this section. Refer to the data sheet section associated with a particular on-chip peripheral for information regarding valid interrupt conditions for the peripheral and the behavior of its interrupt-pending flag(s). Rev.1.0 84 C8051F336/7/8/9 SFR Definition 15.1. IE: Interrupt Enable Bit 7 6 5 4 3 2 1 0 Name EA ESPI0 ET2 ES0 ET1 EX1 ET0 EX0 Type R/W R/W R/W R/W R/W R/W R/W R/W Reset 0 0 0 0 0 0 0 0 SFR Address = 0xA8; Bit-Addressable Bit Name 85 Function 7 EA 6 ESPI0 5 ET2 Enable Timer 2 Interrupt. This bit sets the masking of the Timer 2 interrupt. 0: Disable Timer 2 interrupt. 1: Enable interrupt requests generated by the TF2L or TF2H flags. 4 ES0 Enable UART0 Interrupt. This bit sets the masking of the UART0 interrupt. 0: Disable UART0 interrupt. 1: Enable UART0 interrupt. 3 ET1 Enable Timer 1 Interrupt. This bit sets the masking of the Timer 1 interrupt. 0: Disable all Timer 1 interrupt. 1: Enable interrupt requests generated by the TF1 flag. 2 EX1 Enable External Interrupt 1. This bit sets the masking of External Interrupt 1. 0: Disable external interrupt 1. 1: Enable interrupt requests generated by the /INT1 input. 1 ET0 Enable Timer 0 Interrupt. This bit sets the masking of the Timer 0 interrupt. 0: Disable all Timer 0 interrupt. 1: Enable interrupt requests generated by the TF0 flag. 0 EX0 Enable External Interrupt 0. This bit sets the masking of External Interrupt 0. 0: Disable external interrupt 0. 1: Enable interrupt requests generated by the /INT0 input. Enable All Interrupts. Globally enables/disables all interrupts. It overrides individual interrupt mask settings. 0: Disable all interrupt sources. 1: Enable each interrupt according to its individual mask setting. Enable Serial Peripheral Interface (SPI0) Interrupt. This bit sets the masking of the SPI0 interrupts. 0: Disable all SPI0 interrupts. 1: Enable interrupt requests generated by SPI0. Rev.1.0 C8051F336/7/8/9 SFR Definition 15.2. IP: Interrupt Priority Bit 7 Name 6 5 4 3 2 1 0 PSPI0 PT2 PS0 PT1 PX1 PT0 PX0 Type R R/W R/W R/W R/W R/W R/W R/W Reset 1 0 0 0 0 0 0 0 SFR Address = 0xB8; Bit-Addressable Bit Name 7 6 Function UNUSED Unused. Read = 1, Write = Don't Care. PSPI0 Serial Peripheral Interface (SPI0) Interrupt Priority Control. This bit sets the priority of the SPI0 interrupt. 0: SPI0 interrupt set to low priority level. 1: SPI0 interrupt set to high priority level. 5 PT2 Timer 2 Interrupt Priority Control. This bit sets the priority of the Timer 2 interrupt. 0: Timer 2 interrupt set to low priority level. 1: Timer 2 interrupt set to high priority level. 4 PS0 UART0 Interrupt Priority Control. This bit sets the priority of the UART0 interrupt. 0: UART0 interrupt set to low priority level. 1: UART0 interrupt set to high priority level. 3 PT1 Timer 1 Interrupt Priority Control. This bit sets the priority of the Timer 1 interrupt. 0: Timer 1 interrupt set to low priority level. 1: Timer 1 interrupt set to high priority level. 2 PX1 External Interrupt 1 Priority Control. This bit sets the priority of the External Interrupt 1 interrupt. 0: External Interrupt 1 set to low priority level. 1: External Interrupt 1 set to high priority level. 1 PT0 Timer 0 Interrupt Priority Control. This bit sets the priority of the Timer 0 interrupt. 0: Timer 0 interrupt set to low priority level. 1: Timer 0 interrupt set to high priority level. 0 PX0 External Interrupt 0 Priority Control. This bit sets the priority of the External Interrupt 0 interrupt. 0: External Interrupt 0 set to low priority level. 1: External Interrupt 0 set to high priority level. Rev.1.0 86 C8051F336/7/8/9 SFR Definition 15.3. EIE1: Extended Interrupt Enable 1 Bit 7 6 5 4 3 2 1 0 Name ET3 Reserved ECP0 EPCA0 EADC0 EWADC0 EMAT ESMB0 Type R/W R/W R/W R/W R/W R/W R/W R/W Reset 0 0 0 0 0 0 0 0 SFR Address = 0xE6 Bit Name 7 6 5 Enable Timer 3 Interrupt. This bit sets the masking of the Timer 3 interrupt. 0: Disable Timer 3 interrupts. 1: Enable interrupt requests generated by the TF3L or TF3H flags. Reserved Reserved. Must Write 0. ECP0 Enable Comparator0 (CP0) Interrupt. This bit sets the masking of the CP0 interrupt. 0: Disable CP0 interrupts. 1: Enable interrupt requests generated by the CP0RIF or CP0FIF flags. 4 EPCA0 Enable Programmable Counter Array (PCA0) Interrupt. This bit sets the masking of the PCA0 interrupts. 0: Disable all PCA0 interrupts. 1: Enable interrupt requests generated by PCA0. 3 EADC0 Enable ADC0 Conversion Complete Interrupt. This bit sets the masking of the ADC0 Conversion Complete interrupt. 0: Disable ADC0 Conversion Complete interrupt. 1: Enable interrupt requests generated by the AD0INT flag. 2 87 ET3 Function EWADC0 Enable Window Comparison ADC0 Interrupt. This bit sets the masking of ADC0 Window Comparison interrupt. 0: Disable ADC0 Window Comparison interrupt. 1: Enable interrupt requests generated by ADC0 Window Compare flag (AD0WINT). 1 EMAT 0 ESMB0 Enable Port Match Interrupts. This bit sets the masking of the Port Match Event interrupt. 0: Disable all Port Match interrupts. 1: Enable interrupt requests generated by a Port Match. Enable SMBus (SMB0) Interrupt. This bit sets the masking of the SMB0 interrupt. 0: Disable all SMB0 interrupts. 1: Enable interrupt requests generated by SMB0. Rev.1.0 C8051F336/7/8/9 SFR Definition 15.4. EIP1: Extended Interrupt Priority 1 Bit 7 6 5 4 3 2 1 0 Name PT3 Reserved PCP0 PPCA0 PADC0 PWADC0 PMAT PSMB0 Type R/W R/W R/W R/W R/W R/W R/W R/W Reset 0 0 0 0 0 0 0 0 SFR Address = 0xF6 Bit Name 7 6 5 PT3 Function Timer 3 Interrupt Priority Control. This bit sets the priority of the Timer 3 interrupt. 0: Timer 3 interrupts set to low priority level. 1: Timer 3 interrupts set to high priority level. Reserved Reserved. Must Write 0. PCP0 Comparator0 (CP0) Interrupt Priority Control. This bit sets the priority of the CP0 interrupt. 0: CP0 interrupt set to low priority level. 1: CP0 interrupt set to high priority level. 4 PPCA0 Programmable Counter Array (PCA0) Interrupt Priority Control. This bit sets the priority of the PCA0 interrupt. 0: PCA0 interrupt set to low priority level. 1: PCA0 interrupt set to high priority level. 3 PADC0 ADC0 Conversion Complete Interrupt Priority Control. This bit sets the priority of the ADC0 Conversion Complete interrupt. 0: ADC0 Conversion Complete interrupt set to low priority level. 1: ADC0 Conversion Complete interrupt set to high priority level. 2 PWADC0 ADC0 Window Comparator Interrupt Priority Control. This bit sets the priority of the ADC0 Window interrupt. 0: ADC0 Window interrupt set to low priority level. 1: ADC0 Window interrupt set to high priority level. 1 PMAT 0 PSMB0 Port Match Interrupt Priority Control. This bit sets the priority of the Port Match Event interrupt. 0: Port Match interrupt set to low priority level. 1: Port Match interrupt set to high priority level. SMBus (SMB0) Interrupt Priority Control. This bit sets the priority of the SMB0 interrupt. 0: SMB0 interrupt set to low priority level. 1: SMB0 interrupt set to high priority level. Rev.1.0 88 C8051F336/7/8/9 15.3. External Interrupts /INT0 and /INT1 The /INT0 and /INT1 external interrupt sources are configurable as active high or low, edge or level sensitive. The IN0PL (/INT0 Polarity) and IN1PL (/INT1 Polarity) bits in the IT01CF register select active high or active low; the IT0 and IT1 bits in TCON (Section “24.1. Timer 0 and Timer 1” on page 182) select level or edge sensitive. The table below lists the possible configurations. IT0 IN0PL /INT0 Interrupt IT1 IN1PL /INT1 Interrupt 1 1 0 0 0 1 0 1 Active low, edge sensitive Active high, edge sensitive Active low, level sensitive Active high, level sensitive 1 1 0 0 0 1 0 1 Active low, edge sensitive Active high, edge sensitive Active low, level sensitive Active high, level sensitive /INT0 and /INT1 are assigned to Port pins as defined in the IT01CF register (see SFR Definition 15.5). Note that /INT0 and /INT0 Port pin assignments are independent of any Crossbar assignments. /INT0 and /INT1 will monitor their assigned Port pins without disturbing the peripheral that was assigned the Port pin via the Crossbar. To assign a Port pin only to /INT0 and/or /INT1, configure the Crossbar to skip the selected pin(s). This is accomplished by setting the associated bit in register XBR0 (see Section “20.3. Priority Crossbar Decoder” on page 124 for complete details on configuring the Crossbar). IE0 (TCON.1) and IE1 (TCON.3) serve as the interrupt-pending flags for the /INT0 and /INT1 external interrupts, respectively. If an /INT0 or /INT1 external interrupt is configured as edge-sensitive, the corresponding interrupt-pending flag is automatically cleared by the hardware when the CPU vectors to the ISR. When configured as level sensitive, the interrupt-pending flag remains logic 1 while the input is active as defined by the corresponding polarity bit (IN0PL or IN1PL); the flag remains logic 0 while the input is inactive. The external interrupt source must hold the input active until the interrupt request is recognized. It must then deactivate the interrupt request before execution of the ISR completes or another interrupt request will be generated. 89 Rev.1.0 C8051F336/7/8/9 SFR Definition 15.5. IT01CF: INT0/INT1 Configuration Bit 7 6 Name IN1PL IN1SL[2:0] IN0PL IN0SL[2:0] Type R/W R/W R/W R/W Reset 0 0 5 0 SFR Address = 0xE4 Bit Name 7 6:4 3 2:0 IN1PL 4 3 0 0 2 0 1 0 0 1 Function /INT1 Polarity. 0: /INT1 input is active low. 1: /INT1 input is active high. IN1SL[2:0] /INT1 Port Pin Selection Bits. These bits select which Port pin is assigned to /INT1. Note that this pin assignment is independent of the Crossbar; /INT1 will monitor the assigned Port pin without disturbing the peripheral that has been assigned the Port pin via the Crossbar. The Crossbar will not assign the Port pin to a peripheral if it is configured to skip the selected pin. 000: Select P0.0 001: Select P0.1 010: Select P0.2 011: Select P0.3 100: Select P0.4 101: Select P0.5 110: Select P0.6 111: Select P0.7 IN0PL /INT0 Polarity. 0: /INT0 input is active low. 1: /INT0 input is active high. IN0SL[2:0] /INT0 Port Pin Selection Bits. These bits select which Port pin is assigned to /INT0. Note that this pin assignment is independent of the Crossbar; /INT0 will monitor the assigned Port pin without disturbing the peripheral that has been assigned the Port pin via the Crossbar. The Crossbar will not assign the Port pin to a peripheral if it is configured to skip the selected pin. 000: Select P0.0 001: Select P0.1 010: Select P0.2 011: Select P0.3 100: Select P0.4 101: Select P0.5 110: Select P0.6 111: Select P0.7 Rev.1.0 90 C8051F336/7/8/9 16. Flash Memory On-chip, re-programmable Flash memory is included for program code and non-volatile data storage. The Flash memory can be programmed in-system, a single byte at a time, through the C2 interface or by software using the MOVX instruction. Once cleared to logic 0, a Flash bit must be erased to set it back to logic 1. Flash bytes would typically be erased (set to 0xFF) before being reprogrammed. The write and erase operations are automatically timed by hardware for proper execution; data polling to determine the end of the write/erase operation is not required. Code execution is stalled during a Flash write/erase operation. Refer to Section “6. Electrical Characteristics” on page 27 for complete Flash memory electrical characteristics. 16.1. Programming The Flash Memory The simplest means of programming the Flash memory is through the C2 interface using programming tools provided by Silicon Labs or a third party vendor. This is the only means for programming a non-initialized device. For details on the C2 commands to program Flash memory, see Section “26. C2 Interface” on page 221. To ensure the integrity of Flash contents, it is strongly recommended that the on-chip VDD Monitor be enabled in any system that includes code that writes and/or erases Flash memory from software. See Section 16.4 for more details. 16.1.1. Flash Lock and Key Functions Flash writes and erases by user software are protected with a lock and key function. The Flash Lock and Key Register (FLKEY) must be written with the correct key codes, in sequence, before Flash operations may be performed. The key codes are: 0xA5, 0xF1. The timing does not matter, but the codes must be written in order. If the key codes are written out of order, or the wrong codes are written, Flash writes and erases will be disabled until the next system reset. Flash writes and erases will also be disabled if a Flash write or erase is attempted before the key codes have been written properly. The Flash lock resets after each write or erase; the key codes must be written again before a following Flash operation can be performed. The FLKEY register is detailed in SFR Definition 16.2. 16.1.2. Flash Erase Procedure The Flash memory can be programmed by software using the MOVX write instruction with the address and data byte to be programmed provided as normal operands. Before writing to Flash memory using MOVX, Flash write operations must be enabled by: (1) setting the PSWE Program Store Write Enable bit (PSCTL.0) to logic 1 (this directs the MOVX writes to target Flash memory); and (2) Writing the Flash key codes in sequence to the Flash Lock register (FLKEY). The PSWE bit remains set until cleared by software. A write to Flash memory can clear bits to logic 0 but cannot set them; only an erase operation can set bits to logic 1 in Flash. A byte location to be programmed should be erased before a new value is written. The Flash memory is organized in 512-byte pages. The erase operation applies to an entire page (setting all bytes in the page to 0xFF). To erase an entire 512-byte page, perform the following steps: 1. Disable interrupts (recommended). 2. Set thePSEE bit (register PSCTL). 3. Set the PSWE bit (register PSCTL). 4. Write the first key code to FLKEY: 0xA5. 5. Write the second key code to FLKEY: 0xF1. 6. Using the MOVX instruction, write a data byte to any location within the 512-byte page to be erased. 7. Clear the PSWE and PSEE bits. Rev.1.0 91 C8051F336/7/8/9 16.1.3. Flash Write Procedure Flash bytes are programmed by software with the following sequence: 1. Disable interrupts (recommended). 2. Erase the 512-byte Flash page containing the target location, as described in Section 16.1.2. 3. Set the PSWE bit (register PSCTL). 4. Clear the PSEE bit (register PSCTL). 5. Write the first key code to FLKEY: 0xA5. 6. Write the second key code to FLKEY: 0xF1. 7. Using the MOVX instruction, write a single data byte to the desired location within the 512-byte sector. 8. Clear the PSWE bit. Steps 5–7 must be repeated for each byte to be written. After Flash writes are complete, PSWE should be cleared so that MOVX instructions do not target program memory. 16.2. Non-volatile Data Storage The Flash memory can be used for non-volatile data storage as well as program code. This allows data such as calibration coefficients to be calculated and stored at run time. Data is written using the MOVX write instruction and read using the MOVC instruction. Note: MOVX read instructions always target XRAM. 92 Rev.1.0 C8051F336/7/8/9 16.3. Security Options The CIP-51 provides security options to protect the Flash memory from inadvertent modification by software as well as to prevent the viewing of proprietary program code and constants. The Program Store Write Enable (bit PSWE in register PSCTL) and the Program Store Erase Enable (bit PSEE in register PSCTL) bits protect the Flash memory from accidental modification by software. PSWE must be explicitly set to ‘1’ before software can modify the Flash memory; both PSWE and PSEE must be set to ‘1’ before software can erase Flash memory. Additional security features prevent proprietary program code and data constants from being read or altered across the C2 interface. A Security Lock Byte located in Flash user space offers protection of the Flash program memory from access (reads, writes, or erases) by unprotected code or the C2 interface. See Section “13. Memory Organization” on page 74 for the location of the security byte. The Flash security mechanism allows the user to lock n 512-byte Flash pages, starting at page 0 (addresses 0x0000 to 0x01FF), where n is the 1’s complement number represented by the Security Lock Byte. Note that the page containing the Flash Security Lock Byte is unlocked when no other Flash pages are locked (all bits of the Lock Byte are ‘1’) and locked when any other Flash pages are locked (any bit of the Lock Byte is ‘0’). An example is shown in Figure 16.1. Security Lock Byte: 1s Complement: Flash pages locked: 11111101b 00000010b 3 (First two Flash pages + Lock Byte Page) Figure 16.1. Security Byte Decoding Rev.1.0 93 C8051F336/7/8/9 The level of Flash security depends on the Flash access method. The three Flash access methods that can be restricted are reads, writes, and erases from the C2 debug interface, user firmware executing on unlocked pages, and user firmware executing on locked pages. Table 16.1 summarizes the Flash security features of the C8051F336/7/8/9 devices. Table 16.1. Flash Security Summary Action C2 Debug Interface User Firmware executing from: an unlocked page a locked page Permitted Permitted Permitted Not Permitted Flash Error Reset Permitted Read or Write page containing Lock Byte (if no pages are locked) Permitted Permitted Permitted Read or Write page containing Lock Byte (if any page is locked) Not Permitted Flash Error Reset Permitted Read contents of Lock Byte (if no pages are locked) Permitted Permitted Permitted Read contents of Lock Byte (if any page is locked) Not Permitted Flash Error Reset Permitted Read, Write or Erase unlocked pages (except page with Lock Byte) Read, Write or Erase locked pages (except page with Lock Byte) Erase page containing Lock Byte (if no pages are locked) Permitted Flash Error Reset Flash Error Reset C2 Device Erase Only Flash Error Reset Flash Error Reset Lock additional pages (change '1's to '0's in the Lock Byte) Not Permitted Flash Error Reset Flash Error Reset Unlock individual pages (change '0's to '1's in the Lock Byte) Not Permitted Flash Error Reset Flash Error Reset Read, Write or Erase Reserved Area Not Permitted Flash Error Reset Flash Error Reset Erase page containing Lock Byte—Unlock all pages (if any page is locked) C2 Device Erase - Erases all Flash pages including the page containing the Lock Byte. Flash Error Reset - Not permitted; Causes Flash Error Device Reset (FERROR bit in RSTSRC is '1' after reset). - All prohibited operations that are performed via the C2 interface are ignored (do not cause device reset). - Locking any Flash page also locks the page containing the Lock Byte. - Once written to, the Lock Byte cannot be modified except by performing a C2 Device Erase. - If user code writes to the Lock Byte, the Lock does not take effect until the next device reset. 94 Rev.1.0 C8051F336/7/8/9 16.4. Flash Write and Erase Guidelines Any system which contains routines which write or erase Flash memory from software involves some risk that the write or erase routines will execute unintentionally if the CPU is operating outside its specified operating range of VDD, system clock frequency, or temperature. This accidental execution of Flash modifying code can result in alteration of Flash memory contents causing a system failure that is only recoverable by re-Flashing the code in the device. The following guidelines are recommended for any system which contains routines which write or erase Flash from code. 16.4.1. VDD Maintenance and the VDD monitor 1. If the system power supply is subject to voltage or current "spikes," add sufficient transient protection devices to the power supply to ensure that the supply voltages listed in the Absolute Maximum Ratings table are not exceeded. 2. Make certain that the minimum VDD rise time specification of 1 ms is met. If the system cannot meet this rise time specification, then add an external VDD brownout circuit to the RST pin of the device that holds the device in reset until VDD reaches 2.7 V and re-asserts RST if VDD drops below 2.7 V. 3. Enable the on-chip VDD monitor and enable the VDD monitor as a reset source as early in code as possible. This should be the first set of instructions executed after the Reset Vector. For 'C'-based systems, this will involve modifying the startup code added by the 'C' compiler. See your compiler documentation for more details. Make certain that there are no delays in software between enabling the VDD monitor and enabling the VDD monitor as a reset source. Code examples showing this can be found in “AN201: Writing to Flash from Firmware", available from the Silicon Laboratories web site. 4. As an added precaution, explicitly enable the VDD monitor and enable the VDD monitor as a reset source inside the functions that write and erase Flash memory. The VDD monitor enable instructions should be placed just after the instruction to set PSWE to a '1', but before the Flash write or erase operation instruction. 5. Make certain that all writes to the RSTSRC (Reset Sources) register use direct assignment operators and explicitly DO NOT use the bit-wise operators (such as AND or OR). For example, "RSTSRC = 0x02" is correct. "RSTSRC |= 0x02" is incorrect. 6. Make certain that all writes to the RSTSRC register explicitly set the PORSF bit to a '1'. Areas to check are initialization code which enables other reset sources, such as the Missing Clock Detector or Comparator, for example, and instructions which force a Software Reset. A global search on "RSTSRC" can quickly verify this. 16.4.2. PSWE Maintenance 7. Reduce the number of places in code where the PSWE bit (b0 in PSCTL) is set to a '1'. There should be exactly one routine in code that sets PSWE to a '1' to write Flash bytes and one routine in code that sets PSWE and PSEE both to a '1' to erase Flash pages. 8. Minimize the number of variable accesses while PSWE is set to a '1'. Handle pointer address updates and loop variable maintenance outside the "PSWE = 1;... PSWE = 0;" area. Code examples showing this can be found in AN201, "Writing to Flash from Firmware", available from the Silicon Laboratories web site. 9. Disable interrupts prior to setting PSWE to a '1' and leave them disabled until after PSWE has been reset to '0'. Any interrupts posted during the Flash write or erase operation will be serviced in priority order after the Flash operation has been completed and interrupts have been re-enabled by software. 10.Make certain that the Flash write and erase pointer variables are not located in XRAM. See your compiler documentation for instructions regarding how to explicitly locate variables in different memory Rev.1.0 95 C8051F336/7/8/9 areas. 11. Add address bounds checking to the routines that write or erase Flash memory to ensure that a routine called with an illegal address does not result in modification of the Flash. 16.4.3. System Clock 12.If operating from an external crystal, be advised that crystal performance is susceptible to electrical interference and is sensitive to layout and to changes in temperature. If the system is operating in an electrically noisy environment, use the internal oscillator or use an external CMOS clock. 13.If operating from the external oscillator, switch to the internal oscillator during Flash write or erase operations. The external oscillator can continue to run, and the CPU can switch back to the external oscillator after the Flash operation has completed. Additional Flash recommendations and example code can be found in AN201, "Writing to Flash from Firmware", available from the Silicon Laboratories web site. 96 Rev.1.0 C8051F336/7/8/9 SFR Definition 16.1. PSCTL: Program Store R/W Control Bit 7 6 5 4 3 2 Name 1 0 PSEE PSWE Type R R R R R R R/W R/W Reset 0 0 0 0 0 0 0 0 SFR Address = 0x8F Bit Name 7:2 1 Function UNUSED Unused. Read = 000000b, Write = don’t care. PSEE Program Store Erase Enable Setting this bit (in combination with PSWE) allows an entire page of Flash program memory to be erased. If this bit is logic 1 and Flash writes are enabled (PSWE is logic 1), a write to Flash memory using the MOVX instruction will erase the entire page that contains the location addressed by the MOVX instruction. The value of the data byte written does not matter. 0: Flash program memory erasure disabled. 1: Flash program memory erasure enabled. 0 PSWE Program Store Write Enable Setting this bit allows writing a byte of data to the Flash program memory using the MOVX write instruction. The Flash location should be erased before writing data. 0: Writes to Flash program memory disabled. 1: Writes to Flash program memory enabled; the MOVX write instruction targets Flash memory. Rev.1.0 97 C8051F336/7/8/9 SFR Definition 16.2. FLKEY: Flash Lock and Key Bit 7 6 5 4 3 Name FLKEY[7:0] Type R/W Reset 0 0 0 0 SFR Address = 0xB7 Bit Name 7:0 0 2 1 0 0 0 0 Function FLKEY[7:0] Flash Lock and Key Register. Write: This register provides a lock and key function for Flash erasures and writes. Flash writes and erases are enabled by writing 0xA5 followed by 0xF1 to the FLKEY register. Flash writes and erases are automatically disabled after the next write or erase is complete. If any writes to FLKEY are performed incorrectly, or if a Flash write or erase operation is attempted while these operations are disabled, the Flash will be permanently locked from writes or erasures until the next device reset. If an application never writes to Flash, it can intentionally lock the Flash by writing a non-0xA5 value to FLKEY from software. Read: When read, bits 1–0 indicate the current Flash lock state. 00: Flash is write/erase locked. 01: The first key code has been written (0xA5). 10: Flash is unlocked (writes/erases allowed). 11: Flash writes/erases disabled until the next reset. 98 Rev.1.0 C8051F336/7/8/9 SFR Definition 16.3. FLSCL: Flash Scale Bit 7 6 5 4 3 2 1 0 Name FOSE Reserved Reserved Reserved Reserved Reserved Reserved Reserved Type R/W R/W R/W R/W R/W R/W R/W R/W Reset 1 0 0 0 0 0 0 0 SFR Address = 0xB6 Bit Name 7 FOSE Function Flash One-shot Enable This bit enables the Flash read one-shot (recommended). If the Flash one-shot is disabled, the Flash sense amps are enabled for a full clock cycle during Flash reads, increasing the device power consumption. 0: Flash one-shot disabled. 1: Flash one-shot enabled. 6:0 Reserved Reserved. Must Write 0000000b. Rev.1.0 99 C8051F336/7/8/9 17. Reset Sources Reset circuitry allows the controller to be easily placed in a predefined default condition. Upon entering this reset state, the following events occur:  CIP-51 halts program execution Special Function Registers (SFRs) are initialized to their defined reset values  External Port pins are forced to a known state  Interrupts and timers are disabled. All SFRs are reset to the predefined values noted in the SFR detailed descriptions. The contents of internal data memory are unaffected during a reset; any previously stored data is preserved. However, since the stack pointer SFR is reset, the stack is effectively lost, even though the data on the stack is not altered.  The Port I/O latches are reset to 0xFF (all logic ones) in open-drain mode. Weak pullups are enabled during and after the reset. For VDD Monitor and power-on resets, the RST pin is driven low until the device exits the reset state. On exit from the reset state, the program counter (PC) is reset, and the system clock defaults to the internal oscillator. The Watchdog Timer is enabled with the system clock divided by 12 as its clock source. Program execution begins at location 0x0000. VDD Power On Reset Supply Monitor '0' Enable (wired-OR) /RST + C0RSEF Missing Clock Detector (oneshot) EN Reset Funnel PCA WDT (Software Reset) SWRSF Errant FLASH Operation EN System Clock WDT Enable Px.x + - Comparator 0 MCD Enable Px.x CIP-51 Microcontroller Core System Reset Extended Interrupt Handler Figure 17.1. Reset Sources Rev.1.0 100 C8051F336/7/8/9 17.1. Power-On Reset During power-up, the device is held in a reset state and the RST pin is driven low until VDD settles above VRST. A delay occurs before the device is released from reset; the delay decreases as the VDD ramp time increases (VDD ramp time is defined as how fast VDD ramps from 0 V to VRST). Figure 17.2. plots the power-on and VDD monitor reset timing. The maximum VDD ramp time is 1 ms; slower ramp times may cause the device to be released from reset before VDD reaches the VRST level. For ramp times less than 1 ms, the power-on reset delay (TPORDelay) is typically less than 0.3 ms. volts On exit from a power-on reset, the PORSF flag (RSTSRC.1) is set by hardware to logic 1. When PORSF is set, all of the other reset flags in the RSTSRC Register are indeterminate (PORSF is cleared by all other resets). Since all resets cause program execution to begin at the same location (0x0000) software can read the PORSF flag to determine if a power-up was the cause of reset. The content of internal data memory should be assumed to be undefined after a power-on reset. The VDD monitor is enabled following a power-on reset. VDD 2.70 2.55 VRST VD D 2.0 1.0 t Logic HIGH /RST TPORDelay Logic LOW VDD Monitor Reset Power-On Reset Figure 17.2. Power-On and VDD Monitor Reset Timing 101 Rev.1.0 C8051F336/7/8/9 17.2. Power-Fail Reset / VDD Monitor When a power-down transition or power irregularity causes VDD to drop below VRST, the power supply monitor will drive the RST pin low and hold the CIP-51 in a reset state (see Figure 17.2). When VDD returns to a level above VRST, the CIP-51 will be released from the reset state. Note that even though internal data memory contents are not altered by the power-fail reset, it is impossible to determine if VDD dropped below the level required for data retention. If the PORSF flag reads ‘1’, the data may no longer be valid. The VDD monitor is enabled after power-on resets. Its defined state (enabled/disabled) is not altered by any other reset source. For example, if the VDD monitor is disabled by code and a software reset is performed, the VDD monitor will still be disabled after the reset. Important Note: If the VDD monitor is being turned on from a disabled state, it should be enabled before it is selected as a reset source. Selecting the VDD monitor as a reset source before it is enabled and stabilized may cause a system reset. In some applications, this reset may be undesirable. If this is not desirable in the application, a delay should be introduced between enabling the monitor and selecting it as a reset source. The procedure for enabling the VDD monitor and configuring it as a reset source from a disabled state is shown below: 1. Enable the VDD monitor (VDMEN bit in VDM0CN = ‘1’). 2. If necessary, wait for the VDD monitor to stabilize. 3. Select the VDD monitor as a reset source (PORSF bit in RSTSRC = ‘1’). See Figure 17.2 for VDD monitor timing; note that the power-on-reset delay is not incurred after a VDD monitor reset. See Section “6. Electrical Characteristics” on page 27 for complete electrical characteristics of the VDD monitor. Rev.1.0 102 C8051F336/7/8/9 SFR Definition 17.1. VDM0CN: VDD Monitor Control Bit 7 6 5 4 3 2 1 0 Name VDMEN VDDSTAT Type R/W R R R R R R R Reset Varies Varies 0 0 0 0 0 0 SFR Address = 0xFF Bit Name 7 VDMEN Function VDD Monitor Enable. This bit turns the VDD monitor circuit on/off. The VDD Monitor cannot generate system resets until it is also selected as a reset source in register RSTSRC (SFR Definition 17.2). Selecting the VDD monitor as a reset source before it has stabilized may generate a system reset. In systems where this reset would be undesirable, a delay should be introduced between enabling the VDD Monitor and selecting it as a reset source. 0: VDD Monitor Disabled. 1: VDD Monitor Enabled. 6 VDDSTAT VDD Status. This bit indicates the current power supply status (VDD Monitor output). 0: VDD is at or below the VDD monitor threshold. 1: VDD is above the VDD monitor threshold. 5:0 UNUSED Unused. Read = 000000b; Write = Don’t care. 17.3. External Reset The external RST pin provides a means for external circuitry to force the device into a reset state. Asserting an active-low signal on the RST pin generates a reset; an external pullup and/or decoupling of the RST pin may be necessary to avoid erroneous noise-induced resets. See Section “6. Electrical Characteristics” on page 27 for complete RST pin specifications. The PINRSF flag (RSTSRC.0) is set on exit from an external reset. 17.4. Missing Clock Detector Reset The Missing Clock Detector (MCD) is a one-shot circuit that is triggered by the system clock. If the system clock remains high or low for more than 100 µs, the one-shot will time out and generate a reset. After a MCD reset, the MCDRSF flag (RSTSRC.2) will read ‘1’, signifying the MCD as the reset source; otherwise, this bit reads ‘0’. Writing a ‘1’ to the MCDRSF bit enables the Missing Clock Detector; writing a ‘0’ disables it. The state of the RST pin is unaffected by this reset. 103 Rev.1.0 C8051F336/7/8/9 17.5. Comparator0 Reset Comparator0 can be configured as a reset source by writing a ‘1’ to the C0RSEF flag (RSTSRC.5). Comparator0 should be enabled and allowed to settle prior to writing to C0RSEF to prevent any turn-on chatter on the output from generating an unwanted reset. The Comparator0 reset is active-low: if the non-inverting input voltage (on CP0+) is less than the inverting input voltage (on CP0-), the device is put into the reset state. After a Comparator0 reset, the C0RSEF flag (RSTSRC.5) will read ‘1’ signifying Comparator0 as the reset source; otherwise, this bit reads ‘0’. The state of the RST pin is unaffected by this reset. 17.6. PCA Watchdog Timer Reset The programmable Watchdog Timer (WDT) function of the Programmable Counter Array (PCA) can be used to prevent software from running out of control during a system malfunction. The PCA WDT function can be enabled or disabled by software as described in Section “25.4. Watchdog Timer Mode” on page 213; the WDT is enabled and clocked by SYSCLK / 12 following any reset. If a system malfunction prevents user software from updating the WDT, a reset is generated and the WDTRSF bit (RSTSRC.5) is set to ‘1’. The state of the RST pin is unaffected by this reset. 17.7. Flash Error Reset If a Flash read/write/erase or program read targets an illegal address, a system reset is generated. This may occur due to any of the following:  A Flash write or erase is attempted above user code space. This occurs when PSWE is set to ‘1’ and a MOVX write operation targets an address above address 0x3DFF.  A Flash read is attempted above user code space. This occurs when a MOVC operation targets an address above address 0x3DFF.  A Program read is attempted above user code space. This occurs when user code attempts to branch to an address above 0x3DFF.  A Flash read, write or erase attempt is restricted due to a Flash security setting (see Section “16.3. Security Options” on page 93). The FERROR bit (RSTSRC.6) is set following a Flash error reset. The state of the RST pin is unaffected by this reset. 17.8. Software Reset Software may force a reset by writing a ‘1’ to the SWRSF bit (RSTSRC.4). The SWRSF bit will read ‘1’ following a software forced reset. The state of the RST pin is unaffected by this reset. Rev.1.0 104 C8051F336/7/8/9 SFR Definition 17.2. RSTSRC: Reset Source Bit 7 Name 6 5 4 3 2 1 0 FERROR C0RSEF SWRSF WDTRSF MCDRSF PORSF PINRSF Type R R R/W R/W R R/W R/W R Reset 0 Varies Varies Varies Varies Varies Varies Varies SFR Address = 0xEF Bit Name Description Write 7 UNUSED Unused. Don’t care. 6 FERROR Flash Error Reset Flag. N/A 5 4 3 2 1 0 0 Set to ‘1’ if Flash read/write/erase error caused the last reset. C0RSEF Comparator0 Reset Enable Writing a ‘1’ enables Com- Set to ‘1’ if Comparator0 parator0 as a reset source caused the last reset. and Flag. (active-low). SWRSF Software Reset Force and Writing a ‘1’ forces a sys- Set to ‘1’ if last reset was tem reset. caused by a write to Flag. SWRSF. WDTRSF Watchdog Timer Reset Flag. N/A Set to ‘1’ if Watchdog Timer overflow caused the last reset. MCDRSF Missing Clock Detector Writing a ‘1’ enables the Set to ‘1’ if Missing Clock Missing Clock Detector. Detector timeout caused Enable and Flag. The MCD triggers a reset the last reset. if a missing clock condition is detected. Writing a ‘1’ enables the Set to ‘1’ anytime a powerPORSF Power-On / VDD Monitor monitor as a reset V on or VDD monitor reset Reset Flag, and VDD monitor DD source. occurs. Reset Enable. Writing ‘1’ to this bit When set to ‘1’ all other before the VDD monitor RSTSRC flags are indeis enabled and stabilized terminate. may cause a system reset. PINRSF HW Pin Reset Flag. N/A Set to ‘1’ if RST pin caused the last reset. Note: Do not use read-modify-write operations on this register 105 Read Rev.1.0 C8051F336/7/8/9 18. Power Management Modes The C8051F336/7/8/9 devices have three software programmable power management modes: Idle, Stop, and Suspend. Idle mode and Stop mode are part of the standard 8051 architecture, while Suspend mode is an enhanced power-saving mode implemented by the high-speed oscillator peripheral. Idle mode halts the CPU while leaving the peripherals and clocks active. In Stop mode, the CPU is halted, all interrupts and timers (except the Missing Clock Detector) are inactive, and the internal oscillator is stopped (analog peripherals remain in their selected states; the external oscillator is not affected). Suspend mode is similar to Stop mode in that the internal oscillator and CPU are halted, but the device can wake on events such as a Port Mismatch, Comparator low output, or a Timer 3 overflow. Since clocks are running in Idle mode, power consumption is dependent upon the system clock frequency and the number of peripherals left in active mode before entering Idle. Stop mode and Suspend mode consume the least power because the majority of the device is shut down with no clocks active. SFR Definition 18.1 describes the Power Control Register (PCON) used to control the C8051F336/7/8/9's Stop and Idle power management modes. Suspend mode is controlled by the SUSPEND bit in the OSCICN register (SFR Definition 19.3). Although the C8051F336/7/8/9 has Idle, Stop, and Suspend modes available, more control over the device power can be achieved by enabling/disabling individual peripherals as needed. Each analog peripheral can be disabled when not in use and placed in low power mode. Digital peripherals, such as timers or serial buses, draw little power when they are not in use. Turning off oscillators lowers power consumption considerably, at the expense of reduced functionality. 18.1. Idle Mode Setting the Idle Mode Select bit (PCON.0) causes the hardware to halt the CPU and enter Idle mode as soon as the instruction that sets the bit completes execution. All internal registers and memory maintain their original data. All analog and digital peripherals can remain active during Idle mode. Idle mode is terminated when an enabled interrupt is asserted or a reset occurs. The assertion of an enabled interrupt will cause the Idle Mode Selection bit (PCON.0) to be cleared and the CPU to resume operation. The pending interrupt will be serviced and the next instruction to be executed after the return from interrupt (RETI) will be the instruction immediately following the one that set the Idle Mode Select bit. If Idle mode is terminated by an internal or external reset, the CIP-51 performs a normal reset sequence and begins program execution at address 0x0000. Note: If the instruction following the write of the IDLE bit is a single-byte instruction and an interrupt occurs during the execution phase of the instruction that sets the IDLE bit, the CPU may not wake from Idle mode when a future interrupt occurs. Therefore, instructions that set the IDLE bit should be followed by an instruction that has two or more opcode bytes, for example: // in ‘C’: PCON |= 0x01; PCON = PCON; // set IDLE bit // ... followed by a 3-cycle dummy instruction ; in assembly: ORL PCON, #01h MOV PCON, PCON ; set IDLE bit ; ... followed by a 3-cycle dummy instruction If enabled, the Watchdog Timer (WDT) will eventually cause an internal watchdog reset and thereby terminate the Idle mode. This feature protects the system from an unintended permanent shutdown in the event of an inadvertent write to the PCON register. If this behavior is not desired, the WDT may be disabled by Rev.1.0 106 C8051F336/7/8/9 software prior to entering the Idle mode if the WDT was initially configured to allow this operation. This provides the opportunity for additional power savings, allowing the system to remain in the Idle mode indefinitely, waiting for an external stimulus to wake up the system. Refer to Section “17.6. PCA Watchdog Timer Reset” on page 104 for more information on the use and configuration of the WDT. 18.2. Stop Mode Setting the Stop Mode Select bit (PCON.1) causes the controller core to enter Stop mode as soon as the instruction that sets the bit completes execution. In Stop mode the internal oscillator, CPU, and all digital peripherals are stopped; the state of the external oscillator circuit is not affected. Each analog peripheral (including the external oscillator circuit) may be shut down individually prior to entering Stop Mode. Stop mode can only be terminated by an internal or external reset. On reset, the device performs the normal reset sequence and begins program execution at address 0x0000. If enabled, the Missing Clock Detector will cause an internal reset and thereby terminate the Stop mode. The Missing Clock Detector should be disabled if the CPU is to be put to in STOP mode for longer than the MCD timeout of 100 µs. 18.3. Suspend Mode Setting the SUSPEND bit (OSCICN.5) causes the hardware to halt the CPU and the high-frequency internal oscillator, and go into Suspend mode as soon as the instruction that sets the bit completes execution. All internal registers and memory maintain their original data. Most digital peripherals are not active in Suspend mode. The exception to this is the Port Match feature and Timer 3, when it is run from an external oscillator source or the internal low-frequency oscillator. Suspend mode can be terminated by four types of events, a port match (described in Section “20.5. Port Match” on page 129), a Timer 3 overflow (described in Section “24.3. Timer 3” on page 196), a Comparator low output (if enabled), or a device reset event. Note that in order to run Timer 3 in Suspend mode, the timer must be configured to clock from either the external clock source or the internal low-frequency oscillator source. When Suspend mode is terminated, the device will continue execution on the instruction following the one that set the SUSPEND bit. If the wake event (port match or Timer 3 overflow) was configured to generate an interrupt, the interrupt will be serviced upon waking the device. If Suspend mode is terminated by an internal or external reset, the CIP-51 performs a normal reset sequence and begins program execution at address 0x0000. 107 Rev.1.0 C8051F336/7/8/9 SFR Definition 18.1. PCON: Power Control Bit 7 6 5 4 3 2 1 0 Name GF[5:0] STOP IDLE Type R/W R/W R/W 0 0 Reset 0 0 0 SFR Address = 0x87 Bit Name 7:2 GF[5:0] 0 0 0 Function General Purpose Flags 5–0. These are general purpose flags for use under software control. 1 STOP Stop Mode Select. Setting this bit will place the CIP-51 in Stop mode. This bit will always be read as 0. 1: CPU goes into Stop mode (internal oscillator stopped). 0 IDLE IDLE: Idle Mode Select. Setting this bit will place the CIP-51 in Idle mode. This bit will always be read as 0. 1: CPU goes into Idle mode. (Shuts off clock to CPU, but clock to Timers, Interrupts, Serial Ports, and Analog Peripherals are still active.) Rev.1.0 108 C8051F336/7/8/9 19. Oscillators and Clock Selection C8051F336/7/8/9 devices include a programmable internal high-frequency oscillator, a programmable internal low-frequency oscillator, and an external oscillator drive circuit. The internal high-frequency oscillator can be enabled/disabled and calibrated using the OSCICN and OSCICL registers, as shown in Figure 19.1. The internal low-frequency oscillator can be enabled/disabled and calibrated using the OSCLCN register. The system clock can be sourced by the external oscillator circuit or either internal oscillator. Both internal oscillators offer a selectable post-scaling feature. OSCLEN OSCLRDY OSCLF3 OSCLF2 OSCLF1 OSCLF0 OSCLD1 OSCLD0 OSCLCN IFCN1 IFCN0 OSCICN IOSCEN IFRDY OSCICL Option 3 XTAL2 OSCLF OSCLD Programmable Internal Clock Generator Option 4 XTAL2 EN n OSCLF EN Option 2 VDD Low Frequency Oscillator Option 1 OSCLD XTAL1 XTAL2 Input Circuit 10MΩ SYSCLK n OSC OSCXCN SEL1 SEL0 XFCN2 XFCN1 XFCN0 XTLVLD XOSCMD2 XOSCMD1 XOSCMD0 XTAL2 CLKSEL Figure 19.1. Oscillator Options 19.1. System Clock Selection The CLKSL[1:0] bits in register CLKSEL select which oscillator source is used as the system clock. CLKSL[1:0] must be set to 01b for the system clock to run from the external oscillator; however the external oscillator may still clock certain peripherals (timers, PCA) when the internal oscillator is selected as the system clock. The system clock may be switched on-the-fly between the internal oscillator, external oscillator, and Clock Multiplier so long as the selected clock source is enabled and has settled. The internal high-frequency and low-frequency oscillators require little start-up time and may be selected as the system clock immediately following the register write which enables the oscillator. The external RC and C modes also typically require no startup time. External crystals and ceramic resonators however, typically require a start-up time before they are settled and ready for use. The Crystal Valid Flag (XTLVLD in register OSCXCN) is set to '1' by hardware when the external crystal or ceramic resonator is settled. In crystal mode, to avoid reading a false XTLVLD, software should delay at least 1 ms between enabling the external oscillator and checking XTLVLD. Rev.1.0 109 C8051F336/7/8/9 SFR Definition 19.1. CLKSEL: Clock Select Bit 7 6 5 4 3 2 0 CLKSL[1:0] Name Type R R R R R R Reset 0 0 0 0 0 0 SFR Address = 0xA9 Bit Name 7:2 1:0 1 R/W 0 0 Function UNUSED Unused. Read = 000000b; Write = Don’t Care CLKSL[1:0] System Clock Source Select Bits. 00: SYSCLK derived from the Internal High-Frequency Oscillator and scaled per the IFCN bits in register OSCICN. 01: SYSCLK derived from the External Oscillator circuit. 10: SYSCLK derived from the Internal Low-Frequency Oscillator and scaled per the OSCLD bits in register OSCLCN. 11: reserved. 110 Rev.1.0 C8051F336/7/8/9 19.2. Programmable Internal High-Frequency (H-F) Oscillator All C8051F336/7/8/9 devices include a programmable internal high-frequency oscillator that defaults as the system clock after a system reset. The internal oscillator period caPara1n be adjusted via the OSCICL register as defined by SFR Definition 19.2. On C8051F336/7/8/9 devices, OSCICL is factory calibrated to obtain a 24.5 MHz base frequency. The system clock may be derived from the programmed internal oscillator divided by 1, 2, 4, or 8, as defined by the IFCN bits in register OSCICN. The divide value defaults to 8 following a reset. 19.2.1. Internal Oscillator Suspend Mode When software writes a logic 1 to SUSPEND (OSCICN.5), the internal oscillator is suspended. If the system clock is derived from the internal oscillator, the input clock to the peripheral or CIP-51 will be stopped until one of the following events occur:  Port 0 Match Event. Port 1 Match Event.  Comparator 0 enabled and output is logic 0.  Timer3 Overflow Event.  When one of the oscillator awakening events occur, the internal oscillator, CIP-51, and affected peripherals resume normal operation, regardless of whether the event also causes an interrupt. The CPU resumes execution at the instruction following the write to SUSPEND. SFR Definition 19.2. OSCICL: Internal H-F Oscillator Calibration Bit 7 6 5 4 3 1 0 Varies Varies Varies OSCICL[6:0] Name Type R Reset 0 SFR Address = 0xB3 Bit Name 7 6:0 2 R/W Varies Varies Varies Varies Function Unused Unused. Read = 0; Write = Don’t Care OSCICL[6:0] Internal Oscillator Calibration Bits. These bits determine the internal oscillator period. When set to 0000000b, the H-F oscillator operates at its fastest setting. When set to 1111111b, the H-F oscillator operates at its slowest setting. The reset value is factory calibrated to generate an internal oscillator frequency of 24.5 MHz. Rev.1.0 111 C8051F336/7/8/9 SFR Definition 19.3. OSCICN: Internal H-F Oscillator Control Bit 7 6 5 4 Name IOSCEN IFRDY SUSPEND STSYNC Type R/W R R/W R R R Reset 1 1 0 0 0 0 SFR Address = 0xB2 Bit Name 7 IOSCEN 3 2 1 0 IFCN[1:0] R/W 0 0 Function Internal H-F Oscillator Enable Bit. 0: Internal H-F Oscillator Disabled. 1: Internal H-F Oscillator Enabled. 6 IFRDY Internal H-F Oscillator Frequency Ready Flag. 0: Internal H-F Oscillator is not running at programmed frequency. 1: Internal H-F Oscillator is running at programmed frequency. 5 SUSPEND Internal Oscillator Suspend Enable Bit. Setting this bit to logic 1 places the internal oscillator in SUSPEND mode. The internal oscillator resumes operation when one of the SUSPEND mode awakening events occurs. 4 STSYNC Suspend Timer Synchronization Bit. This bit is used to indicate when it is safe to read and write the registers associated with the suspend wake-up timer. If a suspend wake-up source other than the timer has brought the oscillator out of suspend mode, it may take up to three timer clocks before the timer can be read or written. When STSYNC reads '1', reads and writes of the timer register should not be performed. When STSYNC reads '0', it is safe to read and write the timer registers. 3:2 1:0 Unused IFCN[1:0] Unused. Read = 00b; Write = Don’t Care Internal H-F Oscillator Frequency Divider Control Bits. 00: SYSCLK derived from Internal H-F Oscillator divided by 8. 01: SYSCLK derived from Internal H-F Oscillator divided by 4. 10: SYSCLK derived from Internal H-F Oscillator divided by 2. 11: SYSCLK derived from Internal H-F Oscillator divided by 1. 112 Rev.1.0 C8051F336/7/8/9 19.3. Programmable Internal Low-Frequency (L-F) Oscillator All C8051F336/7/8/9 devices include a programmable low-frequency internal oscillator, which is calibrated to a nominal frequency of 80 kHz. The low-frequency oscillator circuit includes a divider that can be changed to divide the clock by 1, 2, 4, or 8, using the OSCLD bits in the OSCLCN register (see SFR Definition 19.4). Additionally, the OSCLF[3:0] bits can be used to adjust the oscillator’s output frequency. 19.3.1. Calibrating the Internal L-F Oscillator Timers 2 and 3 include capture functions that can be used to capture the oscillator frequency, when running from a known time base. When either Timer 2 or Timer 3 is configured for L-F Oscillator Capture Mode, a falling edge (Timer 2) or rising edge (Timer 3) of the low-frequency oscillator’s output will cause a capture event on the corresponding timer. As a capture event occurs, the current timer value (TMRnH:TMRnL) is copied into the timer reload registers (TMRnRLH:TMRnRLL). By recording the difference between two successive timer capture values, the low-frequency oscillator’s period can be calculated. The OSCLF bits can then be adjusted to produce the desired oscillator frequency. SFR Definition 19.4. OSCLCN: Internal L-F Oscillator Control Bit 7 6 5 Name OSCLEN OSCLRDY OSCLF[3:0] OSCLD[1:0] Type R/W R R.W R/W Reset 0 0 Varies 4 3 Varies SFR Address = 0xE3 Bit Name 7 OSCLEN Varies 2 Varies 1 0 0 0 Function Internal L-F Oscillator Enable. 0: Internal L-F Oscillator Disabled. 1: Internal L-F Oscillator Enabled. 6 OSCLRDY Internal L-F Oscillator Ready. 0: Internal L-F Oscillator frequency not stabilized. 1: Internal L-F Oscillator frequency stabilized. Note: OSCLRDY is only set back to 0 in the event of a device reset or a change to the OSCLD[1:0] bits. 5:2 OSCLF[3:0] Internal L-F Oscillator Frequency Control Bits. Fine-tune control bits for the Internal L-F oscillator frequency. When set to 0000b, the L-F oscillator operates at its fastest setting. When set to 1111b, the L-F oscillator operates at its slowest setting. 1:0 OSCLD[1:0] Internal L-F Oscillator Divider Select. 00: Divide by 8 selected. 01: Divide by 4 selected. 10: Divide by 2 selected. 11: Divide by 1 selected. Rev.1.0 113 C8051F336/7/8/9 114 Rev.1.0 C8051F336/7/8/9 19.4. External Oscillator Drive Circuit The external oscillator circuit may drive an external crystal, ceramic resonator, capacitor, or RC network. A CMOS clock may also provide a clock input. For a crystal or ceramic resonator configuration, the crystal/resonator must be wired across the XTAL1 and XTAL2 pins as shown in Option 1 of Figure 19.1. A 10 MΩ resistor also must be wired across the XTAL2 and XTAL1 pins for the crystal/resonator configuration. In RC, capacitor, or CMOS clock configuration, the clock source should be wired to the XTAL2 pin as shown in Option 2, 3, or 4 of Figure 19.1. The type of external oscillator must be selected in the OSCXCN register, and the frequency control bits (XFCN) must be selected appropriately (see SFR Definition 19.5). Important Note on External Oscillator Usage: Port pins must be configured when using the external oscillator circuit. When the external oscillator drive circuit is enabled in crystal/resonator mode, Port pins P0.2 and P0.3 are used as XTAL1 and XTAL2 respectively. When the external oscillator drive circuit is enabled in capacitor, RC, or CMOS clock mode, Port pin P0.3 is used as XTAL2. The Port I/O Crossbar should be configured to skip the Port pins used by the oscillator circuit; see Section “20.3. Priority Crossbar Decoder” on page 124 for Crossbar configuration. Additionally, when using the external oscillator circuit in crystal/resonator, capacitor, or RC mode, the associated Port pins should be configured as analog inputs. In CMOS clock mode, the associated pin should be configured as a digital input. See Section “20.4. Port I/O Initialization” on page 126 for details on Port input mode selection. Rev.1.0 114 C8051F336/7/8/9 SFR Definition 19.5. OSCXCN: External Oscillator Control Bit 7 6 Name XTLVLD XOSCMD[2:0] Type R R/W Reset 0 0 5 4 3 XTLVLD 1 0 XFCN[2:0] R 0 0 0 SFR Address = 0xB1 Bit Name 7 2 R/W 0 0 0 Function Crystal Oscillator Valid Flag. (Read only when XOSCMD = 11x.) 0: Crystal Oscillator is unused or not yet stable. 1: Crystal Oscillator is running and stable. 6:4 XOSCMD[2:0] External Oscillator Mode Select. 00x: External Oscillator circuit off. 010: External CMOS Clock Mode. 011: External CMOS Clock Mode with divide by 2 stage. 100: RC Oscillator Mode. 101: Capacitor Oscillator Mode. 110: Crystal Oscillator Mode. 111: Crystal Oscillator Mode with divide by 2 stage. 3 2:0 UNUSED XFCN[2:0] Read = 0; Write = Don’t Care External Oscillator Frequency Control Bits. Set according to the desired frequency for Crystal or RC mode. Set according to the desired K Factor for C mode. 115 XFCN Crystal Mode RC Mode C Mode 000 001 010 011 100 101 110 111 f ≤ 32 kHz 32 kHz < f ≤ 84 kHz 84 kHz < f ≤ 225 kHz 225 kHz < f ≤ 590 kHz 590 kHz < f ≤ 1.5 MHz 1.5 MHz < f ≤ 4 MHz 4 MHz < f ≤ 10 MHz 10 MHz < f ≤ 30 MHz f ≤ 25 kHz 25 kHz < f ≤ 50 kHz 50 kHz < f ≤ 100 kHz 100 kHz < f ≤ 200 kHz 200 kHz < f ≤ 400 kHz 400 kHz < f ≤ 800 kHz 800 kHz < f ≤ 1.6 MHz 1.6 MHz < f ≤ 3.2 MHz K Factor = 0.87 K Factor = 2.6 K Factor = 7.7 K Factor = 22 K Factor = 65 K Factor = 180 K Factor = 664 K Factor = 1590 Rev.1.0 C8051F336/7/8/9 19.4.1. External Crystal Example If a crystal or ceramic resonator is used as an external oscillator source for the MCU, the circuit should be configured as shown in Figure 19.1, Option 1. The External Oscillator Frequency Control value (XFCN) should be chosen from the Crystal column of the table in SFR Definition 19.5 (OSCXCN register). For example, an 11.0592 MHz crystal requires an XFCN setting of 111b and a 32.768 kHz Watch Crystal requires an XFCN setting of 001b. After an external 32.768 kHz oscillator is stabilized, the XFCN setting can be switched to 000 to save power. It is recommended to enable the missing clock detector before switching the system clock to any external oscillator source. When the crystal oscillator is first enabled, the oscillator amplitude detection circuit requires a settling time to achieve proper bias. Introducing a delay of 1 ms between enabling the oscillator and checking the XTLVLD bit will prevent a premature switch to the external oscillator as the system clock. Switching to the external oscillator before the crystal oscillator has stabilized can result in unpredictable behavior. The recommended procedure is: 1. Force XTAL1 and XTAL2 to a low state. This involves enabling the Crossbar and writing ‘0’ to the port pins associated with XTAL1 and XTAL2. 2. Configure XTAL1 and XTAL2 as analog inputs using. 3. Enable the external oscillator. 4. Wait at least 1 ms. 5. Poll for XTLVLD => ‘1’. 6. Enable the Missing Clock Detector. 7. Switch the system clock to the external oscillator. Important Note on External Crystals: Crystal oscillator circuits are quite sensitive to PCB layout. The crystal should be placed as close as possible to the XTAL pins on the device. The traces should be as short as possible and shielded with ground plane from any other traces which could introduce noise or interference. The capacitors shown in the external crystal configuration provide the load capacitance required by the crystal for correct oscillation. These capacitors are "in series" as seen by the crystal and "in parallel" with the stray capacitance of the XTAL1 and XTAL2 pins. Note: The desired load capacitance depends upon the crystal and the manufacturer. Please refer to the crystal data sheet when completing these calculations. For example, a tuning-fork crystal of 32.768 kHz with a recommended load capacitance of 12.5 pF should use the configuration shown in Figure 19.1, Option 1. The total value of the capacitors and the stray capacitance of the XTAL pins should equal 25 pF. With a stray capacitance of 3 pF per pin, the 22 pF capacitors yield an equivalent capacitance of 12.5 pF across the crystal, as shown in Figure 19.2. Rev.1.0 116 C8051F336/7/8/9 XTAL1 10MΩ XTAL2 32.768 kHz 22pF* 22pF* * Capacitor values depend on crystal specifications Figure 19.2. External 32.768 kHz Quartz Crystal Oscillator Connection Diagram 19.4.2. External RC Example If an RC network is used as an external oscillator source for the MCU, the circuit should be configured as shown in Figure 19.1, Option 2. The capacitor should be no greater than 100 pF; however for very small capacitors, the total capacitance may be dominated by parasitic capacitance in the PCB layout. To determine the required External Oscillator Frequency Control value (XFCN) in the OSCXCN Register, first select the RC network value to produce the desired frequency of oscillation, according to Equation 19.1, where f = the frequency of oscillation in MHz, C = the capacitor value in pF, and R = the pull-up resistor value in kΩ. Equation 19.1. RC Mode Oscillator Frequency 3 f = 1.23 × 10 ⁄ ( R × C ) For example: If the frequency desired is 100 kHz, let R = 246 kΩ and C = 50 pF: f = 1.23( 103 ) / RC = 1.23 ( 103 ) / [ 246 x 50 ] = 0.1 MHz = 100 kHz Referring to the table in SFR Definition 19.5, the required XFCN setting is 010b. 117 Rev.1.0 C8051F336/7/8/9 19.4.3. External Capacitor Example If a capacitor is used as an external oscillator for the MCU, the circuit should be configured as shown in Figure 19.1, Option 3. The capacitor should be no greater than 100 pF; however for very small capacitors, the total capacitance may be dominated by parasitic capacitance in the PCB layout. To determine the required External Oscillator Frequency Control value (XFCN) in the OSCXCN Register, select the capacitor to be used and find the frequency of oscillation according to Equation 19.2, where f = the frequency of oscillation in MHz, C = the capacitor value in pF, and VDD = the MCU power supply in Volts. Equation 19.2. C Mode Oscillator Frequency f = ( KF ) ⁄ ( R × V DD ) For example: Assume VDD = 3.0 V and f = 150 kHz: f = KF / (C x VDD) 0.150 MHz = KF / (C x 3.0) Since the frequency of roughly 150 kHz is desired, select the K Factor from the table in SFR Definition 19.5 (OSCXCN) as KF = 22: 0.150 MHz = 22 / (C x 3.0) C x 3.0 = 22 / 0.150 MHz C = 146.6 / 3.0 pF = 48.8 pF Therefore, the XFCN value to use in this example is 011b and C = 50 pF. Rev.1.0 118 C8051F336/7/8/9 20. Port Input/Output Digital and analog resources are available through 17 (C8051F336/7) or 21 (C8051F338/9) I/O pins. Port pins P0.0-P2.3 can be defined as general-purpose I/O (GPIO), assigned to one of the internal digital resources, or assigned to an analog function as shown in Figure 20.4. Port pin P2.4 on the C8051F338/9 and P2.0 on the C8051F336/7 can be used as GPIO and are shared with the C2 Interface Data signal (C2D). The designer has complete control over which functions are assigned, limited only by the number of physical I/O pins. This resource assignment flexibility is achieved through the use of a Priority Crossbar Decoder. Note that the state of a Port I/O pin can always be read in the corresponding Port latch, regardless of the Crossbar settings. The Crossbar assigns the selected internal digital resources to the I/O pins based on the Priority Decoder (Figure 20.4 and Figure 20.5). The registers XBR0 and XBR1, defined in SFR Definition 20.1 and SFR Definition 20.2, are used to select internal digital functions. All Port I/Os are 5 V tolerant (refer to Figure 20.2 for the Port cell circuit). The Port I/O cells are configured as either push-pull or open-drain in the Port Output Mode registers (PnMDOUT, where n = 0,1). Complete Electrical Specifications for Port I/O are given in Section “6. Electrical Characteristics” on page 27. Port Match P0MASK, P0MAT P1MASK, P1MAT XBR0, XBR1, PnSKIP Registers External Interrupts EX0 and EX1 Priority Decoder Highest Priority UART 4 (Internal Digital Signals) SPI P0.0 2 SMBus CP0 Outputs Digital Crossbar 8 2 P1 I/O Cells P1.7 2 8 (Port Latches) P0 P1.0 8 4 T0, T1 P0 I/O Cells P0.7 SYSCLK PCA Lowest Priority PnMDOUT, PnMDIN Registers 2 4 (P0.0-P0.7) P2.0* P2 I/O Cell P2.3* 8 P1 (P1.0-P1.7) 4 P2 (P2.0-P2.3*) To Analog Peripherals (ADC0, CP0, VREF, XTAL) *P2.0-P2.3 are only available through the crossbar on QFN24 Packages. Figure 20.1. Port I/O Functional Block Diagram Rev.1.0 119 C8051F336/7/8/9 20.1. Port I/O Modes of Operation Port pins P0.0 - P2.3 use the Port I/O cell shown in Figure 20.2. Each Port I/O cell can be configured by software for analog I/O or digital I/O using the PnMDIN registers. On reset, all Port I/O cells default to a high impedance state with weak pull-ups enabled. Until the crossbar is enabled (XBARE = ‘1’), both the high and low port I/O drive circuits are explicitly disabled on all crossbar pins. 20.1.1. Port Pins Configured for Analog I/O Any pins to be used as Comparator or ADC input, external oscillator input/output, VREF, or IDAC output should be configured for analog I/O (PnMDIN.n = ‘1’). When a pin is configured for analog I/O, its weak pullup, digital driver, and digital receiver are disabled. Port pins configured for analog I/O will always read back a value of ‘0’. Configuring pins as analog I/O saves power and isolates the Port pin from digital interference. Port pins configured as digital I/O may still be used by analog peripherals; however, this practice is not recommended and may result in measurement errors. 20.1.2. Port Pins Configured For Digital I/O Any pins to be used by digital peripherals (UART, SPI, SMBus, etc.), external event trigger functions, or as GPIO should be configured as digital I/O (PnMDIN.n = ‘1’). For digital I/O pins, one of two output modes (push-pull or open-drain) must be selected using the PnMDOUT registers. Push-pull outputs (PnMDOUT.n = ‘1’) drive the Port pad to the VDD or GND supply rails based on the output logic value of the Port pin. Open-drain outputs have the high side driver disabled; therefore, they only drive the Port pad to GND when the output logic value is ‘0’ and become high impedance inputs (both high low drivers turned off) when the output logic value is ‘1’. When a digital I/O cell is placed in the high impedance state, a weak pull-up transistor pulls the Port pad to the VDD supply voltage to ensure the digital input is at a defined logic state. Weak pull-ups are disabled when the I/O cell is driven to GND to minimize power consumption, and they may be globally disabled by setting WEAKPUD to ‘1’. The user should ensure that digital I/O are always internally or externally pulled or driven to a valid logic state to minimize power consumption. Port pins configured for digital I/O always read back the logic state of the Port pad, regardless of the output logic value of the Port pin. 120 Rev.1.0 C8051F336/7/8/9 WEAKPUD (Weak Pull-Up Disable) PxMDOUT.x (1 for push-pull) (0 for open-drain) VDD VDD XBARE (Crossbar Enable) (WEAK) PORT PAD Px.x – Output Logic Value (Port Latch or Crossbar) PxMDIN.x (1 for digital) (0 for analog) To/From Analog Peripheral GND Px.x – Input Logic Value (Reads 0 when pin is configured as an analog I/O) Figure 20.2. Port I/O Cell Block Diagram 20.1.3. Interfacing Port I/O to 5V Logic All Port I/O configured for digital, open-drain operation are capable of interfacing to digital logic operating at a supply voltage higher than VDD and less than 5.25V. An external pull-up resistor to the higher supply voltage is typically required for most systems. Important Note: In a multi-voltage interface, the external pull-up resistor should be sized to allow a current of at least 150uA to flow into the Port pin when the supply voltage is between (VDD + 0.6V) and (VDD + 1.0V). Once the Port pin voltage increases beyond this range, the current flowing into the Port pin is minimal. Figure 20.3 shows the input current characteristics of port pins driven above VDD. The port pin requires 150 µA peak overdrive current when its voltage reaches approximately (VDD + 0.7 V). VDD Vtest (V) VDD VDD+0.7 IVtest 0 I/O Cell IVtest -10 (µA) + - Vtest Port I/O Overdrive Test Circuit -150 Port I/O Overdrive Current vs. Voltage Figure 20.3. Port I/O Overdrive Current Rev.1.0 121 C8051F336/7/8/9 20.2. Assigning Port I/O Pins to Analog and Digital Functions Port I/O pins P0.0 - P2.3 can be assigned to various analog, digital, and external interrupt functions. The Port pins assigned to analog functions should be configured for analog I/O, and Port pins assigned to digital or external interrupt functions should be configured for digital I/O. 20.2.1. Assigning Port I/O Pins to Analog Functions Table 20.1 shows all available analog functions that require Port I/O assignments. Port pins selected for these analog functions should have their corresponding bit in PnSKIP set to ‘1’. This reserves the pin for use by the analog function and does not allow it to be claimed by the Crossbar. Table 20.1 shows the potential mapping of Port I/O to each analog function. Table 20.1. Port I/O Assignment for Analog Functions Analog Function Potentially Assignable Port Pins SFR(s) used for Assignment ADC Input P0.0 - P2.3 AMX0P, AMX0N, PnSKIP, PnMDIN Comparator0 Input P0.0 - P2.3 CPT0MX, PnSKIP, PnMDIN Voltage Reference (VREF0) P0.0 REF0CN, PnSKIP, PnMDIN Current DAC Output (IDA0) P0.1 IDA0CN, PnSKIP, PnMDIN External Oscillator in Crystal Mode (XTAL1) P0.2 OSCXCN, PnSKIP, PnMDIN External Oscillator in RC, C, or Crystal Mode (XTAL2) P0.3 OSCXCN, PnSKIP, PnMDIN 20.2.2. Assigning Port I/O Pins to Digital Functions Any Port pins not assigned to analog functions may be assigned to digital functions or used as GPIO. Most digital functions rely on the Crossbar for pin assignment; however, some digital functions bypass the Crossbar in a manner similar to the analog functions listed above. Port pins used by these digital functions and any Port pins selected for use as GPIO should have their corresponding bit in PnSKIP set to ‘1’. Table 20.2 shows all available digital functions and the potential mapping of Port I/O to each digital function. Table 20.2. Port I/O Assignment for Digital Functions Digital Function Potentially Assignable Port Pins UART0, SPI0, SMBus, CP0, Any Port pin available for assignment by the CP0A, SYSCLK, PCA0 Crossbar. This includes P0.0 - P2.3 pins which (CEX0-2 and ECI), T0 or T1. have their PnSKIP bit set to ‘0’. Note: The Crossbar will always assign UART0 pins to P0.4 and P0.5. Any pin used for GPIO 122 P0.0 - P2.4 Rev.1.0 SFR(s) used for Assignment XBR0, XBR1 P0SKIP, P1SKIP, P2SKIP C8051F336/7/8/9 20.2.3. Assigning Port I/O Pins to External Event Trigger Functions External event trigger functions can be used to trigger an interrupt or wake the device from a low power mode when a transition occurs on a digital I/O pin. The event trigger functions do not require dedicated pins and will function on both GPIO pins (PnSKIP = ’1’) and pins in use by the Crossbar (PnSKIP = ‘0’). External event trigger functions cannot be used on pins configured for analog I/O. Table 20.3 shows all available external event trigger functions. Table 20.3. Port I/O Assignment for External Event Trigger Functions Event Trigger Function Potentially Assignable Port Pins SFR(s) used for Assignment External Interrupt 0 P0.0 - P0.7 IT01CF External Interrupt 1 P0.0 - P0.7 IT01CF Port Match P0.0 - P1.7 P0MASK, P0MAT P1MASK, P1MAT Rev.1.0 123 C8051F336/7/8/9 20.3. Priority Crossbar Decoder The Priority Crossbar Decoder (Figure 20.4) assigns a priority to each I/O function, starting at the top with UART0. When a digital resource is selected, the least-significant unassigned Port pin is assigned to that resource (excluding UART0, which is always at pins 4 and 5). If a Port pin is assigned, the Crossbar skips that pin when assigning the next selected resource. Additionally, the Crossbar will skip Port pins whose associated bits in the PnSKIP registers are set. The PnSKIP registers allow software to skip Port pins that are to be used for analog input, dedicated functions, or GPIO. Important Note on Crossbar Configuration: If a Port pin is claimed by a peripheral without use of the Crossbar, its corresponding PnSKIP bit should be set. This applies to P0.0 if VREF is used, P0.3 and/or P0.2 if the external oscillator circuit is enabled, P0.6 if the ADC or IDAC is configured to use the external conversion start signal (CNVSTR), and any selected ADC or Comparator inputs. The Crossbar skips selected pins as if they were already assigned, and moves to the next unassigned pin. Figure 20.4 shows all of the potential peripheral-to-pin assignments available to the crossbar. Note that this does not mean any peripheral can always be assigned to the highlighted pins. The actual pin assignments are determined by the priority of the enabled peripherals. P0 SF Signals PIN I/O VREF IDA 0 1 x1 x2 2 3 P1 P2 CNVSTR 4 5 6 7 0 1 2 3 4 5 6 7 0 12 22 32 42 TX0 Pin not available for crossbar peripherals. RX0 SCK MISO MOSI NSS1 SDA SCL CP0 CP0A SYSCLK CEX0 CEX1 CEX2 ECI T0 T1 SF Signals Port pin potentially available to peripheral Notes: Special Function Signals are not assigned by the crossbar. When these signals are enabled, the Crossbar must be manually configured to skip their corresponding port pins. 1. NSS is only pinned out in 4-wire SPI Mode 2. Pins P2.1-P2.4 only on QFN24 Package 3. Pin 2.0 unavailable on crossbar in QFN20 Package Figure 20.4. Crossbar Priority Decoder - Possible Pin Assignments 124 Rev.1.0 C8051F336/7/8/9 Registers XBR0 and XBR1 are used to assign the digital I/O resources to the physical I/O Port pins. Note that when the SMBus is selected, the Crossbar assigns both pins associated with the SMBus (SDA and SCL); when the UART is selected, the Crossbar assigns both pins associated with the UART (TX and RX). UART0 pin assignments are fixed for bootloading purposes: UART TX0 is always assigned to P0.4; UART RX0 is always assigned to P0.5. Standard Port I/Os appear contiguously after the prioritized functions have been assigned. Figure 20.5 shows an example of the resulting pin assignments of the device with UART0, SMBus, and CEX0 enabled, the XTAL1 (P0.2) and XTAL2 (P0.3) pins skipped (P0SKIP = 0x0C). UART0 is the highest priority and it will be assigned first. The UART can only appear on P0.4 and P0.5, so that is where it is assigned. The next-highest enabled peripheral is the SMBus. P0.0 and P0.1 are free, so the SMBus takes these two pins. The last peripheral enabled is the PCA’s CEX0 pin. P0.0, P0.1, P0.4 and P0.5 are already occupied by higher-priority peripherals. Additionally, P0.2 and P0.3 are set to be skipped by the crossbar. The CEX0 signal ends up getting routed to P0.6, as it is the next available pin. The other pins on the device are available for use as general-purpose digital I/O or analog functions. P0 SF Signals PIN I/O VREF IDA x2 3 4 5 6 7 0 1 2 1 0 0 0 0 0 0 0 0 1 2 0 0 1 P2 P1 x1 CNVSTR 3 4 5 6 7 0 0 0 0 0 0 0 12 22 32 0 0 0 42 TX0 RX0 Pin not available for crossbar peripherals. SCK MISO MOSI NSS1 SDA SCL CP0 CP0A SYSCLK CEX0 CEX1 CEX2 ECI T0 T1 P1SKIP[0:7] P0SKIP[0:7] SF Signals P2SKIP[0:3] Port pin potentially available to peripheral Notes: Special Function Signals are not assigned by the crossbar. When these signals are enabled, the CrossBar must be manually configured to skip their corresponding port pins. 1. NSS is only pinned out in 4-wire SPI Mode 2. Pins P2.1-P2.4 only on QFN24 Package 3. Pin 2.0 unavailable on crossbar in QFN20 Package Figure 20.5. Crossbar Priority Decoder Example Important Note: The SPI can be operated in either 3-wire or 4-wire modes, pending the state of the NSSMD1–NSSMD0 bits in register SPI0CN. According to the SPI mode, the NSS signal may or may not be routed to a Port pin. Rev.1.0 125 C8051F336/7/8/9 20.4. Port I/O Initialization Port I/O initialization consists of the following steps: 1. Select the input mode (analog or digital) for all Port pins, using the Port Input Mode register (PnMDIN). 2. Select the output mode (open-drain or push-pull) for all Port pins, using the Port Output Mode register (PnMDOUT). 3. Select any pins to be skipped by the I/O Crossbar using the Port Skip registers (PnSKIP). 4. Assign Port pins to desired peripherals. 5. Enable the Crossbar (XBARE = ‘1’). All Port pins must be configured as either analog or digital inputs. Any pins to be used as Comparator or ADC inputs should be configured as an analog inputs. When a pin is configured as an analog input, its weak pullup, digital driver, and digital receiver are disabled. This process saves power and reduces noise on the analog input. Pins configured as digital inputs may still be used by analog peripherals; however this practice is not recommended. Additionally, all analog input pins should be configured to be skipped by the Crossbar (accomplished by setting the associated bits in PnSKIP). Port input mode is set in the PnMDIN register, where a ‘1’ indicates a digital input, and a ‘0’ indicates an analog input. All pins default to digital inputs on reset. See SFR Definition 20.8 for the PnMDIN register details. The output driver characteristics of the I/O pins are defined using the Port Output Mode registers (PnMDOUT). Each Port Output driver can be configured as either open drain or push-pull. This selection is required even for the digital resources selected in the XBRn registers, and is not automatic. The only exception to this is the SMBus (SDA, SCL) pins, which are configured as open-drain regardless of the PnMDOUT settings. When the WEAKPUD bit in XBR1 is ‘0’, a weak pullup is enabled for all Port I/O configured as open-drain. WEAKPUD does not affect the push-pull Port I/O. Furthermore, the weak pullup is turned off on an output that is driving a ‘0’ to avoid unnecessary power dissipation. Registers XBR0 and XBR1 must be loaded with the appropriate values to select the digital I/O functions required by the design. Setting the XBARE bit in XBR1 to ‘1’ enables the Crossbar. Until the Crossbar is enabled, the external pins remain as standard Port I/O (in input mode), regardless of the XBRn Register settings. For given XBRn Register settings, one can determine the I/O pin-out using the Priority Decode Table; as an alternative, the Configuration Wizard utility of the Silicon Labs IDE software will determine the Port I/O pin-assignments based on the XBRn Register settings. The Crossbar must be enabled to use Port pins as standard Port I/O in output mode. Port output drivers are disabled while the Crossbar is disabled. 126 Rev.1.0 C8051F336/7/8/9 SFR Definition 20.1. XBR0: Port I/O Crossbar Register 0 Bit 7 6 Name 5 4 3 2 1 0 CP0AE CP0E SYSCKE SMB0E SPI0E URT0E Type R R R/W R/W R/W R/W R/W R/W Reset 0 0 0 0 0 0 0 0 SFR Address = 0xE1 Bit Name 7:6 5 Function UNUSED Unused. Read = 00b; Write = Don’t Care. CP0AE Comparator0 Asynchronous Output Enable. 0: Asynchronous CP0 unavailable at Port pin. 1: Asynchronous CP0 routed to Port pin. 4 CP0E Comparator0 Output Enable. 0: CP0 unavailable at Port pin. 1: CP0 routed to Port pin. 3 SYSCKE /SYSCLK Output Enable. 0: /SYSCLK unavailable at Port pin. 1: /SYSCLK output routed to Port pin. 2 SMB0E SMBus I/O Enable. 0: SMBus I/O unavailable at Port pins. 1: SMBus I/O routed to Port pins. 1 SPI0E SPI I/O Enable. 0: SPI I/O unavailable at Port pins. 1: SPI I/O routed to Port pins. Note that the SPI can be assigned either 3 or 4 GPIO pins. 0 URT0E UART I/O Output Enable. 0: UART I/O unavailable at Port pin. 1: UART TX0, RX0 routed to Port pins P0.4 and P0.5. Rev.1.0 127 C8051F336/7/8/9 SFR Definition 20.2. XBR1: Port I/O Crossbar Register 1 Bit 7 Name WEAKPUD 6 5 4 3 XBARE T1E T0E ECIE 2 1 0 PCA0ME[1:0] Type R/W R/W R/W R/W R/W R R/W R/W Reset 0 0 0 0 0 0 0 0 SFR Address = 0xE2 Bit Name 7 WEAKPUD Function Port I/O Weak Pullup Disable. 0: Weak Pullups enabled (except for Ports whose I/O are configured for analog mode). 1: Weak Pullups disabled. 6 XBARE Crossbar Enable. 0: Crossbar disabled. 1: Crossbar enabled. 5 T1E T1 Enable. 0: T1 unavailable at Port pin. 1: T1 routed to Port pin. 4 T0E T0 Enable. 0: T0 unavailable at Port pin. 1: T0 routed to Port pin. 3 ECIE PCA0 External Counter Input Enable. 0: ECI unavailable at Port pin. 1: ECI routed to Port pin. 2 UNUSED Unused. Read = 0b; Write = Don’t Care. 1:0 PCA0ME[1:0] PCA Module I/O Enable Bits. 00: All PCA I/O unavailable at Port pins. 01: CEX0 routed to Port pin. 10: CEX0, CEX1 routed to Port pins. 11: CEX0, CEX1, CEX2 routed to Port pins. 128 Rev.1.0 C8051F336/7/8/9 20.5. Port Match Port match functionality allows system events to be triggered by a logic value change on P0 or P1. A software controlled value stored in the PnMATCH registers specifies the expected or normal logic values of P0 and P1. A Port mismatch event occurs if the logic levels of the Port’s input pins no longer match the software controlled value. This allows Software to be notified if a certain change or pattern occurs on P0 or P1 input pins regardless of the XBRn settings. The PnMASK registers can be used to individually select which P0 and P1 pins should be compared against the PnMATCH registers. A Port mismatch event is generated if (P0 & P0MASK) does not equal (P0MATCH & P0MASK) or if (P1 & P1MASK) does not equal (P1MATCH & P1MASK). A Port mismatch event may be used to generate an interrupt or wake the device from a low power mode, such as IDLE or SUSPEND. See the Interrupts and Power Options chapters for more details on interrupt and wake-up sources. SFR Definition 20.3. P0MASK: Port 0 Mask Register Bit 7 6 5 4 3 Name P0MASK[7:0] Type R/W Reset 0 0 0 SFR Address = 0xFE Bit Name 7:0 P0MASK[7:0] 0 0 2 1 0 0 0 0 Function Port 0 Mask Value. Selects P0 pins to be compared to the corresponding bits in P0MAT. 0: P0.n pin logic value is ignored and cannot cause a Port Mismatch event. 1: P0.n pin logic value is compared to P0MAT.n. Rev.1.0 129 C8051F336/7/8/9 SFR Definition 20.4. P0MAT: Port 0 Match Register Bit 7 6 5 4 3 Name P0MAT[7:0] Type R/W Reset 1 1 1 1 1 SFR Address = 0xFD Bit Name 7:0 P0MAT[7:0] 2 1 0 1 1 1 Function Port 0 Match Value. Match comparison value used on Port 0 for bits in P0MASK which are set to ‘1’. 0: P0.n pin logic value is compared with logic LOW. 1: P0.n pin logic value is compared with logic HIGH. SFR Definition 20.5. P1MASK: Port 1 Mask Register Bit 7 6 5 4 3 Name P1MASK[7:0] Type R/W Reset 0 0 0 0 SFR Address = 0xEE Bit Name 7:0 P1MASK[7:0] 0 2 1 0 0 0 0 Function Port 1 Mask Value. Selects P1 pins to be compared to the corresponding bits in P1MAT. 0: P1.n pin logic value is ignored and cannot cause a Port Mismatch event. 1: P1.n pin logic value is compared to P1MAT.n. 130 Rev.1.0 C8051F336/7/8/9 SFR Definition 20.6. P1MAT: Port 1 Match Register Bit 7 6 5 4 3 Name P1MAT[7:0] Type R/W Reset 1 1 1 SFR Address = 0xED Bit Name 7:0 P1MAT[7:0] 1 1 2 1 0 1 1 1 Function Port 1 Match Value. Match comparison value used on Port 1 for bits in P1MASK which are set to ‘1’. 0: P1.n pin logic value is compared with logic LOW. 1: P1.n pin logic value is compared with logic HIGH. 20.6. Special Function Registers for Accessing and Configuring Port I/O All Port I/O are accessed through corresponding special function registers (SFRs) that are both byte addressable and bit addressable. When writing to a Port, the value written to the SFR is latched to maintain the output data value at each pin. When reading, the logic levels of the Port's input pins are returned regardless of the XBRn settings (i.e., even when the pin is assigned to another signal by the Crossbar, the Port register can always read its corresponding Port I/O pin). The exception to this is the execution of the read-modify-write instructions that target a Port Latch register as the destination. The read-modify-write instructions when operating on a Port SFR are the following: ANL, ORL, XRL, JBC, CPL, INC, DEC, DJNZ and MOV, CLR or SETB, when the destination is an individual bit in a Port SFR. For these instructions, the value of the latch register (not the pin) is read, modified, and written back to the SFR. Each Port has a corresponding PnSKIP register which allows its individual Port pins to be assigned to digital functions or skipped by the Crossbar. All Port pins used for analog functions, GPIO, or dedicated digital functions such as the EMIF should have their PnSKIP bit set to ‘1’. The Port input mode of the I/O pins is defined using the Port Input Mode registers (PnMDIN). Each Port cell can be configured for analog or digital I/O. This selection is required even for the digital resources selected in the XBRn registers, and is not automatic. The only exception to this is P2.4, which can only be used for digital I/O. The output driver characteristics of the I/O pins are defined using the Port Output Mode registers (PnMDOUT). Each Port Output driver can be configured as either open drain or push-pull. This selection is required even for the digital resources selected in the XBRn registers, and is not automatic. The only exception to this is the SMBus (SDA, SCL) pins, which are configured as open-drain regardless of the PnMDOUT settings. Rev.1.0 131 C8051F336/7/8/9 SFR Definition 20.7. P0: Port 0 Bit 7 6 5 4 Name P0[7:0] Type R/W Reset 1 1 1 1 SFR Address = 0x80; Bit Addressable Bit Name Description 7:0 P0[7:0] Port 0 Data. Sets the Port latch logic value or reads the Port pin logic state in Port cells configured for digital I/O. 3 2 1 0 1 1 1 1 Write Read 0: Set output latch to logic LOW. 1: Set output latch to logic HIGH. 0: P0.n Port pin is logic LOW. 1: P0.n Port pin is logic HIGH. SFR Definition 20.8. P0MDIN: Port 0 Input Mode Bit 7 6 5 4 3 Name P0MDIN[7:0] Type R/W Reset 1 1 1 1 SFR Address = 0xF1 Bit Name 7:0 P0MDIN[7:0] 1 2 1 0 1 1 1 Function Analog Configuration Bits for P0.7–P0.0 (respectively). Port pins configured for analog mode have their weak pullup, digital driver, and digital receiver disabled. 0: Corresponding P0.n pin is configured for analog mode. 1: Corresponding P0.n pin is not configured for analog mode. 132 Rev.1.0 C8051F336/7/8/9 SFR Definition 20.9. P0MDOUT: Port 0 Output Mode Bit 7 6 5 4 3 Name P0MDOUT[7:0] Type R/W Reset 0 0 0 0 0 SFR Address = 0xA4 Bit Name 2 1 0 0 0 0 Function 7:0 P0MDOUT[7:0] Output Configuration Bits for P0.7–P0.0 (respectively). These bits are ignored if the corresponding bit in register P0MDIN is logic 0. 0: Corresponding P0.n Output is open-drain. 1: Corresponding P0.n Output is push-pull. SFR Definition 20.10. P0SKIP: Port 0 Skip Bit 7 6 5 4 3 Name P0SKIP[7:0] Type R/W Reset 0 0 0 0 0 SFR Address = 0xD4 Bit Name 7:0 P0SKIP[7:0] 2 1 0 0 0 0 Function Port 0 Crossbar Skip Enable Bits. These bits select Port 0 pins to be skipped by the Crossbar Decoder. Port pins used for analog, special functions or GPIO should be skipped by the Crossbar. 0: Corresponding P0.n pin is not skipped by the Crossbar. 1: Corresponding P0.n pin is skipped by the Crossbar. Rev.1.0 133 C8051F336/7/8/9 SFR Definition 20.11. P1: Port 1 Bit 7 6 5 4 Name P1[7:0] Type R/W Reset 1 1 1 1 SFR Address = 0x90; Bit Addressable Bit Name Description 7:0 P1[7:0] Port 1 Data. Sets the Port latch logic value or reads the Port pin logic state in Port cells configured for digital I/O. 3 2 1 0 1 1 1 1 Write Read 0: Set output latch to logic LOW. 1: Set output latch to logic HIGH. 0: P1.n Port pin is logic LOW. 1: P1.n Port pin is logic HIGH. SFR Definition 20.12. P1MDIN: Port 1 Input Mode Bit 7 6 5 4 3 Name P1MDIN[7:0] Type R/W Reset 1 1 1 1 SFR Address = 0xF2 Bit Name 7:0 P1MDIN[7:0] 1 2 1 0 1 1 1 Function Analog Configuration Bits for P1.7–P1.0 (respectively). Port pins configured for analog mode have their weak pullup, digital driver, and digital receiver disabled. 0: Corresponding P1.n pin is configured for analog mode. 1: Corresponding P1.n pin is not configured for analog mode. 134 Rev.1.0 C8051F336/7/8/9 SFR Definition 20.13. P1MDOUT: Port 1 Output Mode Bit 7 6 5 4 3 Name P1MDOUT[7:0] Type R/W Reset 0 0 0 0 0 SFR Address = 0xA5 Bit Name 2 1 0 0 0 0 Function 7:0 P1MDOUT[7:0] Output Configuration Bits for P1.7–P1.0 (respectively). These bits are ignored if the corresponding bit in register P1MDIN is logic 0. 0: Corresponding P1.n Output is open-drain. 1: Corresponding P1.n Output is push-pull. SFR Definition 20.14. P1SKIP: Port 1 Skip Bit 7 6 5 4 3 Name P1SKIP[7:0] Type R/W Reset 0 0 0 0 0 SFR Address = 0xD5 Bit Name 7:0 P1SKIP[7:0] 2 1 0 0 0 0 Function Port 1 Crossbar Skip Enable Bits. These bits select Port 1 pins to be skipped by the Crossbar Decoder. Port pins used for analog, special functions or GPIO should be skipped by the Crossbar. 0: Corresponding P1.n pin is not skipped by the Crossbar. 1: Corresponding P1.n pin is skipped by the Crossbar. Rev.1.0 135 C8051F336/7/8/9 SFR Definition 20.15. P2: Port 2 Bit 7 6 5 4 3 Type R R R Reset 0 0 0 0 1 1 R/W 1 SFR Address = 0xA0; Bit Addressable Bit Name Description UNUSED Unused. 4:0 1 P2[4:0] Name 7:5 2 P2[4:0] Port 2 Data. Sets the Port latch logic value or reads the Port pin logic state in Port cells configured for digital I/O. 1 1 Write Read Don’t Care 000b 0: Set output latch to logic LOW. 1: Set output latch to logic HIGH. 0: P2.n Port pin is logic LOW. 1: P2.n Port pin is logic HIGH. Note: Pins P2.1-P2.4 are only available in QFN24-packaged devices. SFR Definition 20.16. P2MDIN: Port 2 Input Mode Bit 7 6 5 4 3 1 0 P2MDIN[7:0] Name Type R R R R Reset 0 0 0 0 SFR Address = 0xF3 Bit Name 7:4 3:0 2 UNUSED P2MDIN[3:0] R/W 1 1 1 1 Function Unused. Read = 0000b; Write = Don’t Care Analog Configuration Bits for P2.3–P2.0 (respectively). Port pins configured for analog mode have their weak pullup, digital driver, and digital receiver disabled. 0: Corresponding P2.n pin is configured for analog mode. 1: Corresponding P2.n pin is not configured for analog mode. Note: Pins P2.1-P2.4 are only available in QFN24-packaged devices. 136 Rev.1.0 C8051F336/7/8/9 SFR Definition 20.17. P2MDOUT: Port 2 Output Mode Bit 7 6 5 4 3 2 1 0 0 0 P2MDOUT[4:0] Name Type R R R Reset 0 0 0 R/W 0 0 SFR Address = 0xA6 Bit Name 0 Function 7:5 UNUSED Unused. Read = 000b; Write = Don’t Care 4:0 P2MDOUT[4:0] Output Configuration Bits for P2.4–P2.0 (respectively). These bits are ignored if the corresponding bit in register P2MDIN is logic 0. 0: Corresponding P2.n Output is open-drain. 1: Corresponding P2.n Output is push-pull. Note: P2.0 is not available for analog input in the QFN20-packaged devices, and P2.1-P2.4 are only available in the QFN24-packaged devices. SFR Definition 20.18. P2SKIP: Port 2 Skip Bit 7 6 5 4 3 1 0 P2SKIP[7:0] Name Type R R R R Reset 0 0 0 0 R/W 0 SFR Address = 0xD6 Bit Name 7:4 3:0 2 UNUSED P2SKIP[3:0] 0 0 0 Function Unused. Read = 0000b; Write = Don’t Care Port 2 Crossbar Skip Enable Bits. These bits select Port 2 pins to be skipped by the Crossbar Decoder. Port pins used for analog, special functions or GPIO should be skipped by the Crossbar. 0: Corresponding P2.n pin is not skipped by the Crossbar. 1: Corresponding P2.n pin is skipped by the Crossbar. Note: P2.0 is not available for crossbar peripherals in the QFN20-packaged devices, and P2.1-P2.4 are only available in the QFN24-packaged devices. Rev.1.0 137 C8051F336/7/8/9 21. SMBus The SMBus I/O interface is a two-wire, bi-directional serial bus. The SMBus is compliant with the System Management Bus Specification, version 1.1, and compatible with the I2C serial bus. Reads and writes to the interface by the system controller are byte oriented with the SMBus interface autonomously controlling the serial transfer of the data. Data can be transferred at up to 1/20th of the system clock as a master or slave (this can be faster than allowed by the SMBus specification, depending on the system clock used). A method of extending the clock-low duration is available to accommodate devices with different speed capabilities on the same bus. The SMBus interface may operate as a master and/or slave, and may function on a bus with multiple masters. The SMBus provides control of SDA (serial data), SCL (serial clock) generation and synchronization, arbitration logic, and START/STOP control and generation. The SMBus peripheral can be fully driven by software (i.e., software accepts/rejects slave addresses, and generates ACKs), or hardware slave address recognition and automatic ACK generation can be enabled to minimize software overhead. A block diagram of the SMBus peripheral and the associated SFRs is shown in Figure 21.1. SMB0CN M T S S A A A S A X T T C RC I SMAOK B K T O R L E D QO R E S T SMB0CF E I B E S S S S N N U XMMMM S H S T B B B B M Y H T F C C B OO T S S L E E 1 0 D SMBUS CONTROL LOGIC Arbitration SCL Synchronization SCL Generation (Master Mode) SDA Control Hardware Slave Address Recognition Hardware ACK Generation Data Path IRQ Generation Control Interrupt Request 00 T0 Overflow 01 T1 Overflow 10 TMR2H Overflow 11 TMR2L Overflow SCL Control S L V 5 S L V 4 S L V 3 S L V 2 S L V 1 SMB0ADR SG L C V 0 S S S S S S S L L L L L L L V V V V V V V MMMMMMM 6 5 4 3 2 1 0 SMB0ADM C R O S S B A R N SDA Control SMB0DAT 7 6 5 4 3 2 1 0 S L V 6 SCL FILTER Port I/O SDA FILTER E H A C K N Figure 21.1. SMBus Block Diagram Rev.1.0 138 C8051F336/7/8/9 21.1. Supporting Documents It is assumed the reader is familiar with or has access to the following supporting documents: 1. The I2C-Bus and How to Use It (including specifications), Philips Semiconductor. 2. The I2C-Bus Specification—Version 2.0, Philips Semiconductor. 3. System Management Bus Specification—Version 1.1, SBS Implementers Forum. 21.2. SMBus Configuration Figure 21.2 shows a typical SMBus configuration. The SMBus specification allows any recessive voltage between 3.0 V and 5.0 V; different devices on the bus may operate at different voltage levels. The bi-directional SCL (serial clock) and SDA (serial data) lines must be connected to a positive power supply voltage through a pullup resistor or similar circuit. Every device connected to the bus must have an open-drain or open-collector output for both the SCL and SDA lines, so that both are pulled high (recessive state) when the bus is free. The maximum number of devices on the bus is limited only by the requirement that the rise and fall times on the bus not exceed 300 ns and 1000 ns, respectively. VDD = 5V VDD = 3V VDD = 5V VDD = 3V Master Device Slave Device 1 Slave Device 2 SDA SCL Figure 21.2. Typical SMBus Configuration 21.3. SMBus Operation Two types of data transfers are possible: data transfers from a master transmitter to an addressed slave receiver (WRITE), and data transfers from an addressed slave transmitter to a master receiver (READ). The master device initiates both types of data transfers and provides the serial clock pulses on SCL. The SMBus interface may operate as a master or a slave, and multiple master devices on the same bus are supported. If two or more masters attempt to initiate a data transfer simultaneously, an arbitration scheme is employed with a single master always winning the arbitration. Note that it is not necessary to specify one device as the Master in a system; any device who transmits a START and a slave address becomes the master for the duration of that transfer. A typical SMBus transaction consists of a START condition followed by an address byte (Bits7–1: 7-bit slave address; Bit0: R/W direction bit), one or more bytes of data, and a STOP condition. Bytes that are received (by a master or slave) are acknowledged (ACK) with a low SDA during a high SCL (see Figure 21.3). If the receiving device does not ACK, the transmitting device will read a NACK (not acknowledge), which is a high SDA during a high SCL. The direction bit (R/W) occupies the least-significant bit position of the address byte. The direction bit is set to logic 1 to indicate a "READ" operation and cleared to logic 0 to indicate a "WRITE" operation. 139 Rev.1.0 C8051F336/7/8/9 All transactions are initiated by a master, with one or more addressed slave devices as the target. The master generates the START condition and then transmits the slave address and direction bit. If the transaction is a WRITE operation from the master to the slave, the master transmits the data a byte at a time waiting for an ACK from the slave at the end of each byte. For READ operations, the slave transmits the data waiting for an ACK from the master at the end of each byte. At the end of the data transfer, the master generates a STOP condition to terminate the transaction and free the bus. Figure 21.3 illustrates a typical SMBus transaction. SCL SDA SLA6 START SLA5-0 Slave Address + R/W R/W D7 ACK D6-0 Data Byte NACK STOP Figure 21.3. SMBus Transaction 21.3.1. Transmitter Vs. Receiver On the SMBus communications interface, a device is the “transmitter” when it is sending an address or data byte to another device on the bus. A device is a “receiver” when an address or data byte is being sent to it from another device on the bus. The transmitter controls the SDA line during the address or data byte. After each byte of address or data information is sent by the transmitter, the receiver sends an ACK or NACK bit during the ACK phase of the transfer, during which time the receiver controls the SDA line. 21.3.2. Arbitration A master may start a transfer only if the bus is free. The bus is free after a STOP condition or after the SCL and SDA lines remain high for a specified time (see Section “21.3.5. SCL High (SMBus Free) Timeout” on page 141). In the event that two or more devices attempt to begin a transfer at the same time, an arbitration scheme is employed to force one master to give up the bus. The master devices continue transmitting until one attempts a HIGH while the other transmits a LOW. Since the bus is open-drain, the bus will be pulled LOW. The master attempting the HIGH will detect a LOW SDA and lose the arbitration. The winning master continues its transmission without interruption; the losing master becomes a slave and receives the rest of the transfer if addressed. This arbitration scheme is non-destructive: one device always wins, and no data is lost. 21.3.3. Clock Low Extension SMBus provides a clock synchronization mechanism, similar to I2C, which allows devices with different speed capabilities to coexist on the bus. A clock-low extension is used during a transfer in order to allow slower slave devices to communicate with faster masters. The slave may temporarily hold the SCL line LOW to extend the clock low period, effectively decreasing the serial clock frequency. 21.3.4. SCL Low Timeout If the SCL line is held low by a slave device on the bus, no further communication is possible. Furthermore, the master cannot force the SCL line high to correct the error condition. To solve this problem, the SMBus protocol specifies that devices participating in a transfer must detect any clock cycle held low longer than 25 ms as a “timeout” condition. Devices that have detected the timeout condition must reset the communication no later than 10 ms after detecting the timeout condition. Rev.1.0 140 C8051F336/7/8/9 When the SMBTOE bit in SMB0CF is set, Timer 3 is used to detect SCL low timeouts. Timer 3 is forced to reload when SCL is high, and allowed to count when SCL is low. With Timer 3 enabled and configured to overflow after 25 ms (and SMBTOE set), the Timer 3 interrupt service routine can be used to reset (disable and re-enable) the SMBus in the event of an SCL low timeout. 21.3.5. SCL High (SMBus Free) Timeout The SMBus specification stipulates that if the SCL and SDA lines remain high for more that 50 µs, the bus is designated as free. When the SMBFTE bit in SMB0CF is set, the bus will be considered free if SCL and SDA remain high for more than 10 SMBus clock source periods (as defined by the timer configured for the SMBus clock source). If the SMBus is waiting to generate a Master START, the START will be generated following this timeout. A clock source is required for free timeout detection, even in a slave-only implementation. 21.4. Using the SMBus The SMBus can operate in both Master and Slave modes. The interface provides timing and shifting control for serial transfers; higher level protocol is determined by user software. The SMBus interface provides the following application-independent features:         Byte-wise serial data transfers Clock signal generation on SCL (Master Mode only) and SDA data synchronization Timeout/bus error recognition, as defined by the SMB0CF configuration register START/STOP timing, detection, and generation Bus arbitration Interrupt generation Status information Optional hardware recognition of slave address and automatic acknowledgement of address/data SMBus interrupts are generated for each data byte or slave address that is transferred. When hardware acknowledgement is disabled, the point at which the interrupt is generated depends on whether the hardware is acting as a data transmitter or receiver. When a transmitter (i.e., sending address/data, receiving an ACK), this interrupt is generated after the ACK cycle so that software may read the received ACK value; when receiving data (i.e., receiving address/data, sending an ACK), this interrupt is generated before the ACK cycle so that software may define the outgoing ACK value. If hardware acknowledgement is enabled, these interrupts are always generated after the ACK cycle. See Section 21.5 for more details on transmission sequences. Interrupts are also generated to indicate the beginning of a transfer when a master (START generated), or the end of a transfer when a slave (STOP detected). Software should read the SMB0CN (SMBus Control register) to find the cause of the SMBus interrupt. The SMB0CN register is described in Section 21.4.2; Table 21.5 provides a quick SMB0CN decoding reference. 21.4.1. SMBus Configuration Register The SMBus Configuration register (SMB0CF) is used to enable the SMBus Master and/or Slave modes, select the SMBus clock source, and select the SMBus timing and timeout options. When the ENSMB bit is set, the SMBus is enabled for all master and slave events. Slave events may be disabled by setting the INH bit. With slave events inhibited, the SMBus interface will still monitor the SCL and SDA pins; however, the interface will NACK all received addresses and will not generate any slave interrupts. When the INH bit is set, all slave events will be inhibited following the next START (interrupts will continue for the duration of the current transfer). 141 Rev.1.0 C8051F336/7/8/9 Table 21.1. SMBus Clock Source Selection SMBCS1 SMBCS0 SMBus Clock Source 0 0 1 1 0 1 0 1 Timer 0 Overflow Timer 1 Overflow Timer 2 High Byte Overflow Timer 2 Low Byte Overflow The SMBCS1–0 bits select the SMBus clock source, which is used only when operating as a master or when the Free Timeout detection is enabled. When operating as a master, overflows from the selected source determine the absolute minimum SCL low and high times as defined in Equation 21.1. Note that the selected clock source may be shared by other peripherals so long as the timer is left running at all times. For example, Timer 1 overflows may generate the SMBus and UART baud rates simultaneously. Timer configuration is covered in Section “24. Timers” on page 180. 1 T HighMin = T LowMin = ---------------------------------------------f ClockSourceOverflow Equation 21.1. Minimum SCL High and Low Times The selected clock source should be configured to establish the minimum SCL High and Low times as per Equation 21.1. When the interface is operating as a master (and SCL is not driven or extended by any other devices on the bus), the typical SMBus bit rate is approximated by Equation 21.2. f ClockSourceOverflow BitRate = ---------------------------------------------3 Equation 21.2. Typical SMBus Bit Rate Figure 21.4 shows the typical SCL generation described by Equation 21.2. Notice that THIGH is typically twice as large as TLOW. The actual SCL output may vary due to other devices on the bus (SCL may be extended low by slower slave devices, or driven low by contending master devices). The bit rate when operating as a master will never exceed the limits defined by equation Equation 21.1. Timer Source Overflows SCL TLow SCL High Timeout THigh Figure 21.4. Typical SMBus SCL Generation Setting the EXTHOLD bit extends the minimum setup and hold times for the SDA line. The minimum SDA setup time defines the absolute minimum time that SDA is stable before SCL transitions from low-to-high. The minimum SDA hold time defines the absolute minimum time that the current SDA value remains stable Rev.1.0 142 C8051F336/7/8/9 after SCL transitions from high-to-low. EXTHOLD should be set so that the minimum setup and hold times meet the SMBus Specification requirements of 250 ns and 300 ns, respectively. Table 21.2 shows the minimum setup and hold times for the two EXTHOLD settings. Setup and hold time extensions are typically necessary when SYSCLK is above 10 MHz. Table 21.2. Minimum SDA Setup and Hold Times EXTHOLD 0 1 Minimum SDA Setup Time Tlow – 4 system clocks or 1 system clock + s/w delay* 11 system clocks Minimum SDA Hold Time 3 system clocks 12 system clocks Note: Setup Time for ACK bit transmissions and the MSB of all data transfers. When using software acknowledgement, the s/w delay occurs between the time SMB0DAT or ACK is written and when SI is cleared. Note that if SI is cleared in the same write that defines the outgoing ACK value, s/w delay is zero. With the SMBTOE bit set, Timer 3 should be configured to overflow after 25 ms in order to detect SCL low timeouts (see Section “21.3.4. SCL Low Timeout” on page 140). The SMBus interface will force Timer 3 to reload while SCL is high, and allow Timer 3 to count when SCL is low. The Timer 3 interrupt service routine should be used to reset SMBus communication by disabling and re-enabling the SMBus. SMBus Free Timeout detection can be enabled by setting the SMBFTE bit. When this bit is set, the bus will be considered free if SDA and SCL remain high for more than 10 SMBus clock source periods (see Figure 21.4). 143 Rev.1.0 C8051F336/7/8/9 SFR Definition 21.1. SMB0CF: SMBus Clock/Configuration Bit 7 6 5 4 Name ENSMB INH BUSY Type R/W R/W R R/W Reset 0 0 0 0 3 EXTHOLD SMBTOE SFR Address = 0xC1 Bit Name 7 ENSMB 2 1 0 SMBFTE SMBCS[1:0] R/W R/W R/W 0 0 0 0 Function SMBus Enable. This bit enables the SMBus interface when set to 1. When enabled, the interface constantly monitors the SDA and SCL pins. 6 INH SMBus Slave Inhibit. When this bit is set to logic 1, the SMBus does not generate an interrupt when slave events occur. This effectively removes the SMBus slave from the bus. Master Mode interrupts are not affected. 5 BUSY SMBus Busy Indicator. This bit is set to logic 1 by hardware when a transfer is in progress. It is cleared to logic 0 when a STOP or free-timeout is sensed. 4 EXTHOLD SMBus Setup and Hold Time Extension Enable. This bit controls the SDA setup and hold times according to Table 21.2. 0: SDA Extended Setup and Hold Times disabled. 1: SDA Extended Setup and Hold Times enabled. 3 SMBTOE SMBus SCL Timeout Detection Enable. This bit enables SCL low timeout detection. If set to logic 1, the SMBus forces Timer 3 to reload while SCL is high and allows Timer 3 to count when SCL goes low. If Timer 3 is configured to Split Mode, only the High Byte of the timer is held in reload while SCL is high. Timer 3 should be programmed to generate interrupts at 25 ms, and the Timer 3 interrupt service routine should reset SMBus communication. 2 SMBFTE SMBus Free Timeout Detection Enable. When this bit is set to logic 1, the bus will be considered free if SCL and SDA remain high for more than 10 SMBus clock source periods. 1:0 SMBCS[1:0] SMBus Clock Source Selection. These two bits select the SMBus clock source, which is used to generate the SMBus bit rate. The selected device should be configured according to Equation 21.1. 00: Timer 0 Overflow 01: Timer 1 Overflow 10: Timer 2 High Byte Overflow 11: Timer 2 Low Byte Overflow Rev.1.0 144 C8051F336/7/8/9 21.4.2. SMB0CN Control Register SMB0CN is used to control the interface and to provide status information (see SFR Definition 21.2). The higher four bits of SMB0CN (MASTER, TXMODE, STA, and STO) form a status vector that can be used to jump to service routines. MASTER indicates whether a device is the master or slave during the current transfer. TXMODE indicates whether the device is transmitting or receiving data for the current byte. STA and STO indicate that a START and/or STOP has been detected or generated since the last SMBus interrupt. STA and STO are also used to generate START and STOP conditions when operating as a master. Writing a 1 to STA will cause the SMBus interface to enter Master Mode and generate a START when the bus becomes free (STA is not cleared by hardware after the START is generated). Writing a 1 to STO while in Master Mode will cause the interface to generate a STOP and end the current transfer after the next ACK cycle. If STO and STA are both set (while in Master Mode), a STOP followed by a START will be generated. The ARBLOST bit indicates that the interface has lost an arbitration. This may occur anytime the interface is transmitting (master or slave). A lost arbitration while operating as a slave indicates a bus error condition. ARBLOST is cleared by hardware each time SI is cleared. The SI bit (SMBus Interrupt Flag) is set at the beginning and end of each transfer, after each byte frame, or when an arbitration is lost; see Table 21.3 for more details. Important Note About the SI Bit: The SMBus interface is stalled while SI is set; thus SCL is held low, and the bus is stalled until software clears SI. 21.4.2.1. Software ACK Generation When the EHACK bit in register SMB0ADM is cleared to 0, the firmware on the device must detect incoming slave addresses and ACK or NACK the slave address and incoming data bytes. As a receiver, writing the ACK bit defines the outgoing ACK value; as a transmitter, reading the ACK bit indicates the value received during the last ACK cycle. ACKRQ is set each time a byte is received, indicating that an outgoing ACK value is needed. When ACKRQ is set, software should write the desired outgoing value to the ACK bit before clearing SI. A NACK will be generated if software does not write the ACK bit before clearing SI. SDA will reflect the defined ACK value immediately following a write to the ACK bit; however SCL will remain low until SI is cleared. If a received slave address is not acknowledged, further slave events will be ignored until the next START is detected. 21.4.2.2. Hardware ACK Generation When the EHACK bit in register SMB0ADM is set to 1, automatic slave address recognition and ACK generation is enabled. More detail about automatic slave address recognition can be found in Section 21.4.3. As a receiver, the value currently specified by the ACK bit will be automatically sent on the bus during the ACK cycle of an incoming data byte. As a transmitter, reading the ACK bit indicates the value received on the last ACK cycle. The ACKRQ bit is not used when hardware ACK generation is enabled. If a received slave address is NACKed by hardware, further slave events will be ignored until the next START is detected, and no interrupt will be generated. Table 21.3 lists all sources for hardware changes to the SMB0CN bits. Refer to Table 21.5 for SMBus status decoding using the SMB0CN register. 145 Rev.1.0 C8051F336/7/8/9 SFR Definition 21.2. SMB0CN: SMBus Control Bit 7 6 5 4 3 2 1 0 Name MASTER TXMODE STA STO ACKRQ ARBLOST ACK SI Type R R R/W R/W R R R/W R/W Reset 0 0 0 0 0 0 0 0 SFR Address = 0xC0; Bit-Addressable Bit Name Description Read Write 7 MASTER SMBus Master/Slave Indicator. This read-only bit indicates when the SMBus is operating as a master. 0: SMBus operating in slave mode. 1: SMBus operating in master mode. N/A 6 TXMODE SMBus Transmit Mode Indicator. This read-only bit indicates when the SMBus is operating as a transmitter. 0: SMBus in Receiver Mode. 1: SMBus in Transmitter Mode. N/A 0: No Start generated. 1: When Configured as a Master, initiates a START or repeated START. 0: No STOP condition is transmitted. 1: When configured as a Master, causes a STOP condition to be transmitted after the next ACK cycle. Cleared by Hardware. N/A 5 STA SMBus Start Flag. 4 STO SMBus Stop Flag. 0: No Start or repeated Start detected. 1: Start or repeated Start detected. 0: No Stop condition detected. 1: Stop condition detected (if in Slave Mode) or pending (if in Master Mode). 3 ACKRQ SMBus Acknowledge Request. 0: No Ack requested 1: ACK requested 2 ARBLOST SMBus Arbitration Lost Indicator. 1 ACK 0 SI SMBus Acknowledge. 0: No arbitration error. 1: Arbitration Lost N/A 0: NACK received. 1: ACK received. 0: Send NACK 1: Send ACK SMBus Interrupt Flag. 0: No interrupt pending This bit is set by hardware 1: Interrupt Pending under the conditions listed in Table 15.3. SI must be cleared by software. While SI is set, SCL is held low and the SMBus is stalled. Rev.1.0 0: Clear interrupt, and initiate next state machine event. 1: Force interrupt. 146 C8051F336/7/8/9 Table 21.3. Sources for Hardware Changes to SMB0CN Bit MASTER Set by Hardware When:   A START is generated. START is generated.  SMB0DAT is written before the start of an SMBus frame.    A STOP is generated. Arbitration is lost. A START is detected. Arbitration is lost. SMB0DAT is not written before the start of an SMBus frame. Must be cleared by software.  A pending STOP is generated.  After each ACK cycle.  Each time SI is cleared.   TXMODE STA  STO   ACKRQ  ARBLOST   ACK     SI Cleared by Hardware When:    A START followed by an address byte is received. A STOP is detected while addressed as a slave. Arbitration is lost due to a detected STOP. A byte has been received and an ACK response value is needed (only when hardware ACK is not enabled). A repeated START is detected as a MASTER when STA is low (unwanted repeated START). SCL is sensed low while attempting to generate a STOP or repeated START condition. SDA is sensed low while transmitting a 1 (excluding ACK bits). The incoming ACK value is low (ACKNOWLEDGE). A START has been generated. Lost arbitration. A byte has been transmitted and an ACK/NACK received. A byte has been received. A START or repeated START followed by a slave address + R/W has been received. A STOP has been received.    The incoming ACK value is high (NOT ACKNOWLEDGE).  Must be cleared by software. 21.4.3. Hardware Slave Address Recognition The SMBus hardware has the capability to automatically recognize incoming slave addresses and send an ACK without software intervention. Automatic slave address recognition is enabled by setting the EHACK bit in register SMB0ADM to 1. This will enable both automatic slave address recognition and automatic hardware ACK generation for received bytes (as a master or slave). More detail on automatic hardware ACK generation can be found in Section 21.4.2.2. The registers used to define which address(es) are recognized by the hardware are the SMBus Slave Address register (SFR Definition 21.3) and the SMBus Slave Address Mask register (SFR Definition 21.4). A single address or range of addresses (including the General Call Address 0x00) can be specified using these two registers. The most-significant seven bits of the two registers are used to define which addresses will be ACKed. A 1 in bit positions of the slave address mask SLVM[6:0] enable a comparison between the received slave address and the hardware’s slave address SLV[6:0] for those bits. A 0 in a bit 147 Rev.1.0 C8051F336/7/8/9 of the slave address mask means that bit will be treated as a “don’t care” for comparison purposes. In this case, either a 1 or a 0 value are acceptable on the incoming slave address. Additionally, if the GC bit in register SMB0ADR is set to 1, hardware will recognize the General Call Address (0x00). Table 21.4 shows some example parameter settings and the slave addresses that will be recognized by hardware under those conditions. Table 21.4. Hardware Address Recognition Examples (EHACK = 1) Hardware Slave Address SLV[6:0] Slave Address Mask SLVM[6:0] GC bit Slave Addresses Recognized by Hardware 0x34 0x34 0x34 0x34 0x70 0x7F 0x7F 0x7E 0x7E 0x73 0 1 0 1 0 0x34 0x34, 0x00 (General Call) 0x34, 0x35 0x34, 0x35, 0x00 (General Call) 0x70, 0x74, 0x78, 0x7C SFR Definition 21.3. SMB0ADR: SMBus Slave Address Bit 7 6 5 4 3 2 1 0 Name SLV[6:0] GC Type R/W R/W Reset 0 0 0 0 0 SFR Address = 0xD7 Bit Name 7:1 SLV[6:0] 0 0 0 Function SMBus Hardware Slave Address. Defines the SMBus Slave Address(es) for automatic hardware acknowledgement. Only address bits which have a 1 in the corresponding bit position in SLVM[6:0] are checked against the incoming address. This allows multiple addresses to be recognized. 0 GC General Call Address Enable. When hardware address recognition is enabled (EHACK = 1), this bit will determine whether the General Call Address (0x00) is also recognized by hardware. 0: General Call Address is ignored. 1: General Call Address is recognized. Rev.1.0 148 C8051F336/7/8/9 SFR Definition 21.4. SMB0ADM: SMBus Slave Address Mask Bit 7 6 5 4 3 2 1 0 Name SLVM[6:0] EHACK Type R/W R/W Reset 1 1 1 1 SFR Address = 0xE7 Bit Name 7:1 SLVM[6:0] 1 1 1 0 Function SMBus Slave Address Mask. Defines which bits of register SMB0ADR are compared with an incoming address byte, and which bits are ignored. Any bit set to 1 in SLVM[6:0] enables comparisons with the corresponding bit in SLV[6:0]. Bits set to 0 are ignored (can be either 0 or 1 in the incoming address). 0 EHACK Hardware Acknowledge Enable. Enables hardware acknowledgement of slave address and received data bytes. 0: Firmware must manually acknowledge all incoming address and data bytes. 1: Automatic Slave Address Recognition and Hardware Acknowledge is Enabled. 149 Rev.1.0 C8051F336/7/8/9 21.4.4. Data Register The SMBus Data register SMB0DAT holds a byte of serial data to be transmitted or one that has just been received. Software may safely read or write to the data register when the SI flag is set. Software should not attempt to access the SMB0DAT register when the SMBus is enabled and the SI flag is cleared to logic 0, as the interface may be in the process of shifting a byte of data into or out of the register. Data in SMB0DAT is always shifted out MSB first. After a byte has been received, the first bit of received data is located at the MSB of SMB0DAT. While data is being shifted out, data on the bus is simultaneously being shifted in. SMB0DAT always contains the last data byte present on the bus. In the event of lost arbitration, the transition from master transmitter to slave receiver is made with the correct data or address in SMB0DAT. SFR Definition 21.5. SMB0DAT: SMBus Data Bit 7 6 5 4 3 Name SMB0DAT[7:0] Type R/W Reset 0 0 SFR Address = 0xC2 Bit Name 0 0 0 2 1 0 0 0 0 Function 7:0 SMB0DAT[7:0] SMBus Data. The SMB0DAT register contains a byte of data to be transmitted on the SMBus serial interface or a byte that has just been received on the SMBus serial interface. The CPU can read from or write to this register whenever the SI serial interrupt flag (SMB0CN.0) is set to logic 1. The serial data in the register remains stable as long as the SI flag is set. When the SI flag is not set, the system may be in the process of shifting data in/out and the CPU should not attempt to access this register. Rev.1.0 150 C8051F336/7/8/9 21.5. SMBus Transfer Modes The SMBus interface may be configured to operate as master and/or slave. At any particular time, it will be operating in one of the following four modes: Master Transmitter, Master Receiver, Slave Transmitter, or Slave Receiver. The SMBus interface enters Master Mode any time a START is generated, and remains in Master Mode until it loses an arbitration or generates a STOP. An SMBus interrupt is generated at the end of all SMBus byte frames. Note that the position of the ACK interrupt when operating as a receiver depends on whether hardware ACK generation is enabled. As a receiver, the interrupt for an ACK occurs before the ACK with hardware ACK generation disabled, and after the ACK when hardware ACK generation is enabled. As a transmitter, interrupts occur after the ACK, regardless of whether hardware ACK generation is enabled or not. 21.5.1. Write Sequence (Master) During a write sequence, an SMBus master writes data to a slave device. The master in this transfer will be a transmitter during the address byte, and a transmitter during all data bytes. The SMBus interface generates the START condition and transmits the first byte containing the address of the target slave and the data direction bit. In this case the data direction bit (R/W) will be logic 0 (WRITE). The master then transmits one or more bytes of serial data. After each byte is transmitted, an acknowledge bit is generated by the slave. The transfer is ended when the STO bit is set and a STOP is generated. Note that the interface will switch to Master Receiver Mode if SMB0DAT is not written following a Master Transmitter interrupt. Figure 21.5 shows a typical master write sequence. Two transmit data bytes are shown, though any number of bytes may be transmitted. Notice that all of the “data byte transferred” interrupts occur after the ACK cycle in this mode, regardless of whether hardware ACK generation is enabled. Interrupts with Hardware ACK Enabled (EHACK = 1) S SLA W A Data Byte A Data Byte A Interrupts with Hardware ACK Disabled (EHACK = 0) S = START P = STOP A = ACK W = WRITE SLA = Slave Address Received by SMBus Interface Transmitted by SMBus Interface Figure 21.5. Typical Master Write Sequence 151 Rev.1.0 P C8051F336/7/8/9 21.5.2. Read Sequence (Master) During a read sequence, an SMBus master reads data from a slave device. The master in this transfer will be a transmitter during the address byte, and a receiver during all data bytes. The SMBus interface generates the START condition and transmits the first byte containing the address of the target slave and the data direction bit. In this case the data direction bit (R/W) will be logic 1 (READ). Serial data is then received from the slave on SDA while the SMBus outputs the serial clock. The slave transmits one or more bytes of serial data. If hardware ACK generation is disabled, the ACKRQ is set to 1 and an interrupt is generated after each received byte. Software must write the ACK bit at that time to ACK or NACK the received byte. With hardware ACK generation enabled, the SMBus hardware will automatically generate the ACK/NACK, and then post the interrupt. It is important to note that the appropriate ACK or NACK value should be set up by the software prior to receiving the byte when hardware ACK generation is enabled. Writing a 1 to the ACK bit generates an ACK; writing a 0 generates a NACK. Software should write a 0 to the ACK bit for the last data transfer, to transmit a NACK. The interface exits Master Receiver Mode after the STO bit is set and a STOP is generated. The interface will switch to Master Transmitter Mode if SMB0DAT is written while an active Master Receiver. Figure 21.6 shows a typical master read sequence. Two received data bytes are shown, though any number of bytes may be received. Notice that the ‘data byte transferred’ interrupts occur at different places in the sequence, depending on whether hardware ACK generation is enabled. The interrupt occurs before the ACK with hardware ACK generation disabled, and after the ACK when hardware ACK generation is enabled. Interrupts with Hardware ACK Enabled (EHACK = 1) S SLA R A Data Byte A Data Byte N P Interrupts with Hardware ACK Disabled (EHACK = 0) S = START P = STOP A = ACK N = NACK R = READ SLA = Slave Address Received by SMBus Interface Transmitted by SMBus Interface Figure 21.6. Typical Master Read Sequence Rev.1.0 152 C8051F336/7/8/9 21.5.3. Write Sequence (Slave) During a write sequence, an SMBus master writes data to a slave device. The slave in this transfer will be a receiver during the address byte, and a receiver during all data bytes. When slave events are enabled (INH = 0), the interface enters Slave Receiver Mode when a START followed by a slave address and direction bit (WRITE in this case) is received. If hardware ACK generation is disabled, upon entering Slave Receiver Mode, an interrupt is generated and the ACKRQ bit is set. The software must respond to the received slave address with an ACK, or ignore the received slave address with a NACK. If hardware ACK generation is enabled, the hardware will apply the ACK for a slave address which matches the criteria set up by SMB0ADR and SMB0ADM. The interrupt will occur after the ACK cycle. If the received slave address is ignored (by software or hardware), slave interrupts will be inhibited until the next START is detected. If the received slave address is acknowledged, zero or more data bytes are received. If hardware ACK generation is disabled, the ACKRQ is set to 1 and an interrupt is generated after each received byte. Software must write the ACK bit at that time to ACK or NACK the received byte. With hardware ACK generation enabled, the SMBus hardware will automatically generate the ACK/NACK, and then post the interrupt. It is important to note that the appropriate ACK or NACK value should be set up by the software prior to receiving the byte when hardware ACK generation is enabled. The interface exits Slave Receiver Mode after receiving a STOP. Note that the interface will switch to Slave Transmitter Mode if SMB0DAT is written while an active Slave Receiver. Figure 21.7 shows a typical slave write sequence. Two received data bytes are shown, though any number of bytes may be received. Notice that the ‘data byte transferred’ interrupts occur at different places in the sequence, depending on whether hardware ACK generation is enabled. The interrupt occurs before the ACK with hardware ACK generation disabled, and after the ACK when hardware ACK generation is enabled. Interrupts with Hardware ACK Enabled (EHACK = 1) S SLA W A Data Byte A Data Byte A P Interrupts with Hardware ACK Disabled (EHACK = 0) S = START P = STOP A = ACK W = WRITE SLA = Slave Address Received by SMBus Interface Transmitted by SMBus Interface Figure 21.7. Typical Slave Write Sequence 153 Rev.1.0 C8051F336/7/8/9 21.5.4. Read Sequence (Slave) During a read sequence, an SMBus master reads data from a slave device. The slave in this transfer will be a receiver during the address byte, and a transmitter during all data bytes. When slave events are enabled (INH = 0), the interface enters Slave Receiver Mode (to receive the slave address) when a START followed by a slave address and direction bit (READ in this case) is received. If hardware ACK generation is disabled, upon entering Slave Receiver Mode, an interrupt is generated and the ACKRQ bit is set. The software must respond to the received slave address with an ACK, or ignore the received slave address with a NACK. If hardware ACK generation is enabled, the hardware will apply the ACK for a slave address which matches the criteria set up by SMB0ADR and SMB0ADM. The interrupt will occur after the ACK cycle. If the received slave address is ignored (by software or hardware), slave interrupts will be inhibited until the next START is detected. If the received slave address is acknowledged, zero or more data bytes are transmitted. If the received slave address is acknowledged, data should be written to SMB0DAT to be transmitted. The interface enters slave transmitter mode, and transmits one or more bytes of data. After each byte is transmitted, the master sends an acknowledge bit; if the acknowledge bit is an ACK, SMB0DAT should be written with the next data byte. If the acknowledge bit is a NACK, SMB0DAT should not be written to before SI is cleared (an error condition may be generated if SMB0DAT is written following a received NACK while in slave transmitter mode). The interface exits slave transmitter mode after receiving a STOP. Note that the interface will switch to slave receiver mode if SMB0DAT is not written following a Slave Transmitter interrupt. Figure 21.8 shows a typical slave read sequence. Two transmitted data bytes are shown, though any number of bytes may be transmitted. Notice that all of the “data byte transferred” interrupts occur after the ACK cycle in this mode, regardless of whether hardware ACK generation is enabled. Interrupts with Hardware ACK Enabled (EHACK = 1) S SLA R A Data Byte A Data Byte N P Interrupts with Hardware ACK Disabled (EHACK = 0) S = START P = STOP N = NACK R = READ SLA = Slave Address Received by SMBus Interface Transmitted by SMBus Interface Figure 21.8. Typical Slave Read Sequence 21.6. SMBus Status Decoding The current SMBus status can be easily decoded using the SMB0CN register. The appropriate actions to take in response to an SMBus event depend on whether hardware slave address recognition and ACK generation is enabled or disabled. Table 21.5 describes the typical actions when hardware slave address recognition and ACK generation is disabled. Table 21.6 describes the typical actions when hardware slave address recognition and ACK generation is enabled. In the tables, STATUS VECTOR refers to the four upper bits of SMB0CN: MASTER, TXMODE, STA, and STO. The shown response options are only the typical responses; application-specific procedures are allowed as long as they conform to the SMBus specification. Highlighted responses are allowed by hardware but do not conform to the SMBus specification. Rev.1.0 154 C8051F336/7/8/9 155 ARBLOST 0 0 X 0 0 1000 1 0 ACK STO 0 STA 1100 Typical Response Options ACK ACKRQ Vector Status Mode Master Receiver Master Transmitter 1110 Current SMbus State Vector Expected Values to Write Values Read Next Status Table 21.5. SMBus Status Decoding With Hardware ACK Generation Disabled (EHACK = 0) 0 0 X 1100 1 0 X 1110 0 1 X — Load next data byte into SMB0DAT. 0 0 X 1100 End transfer with STOP. 0 1 X — A master data or address byte End transfer with STOP and start 1 1 was transmitted; ACK another transfer. received. Send repeated START. 1 1 X — 0 X 1110 Switch to Master Receiver Mode 0 (clear SI without writing new data to SMB0DAT). 0 X 1000 Acknowledge received byte; Read SMB0DAT. 0 0 1 1000 Send NACK to indicate last byte, 0 and send STOP. 1 0 — Send NACK to indicate last byte, 1 and send STOP followed by START. 1 0 1110 Send ACK followed by repeated START. 1 0 1 1110 Send NACK to indicate last byte, 1 and send repeated START. 0 0 1110 Send ACK and switch to Master Transmitter Mode (write to SMB0DAT before clearing SI). 0 0 1 1100 Send NACK and switch to Master Transmitter Mode (write to SMB0DAT before clearing SI). 0 0 0 1100 A master START was generated. Load slave address + R/W into SMB0DAT. A master data or address byte Set STA to restart transfer. 0 was transmitted; NACK Abort transfer. received. 0 X A master data byte was received; ACK requested. Rev.1.0 C8051F336/7/8/9 ARBLOST ACK STA STO 0101 ACKRQ 0 0 0 A slave byte was transmitted; No action required (expecting NACK received. STOP condition). 0 0 X 0001 0 0 1 A slave byte was transmitted; Load SMB0DAT with next data ACK received. byte to transmit. 0 0 X 0100 0 1 X A Slave byte was transmitted; No action required (expecting error detected. Master to end transfer). 0 0 X 0001 0 0 X — 0 0 1 0000 If Read, Load SMB0DAT with 0 data byte; ACK received address 0 1 0100 NACK received address. 0 0 0 — If Write, Acknowledge received address 0 0 1 0000 If Read, Load SMB0DAT with 0 Lost arbitration as master; 1 X slave address + R/W received; data byte; ACK received address ACK requested. NACK received address. 0 0 1 0100 0 0 — 1 0 0 1110 0 0 X — Current SMbus State Typical Response Options An illegal STOP or bus error 0 X X was detected while a Slave Clear STO. Transmission was in progress. If Write, Acknowledge received address 1 0 X A slave address + R/W was received; ACK requested. Slave Receiver 0010 1 Reschedule failed transfer; NACK received address. 0 A STOP was detected while 0 X addressed as a Slave Transmitter or Slave Receiver. 1 1 X Lost arbitration while attempt- No action required (transfer ing a STOP. complete/aborted). 0 0 0 — Acknowledge received byte; Read SMB0DAT. 0 1 0000 0 X A slave byte was received; ACK requested. 0 1 NACK received byte. 0 0 0 — 0 0 X — 1 0 X 1110 Abort failed transfer. 0 0 X — 1110 0001 Bus Error Condition 0000 ACK Vector Status Mode Slave Transmitter 0100 Vector Expected Values to Write Values Read Next Status Table 21.5. SMBus Status Decoding With Hardware ACK Generation Disabled (EHACK = 0) (Continued) Clear STO. 0010 0 1 X Lost arbitration while attempt- Abort failed transfer. ing a repeated START. Reschedule failed transfer. 0001 0 1 X Lost arbitration due to a detected STOP. Reschedule failed transfer. 1 0 X 0 0 — 1 1 X Lost arbitration while transmit- Abort failed transfer. ting a data byte as master. Reschedule failed transfer. 0 0000 1 0 0 1110 Rev.1.0 156 C8051F336/7/8/9 ARBLOST 0 0 X 0 0 Master Receiver 0 0 ACK 0 0 X 1100 1 0 X 1110 0 1 X — Load next data byte into SMB0DAT. 0 0 X 1100 End transfer with STOP. 0 1 X — End transfer with STOP and start 1 A master data or address byte another transfer. 1 was transmitted; ACK Send repeated START. 1 received. Switch to Master Receiver Mode 0 (clear SI without writing new data to SMB0DAT). Set ACK for initial data byte. 1 X — 0 X 1110 0 1 1000 A master START was generated. 0 Load slave address + R/W into SMB0DAT. A master data or address byte Set STA to restart transfer. 0 was transmitted; NACK Abort transfer. received. 1 A master data byte was received; ACK sent. 1000 0 157 0 STO 0 STA 1100 Typical Response Options ACK ACKRQ Vector Status Mode Master Transmitter 1110 Current SMbus State Vector Expected Values to Write Values Read Next Status Table 21.6. SMBus Status Decoding With Hardware ACK Generation Enabled (EHACK = 1) A master data byte was 0 received; NACK sent (last byte). Set ACK for next data byte; Read SMB0DAT. 0 0 1 1000 Set NACK to indicate next data byte as the last data byte; Read SMB0DAT. 0 0 0 1000 Initiate repeated START. 1 0 0 1110 Switch to Master Transmitter 0 Mode (write to SMB0DAT before clearing SI). 0 X 1100 Read SMB0DAT; send STOP. 0 1 0 — Read SMB0DAT; Send STOP followed by START. 1 1 0 1110 Initiate repeated START. 1 0 0 1110 0 X 1100 Switch to Master Transmitter 0 Mode (write to SMB0DAT before clearing SI). Rev.1.0 C8051F336/7/8/9 ARBLOST ACK STA STO 0101 ACKRQ 0 0 0 A slave byte was transmitted; No action required (expecting NACK received. STOP condition). 0 0 X 0001 0 0 1 A slave byte was transmitted; Load SMB0DAT with next data ACK received. byte to transmit. 0 0 X 0100 0 1 X A Slave byte was transmitted; No action required (expecting error detected. Master to end transfer). 0 0 X 0001 0 0 X — If Write, Set ACK for first data byte. 0 0 1 0000 If Read, Load SMB0DAT with data byte 0 0 X 0100 If Write, Set ACK for first data byte. 0 0 1 0000 0 0 X 0100 1 0 X 1110 0 0 X — Lost arbitration while attempt- No action required (transfer ing a STOP. complete/aborted). 0 0 0 — Set ACK for next data byte; Read SMB0DAT. 0 0 1 0000 Set NACK for next data byte; Read SMB0DAT. 0 0 0 0000 0 0 X — 1 0 X 1110 Abort failed transfer. 0 0 X — Current SMbus State An illegal STOP or bus error 0 X X was detected while a Slave Clear STO. Transmission was in progress. 0 A slave address + R/W was 0 X received; ACK sent. Slave Receiver 0010 Bus Error Condition Typical Response Options 0 Lost arbitration as master; 1 X slave address + R/W received; If Read, Load SMB0DAT with ACK sent. data byte Reschedule failed transfer 0 A STOP was detected while 0 X addressed as a Slave Transmitter or Slave Receiver. 0 1 X 0001 ACK Vector Status Mode Slave Transmitter 0100 Vector Expected Values to Write Values Read Next Status Table 21.6. SMBus Status Decoding With Hardware ACK Generation Enabled (EHACK = 1) (Continued) Clear STO. 0000 0 0 X A slave byte was received. 0010 0 1 X Lost arbitration while attempt- Abort failed transfer. ing a repeated START. Reschedule failed transfer. 0001 0 1 X Lost arbitration due to a detected STOP. Reschedule failed transfer. 1 0 X 1110 0 X — 0 1 X Lost arbitration while transmit- Abort failed transfer. ting a data byte as master. Reschedule failed transfer. 0 0000 1 0 X 1110 Rev.1.0 158 C8051F336/7/8/9 22. UART0 UART0 is an asynchronous, full duplex serial port offering modes 1 and 3 of the standard 8051 UART. Enhanced baud rate support allows a wide range of clock sources to generate standard baud rates (details in Section “22.1. Enhanced Baud Rate Generation” on page 160). Received data buffering allows UART0 to start reception of a second incoming data byte before software has finished reading the previous data byte. UART0 has two associated SFRs: Serial Control Register 0 (SCON0) and Serial Data Buffer 0 (SBUF0). The single SBUF0 location provides access to both transmit and receive registers. Writes to SBUF0 always access the Transmit register. Reads of SBUF0 always access the buffered Receive register; it is not possible to read data from the Transmit register. With UART0 interrupts enabled, an interrupt is generated each time a transmit is completed (TI0 is set in SCON0), or a data byte has been received (RI0 is set in SCON0). The UART0 interrupt flags are not cleared by hardware when the CPU vectors to the interrupt service routine. They must be cleared manually by software, allowing software to determine the cause of the UART0 interrupt (transmit complete or receive complete). SFR Bus Write to SBUF TB8 SBUF (TX Shift) SET D Q TX CLR Crossbar Zero Detector Stop Bit Shift Start Data Tx Control Tx Clock Send Tx IRQ SCON TI Serial Port Interrupt MCE REN TB8 RB8 TI RI SMODE UART Baud Rate Generator Port I/O RI Rx IRQ Rx Clock Rx Control Start Shift 0x1FF Load SBUF RB8 Input Shift Register (9 bits) Load SBUF SBUF (RX Latch) Read SBUF SFR Bus RX Crossbar Figure 22.1. UART0 Block Diagram Rev.1.0 159 C8051F336/7/8/9 22.1. Enhanced Baud Rate Generation The UART0 baud rate is generated by Timer 1 in 8-bit auto-reload mode. The TX clock is generated by TL1; the RX clock is generated by a copy of TL1 (shown as RX Timer in Figure 22.2), which is not useraccessible. Both TX and RX Timer overflows are divided by two to generate the TX and RX baud rates. The RX Timer runs when Timer 1 is enabled, and uses the same reload value (TH1). However, an RX Timer reload is forced when a START condition is detected on the RX pin. This allows a receive to begin any time a START is detected, independent of the TX Timer state. Timer 1 TL1 UART Overflow 2 TX Clock Overflow 2 RX Clock TH1 Start Detected RX Timer Figure 22.2. UART0 Baud Rate Logic Timer 1 should be configured for Mode 2, 8-bit auto-reload (see Section “24.1.3. Mode 2: 8-bit Counter/Timer with Auto-Reload” on page 184). The Timer 1 reload value should be set so that overflows will occur at two times the desired UART baud rate frequency. Note that Timer 1 may be clocked by one of six sources: SYSCLK, SYSCLK/4, SYSCLK/12, SYSCLK/48, the external oscillator clock/8, or an external input T1. For any given Timer 1 clock source, the UART0 baud rate is determined by Equation 22.1-A and Equation 22.1-B. A) 1 UartBaudRate = --- × T1_Overflow_Rate 2 B) T1 CLK T1_Overflow_Rate = -------------------------256 – TH1 Equation 22.1. UART0 Baud Rate Where T1CLK is the frequency of the clock supplied to Timer 1, and T1H is the high byte of Timer 1 (reload value). Timer 1 clock frequency is selected as described in Section “24. Timers” on page 180. A quick reference for typical baud rates and system clock frequencies is given in Table 22.1 through Table 22.2. The internal oscillator may still generate the system clock when the external oscillator is driving Timer 1. 160 Rev.1.0 C8051F336/7/8/9 22.2. Operational Modes UART0 provides standard asynchronous, full duplex communication. The UART mode (8-bit or 9-bit) is selected by the S0MODE bit (SCON0.7). Typical UART connection options are shown in Figure 22.3. TX RS-232 LEVEL XLTR RS-232 RX C8051xxxx OR TX TX RX RX MCU C8051xxxx Figure 22.3. UART Interconnect Diagram 22.2.1. 8-Bit UART 8-Bit UART mode uses a total of 10 bits per data byte: one start bit, eight data bits (LSB first), and one stop bit. Data are transmitted LSB first from the TX0 pin and received at the RX0 pin. On receive, the eight data bits are stored in SBUF0 and the stop bit goes into RB80 (SCON0.2). Data transmission begins when software writes a data byte to the SBUF0 register. The TI0 Transmit Interrupt Flag (SCON0.1) is set at the end of the transmission (the beginning of the stop-bit time). Data reception can begin any time after the REN0 Receive Enable bit (SCON0.4) is set to logic 1. After the stop bit is received, the data byte will be loaded into the SBUF0 receive register if the following conditions are met: RI0 must be logic 0, and if MCE0 is logic 1, the stop bit must be logic 1. In the event of a receive data overrun, the first received 8 bits are latched into the SBUF0 receive register and the following overrun data bits are lost. If these conditions are met, the eight bits of data is stored in SBUF0, the stop bit is stored in RB80 and the RI0 flag is set. If these conditions are not met, SBUF0 and RB80 will not be loaded and the RI0 flag will not be set. An interrupt will occur if enabled when either TI0 or RI0 is set. MARK SPACE START BIT D0 D1 D2 D3 D4 D5 D6 D7 STOP BIT BIT TIMES BIT SAMPLING Figure 22.4. 8-Bit UART Timing Diagram Rev.1.0 161 C8051F336/7/8/9 22.2.2. 9-Bit UART 9-bit UART mode uses a total of eleven bits per data byte: a start bit, 8 data bits (LSB first), a programmable ninth data bit, and a stop bit. The state of the ninth transmit data bit is determined by the value in TB80 (SCON0.3), which is assigned by user software. It can be assigned the value of the parity flag (bit P in register PSW) for error detection, or used in multiprocessor communications. On receive, the ninth data bit goes into RB80 (SCON0.2) and the stop bit is ignored. Data transmission begins when an instruction writes a data byte to the SBUF0 register. The TI0 Transmit Interrupt Flag (SCON0.1) is set at the end of the transmission (the beginning of the stop-bit time). Data reception can begin any time after the REN0 Receive Enable bit (SCON0.4) is set to 1. After the stop bit is received, the data byte will be loaded into the SBUF0 receive register if the following conditions are met: (1) RI0 must be logic 0, and (2) if MCE0 is logic 1, the 9th bit must be logic 1 (when MCE0 is logic 0, the state of the ninth data bit is unimportant). If these conditions are met, the eight bits of data are stored in SBUF0, the ninth bit is stored in RB80, and the RI0 flag is set to 1. If the above conditions are not met, SBUF0 and RB80 will not be loaded and the RI0 flag will not be set to 1. A UART0 interrupt will occur if enabled when either TI0 or RI0 is set to 1. MARK SPACE START BIT D0 D1 D2 D3 D4 D5 D6 BIT TIMES BIT SAMPLING Figure 22.5. 9-Bit UART Timing Diagram 162 Rev.1.0 D7 D8 STOP BIT C8051F336/7/8/9 22.3. Multiprocessor Communications 9-Bit UART mode supports multiprocessor communication between a master processor and one or more slave processors by special use of the ninth data bit. When a master processor wants to transmit to one or more slaves, it first sends an address byte to select the target(s). An address byte differs from a data byte in that its ninth bit is logic 1; in a data byte, the ninth bit is always set to logic 0. Setting the MCE0 bit (SCON0.5) of a slave processor configures its UART such that when a stop bit is received, the UART will generate an interrupt only if the ninth bit is logic 1 (RB80 = 1) signifying an address byte has been received. In the UART interrupt handler, software will compare the received address with the slave's own assigned 8-bit address. If the addresses match, the slave will clear its MCE0 bit to enable interrupts on the reception of the following data byte(s). Slaves that weren't addressed leave their MCE0 bits set and do not generate interrupts on the reception of the following data bytes, thereby ignoring the data. Once the entire message is received, the addressed slave resets its MCE0 bit to ignore all transmissions until it receives the next address byte. Multiple addresses can be assigned to a single slave and/or a single address can be assigned to multiple slaves, thereby enabling "broadcast" transmissions to more than one slave simultaneously. The master processor can be configured to receive all transmissions or a protocol can be implemented such that the master/slave role is temporarily reversed to enable half-duplex transmission between the original master and slave(s). Master Device Slave Device Slave Device Slave Device V+ RX TX RX TX RX TX RX TX Figure 22.6. UART Multi-Processor Mode Interconnect Diagram Rev.1.0 163 C8051F336/7/8/9 SFR Definition 22.1. SCON0: Serial Port 0 Control Bit 7 6 Name S0MODE Type R/W Reset 0 5 4 3 2 1 0 MCE0 REN0 TB80 RB80 TI0 RI0 R R/W R/W R/W R/W R/W R/W 1 0 0 0 0 0 0 SFR Address = 0x98; Bit-Addressable Bit Name 7 6 5 Function S0MODE Serial Port 0 Operation Mode. Selects the UART0 Operation Mode. 0: 8-bit UART with Variable Baud Rate. 1: 9-bit UART with Variable Baud Rate. Unused MCE0 Unused. Read = 1b, Write = Don’t Care. Multiprocessor Communication Enable. The function of this bit is dependent on the Serial Port 0 Operation Mode: Mode 0: Checks for valid stop bit. 0: Logic level of stop bit is ignored. 1: RI0 will only be activated if stop bit is logic level 1. Mode 1: Multiprocessor Communications Enable. 0: Logic level of ninth bit is ignored. 1: RI0 is set and an interrupt is generated only when the ninth bit is logic 1. 4 REN0 Receive Enable. 0: UART0 reception disabled. 1: UART0 reception enabled. 3 TB80 Ninth Transmission Bit. The logic level of this bit will be sent as the ninth transmission bit in 9-bit UART Mode (Mode 1). Unused in 8-bit mode (Mode 0). 2 RB80 Ninth Receive Bit. RB80 is assigned the value of the STOP bit in Mode 0; it is assigned the value of the 9th data bit in Mode 1. 1 TI0 Transmit Interrupt Flag. Set by hardware when a byte of data has been transmitted by UART0 (after the 8th bit in 8-bit UART Mode, or at the beginning of the STOP bit in 9-bit UART Mode). When the UART0 interrupt is enabled, setting this bit causes the CPU to vector to the UART0 interrupt service routine. This bit must be cleared manually by software. 0 RI0 Receive Interrupt Flag. Set to 1 by hardware when a byte of data has been received by UART0 (set at the STOP bit sampling time). When the UART0 interrupt is enabled, setting this bit to 1 causes the CPU to vector to the UART0 interrupt service routine. This bit must be cleared manually by software. 164 Rev.1.0 C8051F336/7/8/9 SFR Definition 22.2. SBUF0: Serial (UART0) Port Data Buffer Bit 7 6 5 4 3 Name SBUF0[7:0] Type R/W Reset 0 0 SFR Address = 0x99 Bit Name 7:0 0 0 0 2 1 0 0 0 0 Function SBUF0[7:0] Serial Data Buffer Bits 7–0 (MSB–LSB). This SFR accesses two registers; a transmit shift register and a receive latch register. When data is written to SBUF0, it goes to the transmit shift register and is held for serial transmission. Writing a byte to SBUF0 initiates the transmission. A read of SBUF0 returns the contents of the receive latch. Rev.1.0 165 C8051F336/7/8/9 Table 22.1. Timer Settings for Standard Baud Rates Using The Internal 24.5 MHz Oscillator Internal Osc. SYSCLK from Frequency: 24.5 MHz Target Baud Rate (bps) Baud Rate % Error 230400 115200 57600 28800 14400 9600 2400 1200 –0.32% –0.32% 0.15% –0.32% 0.15% –0.32% –0.32% 0.15% Oscillator Timer Clock Divide Source Factor 106 212 426 848 1704 2544 10176 20448 SCA1–SCA0 (pre-scale select)1 T1M1 Timer 1 Reload Value (hex) XX2 XX XX 01 00 00 10 10 1 1 1 0 0 0 0 0 0xCB 0x96 0x2B 0x96 0xB9 0x96 0x96 0x2B SCA1–SCA0 (pre-scale select)1 T1M1 Timer 1 Reload Value (hex) XX2 XX XX 00 00 00 10 10 11 11 11 11 11 11 1 1 1 0 0 0 0 0 0 0 0 0 0 0 0xD0 0xA0 0x40 0xE0 0xC0 0xA0 0xA0 0x40 0xFA 0xF4 0xE8 0xD0 0xA0 0x70 SYSCLK SYSCLK SYSCLK SYSCLK/4 SYSCLK/12 SYSCLK/12 SYSCLK/48 SYSCLK/48 Notes: 1. SCA1–SCA0 and T1M bit definitions can be found in Section 24.1. 2. X = Don’t care. Table 22.2. Timer Settings for Standard Baud Rates Using an External 22.1184 MHz Oscillator SYSCLK from External Osc. SYSCLK from Internal Osc. Frequency: 22.1184 MHz Target Baud Rate (bps) Baud Rate % Error 230400 115200 57600 28800 14400 9600 2400 1200 230400 115200 57600 28800 14400 9600 0.00% 0.00% 0.00% 0.00% 0.00% 0.00% 0.00% 0.00% 0.00% 0.00% 0.00% 0.00% 0.00% 0.00% Oscillator Timer Clock Divide Source Factor 96 192 384 768 1536 2304 9216 18432 96 192 384 768 1536 2304 SYSCLK SYSCLK SYSCLK SYSCLK / 12 SYSCLK / 12 SYSCLK / 12 SYSCLK / 48 SYSCLK / 48 EXTCLK / 8 EXTCLK / 8 EXTCLK / 8 EXTCLK / 8 EXTCLK / 8 EXTCLK / 8 Notes: 1. SCA1–SCA0 and T1M bit definitions can be found in Section 24.1. 2. X = Don’t care. 166 Rev.1.0 C8051F336/7/8/9 23. Enhanced Serial Peripheral Interface (SPI0) The Enhanced Serial Peripheral Interface (SPI0) provides access to a flexible, full-duplex synchronous serial bus. SPI0 can operate as a master or slave device in both 3-wire or 4-wire modes, and supports multiple masters and slaves on a single SPI bus. The slave-select (NSS) signal can be configured as an input to select SPI0 in slave mode, or to disable Master Mode operation in a multi-master environment, avoiding contention on the SPI bus when more than one master attempts simultaneous data transfers. NSS can also be configured as a chip-select output in master mode, or disabled for 3-wire operation. Additional general purpose port I/O pins can be used to select multiple slave devices in master mode. SFR Bus SYSCLK SPI0CN SPIF WCOL MODF RXOVRN NSSMD1 NSSMD0 TXBMT SPIEN SPI0CFG SPIBSY MSTEN CKPHA CKPOL SLVSEL NSSIN SRMT RXBMT SCR7 SCR6 SCR5 SCR4 SCR3 SCR2 SCR1 SCR0 SPI0CKR Clock Divide Logic SPI CONTROL LOGIC Data Path Control SPI IRQ Pin Interface Control MOSI Tx Data SPI0DAT SCK Transmit Data Buffer Shift Register 7 6 5 4 3 2 1 0 Rx Data Pin Control Logic Receive Data Buffer MISO C R O S S B A R Port I/O NSS Read SPI0DAT Write SPI0DAT SFR Bus Figure 23.1. SPI Block Diagram Rev.1.0 167 C8051F336/7/8/9 23.1. Signal Descriptions The four signals used by SPI0 (MOSI, MISO, SCK, NSS) are described below. 23.1.1. Master Out, Slave In (MOSI) The master-out, slave-in (MOSI) signal is an output from a master device and an input to slave devices. It is used to serially transfer data from the master to the slave. This signal is an output when SPI0 is operating as a master and an input when SPI0 is operating as a slave. Data is transferred most-significant bit first. When configured as a master, MOSI is driven by the MSB of the shift register in both 3- and 4-wire mode. 23.1.2. Master In, Slave Out (MISO) The master-in, slave-out (MISO) signal is an output from a slave device and an input to the master device. It is used to serially transfer data from the slave to the master. This signal is an input when SPI0 is operating as a master and an output when SPI0 is operating as a slave. Data is transferred most-significant bit first. The MISO pin is placed in a high-impedance state when the SPI module is disabled and when the SPI operates in 4-wire mode as a slave that is not selected. When acting as a slave in 3-wire mode, MISO is always driven by the MSB of the shift register. 23.1.3. Serial Clock (SCK) The serial clock (SCK) signal is an output from the master device and an input to slave devices. It is used to synchronize the transfer of data between the master and slave on the MOSI and MISO lines. SPI0 generates this signal when operating as a master. The SCK signal is ignored by a SPI slave when the slave is not selected (NSS = 1) in 4-wire slave mode. 23.1.4. Slave Select (NSS) The function of the slave-select (NSS) signal is dependent on the setting of the NSSMD1 and NSSMD0 bits in the SPI0CN register. There are three possible modes that can be selected with these bits: 1. NSSMD[1:0] = 00: 3-Wire Master or 3-Wire Slave Mode: SPI0 operates in 3-wire mode, and NSS is disabled. When operating as a slave device, SPI0 is always selected in 3-wire mode. Since no select signal is present, SPI0 must be the only slave on the bus in 3-wire mode. This is intended for point-topoint communication between a master and one slave. 2. NSSMD[1:0] = 01: 4-Wire Slave or Multi-Master Mode: SPI0 operates in 4-wire mode, and NSS is enabled as an input. When operating as a slave, NSS selects the SPI0 device. When operating as a master, a 1-to-0 transition of the NSS signal disables the master function of SPI0 so that multiple master devices can be used on the same SPI bus. 3. NSSMD[1:0] = 1x: 4-Wire Master Mode: SPI0 operates in 4-wire mode, and NSS is enabled as an output. The setting of NSSMD0 determines what logic level the NSS pin will output. This configuration should only be used when operating SPI0 as a master device. See Figure 23.2, Figure 23.3, and Figure 23.4 for typical connection diagrams of the various operational modes. Note that the setting of NSSMD bits affects the pinout of the device. When in 3-wire master or 3-wire slave mode, the NSS pin will not be mapped by the crossbar. In all other modes, the NSS signal will be mapped to a pin on the device. See Section “20. Port Input/Output” on page 119 for general purpose port I/O and crossbar information. 168 Rev.1.0 C8051F336/7/8/9 23.2. SPI0 Master Mode Operation A SPI master device initiates all data transfers on a SPI bus. SPI0 is placed in master mode by setting the Master Enable flag (MSTEN, SPI0CN.6). Writing a byte of data to the SPI0 data register (SPI0DAT) when in master mode writes to the transmit buffer. If the SPI shift register is empty, the byte in the transmit buffer is moved to the shift register, and a data transfer begins. The SPI0 master immediately shifts out the data serially on the MOSI line while providing the serial clock on SCK. The SPIF (SPI0CN.7) flag is set to logic 1 at the end of the transfer. If interrupts are enabled, an interrupt request is generated when the SPIF flag is set. While the SPI0 master transfers data to a slave on the MOSI line, the addressed SPI slave device simultaneously transfers the contents of its shift register to the SPI master on the MISO line in a full-duplex operation. Therefore, the SPIF flag serves as both a transmit-complete and receive-data-ready flag. The data byte received from the slave is transferred MSB-first into the master's shift register. When a byte is fully shifted into the register, it is moved to the receive buffer where it can be read by the processor by reading SPI0DAT. When configured as a master, SPI0 can operate in one of three different modes: multi-master mode, 3-wire single-master mode, and 4-wire single-master mode. The default, multi-master mode is active when NSSMD1 (SPI0CN.3) = 0 and NSSMD0 (SPI0CN.2) = 1. In this mode, NSS is an input to the device, and is used to disable the master SPI0 when another master is accessing the bus. When NSS is pulled low in this mode, MSTEN (SPI0CN.6) and SPIEN (SPI0CN.0) are set to 0 to disable the SPI master device, and a Mode Fault is generated (MODF, SPI0CN.5 = 1). Mode Fault will generate an interrupt if enabled. SPI0 must be manually re-enabled in software under these circumstances. In multi-master systems, devices will typically default to being slave devices while they are not acting as the system master device. In multi-master mode, slave devices can be addressed individually (if needed) using general-purpose I/O pins. Figure 23.2 shows a connection diagram between two master devices in multiple-master mode. 3-wire single-master mode is active when NSSMD1 (SPI0CN.3) = 0 and NSSMD0 (SPI0CN.2) = 0. In this mode, NSS is not used, and is not mapped to an external port pin through the crossbar. Any slave devices that must be addressed in this mode should be selected using general-purpose I/O pins. Figure 23.3 shows a connection diagram between a master device in 3-wire master mode and a slave device. 4-wire single-master mode is active when NSSMD1 (SPI0CN.3) = 1. In this mode, NSS is configured as an output pin, and can be used as a slave-select signal for a single SPI device. In this mode, the output value of NSS is controlled (in software) with the bit NSSMD0 (SPI0CN.2). Additional slave devices can be addressed using general-purpose I/O pins. Figure 23.4 shows a connection diagram for a master device in 4-wire master mode and two slave devices. Master Device 1 NSS GPIO MISO MISO MOSI MOSI SCK SCK GPIO NSS Master Device 2 Figure 23.2. Multiple-Master Mode Connection Diagram Rev.1.0 169 C8051F336/7/8/9 Master Device MISO MISO MOSI MOSI SCK SCK Slave Device Figure 23.3. 3-Wire Single Master and 3-Wire Single Slave Mode Connection Diagram Master Device GPIO MISO MISO MOSI MOSI SCK SCK NSS NSS MISO MOSI Slave Device Slave Device SCK NSS Figure 23.4. 4-Wire Single Master Mode and 4-Wire Slave Mode Connection Diagram 23.3. SPI0 Slave Mode Operation When SPI0 is enabled and not configured as a master, it will operate as a SPI slave. As a slave, bytes are shifted in through the MOSI pin and out through the MISO pin by a master device controlling the SCK signal. A bit counter in the SPI0 logic counts SCK edges. When 8 bits have been shifted through the shift register, the SPIF flag is set to logic 1, and the byte is copied into the receive buffer. Data is read from the receive buffer by reading SPI0DAT. A slave device cannot initiate transfers. Data to be transferred to the master device is pre-loaded into the shift register by writing to SPI0DAT. Writes to SPI0DAT are doublebuffered, and are placed in the transmit buffer first. If the shift register is empty, the contents of the transmit buffer will immediately be transferred into the shift register. When the shift register already contains data, the SPI will load the shift register with the transmit buffer’s contents after the last SCK edge of the next (or current) SPI transfer. When configured as a slave, SPI0 can be configured for 4-wire or 3-wire operation. The default, 4-wire slave mode, is active when NSSMD1 (SPI0CN.3) = 0 and NSSMD0 (SPI0CN.2) = 1. In 4-wire mode, the NSS signal is routed to a port pin and configured as a digital input. SPI0 is enabled when NSS is logic 0, and disabled when NSS is logic 1. The bit counter is reset on a falling edge of NSS. Note that the NSS signal must be driven low at least 2 system clocks before the first active edge of SCK for each byte transfer. Figure 23.4 shows a connection diagram between two slave devices in 4-wire slave mode and a master device. 170 Rev.1.0 C8051F336/7/8/9 3-wire slave mode is active when NSSMD1 (SPI0CN.3) = 0 and NSSMD0 (SPI0CN.2) = 0. NSS is not used in this mode, and is not mapped to an external port pin through the crossbar. Since there is no way of uniquely addressing the device in 3-wire slave mode, SPI0 must be the only slave device present on the bus. It is important to note that in 3-wire slave mode there is no external means of resetting the bit counter that determines when a full byte has been received. The bit counter can only be reset by disabling and reenabling SPI0 with the SPIEN bit. Figure 23.3 shows a connection diagram between a slave device in 3wire slave mode and a master device. 23.4. SPI0 Interrupt Sources When SPI0 interrupts are enabled, the following four flags will generate an interrupt when they are set to logic 1: All of the following bits must be cleared by software.  The SPI Interrupt Flag, SPIF (SPI0CN.7) is set to logic 1 at the end of each byte transfer. This flag can occur in all SPI0 modes.  The Write Collision Flag, WCOL (SPI0CN.6) is set to logic 1 if a write to SPI0DAT is attempted when the transmit buffer has not been emptied to the SPI shift register. When this occurs, the write to SPI0DAT will be ignored, and the transmit buffer will not be written.This flag can occur in all SPI0 modes.  The Mode Fault Flag MODF (SPI0CN.5) is set to logic 1 when SPI0 is configured as a master, and for multi-master mode and the NSS pin is pulled low. When a Mode Fault occurs, the MSTEN and SPIEN bits in SPI0CN are set to logic 0 to disable SPI0 and allow another master device to access the bus.  The Receive Overrun Flag RXOVRN (SPI0CN.4) is set to logic 1 when configured as a slave, and a transfer is completed and the receive buffer still holds an unread byte from a previous transfer. The new byte is not transferred to the receive buffer, allowing the previously received data byte to be read. The data byte which caused the overrun is lost. 23.5. Serial Clock Phase and Polarity Four combinations of serial clock phase and polarity can be selected using the clock control bits in the SPI0 Configuration Register (SPI0CFG). The CKPHA bit (SPI0CFG.5) selects one of two clock phases (edge used to latch the data). The CKPOL bit (SPI0CFG.4) selects between an active-high or active-low clock. Both master and slave devices must be configured to use the same clock phase and polarity. SPI0 should be disabled (by clearing the SPIEN bit, SPI0CN.0) when changing the clock phase or polarity. The clock and data line relationships for master mode are shown in Figure 23.5. For slave mode, the clock and data relationships are shown in Figure 23.6 and Figure 23.7. Note that CKPHA should be set to 0 on both the master and slave SPI when communicating between two Silicon Labs C8051 devices. The SPI0 Clock Rate Register (SPI0CKR) as shown in SFR Definition 23.3 controls the master mode serial clock frequency. This register is ignored when operating in slave mode. When the SPI is configured as a master, the maximum data transfer rate (bits/sec) is one-half the system clock frequency or 12.5 MHz, whichever is slower. When the SPI is configured as a slave, the maximum data transfer rate (bits/sec) for full-duplex operation is 1/10 the system clock frequency, provided that the master issues SCK, NSS (in 4wire slave mode), and the serial input data synchronously with the slave’s system clock. If the master issues SCK, NSS, and the serial input data asynchronously, the maximum data transfer rate (bits/sec) must be less than 1/10 the system clock frequency. In the special case where the master only wants to transmit data to the slave and does not need to receive data from the slave (i.e. half-duplex operation), the SPI slave can receive data at a maximum data transfer rate (bits/sec) of 1/4 the system clock frequency. This is provided that the master issues SCK, NSS, and the serial input data synchronously with the slave’s system clock. Rev.1.0 171 C8051F336/7/8/9 SCK (CKPOL=0, CKPHA=0) SCK (CKPOL=0, CKPHA=1) SCK (CKPOL=1, CKPHA=0) SCK (CKPOL=1, CKPHA=1) MISO/MOSI MSB Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 NSS (Must Remain High in Multi-Master Mode) Figure 23.5. Master Mode Data/Clock Timing SCK (CKPOL=0, CKPHA=0) SCK (CKPOL=1, CKPHA=0) MOSI MSB Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 MISO MSB Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 NSS (4-Wire Mode) Figure 23.6. Slave Mode Data/Clock Timing (CKPHA = 0) 172 Rev.1.0 C8051F336/7/8/9 SCK (CKPOL=0, CKPHA=1) SCK (CKPOL=1, CKPHA=1) MOSI MSB Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 MISO MSB Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 Bit 0 NSS (4-Wire Mode) Figure 23.7. Slave Mode Data/Clock Timing (CKPHA = 1) 23.6. SPI Special Function Registers SPI0 is accessed and controlled through four special function registers in the system controller: SPI0CN Control Register, SPI0DAT Data Register, SPI0CFG Configuration Register, and SPI0CKR Clock Rate Register. The four special function registers related to the operation of the SPI0 Bus are described in the following figures. Rev.1.0 173 C8051F336/7/8/9 SFR Definition 23.1. SPI0CFG: SPI0 Configuration Bit 7 6 5 4 3 2 1 0 Name SPIBSY MSTEN CKPHA CKPOL SLVSEL NSSIN SRMT RXBMT Type R R/W R/W R/W R R R R Reset 0 0 0 0 0 1 1 1 SFR Address = 0xA1 Bit Name 7 SPIBSY Function SPI Busy. This bit is set to logic 1 when a SPI transfer is in progress (master or slave mode). 6 MSTEN Master Mode Enable. 0: Disable master mode. Operate in slave mode. 1: Enable master mode. Operate as a master. 5 CKPHA SPI0 Clock Phase. 0: Data centered on first edge of SCK period.* 1: Data centered on second edge of SCK period.* 4 CKPOL SPI0 Clock Polarity. 0: SCK line low in idle state. 1: SCK line high in idle state. 3 SLVSEL Slave Selected Flag. This bit is set to logic 1 whenever the NSS pin is low indicating SPI0 is the selected slave. It is cleared to logic 0 when NSS is high (slave not selected). This bit does not indicate the instantaneous value at the NSS pin, but rather a de-glitched version of the pin input. 2 NSSIN NSS Instantaneous Pin Input. This bit mimics the instantaneous value that is present on the NSS port pin at the time that the register is read. This input is not de-glitched. 1 SRMT Shift Register Empty (valid in slave mode only). This bit will be set to logic 1 when all data has been transferred in/out of the shift register, and there is no new information available to read from the transmit buffer or write to the receive buffer. It returns to logic 0 when a data byte is transferred to the shift register from the transmit buffer or by a transition on SCK. SRMT = 1 when in Master Mode. 0 RXBMT Receive Buffer Empty (valid in slave mode only). This bit will be set to logic 1 when the receive buffer has been read and contains no new information. If there is new information available in the receive buffer that has not been read, this bit will return to logic 0. RXBMT = 1 when in Master Mode. Note: In slave mode, data on MOSI is sampled in the center of each data bit. In master mode, data on MISO is sampled one SYSCLK before the end of each data bit, to provide maximum settling time for the slave device. See Table 23.1 for timing parameters. 174 Rev.1.0 C8051F336/7/8/9 SFR Definition 23.2. SPI0CN: SPI0 Control Bit 7 6 5 4 Name SPIF WCOL MODF RXOVRN Type R/W R/W R/W R/W Reset 0 0 0 0 SFR Address = 0xF8; Bit-Addressable Bit Name 7 SPIF 3 2 1 0 NSSMD[1:0] TXBMT SPIEN R/W R R/W 1 0 0 1 Function SPI0 Interrupt Flag. This bit is set to logic 1 by hardware at the end of a data transfer. If SPI interrupts are enabled, an interrupt will be generated. This bit is not automatically cleared by hardware, and must be cleared by software. 6 WCOL Write Collision Flag. This bit is set to logic 1 if a write to SPI0DAT is attempted when TXBMT is 0. When this occurs, the write to SPI0DAT will be ignored, and the transmit buffer will not be written. If SPI interrupts are enabled, an interrupt will be generated. This bit is not automatically cleared by hardware, and must be cleared by software. 5 MODF Mode Fault Flag. This bit is set to logic 1 by hardware when a master mode collision is detected (NSS is low, MSTEN = 1, and NSSMD[1:0] = 01). If SPI interrupts are enabled, an interrupt will be generated. This bit is not automatically cleared by hardware, and must be cleared by software. 4 RXOVRN Receive Overrun Flag (valid in slave mode only). This bit is set to logic 1 by hardware when the receive buffer still holds unread data from a previous transfer and the last bit of the current transfer is shifted into the SPI0 shift register. If SPI interrupts are enabled, an interrupt will be generated. This bit is not automatically cleared by hardware, and must be cleared by software. 3:2 NSSMD[1:0] Slave Select Mode. Selects between the following NSS operation modes: (See Section 23.2 and Section 23.3). 00: 3-Wire Slave or 3-Wire Master Mode. NSS signal is not routed to a port pin. 01: 4-Wire Slave or Multi-Master Mode (Default). NSS is an input to the device. 1x: 4-Wire Single-Master Mode. NSS signal is mapped as an output from the device and will assume the value of NSSMD0. 1 TXBMT Transmit Buffer Empty. This bit will be set to logic 0 when new data has been written to the transmit buffer. When data in the transmit buffer is transferred to the SPI shift register, this bit will be set to logic 1, indicating that it is safe to write a new byte to the transmit buffer. 0 SPIEN SPI0 Enable. 0: SPI disabled. 1: SPI enabled. Rev.1.0 175 C8051F336/7/8/9 SFR Definition 23.3. SPI0CKR: SPI0 Clock Rate Bit 7 6 5 4 Name SCR[7:0] Type R/W Reset 0 0 0 0 SFR Address = 0xA2 Bit Name 7:0 SCR[7:0] 3 2 1 0 0 0 0 0 Function SPI0 Clock Rate. These bits determine the frequency of the SCK output when the SPI0 module is configured for master mode operation. The SCK clock frequency is a divided version of the system clock, and is given in the following equation, where SYSCLK is the system clock frequency and SPI0CKR is the 8-bit value held in the SPI0CKR register. SYSCLK f SCK = ----------------------------------------------------------2 × ( SPI0CKR[7:0] + 1 ) for 0