BitPal - The Hardware Programmer's bit field helper
Version 1.0


Description

This is a Palm application designed to decode bit fields. It is intended for hardware programmers who need to frequently need to decode the value status & control registers into the state of the individual bits.

The program is free under the Mozilla Public License v1.1. The source code is included in this distribution.


Installation

In the distribution, you should have:

BitPalApp.prc

The compiled program.

source.zip

The source code and a Makefile for use with PalmOS GNU Tools.

BitPal.html

The user's manual (this document).


Usage

Main Page

The main page shows the names of the available bitsets. A bitset is the complete definition of the bits in a 8,16 or 32 bit field. The bitsets are created using the edit page described shortly.

To open a bitset in the decoder, you can select it and tap the Open button. You can also double tap on the bitset name.

To create a bitset, tap the New button. This will bring you to the Edit page with a blank bitset.

To change a bitset, select the name and tap the Edit button. This will bring you to the Edit page.

Bitsets can be deleted by selecting the name, and tapping the Delete button. A confirmation dialog will popup before the bitset is actually deleted.

The order the bitsets are display can be changed from the Action|Sort menu item. Currently, they can be sorted by name (the default), most frequently used, and most recently used.

Edit & Create Page

This page allows you to edit the definition of a bitset. The top line is the name, which will be shown on the main page and decode page. Because the bitsets are sorted by name you may want to start the names of related bitsets with a group name. The next line is the number of bits in the bitset. The bottom of the page contains a table for the definition of each bit.

The table contains four columns. The first is the bit number (zero based). The second column is an On/Off checkbox. Check all bits that are used in the bit field. The third column is the mnemonic for the bit (up to 5 characters). The fourth column is the full description of the bit.

Once all the bits are to your liking, the Done button will save the changes and return to the main page. The Cancel button will discard any changes and return to the main page.

Decode Page

The decode page is where you enter a value and see the state of each bit. Enter the value in the graffiti area in either hex or decimal, which is selected via the H & D radio buttons at the top right. The field at the top center shows the value. Backspace can be used to delete typing. The C button or shortcut C clears the value field.

As you type, the space at the bottom of the page shows the state of all the bits that correspond to the current value. The mnemonic for each bit that is set shows under the name section. There you can see all the bits without scrolling. The table below shows each bit, the mnemonic and long description. For long bit fields, the scrollbars are needed to see all the bits.


Contact

You can find the latest distribution and source code at my site. The author can be contacted by email.


License


This software is subject to the Mozilla Public
License Version 1.1 (the "License"); you may not use this file
except in compliance with the License. You may obtain a copy of
the License at http://www.mozilla.org/MPL/
 
Software distributed under the License is distributed on an "AS
IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
implied. See the License for the specific language governing
rights and limitations under the License.

The Original Code is "BitPal".

The Initial Developer of the Original Code is James D. Rudnicki.  
Portions created by James D. Rudnicki are
Copyright (C) 2001.  All Rights Reserved.

A full copy of the Mozilla Public License was included in this distribution. The original is available at www.mozilla.org.


Revision history

  • v1.0, June 2001 Initial release.

  • To do list