Difference between revisions of "Bootloader Development"
Jump to navigation
Jump to search
(Further reading) |
|||
(13 intermediate revisions by one other user not shown) | |||
Line 1: | Line 1: | ||
+ | Developing Bootloader for the [[DsPIC30F_5011_Development_Board]] | ||
+ | |||
==Concepts== | ==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. | + | *Programming with ICSP (In-Circuit Self Programming) 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. | + | *However, ICSP requires an external programmer (e.g. Microchip ICD2 debugger). |
*To allow the user to change the program after production but without the need of an external programmer, bootloader becomes useful. | *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. | + | *Bootloader is a small program installed via ICSP. Every time 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 (Run-time Self Programming) 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. | *The disadvantage of bootloaders is that they consume some of the memory of the device. | ||
Line 16: | Line 18: | ||
|- valign="top" | |- valign="top" | ||
| [http://www.ingenia-cat.com/index.php?lang=en ingenia] | | [http://www.ingenia-cat.com/index.php?lang=en ingenia] | ||
− | | | + | | Assembly |
− | | | + | | Windows |
− | | | + | | - |
| | | | ||
*Works for all dsPIC supporting RTSP | *Works for all dsPIC supporting RTSP | ||
Line 45: | Line 47: | ||
==dsPicBootloader== | ==dsPicBootloader== | ||
− | *The bootloader developed by ingenia | + | *The bootloader developed by ingenia was open source (unavailable now) and it has been modified to suit our development. Hereafter, the modified version is called dsPicBootloader. |
− | *Repository for download: [http://chungyan5.no-ip.org/vc | + | ===Download=== |
+ | *Repository for download: [http://chungyan5.no-ip.org/vc dsPicBootloader] | ||
**Download projects: "dspic_bootloader" and "intel_hex_parser" | **Download projects: "dspic_bootloader" and "intel_hex_parser" | ||
− | * | + | ===Usage=== |
+ | *[[Programming_the_Device#Loading_Bootloader_.28Once_only.29 | Instruction]] for usage | ||
+ | ===Features=== | ||
+ | *Before v1.05.00, the bootloader employs the following settings: | ||
+ | # Use U2ART channel | ||
+ | # Start up using internal FRC, phase-lock-loop x16, without auto-switching of clock source | ||
+ | # Watchdog timer disabled | ||
+ | # Clock switching disabled | ||
+ | # Primary oscillator disabled | ||
+ | # OSC2 Pin functions as digital I/O | ||
+ | *In v1.05.00, dsPicBootloader employs the following settings: | ||
+ | # Use U2ART channel | ||
+ | # Start up using internal FRC, phase-lock-loop x16, without auto-switching of clock source | ||
+ | # Watchdog timer disabled | ||
+ | # '''Clock switching enabled''' | ||
+ | # '''Primary oscillator configured to High Speed (OSC2 Pin cannot function as digital I/O)''' | ||
+ | *From v1.06.00 onwards, configuration registers can be overwritten, and employs the following settings: | ||
# Use U2ART channel | # Use U2ART channel | ||
− | # | + | # Start up using internal FRC, phase-lock-loop x16, without auto-switching of clock source |
− | + | # Watchdog timer disabled | |
− | + | # Clock switching enabled | |
− | + | # '''Primary oscillator disabled''' (if using external crystal crystal, configuration registers need to be erase and change) | |
− | + | # '''OSC2 Pin functions as digital I/O''' | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
==dsPicProgrammer (Java-based Multi-Platformed)== | ==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. | *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. | + | *A simple programmer (hereafter called dsPicProgrammer) written in Java and 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. |
− | *Repository for download: [http://chungyan5.no-ip.org/vc | + | ===Download=== |
+ | *Repository for download: [http://chungyan5.no-ip.org/vc dsPicProgrammer] | ||
**Download project: "dspicProgrammer" | **Download project: "dspicProgrammer" | ||
− | * | + | ===Usage=== |
+ | *[[Programming_the_Device#Download_and_Loading_Firmware | Instruction]] for usage | ||
+ | ===Features=== | ||
#Can be used on both Linux and Windows platforms. | #Can be used on both Linux and Windows platforms. | ||
− | #Adjustable baudrate (9600bps to | + | #Adjustable baudrate (9600bps to 115200bps<sup>[1]</sup>). |
− | #Support programming of dsPIC30F5011 | + | #Support programming of dsPIC30F5011, dsPIC33FJ128GP306, dsPIC33FJ256GP506<sup>[2]</sup> devices (Developers may add your devices). |
#Protection against overwriting bootloader codes on devices. | #Protection against overwriting bootloader codes on devices. | ||
#Detection if application program does not have its reset() at user's code start address. | #Detection if application program does not have its reset() at user's code start address. | ||
− | #Reprogramming can be done without powering down the target board, | + | #Reprogramming can be done without powering down the target board. By default, the target board is reset by sending a BREAK character. Users can implement their own reset algorithm by replacing the BreakReset() function. |
#Target board will run the user's program after programming is done. | #Target board will run the user's program after programming is done. | ||
+ | #Configuration registers can be changed<sup>[3]</sup>. | ||
#Can be used with USB-Serial Cables. Below is a list of tested cable: | #Can be used with USB-Serial Cables. Below is a list of tested cable: | ||
− | + | ====USB-to-COM Cable==== | |
− | + | *[http://www.prolific.com.tw/eng/Products.asp?ID=59 Prolific PL-2303 USB to Serial Bridge Controller]: [http://www.prolific.com.tw/eng/downloads.asp?ID=31 Driver download] | |
− | + | *[http://www.bafo.com BAFO Technologies] BF-810 USB Serial Adapter:[http://www.bafo.com/menu-support.asp Driver download] | |
+ | *[http://www.z-tek.com.cn/entw/en/index.asp Z-TEK] ZE400 USB 2.0 TO RS232 Cable:[http://www.z-tek.com.cn/entw/en/download.asp?driver_lei=windows Driver download] | ||
+ | **Comparison on relative speed of communication (on Linux, average over 500 samples) | ||
+ | {|border="1" cellspacing="0" cellpadding="5" | ||
+ | |+ | ||
+ | |- | ||
+ | ! !! Real COM port !! 1 USB-to-COM Cable !! 2 USB-to-COM Cables (Cable A) !! 2 USB-to-COM Cables (Cable B) !! 2 USB-to-COM Cables via Hub (Cable A) !! 2 USB-to-COM Cables via Hub (Cable B) | ||
+ | |- | ||
+ | ! Average (ms) || 19.47 || 23.81 || 23.91 || 23.75 || 22.72 || 23.06 | ||
+ | |- | ||
+ | ! Max (ms) || 36 || 41 || 41 || 35 || 45 || 37 | ||
+ | |- | ||
+ | ! Min (ms) || 10 || 10 || 10 || 9 || 9 || 10 | ||
+ | |} | ||
+ | |||
'''NOTE:'''<br> | '''NOTE:'''<br> | ||
− | [1] | + | [1] before version 1.5.2, the baudrate bounded at 57600bps.<br> |
− | [2] only dsPIC30 devices are compatible with the ingenia's programmer. For dsPIC33 devices, the protocol has been modified due to the increased flash size, and the dsPIC33 bootloader can only work with dsPicProgrammer. | + | [2] only dsPIC30 devices are compatible with the ingenia's programmer. For dsPIC33 devices, the protocol has been modified due to the increased flash size, and the dsPIC33 bootloader can only work with dsPicProgrammer.<br> |
+ | [3] before version 1.6.0, configuration registers cannot be changed. | ||
==Special Consideration== | ==Special Consideration== | ||
− | *The bootloader assumes that the user program starts at address 0x100. This is usually the case, but there are always exceptions. | + | *The bootloader assumes that the user program starts at address 0x100 (dspic30) or 0x200 (dspic33). This is usually the case, but there are always exceptions. |
− | *To ensure that the user program always starts at address | + | *To ensure that the user program always starts at the correct address, 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. | :*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 | .section .reset, code //previously .section .libc, code | ||
Line 129: | Line 143: | ||
+-------------------+ +------------------------------------+ | +-------------------+ +------------------------------------+ | ||
− | + | ===Resetting Target Device=== | |
− | + | *dsPicProgrammer sends a Break character (pull UART-TX to low logic, which is normally high). | |
− | + | *User's program on dsPic detects the break character and reset the chip | |
− | + | **NOTE: The user's program is expected to have the following code in order to enable this function. Otherwise, the target board must be restarted manually. | |
− | |||
− | |||
− | |||
− | |||
− | |||
void _ISR _U2RXInterrupt(void) | void _ISR _U2RXInterrupt(void) | ||
{ | { | ||
Line 162: | Line 171: | ||
_U2RXIF = 0; //Clear the flag | _U2RXIF = 0; //Clear the flag | ||
} | } | ||
− | + | ===Entering Ingenia's Protocol=== | |
− | + | *Transmission is conducted in 8N1, i.e. 8-bit, no parity, 1 stop-bit | |
− | + | *Communication Protocol is reviewed in [http://www.ingenia-cat.com/reference/doc/dt/ibl/16BIT.MAN.1486745188.pdf 16-bit PIC serial bootloader product manual]. The following summarizes the key steps on the PC side. | |
− | + | #Autobaud rate detection: dsPicProgrammer continuously sends a character "U" [0x55] via COM port and waits for an acknowledgment character "U", [ACK] = [0x55] | |
− | + | #Version Control: dsPicProgrammer sends the command character [0x03]. On success, dsPicProgrammer receives 3 characters i) Major Version ii) Minor Version iii) Acknowledgment [0x55] | |
− | + | #Device ID Monitoring: dsPicProgrammer sends the read command character [0x01] + 24-bit address [High][Medium][Low] (0xFF0000). Then, it receives 4-byte data [High][Medium][Low][ACK] | |
− | + | #Load the user hex file and check integrity | |
− | + | #Start Programming: dsPicProgrammer issues the write command character [0x02] + 24-bit address [High][Medium][Low]+ Number of bytes [High][Low] + [data 0] + [data 1] + ... + [data N-1] + [CRC]=(INTEL HEX8 Checksum - Sum modulo 256) and receives [ACK] or [NACK] = [0xFF] | |
− | + | ===Goto User's Program=== | |
− | + | *dsPicProgrammer sends the goto user code command [0x0F] | |
− | + | ||
+ | == Further reading == | ||
+ | |||
+ | * [[PIC Programmers, In Circuit Programming and BootLoaders]] |
Latest revision as of 20:28, 8 August 2009
Developing Bootloader for the DsPIC30F_5011_Development_Board
Contents
Concepts[edit]
- Programming with ICSP (In-Circuit Self Programming) 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 (e.g. Microchip ICD2 debugger).
- 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. Every time 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 (Run-time Self Programming) 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.
Developer | Source | Platform | User Guide | Remarks |
---|---|---|---|---|
ingenia | Assembly | Windows | - |
|
Tiny | Assembly | Windows | Web |
|
Elektronika | Hex | Windows | txt |
|
dsPicBootloader[edit]
- The bootloader developed by ingenia was open source (unavailable now) and it has been modified to suit our development. Hereafter, the modified version is called dsPicBootloader.
Download[edit]
- Repository for download: dsPicBootloader
- Download projects: "dspic_bootloader" and "intel_hex_parser"
Usage[edit]
- Instruction for usage
Features[edit]
- Before v1.05.00, the bootloader employs the following settings:
- Use U2ART channel
- Start up using internal FRC, phase-lock-loop x16, without auto-switching of clock source
- Watchdog timer disabled
- Clock switching disabled
- Primary oscillator disabled
- OSC2 Pin functions as digital I/O
- In v1.05.00, dsPicBootloader employs the following settings:
- Use U2ART channel
- Start up using internal FRC, phase-lock-loop x16, without auto-switching of clock source
- Watchdog timer disabled
- Clock switching enabled
- Primary oscillator configured to High Speed (OSC2 Pin cannot function as digital I/O)
- From v1.06.00 onwards, configuration registers can be overwritten, and employs the following settings:
- Use U2ART channel
- Start up using internal FRC, phase-lock-loop x16, without auto-switching of clock source
- Watchdog timer disabled
- Clock switching enabled
- Primary oscillator disabled (if using external crystal crystal, configuration registers need to be erase and change)
- OSC2 Pin functions as digital I/O
dsPicProgrammer (Java-based Multi-Platformed)[edit]
- 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 and based on the library developed by 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.
Download[edit]
- Repository for download: dsPicProgrammer
- Download project: "dspicProgrammer"
Usage[edit]
- Instruction for usage
Features[edit]
- Can be used on both Linux and Windows platforms.
- Adjustable baudrate (9600bps to 115200bps[1]).
- Support programming of dsPIC30F5011, dsPIC33FJ128GP306, dsPIC33FJ256GP506[2] devices (Developers may add your devices).
- Protection against overwriting bootloader codes on devices.
- Detection if application program does not have its reset() at user's code start address.
- Reprogramming can be done without powering down the target board. By default, the target board is reset by sending a BREAK character. Users can implement their own reset algorithm by replacing the BreakReset() function.
- Target board will run the user's program after programming is done.
- Configuration registers can be changed[3].
- Can be used with USB-Serial Cables. Below is a list of tested cable:
USB-to-COM Cable[edit]
- Prolific PL-2303 USB to Serial Bridge Controller: Driver download
- BAFO Technologies BF-810 USB Serial Adapter:Driver download
- Z-TEK ZE400 USB 2.0 TO RS232 Cable:Driver download
- Comparison on relative speed of communication (on Linux, average over 500 samples)
Real COM port | 1 USB-to-COM Cable | 2 USB-to-COM Cables (Cable A) | 2 USB-to-COM Cables (Cable B) | 2 USB-to-COM Cables via Hub (Cable A) | 2 USB-to-COM Cables via Hub (Cable B) | |
---|---|---|---|---|---|---|
Average (ms) | 19.47 | 23.81 | 23.91 | 23.75 | 22.72 | 23.06 |
Max (ms) | 36 | 41 | 41 | 35 | 45 | 37 |
Min (ms) | 10 | 10 | 10 | 9 | 9 | 10 |
NOTE:
[1] before version 1.5.2, the baudrate bounded at 57600bps.
[2] only dsPIC30 devices are compatible with the ingenia's programmer. For dsPIC33 devices, the protocol has been modified due to the increased flash size, and the dsPIC33 bootloader can only work with dsPicProgrammer.
[3] before version 1.6.0, configuration registers cannot be changed.
Special Consideration[edit]
- The bootloader assumes that the user program starts at address 0x100 (dspic30) or 0x200 (dspic33). This is usually the case, but there are always exceptions.
- To ensure that the user program always starts at the correct address, 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
Communication Protocol[edit]
+-------------------+ +-------------------+----------------+ | dsPicProgrammer | | dsPicBootloader | User's Program | +-------------------+ +-------------------+----------------+ | PC | | Target dsPic | +-------------------+ +------------------------------------+ | COM PORT |=============| UART | +-------------------+ +------------------------------------+
Resetting Target Device[edit]
- dsPicProgrammer sends a Break character (pull UART-TX to low logic, which is normally high).
- User's program on dsPic detects the break character and reset the chip
- NOTE: The user's program is expected to have the following code in order to enable this function. Otherwise, the target board must be restarted manually.
void _ISR _U2RXInterrupt(void) { //No Framming error if( U2STAbits.FERR == 0) { //Normal procedure } //Framming error else { if ( U2STAbits.URXDA ){ unsigned char data; data = (unsigned char) U2RXREG; if(data == 0x00){ // A break char has been received: // U2RX has been pulled to zero for more than 13 bits // This is used to reboot the pic mdelay(800); //wait for break character to clear asm("reset"); //software reset } } } _U2RXIF = 0; //Clear the flag }
Entering Ingenia's Protocol[edit]
- Transmission is conducted in 8N1, i.e. 8-bit, no parity, 1 stop-bit
- Communication Protocol is reviewed in 16-bit PIC serial bootloader product manual. The following summarizes the key steps on the PC side.
- Autobaud rate detection: dsPicProgrammer continuously sends a character "U" [0x55] via COM port and waits for an acknowledgment character "U", [ACK] = [0x55]
- Version Control: dsPicProgrammer sends the command character [0x03]. On success, dsPicProgrammer receives 3 characters i) Major Version ii) Minor Version iii) Acknowledgment [0x55]
- Device ID Monitoring: dsPicProgrammer sends the read command character [0x01] + 24-bit address [High][Medium][Low] (0xFF0000). Then, it receives 4-byte data [High][Medium][Low][ACK]
- Load the user hex file and check integrity
- Start Programming: dsPicProgrammer issues the write command character [0x02] + 24-bit address [High][Medium][Low]+ Number of bytes [High][Low] + [data 0] + [data 1] + ... + [data N-1] + [CRC]=(INTEL HEX8 Checksum - Sum modulo 256) and receives [ACK] or [NACK] = [0xFF]
Goto User's Program[edit]
- dsPicProgrammer sends the goto user code command [0x0F]