|
|
| (204 intermediate revisions by 33 users not shown) |
| Line 1: |
Line 1: |
| − | <a href=http://volleyballwebsite.info/japan-volleyball/>japan volleyball</a>
| + | This project aims to provide the development tools for building a [[Multi-purpose_Embedded_System | multi-purpose MCU board]]. Description is based on Microchip dsPic33FJ256GP506 (was dsPic30F5011), but information provided in this wiki may give useful directions for developing similar embedded systems with different platforms. |
| | | | |
| − | <a href=http://volleyballwebsite.info/volleyball-club/club-fusion-volleyball.php>club fusion volleyball</a>
| + | ==Introduction== |
| | | | |
| − | | + | ===Features of dsPic33FJ256GP506=== |
| − |
| + | *3.0 to 3.3 V |
| − | <a href=http://volleyballwebsite.info/volleyball-club/club-volleyball-san-antonio.php>club volleyball san antonio</a>
| + | *Up to 40 MIPs |
| − | | + | *Maximum current sink/source for I/O pins: 4 mA |
| − | | + | *16-bit arithmetics |
| − | <a href=http://volleyballwebsite.info/womens-volleyball/ncaa-result-volleyball-womens.php>ncaa result volleyball womens</a>
| + | *DSP Instruction Set |
| − | | + | *Dual programming techniques: ICSP and RTSP |
| − | ==Software Architecture==
| + | *Memory |
| − | +----------+-----------+---------+---------+
| + | **256 KB flash (86K instructions) |
| − | | local | remote | | |
| + | **16 KB RAM (incl. 2 KB DMA RAM) |
| − | +----------+-----------+ host | UI |
| + | **No EEPROM |
| − | | data access | channel | |
| + | *Communications ports |
| − | | (DI,DO,AI,AO) | | |
| + | **UART |
| − | +----------------------+---------+---------+
| + | **I<sup>2</sup>C: up to 1 Mbit/s |
| − | | Application |
| + | **SPI |
| − | | |
| + | *ADC |
| − | +------------------------------------------+
| + | *10-bit A/D, 1.1 Msps |
| − | | Applications Model |
| + | *12-bit A/D, 500 ksps |
| − | | +--------------+-----------+ |
| + | *No DAC (PWMs only) |
| − | | | GUI | CLib | |
| + | *Pin-to-pin compatible with other dsPICs |
| − | | | +------+-----------+-------+
| |
| − | | | | Operating System |
| |
| − | +-------+-------+--------------------------+
| |
| − | | Drivers |
| |
| − | +------------------------------------------+
| |
| − | | Hardware |
| |
| − | +------------------------------------------+
| |
| − | *Currently, operating system is based on [http://www.psocdeveloper.com/forums/viewtopic.php?p=973&sid=717d6b7e86472a5036f7cfbbcb0c05aa linlike8]. The possibility of using other OS (e.g. [http://www.freertos.org/ FreeRTOS]) will be explored later. | |
| − | *Software Drivers are to be developed to allow users at Application Level to use the hardware (e.g. ADC, DAC, UART, EEPROM) through the OS. | |
| − | *The interface between the drivers and the OS should be compliant with [http://www.die.net/doc/linux/man/man2/ POSIX standard] for Linux (e.g. open(), write(), read(), ioctl() etc). | |
| − | | |
| − | | |
| − | ==Programming Tips==
| |
| − | | |
| − | ===Memory Map for 5011===
| |
| | {| border="1" cellspacing="0" cellpadding="5" | | {| border="1" cellspacing="0" cellpadding="5" |
| − | |+ Table 6.1 Memory Location | + | |+ Comparison between different dsPICs |
| − | ! Type !! Start Address !! End Address !! Size | + | ! dsPic !! *Price<br>US$ !! MIPs |
| − | |-valign="top" | + | ! Flash<br>(kB)!! RAM<br>(kB) !! EEPROM<br>(kB) |
| − | | Flash || 0x000000 ||0x00AFFF || 44K<sup>[1]</sup> | + | ! I/O !! ADC<br>12-bit !! IC !! OC !! Motor<br>Ctrl !! Timers |
| − | |-valign="top" | + | ! QEI !! UART !! SPI !! I2C !! CAN !! Codec |
| − | | +--Flash: Reset Vector || 0x000000 ||0x000003 || 4 | + | |- |
| − | |-valign="top" | + | | 33FJ256GP506 || 6.11 || 40 |
| − | | +--Flash: Interrupt Vector Table || 0x000004 ||0x00007F || 124 | + | | 256 || 16 || 0 |
| − | |-valign="top" | + | | 53 || 18 || 8 || 8 || 0 || 9x16bit<br>4x32bit |
| − | | +--Flash: Alternate Vector Table || 0x000084 ||0x0000FF || 124 | + | | 0 || 2 || 2 || 2 || 1 || 1 |
| − | |-valign="top" | + | |- |
| − | | +--Flash: User Program || 0x000100 ||0x00AFFF || 43.7K | + | | 33FJ128GP206 || 4.62 || 40 |
| − | |-valign="top" | + | | 128 || 8 || 0 |
| − | | EEPROM || 0x7FFC00 || 0x7FFFFF || 1K<sup>[2]</sup> | + | | 53 || 18 || 8 || 8 || 0 || 9x16bit<br>4x32bit |
| − | |-valign="top" | + | | 0 || 2 || 2 || 1 || 0 || 1 |
| − | | Programming Executive || 0x800000 || 0x8005BF || 1472 | + | |- |
| − | |-valign="top" | + | | 33FJ128GP306 || 4.81 || 40 |
| − | | Unit ID || 0x8005C0 || 0x8005FF || 64 | + | | 128 || 16 || 0 |
| − | |-valign="top" | + | | 53 || 18 || 8 || 8 || 0 || 9x16bit<br>4x32bit |
| − | | Config Registers || 0xF80000 || 0xF8000F || 16 | + | | 0 || 2 || 2 || 2 || 0 || 1 |
| − | |-valign="top" | + | |- |
| − | | Device ID || 0xFF0000 || 0xFF0003 || 4 | + | | 33FJ128GP706 || 5.49 || 40 |
| | + | | 128 || 16 || 0 |
| | + | | 53 || 18 || 8 || 8 || 0 || 9x16bit<br>4x32bit |
| | + | | 0 || 2 || 2 || 2 || 2 || 1 |
| | + | |- |
| | + | | 33FJ128MC506 || 4.97 || 40 |
| | + | | 128 || 8 || 0 |
| | + | | 53 || 16 || 8 || 8 || 8 || 9x16bit<br>4x32bit |
| | + | | 1 || 2 || 2 || 2 || 1 || 0 |
| | |- | | |- |
| − | |} | + | | 33FJ128MC706 || 5.38 || 40 |
| − | [1] Each address is 16-bit wide. Every two addresses correspond to a 24-bit instruction. Each even address contains 2 valid bytes; each odd address contains 1 valid byte plus 1 phathom byte.<br>
| + | | 128 || 16 || 0 |
| − | [2] Each address is 8-bit wide.
| + | | 53 || 16 || 8 || 8 || 8 || 9x16bit<br>4x32bit |
| − | | + | | 1 || 2 || 2 || 2 || 1 || 0 |
| − | ===Data Location===
| |
| − | {| border="1" cellspacing="0" cellpadding="5"
| |
| − | |+ Table 6.2 Data Location | |
| − | ! Type !! Description !! Example
| |
| − | |-valign="top" | |
| − | | _XBSS(N) <sup>[1]</sup> | |
| − | | RAM Data in X-memory, aligned at N, no initilization | |
| − | | int _XBSS(32) xbuf[16]; | |
| − | |-valign="top" | |
| − | | _XDATA(N) <sup>[1]</sup> | |
| − | | RAM Data in X-memory, aligned at N, with initilization
| |
| − | | int _XDATA(32) xbuf[] = {1, 2, 3, 4, 5}; | |
| − | |-valign="top"
| |
| − | | _YBSS(N) <sup>[1]</sup>
| |
| − | | RAM Data in Y-memory, aligned at N, no initilization | |
| − | | int _YBSS(32) ybuf[16]; | |
| − | |-valign="top" | |
| − | | _YDATA(N) <sup>[1]</sup> | |
| − | | RAM Data in Y-memory, aligned at N, with initilization | |
| − | | int _YDATA(32) ybuf[16] = {1, 2, 3, 4, 5}; | |
| − | |-valign="top" | |
| − | | __attribute__((space(const))) | |
| − | | Flash ROM data, constant, accessed by normal C<br>statements, but 32K max.
| |
| − | | int i __attribute__((space(const))) = 10; | |
| − | |-valign="top" | |
| − | | __attribute__((space(prog)))
| |
| − | | Flash ROM data, read/write by program space visibility<br>window (psv)
| |
| − | | int i __attribute__((space(prog))); | |
| − | |-valign="top" | |
| − | | __attribute__((space(auto_psv))) | |
| − | | Flash ROM data, read by normal C statements, write<br>by accessing psv
| |
| − | | int i __attribute__((space(auto_psv))); | |
| − | |-valign="top" | |
| − | | __attribute__((space(psv))) | |
| − | | Flash ROM data, read/write by (psv) | |
| − | | int i __attribute__((space(psv))); | |
| − | |-valign="top" | |
| − | | _EEDATA(N) <sup>[1]</sup>
| |
| − | | ROM Data in EEPROM, aligned at N, read/write with psv | |
| − | | int _EEDATA(2) table[]={0, 1, 2, 3, 5, 8}; | |
| − | |-valign="top"
| |
| − | | _PERSISTENT
| |
| − | | RAM Data, data remain after reset
| |
| − | | int _PERSISTENT var1, var2;
| |
| − | |-valign="top"
| |
| − | | _NEAR
| |
| − | | RAM Data at near section
| |
| − | | int _NEAR var1, var2;
| |
| − | |-valign="top"
| |
| − | | _ISR
| |
| − | | Interrupt service rountine
| |
| − | | void _ISR _INT0Interrupt(void);
| |
| − | |-valign="top"
| |
| − | | _ISRFAST
| |
| − | | Fast interrupt service rountine
| |
| − | | void _ISRFAST _T0Interrupt(void);
| |
| | |- | | |- |
| | |} | | |} |
| − | #N must be a power of two, with a minimum value of 2.
| + | <nowiki>*</nowiki>For reference only, subject to change |
| − | | |
| − | ===Configuration Bits===
| |
| − | ----
| |
| − | *System clock source can be provided by:
| |
| − | #Primary oscillator (OSC1, OSC2)
| |
| − | #Secondary oscillator (SOSCO and SOSCI) with 32kHz crystal
| |
| − | #Internal Fast RC (FRC) oscillator at 7.37MHz (7372800Hz)
| |
| − | #Low-Power RC (LPRC) oscillator (Watchdog Timer) at 512 kHz.
| |
| − | *These clock sources can be incorporated with interal Phase-locked-loop (PLL) x4, x8 or x16 to yield the osciallator frequrence F<sub>OSC</sub>
| |
| − | *The system clock is divided by 4 to yield the internal instruction cycle clock, F<sub>CY</sub>=F<sub>OSC</sub>/4
| |
| − | *FRC with PLLx16 is used to achieve F<sub>CY</sub>=29.49MHz (29491200Hz or 30MIPS)
| |
| − | | |
| − | //The code (MACRO) below is to be placed at the top of program (before main)
| |
| − | _FOSC(CSW_FSCM_OFF & FRC_PLL16);
| |
| − | _FWDT(WDT_OFF); //Turn off Watchdog Timer
| |
| − | _FBORPOR(PBOR_ON & BORV_27 & MCLR_DIS & PWRT_16);
| |
| − | _FGS(CODE_PROT_OFF); //Disable Code Protection
| |
| − | | |
| − | ===Timer===
| |
| − | | |
| − | ----
| |
| − | *Each timer is 16-bit (i.e. counting from 0 to 65535).
| |
| − | *Timer 2 and 3 can be incorporated together to form a 32-bit timer.
| |
| − | *Prescale is the ratio between timer counts and system clock counts. Prescales of 1:1, 1:8, 1:64 and 1:256 are available.
| |
| − | *Timers may be used to implement free time clock or mesaure time.
| |
| − | | |
| − | ====Free Time Clock====
| |
| − | *Let required time for ticking be PERIOD.
| |
| − | *Number of instruction cycles during PERIOD = PERIOD*F<sub>CY</sub> cycles
| |
| − | *Using a prescale of 1:x, the timer period count register = # of cycles/x
| |
| − | *e.g. PERIOD = 10ms; # of cycles = 10ms*30MHz = 300000 cylces; Using 1:64 Prescale, register setting = 300000/64 = 4688
| |
| − | void time_init(void){
| |
| − | TMR1 = 0; // Clear register
| |
| − | PR1 = 4688; // Set period
| |
| − | //============================================================
| |
| − | _T1IF = 0; // Clear interrupt flag
| |
| − | _T1IE = 1; // Enable interrupts
| |
| − | //============================================================
| |
| − | T1CONbits.TCS = 0; // Use internal clock source
| |
| − | T1CONbits.TCKPS = 2; // Prescale Select 1:64
| |
| − | T1CONbits.TON = 1; // Start the timer
| |
| − | }
| |
| − | //********************************************************************
| |
| − | void _ISRFAST _T1Interrupt(void){
| |
| − | _T1IF = 0; // Clear interrupt flag
| |
| − | //Place user code here
| |
| − | }
| |
| − | | |
| − | ====Time Measurement====
| |
| − | *To measure the time taken for action(), use the code below:
| |
| − | unsigned int measure_time(void){
| |
| − | PR3 = 0xFFFF; // Set counter to maximum
| |
| − | _T3IF = 0; // Clear interrupt flag
| |
| − | _T3IE = 0; // Disable interrupt
| |
| − | T3CONbits.TON = 1; // Start the timer, TMR3 count up
| |
| − | TMR3 = 0; //Clear TMR3 to start count up
| |
| − | //====================================================
| |
| − | //Add code here to wait for something to happen
| |
| − | action();
| |
| − | //====================================================
| |
| − | T3CONbits.TON = 0; //Stop the timer
| |
| − | //====================================================
| |
| − | return (unsigned int) TMR3/FCY; //TMR/FCY yields the actual time
| |
| − | }
| |
| − | | |
| − | ===Interrupt===
| |
| − | | |
| − | ----
| |
| − | *Registers are involved in Interrupts includes:
| |
| − | #Interrupt Flag Status (IFS0-IFS2) registers
| |
| − | #Interrupt Enable Control (IEC0-IEC2) registers
| |
| − | #Interrupt Priority Control (IPC0-IPC10) registers
| |
| − | #Interrupt Priority Level (IPL) register
| |
| − | #Global Interrupt Control (INTCON1, INTCON2) registers
| |
| − | #Interrupt vector (INTTREG) register
| |
| − | *User may assign priority level 0-7 to a specific interrupt using IPC. Setting priority to 0 disable a specific interrupt. Level 7 interrupt has the highest priority.
| |
| − | *Current priority level is stored in IPL. Setting IPL to 7 disables all interrupts (except traps). The following MACROs are defined in <p30f5011.h>:
| |
| − | #SET_CPU_IPL(ipl): Set IPL to ipl
| |
| − | #SET_AND_SAVE_CPU_IPL(save_to, ipl): Store the current IPL to save_to and then set to ipl
| |
| − | #RESTORE_CPU_IPL(saved_to): Restore the previously saved ipl
| |
| − | *sti() and cli() are defined to enable and disable global interrupts for time critical functions:
| |
| − | extern int SAVE_IPL;
| |
| − | #define sti() RESTORE_CPU_IPL(SAVE_IPL)
| |
| − | #define cli() SET_AND_SAVE_CPU_IPL(SAVE_IPL, 7)
| |
| − | //============================================================
| |
| − | char adc_ioctl(unsigned char request, unsigned char* argp){
| |
| − | //...
| |
| − | cli(); //Disable global interrupt
| |
| − | for(;ch<=argp[0];ch++)
| |
| − | adc_add_ch(argp[ch]); //Add adc channels
| |
| − | sti(); //Enable global interrupt
| |
| − | //...
| |
| − | return 0;
| |
| − | }
| |
| − | | |
| − | ===UART===
| |
| − | | |
| − | ----
| |
| − | *5011 provides two UART channels UxART, for x=1, 2.
| |
| − | *UxMODE, UxSTA, UxBRG are registers used to set the mode, indicate the status, and set the baud rate respectively.
| |
| − | *For UART communications compatiable with RS232 standard, an external driver (e.g. MAX3232ESE) is needed.
| |
| − | *For UART communications compatiable with RS485 standard, an external driver (e.g. DS3695N) is needed.
| |
| − | ====Auto baud rate detection====
| |
| − | *The method is provided by [http://www.opencircuits.com/DsPIC30F_5011_Development_Board ingenia bootloader].
| |
| − | *The PC sends a ASCII character 'U' (0x55) to the target board.
| |
| − | *On the first rising edge of the start bit, the target board starts the timer.
| |
| − | *At the fifth rising edge, the timer is stopped, let the count number be ''t_count''.
| |
| − | **The measured period corresponds to 8 bits transmitted at a baud rate ''uxbrg''.
| |
| − | _ _ _ _ _ _
| |
| − | _|S|_|1|_|1|_|1|_|1|_|S|_ (S = Start Bit)
| |
| − | <--------------->
| |
| − | Measured Time
| |
| − | *The relationship between ''uxbrg'' and ''TMR'' is
| |
| − | Measured Time (in seconds) = t_count/F<sub>cy</sub>
| |
| − | uxbrg = 1/(Measured Time/8)
| |
| − | = 8*F<sub>cy</sub>/t_count
| |
| − | *Since UxBRG is computed by:
| |
| − | UxBRG = (F<sub>cy</sub>/(16*Baudrate)) -1
| |
| − | = (F<sub>cy</sub>/(16*8*F<sub>cy</sub>/t_count)) -1
| |
| − | = t_count/128 -1
| |
| − | *The following is the code for auto baud rate detection for U2ART:
| |
| − | unsigned int uart2_autobaud(void){
| |
| − | U2MODEbits.ABAUD = 1; //Enable Autobaud detect from U2RX (from IC2 if 0)
| |
| − | U2MODEbits.UARTEN = 1; //U2ART enable
| |
| − | //Timer 3 Config==========================================================
| |
| − | PR3 = 0xFFFF; // Set counter to maximum
| |
| − | _T3IF = 0; // Clear interrupt flag
| |
| − | _T3IE = 0; // Disable interrupt
| |
| − | T3CONbits.TON = 1; // Start the timer, TMR3 count up
| |
| − | //Input Capture Config====================================================
| |
| − | IC2CONbits.ICM = 3; //Detect rising
| |
| − | _IC2IF = 0; //Clear interrupt flag
| |
| − | _IC2IE = 0; //Disable interrupt
| |
| − | //Start Auto baud detection===============================================
| |
| − | unsigned int i=0;
| |
| − | cli(); //Disable Global Interrupt
| |
| − | while(!_IC2IF); //1st rising edge detected
| |
| − | TMR3 = 0; //Clear TMR3 to start count up
| |
| − | _IC2IF = 0; //Clear interrupt flag
| |
| − | while(!_IC2IF); //2nd rising edge detected
| |
| − | _IC2IF = 0; //Clear interrupt flag
| |
| − | while(!_IC2IF); //3rd rising edge detected
| |
| − | _IC2IF = 0; //Clear interrupt flag
| |
| − | while(!_IC2IF); //4th rising edge detected
| |
| − | _IC2IF = 0; //Clear interrupt flag
| |
| − | while(!_IC2IF); //5th rising edge detected
| |
| − | _IC2IF = 0; //Clear interrupt flag
| |
| − | T3CONbits.TON = 0; //Stop the timer
| |
| − | sti(); //Enable Global Interrupt
| |
| − | //Compute value for BRG register==========================================
| |
| − | unsigned int time;
| |
| − | time = ((TMR3+0x40)>>7)-1; //+0x40 for rounding
| |
| − | //========================================================================
| |
| − | return time;
| |
| − | }
| |
| − | *For 30MIP, tested speeds of transmission include 9600bps, 19200bps, 28800bps, 38400bps and 57600bps.
| |
| − | ====Initialize UART====
| |
| − | void uart2_init(void){
| |
| − | //=================================================================
| |
| − | // Configure Baud rate
| |
| − | // +-- Default Baud rate = 19.2 kbps
| |
| − | // +-- U2BRG = 30e6 / (16 * 19200) - 1 = 97
| |
| − | unsigned int u2brg = 97;
| |
| − | #if(AUTO_BAUD_DECT>0)
| |
| − | u2brg = uart2_autobaud();
| |
| − | #endif
| |
| − | U2BRG = u2brg;
| |
| − | //=================================================================
| |
| − | // Disable U2ART
| |
| − | U2MODEbits.UARTEN = 0; //Disable U2ART module
| |
| − | //=================================================================
| |
| − | // Configure Interrupt Priority
| |
| − | _U2RXIF = 0; //Clear Rx interrupt flags
| |
| − | _U2TXIF = 0; //Clear Tx interrupt flags
| |
| − | _U2RXIE = 1; //Receive interrupt: 0 disable, 1 enable
| |
| − | _U2TXIE = 1; //Transmit interrupt: 0 disable, 1 enable
| |
| − | //=================================================================
| |
| − | // Configure Mode
| |
| − | // +--Default: 8N1, no loopback, no wake in sleep mode, continue in idle mode
| |
| − | // +--Diable autobaud detect
| |
| − | // +--Enable U2ART module
| |
| − | U2MODEbits.ABAUD = 0; //Disable Autobaud detect from U2RX
| |
| − | U2MODEbits.UARTEN = 1; //U2ART enable
| |
| − | //=================================================================
| |
| − | // Configure Status
| |
| − | // +--Default: TxInt when a char is transmitted, no break char
| |
| − | // +--Default: RxInt when a char is received, no address detect, clear overflow
| |
| − | // +--Enable Transmit
| |
| − | U2STAbits.UTXEN = 1; //Tx enable
| |
| − | }
| |
| − | | |
| − | ====Sending and Receiving Data====
| |
| − | void _ISR _U2TXInterrupt(void){
| |
| − | _U2TXIF = 0; //Clear Interrupt Flag
| |
| − | if(tx_data_ready())
| |
| − | U2TXREG = tx_buf[POS]; //send next byte...
| |
| − | }
| |
| − | void _ISR _U2RXInterrupt(void){
| |
| − | _U2RXIF = 0; //Clear the flag
| |
| − | if ( U2STAbits.URXDA ){
| |
| − | rx_buf[POS] = (unsigned char) U2RXREG; //Read the data from buffer
| |
| − | }
| |
| − | }
| |
| − | | |
| − | ===I<sup>2</sup>C===
| |
| − | | |
| − | ----
| |
| − | *Two lines are devoted for the serial communication. SCL for clock, SDA for data.
| |
| − | *Standard communication speed includes
| |
| − | #Standard speed mode: 100kHz
| |
| − | #Fast speed mode: 400kHz
| |
| − | #High speed mode: 3.4MHz
| |
| − | *dsPIC30f5011 supports standard and fast speed modes. The maximum speed attainable is 1MHz.
| |
| − | *Pull-up resistors are required for both SCL and SDA. Minimum pull-up resistance is given by:
| |
| − | Pull-up resistor (min) = (V<sub>dd</sub>-0.4)/0.003 ...... [See section 21.8 in Family reference manual]
| |
| − | *2.2Kohm is typical for standard speed mode.
| |
| − | *After initiating a start/stop/restart bit, add a small delay (e.g. no operation) before polling the corresponding control bit (hardware controlled). For example:
| |
| − | StartI2C();<br>
| |
| − | Nop(); //A small delay for hardware to respond<br>
| |
| − | while(I2CCONbits.SEN); //Wait till Start sequence is completed
| |
| − | *After sending a byte and receiving an acknowledgement from the slave device, ensure to change to idle state. For example:
| |
| − | MasterWriteI2C(0x55);<br>
| |
| − | while(I2CSTATbits.TBF); //Wait for transmit buffer to empty<br>
| |
| − | while(I2CSTATbits.ACKSTAT); //Wait for slave acknowledgement<br>
| |
| − | IdleI2C();
| |
| − | | |
| − | ===ADC===
| |
| | | | |
| − | ----
| + | ===Forums=== |
| − | *12-bit ADC: (Max 16 Channels)
| + | *[http://forum.microchip.com/ Microchip]: Official forum by Microchip |
| − | *Allow a maximum of 2 sets of analog input multiplexer configurations, MUX A and MUX B (Normally use one only).
| + | **See MPLAB ICD 2, MPLAB IDE, MPLAB C30 Compiler, ASM30, Link30 forum, dsPIC30F Topics, dsPic33 topics |
| − | *A maximum of 200kps of sampling rate when using auto sampling mode.
| + | *[http://www.htsoft.com/forum/all/ubbthreads.php/Cat/0/C/6 HI-TECH Software Forum]: Discussion on dsPICC, a C compiler developed by HI-TECH |
| − | ====Configuration==== | + | *[http://sourceforge.net/forum/forum.php?forum_id=382005 FreeRTOS Real Time Kernel]: Open Discussion and Support on FreeRTOS |
| − | *Interrupt: Clear ADC interrupt flag and enable ADC interrupt. The ADC module will be set to interrupt when the specified channels are updated. | + | *[http://www.nabble.com/MicroControllers---GNUPIC-f2057.html Nabble]: MicroControllers - GNUPIC |
| − | _ADIF = 0; //clear ADC interrupt flag
| |
| − | _ADIE = 1; //enable adc interrupt
| |
| − | *I/O: Set the corresponding TRISBX bits (digit i/o config) to input (i.e. = 1), and set corresponding bits in ADPCFG (analog config) to zero. | |
| − | _TRISB2 = 1; //Set AN2 [Case Temp] as analog input
| |
| − | _TRISB8 = 1; //Set AN8 [Power detect 0] as analog input
| |
| − | _TRISB9 = 1; //Set AN9 [Power detect 1] as analog input
| |
| − | _TRISB10 = 1; //Set AN10 [Current detect 0] as analog input
| |
| − | _TRISB11 = 1; //Set AN11 [Temp detect 0] as analog input
| |
| − | ADPCFG = 0xF0FB; //0 => Analog, 1 => Digital
| |
| − | *Scanning Mode: Scan mode is used. In this mode, the Sample and Hold (S/H) is switched between the channels specified by ADCSSL (Scan select register). | |
| − | ADCSSL = 0x0F04; //0 => Skip, 1 => Scan
| |
| − | *Reference Voltage for S/H: Only MUX A is used. By default, the negative reference voltage of the S/H is connected to V<sub>REF-</sub>.
| |
| − | ADCHSbits.CH0NA = 0;
| |
| − | *Sampling Rate: T<sub>AD</sub> refers to the time unit for the ADC clock. To configure the ADC module at 200kbps, the minimum sampling time of 1T<sub>AD</sub> = 334ns is required. ADCS<5:0> in ADCON3 register is used to set the time, which is given by: | |
| − | ADCS<5:0> = 2(T<sub>AD</sub>/T<sub>CY</sub>)-1
| |
| − | = 2(334e-9/33.34e-9)-1
| |
| − | = 19
| |
| | | | |
| − | ADCON3bits.SAMC = 1; //1TAD for sampling time
| + | ===References=== |
| − | ADCON3bits.ADRC = 1; //Use internal ADC clock
| + | *dsPIC33F |
| − | ADCON3bits.ADCS = 19; //Set TAD = 334ns
| + | **[http://www.microchip.com/stellent/idcplg?IdcService=SS_GET_PAGE&nodeId=2573 dsPIC33F Family Reference Manual Sections] |
| − | *Settings for ADC Operation: For 200kbps operation, the voltage references for the ADC voltage are connected to V<sub>REF+</sub> and V<sub>REF-</sub>. Scan input is enabled, and the module will generate an interrupt when all selected channels have been scanned. | + | **[http://ww1.microchip.com/downloads/en/DeviceDoc/70286C.pdf dsPIC33FJXXXGPX06/X08/X10 Data Sheet] |
| − | ADCON2bits.VCFG = 3; //External Vref+, Vref-
| + | **[http://ww1.microchip.com/downloads/en/DeviceDoc/80306E.pdf dsPIC33FJXXXGPX06/X08/X10 Rev. A2/A3/A4 Silicon Errata] |
| − | ADCON2bits.CSCNA = 1; //Scan input
| + | **[http://ww1.microchip.com/downloads/en/DeviceDoc/70152G.pdf Flash Programming Specification] |
| − | ADCON2bits.SMPI = 4; //take 5 samples (one sample per channel) per interrupt
| + | *ICD2 Programmer |
| − | *More Settings for ADC Operation: Turn on the module, select the data output format as unsigned integer, and allow auto setting of SAMP bit (auto sampling). | + | **[http://ww1.microchip.com/downloads/en/DeviceDoc/51331C.pdf ICD2 User's Guide] |
| − | ADCON1bits.ADON = 1; //Turn on module
| + | *MPLAB |
| − | ADCON1bits.FORM = 0; //[2 fractional]; [3 siged fractional]
| + | **[http://ww1.microchip.com/downloads/en/DeviceDoc/51519B.pdf MPLAB IDE User's Guide] |
| − | ADCON1bits.SSRC = 7; //auto covert, using internal clock source
| + | *C30 Compiler |
| − | ADCON1bits.ASAM = 1; //auto setting of SAMP bit
| + | **[http://ww1.microchip.com/downloads/en/DeviceDoc/C30_Users_Guide_51284e.pdf MPLAB C30 C Compiler User's Guide]: Contains commands for using pic30-elf-gcc |
| − | ====Storing ADC Data====
| + | **[http://ww1.microchip.com/downloads/en/DeviceDoc/16bit_Language_Tool_Libraries_51456c.pdf 16-bit Language Tools Libraries]: Contains summaries and examples of using DSP libraries, standard C libraries and device libraries |
| − | *16 registers (ADCBUF0 -ADCBUF15) are dedicated to store the ADC data between interrupts. However, the data in ADCBUFx does not necessarily correspond to the data taken for channel x. Since the lowest register will always be filled first, when some of the channels are not scanned (i.e. skipped), care must be taken. The following code checks the ADCSSL register for the current scanning channels and moves the data to the corresponding position in *adc_buf. | + | **[http://ww1.microchip.com/downloads/en/DeviceDoc/Asm30_Link_Util_51317e.pdf MPLAB ASM30, MPLAB LINK30 and Utilities User's Guide] |
| − | void _ISR _ADCInterrupt(void){
| |
| − | _ADIF = 0; //Clear adc interrupt
| |
| − | //==========================================================
| |
| − | unsigned char channel = 0;
| |
| − | unsigned char buffer = 0;
| |
| − | for (; channel<ADC_MAX_CH; channel++){
| |
| − | if(adc_ch_updated(channel)){ //Check if channel has updated
| |
| − | adc_buf[channel] = ADC16Ptr[buffer]; //Copy data to adc_buf
| |
| − | buffer++;
| |
| − | }
| |
| − | }
| |
| − | }
| |
| − | unsigned char adc_ch_updated(unsigned char ch){
| |
| − | unsigned int mask;
| |
| − | mask = 0x0001 << ch;
| |
| − | if(ADCSSL & mask)
| |
| − | return 1;
| |
| − | return 0;
| |
| − | }
| |
| − | ====Adding and Removing Channels====
| |
| − | *Channels may be added or removed by changing _TRISBX, ADPCFG, ADCSSL and ADCON2bits.SMPI.
| |
| − | void adc_add_ch(unsigned char ch){
| |
| − | //Enable i/o pin as input===========================================
| |
| − | switch(ch){
| |
| − | case 0: _TRISB0 = 1; break;
| |
| − | case 1: _TRISB1 = 1; break;
| |
| − | case 2: _TRISB2 = 1; break;
| |
| − | case 3: _TRISB3 = 1; break;
| |
| − | case 4: _TRISB4 = 1; break;
| |
| − | case 5: _TRISB5 = 1; break;
| |
| − | case 6: _TRISB6 = 1; break;
| |
| − | case 7: _TRISB7 = 1; break;
| |
| − | case 8: _TRISB8 = 1; break;
| |
| − | case 9: _TRISB9 = 1; break;
| |
| − | case 10: _TRISB10 = 1; break;
| |
| − | case 11: _TRISB11 = 1; break;
| |
| − | case 12: _TRISB12 = 1; break;
| |
| − | case 13: _TRISB13 = 1; break;
| |
| − | case 14: _TRISB14 = 1; break;
| |
| − | default: _TRISB15 = 1;
| |
| − | }
| |
| − | unsigned int mask;
| |
| − | mask = 0x0001 << ch;
| |
| − | ADCSSL = ADCSSL | mask;
| |
| − | ADPCFG = ~ADCSSL;
| |
| − | ADCON2bits.SMPI++; //take one more sample per interrupt
| |
| − | }
| |
| − | void adc_rm_ch(unsigned char ch){
| |
| − | unsigned int mask;
| |
| − | mask = 0x0001 << ch;
| |
| − | ADPCFG = ADPCFG | mask;
| |
| − | ADCSSL = ~ADPCFG;
| |
| − | ADCON2bits.SMPI--; //take one less sample per interrupt
| |
| − | }
| |
| | | | |
| − | ===EEPROM=== | + | ===Code Examples=== |
| | + | *[http://www.microchip.com/stellent/idcplg?IdcService=SS_GET_PAGE&nodeId=1408 Microchip Example Codes for dsPic] |
| | | | |
| − | ----
| + | ===Related Development=== |
| − | *5011 has 1024 bytes of EEPROM, readable and writable under normal voltage (5V).
| + | *[[Ethernet Module]] |
| − | *To use, declare:
| + | *[[Modulation Plugin]] |
| − | unsigned char _EEDATA(2) eeData[1024]={ 0x00, 0x00, 0x00, 0x00, .... }
| |
| − | unsigned int byte_pointer = 0;
| |
| − | ====Seek==== | |
| − | *This function moves the pointer to the desired position before a reading/writing operation is performed. | |
| − | int eeprom_lseek(int offset, unsigned char whence){
| |
| − | byte_pointer = offset;
| |
| − | return byte_pointer;
| |
| − | }
| |
| − | ====Read====
| |
| − | *This function read ''count'' bytes from the eeprom.
| |
| − | int eeprom_read(unsigned char* buf, int count){
| |
| − | int i=0;
| |
| − | for(; i<count && byte_pointer < 1024; i++){
| |
| − | readEEByte( __builtin_tblpage(eeData),
| |
| − | __builtin_tbloffset(eeData) + byte_pointer,
| |
| − | &buf[i]);
| |
| − | byte_pointer++; //Update global pointer
| |
| − | }
| |
| − | return i; //read i bytes successful
| |
| − | }
| |
| − | *readEEByte() is implemented in assembly code as follows: | |
| − | .global _readEEByte
| |
| − | _readEEByte:
| |
| − | push TBLPAG ;w0 = base of eeData
| |
| − | mov w0, TBLPAG ;w1 = offset for eeData in byte
| |
| − | tblrdl.b [w1], [w2] ;w2 = pointer to user buffer
| |
| − | pop TBLPAG
| |
| − | return
| |
| | | | |
| − | ====Write====
| |
| − | *This function write ''count'' bytes to eeprom.
| |
| − | int eeprom_write(unsigned char* buf, int count){
| |
| − | char isOddAddr = byte_pointer%2; //current address is odd
| |
| − | char isOddByte = count%2; //number of bytes to write is odd
| |
| − | //=================================================================
| |
| − | unsigned int word_offset = byte_pointer>>1; //div by 2 and round down
| |
| − | int max_write;
| |
| − | max_write = (isOddAddr == 0 && isOddByte == 0) ? (count>>1) : (count>>1)+1;
| |
| − | //=================================================================
| |
| − | unsigned int word_data; //Store word to be written
| |
| − | int byte_wr = 0; //number of bytes written, i.e buffer pointer
| |
| − | int i = 0;
| |
| − | //=================================================================
| |
| − | for(; i<max_write && word_offset<512; i++, word_offset++){
| |
| − | if(i==0 && isOddAddr){
| |
| − | //First byte not used
| |
| − | //============================================save first byte
| |
| − | readEEByte( __builtin_tblpage(eeData),
| |
| − | __builtin_tbloffset(eeData) + byte_pointer - 1,
| |
| − | &word_data);
| |
| − | //===========================================================
| |
| − | word_data = ((unsigned int)buf[0] << 8) + (0xFF & word_data);
| |
| − | byte_wr++; //Update buffer pointer
| |
| − | byte_pointer++; //Update global pointer
| |
| − | } else if(i==max_write-1 && ((isOddAddr && sOddByte==0)||(isOddAddr==0 && isOddByte))){
| |
| − | //Last byte not used
| |
| − | //=============================================save last byte
| |
| − | readEEByte( __builtin_tblpage(eeData),
| |
| − | __builtin_tbloffset(eeData) + byte_pointer + 1,
| |
| − | &word_data);
| |
| − | //============================================================
| |
| − | word_data = (word_data << 8) + buf[byte_wr];
| |
| − | byte_wr++; //Update buffer pointer
| |
| − | byte_pointer++; //Update global pointer
| |
| − | } else{
| |
| − | //Both bytes valid
| |
| − | word_data = ((unsigned int)buf[byte_wr+1] << 8) + buf[byte_wr];
| |
| − | byte_wr+=2; //Update buffer pointer
| |
| − | byte_pointer+=2; //Update global pointer
| |
| − | }
| |
| − | //==================================================================
| |
| − | eraseEEWord( __builtin_tblpage(eeData),
| |
| − | __builtin_tbloffset(eeData) + 2*word_offset);
| |
| − | writeEEWord( __builtin_tblpage(eeData),
| |
| − | __builtin_tbloffset(eeData) + 2*word_offset,
| |
| − | &word_data);
| |
| − | //==================================================================
| |
| − | }
| |
| − | return byte_wr; //No. of byte written
| |
| − | }
| |
| − | *eraseEEWord and writeEEWord are implemented in assembly.
| |
| − | .global _eraseEEWord
| |
| − | _eraseEEWord:
| |
| − | push TBLPAG
| |
| − | mov w0, NVMADRU ;w0 = base of eeData
| |
| − | mov w1, NVMADR ;w1 = offset for eeData in word
| |
| − | mov #0x4044, w0
| |
| − | mov w0, NVMCON ;Set to erase operation
| |
| − | push SR ;Disable global interrupts
| |
| − | mov #0x00E0, w0
| |
| − | ior SR
| |
| − | mov #0x55, w0 ;Write the KEY sequence
| |
| − | mov w0, NVMKEY
| |
| − | mov #0xAA, w0
| |
| − | mov w0, NVMKEY
| |
| − | bset NVMCON, #15 ;Start the erase cycle, bit 15 = WR
| |
| − | nop
| |
| − | nop
| |
| − | L1: btsc NVMCON, #15 ;while(NVMCONbits.WR)
| |
| − | bra L1
| |
| − | clr w0
| |
| − | pop SR ;Enable global interrupts
| |
| − | pop TBLPAG
| |
| − | return
| |
| | | | |
| − | .global _writeEEWord
| + | ==Programming Methods== |
| − | _writeEEWord:
| + | *There are 2 programming methods: In-Circuit Serial Programming (ICSP) and Run-Time Self-Programming (RTSP) |
| − | push TBLPAG ;w0 = base of eeData
| + | *ICSP allows the devices to be programmed after being placed in a circuit board. |
| − | mov w0, TBLPAG ;w1 = offset for eeData in byte
| + | *RTSP allows the devices to be programmed when an embedded program is already in operation. |
| − | tblwtl [w2], [w1] ;w2 = pointer to user buffer
| |
| − | mov #0x4004, w0 ;Set to write operation
| |
| − | MOV w0, NVMCON
| |
| − | push SR ;Disable global interrupts
| |
| − | mov #0x00E0, w0
| |
| − | ior SR
| |
| − | mov #0x55, w0 ;Write the KEY sequence
| |
| − | mov w0, NVMKEY
| |
| − | mov #0xAA, w0
| |
| − | mov w0, NVMKEY
| |
| − | bset NVMCON, #15 ;Start the erase cycle, bit 15 = WR
| |
| − | nop
| |
| − | nop
| |
| − | L2: btsc NVMCON, #15 ;while(NVMCONbits.WR)
| |
| − | bra L2
| |
| − | clr w0
| |
| − | pop SR ;Enable global interrupts
| |
| − | pop TBLPAG
| |
| − | return
| |
| | | | |
| − | ===Simple PWM (Output Compare Module)=== | + | ===ICSP: External Programmer (ICD2)=== |
| | + | *Two types of ICSP are available: '''ICSP''' and '''Enhanced ICSP'''. Both of them require setting MCLR# to V<sub>IHH</sub> (9V – 13.25V). |
| | + | *Standard ICSP |
| | + | **Use external programmer (e.g. MPLAB<sup>®</sup> ICD 2, MPLAB<sup>®</sup> PM3 or PRO MATE<sup>®</sup> II) only. |
| | + | **Required low-level programming to erase, program and verify the chip. |
| | + | **Slower, because codes are serially executed. |
| | | | |
| − | ----
| + | *Enhanced ICSP |
| − | | + | **Use external programmer and '''Programming Executive''' (PE). |
| − | *The PWM module consists of 8 channels using the output compare module of dsPic. | + | **PE is stored in the on-chip memory. |
| − | *These channels are locate at pin 46 (OC1), 49 (OC2), 50 (OC3), 51 (OC4), 52 (OC5), 53 (OC6), 54 (OC7), 55 (OC8). These pins are shared with port D. | + | **PE allows faster programming. |
| − | *The range of PWM freqeuencies obtainable is 2Hz to 15MHz (See Figure 6.3). Suggested range of operation is 2Hz to 120kHz. The relationship between resolution ''r'' and PWM frequency ''f''<sub>PWM</sub> is given by: | + | **PE can be downloaded to the chip by external programmer using the standard ICSP method. |
| − | f<sub>PWM</sub> = f<sub>CY</sub>/(Prescale*10<sup>rlog(2)</sup>)
| + | **PE contains a small command set to erase, program and verify the chip, avoiding the need of low-level programming. |
| | | | |
| | + | ====Hardware Interface==== |
| | {| border="1" cellspacing="0" cellpadding="5" | | {| border="1" cellspacing="0" cellpadding="5" |
| − | |+ Table 6.3 Relationship of Resolution and PWM Frequency | + | |+ Pin Used by ICSP |
| − | ! Resolution (bit) !! Prescale=1 !! Prescale=8 !! Prescale=64 !! Prescale=256 | + | ! Pin Label !! Function !! Pin Number |
| | |- | | |- |
| − | |1||15,000,000 ||1,875,000 ||234,375||58,594 | + | | MCLR# || Programming Enable|| 7 |
| | + | |- |
| | + | | V<sub>DD</sub> || Power Supply || 10, 26, 38, 57 |
| | + | |- |
| | + | | V<sub>SS</sub> || Ground || 9, 25, 41, 56 |
| | |- | | |- |
| − | |2||7,500,000 ||937,500 ||117,188 ||29,297 | + | | PGC || Serial Clock || 17 |
| − | |- | + | |- |
| − | |3||3,750,000 ||468,750 ||58,594 ||14,648 | + | | PGD || Serial Data || 18 |
| − | |-
| |
| − | |4||1,875,000 ||234,375 ||29,297 ||7,324
| |
| − | |-
| |
| − | |5||937,500 ||117,188 ||14,648 ||3,662
| |
| − | |-
| |
| − | |6||468,750 ||58,594 ||7,324 ||1,831
| |
| − | |-
| |
| − | |7||234,375 ||29,297 ||3,662 ||916
| |
| − | |-
| |
| − | |8||117,188 ||14,648 ||1,831||458
| |
| − | |-
| |
| − | |9||58,594 ||7,324 ||916 ||229
| |
| − | |-
| |
| − | |10||29,297 ||3,662 ||458 ||114
| |
| − | |-
| |
| − | |11||14,648 ||1,831 ||229||57
| |
| − | |-
| |
| − | |12||7,324 ||916 ||114 ||29
| |
| − | |-
| |
| − | |13||3,662 ||458 ||57 ||14
| |
| − | |-
| |
| − | |14||1,831 ||229 ||29 ||7
| |
| − | |-
| |
| − | |15||916 ||114 ||14 ||4
| |
| − | |-
| |
| − | |16||458 ||57 ||7 ||2
| |
| | |- | | |- |
| | |} | | |} |
| | | | |
| − | ====open()====
| |
| − | *A timer (either Timer 2 or 3) is needed to determine the pwm period. The following code uses timer 2 for all 8 channels.
| |
| − | void pwm_open(void){
| |
| − | OC1CON = 0; OC2CON = 0; //Disable all output compare modules
| |
| − | OC3CON = 0; OC4CON = 0;
| |
| − | OC5CON = 0; OC6CON = 0;
| |
| − | OC7CON = 0; OC8CON = 0;
| |
| − | //============================================================
| |
| − | TMR2 = 0; // Clear register
| |
| − | PR2 = 0xFFFF; // Set to Maximum
| |
| − | //============================================================
| |
| − | _T2IP = 7; // Set priority level to 7 (7 Highest)
| |
| − | _T2IF = 0; // Clear interrupt flag
| |
| − | _T2IE = 1; // Enable interrupts
| |
| − | //============================================================
| |
| − | T2CONbits.TCS = 0; // Use internal clock source
| |
| − | T2CONbits.TCKPS = 0; // Prescale Select 1:1
| |
| − | //============================================================
| |
| − | T2CONbits.TON = 1; // Start the timer
| |
| − | }
| |
| − | void _ISR _T2Interrupt(void){
| |
| − | _T2IF = 0; // Clear interrupt flag
| |
| − | }
| |
| − |
| |
| − | ====ioctl()====
| |
| − | *User should select the channel and set the pwm period using the functions below before issuing the duty cycle:
| |
| − | char pwm_ioctl(unsigned char request, unsigned long* argp){
| |
| − | unsigned int value;
| |
| − | unsigned char mask;
| |
| − | switch(request){
| |
| − | case PWM_SET_PERIOD:
| |
| − | return setPeriodNPrescale(argp[0]);
| |
| − | case PWM_SELECT_CH:
| |
| − | pwm_channel = argp[0];
| |
| − | mask = 0x01 << pwm_channel;
| |
| − | pwm_status = pwm_status | mask;
| |
| − | return 0;
| |
| − | default:
| |
| − | return -1;
| |
| − | }
| |
| − | }
| |
| − | char setPeriodNPrescale(unsigned long value_ns){
| |
| − | unsigned long ans;
| |
| − | unsigned long long numerator = (unsigned long long)value_ns*SYSTEM_FREQ_MHZ;
| |
| − | unsigned char index= -1;
| |
| − | unsigned long denominator;
| |
| − | //-------------------------------------------------
| |
| − | do{
| |
| − | denominator = (unsigned long)1000*pwm_prescale[++index];
| |
| − | ans = (unsigned long)(((long double)numerator/denominator) + 0.5) - 1; //rounding to nearest integer
| |
| − | } while(ans > 0x0000FFFF && index < 3);
| |
| − | //-------------------------------------------------
| |
| − | if(ans > 0x0000FFFF)
| |
| − | return -1;
| |
| − | //-------------------------------------------------
| |
| − | T2CONbits.TON = 0; // Turn off the timer
| |
| − | T2CONbits.TCKPS = index; // Change prescale factor
| |
| − | PR2 = (unsigned int) ans; // Set to Maximum
| |
| − | T2CONbits.TON = 1; // Turn on the timer
| |
| − | //-------------------------------------------------
| |
| − | return 0;
| |
| − | }
| |
| − |
| |
| − | ====write()====
| |
| − | *User can change the duty cycle using teh following functions
| |
| − | int pwm_write(unsigned long* buf){
| |
| − | if((pwm_status & (0x01 << pwm_channel)) == 0){
| |
| − | return -1; //Channel has not been enabled
| |
| − | }
| |
| − | switch(pwm_channel){
| |
| − | case 0:
| |
| − | OC1RS = calcDCycle(buf[0]); OC1R = OC1RS;
| |
| − | OC1CONbits.OCM = 6; //Simple PWM, Fault pin disabled
| |
| − | break;
| |
| − | case 1:
| |
| − | OC2RS = calcDCycle(buf[0]); OC2R = OC2RS;
| |
| − | OC2CONbits.OCM = 6; //Simple PWM, Fault pin disabled
| |
| − | break;
| |
| − | ...
| |
| − | case 7:
| |
| − | OC8RS = calcDCycle(buf[0]); OC8R = OC8RS;
| |
| − | OC8CONbits.OCM = 6; //Simple PWM, Fault pin disabled
| |
| − | break;
| |
| − | default:
| |
| − | return -1;
| |
| − | }
| |
| − | return 4;
| |
| − | }
| |
| − | unsigned int calcDCycle(unsigned long value_ns){
| |
| − | unsigned long long numerator = (unsigned long long)value_ns*SYSTEM_FREQ_MHZ;
| |
| − | unsigned int index = T2CONbits.TCKPS;
| |
| − | unsigned long denominator = (unsigned long)1000*pwm_prescale[index];
| |
| − | return (unsigned int)(((long double)numerator/denominator) + 0.5) - 1; //rounding to nearest integer
| |
| − | }
| |
| − |
| |
| − | ====Propagration Delay====
| |
| − | *PWM channels sharing the same timer will have their PWM signals synchronised (i.e. the HIGH state of the duty cycle are all triggered together).
| |
| − | *To introduced delay to the PWM signals, the signal from selected channels may be made to pass through a series of inverters (e.g. 74HC14D). This adds propagation delay to the signal.
| |
| − | *However, as propagration delay of logic gates depends on applied voltage, temperature and load capacitance, the accuracy is low and performance is poor. For accurate delay, delay lines may be used, but they are expensive.
| |
| | | | |
| | {| border="1" cellspacing="0" cellpadding="5" | | {| border="1" cellspacing="0" cellpadding="5" |
| − | |+ Table 6.4 Propagation Delay of [http://www.nxp.com/acrobat_download/datasheets/74HC_HCT14_3.pdf Philips 74HC14D]<sup>[1], [2]</sup> | + | |+ Available Programmers in the Market |
| − | ! !! 3.3V !! !! !! 5.0V !! !! | + | ! Product Name |
| | + | ! Interface with PC |
| | + | ! Interface with Device |
| | + | ! *Price (US) |
| | + | ! Remarks |
| | |- | | |- |
| − | ! Number of Gates !! A !! B !! C !! A !! B !! C
| + | | [http://direct.www.microchip.com/stellent/idcplg?IdcService=SS_GET_PAGE&nodeId=1406&dDocName=en010046&part=DV164005 MPLAB<sup>®</sup> ICD 2] |
| − | |- | + | | USB or RS232 |
| − | | 2 | + | | [http://www.microchip.com/Microchip.WWW.SecureSoftwareList/secsoftwaredownload.aspx?device=en010046&lang=en&ReturnURL=http://www.microchip.com/stellent/idcplg?IdcService=SS_GET_PAGE&nodeId=1406&dDocName=en010046&part=DV164005# 6-PIN RJ-12 connector] |
| − | | 21ns (10.5)|| 23ns (11.5)|| 22ns (11.0) | + | | $159.99 |
| − | | 15ns (7.5)|| 14ns (7.0)|| 14ns (7.0) | + | | - |
| | |- | | |- |
| − | | 4 | + | | [http://www.sureelectronics.net Clone Microchip ICD2] (Now Using) |
| − | | 45ns (11.3)|| 46ns (11.5)|| 46ns (11.5)
| + | | USB |
| − | | 30ns (7.5)|| 30ns (7.5)|| 30ns (7.5) | + | | 6-pin flat cables |
| | + | | $52.35 |
| | + | | Do not work with new MPLAB versions (works for 7.50), communication to MPLAB may sometime hang (see [http://www.sureelectronics.net/pdfs/DB-DP003.pdf manual]) |
| | |- | | |- |
| − | | 6
| |
| − | | 69ns (11.5)|| 70ns (11.7)|| 72ns (12.0)
| |
| − | | 45ns (7.5)|| 46ns (7.7)|| 47ns (7.8)
| |
| − | |-
| |
| | |} | | |} |
| − | [1] Data in specification for 4.5V: Typical 15ns, Maximum 25ns<br>
| + | <nowiki>*</nowiki>For reference only (exclude shipping), subject to change |
| − | [2] Data in specification for 6.0V: Typical 12ns, Maximum 21ns
| |
| − | | |
| − | ===DSP Library===
| |
| − | | |
| − | ----
| |
| − | *Library functions in <dsp.h> include the following categories:
| |
| − | #Vector
| |
| − | #Window
| |
| − | #Matrix
| |
| − | #Filtering
| |
| − | #Transform
| |
| − | #Control
| |
| − | | |
| − | ====Data Types====
| |
| − | *Signed Fractional Value (1.15 data format)
| |
| − | **Inputs and outputs of the dsp functions adopt 1.15 data format, which consumes 16 bits to represent values between -1 to 1-2<sup>-15</sup> inclusive.
| |
| − | **Bit<15> is a signed bit, positive = 0, negative = 1.
| |
| − | **Bit<14:0> are the exponent bits ''e''.
| |
| − | **Positive value = 1 - 2<sup>-15</sup>*(32768 - ''e'')
| |
| − | **Negative value = 0 - 2<sup>-15</sup>*(32768 - ''e'')
| |
| − | *40-bit Accumulator operations (9.31 data format)
| |
| − | **The dsp functions use the 40 bits accumalators during arithmatic calculations.
| |
| − | **Bit<39:31> are signed bits, positive = 0x000, negative = 0x1FF.
| |
| − | **Bit<30:0> are exponent bits.
| |
| − | *IEEE Floating Point Values
| |
| − | **Fractional values can be converted to Floating point values using: '''fo = Fract2Float(fr);''' for fr = [-1, 1-2<sup>-15</sup>]
| |
| − | **Floating point values can be converted to Fractional values using: '''fr = Float2Fract(fo);''' or '''fr = Q15(fo);''' for fo = [-1, 1-2<sup>-15</sup>]
| |
| − | **Float2Fract() is same as Q15(), except having saturation control. When +ve >= 1, answer = 2<sup>15</sup>-1 = 32767 (0x7FFF). When -ve < -1, answer = -2<sup>15</sup> = -32767 (0x8000) | |
| − | | |
| − | ====Overflow and Saturation Traps====
| |
| − | *To be added.
| |
| − | | |
| − | ===Build-in Library===
| |
| − | | |
| − | ----
| |
| − | *Some assembler operators can only be accessed by inline assembly code, for example,
| |
| − | #Manuipulation of accumulators A and B (add, sub, mul, divide, shift, clear, square)
| |
| − | #Bit toggling
| |
| − | #Access to psv (program space visiblity) page and offset
| |
| − | #Access to table instruction page and offset
| |
| − | *Built-in functions are written as C-like function calls to utilize these assembler operators.
| |
| − | | |
| − | | |
| − | ==Bootloader Development==
| |
| − | | |
| − | ===Concepts===
| |
| − | *Programming with ICSP is useful when the target board is produced in batch. The producer can download a program even when the chip is on the target board.
| |
| − | *However, ICSP requires an external programmer.
| |
| − | *To allow the user to change the program after production but without the need of an external programmer, bootloader becomes useful.
| |
| − | *Bootloader is a small program installed via ICSP. Everytime the device is reset, the bootloader is run first. The bootloader first detects the default serial channel whether the user wishes to download a new program to the device. If so, the bootloader will pause there, and wait for the user to download the hex file from the PC. The hex file is written to the device via RTSP instructions in the bootloader. If a new download is not necessary, the bootloader redirects to the previously installed user's program.
| |
| − | *The disadvantage of bootloaders is that they consume some of the memory of the device.
| |
| | | | |
| | | | |
| | {| border="1" cellspacing="0" cellpadding="5" | | {| border="1" cellspacing="0" cellpadding="5" |
| − | |+ Table 7.1 Free bootloaders for dsPIC | + | |+ DIY ICD 2 Programmer Circuit |
| − | ! Developer | + | ! Source !! Schematic !! PIC16F877A Bootloader |
| − | ! Source | + | |- |
| − | ! Platform | + | | [http://membres.lycos.fr/silicium31/Electronique/PIC/FreeIcdEnglish.htm Patrick Touzet] |
| − | ! User Guide | + | | [http://membres.lycos.fr/silicium31/Electronique/PIC/ICD2%20V1.3.pdf Yes] |
| − | ! Remarks | + | | [http://membres.lycos.fr/silicium31/Electronique/PIC/ICD2_FW.zip HEX] |
| − | |- valign="top" | + | |- |
| − | | [http://www.ingenia-cat.com/index.php?lang=en ingenia] | + | | [http://www.nebadje.org/doku.php?id=neblab:icd2clone Nebadje] |
| − | | [http://www.ingenia-cat.com/download/iBL.s Assembly]
| + | | [http://people.ee.ethz.ch/~jbiveron/nebadje/ICD2_DOC.pdf Yes] |
| − | | [http://www.ingenia-cat.com/download/ingeniadsPICbootloader1.1.zip Windows] | + | | [http://people.ee.ethz.ch/~jbiveron/nebadje/ICD2_FW.zip Zip] |
| − | | [http://www.ingenia-cat.com/reference/pdf/iBL.UG.V1.2.pdf pdf]
| |
| − | |
| |
| − | *Works for all dsPIC supporting RTSP
| |
| − | *Auto baudrate detection
| |
| − | *Use about 1.15% of the flash memory space (0xAFFF-0xAE00)/(0xAFFF-0x0100)
| |
| − | *Development of Linux platform is underway
| |
| − | *Modification of code for dsPIC30F5011 is successful
| |
| − | |-valign="top"
| |
| − | | [http://www.etc.ugal.ro/cchiculita/software/picbootloader.htm Tiny] | |
| − | | [http://www.etc.ugal.ro/cchiculita/software/tinybld191.zip Assembly]
| |
| − | | Windows | |
| − | | [http://www.etc.ugal.ro/cchiculita/software/tinybldusage.htm Web] | |
| − | |
| |
| − | *By default, only supports 601X, 601X, 401X, 2010
| |
| − | *Smaller code size than ingenia, but not as easy to modify
| |
| − | |-valign="top"
| |
| − | | [http://www.via.si/software/dsPIC_bootloader/ Elektronika]
| |
| − | | [http://www.via.si/software/dsPIC_bootloader/data/ Hex] | |
| − | | Windows
| |
| − | | [http://www.via.si/software/dsPIC_bootloader/data/README.txt txt] | |
| − | |
| |
| − | *Only works for dsPIC30F6014 serial port UART2 at baudrate 57600
| |
| | |- | | |- |
| | |} | | |} |
| | | | |
| − | ===dsPicBootloader===
| |
| − |
| |
| − | *The bootloader developed by ingenia is open source and it has been modified (see below) to suit our development using dsPic30f5011.
| |
| − | *The bootloader (hereafter called dsPicBootloader) employs the following settings:
| |
| − | # Use U2ART channel
| |
| − | # Use FRC, PLL16
| |
| − | # For 5011, the bootloader is located between 0x00AE00 to 0x00AFFE (512bytes). Refer to C:\Program Files\Ingenia\ingeniadsPICbootloader\ibl_dspiclist.xml after installing the GUI interface.
| |
| − | *Changes made to [http://www.ingenia-cat.com/download/iBL.s assembly code] includes:
| |
| − | 1. including p30f5011.gld and p30f5011.inc
| |
| − | .include "p30f5011.inc"
| |
| − | 2. changing the config code of UART #0x8420 -> #0x8020
| |
| − | ; Uart init
| |
| − | mov '''#0x8020''', W0 ; W0 = 0x8020 -> 1000 0000 0010 0000b
| |
| − | mov W0, U2MODE ; Enable UART, AutoBaud and 8N1
| |
| − | clr U2STA
| |
| − | 3. changing the start address 0xAE00 - 0x0100 = 0AD00
| |
| − | .equ CRC, W4
| |
| − | .equ ACK, 0x55
| |
| − | .equ NACK, 0xFF
| |
| − | .equ USER_ADDRESS, 0x0100
| |
| − | .equ START_ADDRESS, '''0xAD00''' ; Relative to 0x0100
| |
| − | 4. using Internal FRC and PLL16
| |
| − | config __FOSC, CSW_FSCM_OFF & '''FRC_PLL16''' ;Turn off clock switching and
| |
| − | ;fail-safe clock monitoring and
| |
| − | ;use the Internal Clock as the
| |
| − | ;system clock
| |
| − | 5. disabling MCLR (optional)
| |
| − | config __FBORPOR, PBOR_ON & BORV_27 & PWRT_16 & '''MCLR_DIS'''
| |
| − | ;Set Brown-out Reset voltage and
| |
| − | ;and set Power-up Timer to 16msecs
| |
| − | 6. changing all the related registers of U1ART to U2ART, all U1XXX => U2XXX
| |
| − | '''U2MODE, U2STA, U2BRG, U2RXREG, U2TXREG'''
| |
| − | 7. changing all the related registers of IC1 to IC2, all IC1XXX => IC2XXX
| |
| − | '''IC2CON, #IC2IF, #IC2IE'''
| |
| − |
| |
| − | ===dsPicProgrammer (Java-based Multi-Platformed)===
| |
| − | *Ingenia developed a programmer (PC-side) that works only in Windows environment. The project for Linux environment is currently suspended.
| |
| − | *A simple programmer (hereafter called dsPicProgrammer) written in Java based on the library developed by [http://www.rxtx.org/ RXTX] has been developed here. The programmer supports both Linux and Windows environments, and may be used as a substitution for the official programmer developed by ingenia.
| |
| − | *The programmer has the following specification and limitations:
| |
| − | #Use baud rate of 57600bps (Not selectable).
| |
| − | #Only program dsPic30f5011 devices (Developers may change the source code for your devices).
| |
| − | #Protection against overwriting bootloader codes on devices.
| |
| − | #Dectection if application program does not have its reset() at address 0x100.
| |
| | | | |
| − | ===Special Consideration=== | + | ====Software Interface==== |
| − | *The bootloader assumes that the user program starts at address 0x100. This is usually the case, but there are always exceptions. | + | *The program can be written and compiled in an Integrated Development Environment (IDE) using either Assembly or C. The complied codes are then loaded to the device through the external programmer. |
| − | *To ensure that the user program always starts at address 0x100, you can create a customized linker script and customized reset() function as follows:
| |
| − | :*Copy and modify the file named "crt0.s" from the directory "C:\Program Files\Microchip\MPLAB C30\src\pic30" to the project directory and include it.
| |
| − | .section .reset, code //previously .section .libc, code
| |
| − | :*Copy and modify the linkerscript for the device (e.g. p30f5011.gld) to the project directory and include it.
| |
| − | .text __CODE_BASE :
| |
| − | {
| |
| − | *(.reset); //<-insert this line here
| |
| − | *(.handle);
| |
| − | *(.libc) *(.libm) *(.libdsp); /* keep together in this order */
| |
| − | *(.lib*);
| |
| − | *(.text);
| |
| − | } >program
| |
| | | | |
| − | ===Downloads===
| |
| | {| border="1" cellspacing="0" cellpadding="5" | | {| border="1" cellspacing="0" cellpadding="5" |
| − | |+ Table 7.2 dsPicBootloader and dsPicProgrammer for dsPIC30f5011 | + | |+ Summary of IDE |
| − | ! Program | + | ! Product Name !! Features !! OS !! Price (US$) |
| − | ! Site 1 | + | |- |
| − | ! Site 2 | + | | [http://www.microchip.com/stellent/idcplg?IdcService=SS_GET_PAGE&nodeId=1406&dDocName=en019469&part=SW007002 MPLAB<sup>®</sup> IDE] |
| − | ! Remarks | + | | Assembler Only |
| − | |- valign="top"
| + | | Windows |
| − | | dsPicBootloader
| + | | Free |
| − | | [http://chungyan5.no-ip.org/websvn/listing.php click] | + | |- |
| − | | [http://www.opencircuits.com/images/e/ed/DsPicBootloader.zip click] | + | | [http://www.microchip.com/stellent/idcplg?IdcService=SS_GET_PAGE&nodeId=1406&dDocName=en010065&part=SW006012 MPLAB<sup>®</sup> C30] |
| − | | Under "dsPicBootloader/", download ingenia.s and compile yourself | + | | Assembler and C-Compiler |
| − | |-valign="top" | + | | Windows |
| − | | dsPicProgrammer | + | | $895.00 (Free student version<sup>1</sup>) |
| − | | [http://chungyan5.no-ip.org/websvn/listing.php click] | |
| − | | [http://www.opencircuits.com/images/1/13/DsPicProgrammer.zip click] | |
| − | | Under "dsPicProgrammer/", dowload dsPicProgrammer.jar<br><br>Alternatively, if you want to compile yourself or modify the source code, download <br>COMDataHandler.java, COMPortManager.java, Pic5011Prog.java, Pic5011Protocol.java, <br>and WriteBuffer.java under "dsPicProgrammer/" '''plus''' RdFileIntelHex.java under <br>"IntelHexPaser/tags/0.02.00/".<br>You should also install RXTX on your local machine as recommended in the readme file. | |
| | |- | | |- |
| | + | | [http://piklab.sourceforge.net/ Piklab] |
| | + | | Assembler and C-Compiler |
| | + | | Linux |
| | + | | Free |
| | |} | | |} |
| | + | # Full-featured for the first 60 days. After 60 days, some code optimization functions are disabled. The compiler will continue to function after 60 days, but code size may increase. |
| | | | |
| − | ===Communication Protocol=== | + | ===RTSP: COM Port (Bootloader)=== |
| − | * Communication Protocol is reviewed in [http://www.ingenia-cat.com/reference/pdf/iBL.UG.V1.2.pdf ingenia bootloader user's guide] section 2.1.3. The following summarises the key steps on the PC side (Refer also to section 2.2.2). | + | *RTSP works in normal voltage (MCLR# no need to raise to V<sub>IHH</sub>). |
| − | * Transmission is conducted in 8N1, i.e. 8-bit, no parity, 1 stop-bit | + | *No literature has mentioned the incorporation of Programming Executive (PE). Presumably, since Enhanced ICSP needs to set MCLR# to V<sub>IHH</sub>, RTSP cannot use PE. |
| − | * '''Stage 1: User's configuation'''
| + | *Refer to [[DsPIC30F_5011_Development_Board#Bootloader_Development | bootloader section]]. |
| − | **Select a baudrate
| |
| − | **Select a COM port channel
| |
| − | * '''Stage 2: Autobaud rate detection and version control'''
| |
| − | **Continuously sending a character "U" [0x55] via COM port
| |
| − | **Continuously waiting for an acknowledgment character "U", [ACK] = [0x55]
| |
| − | **Send command character [0x03]
| |
| − | **Receive 3 characters 1) Major Version 2) Minor Version 3) Acknowledgment [0x55]
| |
| − | **Prints the version number [Major.Minor] (e.g. 1.1) on screen.
| |
| − | * '''Stage 3: Loading and writing the program'''
| |
| − | **Load the user hex file, check integrity.
| |
| − | **Start loading file using: | |
| − | ***Read command character [0x01] + 24-bit address [High][Medium][Low]
| |
| − | ***Receive 4-byte data [High][Medium][Low][ACK]
| |
| − | ***Write command character [0x02] + 24-bit address [High][Medium][Low]+ Number of bytes [N] + [data 0] + [data 1] + ... + [data N-1] + [CRC]=(INTEL HEX8 Checksum - Sum modulo 256)
| |
| − | ***Receive [ACK] or [NACK] = [0xFF]
| |
| − | ***Note: Writing is in row mode access (i.e. erase and write a whole row, each row has 32 instructions, or 96 bytes because each instruction has 24 bits)
| |
| − | ::# Ensure the initial address of writing match an initial row position,
| |
| − | ::# Send the data corresponding to the whole row.
| |
| − | | |
| − | | |
| − | ==USB-RS232 Bridge==
| |
| | | | |
| − | *As USB ports are becoming more and more common, COM ports and Parallel ports may be redundant in the next few years. This section explore the possibilities of programming the target board through a USB port.
| |
| − | *There are two options:
| |
| − | #Use an external USB/RS232 adaptor, the driver will emulate a virtual COM port, such as [http://www.prolific.com.tw/eng/downloads.asp?ID=31 Prolific] and [http://www.ftdichip.com/Drivers/VCP.htm FDTI]. Ingenia has tested its bootloader with some USB-232 manufacturers (silabs, FTDI, etc..). However, the programming failed with our Prolific adapter. Application program may use [http://java.sun.com/products/javacomm/ JavaComm API] (javax.comm) and/or [http://www.rxtx.org/ RXTX] to drive the COM port.
| |
| − | #Modified the bootloader program on PC to support USB communication. e.g. using [http://jusb.sourceforge.net/ jUSB] and [http://javax-usb.org/ JSR-80] (javax.usb). External circuits such as PIC18F4550 and MAX232 are required.
| |
| | | | |
| − | |--User's App.--|-------Device Manager------|-------USB-RS232 Interface------|---dsPIC---|
| + | ==Development Environment== |
| − | Option 1:
| |
| − | +-------------+ +----------+ +----------+ +---+ +------------+ +-----+ +--------+
| |
| − | | Application |--| JavaComm |--| Virtual |==|USB|--| FDTI |--|RS232|==| Target |
| |
| − | | Program | | RXTX | | COM Port | +---+ | Circuitary | +-----+ | Board |
| |
| − | +-------------+ +----------+ +----------+ +------------+ +--------+
| |
| − | Option 2:
| |
| − | +-------------+ +--------+ +---+ +------------+ +-----+ +--------+
| |
| − | | Application |----------| JSR-80 |==========|USB|--| PIC18F4550 |--|RS232|==| Target |
| |
| − | | Program | | jUSB | +---+ | MAX232 | +-----+ | Board |
| |
| − | +-------------+ +--------+ +------------+ +--------+
| |
| | | | |
| − | *Currently, when RXTX is incorporated with JavaComm API, operating systems supported include Linux, Windows, Mac OS, Solaris and other operating systems. On the other hand, jUSB and JSR-80 only works for linux.
| + | ===Windows=== |
| | | | |
| − | ===FDTI Chipset===
| + | [[Image:PIC_setup_win.JPG]] |
| − | *FT232RL communicates with PC via USB to provide 1 UART channel.
| |
| − | *Datasheet can be downloaded [http://www.ftdichip.com/Documents/DataSheets/DS_FT232R.pdf here].
| |
| − | **Refer to Fig. 11 (Page 19) for Bus Powered Configuration.
| |
| − | **Refer to Fig. 16 (Page 24) for for UART TTL-level Receive [RXD -> 1], Transmit [TXD -> 4], Transmit Enable [CBUS2/TXDEN -> 3]. Omit Receive Enable [CBUS3/PWREN#] and use [CBUS2/TXDEN -> 2]
| |
| − | **Refer to Fig. 15 (Page 23) for LED Configuration: [CBUS0/TXLED#] and [CBUS1/RXLED#]
| |
| − | *Virtual COM Port Drivers can be downloaded [http://www.ftdichip.com/Drivers/VCP.htm here].
| |
| | | | |
| | + | *C-Compiler, Assembler and Linker are under GNU license. |
| | + | **MPLAB C30 C Compiler (*.c -> *.s) |
| | + | **MPLAB ASM30 Assembler (*.s -> *.o) |
| | + | **MPLAB LINK30 Linker (*.o -> *.bin) |
| | | | |
| − | ==Programming the Device== | + | *PA optimizer, simulator, runtime libraries, header files, include files, and linker scripts are not covered by GNU. Reference is [http://direct.forum.microchip.com/tm.aspx?m=107208 here]. |
| | | | |
| − | ===Requirements===
| + | *Microchip has integrated ASM30, LINK30, assembly header files, linker scripts in MPLAB IDE, which is free for download. |
| − | *Hardware | + | *MPLAB C30 costs US$895. A 60-day free student version is also available. After 60-days, the optimizer is automatically disabled, while other tools can still function properly. |
| − | #PC with COM port (Windows XP Installed for MPLAB)
| |
| − | #ICD2 Programmer
| |
| − | #Target Board
| |
| − | #5V Power Supply
| |
| | | | |
| − | *Software | + | *C-libraries contained in C30 includes (Refer to [http://ww1.microchip.com/downloads/en/DeviceDoc/16bit_Language_Tool_Libraries_51456c.pdf 16-Bit Language Tools Libraries] from Microchip). |
| − | #[http://ww1.microchip.com/downloads/en/DeviceDoc/MP750.zip MPLAB IDE v7.50 or higher]
| |
| − | #[http://chungyan5.no-ip.org/websvn/listing.php dsPicProgrammer] ('''dsPicProgrammer.jar''')
| |
| − | #[http://users.frii.com/jarvi/rxtx/download.html RXTX driver]
| |
| | | | |
| − | *Files
| |
| − | #[http://chungyan5.no-ip.org/websvn/listing.php dsPicBootloader] ('''ingenia.hex'''). Original assembly code by ingenia can be downloaded from [http://www.ingenia-cat.com/download/iBL.s here].
| |
| − | #Application hex file (e.g. '''app.hex''')
| |
| | | | |
| − | ===Loading Bootloader (Once only)===
| |
| | {|border="1" cellspacing="0" cellpadding="5" | | {|border="1" cellspacing="0" cellpadding="5" |
| − | |+ Table 9.1 Loading Bootloader | + | |+ C Libraries in MPLAB C30 |
| − | ! Step !! Remarks | + | ! Library !! Directory <br>(\\Microchip\MPLAB C30) !! Major functions |
| | |-valign="top" | | |-valign="top" |
| − | | Install [http://ww1.microchip.com/downloads/en/DeviceDoc/MP750.zip MPLAB IDE] || | + | | DSP Library <br>(e.g. libdsp-coff.a) |
| − | *Do '''NOT''' connect ICD 2 (via USB) to PC
| + | | \lib <br> \src\dsp <br> \support\h |
| − | *Execute '''MPLAB vX.XX Install.exe'''
| + | | Vector, Matrix, Filter, etc. |
| | |-valign="top" | | |-valign="top" |
| − | | Install USB Driver || | + | | 16-Bit Peripheral Libraries |
| − | *Follow the instruction in (C:\Program Files\Microchip\MPLAB IDE\ICD2\Drivers\Ddicd2.htm)
| + | | \lib <br> \src\peripheral <br> \support\h |
| | + | | ADC12, IOPort, UART, I<sup>2</sup>C, etc. |
| | |-valign="top" | | |-valign="top" |
| − | | Select Target Chip || | + | | Standard C Libraries <br>(e.g. libc-coff.a, libm-coff.a, libpic-coff.a) |
| − | *Run MPLAB IDE on PC
| + | | \lib <br> \src\libm <br> \include |
| − | *Select: Configure>Select Devices...
| + | | stdio.h, time.h, float.h, math.h, |
| − | *Choose dsPIC30F5011
| |
| | |-valign="top" | | |-valign="top" |
| − | | Target <-> ICD 2 || | + | | MPLAB C30 Built-in Functions |
| − | *Use six pin cable. Beware of the pin assignments. Only pin 1 - 5 should be used. | + | | none |
| − | *Place Jumper on target board (if any). The Jumper connects target V<sub>cc</sub> to ICD 2. | + | | _buildin_addab, _buildin_add, _buildinmpy, etc |
| − | *Do '''NOT''' power-up the target. | + | |- |
| | + | |} |
| | + | |
| | + | ===Linux=== |
| | + | |
| | + | [[Image:PIC_setup_linux.JPG]] |
| | + | |
| | + | *C Compiler, Assembler and Linker are under GNU license. |
| | + | **The code can be downloaded from Microchip at [http://www.microchip.com/stellent/idcplg?IdcService=SS_GET_PAGE&nodeId=1406&dDocName=en023073 here]. |
| | + | **Current MPLAB ASM30 Assembler: v2.04 |
| | + | **Current MPLAB C30 Compiler: v2.04 |
| | + | *'''Important Note''': Only the compiler is free. The header files and library are owned by Microchip. |
| | + | |
| | + | {|border="1" cellspacing="0" cellpadding="5" |
| | + | |+ Pic30 C-Compiler Toolchain Templates for Conversion to Debian-based systems |
| | + | ! Toolchain Source !! Instruction !! Remarks |
| | |-valign="top" | | |-valign="top" |
| − | | ICD 2 <-> PC || | + | | [http://www.baycom.org/~tom/dspic/ v2.00] |
| − | *Plug-in ICD 2 to PC via USB cable
| + | | Download pic30-gcc-2.00-1.i386.rpm and pic30-binutils-2.00-1.i386.rpm.<br>Convert to deb files. |
| − | *Power-up the target.
| + | | Stable<br>Now using |
| − | *Select: Programmer>Select Programmer>MPLAB ICD 2
| |
| − | *If this is the first time the ICD 2 is connected to PC, MPLAB IDE will automatically download the required OS to ICD 2, wait until it has finished
| |
| − | *If you have not connected and powered up the target, you might see Warnings on invalid device IDs, and/or running self tests.
| |
| − | *See results of self test if necessary: Programmer>Settings, Status Tab. Refer to [http://ww1.microchip.com/downloads/en/DeviceDoc/51331B.pdf ICD2 User's Guide] Chapter 7.
| |
| | |-valign="top" | | |-valign="top" |
| − | | Load Bootloader || | + | | [http://www.nabble.com/Debian-templates-for-dsPIC-build-toolchain-2.05-td7886279.html v2.05] |
| − | *Select: File>Import...
| + | | Reference to example below, but use 2.05 files |
| − | *Select '''ingenia.hex'''
| + | | Can compile<br>Stable but not heavily tested |
| | |-valign="top" | | |-valign="top" |
| − | | Start Programming || | + | | [http://www.nabble.com/Debian-templates-for-dsPIC-build-toolchain-3.01-tf4308624.html v3.01] |
| − | *Select: Programmer>Program
| + | | Follow example below |
| | + | | Can compile<br>Unstable (sometime produce segmentation fault) |
| | |-valign="top" | | |-valign="top" |
| − | | Finishing || | + | | [http://www.nabble.com/Debian-Template-Patches-for-C30-v3.10-i386-td17534084.html v3.10] |
| − | *Power-down the Taget
| + | | Reference to example below, but use 3.10 files |
| − | *Select: Programmer>Select Programmer>None
| + | | Cannot compile yet (segmentation fault) |
| − | *Unplug USB cable
| |
| | |- | | |- |
| | |} | | |} |
| | + | ====Conversion Example==== |
| | + | *Pre-install these packages: dpkg-dev, debhelper, bison, flex, sysutils, gcc-3.3, fakeroot |
| | + | **cmd: '''sudo apt-get install dpkg-dev debhelper bison flex sysutils gcc-3.3 fakeroot''' |
| | + | *Download and unzip template: '''pic30-3.01.tar.bz2''' |
| | + | *Download assembler: '''mplabalc30v3_01_A.tar.gz'''. Save under /pic30-3.01/pic30-binutils-3.01/upstream/ |
| | + | *Download c-compiler: '''mplabc30v3_01_A.tgz'''. Save under /pic30-3.01/pic30-gcc-3.01/upstream/ |
| | + | *Install MPLAB_C30_v3_01-StudentEdition under Windows |
| | + | *Copy directories /include, /lib, /support, and /bin/c30_device.info to pic30-3.01/pic30-support-3.01/upstream/ |
| | + | *Pack pic30-binutils into deb file |
| | + | **goto /pic30-3.01/pic30-binutils-3.01/ |
| | + | **type cmd: '''dpkg-buildpackage -rfakeroot -b''' |
| | + | *Install pic30-binutils_3.01-1_i386.deb |
| | + | **type cmd: '''sudo dpkg -i pic30-binutils_3.01-1_i386.deb''' |
| | + | *Pack pic30-gcc-3.01 into deb file |
| | + | **goto /pic30-3.01/pic30-gcc-3.01/ |
| | + | **type cmd: '''dpkg-buildpackage -rfakeroot -b''' |
| | + | *Install pic30-gcc_3.01-1_i386.deb |
| | + | **type cmd: '''sudo dpkg -i pic30-gcc_3.01-1_i386.deb''' |
| | + | *Pack support files into deb file |
| | + | **goto /pic30-3.01/pic30-support-3.01/ |
| | + | **type cmd: '''dpkg-buildpackage -rfakeroot -b''' |
| | + | *Install pic30-support_3.01-1_all.deb |
| | + | **type cmd: '''sudo dpkg -i pic30-support_3.01-1_all.deb''' |
| | + | *After installation, locations of |
| | + | **C-Header (*.h): /usr/pic30-elf/include |
| | + | **Libraries (*.a): /usr/pic30-elf/lib |
| | + | **Assembly header (*.inc): /usr/share/pic30-support/inc |
| | + | **Linkerscript (*.gld): /usr/share/pic30-support/gld |
| | + | |
| | + | ===Burning Program Codes to Target Board=== |
| | + | #Use 'dspicprg and dspicdmp' utilities developed by [http://homerreid.ath.cx/misc/dspicprg/ Homer Reid] to burn hex code (*.hex) to devices. See Reference [http://forum.microchip.com/tm.aspx?m=94243 here]. Through serial port only? |
| | + | #Use [http://piklab.sourceforge.net/ Piklab IDE]. Details on file format not known. |
| | + | #Use [http://www.microchip.com/stellent/idcplg?IdcService=SS_GET_PAGE&nodeId=1406&dDocName=en019469&part=SW007002 MPLAB IDE] to burn hex code (*.hex) to devices. |
| | + | |
| | + | ===Code Optimization=== |
| | + | *Below is a comparsion between different optimization levels for the project including drivers for 2 projects. |
| | | | |
| − | ===Loading Application===
| |
| | {|border="1" cellspacing="0" cellpadding="5" | | {|border="1" cellspacing="0" cellpadding="5" |
| − | |+ Table 9.2 Loading Application File | + | |+ Comparison between differnt optimization levels |
| − | ! Step !! Remarks | + | ! Optimization !! Description !! Project 1<br>Code Size<br>(byte) !! Project 1<br>Data Usage<br>(byte) !! Project 2<br>Code Size<br>(byte) !! Project 2<br>Data Usage<br>(byte) |
| | |-valign="top" | | |-valign="top" |
| − | | Install RXTX || | + | | O0 |
| − | *For Windows User:
| + | | No optimization<br>Fastest Compilation |
| − | **copy RXTXcomm.jar to \jre\lib\ext (under java)
| + | | 6222 (9%) || 178 (4%) || 26,037 (38%) || 710 (17%) |
| − | **copy rxtxSerial.dll to \jre\bin
| |
| − | *For Linux User:
| |
| − | **copy RXTXcomm.jar to /jre/lib/ext (under java)
| |
| − | **copy librxtxSerial.so to /jre/lib/[machine type] (i386 for instance)
| |
| | |-valign="top" | | |-valign="top" |
| − | | Connect target board || | + | | O1 |
| − | *For Windows User:
| + | | Optimize<br> Tries to reduce code size and execution time. |
| − | **connect to COM1 (or other useable port)
| + | | 4473 (6%) || 178 (4%) || 22,290 (32%) || 710 (17%) |
| − | *For Linux User:
| |
| − | **connect to ttyS0 (or other useable port)
| |
| | |-valign="top" | | |-valign="top" |
| − | | Open a console window || | + | | O2 |
| − | *In Windows, Start>Run, and type cmd.
| + | | Optimize even more<br> Performs nearly all supported optimizations <br>that do not involve a space-speed trade-off. <br>Increases both compilation time and the <br>performance of the generated code. |
| | + | | 4422 (6%) || 178 (4%) || 21,993 (32%) || 710 (17%) |
| | |-valign="top" | | |-valign="top" |
| − | | Start Programming || | + | | O3 |
| − | *Change to the directory containing dsPicProgrammer.jar
| + | | Optimize yet more. <br>O3 turns on all optimizations specified by O2 <br>and also turns on the inline-functions option. |
| − | *Execute dsPicProgrammer.jar
| + | | 4485 (6%) || 178 (4%) || 22,176 (32%) || 710 (17%) |
| − | **For Windows User: java -jar dsPicProgrammer.jar COMi Y:\foo2\app.hex
| |
| − | **For Linux User: java -jar dsPicProgrammer.jar /dev/ttySi Y:/foo2/app.hex
| |
| − | *Power-up target board
| |
| | |-valign="top" | | |-valign="top" |
| − | | Finishing || | + | | Os |
| − | *Power-down target board
| + | | Optimize for size. <br>Os enables all O2 optimizations that do not <br>typically increase code size. It also performs <br>further optimizations designed to reduce code <br>size. |
| − | *Disconnect from COM port
| + | | 4356 (6%) || 178 (4%) || 21,885 (32%) || 710 (17%) |
| | |- | | |- |
| | |} | | |} |
| | | | |
| | | | |
| − | ==Remote Access== | + | ==[[freertos_posix Development | Driver Development]]== |
| − | *At the moment, local devices (e.g. EEPROM, ADC, DAC, etc.) can only be accessed locally through POSIX functions such as open(), read(), write(), ioctl(). | + | *Description on developing drivers with POSIX API |
| − | *However, a client may need to access these devices on a remote server. This section reviews the background and gives some ideas on its possible implementation. | + | |
| | + | |
| | + | ==[[Bootloader Development]]== |
| | + | *Description on concepts and development on bootloader |
| | + | *Description on dsPicProgrammer to download firmware via bootloader |
| | | | |
| − | ===Requirements===
| |
| − | *A remote file access protocol, to transfer "files" (i.e. device's data) such as:
| |
| − | #[http://en.wikipedia.org/wiki/FTP File Transfer Protocol] (FTP): Required files are copied from sever to client for manipulation
| |
| − | #[http://en.wikipedia.org/wiki/Remote_Shell Remote Shell] (RSH): Required files are copied from sever to client for manipulation
| |
| − | #[http://en.wikipedia.org/wiki/Network_File_System_%28Sun%29 Network File System] (NFS): Required files are manipulated on sever
| |
| − | *An API to access files using a selected protocol, such as:
| |
| − | #[http://www.die.net/doc/linux/man/man2/lam_rfposix.2.html lam_rfposix]: A POSIX-like remote file service for Local Area Multicomputer
| |
| − | #API employed by VxWorks: [http://en.wikipedia.org/wiki/VxWorks VxWorks] is a Unix-like real-time operating system, commonly used for embedded systems.
| |
| | | | |
| − | ===API Reference for VxWorks=== | + | ==[[Programming the Device]]== |
| − | *Reference:
| + | *Description on how to use dsPicProgrammer to download firmware to dspic |
| − | **[http://www.windriver.com/vxworks/ VxWorks Official Website]
| |
| − | **[http://www-cdfonline.fnal.gov/daq/commercial/ OS Libraries API Reference]
| |
| − | *Related Libraies | |
| − | **netDrv (netDrv.h): an API using FTP or RSH
| |
| − | **nfsDrv (nfsDrv.h): an API using NFS
| |
| | | | |
| | | | |
| − | ==To Do List==
| + | [[category:projects]] |
| − | #Construct examples codes for using DSP library
| |
| − | #Construct examples codes for using Build-in library
| |
| − | #GUI Interface for Benchtop boards
| |
