Home   Arduino/PD   OpenRabbit   SWK-8630   TcpSrv   DV300F   Accumulator   Mail me 
I love Vim! 
Welcome at my OpenRabbit site.

Why this name?
All software on the internet is prefixed by Open, therefor the best name I could come up with was OpenRabbit.

What is it NOT?
This is not (yet) a replacement for the software available at www.rabbitsemiconductor.com. So you need to obtain a legal license or development kit at their site. You probably already have one, otherwise you wouldn't be here.

Also this software is NOT provided by Rabbit Semiconductor. They will NOT give any support or whatever regarding this website or software.

Tell me, what is it.
It is a collection of software written in GNU C to make it possible to develop software for the microprocessors sold by Rabbit Semiconductor. You can get rid of your Windows machine, by using their command-line compiler inside Wine. You then use this software on Linux to upload the binary to the target and either just use it as a RFU (Rabbit field utility) or start debugging, like you used to in the Dynamic C IDE.

Tell me about the copyright.
The software you can donwload here is spread under terms and conditions of the GNU General Public License (version 2 or higher). This license can be found in the COPYING file in the package downloadable below.

I want to Donate!

How do I configure Wine to run the command-line compiler?
Let's assume you have a Dos/Windows partition mounted at /dosf. On this partition you have installed DCRABBIT_8.51 (recommended) using a Windows multi-boot or the partition mounted on another Windows machine. Then in the configuration of Wine you should map f: to /dosf. In the latest version using a symlink from ~/.wine/dosdevices or in an earlier version in the config file. Now you should be able to use the compiler inside wine (see the next section).

Can I use a Makefile?
Yes, that's the idea when using Wine. Your Makefile could look like this:
all: clean hello

  rm -f hello.bin

  time wine f:/DCRABBIT_8.51/dccl_cmp.exe hello.c -h+ -br

  openrabbit /dosf/DCRABBIT_8.51/Bios/coldload.bin /dosf/DCRABBIT_8.51/Bios/pilot.bin hello.bin hello.brk f: /dosf /dev/tts/3

  time rfu /dosf/DCRABBIT_8.51/Bios/coldload.bin /dosf/DCRABBIT_8.51/Bios/pilot.bin hello.bin hello.brk f: /dosf /dev/tts/3

How do I use it?
After you've compiled your project, either using DynC in Windows or the CL/Wine version, you point the rfu or openrabbit software to the neccesary files. The usage for both programs is:

openrabbit <coldload.bin> <pilot.bin> <project.bin> <project.brk> <dos drive> <mount point> <serial device>

It will start loading data to the device. After a while (when not in rfu mode) a ncurses base screen will come up:

The top-left window shows the code being executed. The window below shows the stdout of the target. On the right you can see the registers and the stack. The window on the bottom-left is reserved for watching C variables.

The keys available are:
F6 = Automatic trace into everything
F7 = Trace into a function
F8 = Step over a function
F9 = Run untill breakpoint
F10 = Stop execution
q = Quit program (It is wise to stop execution first, but it's not neccesary.)

Which version of Dynamic C do I need?
You need version 8.51, but 8.30 might also work (haven't tried it, so let me know).

What should I use to create code?
I prefer Vim, but ofcourse you can also use Kdevelop or any other editor or IDE.
For looking up functions and their usage you can use the man pages (converter downloadable below).

I saw a converter for man pages in you download section, how should I use it?
You need to have at least a regular PHP installed. Then download the r2man.php.gz and gunzip it 'gzip -d r2man.php.gz'. Now open the file in your favorite editor and change the path to php and to your DynC. Create a man3r folder and run the script. It will output what it's working on. When it's finished you could place a line like 'PATH="$PATH:/my/path/to/rabbitman' in your .(bash_)profile. Every time you log in now it will be available. If you want to look up the help for sprintf you just type: 'man 3r sprintf'. Don't forget 3r, otherwise you get the Linux version.

How to install the software?
Download the file below, unpack it and read the INSTALL file.

I want to download it!
OpenRabbitBoth the OpenRabbit Programmer (RFU) and Debuggeropenrabbit_0.1.1.tar.bz20.1.12004-07-28
man3rPHP conversion script to create man pages for the rabbit functions from the lib.dir and from there linked files.r2man.php.gz0.12004-07-29

USE AT YOUR OWN RISK! I'M NOT RESPONSIBLE IF YOUR RABBITS DIE! (but please mail me, if they do...)

I found bugs, what to do?
Currently I'm the only developer, so you can send bug reports to me. If you're a programmer and made changes or extensions then please send me the patches. If there is enough interest in this software I might put it into CVS on SourceForge. For now I'll keep it simple.

All information on this site is provided 'as is'. The author assumes no responsibility for completeness or accuracy of the information provided and makes no warranty, express or implied, regarding the quality or accuracy of any content displayed on, downloaded from, or linked to this site. Use of this site constitutes agreement with these terms and conditions and you agree to hold the author blameless for any loss or damage sustained.

All trademarks, service marks, and copyrights are property of their respective owners.

© 2003-2011 by Lourens Rozema