Contents|Index|Next

Introduction

Cygnus’ GNUPro Toolkit is a complete solution for C and C++ development for the NEC V R 4300 family of processors. The tools include compilers for C and C++, an interactive debugger, and utilities libraries.

Debugger and linker support is included for the DDB-V R 4300 board. It is easy to add support for other V R 4300 boards using the DDB support as an example.

The following documentation serves as further introductory discussion for the NEC V R 4300 family of processors.

- Tool naming conventions
- Case sensitivity
- Processor version(s)
- Targets supported
- Hosts supported
- Object file format
- Setup

Tool naming conventions

Cross-development tools in the Cygnus GNUPro Toolkit normally have names that reflect the target processor and the object file format output by the tools (e.g. ELF). This makes it possible to install more than one set of tools in the same binary directory, including both native and cross-development tools.

The complete tool name is a three-part hyphenated string. The first part indicates the processor or processor family (e.g. ‘mips64vr4300’). The second part indicates the file format output by the tool (e.g. ELF). The third part is the generic tool name (e.g. ‘gcc’). For example, the GCC compiler for the NEC V R 4300 is ‘mips64vr4300-elf-gcc’.

If you have an MS-DOS hosted toolchain, the names of the executables are different in order to accommodate the MS-DOS filename length limitation. The names are the tool name without the target name prefix. Where the GNU C compiler is called ‘mips64vr4300-elf-gcc’ on the Unix side, the MS-DOS name is simply ‘gcc’. The binaries are also installed with an ‘.exe’ suffix, however, you do not need to specify the suffix when running the executable.

For the MS-DOS toolchain the libraries are installed in different locations. Several specific environment settings are required in the ‘autoexec.bat’ file, even when installing the release in the default location of C:\USR\CYGNUS. The MS-DOS hosted toolchain requires the following environmental settings to function properly. Assume the release is installed in C:\USR\CYGNUS.

SET PROOT=C:\USR\CYGNUS
SET PATH=%PROOT%\BIN;%PATH%
SET GCC_EXEC_PREFIX=%PROOT%\LIB\
SET INFOPATH=%PROOT%\INFO
SET C_INCLUDE_PATH=%PROOT%\include
SET CPLUS_INCLUDE_PATH=%PROOT%\include\cxx;%PROOT%\include
SET GO32=EMU %PROOT%\BIN\EMU387
REM Set TMPDIR to point to a ramdisk if you have one
SET TMPDIR=%PROOT%

Note:
The trailing back slash ‘\’ in ‘GCC_EXEC_PREFIX’ is necessary.

The V R 4300 package includes the following supported tools:

Tool Description | Unix Tool Name | DOS Tool Name
GCC compiler | mips64vr4300-elf-gcc | gcc
G++ compiler | mips64vr4300-elf-g++ | g++
C++ compiler | mips64vr4300-elf-c++ | c++
C++ demangler | mips64vr4300-elf-c++filt | c++filt
GAS assembler | mips64vr4300-elf-as | as
GLD linker | mips64vr4300-elf-ld | ld
Standalone simulator | mips64vr4300-elf-run | run
Binary Utilities | mips64vr4300-elf-ar | ar
| mips64vr4300-elf-nm | nm
| mips64vr4300-elf-objcopy | objcopy
| mips64vr4300-elf-objdump | objdump
| mips64vr4300-elf-ranlib | ranlib
| mips64vr4300-elf-size | size
| mips64vr4300-elf-strings | strings
| mips64vr4300-elf-strip | strip
GDB debugger | mips64vr4300-elf-gdb | gdb
WinGDB debugger | N/A | wingdb

Case Sensitivity

The following things are case sensitive under Unix and Windows 95:

- command line options
- assembler labels
- linker script commands
- section names

The following things are not case sensitive under Unix or Windows 95:

- GNU debugger (GDB) commands
- assembler instructions and register names

File names are case sensitive under Unix. Case sensitivity for Windows 95 is dependent on system configuration. By default, file names under Windows 95 are not case sensitive.

Processor version(s)

V R 4300

Targets Supported

GNUPro Instruction Set Simulator

The NEC DDB-VR4300 board is described in the NEC manual, DDB-V R4300 Evaluation Board. This board runs the V R 4300 processor in little-endian mode. The GNUPro simulator runs in both big-endian and little-endian mode.

Hosts Supported

- Sun SunOS 4.1.X (SPARC)
- Microsoft Windows 95 (x86)
- Microsoft Windows NT (x86)

Object file format

The V R 4300 tools support the ELF object file format (refer to System V Application Binary Interface). Use ‘ld’ (refer to Using LD in GNUPro Utilities) or ‘objcopy’ (see objcopy in The GNU Binary Utilities in GNUPro Utilities) to produce S-records.

Setup

Programs may be developed for and debugged on the GNUPro simulator or the VR4300 board.