Difference between revisions of "WinCE port/pt"
Line 171: | Line 171: | ||
== Documentation == | == Documentation == | ||
− | === | + | === Algumas notas sobre WinCE === |
− | * | + | |
+ | * Se você estiver obtendo "Uknown error! Error code : 0xc1" e usando dlls, o erro deve haver porque você está usando algumas export entries não encontradas no arquivo da dll. Verifique a seção export da dll e o nome delas e como utilizá-las. | ||
=== WinCE port notes === | === WinCE port notes === |
Revision as of 20:57, 20 May 2007
This article applies to Windows CE only.
See also: Multiplatform Programming Guide
│
English (en) │
italiano (it) │
português (pt) │
русский (ru) │
中文(台灣) (zh_TW) │
O porte do WinCE é bem completo e utilizável. Ele foi iniciado e é mantido por Yury Sidorov. Oliver (Oro06) cabeçalhos portados da WinCE API.
Estado atual
- O compilador 2.1.x dá suporte à compilação para WinCE.
- ARM CPU tem suporte.
- As seguintes plataformas têm suporte:
- Pocket PC 2002 – WinCE versão 3.0
- Pocket PC 2003 – WinCE versão 4.20
- Pocket PC 2003 Segunda Edição – WinCE versão 4.21
- Windows Mobile 5.0 – WinCE versão 5.0
- RTL e unidades FCL estão funcionando.
Construindo o Tutorial
Durante o tutorial alguns caminhos serão supostos para demonstrar o processo de contrução. Apenas substitua aqueles caminhos pelos do seu sistema.
Passo 1 - Binutils para cross-compilação:
Estas são as ferramentas básicas necessárias para criar executáveis, como: Vinculador (ld), Montador (as), Archiver (ar) (cria arquivos .a do smartlinking), strip e algumas outras.
Você precisa das binutils para cross-compilação para ARM-WinCE, pegue-os em ftp://ftp.freepascal.org/pub/fpc/contrib/cross/arm-wince-binutils.zip for Win32.
Extraia-os em algum diretório no caminho da sua máquina. Vamos supor que você os extraiu em: C:\Programas\arm
Passo 2 - Cross-compilador
Agora você precisa construir o cross-compilador FPC para o processador ARM. Para fazer isso você precisa dos fontes mais recentes do FPC 2.1.x e a instalação do FPC 2.0.4 funcionando para Win32.
Pegue os fontes mais recentes do repositório do 2.1.x no Subversion: http://www.freepascal.org/develop.html#svn
Vamos supor que o seu ompilador FPC para Win32 está localizado em: C:\Programas\fpc\bin\i386-win32
E os seus fontes do Free Pascal 2.1.x estão localizados em: C:\Programas\fpc
Passo 3 - O Processo de Construção
Para construir o cross-compilador é necessário ter uma variável de ambiente PATH correta. No Windows é muito fácil ter um PATH junto com a informação colocada pelos instaladores. Para se certificar de que o seu Path está correto, crie um arquivo de lote do DOS com o seguinte código:
PATH=C:\Programas\fpc\bin\i386-win32;C:\Programas\arm make cycle CPU_TARGET=arm OS_TARGET=wince
Ponha este arqquivo em C:\Programas\fpc\compiler, abra a linha de comando do Windows, vá para esta pasta e execute o arquivo de lote.
No fim da compilação você não deve ter mensagens de erro.
Você deve ter um ppccrossarm.exe em C:\Programas\fpc\compiler e alguns arquivos .o e .ppu em C:\Programas\fpc\rtl\units\arm-wince
Copie eses arquivos para a sua instalaçãodo Free Pascal. O cross-compilador ppccrossarm.exe deve ir para C:\Programas\fpc\bin\arm-wince e as unidades para C:\Programas\fpc\units\arm-wince
Passo 4 - Arquivo de configuração
Você precisa criar um arquivo de configuração fpc.cfg na pasta C:\Programas\fpc\bin\arm-wince para usar o ppccrossarm.exe com facilidade.
Crie um arquivo fpc.cfg vazio na pasta C:\Programas\fpc\bin\arm-wince e adicione as seguintes linhas:
-Twince -FuC:\Programas\fpc\units\arm-wince -XParm-wince- -FDC:\Programas\arm
Finalmente adicione C:\Programas\fpc\bin\arm-wince e C:\Programas\fpc\bin\i386-win32 à sua variável de ambiente PATH.
Lembre-se de substituir os caminhos pelos do seu sistema.
Compilando um Projeto de Teste
Você compilou o compilador. Agora, o que você pode fazer com ele? Este é um tutorial para criar um projeto "hello world" com o seu novo compilador.
Passo 1 - Instalando e Configurando o Emulador
Você vai precisar de um emulador Windows CE configurado para ActiveSync. O ActiveSync é necessário para instalar o PocketCMD, uma ferramenta de linha de comando para executar o nosso programa ""hello world'.
Baixe o emulador de dispositivo livre Pocket PC da Microsoft. Ele emula o ARM CPU. http://msdn.microsoft.com/mobility/downloads/Emulator/default.aspx
Existe um tutorial de como configurar o emulador para ActiveSync here.
Passo 2 - Instalando a linha de comando
Baixe e instale o PocketCMD da SymbolicTools. Pegue-o aqui
Verifique a seção WinCE port notes abaixo para maioresa detalhes sobre linhas de comando em Pocket PC.
Passo 3 - Compilando
Um arquivo de exemplo para compilar:
program test; {$apptype console} var Str: string; begin WriteLn('Software Developed with:'); WriteLn('The Free Pascal Compiler'); WriteLn(''); WriteLn('Please, enter your name:'); ReadLn(Str); WriteLn('Your name is: ' + Str); end.
Sample de linha de comando para compilar test.pas:
ppcrossarm test.pas
Você vai pegar o executável test.exe. Copie-o para o seu dispositivo Windows CE e execute.
Aqui está um screenshot de um programa criado dessa forma.
Depurando aplicações WinCE
O GBD pode ser usado para depurar suas aplicações WinCE remotamente via ActiveSync. Baixe o GDB 6.4 para hots Win32 e arm-wince target aqui: ftp://ftp.freepascal.org/pub/fpc/contrib/cross/gdb-6.4-win32-arm-wince.zip
Algumas dicas:
- Passe o parâmetro --tui para o GDB para habilitar a interface TUI que faz a depuração mais confortável.
- Use finais de linha unix (LF only) nos seus fontes Pascal. Senão o GDB vai mostrar os fontes incorretamente.
Como usar:
Primeiro faça a conexão ActiveSync no seu dispositivo Pocket PC.
Então carregue o gdb:
gdb --tui <seu_executavel_no_pc_local>
No prompt do gdb escreva:
run ou só r
GDB vai copiar o seu executável para o seu dispositivo na pasta \gdb e executá-lo.
Aqui está uma pequena lista dos comandos mais necessários do GDB:
- r args - executa o programa com args argumentos.
- s - step into.
- n - step over.
- ni - step over instrument. Pula instrução assembly .
- c - continua a execução.
- br <function_name> - configura um breakpoint em function_name. Usa PASCALMAIN para configurar um breakpoint no início do programa.
- br <source_file>:<line_number> - configua um breakpoint na linha especificada dos fontes.
- disas - mostra um disassembly da localização atual.
- x/fmt address - dump de memória no endereço com formato especial. use "help x" para maiores informações.
- bt - back trace. imprime back trace da chamada do stack.
- where - Mostra a linha atual e a função e o stack das chamadas that got you there.
- q - Sai do gdb.
Para aprender mais sobre como usar o GDB leia sua documentação aqui: http://www.gnu.org/software/gdb/documentation
Construindo bibliotecas do FPC
Se você quer construir bibliotecas disponíveis com o FPC vá para a pasta de bibliotecas e execute:
PATH=C:\Programas\fpc\bin\i386-win32;C:\Programas\fpc\compiler;C:\Programas\arm make OS_TARGET=wince CPU_TARGET=arm PP=ppcrossarm.exe
Por exemplo você quer construir a FCL. Vá para a pasta fpc\fcl e execute o comando abaixo. Você vai obter as unidades da FCL compiladas em fpc\fcl\units\arm-wince.
Documentation
Algumas notas sobre WinCE
- Se você estiver obtendo "Uknown error! Error code : 0xc1" e usando dlls, o erro deve haver porque você está usando algumas export entries não encontradas no arquivo da dll. Verifique a seção export da dll e o nome delas e como utilizá-las.
WinCE port notes
- chdir procedure always produces an error (WinCE does not support setting of current directory).
- All file/dir paths must be absolute (started with \).
- WinCE is unicode OS. All string parameters to API calls must be PWideChar.
- WinCE does not have support for environment strings.
- WinCE does not have support for console applications by default. But you can install console support by yourself. Please note that FPC creates GUI applications for WinCE target by default. To create console application you should use -WC compiler switch or put {$APPTYPE CONSOLE} directive to source code.
To enable console in WinCE install one of the following programs:- PocketCMD by SymbolicTools. It is recommended solution. Get it here
- PPC Command Shell from Microsoft Windows Mobile Developer Power Toys. Get it here
PPC Command Shell have less features than PocketCMD. Also it have some issues. One of them - a new console window is opened even if an application is started from a console command prompt.
See Also
Links
- Useful WinCE info http://www.rainer-keuchel.de/documents.html
- Standalone Pocket PC device emulator from Microsoft. It emulates ARM CPU. Get it here
- KOL-CE. WinCE port of KOL GUI library. http://sourceforge.net/projects/kol-ce/
- Mamaich Pocket PC port of GCC http://mamaich.uni.cc
- Buildfaq is a general FAQ about how to build and configure FPC.
Here are some links related to ARM CPU Architecture
- ARM Core Developers Forum Not that much active though.
- GCC ARM Improvement Project
- ARM ASSEMBLER Good information and codes related to arm assembly language.
- GNU ARM toolchain for Cygwin, Linux and MacOS
- Microsoft Windows CE .NET 4.2 ARM Guide
- ARM Instruction Sets & Programs Very good and consice information about arm architecture
- The ARM Instruction Set Another fine power point file about arm
Contacts
Write any questions regarding WinCE port to Yury Sidorov