This repository is the Open Source release of the libraries and sample code from Dynamic C 9, an integrated development environment for Digi International's embedded systems based on the Rabbit 2000 and 3000 microprocessors.
It is of limited use without the rest of the IDE and the appropriate target hardware. See the Installation section for instructions on installing Dynamic C 9.62 and updating its libraries and samples with the code in this repository.
The release
branch is a RELEASE software release which is fully
QA-tested and supported by Digi International.
The master
branch is an ALPHA software release which has received
limited functional/unit testing.
The MPL 2.0 license covers the majority of this project with the following exceptions:
- The ISC license covers the contents of the
Applications
,RabbitLink
andSamples
directories.
Instructions on using Git and GitHub are beyond the scope of this document. If you are new to using Git, we recommend the Windows GUI Git Extensions. Their website includes a manual and video tutorial. The program has a command-line "Git bash" tool, available in the Tools menu, that you can use to execute the script below.
To make use of this code, either start with an existing (backed-up) Dynamic C 9.62 installation, or download and install Dynamic C 9.62, followed by the Embedded Security Pack and finally, the Dynamic C 9.62 Library Patches. Portions of the Embedded Security Pack and Library Patches aren't tracked by this repository, so it is necessary to run those installers.
Next, add the GitHub repository to the directory. These instructions
have you creating a private branch where you can store your own changes
to the libraries and samples, merging them in with Digi International's
changes. It assumes you've already changed to the directory with Dynamic
C installed (e.g., cd /c/DCRABBIT_9.62
).
# Connect the Dynamic C installation with the GitHub repository,
# and download all of the branches and tags.
git init
git remote add origin https://github.com/digidotcom/DCRabbit_9.git
git fetch --tags
# Configuration options to ignore file modes and preserve line endings
# (since this is a Windows-only repository).
git config core.filemode false
git config core.autocrlf false
# Reset to the patched 9.62 release (without changing directory contents).
git reset 9.62-patch2
# Get the .gitignore file from the repository.
git checkout .gitignore
# Create a private branch using the 9.62 release as a start point.
git checkout -B mybranch
At this point, git status
will show any changes to the directory
you have made since the original installation. You should reset any
accidental changes, or create commits to track intentional changes.
Once you have processed all of your changes, you can cherry-pick
individual commits from the master
and release
branches, or merge
either branch, in its entirety, into yours.