пишите нам 
Ладошки: КПК, Коммуникаторы, Смартфоны, Windows Mobile, Symbian, Palm OS PDA и гаджеты
Ладошки: КПК, Коммуникаторы, Смартфоны, Windows Mobile, Symbian, Palm OS PDA и гаджеты
Ладошки: КПК, Коммуникаторы, Смартфоны, Windows Mobile, Symbian, Palm OS PDA и гаджеты
Ладошки к Солнцу! Ладошки: КПК, Коммуникаторы, Смартфоны, Windows Mobile, Symbian, Palm OS PDA и гаджеты

Интернет реклама УБС
ToodleDo: он-лайн список дел, клиенты под iPad/iPhone/Android/WM. Будьте эффективным!
 

Приветствуем на Ладошках!

Ладошки, у меня РАНЧИК РОДИЛСЯ! :-) ... Уважаемые давние поклонники и посетители Ладошек! Я запускаю коммьюнити-сайт, новый проект, а вы все, будучи https://www.facebook.com/run4iq Бег для интеллектуалов. Бег для интеллекта. Бег "за" интеллектом. Он сам не придёт ;-) Ранчик родился! Андрей AKA Andrew Nugged Ладошки служат как архив программ для Palm OS и Poclet PC / Windows Mobile и разрешённых книг с 15 окрября 2000 года.
 
Статьи на Ладошках: о КПК и гаджетах
список групп статейВы пишете статьи? Контактируйте с нами!

 
Устройство и функционирование Shared Library (Palm OS)


Автор/Источник: Ронин Виктор
» 12.11.2002 15:53,
просмотров сегодня: 1, всего: 1987
статья размещена в группе: Программирование
оценка: 5, 2 голоса


В большинстве операционных систем есть необходимость создания динамически линкующихся библиотек, так как это дает возможность убрать дублирование кода между программами. В PalmOS для этой цели служат Shared Library. Дальше в этой статье пойдет речь о организации и функционирование Shared Librarys.

Перед тем, как перейти непосредственно к рассмотрению устройства Shared Library, сделаем небольшой экскурс в структуру PalmOS, на уровне ассемблерного кода. Вызов любой API функции в ассемблерном виде выглядит так.

trap #15
SYSTEM_TRAP_NUMBER

Естественно, на месте SYSTEM_TRAP_NUMBER стоит номер какой-то системной функции. В Palm’е они начинаются с номера 0xA000. Когда процессор обнаруживает команду trap #15, то вызывается прерывание #15. Обработчик данного прерывания, выбирает из таблицы адрес соответствующего TRAP’а и переходит по выбранному адресу.

Вероятно, чтобы не организовывать новых методов вызовов функций, были разработана система использующая уже существующий метод вызова функций API.

Для каждой новой библиотеки система не может выделять новые номера trap’ов и прописывать их обработчики. Это связано с тем, что в таком случае таблица обработчиков trap’ов должна была бы динамически изменяться, программы использующие Lib’ы должны были динамически подставлять номер trap’ов, который им надо вызвать и д.р. Как результат для библиотек были выделены фиктивные trap’ы начинающиеся с 0xA800. Фиктивными они являются потому, что, на самом деле, адреса обработчиков функций Lib’ы не хранят в той же таблице, что и адреса обработчиков функций API, а также из-за того, что всем trap’ам с номером большим 0xA800 присвоен один единственный обработчик, который dispatch’ит вызов нужной библиотеке и нужной функции.

Для того, чтобы полностью разобраться как работает библиотека рассмотрим полностью ее цикл жизни.

Начинается он с вызова функции SysLibLoad, которая ищет соответствующую .prс, и если prc найдена, то открывает в ней ’libr’ ресурс и передает ему управления вместе с параметрами refNum и SysLibTblEntryPtr. В системе храниться таблица для всех загруженных Shared Librarys, которая индексируется по refNum и состоит из SysLibTblEntryType. Так вот, функция SysLibLoad, а точнее функции SysLibInstall, которую она вызывает, находит в таблице свободный refNum, инициализирует начальными значениями структуру в этой таблице. После чего refNum и указатель на структуру(SysLibTblEntryPtr) передаются паараметрами в функцию, которая является точкой входа (Entry Point) в библиотеку.

Вот стандартная Entry Point для функции:

Err SampleLibInstall(UInt16 refNum, SysLibTblEntryPtr entryP)
{
	// Install pointer to our dispatch table
	entryP->dispatchTblP = (MemPtr*)SampleLibDispatchTable();
	
	// Initialize globals pointer to zero (we will set up our library
	// globals in the library «open» call).
	entryP->globalsP = 0;

	return 0;
}

Кстати, исходники примера Shared Library располагаются в примерах SDK 4.0. И поставляются вместе с CodeWarrior’ом 8.0. Лежат они в директории ...CodeWarrior(CodeWarrior Examples)Palm OS 4.0 SDKExamplesSampleLib

Собственно самая интересная сторока : entryP->dispatchTblP = (MemPtr*)SampleLibDispatchTable(); Она устанавливает таблицу обработчиков каждой функции внутри библиотеки.

Функция SampleLibDispatchTable возвращает таблицу dispatch’а функций внутри Lib’ы. Таблица представляет собой массив 2 байтных указателей (относительных) на обработчики функций. Она оформляется в виде ASM’овской функции, для того чтобы она не производила никаких действий над стеком. На самом деле 2 байтные указатели указывают не на сам обработчик, а на JMP на обработчик, так как команде DC.W нельзя дать в виде аргумента функцию.

static MemPtr	asm SampleLibDispatchTable(void)
{
	LEA		@Table, A0	// table ptr
	RTS			// exit with it

@Table:
	// Offset to library name
	DC.W		@Name
	
	//
	// Library function dispatch entries
	//
	// ***IMPORTANT***
	// The index parameters passed to the macro libDispatchEntry
	// must be numbered consecutively, beginning with zero.
	//
	// The hard-wired values need to be used for offsets because the MW SDK tools do
	// not support label subtraction.
	//
	
	// Standard traps
	DC.W		libDispatchEntry(0)	// Open
	DC.W		libDispatchEntry(1)	// Close
	DC.W		libDispatchEntry(2)	// Sleep
	DC.W		libDispatchEntry(3)	// Wake
	
	// Start of the Custom traps
	DC.W		libDispatchEntry(4)	// GetLibAPIVersion
	DC.W		libDispatchEntry(5)	// SetCornerDiameter
	DC.W		libDispatchEntry(6)	// GetCornerDiameter
	DC.W		libDispatchEntry(7)	// DrawRectangle

// Standard library function handlers
@GotoOpen:
	JMP 		SampleLibOpen
@GotoClose:
	JMP 		SampleLibClose
@GotoSleep:
	JMP 		SampleLibSleep
@GotoWake:
	JMP 		SampleLibWake
	
// Customer library function handlers
@GotoGetLibAPIVersion:
	JMP 		SampleLibGetLibAPIVersion
@GotoSetCornerDiameter:
	JMP 		SampleLibSetCornerDiameter
@GotoGetCornerDiameter:
	JMP 		SampleLibGetCornerDiameter
@GotoDrawRectangle:
	JMP		SampleLibDrawRectangle

@Name:
// This name identifies the library.  Apps
DC.B		sampleLibName			
}

При любом вызове этой функции библиотеки из программы, будет вызван trap 0xA8xx, где xx какое-то число. Управление получит обработчик trap #15 он его передаст dispatch’еру вызовов к Shared Librarys (так как trap > 0xA800). Далее этот dispatch’ер по refNum’у получит SysLibTblEntryPtr из таблицы Shared Librarys. RefNum он получает из стека, так как каждой функции из Shared Library первым параметром должен передаваться ее refNum. После получения SysLibTblEntryPtr dispatch’ер берет из него таблицу dispatch’а внутри библиотеки, и получив разницу между номером Trap’а который был вызван и 0xA800 извлекает из этой таблицы адрес функции в библиотеки, после чего передает ей управление.

По окончанию работы с библиотекой вызывает функция SysLibRemove, которая отчищает запись в таблице Shared Librarys, соответствующую переданному refNum’у.

Одно из очень важных замечаний. В библиотеки обычно объявляется enum в котором хранятся номера Trap’ов, которые должны использоваться для каждой функции

typedef enum {
	sampleLibTrapGetLibAPIVersion = sysLibTrapCustom,
	sampleLibTrapSetCornerDiameter,
	sampleLibTrapGetCornerDiameter,
	sampleLibTrapDrawRectangle,
	
	sampleLibTrapLast
} SampleLibTrapNumberEnum; 

extern Err SampleLibOpen(UInt16 refNum, UInt32 * clientContextP)
				SAMPLE_LIB_TRAP(sysLibTrapOpen);

Причем эти значения используются при объявление функций, чтобы при компиляции программы использующей Lib’у при вызове функции Lib’ы подставлял нужный Trap. Так вот, очень важно проследить, чтобы DC.W и JMP на функции в SampleLibDispatchTable были объявлены В ТОМ ЖЕ ПОРЯДКЕ, что и в enum’е. Если вы перепутаете его, то управление получит другая функции, для которой может быть слишком много параметров или слишком мало... как результат будет много проблем и вероятней всего Fatal Alert.

Еще одна проблема на которую я натолкнулся. Это, то, что однажды я в JMP вместо названия функций написал элементы enum’а, после чего естественно оно глючило при работе, однако не выдало никаких ошибок при компиляции и линковке

Еще одна особенность, то что функции Shared Library не имею доступа к глобальным переменным обычным путем, а также по в обычном виде Shared Library должна занимать 1 segment. Для работы с глобальными переменными в Shared Library предусмотрено специальное поле в SysLibTblEntryPtr. Оно называется globalsP. И в любой функции его можно использовать, использовав функцию SysLibTblEntry(refNum), и получив таким образом SysLibTblEntryPtr. Перед использованием globalsP должен быть инициализирован (выделена память), после окончания использования необходимо высвободить память.

Ну и напоследок пару слов некоторых define’ах в Lib’ах.

#ifdef BUILDING_SAMPLE_LIB
	#define SAMPLE_LIB_TRAP(trapNum)
#else
	#define SAMPLE_LIB_TRAP(trapNum) SYS_TRAP(trapNum)
#endif

Этот define объявлен для того, чтобы при использование из программы функции библиотеки вызывались через trap’ы, а при использование внутри lib’ы они использовались обычные вызовы. Это осуществляется тем, что в библиотеке defin’ится BUILDING_SAMPLE_LIB. И второй define :

	#define SampleLibInstall		__Startup__

С помощью него обозначается какая функция будет точкой входа, так как по умолчанию точкой входа считается функция с названием __Startup__.

1   2   3   4   5
«хуже     ваша оценка     лучше»


Обсуждение

Ваше мнение будет первым.



 

Чтобы писать комментарии вам нужно
авторизоваться (войти) или зарегистрироваться


 
Регистрация товарного знака в Украине patent.km.ua.
Telephones, address and opening times for shops, post and banks in the UK
 
 

 

статьи
по этой теме
 
EWE — инструмент разработки Java-приложений для платформы PocketPC
04-02-2008, рейтинг(общ.): 3.4, просм.: 0/5367

Платформа Palm OS: защита программного обеспечения
14-05-2003, рейтинг(общ.): 2.862, просм.: 0/8336

Немножко о работе с сетями (Palm OS)
18-03-2003, рейтинг(общ.): 2.22, просм.: 0/4091

Установка цветов прорисовки (Palm OS)
15-01-2003, рейтинг(общ.): 2.35, просм.: 0/2416

Накладывающиеся Control’ы (Palm OS)
29-12-2002, рейтинг(общ.): 2.334, просм.: 0/2250

Создание Static Library (Palm OS)
28-12-2002, рейтинг(общ.): 2.9, просм.: 0/2876

Использование внеэкранного буфера при высоком разрешении (Palm OS)
11-12-2002, рейтинг(общ.): 2.226, просм.: 0/2943

Четыре метода перехвата нажатий на кнопки Палма (Palm OS)
28-11-2002, рейтинг(общ.): 2.653, просм.: 0/3289

Ссылки по программированию (Palm OS). Часть 3
21-11-2002, рейтинг(общ.): 1.812, просм.: 0/5226

Самоудаляющаяся программа (Palm OS)
21-11-2002, рейтинг(общ.): 2.364, просм.: 0/2709

Программирование под Palm OS: Урок 1. Знакомство с CodeWarrior и Constructor’ом
15-11-2002, рейтинг(общ.): 4.438, просм.: 0/3802

Недокументированные функции MemSemaphoreReserve и MemSemaphoreRelease (Palm OS)
14-11-2002, рейтинг(общ.): 2.749, просм.: 0/2213

Программирование под Palm OS: Урок 0. Что нужно для того, чтобы писать под Palm?
09-11-2002, рейтинг(общ.): 3.824, просм.: 0/2671

Коротко о вставке текста в Field’ы (Palm OS)
07-11-2002, рейтинг(общ.): 2.44, просм.: 0/2106

Ссылки по программированию (Palm OS). Часть 2
31-10-2002, рейтинг(общ.): 2.475, просм.: 0/4903

Работа с полями таблицы (Palm OS)
31-10-2002, рейтинг(общ.): 2.334, просм.: 0/2411

Работа с потоковыми файлами на Palm’е (File Streaming API) (Palm OS)
31-10-2002, рейтинг(общ.): 2.095, просм.: 0/2495

Хранение проекта в системе контроля версий (Palm OS)
29-10-2002, рейтинг(общ.): 2.111, просм.: 0/2537

О custom control’ах и их реализации в виде gadget’ов (Palm OS)
28-10-2002, рейтинг(общ.): 2.632, просм.: 0/2643

Быстрая работа с графикой (Palm OS)
25-10-2002, рейтинг(общ.): 2.167, просм.: 0/3053

а вы знаете, что есть:
- рейтинг-каталог сайтов Ладошек?

поддержите
Ладошки
 
Рейтинг Ладошек: КПК, мобильность, коммуникаторы, смартфоны, гаджеты, высокие технологии Рейтинг каталога сайтов Хмельницкого региона Поддержите Ладошки: Как поддержать сайт?
Использование материалов сайта разрешено только при наличии
гиперссылки на страницу Ладошек без блокировки индексации
реклама на сайте    Andrew Nugged © 2000-2015