User:Kevgor: Difference between revisions

From OLPC
Jump to navigation Jump to search
No edit summary
 
(51 intermediate revisions by 4 users not shown)
Line 1: Line 1:
A collection of User Notes from Kevin Gordon of the Ntugi Group <ref>[http://www.ntugigroup.org Ntugi Group Website]</ref>


August 2012


A collection of Miscellaneous User Notes from Kevin Gordon of the Ntugi Group


[[www.ntugigroup.org]]




== Miscellaneous Technical Notes ==


Thanks to Daniel Drake, Mikus Grinbergs, Martin Langhoff, Peter Robinson, James Cameron, Richard Smith, Yioryos Asprobounitis, John Gilmore, Nathan C. Riddle, Gonzalo Odiard, Jon Wattlington, Jerry Vonau , and Sridhar Dhanapalan for all of their help on these things :-)




=Notes=


June 2012
<br />
<br />
== Ntugi Group Reflash Documents ==
* [[User:Kevgor/Current Reflash to Custom Install Image using Ntugigroup USB stick]]
* [[User:Kevgor/Reflash to Standard Install Image using Ntugigroup USB stick]]
* [[User:Kevgor/Reflash to Standard Install Image using Ntugigroup USB stick]]
* [[User:Kevgor/Reflash to Custom Install Image using Ntugigroup USB stick]]
* [[User:Kevgor/Install Script for Labquest]]* [[User:Kevgor/Install Script for mplayer]]
* [[User:Kevgor/Mavrothal scripts for XO 1.0]]
* [[User:Kevgor/Utilities rpms installed from USB for Testing phase]]
<br />


== Install Developer Key ==
su -
wget -P /security https://activation.laptop.org/devkey/xxxxxxxxx/develop.sig
<br />
== Attach an XO to a Projector/External Monitor ==
The only tested products are:
Startech USB2VGA2 adapter or Startech USB2VGA adapter


<br />
Ensure External device has a VGA input, and can display at 1024x768 60Hz<br />
Plug in and power '''on''' the External device<br />
Attach a VGA cable between the Startech device and the VGA port of the External device<br />
Ensure the input selection on the External device is set to VGA. If possible, preset the resolution to 1024x768. Some monitors and projectors will not be able to sync properly to the USB2VGA. There is no known fix for this.<br />
Ensure that the XO is powered '''off'''<br />
Plug the USB end of Startech adapter into any USB port on the XO. If you do this more than once, you should always use the same USB port, as it will save time in configuration<br />
Power '''on''' the XO<br />
It is normal behaviour for the boot process to still start up on the internal screen.<br />
Once the XO recognizes the external adapter, a blue light will illuminate on the adapter.<br />
The XO will attempt to handshake with the adapter<br />
This process may cause horizontal bars to appear until such time as 1024x768 resolution is set<br />
Once the External monitor has control of the display, the internal screen will go into text mode. I.E. - no mirroring.<br />
Using an external display will cause slower graphics throughput. Therefore, you avoid using the external display while cameras are active, for streaming video, or visiting graphics rich web sites. As they say these days, your mileage may vary.<br />
Control will not return to the internal display until after a shutdown.<br />
To boot without an external display, remove the USB end of the Startech cable before powering back on.<br />
<br />
Special Note for the Aaxa m2 Projector for Point 4 above:<br />
Power the projector on.<br />
Repeatedly hit the rightmost key on the top wheel until the "VGA" appears
in the top-right corner of the blank blue projected image, to ensure that the External Device is set to VGA<br />


<br />


== Cheat keys ==
=Testing Notes for USB and add-ons for Current Signed +1 Developer Builds=
Boot-up
<br />
signed install - right game pad - all 4 game keys, on right-hand of display


text boot - right game pad - check-mark key, on right-hand side of display


boot to OFW - esc (X), keyboard key


diagnostics - left game pad - rocker left, on left of display
* [[User:Kevgor/Testing Notes XO-1.50 Build 11-2 os5]]


<br />
=Older Notes=

== Set Clock using serial adapter ==

At the ''ok'' prompt, type these commands to set the date (hitting enter after each one):
ok select /rtc<br />
ok decimal<br />
ok sec min hour day month year set-time<br />

sec, min, hour, day, etc in the previous command should be numbers correlating to the current date. For the current time:
ok {{CURRENTSECOND}} {{CURRENTMINUTE}} {{CURRENTHOUR}} {{CURRENTDAY}} {{CURRENTMONTH}} {{CURRENTYEAR}} set-time

<br />
== Set Clock using Linux==
Once Linux has booted, a) login at a root terminal (e.g. press Ctrl+Alt+F2). Or b) as superuser in Linux terminal:

Set the system time using the <tt>date</tt> command, e.g. for the current date/time:

date --utc --set="{{CURRENTYEAR}}-{{CURRENTMONTH}}-{{CURRENTDAY}} {{CURRENTHOUR}}:{{CURRENTMINUTE}}:{{CURRENTSECOND}}"
cd /etc
ln -sf /usr/share/zoneinfo/EST localtime
/sbin/hwclock --systohc

Then [[Shutdown|shutdown]] normally and the system time will be stored in the clock. If you are attempting a shutdown from terminal, enter
poweroff
because if you instead enter
shutdown
it takes you into a single user text mode.

(Do not force a shutdown by holding down the power button, or do a soft reboot because the change will not be stored.)
<br />
<br />

== Unsigned Build reflash commands from OFW ok prompt==
XO1 - jffs2 from os-builder
copy-nand u:\xxxxxxx.img
XO1 - ubifs
update-nand u:\xxxxxxx.onu
XO1.5 and 1.75
fs-update u:\xxxxxxxx.zd
OFW
flash u:\qxxxx.rom
<br />

== Start cups service ==
/sbin/service cups start
<br />
== Copy Kernel Files after kernel rpm install ==
cp -a /boot/* /bootpart/boot/
<br />
== Check USB files ==
To check speed <br />
ok null-fsdisk fs-update u:\fs.zd
<br />
To check sum specifically on the TBSF build<br />
md5sum os26-4g.zd

You should have this string:<br />
'''d0db56b3978eb4091efe805b0d4bc18e'''
<br />

== FTP server ==


Link to brooksc OLPC News page on ftp on the XO <ref>[http://www.olpcnews.com/forum/index.php?topic=997.0 Brooksc FTP notes]</ref>.

pure-ftpd is now included in the standard repository packages, so one can just do a plain
yum install --nogpgcheck pure-ftpd

To manually start the service, non-persistent:
/sbin/service pure-ftpd start
<br />
== USB ethernet auto-assign workaround ==
avahi-autoipd eth1
<br />
== Battery/DC Notes ==

Battery Recovery Procedure on Wiki <ref>[http://wiki.laptop.org/go/XO_LiFePO4_Recovery_Procedure Battery Recovery Procedure]</ref><br />
Troubleshooting Battery on Wiki <ref>[http://wiki.laptop.org/go/XO_Troubleshooting_Battery Troubleshooting Battery]</ref><br />
Power Mangement on Wiki <ref>[http://wiki.laptop.org/go/Power_management Power Management]</ref><br />

Please read the reference wiki pages for correct usage before executing any items from this following list of commands!! This list is *not* meant to be run as a script. It is merely a laundry list of commands to refresh my memory as to the correct spelling of those that are available. Also, since some commands from the batman.fth forth script are contained in the more recent firmware versions, one may get a 'not-unique' message when loading the script. It would appear these messages can be safely ignored.<br />
At open firmware:
ec-abnormal@ .
see-bstate
watch-battery
fload u:\batman.fth
batman-start
bat-recover
bat-set-life-byd
bat-set-low
batman-stop
<br />

From Richard Smith on yellow wont go green
<br />
Next time you are using the machine stop powerd and run olpc-pwr-log
in a terminal (you can use it normally) and let it run down until it
powers off. Then remove the battery, power back up, run olpc-pwr-log
again and then re-insert the battery. Let it charge until you see the
got to 100 and the 3rd and 4th column of numbers reach some sort of
steady state where they don't change much. Ctrl-C and then send me
the file.

FYI. Col 3 is voltage in uV and col 4 is amperage in uA.

Also send me all the files you have in ~olpc/power-logs
<br />


Barrel specs:<br />
* ''1.67mm'' Center pin diameter
* ''5.5mm'' Outer barrel diameter
* ''11mm'' contact length
<br />

== Trackpad/Keyboard commands==
What kind of trackpad do I have?
dmesg | grep psmouse<br />

Output from above command:<br />
XO 1.5 newer CL1A = serio1: ID: 10 02 64<br />
XO 1.5 older CL1A = synaptics<br />
XO 1.0 = 50<br />
<br />
Tap-to-click Persistent for older CL1/CL1A - edit the following file; to turn on set the param =1 or off =0
/etc/modprobe.d/olpc-psmouse.conf
<br />
Tap-to-click Non-Persistent for newer CL1A - to turn ON
echo -n C > /sys/bus/serio/drivers/psmouse/serio*/flags

Tap-to-click Non-Persistent for newer CL1A - to turn OFF
echo -n c > /sys/bus/serio/drivers/psmouse/serio*/flags
<br />
'''Place above commands in rc.local to make persistent'''
<br />
<br />

== Adopt authority/permissions hint ==
add the NOPASSWD option in /etc/sudoers just for the scripts/commands you need

== Sample yum syntax ==
For download only of yum updates to an External USB Volume PATRIOT with subdirectory called UpdateRpms
yum update --downloadonly --nogpgcheck --downloaddir=/media/PATRIOT/UpdateRpms
For installing rpms from a USB volume PATRIOT with subdirectory called UpdateRpms and no internet access
yum localinstall --nogpgcheck --disablerepo=* /media/PATRIOT/UpdateRpms/*.rpm

== Install bad and ugly gstreamer files to USB ==
For download only of rpm's to an External USB Volume PATRIOT with subdirectory called Guvcview. This
will alter the repos used for subsequent Updates, so delete rpmfusion repos later if you wish
yum install --nogpgcheck \
http://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-stable.noarch.rpm \
http://download1.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-stable.noarch.rpm
sleep 2
yum install --downloadonly --nogpgcheck --downloaddir=/media/PATRIOT/Guvcview \
gstreamer-plugins-bad gstreamer-plugins-ugly gstreamer-ffmpeg


== Enable and Start Bluetooth service ==

To enable:

systemctl enable bluetooth.service
ln -s ‘/lib/systemd/system/bluetooth.service’ ‘/etc/systemd/system/dbus-org.bluez.service’
ln -s ‘/lib/systemd/system/bluetooth.service’ ‘/etc/systemd/system/bluetooth.target.wants/bluetooth.service'

To start:

systemctl start bluetooth.service

== Frequent Links for XO resources ==
XO diagnostics <ref>[http://wiki.laptop.org/go/XO_Self_Test XO diagnostics]</ref>
Developer Builds <ref>[http://build.laptop.org Developer builds]</ref>

Quozl Forth lessons <ref>[http://wiki.laptop.org/go/Forth_Lesson_23 Forth Lesson 23]</ref>

TBSF Build <ref>[http://dev.laptop.org/~martin/TBSF/os26-4g.zd TBSF builds]</ref>

Koji for arm rpms <ref>[http://arm.koji.fedoraproject.org/koji/ Arm rpms from Koji]</ref>

Stable builds <ref>[http://download.laptop.org Stable builds]</ref>

Enable Cups <ref>[http://wiki.laptop.org/go/Enabling_CUPS Enable CUPS]</ref>

OS Builder Wiki <ref>[http://wiki.laptop.org/go/OS_Builder OLPC-OS-Builder]</ref>
Printing OLPC Notes<ref>[http://wiki.laptop.org/go/Printing Printing OLPC Notes]</ref>

Printing Tony Pearson IBM Notes<ref>[https://www.ibm.com/developerworks/mydeveloperworks/blogs/InsideSystemStorage/entry/printing_on_xo_laptop_with?lang=en Printing Tony Pearson IBM Notes]</ref>

OLPC News mavrothal page <ref>[http://www.olpcnews.com/forum/index.php?topic=4965.msg33437;topicseen#msg33437 Mav ref page]</ref>

Disassembly Instructions <ref>[http://wiki.laptop.org/go/Disassembly Disassembly Instructions]</ref>

Manufacturer Data Legend <ref>[http://wiki.laptop.org/go/Manufacturing_data Manufacturing Data legend]</ref>

Notes on first steps on XO 1.75 B1 <ref>[http://wiki.laptop.org/go/XO_1.75_B1 XO 1.75 B1 arrival] </ref>

== External links ==
* [http://www.ntugigroup.com/ Ntugi Group Official Site]
* [http://www.ntugischool.com/ Ntugi Day Secondary School Site]
* [http://www.lewa.org/ Lewa Wildlife Conservancy Site]


== References ==
{{Reflist}}

== Testing Notes for USB and add-ons for Current Signed +1 Developer Builds ==


* [[User:Kevgor/Testing Notes XO-1.50 Build 11.3.0 os883 (Release)]]



== Older Testing Notes ==

'''Completed''' Testing Notes for USB and add-ons for Previous Developer Builds

* [[User:Kevgor/Testing Notes XO-1.50 Build 11-3 os5]]

Latest revision as of 15:57, 29 August 2012

A collection of User Notes from Kevin Gordon of the Ntugi Group <ref>Ntugi Group Website</ref>

August 2012



Miscellaneous Technical Notes

Thanks to Daniel Drake, Mikus Grinbergs, Martin Langhoff, Peter Robinson, James Cameron, Richard Smith, Yioryos Asprobounitis, John Gilmore, Nathan C. Riddle, Gonzalo Odiard, Jon Wattlington, Jerry Vonau , and Sridhar Dhanapalan for all of their help on these things :-)


June 2012

Ntugi Group Reflash Documents


Install Developer Key

su -
wget -P /security https://activation.laptop.org/devkey/xxxxxxxxx/develop.sig


Attach an XO to a Projector/External Monitor

The only tested products are: Startech USB2VGA2 adapter or Startech USB2VGA adapter


Ensure External device has a VGA input, and can display at 1024x768 60Hz
Plug in and power on the External device
Attach a VGA cable between the Startech device and the VGA port of the External device
Ensure the input selection on the External device is set to VGA. If possible, preset the resolution to 1024x768. Some monitors and projectors will not be able to sync properly to the USB2VGA. There is no known fix for this.
Ensure that the XO is powered off
Plug the USB end of Startech adapter into any USB port on the XO. If you do this more than once, you should always use the same USB port, as it will save time in configuration
Power on the XO
It is normal behaviour for the boot process to still start up on the internal screen.
Once the XO recognizes the external adapter, a blue light will illuminate on the adapter.
The XO will attempt to handshake with the adapter
This process may cause horizontal bars to appear until such time as 1024x768 resolution is set
Once the External monitor has control of the display, the internal screen will go into text mode. I.E. - no mirroring.
Using an external display will cause slower graphics throughput. Therefore, you avoid using the external display while cameras are active, for streaming video, or visiting graphics rich web sites. As they say these days, your mileage may vary.
Control will not return to the internal display until after a shutdown.
To boot without an external display, remove the USB end of the Startech cable before powering back on.

Special Note for the Aaxa m2 Projector for Point 4 above:
Power the projector on.
Repeatedly hit the rightmost key on the top wheel until the "VGA" appears in the top-right corner of the blank blue projected image, to ensure that the External Device is set to VGA


Cheat keys

Boot-up
signed install - right game pad - all 4 game keys, on right-hand of display

text boot - right game pad - check-mark key, on right-hand side of display

boot to OFW - esc (X), keyboard key

diagnostics - left game pad - rocker left, on left of display


Set Clock using serial adapter

At the ok prompt, type these commands to set the date (hitting enter after each one):

ok select /rtc
ok decimal
ok sec min hour day month year set-time

sec, min, hour, day, etc in the previous command should be numbers correlating to the current date. For the current time:

ok 53 56 17 23 12 2024 set-time


Set Clock using Linux

Once Linux has booted, a) login at a root terminal (e.g. press Ctrl+Alt+F2). Or b) as superuser in Linux terminal:

Set the system time using the date command, e.g. for the current date/time:

date --utc --set="2024-12-23 17:56:53"
cd /etc
ln -sf /usr/share/zoneinfo/EST localtime
/sbin/hwclock --systohc

Then shutdown normally and the system time will be stored in the clock. If you are attempting a shutdown from terminal, enter

poweroff

because if you instead enter

shutdown

it takes you into a single user text mode.

(Do not force a shutdown by holding down the power button, or do a soft reboot because the change will not be stored.)

Unsigned Build reflash commands from OFW ok prompt

XO1 - jffs2 from os-builder

copy-nand u:\xxxxxxx.img

XO1 - ubifs

update-nand u:\xxxxxxx.onu

XO1.5 and 1.75

fs-update u:\xxxxxxxx.zd

OFW

flash u:\qxxxx.rom


Start cups service

/sbin/service cups start


Copy Kernel Files after kernel rpm install

cp -a /boot/* /bootpart/boot/


Check USB files

To check speed

ok null-fsdisk fs-update u:\fs.zd


To check sum specifically on the TBSF build

md5sum os26-4g.zd

You should have this string:
d0db56b3978eb4091efe805b0d4bc18e

FTP server

Link to brooksc OLPC News page on ftp on the XO <ref>Brooksc FTP notes</ref>.

pure-ftpd is now included in the standard repository packages, so one can just do a plain

yum install --nogpgcheck pure-ftpd

To manually start the service, non-persistent:

/sbin/service pure-ftpd start


USB ethernet auto-assign workaround

avahi-autoipd eth1


Battery/DC Notes

Battery Recovery Procedure on Wiki <ref>Battery Recovery Procedure</ref>
Troubleshooting Battery on Wiki <ref>Troubleshooting Battery</ref>
Power Mangement on Wiki <ref>Power Management</ref>

Please read the reference wiki pages for correct usage before executing any items from this following list of commands!! This list is *not* meant to be run as a script. It is merely a laundry list of commands to refresh my memory as to the correct spelling of those that are available. Also, since some commands from the batman.fth forth script are contained in the more recent firmware versions, one may get a 'not-unique' message when loading the script. It would appear these messages can be safely ignored.
At open firmware:

ec-abnormal@ .
see-bstate
watch-battery
fload u:\batman.fth
batman-start
bat-recover
bat-set-life-byd
bat-set-low
batman-stop


From Richard Smith on yellow wont go green
Next time you are using the machine stop powerd and run olpc-pwr-log in a terminal (you can use it normally) and let it run down until it powers off. Then remove the battery, power back up, run olpc-pwr-log again and then re-insert the battery. Let it charge until you see the got to 100 and the 3rd and 4th column of numbers reach some sort of steady state where they don't change much. Ctrl-C and then send me the file.

FYI. Col 3 is voltage in uV and col 4 is amperage in uA.

Also send me all the files you have in ~olpc/power-logs


Barrel specs:

  • 1.67mm Center pin diameter
  • 5.5mm Outer barrel diameter
  • 11mm contact length


Trackpad/Keyboard commands

What kind of trackpad do I have?

dmesg | grep psmouse

Output from above command:
XO 1.5 newer CL1A = serio1: ID: 10 02 64
XO 1.5 older CL1A = synaptics
XO 1.0 = 50

Tap-to-click Persistent for older CL1/CL1A - edit the following file; to turn on set the param =1 or off =0

/etc/modprobe.d/olpc-psmouse.conf


Tap-to-click Non-Persistent for newer CL1A - to turn ON

echo -n C > /sys/bus/serio/drivers/psmouse/serio*/flags

Tap-to-click Non-Persistent for newer CL1A - to turn OFF

echo -n c > /sys/bus/serio/drivers/psmouse/serio*/flags


Place above commands in rc.local to make persistent

Adopt authority/permissions hint

add the NOPASSWD option in /etc/sudoers just for the scripts/commands you need

Sample yum syntax

For download only of yum updates to an External USB Volume PATRIOT with subdirectory called UpdateRpms

yum update --downloadonly --nogpgcheck --downloaddir=/media/PATRIOT/UpdateRpms

For installing rpms from a USB volume PATRIOT with subdirectory called UpdateRpms and no internet access

yum localinstall --nogpgcheck --disablerepo=* /media/PATRIOT/UpdateRpms/*.rpm

Install bad and ugly gstreamer files to USB

For download only of rpm's to an External USB Volume PATRIOT with subdirectory called Guvcview. This will alter the repos used for subsequent Updates, so delete rpmfusion repos later if you wish

yum install --nogpgcheck \
http://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-stable.noarch.rpm \
http://download1.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-stable.noarch.rpm
sleep 2
yum install --downloadonly --nogpgcheck --downloaddir=/media/PATRIOT/Guvcview \
gstreamer-plugins-bad gstreamer-plugins-ugly gstreamer-ffmpeg


Enable and Start Bluetooth service

To enable:

systemctl enable bluetooth.service

ln -s ‘/lib/systemd/system/bluetooth.service’ ‘/etc/systemd/system/dbus-org.bluez.service’
ln -s ‘/lib/systemd/system/bluetooth.service’ ‘/etc/systemd/system/bluetooth.target.wants/bluetooth.service'

To start:

systemctl start bluetooth.service

Frequent Links for XO resources

XO diagnostics <ref>XO diagnostics</ref>

Developer Builds <ref>Developer builds</ref>

Quozl Forth lessons <ref>Forth Lesson 23</ref>

TBSF Build <ref>TBSF builds</ref>

Koji for arm rpms <ref>Arm rpms from Koji</ref>

Stable builds <ref>Stable builds</ref>

Enable Cups <ref>Enable CUPS</ref>

OS Builder Wiki <ref>OLPC-OS-Builder</ref>

Printing OLPC Notes<ref>Printing OLPC Notes</ref>

Printing Tony Pearson IBM Notes<ref>Printing Tony Pearson IBM Notes</ref>

OLPC News mavrothal page <ref>Mav ref page</ref>

Disassembly Instructions <ref>Disassembly Instructions</ref>

Manufacturer Data Legend <ref>Manufacturing Data legend</ref>

Notes on first steps on XO 1.75 B1 <ref>XO 1.75 B1 arrival </ref>

External links


References

<references group=""></references>

Testing Notes for USB and add-ons for Current Signed +1 Developer Builds


Older Testing Notes

Completed Testing Notes for USB and add-ons for Previous Developer Builds