View and Set Configuration Bits
Configuration Bits
Configuration bits are a collection of specialized bits that can only be modified at program time. Configuration bits are "read" during reset and enable or disable hardware features in the microcontroller. The features controlled by the configuration bits include, but are not limited to, the clock source, Watchdog Timer, Brown-Out detect, and Memory Read protection. Configuration bits are not executable code. Essentially, they are fuses located in the program memory space.

How Configuration Bits are Set

Each Microchip device has its own set of configuration bits. Individual device datasheets contain the definition for each of the bits. For example, find configuration bit information in the "Special Features" section of most PIC® MCU datasheets.

The setting for each configuration bit can be determined by directives written in the application software. The syntax for the configuration bit settings is available from the compiler or associated library manual. For example, the MPLAB® XC8 compiler manual contains information on setting configuration bits using #pragma, whereas to the AVR® Libc manual contains information on setting fuses (avr/fuse.h) and lockbits (avr/lock.h) using macros.

This tutorial will show how to generate the proper configuration code without consulting the compiler manual for the proper syntax.

How to Display the Configuration Bits Window

From the main menu, select Window > Target Memory Views > Configuration Bits. The Configuration Bits window will open in a tab in the Output area under the editor.

PIC16F_OpenConfigBitsWindow.png
Note: Read Device Memory ReadDeviceMemory_WindowIcon.png is required for AVR and SAM devices to ensure correct configuration bit values before editing. When device memory is read, the window text changes from red to black.
AVR8_OpenConfigBitsWindow.png

How to Set Configuration Bits

In the Configuration Bits window, click on any value in the Options column and it will turn into a combo box that will allow you to select the value you desire. The example below shows the Watchdog Timer changed from enabled to disabled.

ConfigBits.png

How to Generate Initialization Code

Although you can read, change, and write device configuration bits using the Configuration Bits window, these settings will only apply to the current device. To ensure any device programmed with the application will have the correct setup of configuration bits, controls on the window can generate code to be placed in your application.

Note: The code generation feature is currently not available for SAM devices using the Arm GCC compiler.

1

Click on the Generate Source Code to Output button.

GenerateConfigBits.png

2

The IDE will automatically generate the code necessary to initialize all the configuration bits to the settings you specified in the window. This code may now be copied and pasted into one of your source files, or you may save it to its own file and add it to your project. To save the file, right click anywhere in the Output window and select Save As from the popup menu.

ConfigBitsSaveAs.png

3

This code may optionally be inserted into the source file focused in the Editor. To insert the code, right click in the Configuration Bits window and select Insert Source Code in Editor from the popup menu. The Toolbar button will also insert the code.

ConfigBitsInsertSrc.png
© 2020 Microchip Technology, Inc.
Notice: ARM and Cortex are the registered trademarks of ARM Limited in the EU and other countries.
Information contained on this site regarding device applications and the like is provided only for your convenience and may be superseded by updates. It is your responsibility to ensure that your application meets with your specifications. MICROCHIP MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED, WRITTEN OR ORAL, STATUTORY OR OTHERWISE, RELATED TO THE INFORMATION, INCLUDING BUT NOT LIMITED TO ITS CONDITION, QUALITY, PERFORMANCE, MERCHANTABILITY OR FITNESS FOR PURPOSE. Microchip disclaims all liability arising from this information and its use. Use of Microchip devices in life support and/or safety applications is entirely at the buyer's risk, and the buyer agrees to defend, indemnify and hold harmless Microchip from any and all damages, claims, suits, or expenses resulting from such use. No licenses are conveyed, implicitly or otherwise, under any Microchip intellectual property rights.