Rock64 usb2.0 Power Control Floating GPIO Tutorial Files & Notes
#1
Brick 
Greetings,

   The purpose of this post is to document the rock64_usb_power_service.sh script , provide instructions and notes for its correct use (tutorial) , and document the installation of the script as a systemd automated service.  

   The problem that we are solving is that the usb2.0 power regulators are controlled by a hardware line (EN) (gpio2) which is in a floating state when the Rock64 boots.   This often results in the usb2.0 ports losing power ( at least momentarily ).  

   The solution to this problem is to create an executable script , as well an automated service (systemd) , that will export the gpio2 line to user space ( setting it low & turning ON the power regulators ) while also allowing the system admin (user) to control the gpio2 for power cycling devices plugged into the usb2.0 port.  This approach to fixing this problem is a win-win in that the usb2.0 power remains on permanently after  boot-up for those who want it, and it also allows advanced users the flexibility of being able to power cycle their usb2.0 ports as designed by the Rock64 engineers ( very handy in many use cases ).

   The user has complete freedom and control because the script may be run manually (as root) or it may be installed as an automated systemd service.  The following tutorial will provide the codes first , then I will discuss how to use them , and finally how to install the usb_gpio_on.service  in systemd.  After each code section I will give instructions for 1) where to place the script, 2) what permissions to give it, 3) what ownership to give it, and finally how to run it.

The Scripts


   Before beginning switch into root operating mode ( and permissions ) with  sudo -i  (important).

rock64_usb_power_service.sh

Code:
#!/bin/bash
# rock64_usb_power_service.sh
#
# Mark H. Harris
# v0.1b
#
#
PWRON=0
PWROFF=1
GP=2
GPOUT="out"
GPPATH="/sys/class/gpio"
GPVALUE="value"
GPMODE="direction"

## remove gpio if already exported
if [ -d $GPPATH/gpio$GP ]
then
   echo $GP > $GPPATH/unexport
   sleep 2
fi

# export the gpio, and set if ready
echo $GP > $GPPATH/export
sleep 2
if [ -e $GPPATH/gpio$GP/$GPMODE ]
then
   echo $GPOUT > $GPPATH/gpio$GP/$GPMODE
   sleep 2
   echo $PWRON > $GPPATH/gpio$GP/$GPVALUE
fi

   The  rock64_usb_power_service.sh  is the executable script.  Place this script in  /usr/local/sbin/

   Check the spelling very carefully;  or things will not work when it comes time to automate the service.

   set the ownership, group, and permissions:
   
   cd  /usr/local/sbin/
   chown  root  rock64_usb_power_service.sh
   chgrp  root  rock64_usb_power_service.sh
   chmod  0754  rock64_usb_power_service.sh

   To run the script manually :

   sudo  -i
   /usr/local/sbin/rock64_usb_power_service.sh

   To power cycle the usb2.0 port's 5v :

   sudo -i
   echo 1  >  /sys/class/gpio/gpio2/value
   echo 0  >  /sys/class/gpio/gpio2/value

   The above script exports the (EN)  gpio2 mux line to user space using the sysfs method,  sets the direction "out", and sets the value 0 ( pulling the line low turns ON the usb2.0 power regulators ).


usb_gpio_on.service

Code:
[Unit]
Description=set the gpio2 EN line low for usb2.0 power regulator ON

[Service]
ExecStart=/usr/local/sbin/rock64_usb_power_service.sh
Type=oneshot

[Install]
WantedBy=default.target

   The above  usb_gpio_on.service  script is called a systemd  "service unit file".  This file describes the service to systemd so that systemd knows how to find the executable, and further knows that the service executable only needs to be run once.  Again, it is very critical that all the spelling is precise;  miss spellings will result is chaos;  and of course no fix.

   Place this file  usb_gpio_on.service  in directory  /etc/systemd/system/

   Set the ownership, group, and permissions for this file :

   cd  /etc/systemd/system/
   chown  root  usb_gpio_on.service
   chgrp  root  usb_gpio_on.service
   chmod  0664  usb_gpio_on.service

   Inform systemd that a change has been made to the unit files on disk       (very critical)

   systemctl  daemon-reload
   systemctl  enable  usb_gpio_on.service

   Congratulations!   At this point the service has successfully run;  the gpio2 has been exported, and the gpio2 pin has been pulled low turning on the usb2.0 power regulators.  

   We are now done;  all that is left to do is to reboot your Rock64 ! 

   You can check that this worked after reboot by looking in  /sys/class/gpio/  for an export directory  called  gpio2!   

   At this point you may go about life on your Rock64 normally -- the usb2.0 power should not drop because the EN line is no longer floating;  however,  if you like you still have the option to power cycle the usb2.0 ports using the method I detailed above.


Caveat Emptor

If you want to try this tutorial follow two simple rules , or do so at your own risk.  Either wait for me to post on the forum that this has been tested multiple times and is 1) safe,  and 2) works;   or become a beta tester ( a guinea pig ).  That means that you contact me on irc and tell me you're testing and that you will be gracious to provide feedback ( including loss of time and|or hair )  so that I know who is using it so far, and whether I need to fix anything or make anything clearer.

Every effort has been made to ensure that this is accurate and free from defects;  but we all know the best laid plans of mice and of programmers.

We may at some future point fix this in the dts|dtb file and place in a future image;  the problem with that is that users who wish to have the advanced ability to power cycle the usb ports as designed would have to hack the dts first!  So we're going to try this and see how it goes.

This method and the script which have been provided have been tested according to this tutorial on my Rock64 production test board, and everything works on my board as described in this tutorial;  again, if I need to make anything more clear, or if something is broken ( I certainly hope not ) please let me know asap , preferably on irc.

Thanks much !    Rolleyes




marcushh777    Cool

please join us for a chat @  irc.pine64.xyz:6667   or ssl  irc.pine64.xyz:6697

( I regret that I am not able to respond to personal messages;  let's meet on irc! )
  Reply
#2
It worked fine for me here on xenial-mate-rock64-0.4.16-83-arm64.

Just make sure the #!/bin/bash line is the very first one in the rock64_usb_power_service.sh file. I tripped myself up on that... It is correct in the posting.
  Reply
#3
(08-24-2017, 02:56 AM)KnReLe Wrote: It worked fine for me here on xenial-mate-rock64-0.4.16-83-arm64.

Thank you KnReLe !    Shy


I too have tested now on both xenial-minimal, and xenial-mate.  Both worked, gpio2 is set and held low, and the usb2.0 can be power cycled.

Caveat:  depending on timing ( when the user logs on vs how long it takes for rc.local to run ) there may be a very brief second or two where the usb 5v power drops before the automation pulls the gpio2 low turning on the usb power regulators.  If this happens to you , please let me know , and let me know how frequent this occurs (PM me, or send a private message, or stop by the irc).  Typically this is going to occur if the user does the logon from the gui before  the boot process has completed;  in other words, this will likely not occur if the user waits until the boot-up is complete before logging on.  This is something that can be seen while monitoring the serial console, for instance.  So, if the user waits a few seconds to logon after boot to give the boot process time to complete fully (serial console is at a logon prompt) it is unlikely that this caveat will occur.

Please review the entire tutorial , and notice that we're enabling the service in systemd 'earlier' which eliminates the timing problem with the legacy rc.local;  so I removed the rc.local step.


Thanks
marcushh777    Cool

please join us for a chat @  irc.pine64.xyz:6667   or ssl  irc.pine64.xyz:6697

( I regret that I am not able to respond to personal messages;  let's meet on irc! )
  Reply
#4
I have updated the tutorial;  please review and make changes as necessary;

If you edited the rc.local file in /etc please remove the line from rc.local and issue this command as root:

cd  /etc/systemd/system/
sudo  systemctl  enable  usb_gpio_on.service


<sorry for inconvenience>

Blush
marcushh777    Cool

please join us for a chat @  irc.pine64.xyz:6667   or ssl  irc.pine64.xyz:6697

( I regret that I am not able to respond to personal messages;  let's meet on irc! )
  Reply
#5
(08-24-2017, 04:40 AM)MarkHaysHarris777 Wrote: I have updated the tutorial;  please review and make changes as necessary;

If you edited the rc.local file in /etc please remove the line from rc.local and issue this command as root:

cd  /etc/systemd/system/
sudo  systemctl  enable  usb_gpio_on.service


<sorry for inconvenience>

Blush

Thanks!  Smile
It worked fine for me on Stock Debian LXDE (Rock64 SDCard) Build 20170809. This is a production Rock64 with 4GB that I received recently. Checked successfully that the directory gpio2 exists in /sys/class/gpio/.

Has worked three times so far:
- After reboot finishing the fix.
- After Shutdown and full power down. Starting from applying power to the Rock64.
- After Shutdown and pressing the Power button on the board.
3 for 3 is the best I've seen so far. 

Followed directions carefully and had no problems. Linux is still not my comfort zone. I've lived mainly in Windows going all the way back to MS-DOS days.

Next problem is to fix is the changing MAC address after reboot. I have a gazillion entries in my router thanks to this problem.

moravecz
  Reply
#6
The upcoming 0.5.3 will have those problems fixed.
Homepage: https://ayufan.eu

Releases:
Rock/Pro 64/Pinebook Pro: LinuxChromium OS
So/Pine A64/Pinebook: LinuxAndroid 6.0Android 7.1

Buy me a Beer
  Reply


Possibly Related Threads...
Thread Author Replies Views Last Post
Lightbulb Mount a HeatSink on the Rock64 using 3M Thermal Tapes MarkHaysHarris777 22 10,548 11-29-2019, 03:14 AM
Last Post: ab1jx
  power connector type please AlexS 1 179 08-31-2019, 08:27 AM
Last Post: tllim
  My Rock64 died (with a happy ending!) rmbusy 1 266 08-15-2019, 06:48 PM
Last Post: tllim
Information Brushless Fan (5v) for Rock64 Clear Case Soft PWM Drive 2N2222 MarkHaysHarris777 7 4,748 07-09-2019, 06:15 AM
Last Post: merwone
  Rock64 stereo audio dac add-on board with RockPro64 Tim13 1 217 07-08-2019, 07:15 PM
Last Post: tllim
  Using a stronger power supply myn4m3 1 204 06-23-2019, 05:01 PM
Last Post: Rocklobster
  Rock64's temperature while being in aluminium case _zernok 3 490 06-23-2019, 08:00 AM
Last Post: rasputin
  Rock64 Stereo Audio DAC add-on board Hukmut 3 639 06-15-2019, 07:56 AM
Last Post: MiiCode2
  USB3 enough to power 2,5 external HDD? va88 11 603 06-06-2019, 03:40 PM
Last Post: va88
  How to check if my power supply is underperforming? va88 3 231 06-02-2019, 05:59 PM
Last Post: va88

Forum Jump:


Users browsing this thread: 1 Guest(s)