Readme file for A8051

Readme file for A8051 V5.52A

Updated: 25/Okt/2001 [IOLW]
Archived: $Revision: 1.13 $

Important information
New features
Known problems
Program corrections
Miscellaneous
Release history

Important information

The assembler uses the UBROF 6 format as default debug format.

Predefined SFRs.

SFR	Address	Description
P0	0x80	Port 0
SP	0x81	Stack pointer
DPL	0x82	Data pointer low
DPH	0x83	Data pointer high
PCON	0x87	Power control register
TCON	0x88	Timer/counter control register
TMOD	0x89	Timer mode
TL0	0x8A	Timer low 0
TL1	0x8B	Timer low 1
TH0	0x8C	Timer high 0
TH1	0x8D	Timer high 1
P1	0x90	Port 1
SCON	0x98	Serial port control register
SBUF	0x99	Serial buffer
P2	0xA0	Port 2
IE	0xA8	Interrupt enable register 0
P3	0xB0	Port 3
PSW	0xD0	Program status word
ACC	0xE0	Accumulator
B	0xF0	B-register

Predefined bits
- In SFR TCON at address 0x88:
  
          bit 0:IT0       /* Interrupt 0 type control bit */
          bit 1:IE0       /* Interrupt 0 flag */
          bit 2:IT1       /* Interrupt 1 type control bit */
          bit 3:IE1       /* Interrupt 1 flag */
          bit 4:TR0       /* Timer 0 run control bit */
          bit 5:TF0       /* Timer 0 overflow flag */
          bit 6:TR1       /* Timer 1 run control bit */
          bit 7:TF1       /* Timer 1 overflow flag */
- In SFR SCON at address 0x98:
  
          bit 0:RI        /* Receive interrupt flag bit */
          bit 1:TI        /* Transmit interrupt flag bit */
          bit 2:RB8       /* Receiver bit 8 */
          bit 3:TB8       /* Transmit bit 8 */
          bit 4:REN       /* Receiver enable bit */
          bit 5:SM2       /* Serial port mode bit 2 */
          bit 6:SM1       /* Serial port mode bit 1 */
          bit 7:SM0       /* Serial port mode bit 0 */
- In SFR IE at address 0xA8:
  
          bit 0:EX0       /* External interrupt 0 enable bit in IE */
          bit 1:ET0       /* Timer 0 interrupt enable bit in IE */
          bit 2:EX1       /* External interrupt 1 enable bit in IE */
          bit 3:ET1       /* Timer 1 interrupt enable bit in IE */
          bit 4:ES        /* Serial interrupt enable bit in IE */
          bit 5:
          bit 6:
          bit 7:EA        /* Global Interrupt Enable */`
- In SFR P3 at address 0xB0:
  
          bit 0:RXD       /* Serial port receive data input */
          bit 1:TXD       /* Serial port transmit data output */
          bit 2:INT0      /* External interrupt 0 */
          bit 3:INT1      /* External interrupt 1 */
          bit 4:T0        /* Timer 0 input */
          bit 5:T1        /* Timer 1 input */
          bit 6:WR        /* Write signal to external memory */
          bit 7:RD        /* Read signal to external memory */
- In SFR IP at address 0xB8:
  
          bit 0:PX0       /* External interrupt 0 priority low */
          bit 1:PT0       /* Timer 0 interrupt priority low */
          bit 2:PX1       /* External interrupt 1 priority low */
          bit 3:PT1       /* Timer 1 interrupt priority low */
          bit 4:PS        /* Serial I/O port interrupt priority low. */
          bit 5:
          bit 6:
          bit 7:
- In SFR PSW at address 0xD0:
  
          bit 0:P         /* Parity bit */
          bit 1:
          bit 2:OV        /* Overflow flag   */
          bit 3:RS0       /* Register bank select, bit 0 */
          bit 4:RS1       /* Register bank select, bit 1 */
          bit 5:F0        /* General-purpose flag */
          bit 6:AC        /* Auxiliary carry */
          bit 7:CY,C      /* Carry flag */
Upgrading from V2.XX
- Reserved Symbols
  You can get a listing of all symbols via the -xDI command line option.
- Directives
          - PUBLIC and EXTERN do not allow a type specifier.
          - LOCSYM accepted but not executed.
          - LSTWID accepted but not executed.
          - LSTFOR accepted but not executed.
          - TITL accepted but not executed.
          - PTITL accepted but not executed.
          - STITL accepted but not executed.
          - PSTITL accepted but not executed.
          - The LST... directives do not remember earlier LST... directives. I.e. they are not of the counting type.
          - Cross-reference table printed differently.
          - DS 0 does not force alignment.
- The syntax for floating point numbers does not allow a leading double quote. I.e. you cannot write DD "1.0.
- The PUBLIC and EXTERN directives do not take type information.
  
  Support for Micro-series Assembler Macros in IAR assembler
- For compatibility with A8051, V2 the old macro syntax is also supported. Please use the new syntax when you write new code.
- Note that there are two types of macro definitions:
  1. Intel/Motorola macros. These are defined:
  "macname MACRO args". Please see the manual for details.
  
  2. IAR Micro-Series macros. These are defined:
  "MACRO %macname".
  
  Note that you cannot have a label in the beginning of that line. You can use both types of macros in a program, but you cannot use Micro-series operators in Intel/Motorola macros. Intel/Motorola macros allow \A through \Z as argument references, but they are not valid for Micro-series macros (some of them are used as operators).
  
  For more information on the IAR Micro-Series macros, please see the A8051 V2 manual.

Operators in A8051
Please use the command line option -u to get compatibility with V2.xx.

Source format in A8051
Directives and mnemonics are not allowed in the label field, i.e. they need a space, tab, or label to their left.

New features

None

Known problems

The following code sequence generates an internal error:
                macro %PUSHA
                PUSH A
                endmac
         MY_DATA:
         D_START EQU MY_DATA
         MY_CODE:
                %PUSHA
                IF (D_START < 128)
                NOP
                ENDIF
                END
[8051A0024]

The assembler cannot handle symbols with bit addresses in segments other than bit segments.
[8051A0023]

Program corrections

The file asm.xcl defined the wrong cpu.
[8051A0025]

Miscellaneous

Nothing

Release history

5.51A

For single-quoted strings with one character, the error message Error[0]: Invalid syntax was sometimes generated.
[8051A0022]

The option -u did not work for AND, OR, or XOR.
[8051A0021]

The assembler generated "Error[43]: Illegal effective address" for SETB and CLR where the address should be legal.
[8051A0020]

The ORL and ANL did not support the logical complement "/" for some bit-addressed bits.
[8051A0019]

3.20A

On the SUN platform, the SETB instruction would generate:
Error[43]: Illegal effective
[8051A0016]

3.11A

In an expression where the multiplication operand (*) is evaluated together with operands of the same precedence, the multipication operand will be evaluated after the other operands, not left-to-right.
[8051A0015]
Relative bits were assigned the wrong addresses if more than one source file was included in the project. The bits were assigned absolute addresses.
[8051A0014]
The predefined symbol P had the wrong address (0xB0.5) associated with it. The address is changed to 0xD0.0.
[8051A0013]
The expression HIGH( t ) got treated as solved by the assembler when t was declared as PUBLIC and placed in a different segment. [AFE0089]
It was not possible to check the length of a definition field.
[AFE0078]
The DB directive wrongly aligned defines to 16-bit, padding with zeros (0).
[AFE0079]

3.10A

The PCON sfr was not defined in the assembler.
[8051A0011]
If a bit-addressable sfr was defined and then accessed with the dot (.) notation, a warning[400] would be generated. This should only happen if the defined address is not bit-addressable.
[8051A0010]
The option -u (old operators) did not keep the AND, OR, and XOR operators from the earlier version. Now the -u option will generate:
                AND     == bitwise and
                OR      == bitwise or
                XOR     == bitwise xor
[8051A0009]
The assembler in the EW8051 was not able to handle certain code generated by the compiler. For example:
MOV DPTR,#$LOCBX assem
would generate an Internal Error.
[251A0002]

3.01C

If CLR, CPL, or SETB is used with an sfr that is not in the bit-addressable area, a warning is given.

3.01A

An Internal Error (align error) was generated in A8051.DLL for some cases of assembler source.
[8051A0005]
Duplicate assignment of a variable inside an IF-ELSE statement was not allowed.
[8051A0004]
An IE in the A8051.DLL caused by the 16-bit dll.
[8051A0003]
The A8051.DLL could not handle long file names.
[8051A0002]
The message window did not show errors or warnings generated by the assembler.
[8051A0001]