dsmtk
Microcontroller Tool Kit for Dallas DS89C4X0

Copyright (c) 2005 Aleksander Mazur

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

This project is not related with Maxim/Dallas Semiconductor.

--------------------------------------------------
Version history

0.2	2005-05-07	this version
0.1	2005-01-15	support for loading flash memory only

--------------------------------------------------
License

See COPYING.

--------------------------------------------------
Description

This program is PC-side software for programming Dallas
Semiconductor's Ultra-High-Speed Flash Microcontrollers
DS89C420/430/440/450. It is basically a terminal program, giving
access to boot-rom functions in programming mode. It also provides
functions for loading/verifying flash memory, encryption vector and
external memory, as well as grabbing output to a file.
More information about microcontrollers can be found at this site:
http://www.maxim-ic.com/
See application notes for information on how to build an interface
board for In-System Programming.
This program is portable, open-source supplement to software available
at Maxim's website, which runs only on Microsoft Windows. It is
written in C and depends on GNU libc.
Before using this program, read at least section 15 ("Program
Loading") of "DS89C420 Ultra-High-Speed Flash Microcontroller User's
Guide", available at www.maxim-ic.com .

Tarball is shipped with precompiled version of dsmtk. If you have
appropiate development tools, you are encouraged to delete this file
("dsmtk") and build it again issuing "make" command.

dsload is a simple shell script that takes one argument - a name of
Intel hex file to be loaded into flash memory. When run, first it
clears flash by issuing 'K' command, and then loads new content from
given file.

Issue "dsmtk --help" to get list of available command-line options.

--------------------------------------------------
Examples

Commands accepted by high-speed microcontroller are descripted in the
document mentioned above. You can list additional (built-in) functions
of dsmtk issuing /help command.

Example 1. Loading hex file into flash (program) memory

dsload file.hex

or (in dsmtk shell):

K
/load file.hex

All the following examples assume that dsmtk is running and connection
is estabilished.

Example 2. Display values of registers

R

output example:

R
LB:00 OCR:FF ACON:1F CKCON:01 P0:00 P1:FF P2:FF P3:FF FCNTL:B1

Example 3. Dump program memory from 0 to 40 (hex)

D 0 40

output example:

D 0 40

:200000000200FAFFFFFFFFFFFFFFFF0200F9FFFFFFFFFF020027FFFFFFFFFFFFFFFFFFFFD7
:20002000FFFFFF02002632C2A7B280D281C0E0C0F0E8C0E0EAC0E0C0D078A07400F67A008D
:01004000C2FD
:00000001FF

Example 4. Dump external (MOVX) memory from 0 to 40, grabbing output
to 'dump.hex' (input mixed with output, input is indented by 2 spaces)

  /grab dump.hex
Grabbing output to dump.hex
  DX 0 40
DX 0 40

:20000000000102030405060708090A0B0C0D0E0F101112131415161718191A1B1C1D1E1FF0
:20002000202122232425262728292A2B2C2D2E2F303132333435363738393A3B3C3D3E3FD0
:01004000407F
:00000001FF

>
  /grab
Wrote grab file