Digi BL1800 user manual Software Reference, An Overview of Dynamic C

Page 41

4.SOFTWARE REFERENCE

To develop and debug programs for the Jackrabbit (and for all other Rabbit hardware), you must install and use Dynamic C. It runs on an IBM-compatible PC and is designed for use with Rabbit-based single-board computers and other devices based on the Rabbit microprocessor. This chapter provides a tour of the major features of Dynamic C with respect to the Jackrabbit.

4.1 An Overview of Dynamic C

Dynamic C has been in use worldwide since 1989. It is specially designed for program- ming embedded systems, and features quick compile and interactive debugging. A com- plete reference guide to Dynamic C is contained in the Dynamic C User’s Manual.

You have a choice of doing your software development in the flash memory or in the data SRAM included on the Jackrabbit. The flash memory and SRAM options are selected with the Options > Project Options > Compiler menu.

The advantage of working in RAM is to save wear on the flash memory, which is limited to about 100,000 write cycles. The disadvantage is that the code and data might not both fit in RAM.

NOTE: An application can be developed in RAM, but cannot run standalone from RAM after the programming cable is disconnected. All standalone applications can only run from flash memory.

NOTE: Do not depend on the flash memory sector size or type. Due to the volatility of the flash memory market, the Jackrabbit and Dynamic C were designed to accommo- date flash devices with various sector sizes.

Developing software with Dynamic C is simple. Users can write, compile, and test C and assembly code without leaving the Dynamic C development environment. Debugging occurs while the application runs on the target. Alternatively, users can compile a program to an image file for later loading. Dynamic C runs on PCs under Windows NT and later— note that Dynamic C is still being evaluated for compatibility with Windows Vista at the time of writing, and should not be expected to run correctly under Windows Vista at this time. Programs can be downloaded at baud rates of up to 460,800 bps after the program compiles.

User’s Manual

37

Image 41

Contents Programmable Single-Board Computer Jackrabbit BL1800Digi International Inc TrademarksTable of Contents Index Schematics Introduction FeaturesDevelopment and Evaluation Tools Jackrabbit FeaturesOnline Documentation How to Use This ManualAdditional Product Information Emissions CE ComplianceImmunity Interfacing the Jackrabbit to Other Devices SafetyDesign Guidelines General Jackrabbit BL1800 Getting Started Development Kit ContentsDevelopment Hardware Connections Attach Jackrabbit to Prototyping Board BoardAssemble AC Adapter Connect Programming CableConnect Power Installing Dynamic C Run a Sample Program TroubleshootingTechnical Support Where Do I Go From Here?Real-Time Clock BL1800 SubsystemsHeaders Jackrabbit PinoutsDigital Inputs Digital Inputs/OutputsHV3 Sourcing Output Digital OutputsConfigurable High-Current Output Changing HV3 to a Sinking Output Bidirectional I/OA/D Converter Schematic Diagram of A/D ConverterJackrabbit BL1800 D/A Converters Schematic Diagram of D/A Converters1 DA1 V ⋅ 1 e RCTypical DA1 Voltages for Various Duty Cycles Typical DA0 Voltages for Various Duty Cycles 2 DA0User’s Manual 2 RS-485 Serial Communication1 RS-232 Ground recommended 485 R16 Programming PortUser’s Manual Programming Cable Changing Between Program Mode and Run ModeFlash Eprom MemorySram Clock Doubler Other HardwareExternal Interrupts Spectrum Spreader Jackrabbit BL1800 An Overview of Dynamic C Software ReferenceJackrabbit BL1800 Jackrabbit Sample Programs Sample ProgramsSample Program DEMOJR1.C DEMOJR1.CWatch Expression Break Point Single-SteppingWatching Variables Dynamically Summary of FeaturesEditing the Program User’s Manual Other Sample Programs Illustrating Digital I/O R/W pin and DB0-DB3 on 3 RS-232 Serial Communication Sample Programs 4 RS-485 Serial Communication Sample Program Cooperative Multitasking Int vswitch Advantages of Cooperative Multitasking 1 I/O Drivers Jackrabbit Function CallsVoid digOutint channel, int value Void anaOutint channel, int value Void anaInint channel, int *value Serial Communication Drivers Add-On Modules Upgrading Dynamic CPatches and Bug Fixes Appendix A. Specifications Figure A-1shows the mechanical dimensions for the Jackrabbit Electrical and Mechanical SpecificationsTable A-1. Jackrabbit Board Specifications Exclusion Zones Exclusion ZoneFigure A-3. User Board Footprint for Jackrabbit Figure A-4. Location of Jackrabbit Configurable Positions Jumper ConfigurationsTable A-2. Jackrabbit Jumper Configurations Conformally coated area Conformal CoatingJackrabbit Use of Rabbit 2000 Parallel PortsTable A-3. Jackrabbit Pinout Configurations PD0 PD1 Jackrabbit BL1800 Appendix B. Prototyping Board Prototyping Board Overview Jackrabbit Connectors User LEDs BuzzerPrototyping Board Features Top Side Mechanical Dimensions and LayoutTop Side Using the Prototyping BoardRelay Demonstration BoardExisting Top Side Prototyping BoardPE0 VCC HV0 SM1 SM0 HV2 Stat Jackrabbit BL1800 Power Supplies Appendix C. Power ManagementDcin Current mA 950 mA·h = 5.4 years 20 µA Batteries and External Battery ConnectionsFigure C-5shows the Jackrabbit battery backup circuitry Battery Backup CircuitReset Generator Power to Vram SwitchChip Select Circuit Figure C-7shows a schematic of the chip select circuitJackrabbit BL1800 SMODE0 SMODE1 IndexRABDB01.C RABDB02.C Schematics