OpenCores
URL https://opencores.org/ocsvn/openmsp430/openmsp430/trunk

Subversion Repositories openmsp430

Compare Revisions

  • This comparison shows the changes necessary to convert path
    /openmsp430/trunk
    from Rev 99 to Rev 100
    Reverse comparison

Rev 99 → Rev 100

/doc/openMSP430.pdf Cannot display: file marked as a binary type. svn:mime-type = application/octet-stream
/doc/html/software_development_tools.html
35,7 → 35,7
<a name="2. openmsp430-loader"></a>
<h1>2. openmsp430-loader</h1>
This simple program allows the user to load the openMSP430 program
memory with an executable file (ELF format) provided as argument.<br>
memory with an executable file (ELF or Intel-HEX format) provided as argument.<br>
It is typically used in conjunction with '<b><i>make</i></b>' in order to automatically load the program after the compile step (see '<b><i>Makefile</i></b>' from software examples provided with the project's FPGA implementation).<br>
The program can be called with the following syntax:
<br><br>
48,10 → 48,10
<td width="15"><br>
</td>
<td>
<code>openmsp430-loader.tcl [-device &lt;communication device&gt;] [-baudrate &lt;communication speed&gt;] &lt;elf-file&gt;
<code>openmsp430-loader.tcl [-device &lt;communication device&gt;] [-baudrate &lt;communication speed&gt;] &lt;elf/ihex-file&gt;
<br><br>
Examples: openmsp430-loader.tcl -device /dev/ttyUSB0 -baudrate 9600 leds.elf<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;openmsp430-loader.tcl
-device COM2: -baudrate 38400 ta_uart.elf </code>
-device COM2: -baudrate 38400 ta_uart.ihex </code>
</td>
</tr>
</tbody></table>
66,15 → 66,19
<h1>3. openmsp430-minidebug</h1>
This small program provides a minimalistic graphical interface enabling simple interaction with the openMSP430:
<br><br>
<img src="getimg.php?1248897416" alt="openmsp430-minidebug" title="openmsp430-minidebug" width="65%">
<img src="usercontent,img,1297506385" alt="openmsp430-minidebug" title="openmsp430-minidebug" width="75%">
<br><br>
As you can see from the screenshot, it allows the following actions:
<ul>
<li><b><font color="#ff0000">(1)</font></b>&nbsp;&nbsp;Load the program memory with an ELF file</li>
<li><b><font color="#ff0000">(2)</font></b>&nbsp;&nbsp;Reset the CPU</li>
<li><b><font color="#ff0000">(3)</font></b>&nbsp;&nbsp;Stop/Start the program execution</li>
<li><b><font color="#ff0000">(4)</font></b>&nbsp;&nbsp;Read/Write access of the CPU registers</li>
<li><b><font color="#ff0000">(5)</font></b>&nbsp;&nbsp;Read/Write access of the whole memory range (program, data, peripherals)</li>
<li><b><font color="#ff0000">(1)</font></b>&nbsp;&nbsp;Connect to the openMSP430 Serial Debug Interface</li>
<li><b><font color="#ff0000">(2)</font></b>&nbsp;&nbsp;Load the program memory with an ELF or Intel-HEX file</li>
<li><b><font color="#ff0000">(3)</font></b>&nbsp;&nbsp;Control the CPU: Reset, Stop, Start and Single-Step</li>
<li><b><font color="#ff0000">(4)</font></b>&nbsp;&nbsp;Read/Write individual status bits</li>
<li><b><font color="#ff0000">(5)</font></b>&nbsp;&nbsp;Read/Write access of the CPU registers</li>
<li><b><font color="#ff0000">(6)</font></b>&nbsp;&nbsp;Read/Write access of the whole memory range (program, data, peripherals)</li>
<li><b><font color="#ff0000">(7)</font></b>&nbsp;&nbsp;Source a custom external TCL script</li>
<li><b><font color="#ff0000">(8)</font></b>&nbsp;&nbsp;Basic disassembled view of the loaded program (current PC location is highlighted in yellow)</li>
<li><b><font color="#ff0000">(9)</font></b>&nbsp;&nbsp;Choose the disassembled view type</li>
</ul>
 
<a name="4. openmsp430-gdbproxy"></a>
/doc/html/images/spacewar.png Cannot display: file marked as a binary type. svn:mime-type = application/octet-stream
doc/html/images/spacewar.png Property changes : Added: svn:mime-type ## -0,0 +1 ## +application/octet-stream \ No newline at end of property Index: doc/html/images/openmsp430-minidebug.png =================================================================== Cannot display: file marked as a binary type. svn:mime-type = application/octet-stream Index: doc/html/overview.html =================================================================== --- doc/html/overview.html (revision 99) +++ doc/html/overview.html (revision 100) @@ -31,7 +31,7 @@ To keep yourself informed about project updates, you can subscribe to the following RSS feed.

Documentation

-The online documentation is available as pdf. +The online documentation is available as pdf.

Features & Limitations

Features

    @@ -79,7 +79,7 @@ Discussion group: Index: doc/html/files_directory_description.html =================================================================== --- doc/html/files_directory_description.html (revision 99) +++ doc/html/files_directory_description.html (revision 100) @@ -1,21 +1,18 @@ - - -openMSP430 File & Directory description - - +openMSP430 File & Directory description

    Table of content

    @@ -22,16 +19,17 @@

    1. Introduction

    To simplify the integration of this IP, the directory structure is based on the OpenCores recommendations. -
    +
    - +

    2. Directory structure: openMSP430 core

    - + - - + + @@ -39,7 +37,8 @@ - + @@ -64,13 +63,13 @@ - + - + @@ -106,13 +105,13 @@ - - - -
    core openMSP430 Core top level directory
    core openMSP430 Core top level directory
    abcd bench Top level testbench directory
    abcd verilog
    abcd tb_openMSP430.v Testbench top level module
    abcd verilog
    +
    abcd tb_openMSP430.v Testbench top level module
    ram.v RAM verilog model
    registers.v Connections to Core internals for easy debugging
    dbg_uart_tasks.v UART tasks for the serial debug interface
    doc Diverse documentation
    abcd slau049f.pdf MSP430x1xx Family User's Guide
    rtl RTL sources
    abcdverilog
    abcdverilog
    +
    abcd openMSP430_defines.v openMSP430 core configuration file (Program and Data memory size definition, Debug Interface configuration)
    openMSP430_undefines.v openMSP430 Verilog `undef file
    openMSP430.v openMSP430 top level
    sim Top level simulations directory
    abcd rtl_sim RTL simulations
    abcd bin RTL simulation scripts
    abcd msp430sim Main simulation script
    abcd msp430sim Main simulation script
    asm2ihex.sh Assembly file compilation (Intel HEX file generation)
    ihex2mem.tcl Verilog program memory file generation
    rtlsim.sh Verilog Icarus simulation script
    template.def ASM linker definition file template
    run For running RTL simulations
    abcd run Run single simulation of a given vector
    abcd run Run single simulation of a given vector
    run_all Run regression of all vectors
    run_disassemble Disassemble the program memory content of the latest simulation
    load_waveform.sav SAV file for gtkWave
    read.tcl Read RTL
    constraints.tcl Set design constrains
    results Results directory
    actel Actel synthesis setup for area & speed analysis
    altera Altera synthesis setup for area & speed analysis
    xilinx Xilinx synthesis setup for area & speed analysis
    -
    + actel Actel synthesis setup for area & speed analysis + altera Altera synthesis setup for area & speed analysis + xilinx Xilinx synthesis setup for area & speed analysis + +
    - +

    3. Directory structure: FGPA projects

    @@ -119,11 +118,12 @@

    3.1 Xilinx Spartan 3 example

    - + - - + + @@ -132,7 +132,8 @@ - + @@ -145,7 +146,7 @@ - + @@ -156,14 +157,20 @@ - - - - - + + + + + - + @@ -172,21 +179,22 @@ -
    fpga openMSP430 FPGA Projects top level directory
    fpga openMSP430 FPGA Projects top level directory
    abcd xilinx_diligent_s3_board Xilinx FPGA Project based on the Diligent Spartan-3 board
    abcd bench Top level testbench directory
    abcd verilog
    abcd tb_openMSP430_fpga.v FPGA testbench top level module
    abcd verilog
    +
    abcd tb_openMSP430_fpga.v FPGA testbench top level module
    registers.v Connections to Core internals for easy debugging
    msp_debug.v Testbench instruction decoder and ASCII chain generator for easy debugging
    glbl.v Xilinx "glbl.v" file
    msp430f1121a.pdf msp430f1121a Specification
    xapp462.pdf Xilinx Digital Clock Managers (DCMs) user guide
    rtl RTL sources
    abcdverilog
    abcdverilog
    +
    abcd openMSP430_fpga.v FPGA top level file
    driver_7segment.v Four-Digit, Seven-Segment LED Display driver
    io_mux.v I/O mux for port function selection.
    sim Top level simulations directory
    abcdrtl_sim RTL simulations
    abcd bin RTL simulation scripts
    abcd msp430sim Main simulation script
    abcd msp430sim Main simulation script
    ihex2mem.tcl Verilog program memory file generation
    rtlsim.sh Verilog Icarus simulation script
    run For running RTL simulations
    *.v Stimulus vector for the corresponding software project
    software Software C programs to be loaded in the program memory
    abcdleds LEDs blinking application (from the CDK4MSP project)
    abcd makefile
    hardware.h
    main.c
    7seg.h
    7seg.c
    abcd makefile
    +
    hardware.h
    +
    main.c
    +
    7seg.h
    +
    7seg.c
    +
    ta_uart Software UART with Timer_A (from the CDK4MSP project)
    synthesis Top level synthesis directory
    abcdxilinx
    abcdxilinx
    +
    abcd create_bitstream.sh Run Xilinx ISE synthesis in a Linux environment
    create_bitstream.bat Run Xilinx ISE synthesis in a Windows environment
    openMSP430_fpga.ucf UCF file
    load_rom.sh Update bitstream's program memory with a given software ELF file in a Linux environment
    load_rom.bat Update bitstream's program memory with a given software ELF file in a Windows environment
    memory.bmm FPGA memory description for bitstream's program memory update
    -
    + +
    - +

    3.2 Altera Cyclone II example

    - + - - + + @@ -195,7 +203,8 @@ - + @@ -206,7 +215,7 @@ - + @@ -217,26 +226,198 @@ - + - + -
    fpga openMSP430 FPGA Projects top level directory
    fpga openMSP430 FPGA Projects top level directory
    abcd altera_de1_board Altera FPGA Project based on Cyclone II Starter Development Board
    abcd README README file
    bench Top level testbench directory
    abcd verilog
    abcd tb_openMSP430_fpga.v FPGA testbench top level module
    abcd verilog
    +
    abcd tb_openMSP430_fpga.v FPGA testbench top level module
    registers.v Connections to Core internals for easy debugging
    msp_debug.v Testbench instruction decoder and ASCII chain generator for easy debugging
    altsyncram.v Altera verilog model of the altsyncram module.
    DE1_Reference_Manual.pdf Cyclone II FPGA Starter Development Board Reference Manual
    DE1_User_Guide.pdf Cyclone II FPGA Starter Development Board User Guide
    rtl RTL sources
    abcdverilog
    abcdverilog
    +
    abcd OpenMSP430_fpga.v FPGA top level file
    driver_7segment.v Four-Digit, Seven-Segment LED Display driver
    io_mux.v I/O mux for port function selection.
    sim Top level simulations directory
    abcdrtl_sim RTL simulations
    abcd bin RTL simulation scripts
    abcd msp430sim Main simulation script
    abcd msp430sim Main simulation script
    ihex2mem.tcl Verilog program memory file generation
    rtlsim.sh Verilog Icarus simulation script
    run For running RTL simulations
    *.v Stimulus vector for the corresponding software project
    software Software C programs to be loaded in the program memory
    abcdbin Specific binaries required for software development.
    abcd mifwrite.cpp This prog is taken from http://www.johnloomis.org/ece595c/notes/isa/mifwrite.html and slightly changed to satisfy quartus6.1 *.mif eating engine.
    abcd mifwrite.cpp This +prog is taken from +http://www.johnloomis.org/ece595c/notes/isa/mifwrite.html and slightly +changed to satisfy quartus6.1 *.mif eating engine.
    mifwrite.exe Windows executable.
    mifwrite Linux executable.
    memledtest LEDs blinking application (from the CDK4MSP project)
    synthesis Top level synthesis directory
    abcdaltera
    abcdaltera
    +
    abcd main.qsf Global Assignments file
    main.sof SOF file
    OpenMSP430_fpga.qpf Quartus II project file
    openMSP430_fpga_top.v RTL file list to be synthesized
    -
    + +
    + + + +

    3.3 Actel ProASIC3 example

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    fpga openMSP430 FPGA Projects top level directory
    abcd actel_m1a3pl_dev_kit Actel FPGA Project based on the ProASIC3 M1A3PL development kit
    +
    abcdbench Top level testbench directory
    abcd verilog
    +
    abcd tb_openMSP430_fpga.vFPGA testbench top level module
    registers.vConnections to Core internals for easy debugging
    msp_debug.vTestbench instruction decoder and ASCII chain generator for easy debugging
    proasic3l.vActel ProASIC3L library file.
    +
    DAC121S101.v
    +
    Verilog model of National's DAC121S101 12 bit DAC.
    doc Diverse documentation
    abcd M1A3PL_DEV_KIT_QS.pdf Development Kit Quickstart Card.
    M1IGLOO_StarterKit_v1_5_UG.pdf Development Kit User's Guide.
    rtl RTL sources
    abcdverilog
    +
    abcd openMSP430_fpga.vFPGA top level file
    dac_spi_if.vSPI interface to National's DAC121S101 12 bit DAC.
    +
    smartgen
    +
    Actel's smartgen directory.
    abcddmem_128B.v 128 Byte RAM (for data memory).
    +

    +
    pmem_2kB.v 2 kByte RAM (for program memory).
    +
    openmsp430Local copy of the openMSP430 core. The *define.v file has been adjusted to the requirements of the project.
    sim Top level simulations directory
    abcdrtl_sim RTL simulations

    +
    bin
    +
    RTL simulation scripts
    +

    +
    msp430sim
    +
    Main simulation script
    +
    ihex2mem.tcl
    +
    Verilog program memory file generation
    +
    rtlsim.sh
    +
    Verilog Icarus simulation script
    +
    runFor running RTL simulations

    +
    run
    +
    Run simulation of a given software project
    +
    run_disassemble
    +
    Disassemble the program memory content of the latest simulation
    srcRTL simulation verilog stimulus

    +
    submit.f
    +
    Verilog simulator command file
    +
    *.v
    +
    Stimulus vector for the corresponding software project
    software Software C programs to be loaded in the program memory

    +
    spacewar
    +
    SpaceWar oscilloscope game.
    +

    +
    Spacewar
    +
    synthesis Top level synthesis directory
    abcdactel
    +
    abcd prepare_implementation.tcl
    +
    Generate required files prior synthesis and P&R.
    +
    synplify.tcl
    +
    Synplify template for the synthesis run.
    +
    libero_designer.tcl
    +
    Libero Designer template for the P&R run.
    +
    design_files.v
    +
    RTL file list to be synthesized.
    +
    design_constraints.pre.sdc
    +
    Synthesis timing constraints.
    +
    design_constraints.post.sdc
    +
    P&R timing constraints.
    +
    design_constraints.pdc
    +
    P&R physical constraints.
    +
    + +
    - +

    4. Directory structure: Software Development Tools

    - + - + @@ -255,13 +436,12 @@ - + -
    tools openMSP430 Software Development Tools top level directory
    tools openMSP430 Software Development Tools top level directory
    abcd bin Contains the executable files
    abcd openmsp430-loader.tcl Simple command line boot loader: TCL Script
    abcd openmsp430-loader.tcl Simple command line boot loader: TCL Script
    openmsp430-loader.exe Simple command line boot loader: Windows executable
    openmsp430-minidebug.tcl Minimalistic debugger with simple GUI: TCL Script
    openmsp430-minidebug.exe Minimalistic debugger with simple GUI: Windows executable
    abcd ew_GDB_RSP.pdf Document from Bill Gatliff: Embedding with GNU: the gdb Remote Serial Protocol
    Howto-GDB_Remote_Serial_Protocol.pdf Document from Jeremy Bennett (Embecosm): Howto: GDB Remote Serial Protocol - Writing a RSP Server
    freewrap642 The freeWrap program turns TCL/TK scripts into single-file binary executable programs for Windows.
    abcd freewrap.exe freeWrap executable to run on TCL/TK scripts (i.e. with GUI)
    abcd freewrap.exe freeWrap executable to run on TCL/TK scripts (i.e. with GUI)
    freewrapTCLSH.exe freeWrap executable to run on pure TCL scripts (i.e. command line)
    tclpip85s.dll freeWrap mandatory DLL
    generate_exec.bat Simple Batch file for auto generation of the tools' windows executables
    -
    - + +
    + - - \ No newline at end of file + \ No newline at end of file
/doc/openMSP430.odt Cannot display: file marked as a binary type. svn:mime-type = application/octet-stream
fpga/altera_de1_board/software/memledtest Property changes : Added: svn:ignore ## -0,0 +1 ## +memledtest.*

powered by: WebSVN 2.1.0

© copyright 1999-2024 OpenCores.org, equivalent to Oliscience, all rights reserved. OpenCores®, registered trademark.