User Manual Prototype for Khadas Beginners

Hello all,

We are toying with the idea of making a small (148mm x 105mm) user manual for beginner Khadas users, likely in English and Chinese, that will be placed into the product box. Please have a look and let us know your thoughts. :slight_smile:

It is meant as a ā€œuniversal manualā€ for all Khadas products, which is a very tall order if you think of itā€¦everything you need to get started in something no larger than a human hand. So weā€™re attempting to gather peopleā€™s feedback, in order to build an approximation of the frequently asked questions, that should be included.

Thanks,
You Jun

1 Like

I donā€™t think itā€™s necessary.

The DOC on the official website is very detailed.

The hardware experience of KHADAS is already very good and we hope to pay more attention to firmware maintenance.

There is a performance BUG in the 0907 firmware, but it has not been maintained for nearly 2 months.

5 Likes

@Terry will release new ROM for VIM3 soon.

Thanks for the feedback!

3 Likes

The idea is good, but it is more suitable for older people. Young people do not read paper instructions now; they are watching YouTube. And the Khadas products are consumed mainly by young people and adult men. It is advisable to make video instructions - this will bring more success and user convenience and help the sale of goods. In paper form, I would put with the goods the pinout pinout diagrams + stickers on the case with the port designation. Thanks for the good product!

6 Likes

Older people
Pleaseā€¦
Instructions are for those who donā€™t live on the edge

Not Guts no Glory
Well just my opinion :smiley::smiley:

5 Likes

Might be nice to have a business sized card with the GPIO legend, for quick reference.

6 Likes

If the guide doc does not provide help info in Chinese, you donā€™t need to have the titles in English and Chinese. So remove the Chinese text and have more space for English text.

2 Likes

Videos are incredibly inefficient and are not easily searchable for specific information. You end up watching an entire 30 min video just in case it might have contained a single sentence worth of information that you needed to find (and often enough it does not, so all that time spent ends up flushed down the toilet). With a manual, you can look up the information instantly, perhaps read it in less than a minute or so.

Videos are useful when you need to see something being done that is not easily described in writing (assuming they are edited to be brief), but otherwise they waste valuable time.

Perhaps ā€œolderā€ people are not really so old fashioned and out of touch and just want to get things done quickly and efficiently without wasting time that could be spent on other things? Life is short, time wasted cannot be replaced. (:D)

3 Likes

Great idea!
Just tried booting my new EDGE-V from SD, with an Ubuntu image. Must have messed up on the key sequence to get into ā€˜upgradeā€™ mode because nothing happened, except for some LED changes. Now, the EDGE-V wonā€™t boot and thereā€™s no HDMI signal.:disappointed_relieved:
Came here hoping to find instructions regarding LED codes, a key press sequence guide, and/or info on boot ā€˜modesā€™, after searching Khadas site for over an hour.
Thanks for asking.:sunglasses:

btw, If you need a test dummy to ensure your instructions are fool-proof, Iā€™m your guy. :woozy_face:

@TheHermit did the instructions help?

They are from here: https://docs.khadas.com/vim2/BootFromExtMedia.html

Yea I remember my first time too. :smile:

Thanks for the quick reply. Yes, thatā€™s the document I was following. Near the bottom, thereā€™s a link to ā€œHow To Boot Into Upgrade Modeā€, with the following instructions:

"### Keys Mode (U-Boot is Running)*

  1. Power on VIM1.*
  2. Long press the Power key without releasing it.*
  3. Short press the ā€˜Resetā€™ key and release it.*
  4. Count to 10 seconds and release the ā€˜Powerā€™ key to enter into upgrade mode"

But, the instructions stop there. Is U-Boot already running in the firmware at power on?
Should there be HDMI output during the upgrade mode?

Also, I noticed that your prototype manual provides a different key sequence (3 quick presses of the Function key) in order to boot from the micro-SD card firmware. :thinking:
At the moment, thereā€™s a solid red LED and white heartbeat LED. When I attempt your 3 press sequence, the blue LED will light briefly, then it returns to solid red & white heartbeat.
Should I try the USB-C cable method to erase and re-image the eMMC?
Thanks for your assistance.

Hello, Does it boot if you remove the card?
Which Ubuntu image did you use?

@TheHermit there are usually only 1 or 2 problems regarding boot up from SD cards.

  1. Your SBC is a newer model, that can use the Khadas TST (press Function-Key 3 times), see: https://docs.khadas.com/vim3/HowtoBootIntoUpgradeMode.html
  2. You forgot to rename the .dtb file in your SD card, for example if youā€™re booting CoreELEC on a VIM3, youā€™ll need to rename the .dtb file to the one that says VIM3.
  3. In rare cases, the user had previously erased his EMMC, and there is no Android OS installed, and so it canā€™t enter the multiboot mode (rare, since all VIMs out-of-the-box have Android pre-installed)

Thanks again for you reply.
1: Yes, thatā€™s the doc I referred to. It mentions Multiboot mode, U-boot mode, Serial Mode, Upgrade mode, Maskrom mode, TST mode, and Upgroup mode. But, in most cases, it only explains how to initialize those modes without explaining what to do once in those modes or what kind of visual feedback the user should see to confirm progress.
2: I was trying to microSD boot into Edge_Ubuntu-lxde-bionic_Linux-4.4_arm64_SD-USB_V20190830.img, which was burned onto the microSD with Balena Etcher. It contains a /dtb folder with the Khadas dtb files. I assume that it is not necessary to rename Khadas dtb. (didnā€™t see any instructions about renaming dtb images)
3: Yes, Android was pre-installed on the eMMC. But, quit working after my failed attempt to boot from the SD card. Would be nice to understand what caused it, so I donā€™t do that again. But, now that Iā€™m here, how do I get out of this mess?:thinking:

1 Like

There is a combination of button pushes that erases the eMMC. Maybe that was done by accident.
Using a PC, the USB-C to A cable and the USB Burning Tool will get you back in business.
See here for guide. See here for firmware.

1 Like

Aha, that explains what happened to the eMMC. Thatā€™s good to know. Are those key sequences documented somewhere? A table would be very helpful.
Yes, I managed to use AndroidTool to erase and reimage the eMMC with
Edge_Ubuntu-lxde-bionic_Linux-4.4_arm64_EMMC_V20190830.img
But, it has display sync issues, so Iā€™m downloading the previous DTB. Hopefully, that will solve the display issue.
Meanwhile, with that partial success, I tried and succeeded in booting Ubuntu from SD card. :clap::clap::clap::clap:
So, things are looking much better, today.
Thank you for the guidance and putting me back on track. I hope my documentation suggestions are helpful.:sunglasses:

1 Like

Several methods exist to erase the eMMC, those, including the button(keys) method, can be found here.

Thanks. Just thought other new customers would wonder, ā€œWhat do these three buttons do?ā€ A concise function table in the Beginners Guide would answer that.
Thanks for your help.:sunglasses:

1 Like

Thanks for your feedback @TheHermit. Yes maybe the manual should just contain tables / diagrams of the GPIO, button presses, etc. And then just add links for more complicated procedures.

1 Like

Prototype GPIO and Button card, would this be useful @RDFTKV? :smile:


@TheHermit for the other SBCs, it would be possible to create a table describing the various functions (alone and in combination) of the buttons.

3 Likes