Version 0.30.
This is the online HTML version of "Jaluino Medium User Guide" PDF version. You can also download the PDF version from Jallib download section, where you'll also find all Jaluino packages.
The Jaluino Team
Jaluino is prototyping board, inspired by Arduino. Arduino is defined (from authors themselves) as "an open-source physical computing platform based on a simple microcontroller board, and a development environment for writing software for the board". So Jaluino is aimed to provide the same kind of features1.
While Arduino is based on Atmel microncontrollers, Jaluino is based on Microchip PIC microcontrollers. This is one of the main reason why Jaluino exists. Another reason is Jaluino uses jalv2, jallib and other Just Another Language related projects.
One important aspect is shields. Arduino boards provide a common hardware base, the main board. On top of this board, daughter boards, named "shields", can be plugged. This allows to share hardware designs easily, focusing only on new features, not on microcontroller basic setup (crystal speed, communication dedicated modules, etc...).
Jaluino claims to provide the same shield functionality. That's why it's an Arduino-like board. But... shields aren't the same, size is different, pin number and layout are different, pin functionalities are different. That's why it may not be considered as an Arduino clone...
Enough talking, here's a photo showing how Jaluino looks like.
The following picture shows the different connectors and important parts composing Jaluino Medium.
Several power sources options are available, selectable using jumpers. Fuse protection (500mA) helps keeping board safe when handled by distracted users...
PIC 18F4550 is clocked by a 20MHz crystal, allowing speed up to 48MHz using PLL (kind of black magic...).
Most used communication protocols are available from the board: USB, serial, I²C, ICSP. Those connectors are right angle male connectors, so easily plug wires and buses.
Resetting PIC 18F4550 can be done manually, using Reset push button, or using special RTS serial line, without manual intervention. This Reset-via-RTS feature is enabled using a jumper.
Finally, female connectors on the center compose shield connectors, used to expose pins to daughter boards.
See Hardware setup for detailed instructions about using jumpers and enabling/disabling features.
Jaluino Medium board size is rather bigger than Arduino Duemilanove board. This is mainly because microntroller itself is bigger (it has more pins). Jaluino board is also single sided, to be easier to build at home. Finally, Jaluino provides more features, like a serial connector1 and an I²C connector.

Jaluino shield aera is smaller than the board itself, whereas Arduino's shield have quite the same size as the board.
| Length | 4.53" (or 11.5cm) |
| Width | 3.35" (or 8.5cm) |
| Length | 3.35" (or 8.5cm) |
| Width | 2.95" (or 7.5cm) |
The following diagram shows 18F4550 pin layout, beside Jaluino shield connector. This is an important diagram, as it shows relation between PIC's pins and connectors, which pins is exposed2, which is not.
Jaluino Medium also exposes its pins as arbitrary number, following connect J1 to J4. Pins can then be accessed within code as number is necessary.
The maximum input current drawn by your 5V and 3.3V circuit depends on input voltage and also if you cool your voltage regulator (MC7805C only necessary).
If you don't cool your voltage regulator you have to look into the specs of your regulator at the therminal resistance, junction to ambient value. For the MC7805 this is 65°C/Watt.
This means that the temperature of your regulator increases 65°C with every 1Watt it consumes. If you add the ambiant temperature of aprox 25°C, your regulator will have an total temperature of 90°C after only consuming 1 Watt.
Although 90°C is not its limitation (the max temperature is 125°C), it warms enough to burn your fingers so lets stay below 1 watt consumption in your regulator.
Power = current x voltage, which gives W=I x U, so with this formula you can calculate your max current consumption in your 5V and 3.3V circuit.
For instance if you use a 9Vdc power supply voltage drop over the regulator is 9V - 1V (drop over bridge) - 5V = 3V.
Max current = W/U = 1/3 = 0.33A (total current in your 5V and thus also 3.3V circuit)
As a result of this, you can understand that if you need much current, it is always best to keep your input voltage as close as possible to the minimum input (9Vdc). If you only have a higher voltage power supply you need to limit your current, or power your board with USB.
If, for any reason, you need more power in your 5V and 3.3V circuit, you need to cool your 5V regulator. In this case you need a very well stabilized 9Vdc power Supply. you can than remove C6 (470uF/35V) which is only necessary for unstabilized or AC voltage input. Use this space to place a heatsink on 5V regulator (U2). (TODO: link to an appendix page explaining this modification, and add picture(s))
Jaluino Medium can provides three voltages on-board, Vin (only when using AC/DC adaptor on jack), 5V and 3.3V:
Version a: this version uses pin layout Ground/Output/Input.

The following components use this pin layout, and can be used to build Jaluino Medium version a: LD1117V33, LM1117T, LM1086.
Version b: this version uses pin layout Input/Ground/Ouput.

The following components use this pin layout, and can be used to build Jaluino Medium version b: LM3940, LF33V.
Choosing version a or version b really is just about selecting which regulator you mostly can find, at lowest price. Other Jaluino features remain the same.
Jaluino Medium comes in two versions, a and b. See section "Description" to understand why. This section simply describes schematics for these two versions. For better readability, you may also have a look at PDF versions.
All schematics, as well as PCBs, are available at Jaluino SVN repository. If you have troubles with following links, please directly have a look this repository.
Version a schematic is also available on Jaluino SVN repository as a PDF file.
Version b schematic is also available on Jaluino SVN repository as a PDF file.
As previously described (see here), Jaluino Medium can be configured on board, with several jumpers. This section describes how to setup these jumpers, showing the different combinations.
Jaluino can be powered using different sources (see here for power specifications): a classical AC/DC adaptor, using USB connector or through a serial module (typically a USB-to-serial adaptor). These different possibilities can be configured with jumpers JP1, JP2, JP3 and JP4.
JP1, JP2 and JP3 jumpers are located on top left and JP4 is located on top right of the board, near serial connector.


Two jumpers can be used to setup serial, basically to configure RTS and CTS. Involved jumpers are JP7 and J7, they are located on top right of the board, near serial connector.



Jaluino Medium has built-in, ready-to-use I²C bus. Jaluino can act as a master or a slave. This behavior is under control of jumpers JP5 and JP6. These jumpers always go by pair: either you plug JP5 and JP6, either you don't plug any jumper at all.1.


Before explaining how to build Jaluino Medium board, one may say: "I don't want to build it, where can I get it ?". Good question ! There's currently no way to get Jaluino Medium other than building it.
In other words, you can't buy a PCB, nor a kit, nor a ready-to-use board, there's no such things to sell... Why ? Because most of this is still very new. In order to buy such a board, a big enough user base is needed. So ? Well, if you're interested in buying a PCB, kit or board, please share your interest with Jaluino Group1 ! By collecting such message, we, Jaluino Team, will be able to have a realistic overview of the need, and may then providing PCB, kit or even the board itself, for a decent price.
Until that time comes, you'll have to build the board. This kind of means it would better if you've already experienced PCB creation, not a pre-requisite, but almost to be honest. Fortunately, Jaluino Medium is designed to be easily built, at home, by average user. Nothing difficult here, it's mostly about having the right tools.
Building the PCB can be done in different ways, depending on available tools, time, budget, easiness,... One easy way, and probably the cheapest one related to good results it provides, is to create PCB using toner transfert technique. The idea is to print the mirrored PCB on a paper, then tranferring it a copper board, most of the time using an iron (the same used for your shirts... well... maybe not the same !). PCB tracks are thus sticked to the copper board. Put it in echant, and you'll get your PCB. Most variations come from the different papers used.
When building Jaluino Medium board, you want it to be as beautiful as possible. That's normal. In order to add a nice finished and polished look, you can add labels on the component side. Before soldering components, think about it, after it'll be too late... or you'll have to unsolder all components and possibly damage them.
Labels can be printed on paper, and sticked onto the component side. If you decide to go this way (which I strongly suggest if you want to impress your wife, friends, co-workers, dog, cat, yourself), follow the guideline here. (TODO: link to "Put labels on your board to make it awesome" tutorial).
Once your PCB is ready, use your faithful solder iron, and start soldering components. The following list shows all required components:
| Component name | Description |
|---|---|
| R1 | 1.2K resistor 1/4W |
| R2, R3 | 4.7K resistors 1/4W |
| R4 | 1.5K resistor 1/4W |
| C1, C4, C7, C8, C11 | 100nF capacitors |
| C2, C3 | 15pF capacitors |
| C5 | 220nF ceramic capacitor2 |
| C6 | 470µF/35V capacitor |
| C9, C12 | 47µF/35V capacitor |
| C10 | 220nF capacitor |
| DB1 | DF04M diode rectifier |
| U1 | Microchip PIC 18F4550, with 40pins large tulipe support |
| U2 | 7805 voltage regulator |
| U3 | 3.3V regulator, see this section for more about this component |
| X1 | 20MHz crystal |
| J1, J2, J3, J4 | 1x8 female pin headers |
| J5 | 1x6 female pin header |
| J6, J8 | 1x6 male pin headers |
| J7 | 1x3 male pin headers |
| J9 | Power supply connector |
| J10 | 1x4 male pin headers |
| D1 | 1N4148 diode |
| D3 | 1N4001 diode |
| D4 | 3" green LED |
| F1 | 500mA fuse and support |
| CON1 | B-Type USB connector |
| SW2 | Push-button (switch) |
| JP1, JP2, JP3, JP4, JP5, JP6 | Jumper connectors (1x2 male pin headers) |
Almost all components look like this, to give a rough idea (some are missing, like 3.3V regulator)
Following Arduino's original licensing, Jaluino reference designs for boards and shields, including schematics and PCBs, are released under Creative Common Attribution-Share Alike 3.0 license.

Full license lecal code can be read at: http://creativecommons.org/licenses/by-sa/3.0/legalcode
Just like Arduino, you can build your own version of Jaluino derived from original reference designs. But we'd like to keep the name "Jaluino" strictly related to original designs, those coming from Jaluino Team/Group, in order to maintain our own official standards.
Jaluino user guide, tutorials and documentation in general is released under a more restrictive license related to commercial usage, the Creative Common Attribution-Noncommercial-Share Alike 3.0 license.

If any questions, suggestions or doubts, please reach Jaluino Group at http://groups.google.com/group/jaluino.