How it Works
MikroElektronika
Loading...
mikroBasic PRO for dsPIC
User guide
726 pgs16.5 Mb0
Table of contents
Loading...

MikroElektronika mikroBasic PRO for dsPIC User guide

Download
mikroBasic PRO for dsPIC
mikroBasic PRO for dsPIC30/33 and PIC24 is a full-featured Basic compiler for dsPIC30, dsPIC33 and PIC24 MCUs from Microchip. It is designed for developing, building and debugging dsPIC30/33 and PIC24-based embedded applications. This development environment has a wide range of features such as: easy-to-use IDE, very compact and
efcient code, many hardware and software libraries, comprehensive documentation, software simulator, COFF le generation, SSA
optimization (up to 30% code reduction) and many more. Numerous ready-to-use and well-explained examples will give a good start for your embedded project.
™
Manual
Compiler
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24
Table of Contents
CHAPTER 1 30 INTRODUCTION 30
Introduction to mikroBasic PRO for dsPIC30/33 and PIC24 31
Features 31 Where to Start 31
What’s new in mikroBasic PRO for dsPIC30/33 and PIC24 32
Compiler Changes 32 IDE Changes 32
Software License Agreement 33
mikroElektronika Associates License Statement and Limited Warranty 33 IMPORTANT - READ CAREFULLY 33 LIMITED WARRANTY 33 HIGH RISK ACTIVITIES 34 GENERAL PROVISIONS 34
Technical Support 35 How to Register 35
Who Gets the License Key 35 How to Get License Key 35 After Receving the License Key 37
CHAPTER 2 39 mikroBasic PRO for dsPIC30/33 and PIC24 Environment 39
Main Menu Options 40 File 41
File Menu Options 41
Edit 42
Edit Menu Options 42 Find Text 43 Replace Text 43 Find In Files 44 Go To Line 44 Regular expressions option 44
View 45
View Menu Options 45
Project 47
Project Menu Options 47
Build 48
Build Menu Options 48
Run 49
Run Menu Options 49
Tools 50
Tools Menu Options 50
MikroElektronika
2
mikroBasic PRO for dsPIC30/33 and PIC24
Help 51
Help Menu Options 51
mikroBasic PRO for dsPIC30/33 and PIC24 IDE 52
IDE Overview 52
Code Editor 53
Editor Settings 53 Auto Save 54 Highlighter 54 Spelling 54 Comment Style 54 Code Folding 54 Code Assistant 55 Parameter Assistant 55 Bookmarks 55 Go to Line 55 Column Select Mode 56 Editor Colors 56 Auto Correct 57 Auto Complete (Code Templates) 58
Code Explorer 60
Routine List 61
Project Manager 61 Project Settings 63 Library Manager 64
Managing libraries using Package Manager 65
Routine List 66 Statistics 66
Memory Usage Windows 66 RAM Memory Usage 67 Used RAM Locations 67 SFR Locations 68 ROM Memory Usage 68 ROM Memory Constants 69 Functions 69 Functions Sorted By Name Chart 70 Functions Sorted By Size Chart 70 Functions Sorted By Addresses 71 Function Tree 71 Memory Summary 72
Messages Window 73 Quick Converter 74 Macro Editor 74 Image Preview 75 Toolbars 77
3
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24
File Toolbar 78 Edit Toolbar 78 Advanced Edit Toolbar 79 Find/Replace Toolbar 79 Project Toolbar 80 Build Toolbar 80 Debug Toolbar 81 Styles Toolbar 81 Tools Toolbar 82 View Toolbar 82 Layout Toolbar 83 Help Toolbar 83
Customizing IDE Layout 84
Docking Windows 84 Saving Layout 85 Auto Hide 85
Options 86
Code editor 86 Tools 86 Output settings 87
Integrated Tools 89
Active Comments Editor 89 ASCII Chart 90 EEPROM Editor 91 Filter Designer 91 Graphic Lcd Bitmap Editor 92 HID Terminal 93 Lcd Custom Character 94 Seven Segment Editor 95 UDP Terminal 95 USART Terminal 96
Active Comments 97
New Active Comment 97 Renaming Active Comment 104 Deleting Active Comment 105
Export Project 106 Jump To Interrupt 107 Regular Expressions 108
Introduction 108 Simple matches 108 Escape sequences 108 Character classes 108 Metacharacters 109
Metacharacters - Line separators 109
Metacharacters - Predened classes 110
MikroElektronika
4
mikroBasic PRO for dsPIC30/33 and PIC24
Metacharacters - Word boundaries 110 Metacharacters - Iterators 110 Metacharacters - Alternatives 111 Metacharacters - Subexpressions 111 Metacharacters - Backreferences 111
Keyboard Shortcuts 112
CHAPTER 3 114 mikroBasic PRO for dsPIC30/33 and PIC24 Command Line Options 114 CHAPTER 4 116 mikroICD (In-Circuit Debugger) 116
Introduction 116 mikroICD Debugger Options 118
Debugger Options 118
mikroICD Debugger Example 119 mikroICD Debugger Windows 123
Debug Windows 123 Breakpoints Window 123 Watch Values Window 123 RAM Window 125 Stopwatch Window 125 EEPROM Watch Window 126 Code Watch Window 127
CHAPTER 5 128 Software Simulator Overview 128
Software Simulator 129 Software Simulator Debug Windows 130
Debug Windows 130 Breakpoints Window 130 Watch Values Window 130 RAM Window 132 Stopwatch Window 132 EEPROM Watch Window 133 Code Watch Window 134
Software Simulator Debugger Options 135
Debugger Options 135
CHAPTER 6 136 mikroBasic PRO for dsPIC30/33 and PIC24 Specics 136
GOTO Table 137
Basic Standard Issues 138
Divergence from the Basic Standard 138 C Language Extensions 138
Predened Globals and Constants 139
Predened project level denes 139
5
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24
Accessing Individual Bits 140
sbit type 141 at keyword 142 bit type 142
Interrupts 143
Function Calls from Interrupt 143 Interrupt Handling 143 Interrupt Example 144
Linker Directives 145
Directive absolute 145 Directive orgall 145 Directive orgall 146
Built-in Routines 147
Lo 148 Hi 148 Higher 149 Highest 149 LoWord 150 HiWord 150 Inc 151 Dec 151 Chr 151 Ord 152 SetBit 152 ClearBit 152 TestBit 153 Delay_us 153 Delay_ms 153 Vdelay_ms 154 VDelay_advanced_ms 154 Delay_Cyc 155 Delay_Cyc_Long 155 Clock_kHz 155 Clock_MHz 156 Get_Fosc_kHz 156 Get_Fosc_Per_Cyc 156 Reset 157 ClrWdt 157 DisableContextSaving() 157 SetFuncCall 158 SetOrg 158 DoGetDateTime 159 DoGetVersion 159
Code Optimization 160
Constant folding 160 Constant propagation 160
MikroElektronika
6
mikroBasic PRO for dsPIC30/33 and PIC24
Copy propagation 160 Value numbering 160 "Dead code" ellimination 160 Stack allocation 160 Local vars optimization 160 Better code generation and local optimization 160
Single Static Assignment Optimization 161
Introduction 161 Proper Coding Recommendations 162 Asm code and SSA optimization 163 Debugging Notes 163 Warning Messages Enhancement 163
Common Object File Format (COFF) 164
COFF File Format 164 COFF File Generation 164
CHAPTER 7 166 dsPIC30/33 and PIC24 Specics 166
Types Efciency 167 Nested Calls Limitations 167 Limits of Indirect Approach Through PSV 167 Limits of Pointer to Function 167 Variable, constant and routine alignment 167
dsPIC Memory Organization 168
Program Memory (ROM) 168 Data Memory (RAM) 169 SFR Memory Space 169 X and Y Data RAM 169 DMA RAM 170 Unimplemented Memory Space 170
Memory Type Speciers 171
code 171 data 171 rx 171 sfr 171 xdata 172 ydata 172 dma 172
Memory Type Qualiers 173
Near Memory Qualier 173 Far Memory Qualier 173
Read Modify Write Problem 174
CHAPTER 8 178 mikroBasic PRO for dsPIC30/33 and PIC24 Language Reference 178
Lexical Elements Overview 180
7
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24
Whitespace 181
Newline Character 181 Whitespace in Strings 181
Comments 182 Tokens 182
Token Extraction Example 182
Literals 183
Integer Literals 183 Floating Point Literals 183 Character Literals 184 String Literals 184
Keywords 185 Identiers 188
Case Sensitivity 188 Uniqueness and Scope 188 Identier Examples 188
Punctuators 189
Brackets 189 Parentheses 189 Comma 189 Colon 190 Dot 190
Program Organization 190
Organization of Main Module 190 Organization of Other Modules 191
Scope and Visibility 192
Scope 192 Visibility 193
Name Spaces 193 Modules 194
Include Clause 194 Main Module 194 Other Modules 195
Variables 196
External Modier 196 Variables and dsPIC30/33 and PIC24 197
Constants 198 Labels 198 Symbols 199 Functions and Procedures 200
Functions 200 Procedures 201 Forward declaration 202 Functions reentrancy 203
MikroElektronika
8
mikroBasic PRO for dsPIC30/33 and PIC24
Types 203
Type Categories 203
Simple Types 204 Derived Types 204 Arrays 204
Array Declaration 204 Constant Arrays 205 Multi-dimensional Arrays 205
Strings 206
String Concatenating 206
Pointers 207
Pointers and memory spaces 208 Function Pointers 208 @ Operator 209
Pointer Arithmetic 210
Assignment and Comparison 210 Pointer Addition 211 Pointer Subtraction 211
Structures 213
Structure Member Access 213
Types Conversions 214
Implicit Conversion 214 Explicit Conversion 215 Conversions Examples 215
Typedef Specier 216 Type Qualiers 216
Qualier const 216
Qualier volatile 217
Operators 217
Operators Precedence and Associativity 217
Arithmetic Operators 217
Arithmetic Operators Overview 218 Division by Zero 218 Unary Arithmetic Operators 218
Relational Operators 219
Relational Operators Overview 219 Relational Operators in Expressions 219
Bitwise Operators 219
Bitwise Operators Overview 219 Logical Operations on Bit Level 220 Unsigned and Conversions 220 Signed and Conversions 221 Bitwise Shift Operators 221
Boolean Operators 221
9
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24
Unary Operators 222
Unary Arithmetic Operator 222 Unary Bitwise Operator 222 Address and Indirection Operator 222
Sizeof Operator 223
Sizeof Applied to Expression 223 Sizeof Applied to Type 223
Expressions 224
Expression Evaluation 224
Statements 225 Assignment Statements 226 Conditional Statements 226 If Statement 226
Nested if statements 226
Select Case Statement 227
Nested Case Statements 228
Iteration Statements 228 For Statement 229
Endless Loop 229
While Statement 229 Do Statement 230 Jump Statements 231 Break and Continue Statements 231
Break Statement 231 Continue Statement 231
Exit Statement 232 Return Statement 232 Goto Statement 232 Gosub Statement 233 asm Statement 234
Accessing variables 234 Asm code and SSA optimization 235
Directives 235 Compiler Directives 235
Directives #DEFINE and #UNDEFINE 236 Directives #IFDEF, #IFNDEF, #ELSE and #ENDIF 236 Include Directive #I 237
Linker Directives 237
Directive absolute 237 Directive org 238
CHAPTER 9 239 mikroBasic PRO for dsPIC30/33 and PIC24 Libraries 239
MikroElektronika
10
mikroBasic PRO for dsPIC30/33 and PIC24
Hardware Libraries 240 Digital Signal Processing Libraries 240 Miscellaneous Libraries 241 Hardware Libraries 242 ADC Library 242
Library Routines 243 ADCx_Init 243 ADCx_Init_Advanced 244 ADCx_Get_Sample 245 ADCx_Read 245 ADC_Set_Active 246 Library Example 246
CAN Library 248
Library Routines 248 CANxSetOperationMode 249 CANxGetOperationMode 249 CANxInitialize 250 CANxSetBaudRate 251 CANxSetMask 252 CANxSetFilter 253 CANxRead 254 CANxWrite 255 CAN Constants 256 CAN_OP_MODE Constants 256 CAN_CONFIG_FLAGS Constants 256 CAN_TX_MSG_FLAGS Constants 257 CAN_RX_MSG_FLAGS Constants 258 CAN_MASK Constants 258 CAN_FILTER Constants 259 Library Example 259 HW Connection 262
CANSPI Library 263
Library Dependency Tree 263 External dependencies of CANSPI Library 263 Library Routines 264 CANSPISetOperationMode 264 CANSPIGetOperationMode 265 CANSPIInit 265 CANSPISetBaudRate 267 CANSPISetMask 268 CANSPISetFilter 269 CANSPIRead 270 CANSPIWrite 271 CANSPI Constants 271 CANSPI_OP_MODE Constants 271
11
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24
CANSPI_TX_MSG_FLAGS Constants 273 CANSPI_RX_MSG_FLAGS Constants 273 CANSPI_MASK Constants 274 CANSPI_FILTER Constants 274 Library Example 275 HW Connection 278
Compact Flash Library 279
Library Dependency Tree 279 External dependencies of Compact Flash Library 280 Library Routines 281 Cf_Init 282 Cf_Detect 283 Cf_Enable 283 Cf_Disable 283 Cf_Read_Init 284 Cf_Read_Byte 284 Cf_Write_Init 284 Cf_Write_Byte 285 Cf_Read_Sector 285 Cf_Write_Sector 285 Cf_Fat_Init 286 Cf_Fat_QuickFormat 286 Cf_Fat_Assign 287 Cf_Fat_Reset 288 Cf_Fat_Read 288 Cf_Fat_Rewrite 289 Cf_Fat_Append 289 Cf_Fat_Delete 289 Cf_Fat_Write 290 Cf_Fat_Set_File_Date 290 Cf_Fat_Get_File_Date 291 Cf_Fat_Get_File_Date_Modied 291 Cf_Fat_Get_File_Size 292 Cf_Fat_Get_Swap_File 292 Library Example 294 HW Connection 299
ECAN Library 300
Library Routines 300 ECANxDmaChannelInit 301 ECANxSetOperationMode 301 ECANxGetOperationMode 302 ECANxInitialize 303 ECANxSelectTxBuffers 304 ECANxFilterDisable 304 ECANxFilterEnable 305 ECANxSetBufferSize 305
MikroElektronika
12
mikroBasic PRO for dsPIC30/33 and PIC24
ECANxSetBaudRate 306 ECANxSetMask 307 ECANxSetFilter 308 ECANxRead 309 ECANxWrite 310 ECAN Constants 311 ECAN_OP_MODE Constants 311 ECAN_CONFIG_FLAGS Constants 311 ECAN_TX_MSG_FLAGS Constants 312 ECAN_RX_MSG_FLAGS Constants 312 ECAN_MASK Constants 313 ECAN_FILTER Constants 313 ECAN_RX_BUFFER Constants 314 Library Example 315 HW Connection 319
EEPROM Library 319
Library Routines 319 EEPROM_Erase 320 EEPROM_Erase_Block 320 EEPROM_Read 320 EEPROM_Write 321 EEPROM_Write_Block 321 Library Example 321
Epson S1D13700 Graphic Lcd Library 323
External dependencies of the Epson S1D13700 Graphic Lcd Library 323 Library Routines 324 S1D13700_Init 325 S1D13700_Write_Command 326 S1D13700_Write_Parameter 327 S1D13700_Read_Parameter 327 S1D13700_Fill 327 S1D13700_GrFill 328 S1D13700_TxtFill 328 S1D13700_Display_GrLayer 328 S1D13700_Display_TxtLayer 329 S1D13700_Set_Cursor 329 S1D13700_Display_Cursor 330 S1D13700_Write_Char 330 S1D13700_Write_Text 331 S1D13700_Dot 331 S1D13700_Line 332 S1D13700_H_Line 332 S1D13700_V_Line 333 S1D13700_Rectangle 333 S1D13700_Box 334 S1D13700_Rectangle_Round_Edges 334
13
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24
S1D13700_Rectangle_Round_Edges_Fill 335 S1D13700_Circle 335 S1D13700_Circle_Fill 336 S1D13700_Image 336 S1D13700_PartialImage 337
Flash Memory Library 338
dsPIC30: 338 PIC24 and dsPIC33: 338 24F04KA201 and 24F16KA102 Family Specics: 339 Library Routines 339 dsPIC30 Functions 339 PIC24 and dsPIC33 Functions 339 dsPIC30 Functions 340 FLASH_Erase32 340 FLASH_Write_Block 340 FLASH_Write_Compact 341 FLASH_Write_Init 341 FLASH_Write_Loadlatch4 342 FLASH_Write_Loadlatch4_Compact 343 FLASH_Write_DoWrite 344 FLASH_Read4 344 FLASH_Read4_Compact 345 PIC24 and dsPIC33 Functions 345 FLASH_Erase 345 FLASH_Write 346 FLASH_Write_Compact 346 FLASH_Read 347 FLASH_Read_Compact 347 Library Example 347
Graphic Lcd Library 349
Library Dependency Tree 349 External dependencies of Graphic Lcd Library 350 Library Routines 351 Glcd_Init 351 Glcd_Set_Side 353 Glcd_Set_X 353 Glcd_Set_Page 353 Glcd_Read_Data 354 Glcd_Write_Data 354 Glcd_Fill 355 Glcd_Dot 355 Glcd_Line 355 Glcd_V_Line 356 Glcd_H_Line 356 Glcd_Rectangle 357 Glcd_Rectangle_Round_Edges 357
MikroElektronika
14
mikroBasic PRO for dsPIC30/33 and PIC24
Glcd_Rectangle_Round_Edges_Fill 358 Glcd_Box 358 Glcd_Circle 359 Glcd_Circle_Fill 359 Glcd_Set_Font 360 Glcd_Write_Char 361 Glcd_Write_Text 361 Glcd_Image 362 Glcd_PartialImage 362 Library Example 363 HW Connection 365
I²C Library 366
Library Routines 366 I2Cx_Init 366 I2Cx_Start 367 I2Cx_Restart 367 I2Cx_Is_Idle 368 I2Cx_Read 368 I2Cx_Write 369 I2Cx_Stop 369 Library Example 370 HW Connection 370
Keypad Library 371
External dependencies of Keypad Library 371 Library Routines 371 Keypad_Init 371 Keypad_Key_Press 372 Keypad_Key_Click 372 Library Example 373 HW Connection 374
Lcd Library 375
Library Dependency Tree 375 External dependencies of Lcd Library 375 Library Routines 375 Lcd_Init 376 Lcd_Out 377 Lcd_Out_Cp 377 Lcd_Chr 377 Lcd_Chr_Cp 378 Lcd_Cmd 378 Available Lcd Commands 378 Library Example 379
Manchester Code Library 381
External dependencies of Manchester Code Library 381 Library Routines 382 Man_Receive_Init 382
15
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24
Man_Receive 383 Man_Send_Init 383 Man_Send 384 Man_Synchro 384 Man_Break 385 Library Example 386 Connection Example 388
Multi Media Card Library 389
Secure Digital Card 389 Secure Digital High Capacity Card 389 Library Dependency Tree 390 External dependencies of MMC Library 390 Library Routines 390 Mmc_Init 391 Mmc_Read_Sector 392 Mmc_Write_Sector 392 Mmc_Read_Cid 393 Mmc_Read_Csd 393 Mmc_Fat_Init 394 Mmc_Fat_QuickFormat 395 Mmc_Fat_Assign 396 Mmc_Fat_Reset 397 Mmc_Fat_Read 397 Mmc_Fat_Rewrite 398 Mmc_Fat_Append 398 Mmc_Fat_Delete 398 Mmc_Fat_Write 399 Mmc_Fat_Set_File_Date 399 Mmc_Fat_Get_File_Date 400 Mmc_Fat_Get_File_Date_Modied 401 Mmc_Fat_Get_File_Size 401 Mmc_Fat_Get_Swap_File 402 Library Example 403 HW Connection 407
OneWire Library 408
Library Routines 408 Ow_Reset 408 Ow_Read 409 Ow_Write 409 Library Example 410 HW Connection 412
Peripheral Pin Select Library 413
Library Routines 413 Unlock_IOLOCK 413 Lock_IOLOCK 413 PPS_Mapping 414
MikroElektronika
16
mikroBasic PRO for dsPIC30/33 and PIC24
Direction Parameters 414 Input Functions 414 Output Functions 415
Port Expander Library 417
Library Dependency Tree 417 External dependencies of Port Expander Library 417 Library Routines 417 Expander_Init 418 Expander_Init_Advanced 419 Expander_Read_Byte 419 Expander_Write_Byte 420 Expander_Read_PortA 420 Expander_Read_PortB 421 Expander_Read_PortAB 421 Expander_Write_PortA 422 Expander_Write_PortB 422 Expander_Write_PortAB 423 Expander_Set_DirectionPortA 423 Expander_Set_DirectionPortB 424 Expander_Set_DirectionPortAB 424 Expander_Set_PullUpsPortA 424 Expander_Set_PullUpsPortB 425 Expander_Set_PullUpsPortAB 425 HW Connection 427
PS/2 Library 428
External dependencies of PS/2 Library 428 Library Routines 428 Ps2_Cong 429 Ps2_Key_Read 429 Special Function Keys 430 Library Example 431 HW Connection 432
PWM Library 432
Library Routines 432 PWM_Init 433 PWM_Set_Duty 433 PWM_Start 434 PWM_Stop 434 Library Example 434 HW Connection 436
PWM Motor Control Library 436
Library Routines 436 PWMx_Mc_Init 437 PWMx_Mc_Set_Duty 438 PWMx_Mc_Start 438 PWMx_Mc_Stop 439
17
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24
HW Connection 440
RS-485 Library 440
Library Dependency Tree 441 External dependencies of RS-485 Library 441 Library Routines 441 RS485Master_Init 441 RS485Master_Receive 442 RS485Master_Send 442 RS485Slave_Init 443 RS485Slave_Receive 444 RS485Slave_Send 444 Library Example 445 HW Connection 448 Message format and CRC calculations 449
Software I²C Library 450
External dependencies of Software I²C Library 450 Library Routines 450 Soft_I2C_Init 451 Soft_I2C_Start 451 Soft_I2C_Read 452 Soft_I2C_Write 452 Soft_I2C_Stop 452 Soft_I2C_Break 453 Library Example 454
Software SPI Library 456
External dependencies of Software SPI Library 456 Library Routines 456 Soft_SPI_Init 457 Soft_SPI_Read 457 Soft_SPI_Write 458 Library Example 458
Software UART Library 460
Library Routines 460 Soft_UART_Init 460 Soft_UART_Read 461 Soft_UART_Write 461 Soft_UART_Break 462 Library Example 463
Sound Library 464
Library Routines 464 Sound_Init 464 Sound_Play 464 HW Connection 467
SPI Library 468
Library Routines 468 SPIx_Init 469
MikroElektronika
18
mikroBasic PRO for dsPIC30/33 and PIC24
SPIx_Init_Advanced 470 SPIx_Read 472 SPIx_Write 472 SPI_Set_Active 473 Library Example 473 HW Connection 474
SPI Ethernet Library 475
Library Dependency Tree 475 External dependencies of SPI Ethernet Library 476 Library Routines 476 SPI_Ethernet_Init 477 SPI_Ethernet_Enable 479 SPI_Ethernet_Disable 480 SPI_Ethernet_doPacket 481 SPI_Ethernet_putByte 481 SPI_Ethernet_putBytes 482 SPI_Ethernet_putConstBytes 482 SPI_Ethernet_putString 483 SPI_Ethernet_putConstString 483 SPI_Ethernet_getByte 483 SPI_Ethernet_getBytes 484 SPI_Ethernet_UserTCP 484 SPI_Ethernet_UserUDP 485 SPI_Ethernet_setUserHandlers 485 SPI_Ethernet_getIpAddress 486 SPI_Ethernet_getGwIpAddress 486 SPI_Ethernet_getDnsIpAddress 487 SPI_Ethernet_getIpMask 487 SPI_Ethernet_confNetwork 488 SPI_Ethernet_arpResolve 489 SPI_Ethernet_sendUDP 489 SPI_Ethernet_dnsResolve 490 SPI_Ethernet_initDHCP 491 SPI_Ethernet_doDHCPLeaseTime 491 SPI_Ethernet_renewDHCP 492 Library Example 492 HW Connection 499
SPI Ethernet ENC24J600 Library 500
Library Dependency Tree 500 External dependencies of SPI Ethernet ENC24J600 Library 501 Library Routines 502 SPI_Ethernet_24j600_Init 503 SPI_Ethernet_24j600_Enable 505 SPI_Ethernet_24j600_Disable 506 SPI_Ethernet_24j600_doPacket 507 SPI_Ethernet_24j600_putByte 507
19
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24
SPI_Ethernet_24j600_putBytes 508 SPI_Ethernet_24j600_putConstBytes 508 SPI_Ethernet_24j600_putString 509 SPI_Ethernet_24j600_putConstString 509 SPI_Ethernet_24j600_getByte 509 SPI_Ethernet_24j600_getBytes 510 SPI_Ethernet_24j600_UserTCP 510 SPI_Ethernet_24j600_UserUDP 511 SPI_Ethernet_24j600_setUserHandlers 511 SPI_Ethernet_24j600_getIpAddress 512 SPI_Ethernet_24j600_getGwIpAddress 512 SPI_Ethernet_24j600_getDnsIpAddress 512 SPI_Ethernet_24j600_getIpMask 513 SPI_Ethernet_24j600_confNetwork 513 SPI_Ethernet_24j600_arpResolve 514 SPI_Ethernet_24j600_sendUDP 514 SPI_Ethernet_24j600_dnsResolve 515 SPI_Ethernet_24j600_initDHCP 516 SPI_Ethernet_24j600_doDHCPLeaseTime 516 SPI_Ethernet_24j600_renewDHCP 517 Library Example 518
SPI Graphic Lcd Library 519
Library Dependency Tree 519 External dependencies of SPI Lcd Library 519 Library Routines 519 SPI_Glcd_Init 520 SPI_Glcd_Set_Side 521 SPI_Glcd_Set_Page 521 SPI_Glcd_Set_X 521 SPI_Glcd_Read_Data 522 SPI_Glcd_Write_Data 522 SPI_Glcd_Fill 522 SPI_Glcd_Dot 523 SPI_Glcd_Line 523 SPI_Glcd_V_Line 524 SPI_Glcd_H_Line 524 SPI_Glcd_Rectangle 525 SPI_Glcd_Rectangle_Round_Edges 525 SPI_Glcd_Rectangle_Round_Edges_Fill 526 SPI_Glcd_Box 526 SPI_Glcd_Circle 527 SPI_Glcd_Circle_FIll 527 SPI_Glcd_Set_Font 528 SPI_Glcd_Write_Char 529 SPI_Glcd_Write_Text 529 SPI_Glcd_Image 530
MikroElektronika
20
mikroBasic PRO for dsPIC30/33 and PIC24
SPI_Glcd_PartialImage 530 Library Example 531 HW Connection 533
SPI Lcd Library 534
Library Dependency Tree 534 External dependencies of SPI Lcd Library 534 Library Routines 534 SPI_Lcd_Cong 535 SPI_Lcd_Out 535 SPI_Lcd_Out_Cp 536 SPI_Lcd_Chr 536 SPI_Lcd_Chr_Cp 536 SPI_Lcd_Cmd 537 Available SPI Lcd Commands 537 Library Example 538 Default Pin Conguration 538
SPI Lcd8 (8-bit interface) Library 540
Library Dependency Tree 540 External dependencies of SPI Lcd Library 540 Library Routines 540 SPI_Lcd8_Cong 541 SPI_Lcd8_Out 541 SPI_Lcd8_Out_Cp 542 SPI_Lcd8_Chr 542 SPI_Lcd8_Chr_Cp 542 SPI_Lcd8_Cmd 543 Available SPI Lcd8 Commands 543 Library Example 544
SPI T6963C Graphic Lcd Library 546
Library Dependency Tree 546 External dependencies of SPI T6963C Graphic Lcd Library 546 Library Routines 547 SPI_T6963C_cong 548 SPI_T6963C_writeData 549 SPI_T6963C_writeCommand 549 SPI_T6963C_setPtr 550 SPI_T6963C_waitReady 550 SPI_T6963C_ll 550 SPI_T6963C_dot 551 SPI_T6963C_write_char 551 SPI_T6963C_write_text 552 SPI_T6963C_line 552 SPI_T6963C_rectangle 553 SPI_T6963C_rectangle_round_edges 553 SPI_T6963C_rectangle_round_edges_ll 554 SPI_T6963C_box 554
21
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24
SPI_T6963C_circle 555 SPI_T6963C_circle_ll 555 SPI_T6963C_image 555 SPI_T6963C_PartialImage 556 SPI_T6963C_sprite 556 SPI_T6963C_set_cursor 557 SPI_T6963C_clearBit 557 SPI_T6963C_setBit 557 SPI_T6963C_negBit 558 SPI_T6963C_displayGrPanel 558 SPI_T6963C_displayTxtPanel 558 SPI_T6963C_setGrPanel 559 SPI_T6963C_setTxtPanel 559 SPI_T6963C_panelFill 559 SPI_T6963C_grFill 560 SPI_T6963C_txtFill 560 SPI_T6963C_cursor_height 560 SPI_T6963C_graphics 561 SPI_T6963C_text 561 SPI_T6963C_cursor 561 SPI_T6963C_cursor_blink 562 Library Example 562 HW Connection 566
T6963C Graphic Lcd Library 567
Library Dependency Tree 567 External dependencies of T6963C Graphic Lcd Library 568 Library Routines 569 T6963C_init 570 T6963C_writeData 571 T6963C_writeCommand 572 T6963C_setPtr 572 T6963C_waitReady 572 T6963C_ll 573 T6963C_dot 573 T6963C_write_char 574 T6963C_write_text 575 T6963C_line 575 T6963C_rectangle 576 T6963C_rectangle_round_edges 576 T6963C_rectangle_round_edges_ll 577 T6963C_box 577 T6963C_circle 577 T6963C_circle_ll 578 T6963C_image 578 T6963C_PartialImage 579 T6963C_sprite 579 T6963C_set_cursor 580
MikroElektronika
22
mikroBasic PRO for dsPIC30/33 and PIC24
T6963C_displayGrPanel 580 T6963C_displayTxtPanel 580 T6963C_setGrPanel 581 T6963C_setTxtPanel 581 T6963C_panelFill 581 T6963C_grFill 582 T6963C_txtFill 582 T6963C_cursor_height 582 T6963C_graphics 583 T6963C_text 583 T6963C_cursor 583 T6963C_cursor_blink 584 Library Example 584 HW Connection 588
TFT Library 589
External dependencies of TFT Library 589 Library Routines 590 TFT_Init 591 TFT_Set_Index 592 TFT_Write_Command 592 TFT_Write_Data 592 TFT_Set_Active 593 TFT_Set_Font 594 TFT_Write_Char 595 TFT_Write_Text 595 TFT_Fill_Screen 596 TFT_Dot 597 TFT_Set_Pen 598 TFT_Set_Brush 599 TFT_Line 601 TFT_H_Line 602 TFT_V_Line 602 TFT_Rectangle 602 TFT_Rectangle_Round_Edges 603 TFT_Circle 603 TFT_Image 603 TFT_Partial_Image 604 TFT_Image_Jpeg 604 TFT_RGBToColor16bit 605 TFT_Color16bitToRGB 605 HW Connection 606
Touch Panel Library 607
Library Dependency Tree 607 External dependencies of Touch Panel Library 607 Library Routines 607 TP_Init 608
23
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24
TP_Set_ADC_Threshold 608 TP_Press_Detect 609 TP_Get_Coordinates 609 TP_Calibrate_Bottom_Left 610 TP_Calibrate_Upper_Right 610 TP_Get_Calibration_Consts 610 TP_Set_Calibration_Consts 611 Library Example 611
Touch Panel TFT Library 615
Library Dependency Tree 615 External dependencies of Touch Panel TFT Library 615 Library Routines 615 TP_TFT_Init 616 TP_TFT_Set_ADC_Threshold 616 TP_TFT_Press_Detect 617 TP_TFT_Get_Coordinates 618 TP_TFT_Calibrate_Min 618 TP_TFT_Calibrate_Max 618 TP_TFT_Get_Calibration_Consts 619 TP_TFT_Set_Calibration_Consts 619 HW Connection 620
UART Library 621
Library Routines 621 UARTx_Init 622 UARTx_Init_Advanced 623 UARTx_Data_Ready 624 UARTx_Tx_Idle 625 UARTx_Read 625 UARTx_Read_Text 626 UARTx_Write 627 UARTx_Write_Text 627 UART_Set_Active 628 Library Example 629 HW Connection 630
USB Library 631
USB HID Class 631 Library Routines 631 HID_Enable 632 HID_Read 632 HID_Write 632 HID_Disable 633 USB_Interrupt_Proc 633 USB_Polling_Proc 633 Gen_Enable 634 Gen_Read 634 Gen_Write 634
MikroElektronika
24
mikroBasic PRO for dsPIC30/33 and PIC24
Library Example 635 HW Connection 635
Digital Signal Processing Libraries 636
Digital Signal Processing Libraries 636
FIR Filter Library 637
Library Routines 637 FIR_Radix 637
IIR Filter Library 638
Library Routines 638 IIR_Radix 638
FFT Library 639
Library Dependency Tree 639 FFT 639 Twiddle Factors: 640 TwiddleCoeff_64 640 TwiddleCoeff_128 640 TwiddleCoeff_256 640 TwiddleCoeff_512 641
Bit Reverse Complex Library 643
Library Routines 643 BitReverseComplex 643
Vectors Library 644
Library Routines 644 Vector_Set 644 Vector_Power 645 Vector_Subtract 645 Vector_Scale 646 Vector_Negate 646 Vector_Multiply 647 Vector_Min 647 Vector_Max 648 Vector_Dot 648 Vector_Correlate 649 Vector_Convolve 650 Vector_Add 650
Matrices Library 651
Library Routines 651 Matrix_Transpose 651 Matrix_Subtract 652 Matrix_Scale 652 Matrix_Multiply 653 Matrix_Add 654
Miscellaneous Libraries 655 Button Library 655
Library Routines 655
25
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24
Button 656
C Type Library 657
Library Functions 657 isalnum 657 isalpha 657 iscntrl 657 isdigit 658 isgraph 658 islower 658 ispunct 658 isspace 658 isupper 659 isxdigit 659 toupper 659 tolower 659
Conversions Library 660
Library Dependency Tree 660 Library Routines 660 ByteToStr 661 ShortToStr 661 WordToStr 662 WordToStrWithZeros 662 IntToStr 663 LongintToStr 663 LongWordToStr 664 FloatToStr 664 WordToStrWithZeros 665 IntToStrWithZeros 665 LongWordToStrWithZeros 666 LongIntToStrWithZeros 666 ByteToHex 667 ShortToHex 667 WordToHex 668 IntToHex 668 LongWordToHex 669 LongIntToHex 669 StrToInt 670 StrToWord 670 Bcd2Dec 670 Dec2Bcd 671 Bcd2Dec16 671 Dec2Bcd16 671
Setjmp Library 672
Library Routines 672 Setjmp 672 Longjmp 672
MikroElektronika
26
mikroBasic PRO for dsPIC30/33 and PIC24
Library Example 673
String Library 674
Library Functions 674 memchr 674 memcmp 675 memcmp 675 memcpy 675 memmove 676 memset 676 strcat 676 strcat2 677 strchr 677 strcmp 677 strcpy 678 strlen 678 strncat 678 strncpy 678 strspn 679 strncmp 679 strstr 679 strcspn 680 strpbrk 680 strrchr 680 ltrim 680 rtrim 681 strappendpre 681 strappendsuf 681 length 681
Time Library 682
Library Routines 682 Time_dateToEpoch 682 Time_epochToDate 683 Time_dateDiff 683 Library Example 684 TimeStruct type denition 685
Trigon Library 686
Library Routines 686 acos 686 asin 686 atan 687 atan2 687 ceil 687 cos 687 cosh 687 eval_poly 687 exp 688
27
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24
fabs 688 oor 688 frexp 688 log 688 ldexp 688 log10 689 modf 689 pow 689 sin 689 sinh 689 sqrt 689 tan 690 tanh 690
Trigonometry Library 691
Library Routines 691 sinE3 691 cosE3 691
CHAPTER 10 692 Tutorials 692
Managing Project 692
Projects 692
New Project 693
New Project Wizard Steps 693
New Project 696
New Project Wizard Steps 696
Customizing Projects 700
Managing Project Group 700 Add/Remove Files from Project 700 Project Level Denes: 701
Add/Remove Files from Project 702
Project Level Denes: 703
Source Files 704
Managing Source Files 704
Creating new source le 704 Opening an existing le 704 Printing an open le 704 Saving le 704 Saving le under a different name 704 Closing le 705
Search Paths 705
Paths for Source Files (.mbas) 706
Edit Project 706
Search Paths 707
Paths for Source Files (.mbas) 707
Clean Project Folder 708
MikroElektronika
28
mikroBasic PRO for dsPIC30/33 and PIC24
Compilation 709
Output Files 709 Assembly View 709
Creating New Library 710
Multiple Library Versions 710
Using Microchip MPLAB® IDE with mikroElektronika compilers 711
Debugging Your Code 711
Using MPLAB® ICD 2 Debugger 711 Using MPLAB® Simulator 718 Frequently Asked Questions 723
Can I use your compilers and programmer on Windows Vista (Windows 7) ? 723 I am getting “Access is denied” error in Vista, how to solve this problem ? 723 What are differences between mikroC PRO, mikroPascal PRO and mikroBasic PRO compilers ? Why do they have different prices ? 723 Why do your PIC compilers don’t support 12F508 and some similar chips ? 723 What are limitations of demo versions of mikroElektronika’s compilers ? 723 Why do I still get demo limit error when I purchased and installed license key ? 723 I have bought license for the older version, do I have to pay license for the new version of the com­piler ? 724 Do your compilers work on Windows Vista (Windows 7) ? 724 What does this function/procedure/routine do ? 724 I try to compile one of the provided examples and nothing happens, what is the problem? 724 Can I get your library sources ? I need to provide all sources with my project. 724 Can I use code I developed in your compilers in commercial purposes ? Are there some limitations ? 724 Why does an example provided with your compilers doesn’t work ? 724 Your example works if I use the same MCU you did, but how to make it work for another MCU ? 724 I need this project nished, can you help me ? 725 Do you have some discount on your compilers/development systems for students/professors ? 725 I have a question about your compilers which is not listed here. Where can I nd an answer ? 725
29
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24

CHAPTER 1

INTRODUCTION

mikroBasic PRO for dsPIC30/33 and PIC24 is a powerful, feature-rich development tool for dsPIC30/33 and PIC24 microcontrollers. It is designed to provide the programmer with the easiest possible solution to developing applications for embedded systems, without compromising performance or control.
mikroBasic PRO for dsPIC30/33 and PIC24 IDE
MikroElektronika
30
mikroBasic PRO for dsPIC30/33 and PIC24

Introduction to mikroBasic PRO for dsPIC30/33 and PIC24

dsPIC30/33 and PIC24 and mikroBasic PRO for dsPIC30/33 and PIC24 t together well: dsPIC is designed as a PIC with digital signal processing capabilities. These are Microchip’s rst inherent 16-bit (data) microcontrollers. They build
on the PIC’s existing strengths by offering hardware MAC (multiply-accumulate), barrel shifting, bit reversal, (16x16)-bit multiplication and other digital signal processing operations. Having a wide range of application and being also prized
for efciency, the dsPIC30/33 and PIC24 MCUs are a natural choice for developing embedded systems. mikroBasic
PRO for dsPIC30/33 and PIC24 provides a successful match featuring highly advanced IDE, broad set of hardware libraries, comprehensive documentation, and plenty of ready-to-run examples.

Features

mikroBasic PRO for dsPIC30/33 and PIC24 allows you to quickly develop and deploy complex applications:
- Write your source code using the built-in Code Editor (Code and Parameter Assistants, Code Folding, Syntax Highlighting, Auto Correct, Code Templates, and more.)
- Use included mikroBasic PRO for dsPIC30/33 and PIC24 libraries to dramatically speed up the development: data acquisition, memory, displays, conversions, communication etc.
- Monitor your program structure, variables, and functions in the Code Explorer.
- Generate commented, human-readable assembly, and standard HEX compatible with all programmers.
- Use the integrated mikroICD (In-Circuit Debugger) Real-Time debugging tool to monitor program execution on the hardware level.
- Inspect program ow and debug executable logic with the integrated Software Simulator.
- Generate COFF(Common Object File Format) le for software and hardware debugging under Microchip’s
MPLAB software.
- Use Single Static Assingment optimization to shrink your code to even smaller size.
- Get detailed reports and graphs: RAM and ROM map, code statistics, assembly listing, calling tree, and more.
- Active Comments enable you to make your comments alive and interactive.
- mikroBasic PRO for dsPIC30/33 and PIC24 provides plenty of examples to expand, develop, and use as
building bricks in your projects. Copy them entirely if you deem t – that’s why we included them with the
compiler.

Where to Start

- In case that you’re a beginner in programming the dsPIC30/33 and PIC24 microcontrollers, read carefully
the dsPIC Specics chapter. It might give you some useful information on the dsPIC30/33 and PIC24
constraints, code portability, and good programming practices.
- If you are experienced in Basic programming, you will probably want to consult the mikroBasic PRO for
dsPIC30/33 and PIC24 Specics rst. For language issues, you can always refer to the comprehensive
Language Reference. A complete list of included libraries is available in the mikroBasic PRO for dsPIC30/33 and PIC24 Libraries.
- If you are not very experienced in Basic programming, don’t panic! mikroBasic PRO for dsPIC30/33 and PIC24 provides plenty of examples making it easy for you to go quickly through it . We suggest you
to consult Projects and Source Files rst, and then start browsing the examples that you’re the most
interested in.
Copyright (c) 2002-2010 mikroElektronika. All rights reserved.
What do you think about this topic ? Send us feedback!
31
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24

What’s new in mikroBasic PRO for dsPIC30/33 and PIC24

IDE build 4.60 Command line build 4.60
New features and enhancements in the following areas will boost your productivity by helping you complete many tasks more easily and in less time.
For a complete version history of mikroBasic PRO for dsPIC30/33 and PIC24 2010, visit the following link: http://www.mikroe.com/download/eng/documents/compilers/mikrobasic/pro/dspic/version_history
- Compiler Changes
- IDE Changes

Compiler Changes

Fixed:
- Optimization issues in specic cases when destination variable is in Rx space.

IDE Changes

Fixed:
- Compiler version is not visible in caption if no projects are open.
- Parameter assistant ignores commas when switching to another parameter.
- Occasional lost of conguration ags when swithing between projets.
- Improper display of RAM memory usage in statistics.
Improved:
- Communication to programmer concerning supported chips.
- License Key Request form.
MikroElektronika
32
mikroBasic PRO for dsPIC30/33 and PIC24

Software License Agreement

mikroElektronika Associates License Statement and Limited Warranty

IMPORTANT - READ CAREFULLY

This license statement and limited warranty constitute a legal agreement (“License Agreement”) between you (either as an individual or a single entity) and mikroElektronika (“mikroElektronika Associates”) for software product (“Software”)
identied above, including any software, media, and accompanying on-line or printed documentation.
BY INSTALLING, COPYING, OR OTHERWISE USING SOFTWARE, YOU AGREE TO BE BOUND BY ALL TERMS AND CONDITIONS OF THE LICENSE AGREEMENT.
Upon your acceptance of the terms and conditions of the License Agreement, mikroElektronika Associates grants you the right to use Software in a way provided below.
This Software is owned by mikroElektronika Associates and is protected by copyright law and international copyright treaty. Therefore, you must treat this Software like any other copyright material (e.g., a book).
You may transfer Software and documentation on a permanent basis provided. You retain no copies and the recipient agrees to the terms of the License Agreement. Except as provided in the License Agreement, you may not transfer, rent, lease, lend, copy, modify, translate, sublicense, time-share or electronically transmit or receive Software, media
or documentation. You acknowledge that Software in the source code form remains a condential trade secret of
mikroElektronika Associates and therefore you agree not to modify Software or attempt to reverse engineer, decompile, or disassemble it, except and only to the extent that such activity is expressly permitted by applicable law notwithstanding this limitation.
If you have purchased an upgrade version of Software, it constitutes a single product with the mikroElektronika Associates software that you upgraded. You may use the upgrade version of Software only in accordance with the License Agreement.

LIMITED WARRANTY

Respectfully excepting the Redistributables, which are provided “as is”, without warranty of any kind, mikroElektronika Associates warrants that Software, once updated and properly used, will perform substantially in accordance with the accompanying documentation, and Software media will be free from defects in materials and workmanship, for a period of ninety (90) days from the date of receipt. Any implied warranties on Software are limited to ninety (90) days.
mikroElektronika Associates’ and its suppliers’ entire liability and your exclusive remedy shall be, at mikroElektronika Associates’ option, either (a) return of the price paid, or (b) repair or replacement of Software that does not meet mikroElektronika Associates’ Limited Warranty and which is returned to mikroElektronika Associates with a copy of your receipt. DO NOT RETURN ANY PRODUCT UNTIL YOU HAVE CALLED MIKROELEKTRONIKA ASSOCIATES FIRST AND OBTAINED A RETURN AUTHORIZATION NUMBER. This Limited Warranty is void if failure of Software has resulted from an accident, abuse, or misapplication. Any replacement of Software will be warranted for the rest of the original warranty period or thirty (30) days, whichever is longer.
TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, MIKROELEKTRONIKA ASSOCIATES AND ITS SUPPLIERS DISCLAIM ALL OTHER WARRANTIES AND CONDITIONS, EITHER EXPRESSED OR IMPLIED, INCLUDED, BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE, AND NON-INFRINGEMENT, WITH REGARD TO SOFTWARE, AND THE PROVISION OF OR FAILURE TO PROVIDE SUPPORT SERVICES.
33
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24
IN NO EVENT SHALL MIKROELEKTRONIKA ASSOCIATES OR ITS SUPPLIERS BE LIABLE FOR ANY SPECIAL, INCIDENTAL, INDIRECT, OR CONSEQUENTIAL DAMAGES WHATSOEVER (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS AND BUSINESS INFORMATION, BUSINESS INTERRUPTION, OR ANY OTHER PECUNIARY LOSS) ARISING OUT OF THE USE OF OR INABILITY TO USE SOFTWARE PRODUCT OR THE PROVISION OF OR FAILURE TO PROVIDE SUPPORT SERVICES, EVEN IF MIKROELEKTRONIKA ASSOCIATES HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. IN ANY CASE, MIKROELEKTRONIKA ASSOCIATES’ ENTIRE LIABILITY UNDER ANY PROVISION OF THIS LICENSE AGREEMENT SHALL BE LIMITED TO THE AMOUNT ACTUALLY PAID BY YOU FOR SOFTWARE PRODUCT PROVIDED, HOWEVER, IF YOU HAVE ENTERED INTO A MIKROELEKTRONIKA ASSOCIATES SUPPORT SERVICES AGREEMENT, MIKROELEKTRONIKA ASSOCIATES’ ENTIRE LIABILITY REGARDING SUPPORT SERVICES SHALL BE GOVERNED BY THE TERMS OF THAT AGREEMENT.

HIGH RISK ACTIVITIES

Software is not fault-tolerant and is not designed, manufactured or intended for use or resale as on-line control equipment in hazardous environments requiring fail-safe performance, such as in the operation of nuclear facilities,
aircraft navigation or communication systems, air trafc control, direct life support machines, or weapons systems, in
which the failure of Software could lead directly to death, personal injury, or severe physical or environmental damage
(“High Risk Activities”). mikroElektronika Associates and its suppliers specically disclaim any expressed or implied warranty of tness for High Risk Activities.

GENERAL PROVISIONS

This statement may only be modied in writing signed by you and an authorised ofcer of mikroElektronika Associates.
If any provision of this statement is found void or unenforceable, the remainder will remain valid and enforceable according to its terms. If any remedy provided is determined to have failed for its essential purpose, all limitations of liability and exclusions of damages set forth in the Limited Warranty shall remain in effect.
This statement gives you specic legal rights; you may have others, which vary, from country to country. mikroElektronika Associates reserves all rights not specically granted in this statement.
mikroElektronika
Visegradska 1A, 11000 Belgrade, Europe.
Phone: + 381 11 36 28 830 Fax: +381 11 36 28 831 Web: www.mikroe.com E-mail: ofce@mikroe.com
MikroElektronika
34
mikroBasic PRO for dsPIC30/33 and PIC24

Technical Support

The latest software can be downloaded free of charge via Internet (you might want to bookmark the page so you could check news, patches, and upgrades later on): www.mikroe.com/en/compilers/mikrobasic PRO/dspic/download.htm .
In case you encounter any problem, you are welcome to our support forums at www.mikroe.com/forum/. Here, you may
also nd helpful information, hardware tips, and practical code snippets. Your comments and suggestions on future
development of the mikroBasic PRO for dsPIC30/33 and PIC24 are always appreciated — feel free to drop a note or two on our Wishlist.
In our Knowledge Base www.mikroe.com/en/kb/ you can nd the answers to Frequently Asked Questions and solutions to known problems. If you can not nd the solution to your problem in Knowledge Base then report it to Support Desk www.mikroe.com/en/support/. In this way, we can record and track down bugs more efciently, which is in our mutual
interest. We respond to every bug report and question in a suitable manner, ever improving our technical support.

How to Register

The latest version of the mikroBasic PRO for dsPIC30/33 and PIC24 is always available for downloading from our website. It is a fully functional software with the mikroICD(in-circuit Debugger), all the libraries, examples, and comprehensive help included.
The only limitation of the free version is that it cannot generate hex output over 2K of program words. Although it might sound restrictive, this margin allows you to develop practical, working applications with no thinking of demo limit. If you intend to develop really complex projects in the mikroBasic PRO for dsPIC30/33 and PIC24, then you should consider the possibility of purchasing the license key.

Who Gets the License Key

Buyers of the mikroBasic PRO for dsPIC30/33 and PIC24 are entitled to the license key. After you have completed the payment procedure, you have an option of registering your mikroBasic PRO for dsPIC30/33 and PIC24. In this way you can generate hex output without any limitations.

How to Get License Key

After you have completed the payment procedure, start the program. Select Help › How to Register from the drop-
down menu or click the How To Register Icon .
You can choose between two registering methods, I work online or I work ofine, based on your current internet connection and click Request license key now button:
35
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24
If you choose I work online registering method, following page will be opened in your default browser:
MikroElektronika
36
mikroBasic PRO for dsPIC30/33 and PIC24
Fill out the registration form, select your distributor, and click the Submit button.
If you choose I work ofine registering method, following window will be opened:
Fill out the registration form, select your distributor, and click the Submit button.
This will start your e-mail client with message ready for sending. Review the information you have entered, and add the comment if you deem it necessary. Please, do not modify the subject line.
Upon receiving and verifying your request, we will send the license key to the e-mail address you specied in the
form.

After Receving the License Key

The license key comes as a small autoextracting le – just start it anywhere on your computer in order to activate
your copy of compiler and remove the demo limit. You do not need to restart your computer or install any additional components. Also, there is no need to run mikroBasic PRO for dsPIC30/33 and PIC24 at the time of activation.
37
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24
Important:
- The license key is valid until you format your hard disk. In case you need to format the hard disk, you should request a new activation key.
- Please keep the activation program in a safe place. Every time you upgrade the compiler you should start this program again in order to reactivate the license.
MikroElektronika
38
mikroBasic PRO for dsPIC30/33 and PIC24

CHAPTER 2

mikroBasic PRO for dsPIC30/33 and PIC24 Environment

39
MikroElektronika

Main Menu Options

Available Main Menu options are:
mikoBasic PRO for dsPIC30/33 and PIC24
Related topics: Keyboard shortcuts, Toolbars
MikroElektronika
40
mikroBasic PRO for dsPIC30/33 and PIC24

File

File Menu Options

The File menu is the main entry point for manipulation with the source les.
File Description
Open a new editor window.
Open source le for editing or image le for viewing.
Reopen recently used le.
Save changes for active editor.
Save the active source le with the different name or change the le type.
Close active source le.
Close all opened les.
Print Preview.
Print.
Exit IDE.
Related topics: Keyboard shortcuts, File Toolbar, Managing Source Files
41
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24

Edit

Edit Menu Options

The Edit Menu contains commands for editing the contents of the current document.
Edit Description
Undo last change.
Redo last change.
Cut selected text to clipboard.
Copy selected text to clipboard.
Paste text from clipboard.
Delete selected text.
Select all text in active editor.
Find text in active editor.
Find next occurence of text in active editor.
Find previous occurence of text in active editor.
Replace text in active editor.
Find text in current le, in all opened les, or in les from desired folder.
Go to line to the desired line in active editor.
Advanced Code Editor options
MikroElektronika
42
mikroBasic PRO for dsPIC30/33 and PIC24
Advanced » Description
Comment selected code or put single line comment if there is no selection.
Uncomment selected code or remove single line comment if there is no selection.
Indent selected code.
Outdent selected code.
Changes selected text case to lowercase.
Changes selected text case to uppercase.
Changes selected text case to titlercase.

Find Text

Dialog box for searching the document for the specied text. The search is performed in the direction specied. If the
string is not found a message is displayed.

Replace Text

Dialog box for searching for a text string in le and replacing it with another text string.
43
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24

Find In Files

Dialog box for searching for a text string in current le, all opened les, or in les on a disk.
The string to search for is specied in the Text to nd eld. If Search in directories option is selected, The les to search are specied in the Files mask and Path elds.

Go To Line

Dialog box that allows the user to specify the line number at which the cursor should be positioned.

Regular expressions option

By checking this box, you will be able to advance your search, through Regular expressions.
Related topics: Keyboard shortcuts, Edit Toolbar, Advanced Edit Toolbar
MikroElektronika
44
mikroBasic PRO for dsPIC30/33 and PIC24

View

View Menu Options

View Menu contains commands for controlling the on-screen display of the current project.
45
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24
View Description
Show/Hide Software Simulator / mikroICD (In-Circuit Debugger) debug windows.
Show/Hide Toolbars.
Show/Hide Bookmarks window.
Show/Hide Code Explorer window.
Show/Hide Library Manager window.
Show/Hide Macro Editor window.
Show/Hide Messages window.
Show/Hide Project Manager window.
Show/Hide Project Settings window.
Show/Hide Routine List in active editor.
Show/Hide Quick Converter window.
Show/Hide View Image Preview window.
View Assembly.
View Listing.
View Statistics.
Show Window List window.
The Tools toolbar can easily be customized by adding new tools in Options(F12) window.
Related topics: Keyboard shortcuts, Integrated Tools, Software Simulator
MikroElektronika
46
mikroBasic PRO for dsPIC30/33 and PIC24

Project

Project Menu Options

Project Menu allows the user to easily manipulate current project.
Project Description
Open New Project Wizard
Open existing project.
Open project group.
Open recently used project or project group.
Save current project.
Save active project le with the different name.
Close active project.
Close project group.
Add le to project.
Remove le from project.
Edit search paths.
Edit project settings
Clean Project Folder
Import projects created in previous versions of mikroBasic.
Export Project.
Related topics: Keyboard shortcuts, Project Toolbar, Creating New Project, Project Manager, Project Settings
47
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24

Build

Build Menu Options

Build Menu allows the user to easily manage building and compiling process.
Build Description
Build active project.
Rebuild all sources in acrive project.
Build all projects.
Stop building of all projects.
Build and program active project.
Related topics: Keyboard shortcuts, Project Toolbar, Creating New Project, Project Manager, Project Settings
MikroElektronika
48
mikroBasic PRO for dsPIC30/33 and PIC24
Run

Run Menu Options

Run Menu is used to debug and test compiled code on a software or harware level.
Run Description
Start Software Simulator or mikroICD (In-Circuit Debugger).
Stop debugger.
Run/Pause Debugger.
Step Into.
Step Over.
Step Out.
Run To Cursor.
Jump to interrupt in current project.
Toggle Breakpoint.
Clear Breakpoints.
Toggle between source and disassembly.
Related topics: Keyboard shortcuts, Debug Toolbar
49
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24

Tools

Tools Menu Options

Tools Menu contains a number of applications designed to ease the use of compiler and included library routines.
Tools Description
Run mikroElektronika Programmer.
Run Package Manager.
Show/Hide Active Comment Editor window.
Run ASCII Chart
Run EEPROM Editor
Generate HTML code suitable for publishing source code on the web.
Run Filter Designer Tool.
Run Glcd bitmap editor
Run HID Terminal
Run Lcd custom character
Run Seven Segment Editor
Run UDP communication terminal
Run USART Terminal
Open Options window
Related topics: Keyboard shortcuts, Tools Toolbar
MikroElektronika
50
mikroBasic PRO for dsPIC30/33 and PIC24

Help

Help Menu Options

Help Description
Оpen Help File.
Оpen Code Migration Document.
Check if new compiler version is available.
Open mikroElektronika Support Forums in a default browser.
Open mikroElektronika Web Page in a default browser.
Information on how to register
Open About window.
Related topics: Keyboard shortcuts, Help Toolbar
51
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24

mikroBasic PRO for dsPIC30/33 and PIC24 IDE

IDE Overview

The mikroBasic PRO for dsPIC30/33 and PIC24 is an user-friendly and intuitive environment.
For a detailed information on a certain part of IDE, simply click on it (hovering a mouse cursor above a desired IDE part will pop-up its name):
- The Code Editor features adjustable Syntax Highlighting, Code Folding, Code Assistant, Parameters Assistant, Spell Checker, Auto Correct for common typos and Code Templates (Auto Complete).
- The Code Explorer is at your disposal for easier project management.
- The Project Manager alows multiple project management
- General project settings can be made in the Project Settings window
- Library manager enables simple handling libraries being used in a project
- The Messages Window displays all information, messages and errors detected during compiling and linking.
- The source-level Software Simulator lets you debug executable logic step-by-step by watching the program ow.
- The New Project Wizard is a fast, reliable, and easy way to create a project.
- Help les are syntax and context sensitive.
- Like in any modern Windows application, you may customize the layout of mikroBasic PRO for dsPIC30/33 and PIC24 to suit your needs best.
- Spell checker underlines identiers which are unknown to the project. In this way it helps the programmer to spot
potential problems early, much before the project is compiled.
- Spell checker can be disabled by choosing the option in the Preferences dialog (F12).
MikroElektronika
52
mikroBasic PRO for dsPIC30/33 and PIC24

Code Editor

The Code Editor is advanced text editor fashioned to satisfy needs of professionals. General code editing is the same as working with any standard text-editor, including familiar Copy, Paste and Undo actions, common for Windows environment.
Available Code Editor options are: Editor Settings, Editor Colors, Auto Correct, Auto Complete and Style.

Editor Settings

Main Editor Settings Features are:
- Auto Save
- Highlighter
- Spelling
- Comment Style
- Code Folding
- Code Assistant
- Parameter Assistant
- Bookmarks and Go to Line
53
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24

Auto Save

Auto Save is a function which saves an opened project automatically, helping to reduce the risk of data loss in case of
a crash or freeze. Autosaving is done in time intervals dened by the user.

Highlighter

Highlighting is a convenient feature for spotting brackets which notate begin or end of a routine, by making them visually distinct.

Spelling

The Spell Checker underlines unknown objects in the code, so they can be easily noticed and corrected before compiling your project.
Select Tools › Options from the drop-down menu, or click the Show Options Icon and then select the Spell Checker Tab.

Comment Style

Code Editor has a feature to change the comment style to either single-line or multi-line. Commenting or uncommenting
the selected code is done by a simple click of a mouse, using the Comment Icon and Uncomment Icon from
the Advanced Edit Toolbar.

Code Folding

Code folding is IDE feature which allows users to selectively hide and display sections of a source le. In this way it is
easier to manage large regions of code within one window, while still viewing only those subsections of the code that are relevant during a particular editing session.
While typing, the code folding symbols ( and ) appear automatically. Use the folding symbols to hide/unhide the code subsections.
MikroElektronika
54
mikroBasic PRO for dsPIC30/33 and PIC24
Another way of folding/unfolding code subsections is by using Alt+← and Alt+→.
If you place a mouse cursor over the tooltip box, the collapsed text will be shown in a tooltip style box.

Code Assistant

If you type the rst few letters of a word and then press Ctrl+Space, all valid identiers matching the letters you have typed will be prompted in a oating panel (see the image below). Now you can keep typing to narrow the choice, or you
can select one from the list using the keyboard arrows and Enter.

Parameter Assistant

The Parameter Assistant will be automatically invoked when you open parenthesis “(” or press Shift+Ctrl+Space. If the
name of a valid function precedes the parenthesis, then the expected parameters will be displayed in a oating panel.
As you type the actual parameter, the next expected parameter will become bold.

Bookmarks

Bookmarks make navigation through a large code easier. To set a bookmark, use Ctrl+Shift+number. The same princliple applies to the removal of the bookmarks. To jump to a bookmark, use Ctrl+number.

Go to Line

The Go to Line option makes navigation through a large code easier. Use the shortcut Ctrl+G to activate this option.
55
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24

Column Select Mode

This mode changes the operation of the editor for selecting text. When column select mode is used, highlighted text
is based on the character column position of the rst character selected to the column of the last character of text
selected. Text selected in this mode does not automatically include all text between the start and end position, but includes all
text in the columns between the rst and last character selected.
Column mode editing is sometimes referred to as block mode editing as the act of selecting text forms a rectangle.
To enter this mode, press Alt + Left mouse button, drag the mouse towards the desired direction thus selecting the text.

Editor Colors

MikroElektronika
56
mikroBasic PRO for dsPIC30/33 and PIC24
Editor Colors option allows user to set, change and save text and color settings organized in schemes. Schemes represent custom graphical appearance that can be applied to GUI (Graphical User Interface) to satisfy tastes of different users.

Auto Correct

Auto Correct option facilitates the user in such a fashion that it automatically corrects common typing or spelling errors as it types.
This option is already set up to automatically correct some words. For example, if you type whiel, it will be corrected to while when you press the spacebar:
57
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24
The user can easily add its common typos by entering original typo, for example btye, to the Original box, and replacement, byte, to the Replacement box, and just click "Add" button. Next time when the typo occurs, it will be automatically corrected.

Auto Complete (Code Templates)

Auto Complete option saves lots of keystrokes for commonly used phrases by automatically completing user's typing.
MikroElektronika
58
mikroBasic PRO for dsPIC30/33 and PIC24
The user can insert the Code Template by typing the name of the template (for instance, dow), then press Ctrl+J and the Code Editor will automatically generate a code:
You can add your own templates to the list by entering the desired keyword, description and code of your template in appropriate boxes. Autocomplete macros can retreive system and project information:
- %DATE% - current system date
- %TIME% - current system time
- %DEVICE% - device (MCU) name as specied in project settings
- %DEVICE_CLOCK% - clock as specied in project settings
- %COMPILER% - current compiler version
These macros can be used in template code, see template ptemplate provided with mikroBasic PRO for dsPIC30/33 and PIC24 installation.
59
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24

Code Explorer

The Code Explorer gives clear view of each item declared inside the source code. You can jump to a declaration of
any item by double clicking it, or pressing the Enter button. Also, besides the list of dened and declared objects, code explorer displays message about the rst error and it's location in code.
The following options are available in the Code Explorer:
Icon Description
Expand/Collapse all nodes in tree.
Locate declaration in code.
MikroElektronika
60
mikroBasic PRO for dsPIC30/33 and PIC24

Routine List

Routine list diplays list of routines, and enables ltering routines by name. Routine list window can be accessed by
pressing Ctrl+L.
You can jump to a desired routine by double clicking on it, or pressing the Enter button. Also, you can sort routines by size or by address.

Project Manager

Project Manager is IDE feature which allows the users to manage multiple projects. Several projects which together make project group may be open at the same time. Only one of them may be active at the moment. Setting project in active mode is performed by double clicking the desired project in the Project Manager, which will result in bolding the project's name. Also, the name of the currently active project will be diplayed in the Program Manager window title, alongside with the number of projects in project group.
61
MikroElektronika
Following options are available in the Project Manager:
Icon Description
mikoBasic PRO for dsPIC30/33 and PIC24
For details about adding and removing les from project see Add/Remove Files from Project.
Save project Group.
Open project group.
Close the active project.
Close project group.
Add project to the project group.
Remove project from the project group.
Add le to the active project.
Remove selected le from the project.
Build the active project.
Run mikroElektronika’s Flash programmer.
Related topics: Project Settings, Project Menu Options, File Menu Options, Project Toolbar, Build Toolbar, Add/Remove Files from Project
MikroElektronika
62
mikroBasic PRO for dsPIC30/33 and PIC24

Project Settings

The following options are available in the Project Settings window:
- Device - select the appropriate device from the device drop-down list.
- MCU Clock - enter the clock frequency value.
- Build/Debugger Type - choose debugger type.
Related topics: Edit Project, Customizing Projects, Project Manager
63
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24

Library Manager

Library Manager enables simple handling libraries being used in a project. Library Manager window lists all libraries (extension .mcl) which are instantly stored in the compiler Uses folder. The desirable library is added to the project by selecting check box next to the library name.
In order to have all library functions accessible, simply press the button Check All and all libraries will be selected.
In case none library is needed in a project, press the button Clear All and all libraries will be cleared from the
project.
Only the selected libraries will be linked.
Icon Description
Refresh Library by scanning les in “Uses” folder.Useful when new libraries are added by copying les to
“Uses” folder.
Rebuild all available libraries. Useful when library sources are available and need refreshing.
Include all available libraries in current project.
No libraries from the list will be included in current project.
Restore library to the state just before last project saving.
MikroElektronika
64
mikroBasic PRO for dsPIC30/33 and PIC24

Managing libraries using Package Manager

The Package Manager is a tool which enables users to easily install their own libraries in the mikroIDE. Libraries are
distributed in the form of a package, which is an archive composed of one or more les, containing libraries. For more
information on Package Manager, visit our website.
Upon package installation, a new node with the package name will be created in the Library Manager. For example:
From the Library Manager, the user can also uninstall the desired package by right clicking the the appropriate node, and from the drop-down menu choose Uninstall package:
Related topics: mikroBasic PRO for PIC Libraries, Creating New Library
65
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24

Routine List

Routine list diplays list of routines, and enables ltering routines by name. Routine list window can be accessed by
pressing Ctrl+L.
You can jump to a desired routine by double clicking on it, or pressing the Enter button. Also, you can sort routines by size or by address.

Statistics

After successful compilation, you can review statistics of your code. Click the Statistics Icon .

Memory Usage Windows

Provides overview of RAM and ROM usage in the various forms.
MikroElektronika
66
mikroBasic PRO for dsPIC30/33 and PIC24

RAM Memory Usage

Displays RAM memory usage in a pie-like form.

Used RAM Locations

Displays used RAM memory locations and their names.
67
MikroElektronika

SFR Locations

Displays list of used SFR locations.
mikoBasic PRO for dsPIC30/33 and PIC24

ROM Memory Usage

Displays ROM memory space usage in a pie-like form.
MikroElektronika
68
mikroBasic PRO for dsPIC30/33 and PIC24

ROM Memory Constants

Displays ROM memory constants and their addresses.

Functions

Sorts and displays functions in various ways.
69
MikroElektronika

Functions Sorted By Name Chart

Sorts and displays functions by their name, in the ascending order.
mikoBasic PRO for dsPIC30/33 and PIC24

Functions Sorted By Size Chart

Sorts and displays functions by their sizes in a chart-like form.
MikroElektronika
70
mikroBasic PRO for dsPIC30/33 and PIC24

Functions Sorted By Addresses

Sorts and displays functions by their addresses, in the ascending order.

Function Tree

Displays Function Tree with the relevant data for each function.
71
MikroElektronika

Memory Summary

Displays summary of RAM and ROM memory in a pie-like form.
mikoBasic PRO for dsPIC30/33 and PIC24
MikroElektronika
72
mikroBasic PRO for dsPIC30/33 and PIC24

Messages Window

Messages Window displays various informations and notications about the compilation process.
It reports for example, time needed for preprocessing, compilation and linking; used RAM and ROM space, generated
baud rate with error percentage, etc.
The user can lter which notications will Messages Window display by checking Errors, Warning and Hints box.
In case that errors were encountered during compiling, the compiler will report them and won’t generate a hex le. The
Messages Window will display errros at the bottom of the window by default.
The compiler also reports warnings, but these do not affect the output; only errors can interefere with the generation
of hex.
Double click the message line in the Message Window to highlight the line where the error was encountered.
73
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24

Quick Converter

Quick Converter enables the user to easily transform numbers from one base to another.
The user can convert integers of various sizes (8, 16 or 32 bits), signed and unsigned, using different representation (decimal, hexadecimal, binary and character).
Also, Quick Converter features oat point numbers conversion from/to Float Decimal, Float 32bit (IEEE), Float 32bit
(Microchip) and Radix 1.15 for dsPIC family of MCUs.

Macro Editor

A macro is a series of keystrokes that have been 'recorded' in the order performed. A macro allows you to 'record' a series of keystrokes and then 'playback', or repeat, the recorded keystrokes.
MikroElektronika
74
mikroBasic PRO for dsPIC30/33 and PIC24
The Macro offers the following commands:
Icon Description
Related topics: Code Editor, Code Templates
Starts ‘recording’ keystrokes for later playback.
Stops capturing keystrokes that was started when the Start Recording command was selected.
Allows a macro that has been recorded to be replayed.
New macro.
Delete macro.

Image Preview

There are a lot of occassions in which the user besides the code, must look at the appropriate schematics in order to succesfully write the desired program. The mikroBasic PRO for dsPIC30/33 and PIC24 provides this possibility through the Image Preview Window.
To add an image to the Image Preview Window, right click the Image Files node in the Project Manager:
75
MikroElektronika
Now, navigate to the desired image le, and simply add it:
Next, right click the added le, and choose Set As Preview Image:
mikoBasic PRO for dsPIC30/33 and PIC24
MikroElektronika
76
mikroBasic PRO for dsPIC30/33 and PIC24
Once you have added the image, it will appear in the Image Preview Window:
Also, you can add multiple images to the Image Files node, but only the one that is set will be automatically displayed in the Image Preview Window upon opening the project.
By changing the Image Preview Window size, displayed image will be t by its height in such a way that its proportions will remain intact.

Toolbars

This section provides an overview of the toolbars available in mikroBasic PRO for dsPIC30/33 and PIC24 Help:
- File Toolbar
- Edit Toolbar
- Advanced Edit Toolbar
- Find Toolbar
- Project Toolbar
- Build Toolbar
- Debug Toolbar
- Styles Toolbar
- Tools Toolbar
- View Toolbar
- Layout Toolbar
- Help Toolbar
77
MikroElektronika

File Toolbar

File Toolbar is a standard toolbar with the following options:
Icon Description
mikoBasic PRO for dsPIC30/33 and PIC24
Opens a new editor window.
Open source le for editing or image le for viewing.
Save changes for active window.
Save changes in all opened windows.
Print Preview.
Print.

Edit Toolbar

Edit Toolbar is a standard toolbar with the following options:
Icon Description
Undo last change.
Redo last change.
Cut selected text to clipboard.
Copy selected text to clipboard.
Paste text from clipboard.
MikroElektronika
78
mikroBasic PRO for dsPIC30/33 and PIC24

Advanced Edit Toolbar

Advanced Edit Toolbar comes with the following options:
Icon Description
Comment selected code or put a single line comment if there is no selection
Uncomment selected code or remove single line comment if there is no selection.
Select text from starting delimiter to ending delimiter.
Go to ending delimiter.
Go to line.
Indent selected code lines.
Outdent selected code lines.
Generate HTML code suitable for publishing current source code on the web.

Find/Replace Toolbar

Find/Replace Toolbar is a standard toolbar with the following options:
Icon Description
Find text in current editor.
Find next occurence.
Find previous occurence.
Replace text.
Find text in les.
79
MikroElektronika

Project Toolbar

Project Toolbar comes with the following options:
Icon Description
mikoBasic PRO for dsPIC30/33 and PIC24
New project.
Open Project
Save Project
Edit project settings.
Close current project.
Clean project folder.
Add File To Project
Remove File From Project

Build Toolbar

Build Toolbar comes with the following options:
Icon Description
Build current project.
Build all opened projects.
Build and program active project.
Start programmer and load current HEX le.
MikroElektronika
80
mikroBasic PRO for dsPIC30/33 and PIC24

Debug Toolbar

Debug Toolbar comes with the following options:
Icon Description
Start Software Simulator or mikroICD (In-Circuit Debugger).
Run/Pause Debugger.
Stop Debugger.
Step Into.
Step Over.
Step Out.
Run To Cursor.
Toggle Breakpoint.
View Breakpoints Window
Clear Breakpoints.
View Watch Window
View Stopwatch Window

Styles Toolbar

Styles toolbar allows you to easily change colors of your workspace.
81
MikroElektronika

Tools Toolbar

Tools Toolbar comes with the following default options:
Icon Description
mikoBasic PRO for dsPIC30/33 and PIC24
Tip : The Tools toolbar can easily be customized by adding new tools in Options menu window.
Run USART Terminal
EEPROM
ASCII Chart
Seven Segment Editor.
Open Active Comment editor.
Options menu

View Toolbar

View Toolbar provides access to assembly code, listing le and statistics windows.
Icon Description
Open assembly code in editor.
Open listing le in editor.
View statistics for current project.
MikroElektronika
82
mikroBasic PRO for dsPIC30/33 and PIC24

Layout Toolbar

Styles toolbar allows you to easily customize workspace through a number of different IDE layouts.
Icon Description
Delete the selected layout.
Save the current layout.
Set the selected layout.

Help Toolbar

Help Toolbar provides access to information on using and registering compilers:
Icon Description
Related topics: Keyboard shortcuts, Integrated Tools
Open Help le.
How To Register.
83
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24

Customizing IDE Layout

Docking Windows

You can increase the viewing and editing space for code, depending on how you arrange the windows in the IDE.
Step 1: Click the window you want to dock, to give it focus.
Step 2: Drag the tool window from its current location. A guide diamond appears. The four arrows of the diamond point
towards the four edges of the IDE.
MikroElektronika
84
mikroBasic PRO for dsPIC30/33 and PIC24
Step 3: Move the pointer over the corresponding portion of the guide diamond. An outline of the window appears in the designated area.
Step 4: To dock the window in the position indicated, release the mouse button.
Tip : To move a dockable window without snapping it into place, press CTRL while dragging it.

Saving Layout

Once you have a window layout that you like, you can save the layout by typing the name for the layout and pressing
the Save Layout Icon .
To set the layout select the desired layout from the layout drop-down list and click the Set Layout Icon .
To remove the layout from the drop-down list, select the desired layout from the list and click the Delete Layout
Icon .

Auto Hide

Auto Hide enables you to see more of your code at one time by minimizing tool windows along the edges of the IDE when not in use.
- Click the window you want to keep visible to give it focus.
- Click the Pushpin Icon on the title bar of the window.
85
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24
When an auto-hidden window loses focus, it automatically slides back to its tab on the edge of the IDE. While a window is auto-hidden, its name and icon are visible on a tab at the edge of the IDE. To display an auto-hidden window, move your pointer over the tab. The window slides back into view and is ready for use.

Options

Options menu consists of three tabs: Code Editor, Tools and Output settings

Code editor

The Code Editor is advanced text editor fashioned to satisfy needs of professionals.

Tools

The mikroBasic PRO for dsPIC30/33 and PIC24 includes the Tools tab, which enables the use of shortcuts to external programs, like Calculator or Notepad. You can set up to 10 different shortcuts, by editing Tool0 - Tool9.
MikroElektronika
86
mikroBasic PRO for dsPIC30/33 and PIC24

Output settings

By modifying Output Settings, user can congure the content of the output les. You can enable or disable, for example, generation of ASM and List le.
Also, user can choose optimization level, and compiler specic settings, which include case sensitivity, dynamic link for string literals setting (described in mikroBasic PRO for dsPIC30/33 and PIC24 specics).
Build all les as library enables user to use compiled library (*.mcl) on any MCU (when this box is checked), or for a
selected MCU (when this box is left unchecked).
For more information on creating new libraries, see Creating New Library.
87
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24
MikroElektronika
88
mikroBasic PRO for dsPIC30/33 and PIC24

Integrated Tools

Active Comments Editor

Active Comments Editor is a tool, particularly useful when working with Lcd display. You can launch it from the drop-
down menu Tools › Active Comments Editor or by clicking the Active Comment Editor Icon from Tools toolbar.
89
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24

ASCII Chart

The ASCII Chart is a handy tool, particularly useful when working with Lcd display. You can launch it from the drop-
down menu Tools › ASCII chart or by clicking the View ASCII Chart Icon from Tools toolbar.
MikroElektronika
90
mikroBasic PRO for dsPIC30/33 and PIC24

EEPROM Editor

The EEPROM Editor is used for manipulating MCU's EEPROM memory. You can launch it from the drop-down menu Tools › EEPROM Editor.
When you run mikroElektronika programmer software from mikroBasic PRO for dsPIC30/33 and PIC24 IDE - project_
name.hex le will be loaded automatically while ihex le must be loaded manually.

Filter Designer

The Filter designer is a tool for designing FIR and IIR lters. It has an user-friendly visual interface for setting the lter
parameters. Filter designer output is the mikroBasic PRO for dsPIC30/33 and PIC24 compatible code. You can launch it from the drop-down menu Tools › Filter Designer.
91
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24

Graphic Lcd Bitmap Editor

The mikroBasic PRO for dsPIC30/33 and PIC24 includes the Graphic Lcd Bitmap Editor. Output is the mikroBasic PRO for dsPIC30/33 and PIC24 compatible code. You can launch it from the drop-down menu Tools › Glcd Bitmap Editor.
MikroElektronika
92
mikroBasic PRO for dsPIC30/33 and PIC24

HID Terminal

The mikroBasic PRO for dsPIC30/33 and PIC24 includes the HID communication terminal for USB communication. You can launch it from the drop-down menu Tools › HID Terminal.
93
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24

Lcd Custom Character

mikroBasic PRO for dsPIC30/33 and PIC24 includes the Lcd Custom Character. Output is mikroBasic PRO for dsPIC30/33 and PIC24 compatible code. You can launch it from the drop-down menu Tools › Lcd Custom Character.
MikroElektronika
94
mikroBasic PRO for dsPIC30/33 and PIC24

Seven Segment Editor

The Seven Segment Editor is a convenient visual panel which returns decimal/hex value for any viable combination you would like to display on seven segment display. Click on the parts of seven segment image to get the requested value
in the edit boxes. You can launch it from the drop-down menu Tools › Seven Segment Editor or by clicking the Seven
Segment Editor Icon from Tools toolbar.

UDP Terminal

The mikroBasic PRO for dsPIC30/33 and PIC24 includes the UDP Terminal. You can launch it from the drop-down menu Tools › UDP Terminal.
95
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24

USART Terminal

The mikroBasic PRO for dsPIC30/33 and PIC24 includes the USART communication terminal for RS232 communication.
You can launch it from the drop-down menu Tools › USART Terminal or by clicking the USART Terminal Icon from
Tools toolbar.
MikroElektronika
96
mikroBasic PRO for dsPIC30/33 and PIC24

Active Comments

The idea of Active Comments is to make comments alive and give old fashioned comments new meaning and look. From now on, you can assign mouse event on your comments and 'tell' your comments what to do on each one. For example, on left mouse click, open some web address in your browser, on mouse over show some picture and on
mouse double click open some le.
Suppose we are writing a example for a GSM/GPSR module which is connected to the EasyPIC6 and we would like to provide a photo of our hardware (jumpers, cables, etc.). within the example. It would also be nice to put some documentation about chip we are using and a GSM module extra board. Now we can have all those things dened in one single comment using Active Comment Editor.

New Active Comment

When you start Active Comment Editor for the rst time (from the View menu, from editor's pop-up menu, or by pressing
Ctrl + Alt + P) you will get an empty editor:
By clicking the button you are prompted to enter a name for the comment:
97
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24
You can notice that when you start typing a name, properties pane is automatically displayed so you can edit properties
if you wish. A Comment will be is created when you click button.
Properties are consisted of two major categories - Attributes and Events.
Attributes can be:
- URL - Valid web address.
- Image - Image has to be previously added to Project (Project Manager > Images).
- File - File has to be previously added to Project (Project Manager > Other Files).
There are four predened event types you can apply to an Active Comment:
1. OnLeftClick + Alt
2. OnRightClick
3. OnDoubleClick
4. OnMouseOver
MikroElektronika
98
mikroBasic PRO for dsPIC30/33 and PIC24
First three event types can have one of the following three actions:
1. OpenUrl - Opens entered URL in default Web browser.
2. OpenFile - Opens a le within a default program associated with the le extension (dened by Windows).
3. None - Does nothing.
The fourth event, OnMouseOver, has only 2 actions:
1. PreviewImage - Shows image when cursor is moved over a comment.
2. None - Does nothing.
Attributes are tightly bounded with events. For example, you can not have OnLeftClick + Alt -> OpenFile if there is no
le attribute set, or if there is no le added to project. The same behavior applies to image attribute.
Let's start editing our Active Comment by entering some valid web address in the URL eld:
For every Active Comment a XML le will be created, containing all valid information regarding the Active Comment -
attributes, events, etc. and it is automatically added to Project manager after saving it:
99
MikroElektronika
mikoBasic PRO for dsPIC30/33 and PIC24
You can see the contents of the created XML le by expanding Active Comment Editor:
As we mentioned above you can add image or le which are already included in project. If the the desired image or le
aren't added, you can do it directly from here by clicking the or button.
MikroElektronika
100
Loading...
Buy Points How it Works FAQ Contact Us Questions and Suggestions Privacy Policy Cookie Policy Terms of Use