dsPIC30F2010 CCS PICC Bootloaders Example

Overview

A boot-loader is a computer program that is responsible for booting a computer and booting an operating system. If it also provides an interactive menu with multiple boot choices then it's often called a boot manager.

dsPIC30F2010 ds18B20 Demo Program with Boot Loader

It also applicable for some 8-bit micro-controller with self re-programmable under software control capabilities, for instance the PIC16F877A, PIC16F887, PIC18F4550, dsPIC30F1010, dsPIC30F2010 etc. It's a block of micro-controller program that manage the process of loading embedded program to any location of Flash memory. It must locates at beginning or at the end of micro-controller Flash memory address.

The dsPIC30F2010 is a self re-programmable Flash micro-controller that allow the user to take the advantage of using a boot loader program.

Program Space Memory Map for dsPIC30F2010

The user just need to burn its boot-loader firmware once using a conventional device programmer, for instance a serial port JDM programmer or even a USB PICKIT3. Then the following embedded program must reserves the boot-loader memory section to prevent ROM program overwriting.  

Preliminary Boot Loader Firmware Flashing to dsPIC30F2010

The boot loader section should locate at the beginning or at the last section of Flash program memory space. However locating it at beginning is very suitable to prevent boot loader program overwriting that can destroy the boot loader functionalities. 

A boot-load embedded program can be uploaded to its target MCU an appropriate host PC boot-loader software on any OS platform via a typical serial port or even a USB port. CCS PICC provides a serial port and USB port boot-loader for some of their devices.

CCS PICC PCD Boot Loader Example

Boot Loader for 8-bit PIC Micro-controllers  

CCS PICC provide C boot/boot-loader C driver and example for its target chips. For its 8-bit PIC16 and PIC18 chips there are a "bootloader.h" header file and "loader.c" C driver. We can check its "ex_bootloader.c" for boot-loader firmware and "ex_bootload.c" for boot program example. In that example, the boot-loader firmware locates at the beginning of program memory. This example boot the program via RS-232 port.

On the other hand we can use CCS PICC Create Project Wizard to generate a boot-loader firmware for 8-bit PIC micro-controllers. There are two options, boot-loader at the start of memory and boot-loader at the end of memory. 

There many method of bootloading the program such as I2C and USB. 

Boot Loader for 16-bit PIC Micro-controllers  

Since the architecture of 16-bit DSC PIC micro-controllers are far different from the 8-bit PIC micro-controllers, the boot-loader C driver are in separated files. There are two C driver files, the "pcd_bootloader.h" and the "loader_pcd.c" C source files. 

There are two C examples file of using the PCD boot-loader firmware. The "ex_pcd_bootloader.c" is firmware of boot-loader prior to boot program. It requires a user input button and reset button to enter firmware loading mode. The "ex_pcd_bootload.c" C sample program is an example of loading the boot program into the chip. It use CCS PICC Serial Input/Output software and boot-loader software to load the program. In this program the boot-loader section locates at the beginning of the program.

Some newer version of CCS PICC as an instance of CCS PICC v5.119 has problem when compiling the boot-loader firmware for some dsPIC30FXXXX series. However I use an older version of CCS PICC v5.049 instead. It works very well without errors and problems.

CCS PICC v5.049 IDE

Boot Loader firmware

Initially I need to prepare a boot-loader firmware for my dsPIC30F2010 DSC.

pcd_bootloader.c

1. 
   /*CCS PICC Compiler version 5.049*/
2. #include <30F2010.h>
3. #fuses HS,NODEBUG,NOWDT,PR,CKSFSM
4. #use delay(clock=20000000)
5. #use rs232(BAUD=9600,UART1)
6. 
   
7. #define PUSH_BUTTON PIN_C14
8. #define BOOT_LED PIN_D0
9. 
   
10. #define _bootloader
11. //#define BOOTLOADER_MODE2X
12. 
    
13. #include <pcd_bootloader.h>
14. #include <loader_pcd.c>
15. 
    
16. #org APPLICATION_START
17. void application(void)
18. {
19. while(TRUE);
20. }
21. 
    
22. void main(void)
23. {
24. output_c(0);
25. output_d(0);
26. set_tris_d(0);
27. set_tris_c(1<<14);
28. //set_pullup(TRUE,PUSH_BUTTON);
29. output_high(PUSH_BUTTON);
30. if(!input(PUSH_BUTTON))
31. {
32. output_high(BOOT_LED);
33. // Let the user know it is ready to accept a download
34. printf("\r\nWaiting for download...");
35. // Load the program
36. load_program();
37. }
39. output_low(BOOT_LED);
40. application();
42. while(1);
44. }
45. 
    
46. #int_default
47. void isr(void)
48. {
49. jump_to_isr(LOADER_END+5);
50. }
51. 
    

After compile this program I need to burn its hex file into my target chip using a PICKIT2 device programmer.

Preliminary Boot Loader Firmware Flashing to dsPIC30F2010

From this point the dsPIC30F2010 has a start-of-memory boot-loader firmware. It doesn't need a device programmer any more. That is a blank program that contain only boot-loader section. To test how it works we just, 

1- press and hold the input push button connects to pin RC14

2- at the same time press the reset button and release them.

3- then you will see an LED(pin RD0) turns on the micro-controller enter its loading program mode. 

The dsPIC30F2010 Prototype Board waiting for program loading

 

dsPIC30F2010 waiting for loading program from host PC

 

Click here to download this example package.

Boot Load Example Program

From here we can load any firmware with a boot loader setting to dsPIC30F2010 via host PC serial port and CCS PICC boot loader software. I modify the "ex_pcd_bootload.c" to blinks an LED then I load it into the dsPIC30F2010 via CCS PICC boot-loader software.

1. 
   
2. /*CCS PICC Compiler version 5.049*/
3. #include <30F2010.h>
4. #fuses HS,NODEBUG,NOWDT,PR,CKSFSM
5. #use delay(clock=20M)
6. #use rs232(UART1,BAUD=9600)
7. 
   
8. //#define BOOTLOADER_MODE2X
9. 
   
10. //This is a necessary include file. It reserves space so that the
11. //bootloader is not overwritten.
12. #include <pcd_bootloader.h>
13. 
    
14. #define LED_0 PIN_D1
15. 
    
16. print_message(void){
17. delay_ms(10);
18. printf("\rCCS PICC v5.049 PCD BOOTLOADER\n\r");
19. }
20. 
    
21. void main()
22. {
23. print_message();
24. unsigned int16 counter=0;
25. output_d(0);
26. set_tris_d(0);
29. while(TRUE)
30. {
31. output_toggle(LED_0);
32. printf("Counter Variable: %Lu\n\r",counter);
33. counter++;
34. delay_ms(1000);
35. }
36. }

After compile this program we just press and hold the boot button, and then press and release the reset pin to enter programming loading mode.

Make sure that the SIOW.exe is already open and connected with an appropriate baud rate. 

press and hold the boot button, and then press and release the reset pin

 

CCS PICC SIOW Waiting for download

 

Click on CCS PICC Bootloader tool

 

Downloading Program

After the program downloading is completed the application on the MCU will run.

Running Program

 Click here to download this example.

ds18B20 LCD Example with Boot-Loader

I modify my program in this post adding a boot-loader program. However it consumes more program memory. I copied the "ds18b20.c" to my project folder since the older version of v5.049 doesn't have this driver.

• pcd_bootload_ds18b20_lcd.c

  

1. 
   /*CCS PICC Compiler version 5.049*/
2. #include <30F2010.h>
3. #fuses HS,NODEBUG,NOWDT,PR,CKSFSM
4. #use delay(clock=20M)
5. #use rs232(UART1,BAUD=9600)
6. 
   
7. //#define BOOTLOADER_MODE2X
8. 
   
9. //This is a necessary include file. It reserves space so that the
10. //bootloader is not overwritten.
11. #include <pcd_bootloader.h>
12. 
    
13. #define PIN_DS18B20_DATA PIN_B0
14. #include "ds18b20.c"
15. 
    
16. #define LCD_RS_PIN PIN_E4
17. #define LCD_RW_PIN PIN_E5
18. #define LCD_ENABLE_PIN PIN_E5
20. #define LCD_DATA4 PIN_E0
21. #define LCD_DATA5 PIN_E1
22. #define LCD_DATA6 PIN_E2
23. #define LCD_DATA7 PIN_E3
24. 
    
25. #include "lcd.c"
26. 
    
27. #define lcd_clear() lcd_putc('\f')
28. #define lcd_home() lcd_putc('\a')
29. /*For 16x4 LCD Only*/
30. #define line_1() lcd_send_byte(0,0x80);
31. #define line_2() lcd_send_byte(0,0xC0);
32. #define line_3() lcd_send_byte(0,0x90);
33. #define line_4() lcd_send_byte(0,0xD0);
34. 
    
35. print_message(void){
36. delay_ms(10);
37. printf("\rCCS PICC v5.049 PCD BOOTLOADER\n\r");
38. }
39. 
    
40. void main(){
41. print_message();
42. signed int16 val;
44. printf("\n\rdsPIC30F2010 Prototype Board.");
45. printf("\n\rSaturday 26th September 2025");
46. printf("\n\rds18b20 Humidity Sensor Example\n\r");
47. printf("\r\n\r\ds18b20.c - DHT11 example starting\r\n\r\n");
48. ds18b20_init();
49. lcd_init();
51. printf(LCD_PUTC,"dsPIC30F2010 LCD");
52. line_2();
53. printf(LCD_PUTC,"ds18b20 Sensor");
54. line_3();
55. printf(LCD_PUTC,"PCD BootLoader");
56. line_4();
57. printf(LCD_PUTC,"CCS PICC v5.049");
58. delay_ms(5000);
59. lcd_clear();
61. while(1){
62. ds18b20_read(&val);
63. printf("temperature = %ldC\r\n", val/(signed int16)16);
64. lcd_home();
65. printf(LCD_PUTC," ds18b20 Sensor");
66. line_2();
67. printf(LCD_PUTC," Temperature");
68. line_3();
69. printf(LCD_PUTC," %ld%cC",val/(signed int16)16,0xDF);
70. line_4();
71. printf(LCD_PUTC," and %f%cF",1.8*(val/(signed int16)16)+32,0xDF);
72. delay_ms(1000);
73. }
74. }

Since the boot-loader section locates at the start of program memory. It doesn't matter even the the compiled boot-load application exceeds the the ROM capacity. It just has an abnormal function.

CCS PICC Memory Use

 I tested it on my DIY dsPIC30F2010 Prototype Board.

Downloading the program

 

After uploading this program we can see the result.

Data send over serial port

 This C driver work fine as I prototype it on my PCBA.

dsPIC30F2010 ds18B20 Demo Program with Boot Loader

 

ds18B20 Temperature Sensor Reading

Click here to download this example.

DHT-11 LCD Example with Boot-Loader

I add this boot-load feature to my previous programming example that the dsPIC30F2010 read the humidity and temperature data from a DHT-11 environmental sensor. The result will display on a TC1604A-04 16x4 LCM. 

1. 
   
2. /*CCS PICC Compiler version 5.049*/
3. #include <30F2010.h>
4. #fuses HS,NODEBUG,NOWDT,PR,CKSFSM
5. #use delay(clock=20M)
6. #use rs232(UART1,BAUD=9600)
7. 
   
8. //#define BOOTLOADER_MODE2X
9. 
   
10. //This is a necessary include file. It reserves space so that the
11. //bootloader is not overwritten.
12. #include <pcd_bootloader.h>
13. 
    
14. #define LED_0 PIN_D1
15. 
    
16. #define PIN_DHT11_DATA PIN_B0
17. #include "dht11.c"
19. #define LCD_RS_PIN PIN_E4
20. #define LCD_RW_PIN PIN_E5
21. #define LCD_ENABLE_PIN PIN_E5
23. #define LCD_DATA4 PIN_E0
24. #define LCD_DATA5 PIN_E1
25. #define LCD_DATA6 PIN_E2
26. #define LCD_DATA7 PIN_E3
27. 
    
28. #include "lcd.c"
29. 
    
30. #define lcd_clear() lcd_putc('\f')
31. #define lcd_home() lcd_putc('\a')
32. /*For 16x4 LCD Only*/
33. #define line_1() lcd_send_byte(0,0x80);
34. #define line_2() lcd_send_byte(0,0xC0);
35. #define line_3() lcd_send_byte(0,0x90);
36. #define line_4() lcd_send_byte(0,0xD0);
37. 
    
38. print_message(void){
39. delay_ms(10);
40. printf("\rCCS PICC v5.049 PCD BOOTLOADER\n\r");
41. }
42. 
    
43. void main()
44. {
45. print_message();
46. unsigned int8 relativeHumidity;
47. unsigned int8 tempC;
49. printf("\n\rdsPIC30F2010 Prototype Board.");
50. printf("\n\rFriday 26 September 2025");
51. printf("\n\rDHT-11 Humidity Sensor Example\n\r");
52. printf("\r\n\r\dht-11.c - DHT11 example starting\r\n\r\n");
54. dht11_init();
55. lcd_init();
57. printf(LCD_PUTC,"dsPIC30F2010 LCD");
58. line_2();
59. printf(LCD_PUTC,"DHT-11 Sensor");
60. line_3();
61. printf(LCD_PUTC,"PCD BootLoader");
62. line_4();
63. printf(LCD_PUTC,"CCS PICC v5.049");
64. delay_ms(5000);
65. lcd_clear();
67. while(1){
68. dht11_read(&relativeHumidity, &tempC);
69. printf("HUMIDITY=%03u%%, TEMPERATURE=%02uC\r\n", relativeHumidity, tempC);
70. lcd_home();
71. printf(LCD_PUTC," DHT-11 Sensor");
72. line_2();
73. printf(LCD_PUTC," Reading:");
74. line_3();
75. printf(LCD_PUTC,"Humidity: %03u%%",relativeHumidity);
76. line_4();
77. printf(LCD_PUTC,"Temperature:%02u%cC",tempC,0xDF);
78. output_toggle(LED_0);
79. delay_ms(1000);
80. }
81. }

 The total line of program instructions is less then the previous example (275 instructions).

Program Uploading

 The sensor data also send over the PC serial port.

 

CCS PICC SIOW Data Sending

Start-Up Program

Environmental Data Reading/Displaying

 

Click here to download this example.

dsPIC30F2010 and ds18B20 Temperature Interfacing

The DS18B20 is a digital thermometer that able to convert the temperature from -55 to +125 degree Celsius. The controller communicates with this temperature sensor using a 1-Wire bus. So this device requires only three wires including GND, VCC, and data line. Furthermore it can use data line to power  the device eliminating the VCC. 

 

This device also work in TTL logic level that could interface with the dsPIC30F2010 using its digital bi-directional I/O. 

DS18B20 Pin Configuration

DS18B20 In TO-92 Package

For more information and interfacing this sensor with a micro-controller please check this post. 

The newer version of CCS PICC (v5.119) have a C driver "ds18b20.c"for this device that allow the programmer to call it using a few lines of code. It's effective and fast.

The following example I use RB0 of dsPIC30F2010 to read the temperature sensor from a single wire ds18b20 temperature sensor. The sensor's data will be send over the RS-232 between the micro-controller and the host PC. I also added a TC1604A-04 16x4 LCD to display the temperature data in degree Celsius and Fahrenheit.  

• CCS PICC Source Code (v5.119) 

 

1. 
   /*CCS PICC Compiler version 5.119*/
2. #include <30F2010.h>
3. #fuses HS,NODEBUG,NOWDT,PR,CKSFSM
4. #use delay(clock=20M)
5. #use rs232(UART1,BAUD=9600)
6. 
   
7. 
   
8. #define PIN_DS18B20_DATA PIN_B0
9. #include "ds18b20.c"
10. 
    
11. #define LCD_RS_PIN PIN_E4
12. #define LCD_RW_PIN PIN_E5
13. #define LCD_ENABLE_PIN PIN_E5
15. #define LCD_DATA4 PIN_E0
16. #define LCD_DATA5 PIN_E1
17. #define LCD_DATA6 PIN_E2
18. #define LCD_DATA7 PIN_E3
19. 
    
20. #include "lcd.c"
21. 
    
22. #define lcd_clear() lcd_putc('\f')
23. #define lcd_home() lcd_putc('\a')
24. /*For 16x4 LCD Only*/
25. #define line_1() lcd_send_byte(0,0x80);
26. #define line_2() lcd_send_byte(0,0xC0);
27. #define line_3() lcd_send_byte(0,0x90);
28. #define line_4() lcd_send_byte(0,0xD0);
29. 
    
30. 
    
31. 
    
32. void main(){
34. signed int16 val;
36. printf("\n\rdsPIC30F2010 Prototype Board.");
37. printf("\n\rSaturday 26th September 2025");
38. printf("\n\rds18b20 Humidity Sensor Example\n\r");
39. printf("\r\n\r\ds18b20.c - DHT11 example starting\r\n\r\n");
40. ds18b20_init();
41. lcd_init();
43. printf(LCD_PUTC,"dsPIC30F2010 LCD");
44. line_2();
45. printf(LCD_PUTC,"ds18b20 Sensor");
46. line_3();
47. printf(LCD_PUTC,"Programming");
48. line_4();
49. printf(LCD_PUTC,"CCS PICC v5.049");
50. delay_ms(5000);
51. lcd_clear();
53. while(1){
54. ds18b20_read(&val);
55. printf("temperature = %ldC\r\n", val/(signed int16)16);
56. lcd_home();
57. printf(LCD_PUTC," ds18b20 Sensor");
58. line_2();
59. printf(LCD_PUTC," Temperature");
60. line_3();
61. printf(LCD_PUTC," %ld%cC",val/(signed int16)16,0xDF);
62. line_4();
63. printf(LCD_PUTC," and %f%cF",1.8*(val/(signed int16)16)+32,0xDF);
64. delay_ms(1000);
65. }
66. }

 I modified the "lcd.c" C driver file to make it works with my TC1604A-04 LCM module. So I need to copy this driver file to my project folder. The "ds18b20.c" C driver file is already existed in the driver folder of CCS PICC v5.119. But I also copied to my project folder.

This program needs 51% of ROM and 36% of RAM.

Serial Input/Output Monitor

I use my DIY dsPIC30F2010 Prototype Board offered by PCBWAY to test this programming example.

Start Up Program

ds18B20 Temperature Reading

Click here to download this example.

 

dsPIC30F2010 and DHT-11 Environmental Sensor Interfacing

The DHT11 temperature and humidity sensor features a temperature and humidity sensor
complex with a calibrated digital signal output. By using the exclusive digital-signal-acquisition
technique and temperature and humidity sensing technology, it ensures high reliability and
excellent long-term stability. This sensor includes a resistive-type humidity measurement
component and an NTC temperature measurement component, and connects to a high performance 8-bit micro-controller, offering excellent quality, fast response, anti-interference
ability and cost-effectiveness.

Its standard TTL bi-directional I/O suitable for dsPIC30F2010 Interfacing and Programming. It needs only three wires, +5VDC, DATA and GND. Its DATA pin requires a weak pull up resistor with a resistance around 4.7k. 

I use my dsPIC30F2010 DIY Prototype Board to test this program. 

DHT11 Humidity & Temperature
Sensor

Parameters

Relative Humidity
Resolution：             16Bit
Repeatability：         ±1%RH
Accuracy：               25℃ ±5%RH
Interchangeability：  Fully interchangeable
Response time：       1/e (63%)25℃ 6s
                                1m/s Air 6s
Hysteresis：             <±0.3%RH
Long-term stability： <±0.5%RH/yr

Temperature
Resolution：             16Bit
Repeatability：         ±1℃
Accuracy：               25℃ ±2℃
Response time：       1/e (63%) 10S

Electrical Characteristics
Power supply：         DC 3.3～ 5.5V
Supply current：       Measure 0.3mA Standby 60μA
Sampling period：     Secondary Greater than 2 seconds 

For more detail about interfacing this sensor with a micro-controller please see this post. 

dsPIC30F2010 CCS PICC Programming

The newer version of CCS PICC (v5.119) has a C driver for the DHT-11 environmental sensor that could be called using a few lines of code. The "dht11.c" C driver locates in the drivers directory in program files. I use pin RB0 of dsPIC30F2010 to interface with this sensor.

The following example shows a simple sensor reading and data displaying over the RS-232.

• board.h 

1. #include <30F2010.h>
2. #device ICSP=1
3. #fuses HS,NODEBUG,NOWDT,PR,CKSFSM
4. #use delay(crystal=20000000)
5. 
   
6. #define LED0 PIN_D0
7. #define LED1 PIN_D1
8. #define SW0 PIN_C13
9. #define SW1 PIN_C14
10. 
    
11. #define DELAY 500
12. 
    
13. #use rs232(UART1, baud=9600, stream=UART_PORT1)

 

•  main.c

1. #include "board.h"
2. 
   
3. #define PIN_DHT11_DATA PIN_B0
4. #include <dht11.c>
5. 
   
6. void main(){
7. unsigned int8 relativeHumidity;
8. unsigned int8 tempC;
9. printf("\n\rdsPIC30F2010 Prototype Board.");
10. printf("\n\rWednesday 25 September 2025");
11. printf("\n\rDHT-11 Humidity Sensor Example\n\r");
12. printf("\r\n\r\dht-11.c - DHT11 example starting\r\n\r\n");
13. dht11_init();
14. delay_ms(1000);
15. while(1){
16. dht11_read(&relativeHumidity, &tempC);
17. printf("HUMIDITY=%03u%%, TEMPERATURE=%02uC\r\n", relativeHumidity, tempC);
18. delay_ms(2000);
19. }
20. }

 

• Memory Use 

•  Serial Input/Output Monitor

 

  Click here to download this example.

I add a 16x4 LCD (TC1604A-04) to display temperature and humidity data. Using a character LCD is very conventional for most small micro-controller programming and interfacing. I copied the "lcd.c" 16x2 LCD C driver to my project folder that I can modify it without changing the original file. I disable the LCD R/W pin (wire to GND) and I upgrade this LCD driver to a 16x4 LCD.

Its "board.h" header file remains the same to above example. 

• main.c

 

1. #include "board.h"
2. 
   
3. #define PIN_DHT11_DATA PIN_B0
4. #include <dht11.c>
5. 
   
7. #define LCD_RS_PIN PIN_E4
8. #define LCD_RW_PIN PIN_E5
9. #define LCD_ENABLE_PIN PIN_E5
11. #define LCD_DATA4 PIN_E0
12. #define LCD_DATA5 PIN_E1
13. #define LCD_DATA6 PIN_E2
14. #define LCD_DATA7 PIN_E3
15. 
    
16. #include "lcd.c"
17. 
    
18. #define lcd_clear() lcd_putc('\f')
19. #define lcd_home() lcd_putc('\a')
20. /*For 16x4 LCD Only*/
21. #define line_1() lcd_send_byte(0,0x80);
22. #define line_2() lcd_send_byte(0,0xC0);
23. #define line_3() lcd_send_byte(0,0x90);
24. #define line_4() lcd_send_byte(0,0xD0);
25. 
    
26. 
    
27. void main(){
28. unsigned int8 relativeHumidity;
29. unsigned int8 tempC;
30. printf("\n\rdsPIC30F2010 Prototype Board.");
31. printf("\n\rFriday 26 September 2025");
32. printf("\n\rDHT-11 Humidity Sensor Example\n\r");
33. printf("\r\n\r\dht-11.c - DHT11 example starting\r\n\r\n");
34. dht11_init();
35. lcd_init();
36. printf(LCD_PUTC,"dsPIC30F2010 LCD");
37. line_2();
38. printf(LCD_PUTC,"DHT-11 Sensor");
39. line_3();
40. printf(LCD_PUTC,"Example Using");
41. line_4();
42. printf(LCD_PUTC,"CCS PICC v5.119");
43. delay_ms(5000);
44. lcd_clear();
45. while(1){
46. dht11_read(&relativeHumidity, &tempC);
47. printf("HUMIDITY=%03u%%, TEMPERATURE=%02uC\r\n", relativeHumidity, tempC);
48. lcd_home();
49. printf(LCD_PUTC," DHT-11 Sensor");
50. line_2();
51. printf(LCD_PUTC," Reading:");
52. line_3();
53. printf(LCD_PUTC,"Humidity: %03u%%",relativeHumidity);
54. line_4();
55. printf(LCD_PUTC,"Temperature:%02u%cC",tempC,0xDF);
56. delay_ms(1000);
57. }
58. }

 The TC1604A-04 works fine even it's too old.

Start-Up Screen

DHT-11 Sensor Reading and Displaying

Click here to download this example.