Difference between revisions of "CI20 Beginners Guide"

From eLinux.org
Jump to: navigation, search
m (move TOC to right)
(Can I power the board from the USB?)
 
(24 intermediate revisions by 6 users not shown)
Line 2: Line 2:
 
The CI20 is 'ready to go out of the box'. The on-board NAND flash comes pre-programmed with a Debian7 installation. Booting the CI20 will take you into Debian. If you then have the correct connections (keyboard, mouse, screen, network or serial port) then you are good to go.
 
The CI20 is 'ready to go out of the box'. The on-board NAND flash comes pre-programmed with a Debian7 installation. Booting the CI20 will take you into Debian. If you then have the correct connections (keyboard, mouse, screen, network or serial port) then you are good to go.
  
The below questions aim to get you going with the CI20 from the outset. If you need more technical details then please consult the system manuals from this web site or the [[CI20_Dev_Zone|developer zone]] pages, or leap onto the [https://groups.google.com/forum/#!forum/mips-creator-ci20 mailing list].
+
The below questions aim to get you going with the CI20 from the outset. If you encounter problems, please read the [[CI20 Troubleshooting|Troubleshooting]] page. If you need more technical details then please consult the system manuals from this web site or the [[CI20_Dev_Zone|developer zone]] pages, or leap onto the [https://groups.google.com/forum/#!forum/mips-creator-ci20 mailing list].
  
 
== Shall I just plug it in? ==
 
== Shall I just plug it in? ==
Yes! Out of the box the CI20 is 'ready to go'. By default it will boot the image in the on-board NAND. From the factory this image is Debian7. To really use the board it will need at minimum an HDMI screen, a USB keyboard and preferably a mouse. You can then configure the system to suit your individual needs, such as connecting it to your wifi network or ethernet and installing more packages. Please see the [[CI20_Debian7|CI20 Debian7]] page for more details.
+
Yes! Out of the box the CI20 is 'ready to go'. By default it will boot the image in the on-board NAND. From the factory this image is Debian7. To really use the board it will need at minimum an HDMI screen, a USB keyboard and preferably a mouse. Remember to plug in the hdmi cable before you power the board. You can then configure the system to suit your individual needs, such as connecting it to your wifi network or ethernet and installing more packages. Please see the [[CI20_Debian7|CI20 Debian7]] page for more details.
  
 
When you plug the power cord in the LED should turn red immediately, then blink once, and then return to red. If the LED is not lit then the board is not powered. If the led is blue then the board is powered, but something has most likely gone wrong (for the stock Debian 7 in NAND anyhow).
 
When you plug the power cord in the LED should turn red immediately, then blink once, and then return to red. If the LED is not lit then the board is not powered. If the led is blue then the board is powered, but something has most likely gone wrong (for the stock Debian 7 in NAND anyhow).
 +
 +
See the [[CI20 Troubleshooting|Troubleshooting]] page if you have problems getting your CI20 set up.
  
 
== What does it boot by default? ==
 
== What does it boot by default? ==
Line 13: Line 15:
  
 
== How do I use the default Debian? ==
 
== How do I use the default Debian? ==
You either need a USB keyboard, mouse and HDMI monitor plugged in (see [[CI20 USB Usage|here]]) or a serial port in order to either interact directly with the Debian installed, or to configure either/or the wifi or ethernet networking so you can communicate with the CI20 over your network.
+
You either need a USB keyboard, mouse and HDMI monitor plugged in (see [[CI20 USB Usage|here]]) or a serial port (see [[CI20 Headless Setup]]) in order to either interact directly with the Debian installed, or to configure either/or the wifi or ethernet networking so you can communicate with the CI20 over your network.
  
 
== What is the default Debian7 login? ==
 
== What is the default Debian7 login? ==
 
The default login is username:ci20 password:ci20
 
The default login is username:ci20 password:ci20
 +
The default root password is also: ci20
 +
 +
== How do I install more apps? ==
 +
The normal Debian install methods work. e.g "sudo apt-get install xyz". If you prefer a GUI based system, you can install the synaptic package manager using "sudo apt-get install synaptic".
 +
 +
== Where can I get help? Is there a forum or mailing list? ==
 +
 +
If you have problems getting your [[CI20]] set up, please take a look at the [[CI20 Troubleshooting|troubleshooting]] page first to see if it resolves your problem.
  
== Is there a forum? ==
+
Also feel free to use the [[CI20 Dev Zone#Mailing lists and Forum|CI20 google groups/forums/mailing lists]] and [[CI20 Dev Zone#IRC|IRC channel]] where [[CI20]] developers and users hang out.
Yes, there is a CI20 google group/forum/mailing list where the developers and users hang out [https://groups.google.com/forum/#!forum/mips-creator-ci20 here]
 
  
 
== What are all the connectors? ==
 
== What are all the connectors? ==
There are numerous connectors on the board - please visit the [[CI20_Tech_Stuff|Tech Stuff]] page for more details.
+
There are numerous connectors on the board which are described on the [[CI20 Hardware#Connectors|Hardware page]] (hint: click the hotspots on the labelled photographs [[CI20 Hardware#Tech Spec overview|here]] to find out about each one).
  
 
== What power supply does it take? ==
 
== What power supply does it take? ==
The CI20 runs off a 5V center positive power supply. The plug size is 4mm diameter with a pin size of 1.7mm. The recommended minimum supply current is 2Amps. Your board should have come with an international power supply in the box.
+
The CI20 ships with a USB power cable.
 +
 
 +
The plug size is 4mm diameter with a pin size of 1.7mm.
 +
 
 +
This is the same as the Sony PSP.
 +
 
 +
The board can draw up to 800mA under full hdmi/gpu/cpu/ethernet load.
 +
 
 +
The minimum recommended power supply is 'real' 1 Amps.
 +
 
 +
If you want to buy a cheaper USB power supply, 2 Amps is recommended in order to remain safe.
 +
 
 +
If you are connecting several power hungry USB peripherals, a powered USB hub is recommended.
 +
 
 +
== Can I power the board from the USB? ==
 +
 
 +
It isn't possible to power the CI20 through its USB connectors, although it is possible to power the board using the supplied USB cable plugged into a computer. However, some computers will switch off a USB port if its power draw exceeds 500mA.
 +
 
 +
The USB standard dictates that only 150mA can be used by a peripheral until it identifies itself. This can't be handled by the CI20 as only the power pins inside of its mini USB port are used.
 +
 
 +
The CI20 typically draws 200-400mA without wired Ethernet in use, which is more than the 150mA that the USB specification allows before enumeration, but well within the maximum 500mA that a USB socket can supply.
 +
 
 +
Whilst it is possible to power the CI20 using a USB cable plugged into a computer's port, it depends on the workload.
  
== Can I power off the USB? ==
+
If you have any problems when using USB power, a good 2A mains PSU will definitely help, either with a PSP plug or a USB A socket to use with a USB power lead.
No, the CI20 does not support being powered via the USB connectors. It is feasible to power it from the expansion connector - check the schematic for more details (and if you cannot read the schematic you may wish to consider not attempting this...)
 
  
 
== What if I want to boot my own code? ==
 
== What if I want to boot my own code? ==
The easiest way to try out your own code is to develop it either for an SDcard image, or to use network booting from the [[CI20 u-boot|u-boot]] prompt.
+
The easiest way to try out your own code is to develop it either for an SDcard image, or to use [[CI20_Dev_Zone#Loading_the_Linux_Kernel_over_ethernet_via_tftp|network booting from the u-boot prompt]].
  
 
== Can I code on it? ==
 
== Can I code on it? ==
 
The default Debian install comes with a full GCC installation, and native on-board compilation is fully supported. the 1Gbyte of DDR RAM will cater for all but the largest application builds, and an SDcard, USB stick or network share can be used for extra storage space.
 
The default Debian install comes with a full GCC installation, and native on-board compilation is fully supported. the 1Gbyte of DDR RAM will cater for all but the largest application builds, and an SDcard, USB stick or network share can be used for extra storage space.
 +
 +
If you wish to cross-compile code on your desktop, you'll need a [[CI20_Dev_Zone#Toolchain|toolchain]]
  
 
== Where can I get Android from? ==
 
== Where can I get Android from? ==
The Android KitKat 4.4 image is in progress, and will be released soon. Once it is ready you will be able to find it via the [[CI20 Downloads|Downloads]] page.
+
The Android image, directions for installing it, and details about supported features are [[CI20 Distros#Android|here]].
  
 
== I think I 'bricked' my CI20 - do I need to return it? ==
 
== I think I 'bricked' my CI20 - do I need to return it? ==
Line 44: Line 76:
  
 
== So, how do I connect other things to it, like a robot or my light switch? ==
 
== So, how do I connect other things to it, like a robot or my light switch? ==
The CI20 has a lot of connectivity, including all the common SPI, I2C and GPIO interfaces. Please see the pinouts on the [[CI20_Tech_Stuff|Tech Stuff]] page for more details.
+
The CI20 has a lot of connectivity, including all the common SPI, I2C and GPIO interfaces. Please see the pinout tables on the [[CI20 Hardware#Tech_Spec_overview|Hardware Page]] for more details.
  
 
{{CI20}}
 
{{CI20}}
 +
[[Category:CI20|Beginners Guide]]

Latest revision as of 04:46, 30 June 2015

The CI20 is 'ready to go out of the box'. The on-board NAND flash comes pre-programmed with a Debian7 installation. Booting the CI20 will take you into Debian. If you then have the correct connections (keyboard, mouse, screen, network or serial port) then you are good to go.

The below questions aim to get you going with the CI20 from the outset. If you encounter problems, please read the Troubleshooting page. If you need more technical details then please consult the system manuals from this web site or the developer zone pages, or leap onto the mailing list.

Shall I just plug it in?

Yes! Out of the box the CI20 is 'ready to go'. By default it will boot the image in the on-board NAND. From the factory this image is Debian7. To really use the board it will need at minimum an HDMI screen, a USB keyboard and preferably a mouse. Remember to plug in the hdmi cable before you power the board. You can then configure the system to suit your individual needs, such as connecting it to your wifi network or ethernet and installing more packages. Please see the CI20 Debian7 page for more details.

When you plug the power cord in the LED should turn red immediately, then blink once, and then return to red. If the LED is not lit then the board is not powered. If the led is blue then the board is powered, but something has most likely gone wrong (for the stock Debian 7 in NAND anyhow).

See the Troubleshooting page if you have problems getting your CI20 set up.

What does it boot by default?

Out of the box it boots the Debian7 image in the onboard NAND flash. You can replace that NAND flash image with other Distributions, or place a Distribution onto an SDcard and boot from there instead.

How do I use the default Debian?

You either need a USB keyboard, mouse and HDMI monitor plugged in (see here) or a serial port (see CI20 Headless Setup) in order to either interact directly with the Debian installed, or to configure either/or the wifi or ethernet networking so you can communicate with the CI20 over your network.

What is the default Debian7 login?

The default login is username:ci20 password:ci20 The default root password is also: ci20

How do I install more apps?

The normal Debian install methods work. e.g "sudo apt-get install xyz". If you prefer a GUI based system, you can install the synaptic package manager using "sudo apt-get install synaptic".

Where can I get help? Is there a forum or mailing list?

If you have problems getting your CI20 set up, please take a look at the troubleshooting page first to see if it resolves your problem.

Also feel free to use the CI20 google groups/forums/mailing lists and IRC channel where CI20 developers and users hang out.

What are all the connectors?

There are numerous connectors on the board which are described on the Hardware page (hint: click the hotspots on the labelled photographs here to find out about each one).

What power supply does it take?

The CI20 ships with a USB power cable.

The plug size is 4mm diameter with a pin size of 1.7mm.

This is the same as the Sony PSP.

The board can draw up to 800mA under full hdmi/gpu/cpu/ethernet load.

The minimum recommended power supply is 'real' 1 Amps.

If you want to buy a cheaper USB power supply, 2 Amps is recommended in order to remain safe.

If you are connecting several power hungry USB peripherals, a powered USB hub is recommended.

Can I power the board from the USB?

It isn't possible to power the CI20 through its USB connectors, although it is possible to power the board using the supplied USB cable plugged into a computer. However, some computers will switch off a USB port if its power draw exceeds 500mA.

The USB standard dictates that only 150mA can be used by a peripheral until it identifies itself. This can't be handled by the CI20 as only the power pins inside of its mini USB port are used.

The CI20 typically draws 200-400mA without wired Ethernet in use, which is more than the 150mA that the USB specification allows before enumeration, but well within the maximum 500mA that a USB socket can supply.

Whilst it is possible to power the CI20 using a USB cable plugged into a computer's port, it depends on the workload.

If you have any problems when using USB power, a good 2A mains PSU will definitely help, either with a PSP plug or a USB A socket to use with a USB power lead.

What if I want to boot my own code?

The easiest way to try out your own code is to develop it either for an SDcard image, or to use network booting from the u-boot prompt.

Can I code on it?

The default Debian install comes with a full GCC installation, and native on-board compilation is fully supported. the 1Gbyte of DDR RAM will cater for all but the largest application builds, and an SDcard, USB stick or network share can be used for extra storage space.

If you wish to cross-compile code on your desktop, you'll need a toolchain

Where can I get Android from?

The Android image, directions for installing it, and details about supported features are here.

I think I 'bricked' my CI20 - do I need to return it?

No, you should not have to return the CI20 if you suspect you have only corrupted the software. The CI20 can always be un-bricked by booting from the SDcard, and in particular by booting the image that re-burns the factory default Debian7 to the NAND flash. That image, along with instructions, is available from the downloads page. You should try this procedure first, and if it fails, provide the logs from the burning and boot process along with your 'RMA request'.

So, how do I connect other things to it, like a robot or my light switch?

The CI20 has a lot of connectivity, including all the common SPI, I2C and GPIO interfaces. Please see the pinout tables on the Hardware Page for more details.