84PCE:OS:Applications - Revision history

MateoConLechuga: /* Application File Type */

2020-09-11T20:43:45Z

‎Application File Type

2018-10-27T01:07:15Z

‎Relocations

2017-10-16T06:27:07Z

‎Additional App Structure

2017-10-14T05:14:27Z

‎Example

2017-10-08T12:04:05Z

2017-10-02T06:41:09Z

‎Relocations

2017-10-02T06:37:03Z

‎Additional App Structure

2017-10-02T04:54:32Z

‎Additional App Structure

2017-10-02T04:51:35Z

‎Additional App Structure

2017-10-02T03:41:53Z

‎Additional App Structure

← Older revision		Revision as of 20:43, 11 September 2020
Line 10:		Line 10:

	Applications can be of arbitrary size, no longer multiples of 16kB.		Applications can be of arbitrary size, no longer multiples of 16kB.
−
−	~~You can find code for creating an application; along with other fancy items [https://github.com/mateoconlechuga/app-inc here]~~

	==Applications in the Archive==		==Applications in the Archive==

@@ Line 169: / Line 169: @@
 == Relocations ==
-Because apps are not stored at a fixed memory address, they require a relocation table to relocate them during sending and defragmentation.
+Because apps are stored at a fixed memory address, they require a relocation table to relocate them during sending and defragmentation.
 The relocation map consists of a six-byte entry for each location which needs to be updated.

@@ Line 118: / Line 118: @@
 h = Null terminated Application name (zero padded to be 9 bytes in length with terminator byte)
-Ch = Flag, [Bit 0 set - don't draw the TI splash screen] [Bit 1 set - app can use OpenLib]
+Ch = Flag
-Eh = Flag, [Bit 0 set - use the offset in 01Eh] [Bit 3 controls something]
+ [Bit 0 - Disable TI splash screen]
 h = Main section
@@ Line 130: / Line 138: @@
 Bh = Execution entry point (usually same as 012h)
-Eh = Unknown 3 byte offset (See 00Eh)
+Eh = Unknown 3 byte offset used in Language apps (See 00Eh)
 h = Offset to ExecLib jump table

@@ Line 243: / Line 243: @@
 ExecuteApp:
 ; HL -> name of app (0 terminated)
 	.org	cursorImage
 ExecuteApp_Start:
-	push	hl
+	ld	de,progToEdit
-	call	DeletePgrmFromUserMem
+	ld	bc,8
-	ld	hl,$100
-	call	_EnoughMem
-	pop	hl
-	jp	c, _ErrMemory
-	call	_FindAppStart		; This locates the start of executable code for an app
-	ld	a,E_Validation
-	jp	c,_JError		; If we can't find it, that's a problem (throw a validation error)
-	push	hl			; push location of start of app
-	call	_ReloadAppEntryVecs
-	call	_AppSetup
-	set	appRunning,(iy+APIFlg)	; turn on apps
-	set	6,(iy+$28)
-	res	0,(iy+$2C)		; set some app flags
-	set	appAllowContext,(iy+APIFlg)	; turn on apps
-	ld	hl,$D1787C		; copy to ram data location
-	ld	bc,$FFF
-	call	_MemClear		; zero out the ram data section
-	pop	hl			; hl -> start of app
-	push	hl			; de -> start of code for app
-	ld	bc,$100			; bypass header information
-	add	hl,bc
-	ex	de,hl
-	ld	hl,$18			; find the start of the data to copy to ram
-	add	hl,de
-	ld	hl,(hl)
-	call	__icmpzero		; initialize the bss if it exists
-	jr	z,+_
-	push	hl
-	pop	bc
-	ld	hl,$15
-	add	hl,de
-	ld	hl,(hl)
-	add	hl,de
-	ld	de,$D1787C		; copy it in
 	ldir
-_:	pop	hl			; hl -> start of app
+	ld	a,cxExtApps
-	call	FindStartOfAppCode	; After this, hl -> start of code for app
+	jp	_NewContext
-	jp	(hl)
 ;----------------------------------------------------------------------------

← Older revision		Revision as of 12:04, 8 October 2017
Line 10:		Line 10:

	Applications can be of arbitrary size, no longer multiples of 16kB.		Applications can be of arbitrary size, no longer multiples of 16kB.
		+
		+	You can find code for creating an application; along with other fancy items [https://github.com/mateoconlechuga/app-inc here]

	==Applications in the Archive==		==Applications in the Archive==

← Older revision		Revision as of 06:41, 2 October 2017
Line 160:		Line 160:

	Because apps are not stored at a fixed memory address, they require a relocation table to relocate them during sending and defragmentation.		Because apps are not stored at a fixed memory address, they require a relocation table to relocate them during sending and defragmentation.
		+
		+	The relocation map consists of a six-byte entry for each location which needs to be updated.
		+
		+	{\| class="wikitable"
		+	\|-
		+	! Offset
		+	! Length
		+	! Contents
		+	\|-
		+	\| 000h
		+	\| 003h
		+	\| Hole offset
		+	\|-
		+	\| 003h
		+	\| 003h
		+	\| base (2 bits) and relative value to place in hole (22 bits)
		+	\|}
		+
		+	----
		+
		+	'''Relocation Map Format'''
		+
		+	The hole offset specifies where in the application code or initial data table an absolute address needs to be updated.
		+	The value to store in the hole is calculated from the base and relative value. The base is 00 for code-segment relative and 10 for data-segment relative. Base values 01 and 11 are reserved.

	==Example==		==Example==

@@ Line 134: / Line 134: @@
 h = Offset to the string used to display a message in the memory screen (Usually a copyright, i.e. "(c) 2005-2015 Texas Instruments")
-h = Relocation information or something?
+h = Reserved word
 == ExecLib ==