XCore Exchange - New pages [en]

Fast

2012-05-07T04:25:35Z

Lilltroll: Created page with 'To be done!'

To be done!

Car-2-Car Basestation by sperner

2012-01-15T17:23:33Z

Sperner: init

I am going to build a basestation for Car-to-Car communication with wireless link via IEEE 802.11p for automotive purpose during my Bachelor Thesis. I will begin development in Spring 2012. Right now I'm just in the research phase and still don't have the hardware to begin.

Annotated Links to Other Guides

2011-12-08T16:28:40Z

Hooligan:

= Inline Assembly =

----

== XMOS Documentation ==
;[http://www.xmos.com/published/xmos-xs1-architecture The XMOS XS1 Architecture]: The XS-1 instruction set
;[http://www.xmos.com/inline-assembly Inline Assembly]: A very brief introduction to inline assembly on the XS-1
== GCC References ==
;[http://www.ibiblio.org/gferg/ldp/GCC-Inline-Assembly-HOWTO.html GCC Inline Assembly HOWTO]: Written for x86 but Section 5 covers the extended ASM syntax used in most XMOS code

Simple i2c tutorial

2011-11-14T10:49:29Z

Phalt: /* i2c example */

This tutorial gives a step by step guide to:

<ul>
<li>Getting started using the XCore Github</li>
<li>How to add XCore modules to your projects</li>
<li>A simple explanation of i2c using custom code</li>
</ul>

==Getting started using the XCore Github==

''Note: There is also another getting started guide on the XCore github [http://github.xcore.com/repo_index/github_howto.html here]''

(I'll assume you already have installed the latest version of the [http://www.xmos.com/products/development-tools XMOS development tools])

Using the XCore github is not as complicated as you think, you don't even need to have git or use github to grab the packages.

The first thing you want to do is download and import the [http://github.xcore.com/repo_index/xcommon_readme.html Xcommon] and [http://github.xcore.com/repo_index/xcore_template_readme.html XCore template] packages.

These two packages will provide you with the basic framework needed for a substantial project in the XDE.

You can now choose to either copy the '''XCore template''' project or rename it, because this will become the project you want to use.

When you have done so, open up the '''makefile''' in sw_myproject/app_template/makefile and head down to the line that says:

TARGET =

This line tells the project which development board we'll be running on. You can change this to what ever board you like, but for this tutorial we need to rename the line to:

TARGET = XDK

Once you have saved the file, '''right click on the src file''' and go to '''new->source file'''.

Name the file main.xc and hit save

To test our packages are running properly, paste this text into the main.xc file. It is just a simple "Hello world" program:

# include <print.h>
int main() {
printstrln("Hello World");
return 0;
}

'''save and build''' the program. If successful, '''run''' it. You should get this pop up in the console.:

Hello World

==How to add XCore modules to your project==

If you're struggling with how to do this, you're going to kick yourself when you see how simple it is.

First things first, you'll need to pick a repository package from the [http://github.xcore.com/repo_index/index.html List here].
There are a lot to choose from and for this tutorial we will be using the '''sc_i2c package''' which you should [http://github.xcore.com/repo_index/sc_i2c_readme.html download from here].

Once downloaded: '''import''' the zipped project into the Development tools.

Go to the project that you want to use the module in and '''open the same makefile you did earlier'''

Further down in this file is the line:

USED_MODULES

Replace this code with the name of the module in the package you just imported. In the case of the i2c, replace this line with this:

USED_MODULES = module_i2c

and that's it! It's dead simple.

You can now start using function calls from that package in your project.

==i2c explanation and example==

===What is i2c?===

i2c (eye-squared-see) is multi-master serial bus that provides communication between low-level peripherals to motherboards and other embedded systems.

For XMOS: this is a very handy package as it can provide a way for devices to communicate.

i2c uses two bidirectional buses which run serial data and serial clock. Between these two signals, they make it possible to support serial transmission of 8-bit data between devices.

There are '''slave''' and '''master''' devices on the bus. The masters initiate transmissions and the device receiving data is called the slave.

i2c can support multiple masters and slaves to provide a versatile framework for data communcation.

===i2c example===

I have created a small example project using one master and one slave to demonstrate a simple version of i2c.

This example is much easier to understand than the one included in the sc_i2c package.

You can download the package [http://dl.dropbox.com/u/19242643/i2c.zip here]

=== Set up ===

Packages you will need:

<ul>
<li>xcommon</li>
<li>sc_i2c</li>
</ul>
(these are both included in the zipped folder above)

Import the project and follow the instructions [http://github.xcore.com/repo_index/sc_i2c_readme.html#instructions-for-building-project-and-running-the-simulation on this page] to set up the simulator. It needs to be in the exact same configuration as the sc_i2c example to run.

Once done, '''build and run''' the program.

Please note that this project is aimed as a simplification of the code, so it is much easier to see and understand what is happening, nothing flashy happens when you run it!

==Known issues==

This project was made during my spare time as a submission for the [https://www.xcore.com/competitions XCore github challenge]

<ul>
<li>Only seems to work with 10.4.2 tools, this is to do with the sc_i2c package which also fails to run under 11.2 and higher (or at least in my attempts it did). I have submitted a bug report for this.</li>
</ul>

8 Sounds USB by Spyrolabs

2011-11-04T20:29:41Z

Doumdi:

'''November 4 2011'''

Have a look at those beautiful pictures of the assembled board :

[http://www.facebook.com/media/set/?set=a.10150366951566096.413812.693336095&type=1&l=c5f1b78a8d Facebook album]

Testing is under way. Stay tuned!

XC-2 Guide de Demarrage Rapide

2011-09-15T22:16:58Z

Octal: /* Disfonctionnements et Dépannage de l’Application Serveur Web */

Vous pouvez télécharger une version PDF formatée de ce document sur le lien
[[File:XC2-Quick-Start-Guide(1.1)-FR-09162011.pdf]]

=''' Introduction '''=

<center>
[[File:Xc2.jpg|400px]]
</center>

Le Kit Ethernet XC-2 est un outil rapide et à cout réduit (rentable) pour développer des produits Ethernet utilisant des composants XMOS. Construit autour d’un composant programmable XS1-G4 à quatre cœurs, le Kit XC-2 offre le matériel nécessaire pour se connecter à système Ethernet 10/100 utilisant un connecteur RJ45.

Le Kit XC-2 comprend :
:* Une carte de développement XC-2.
:* Un connecteur XTAG qui offre une interface JTAG entre la carte et les outils de développement XMOS Tools.
:* Un câble USB pour connecter la XTAG à votre système de développement.
:* Une alimentation externe 5V.

=''' Mise en Route '''=
Le Kit XC-2 inclus une application serveur web écrite en C et XC. Le XS1-G4 fait office de serveur pour le site web, et contrôle la pile de protocoles et le matériel Ethernet.

Pour utiliser le serveur web, vous devez connecter la carte XC-2 à un réseau local ou à votre ordinateur. Assurez-vous de désactiver tout firewall en cours d’exécution avant d’essayer de vous connecter au site web. Si vous n’envisagez pas de lancer le serveur web, vous pouvez aller à la section 3 « Support des Outils de Développement ».

Des informations complémentaires sur la XC-2 sont disponibles sur le site web de la société XMOS. Vous pouvez télécharger le tutoriel de la carte XC-1A, le manuel du hardware, les schémas et les fichiers de conception à partir de : http://www.xmos.com/xc2.

<center>
[[File:XC-2-clipart.png]]
</center>

==''' Connecter la XC-2 à un réseau utilisant DHCP '''==
Connectez la fiche du module d’alimentation 5V à la carte XC-2. La DEL PLL en bas de la carte s’illumine indiquant que la carte a été mise sous tension.

Connectez la XC-2 à votre réseau avec un câble Ethernet (non fourni). Un jeu de DEL s’illumine pour indiquer que la connectivité est effective.

La DEL X1LEDA s’illumine pour indiquer que l’application est en cours d’exécution. La DEL X2LEDB s’allume pour indiquer que la carte s’est connectée avec succès au réseau.

Ouvrez votre navigateur web et tapez : http://xc2.local

Utilisez le menu options pour explorer les capacités de l’appareil. Vous pouvez faire clignoter les DELs sur la XC-2, lire en temps réel les informations sur les fonctionnalités de la carte, et changer les réglages de la carte pour utiliser une configuration avec IP statique ou automatique.

==''' Connecter la XC-2 Directement à un Ordinateur '''==
Assurez-vous que l’alimentation de la XC-2 est déconnectée.

Configurez votre PC pour de manière à ce qu’il se connecte avec une IP statique valide dans le sous-réseau 192.168.0, par exemple 192.168.0.101.

Connectez la XC-2 à votre PC en utilisant un câble Ethernet.

Maintenez enfoncé fermement le bouton A (« Button A ») sur la XC-2 et connectez l’alimentation 5V sur la carte XC-2. Maintenez le bouton A (« Button A ») enfoncé jusqu’à ce que les DELs s’arrêtent de clignoter pour forcer la carte dans le mode IP Statique.

Ouvrez votre navigateur web et allez à http://192.168.0.100, l’adresse IP statique par défaut de la carte XC-2.

==''' Application serveur web – Boutons XC-2 '''==
Le type d’IP utilisée pour se connecter au serveur web est réglé dans la page « Configuration » du site web « xc2.local ». Utilisez les boutons de la XC-2 pour modifier ce réglage quand vous démarrez votre appareil :
:* '''Button A''' – utiliser une adresse IP statique (par défaut : 192.168.0.100).
:* '''Button B''' – utiliser une adresse IP automatique.

==''' Disfonctionnements et Dépannage de l’Application Serveur Web '''==
:*'''Les DELs ne s’allument pas'''
::* Vérifiez que l’alimentation est correctement connectée.

:*'''La DEL X2LEDB ne s’allume pas'''
::* Vérifiez que le câble Ethernet est connecté correctement XC-2.
::* L’obtention d’une adresse IP peut prendre jusqu’à une minute s’il n’y a aucun serveur DHCP sur le réseau.

:*'''La DEL X2LEDB s’allume mais le navigateur web ne peut charger la page http://xc2.local'''
::* Essayez d’installer « Bonjour pour Windows », disponible à partir du site : http://apple.com/downloads.
::* Désactivez tout firewall en cours d’exécution.
::* Configurez votre PC et votre XC-2 de manière à utiliser des adresses IP statiques. Cf. section 2.2.

==''' Mises-à-Jours du Firmware '''==
Vous pouvez vérifier la version du firmware en utilisant la page « Board Information » sur le site web « xc2.local ». Vérifiez les mises à jour du firmware ainsi que les instructions relatives à la mise en place de la mise à jour sur http://www.xmos.com/xc2.

=''' Support des Outils de Développement XMOS '''=
Les outils de développement XMOS sont fournis sous forme d’un seul fichier par plateforme (WIN/MAC/LINUX), téléchargeable à partir de http://www.xmos.com/tools.

Le tableau suivant résume la prise en charge de la carte XC-2 par les outils de développement :

{| class="wikitable"
|-
| Version minimale recquise des outils
| 9.9
|-
| Fichier de support de la carte
| XC-2.xn
|-
| Adaptateur USB-to-JTAG
| XTAG
|-
| Pilote de prériphérique USB-to-JTAG
| FTDI
|-
| Tutoriel de la carte
| Intégré dans XDE et disponible sous forme PDF (version française disponible sur le WIKI)
|-
| Guide du matériel
| http://www.xmos.com/published/xc2hw
|}

=''' Historique du document '''=

{| class="wikitable"
|-
! Date
! Parution
! Commentaire
|-
| 07-08-2009
| 1.0
| Première parution
|-
| 05-10-2010
| 1.1
| Ajout section "Support outils de développement"
|}

----

Disclaimer
XMOS Ltd. is the owner or licensee of this design, code, or Information (collectively, the
“Information”) and is providing it to you “AS IS” with no warranty of any kind, express or
implied and shall have no liability in relation to its use. XMOS Ltd. makes no representation
that the Information, or any particular implementation thereof, is or will be free from any
claims of infringement and again, shall have no liability in relation to any such claims.
Copyright © 2010 XMOS Ltd. All Rights Reserved. XMOS and the XMOS logo are registered
trademarks of XMOS Ltd in the United Kingdom and other countries, and may not be used
without written permission. Company and product names mentioned in this document are the
trademarks or registered trademarks of their respective owners. Where those designations
appear in this document, and XMOS was aware of a trademark claim, the designations have
been printed with initial capital letters or in all capitals.

XC-1A Guide de Demarrage Rapide

2011-09-15T15:08:55Z

Octal: /* Utilisateurs Linux */

Vous pouvez télécharger une version PDF formatée de ce document sur le lien
[[File:XC1A-Quick-Start-Guide(1.0)-FR-09152011.pdf]]

=''' Introduction '''=

<center>
[[File:Xc1a.png|400px]]
</center>

Le kit de développement XC-1A contient tout ce dont vous avez besoin pour commencer l’exploration la technologie des processeurs XMOS pilotés par évènements (event-driven).

Le kit comprend un composant XS1-G4, 4 Mbits de mémoire FLASH SPI, 16 DEL configurables par l’utilisateur, 4 boutons poussoirs, un haut-parleur, une JTAG et interface série, 4 zones d’expansion bien adaptées à recevoir des connecteurs IDC, et une zone de prototypage à trou vous permettant de connecter votre propre circuiterie externe.

La carte XC-1A peut être alimentée via un adaptateur externe 5V, ou via le câble USB fourni qui assure aussi la liaison JTAG entre la carte et les outils de développement XMOS.

==''' Caractéristiques de la carte XC-1A '''==

<center>
[[File:XC-1A-clipart.png]]
</center>

Des informations complémentaires sur la XC-1A sont disponibles sur le site web de la société XMOS. Vous pouvez télécharger le tutoriel de la carte XC-1A, le manuel du hardware, les schémas et les fichiers de conception à partir de :

http://www.xmos.com/products/development-kits/xc-1a-development-kit

=''' Utilisateurs Microsoft Windows '''=
1- Téléchargez et configurer les outils de développement
:* Téléchargez l’installateur des outils de développement à partir de l’URL suivante : http://www.xmos.com/downloads
:* Double cliquez sur le logiciel d’installation pour l’exécuter. Suivez les instructions à l’écran pour installer les outils de développement sur votre ordinateur.

2- Installez les drivers de l’adaptateur USB-to-JTAG
:* Connectez la carte XC-1A à votre machine de développement en utilisant le câble USB fourni.
::L’assistant « Nouveau Matériel » s’affiche. S’il vous propose de vous connecter à Windows Update, cliquez sur « Non ».
:* Cliquez sur « Suivant » pour continuer.
:* Sélectionnez « Installer à partir d’une liste » et cliquez sur « Avancé ».
:* Parcourez vos répertoires pour aller vers le répertoire d’installation des outils de développement XMOS, ouvrez le sous-répertoire « drivers » et sélectionnez le répertoire « FTDI ».
:* Cliquez « Suivant » et suivez les instructions à l’écran.
:* Cliquez « Terminer » pour finir l’installation du driver.

La carte XC-1A démarre et fait clignoter les DELs autour du composant XMOS qui est sur la carte. La carte XC-1A possède 4 démonstrations que vous pouvez lancer en utilisant les boutons poussoirs – cf. Section 5.

3- Démarrer les outils de développement
:* Pour démarrer l’environnement de développement intégré, cliquez sur « Démarrer>Programmes>XMOSXMOS Desktop Tools 9.9>XMOS Development Environment ».
:* Pour utiliser les outils en ligne de commande, cliquez sur « Démarrer>Programmes>XMOSXMOS Desktop Tools 9.9>Desktop Tools Prompt».

Vous êtes maintenant prêt à suivre le tutoriel de la carte XC-1A qui explique comment écrire des programmes XC pour votre carte XC-1A. Téléchargez le tutoriel à partir de :
http://www.xmos.com/published/xc1atut.

=''' Utilisateurs Mac OSX '''=
1- Connectez la carte XC-1A à votre système de développement en utilisant le câble USB fourni.
:La carte XC-1A démarre et fait clignoter les DELs autour du composant XMOS qui est sur la carte. La carte XC-1A possède 4 démonstrations que vous pouvez lancer en utilisant les boutons poussoirs – cf. Section 5.
2- Téléchargez et configurez les outils de développement XMOS Tools
:* Téléchargez l’installateur pour Macintosh à partir de l’URL:
::http://www.xmos.com/downloads
:* Double cliquez sur l’installateur téléchargé pour l’ouvrir, puis glissez l’icône XMOS dans votre dossier « Applications ».
::L’installateur copie les fichiers sur votre disque dur.
:* Démontez l’installateur.
3- Démarrer les outils de développement
:* Pour démarrer l’environnement de développement intégré, ouvrez une nouvelle fenêtre du Finder, naviguez jusqu’au dossier « Applications », ouvrez le dossier XMOS et double cliquez sur l’icône « XDE.app ».
:* Pour utiliser les outils en ligne de commande, ouvrez une fenêtre Terminal, changez de répertoire pour accéder au répertoire d’installation et tapez :
::SetEnv.command

Vous êtes maintenant prêt à suivre le tutoriel de la carte XC-1A qui explique comment écrire des programmes XC pour votre carte XC-1A. Téléchargez le tutoriel à partir de :
http://www.xmos.com/published/xc1atut.

=''' Utilisateurs Linux '''=
1- Connectez la carte XC-1A à votre système de développement en utilisant le câble USB fourni.
:* Connectez-vous à votre shell avec les droits root.
:* Ouvrez le fichier « /etc/fstab » dans un éditeur et rajoutez les lignes suivantes pour accéder au système de fichier USB :
::none /proc/bus/usb usbfs defaults,devmode=0666 0 0
:* Démontez le système de fichier USB avec la commande suivante :
::umount /proc/bus/usb
:* Remontez le système de fichier USB avec la commande suivante :
::mount /proc/bus/usb

::La carte XC-1A démarre et fait clignoter les DELs autour du composant XMOS qui est sur la carte. La carte XC-1A possède 4 démonstrations que vous pouvez lancer en utilisant les boutons poussoirs – cf. Section 5.

2- Téléchargez et configurez les outils de développement XMOS Tools
:* Téléchargez l’archive des outils de développement à partir de l’URL :
::http://www.xmos.com/downloads
:* Décompressez l’archive dans le répertoire d’installation en utilisant la commande :
::tar -xzf archive.tgz -C /home/user

:[[File:Warning_24.png|18px]]Pour que les outils Linux 64-bit fonctionnent correctement, les librairies de la couche de compatibilité 32-bit doivent être installées. Pour plus d’information sur l’installation de ces librairies sur une distribution RedHat, voir : http://www.redhat.com/support
3- Démarrer les outils de développement
:* Configurez l’environnement XMOS Tools. Changez de répertoire pour accéder au répertoire d’installation et tapez :
::source SetEnv
:* Pour démarrer l’environnement de développement intégré, tapez la commande :
::xde
:* Pour utiliser les outils en ligne de commande, appelez l’outil requis directement.

Vous êtes maintenant prêt à suivre le tutoriel de la carte XC-1A qui explique comment écrire des programmes XC pour votre carte XC-1A. Téléchargez le tutoriel à partir de :
http://www.xmos.com/published/xc1atut.

=''' Démonstrations pré-chargées sur la carte XC-1A '''=
Dès sa mise sous tension, la carte XC-1A exécute le code de démonstration pré-chargé. Son comportement par défaut est de faire scintiller les DELs bicolores sous forme d’horloge autour du composant XS1 et de faire clignoter lentement les DELs qui sont à côté des boutons poussoirs. Pressez n’importe lequel des quatre boutons pour lancer l’une des applications de démonstration simples.

==''' Bouton A : Horloge '''==
Affiche une horloge sur les DELs disposées en forme d’horloge avec les aiguilles de la montre comme suit :

:* Rouge : Minutes
:* Vert : Heures
:* Orange: Secondes

Les 12 DELs de l’horloge sur la XC-1A procurent une résolution de 5 secondes. Quand la démonstration de l’horloge s’exécute, vous pouvez utiliser les boutons comme suit :

:* A : Retourne à la démo par défaut (DEL demo)
:* B : Accélère l’horloge pour régler l’heure
:* C : Activer le son tick-tock
:* D : Désactiver le son tick-tock

==''' Bouton B : Synthétiseur Audio Simple '''==
Pressez les boutons B-D pour générer des tonalités différentes. Pressez A pour retourner à la démo par défaut (LED demo).

==''' Bouton C : Jeu de Réaction '''==
Un jeu de réaction simple. La DEL rouge tourne autour de l’horloge. Après un délai de temps variable une DEL va s’allumer en vert. Le but du jeu est de presser le bouton D quand la DEL rouge passe au-dessus la DEL verte. La vitesse du jeu augmente au fur et à mesure de vos progrès. Le jeu a cinq niveaux, le niveau courant est indiqué sur les 4 DELs à côté des boutons poussoirs. Pressez A pour retourner à la démo par défaut (LED demo).

==''' Bouton D : Simple Démo UART '''==
Une démo basique d’UART utilisant le port COM virtuel de la carte XC-1A. Une fois que vous avez démarré le programme, connectez-vous-y en utilisant un terminal (par exemple realTerm pour Windows ou GTKTerm pour Linux). Quand vous pressez une touche, s’affiche une liste de trois commandes que vous pouvez utiliser pour allumer l’horloge formée par les DELs via le terminal. Les réglages de l’UART sont comme suit :

:* Bits per sec : 115200
:* Parity : None
:* Data bits : 8
:* Stop bits : 1
:* Flow control : None

Pressez A pour retourner à la démo par défaut (LED demo).

----
''' Disclaimer '''

XMOS Ltd. is the owner or licensee of this design, code, or Information (collectively,the “Information”) and is providing it to you “AS IS” with no warranty of any kind, express or implied and shall have no liability in relation to its use. XMOS Ltd. makes no representation that the Information, or any particular implementation thereof, is or will be free from any claims of infringement and again, shall have no liability in relation to any such claims.
Copyright ©2009 XMOS Ltd. All Rights Reserved. XMOS and the XMOS logo are registered trademarks of XMOS Ltd in the United Kingdom and other countries,
and may not be used without written permission. Company and product names
mentioned in this document are the trademarks or registered trademarks of their
respective owners. Where those designations appear in this document, and XMOS
was aware of a trademark claim, the designations have been printed with initial
capital letters or in all capitals.

Basic I2C driver and application: 16 bit temperature sensor using ADT7410 by mjcross

2011-09-13T21:31:19Z

Mjcross:

A couple of words about how I approached writing the I2C driver.

I2C ('I squared C') is a two-wire bus comprising a clock signal and a bidirectional (serial, MSB first) data signal. Both signals are shared between all devices on the bus. The clock and data signals are only driven in the 'low' direction, and tristate when outputing a '1' - in which case the bus ican be either either pulled low by another device, or pulled up by a resistor in the region of 20K (NB if you are routing the I2C bus across a pcb alongside high speed data signals, it is advisable to use considerably lower pull up resistors to avoid glitches due to cross-talk).

The I2C bus can run at 400kHz, but to achieve this requires an asymmetric clock signal (Thigh < Tlow). Also, during normal operation it is important that the data signal is stable during the clock high time, as a data edge during this period signifies a control event (master start or stop).

Therefore I based the design of the driver around a reference clock that runs at three times the required bus speed. The normal mode of operation of this is as follows:

On the first (positive) edge of the reference clock, the driver begins outputting the next data bit on the data line.

On the second (positive) edge, the driver takes the bus clock high.

On the third (positive) edge, the driver returns the bus clock low [etc].

Another important consideration is that the bus expects data to be sent in transaction of 8 bits, MSB first. Therefore to use the serialisation feature of an xs-1 port, the driver has first to reverse the bit order. This is achieved using the bitrev() and byterev() functions - NB: you have to use byterev as well, because bitrev reverses the value as an entire 32 bit word (an alternative is to right-shift by 24 bits following the bitrev). NB(2): if you are using either bitrev() or byterev() you have to #include <xclib.h> within your code.