Tokicad 1.00 beta
                              (copyright Renie S. Marquet Nov/2005)

*****NOVA RELEASE : 05.07.2006

NOVO: A função de troca de idiomas está praticamente completa, para disponibilizar um novo
idioma, basta editar o arquivo tokicad.ini e:
 -- incluir o nome na seção [idioma], ex: &Deutsh
 -- criar uma nova seção com o mesmo nome incluido no passo anterior: [&Deutsh]
 -- copiar o conteúdo da seção [&Português]
 -- traduzir as mensagens/palavras de cada linha que estiver após o sinal '=' (igual)
 -- onde tiver as combinações %s or %d ,estas não devem ser trocadas.

NEW: To include a new language, edit tokicad.ini file and:
 -- include the name in [idioma] section, ex: &Deutsh
 -- creat a new section with same name included in first step: [&Deutsh]
 -- copy the content from section [&Português]
 -- translate the message/words of the each line after signal '=' (equal) 
 -- where have the combination %s or %d, these dont' can be changed.


Atenção: esta é uma versão Beta, totalmente desenvolvida apenas com pesquisas de arquivos
enviados por colegas (o autor não tem nem nunca usou o Tango nem o P-Cad).

Esta ferramenta está sendo desenvolvida para auxiliar aos usuários do antigo Tango
a migrarem para o Kicad (está em estudo a conversão de arquivos P-Cad também).

O Tokicad interpreta e converte os arquivos de esquema e pcb no formato ASCII, gerando 
todos os arquivos necessários para o Kicad.

Atenção!!! O ToKicad só converte os arquivos originais no formato ASCII !!!

A partir do arquivo de esquema é gerado o arquivo de projeto (.pro), a lib de componentes
(.lib) e o arquivo de esquema prontos para abrir no Kicad. Para cada tipo de componente 
encontrado no esquema é criado um único modelo na lib.

A partir do arquivo de pcb é gerado o arquivo de netlist (.net), o arquivo de vínculo de 
componentes (.cmp), a biblioteca de módulos (footprint) (.mod) e o arquivo de pcb (.brd) 
prontos para abrir no kicad. Devido ao arquivo de pcb do Tango não ter uma referência
indicando se o módulo original foi rotacinado, não foi possível atuar como no esquema em 
que apenas um modelo é gerado na lib, assim, é gerado um módulo na biblioteca para cada
um encontrado no pcb.

As conversões não são perfeitas nem totalmente completas, esta ferramenta destina-se apenas
a auxiliar na migração de projetos, atualmente auxilia em 80% a 90% da tarefa de migração.

Um pequeno problema identificado com arquivos de esquema da versão 1.2 do Tango é que em
arquivos que sofreram alterações e tiveram componentes deletados, o Tango parece não 
dar muita atenção para o arquivo e não atualiza o parâmetro que indica a rotação dos 
componentes! Como é utilizada a primeira imagem do componete encontrada para montar o modelo
para a lib, se o parâmetro de ângulo do primeiro estiver errado, as demais cópias do 
componente poderão aparecer no esquema orientadas erroneamente, neste caso, o usuário deverá 
orientar a rotação do componente editando o esquema (o ideal seria acertar a lib!) . 
Está disponível a opção de gerar um componente na lib para cada um encontrado no esquema,
deste modo a visualização será perfeita mas, isto não é aconselhavél pois além de "quebrar"
a correspondencia do arquivo de netlist, irá gerar uma lib muito maior com vários
componentes praticamente inúteis!

Foi identificado nos arquivos de pcb que no Tango as camadas são definidas pelo usuário,
deste modo não foi possível fixar uma conversão direta, para solucionar este problema,
foi criada uma configuração em que o usuário pode escolher a correspondência de camadas.

Esta ainda é uma versão BETA, como foram utilizados poucos arquivos para pesquisas e de
poucos colaboradores (cada usuário tem seu "vício" de comportamento), problemas diversos
podem surgir (por favor informem ao autor com subsídios que possam ajudar no levantamento
da solução!) e vários parâmetros dos arquivos não foram considerados pois não foi possível
identificar suas utilidades.

E como todo software free, o autor não se responsabiliza pela utilização do mesmo, seja
direta ou indiretamente, é oferecido "as is", os riscos e responsabilidades são delegados
aos usuários.

Todos os comentários, sugestões, informações de bugs e até um simples "alo" serão bem 
recebidos pelo autor e respondidos (se seu e-mail não for respondido com pelo menos um
"obrigado pela informação", ou não chegou até o autor ou a resposta do autor não chegou
até você, Renie S. Marquet sempre responde a todos os e-mail's o mais breve possível).

Como utilizar:

- Criar um diretório para o projeto do Kicad.

- Copiar os arquivos de esquema e pcb no formato ASCII para o diretório do projeto

- Para que os arquivos fiquem diretamente interligados no Kicad, utilize o mesmo nome
para o esquema e a pcb.

- No Tokicad, informe os arquivos a serem convertidos e o diretório de destino.

- Na aba de configuração, se necessário, defina a correspondência entre as camadas
da pcb no Tango e no Kicad.

- Clique no botão converter, após a conversão será apresentado um relatório de estatíticas
da conversão.

- Se não ocorreu problemas na conversão, clique em salvar.

- Abra o projeto no Kicad e verifique o resultado, se necessário, ajuste a orientação de
rotação dos componentes, verifique também se as camadas da pcb estão corretas, caso estejam
invertidas ou incorretas, refaça a conversão alterando a configuração da pcb até acertar.


Aproveitem, divirtan-se, e não se esqueçam de ajudar a evoluir esse software!

Renie S. Marquet