1NBC(1)                      General Commands Manual                     NBC(1)
2
3
4

NAME

6       nbc - Compiler for LEGO Mindstorms NXT
7

SYNOPSIS

9       nbc [options] file [options]
10

DESCRIPTION

12       This manual page documents briefly the nbc command.
13
14       nbc  is  a program that compiles Not eXactly C (NXC) files or NeXT Byte
15       Code (NBC) files into programs that can run on the standard LEGO  MIND‐
16       STORMS  NXT firmware or the enhanced NBC/NXC firmware. The nbc compiler
17       can either save the compiler output to a file or upload it  to  a  LEGO
18       Mindstorms  NXT  for execution.  The compiler can also compile NXT Pic‐
19       ture files (.ric) using the text-based RICScript language.   Since  nbc
20       can  compile different programming languages it uses the file extension
21       to determine the type of code it is compiling.  NXC programs should use
22       the  .nxc  file extension, NBC programs should use the .nbc file exten‐
23       sion, and RICScript programs should use the .rs file extension.
24

OPTIONS

26       -S=<portname>
27              specify port name (COMn or usb), resource name, or alias
28
29       -d     download program
30
31       -b     treat input file as a binary file (don't compile it)
32
33       -q     quiet mode
34
35       -n     prevent the system file from being included
36
37       -D=<sym>[=<value>]
38              define macro <sym>
39
40       -x     decompile program
41
42       -Z[1|2]
43              turn on compiler optimizations
44
45       -ER=n  set maximum errors before aborting (0 == no limit)
46
47       -PD=n  set max preprocessor recursion depth (default == 10)
48
49       -O=<filename>
50              specify output file
51
52       -E=<filename>
53               write compiler errors to <filename>
54
55       -I=<path>
56              search <path> for include files
57
58       -nbc=<filename>
59              save NXC intermediate NBC code to <filename>
60
61       -L=<filename>
62              generate code listing to <filename>
63
64       -Y=<filename>
65              generate symbol table to <filename>
66
67       -w[-|+]
68              warnings off or on [default is on]
69
70       -sm[-|+]
71              compiler status messages off or on [default is on]
72
73       -EF    enhanced firmware
74
75       -safecall
76              NXC will wrap all function calls in Acquire/Release
77
78       -api   dump the API to stdout
79
80       -v=n   set the targeted firmware version (default == 128,  NXT  1.1  ==
81              105)
82
83       -help  display command line options
84

AUTHOR

86       nbc was written by John Hansen.
87
88       This   manual   page   was   written  by  Sebastian  Reichel  <elektra‐
89       nox@gmail.com>, for the Debian project (but may be used by others).
90
91
92
93                              September  21, 2009                       NBC(1)
Impressum