Skip to content

Commit

Permalink
docs - printer and FAQ adjustments
Browse files Browse the repository at this point in the history
  • Loading branch information
odudex committed Mar 5, 2024
1 parent b444e90 commit 10037be
Show file tree
Hide file tree
Showing 2 changed files with 19 additions and 7 deletions.
20 changes: 16 additions & 4 deletions docs/faq.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,14 +3,26 @@ Some Amigo screens have inverted X coordinates while others don’t. If you noti

Others have found that there are issues with the colors displayed in the interface and camera preview. To fix this we have two options in `Settings > Hardware > Display`, `BGR Colors` and `Inverted Colors`, test with them until the colors appear to be correct on your device.

## Why isn't my Maix Amigo device being recognized when connected to the computer's USB?
Make sure you’re using the USB-C port at the bottom of the device, not the one on the left side. There could also be an issue with the cable. Try using a different cable to see if that resolves the problem. If you're connecting to a USB-C port on your desktop computer, you may need to shut down and restart the device while it's connected. This ensures the driver loads correctly and creates the necessary serial ports.
## Why isn't my device charging or being recognized when connected to the computer's USB?
If you have a Maix Amigo, make sure you're using the USB-C port at the bottom of the device, not the one on the left side.

Different computer hosts have varying hardware, operating systems, and behaviors regarding their USB ports. Below are the expected behaviors:

### USB-A:
Your device should charge and turn on when connected to a USB-A port, even if it was initially turned off. You can also turn off the device while it continues to charge. However, some hosts' USB-A ports may behave like USB-C ports, as described below.

### USB-C:

- If the device is turned off and connected to a USB-C port, it should turn on and start charging. You can turn it off again, and it will continue to charge.

- If the device is already turned on and connected to a USB-C port, it may not charge or be recognized by the computer. In this case, turn off the device to initiate recognition and charging. Once turned off and reconnected, the device should restart, be recognized by the computer, and charging should be triggered by USB-C hosts.
If your device is not charging or being recognized as expected, try using a different USB port or a different computer to determine if the issue is with the device or the host's USB port.

## Why isn't my M5stickV device being recognized and charged when connected to the computer's USB-C?
M5stickV's USB-C port lacks pull up resistors required for it to be recognized and powered by host(computer) USB-C ports. If you don't have an USB-A available, you can use a USB hub connected between your computer's USB-C and M5stickV

## Why does my Krux device randomly freeze or restart when connected to the computer? Why doesn't my device (which has a battery) charge when connected to power?
Windows is known to have issues with the USB-C devices. If you are experiencing random crashes or even reboots, try using a phone charger or other power source such as a power bank. If your problem is with charging, it is expected that USB-A will always charge and turn on the device if it is turned off, you can also turn it off and continue charging. For USB-C, if it is turned off, it will turn on and start charging, it can also be turned off and continue charging, but if it is already turned on, it may not charge, nor be recognized by the computer, it must be turned off to be recognized, it will restart, it will be recognized and USB-C hosts will trigger charging.
## Why does my Krux device randomly freeze or restart when connected to the computer?
Windows is known to have issues with the USB-C devices. If you are experiencing random crashes or even reboots and your device does not have a battery, try using a phone charger or other power source such as a power bank.

## Why won't my Linux OS list a serial port after connecting my device?
If you get the following error when trying to flash your device: `Failed to find device via USB. Is it connected and powered on?`
Expand Down
6 changes: 3 additions & 3 deletions docs/parts.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,9 +69,9 @@ sd-card-info-faq.md
The size of the SD card isn't important; anything over a few megabytes will be plenty.

### (Optional) Thermal Printer
Krux has the ability to print all QR codes it generates, including mnemonic, xpub, wallet backup and signed PSBT, via a locally-connected thermal printer over its serial port.
Krux has the capability to print all QR codes it generates, including those for mnemonics, xpubs, wallet backups, and signed PSBTs, using a locally-connected thermal printer via its serial port.

Many thermal printers may work, but the [Adafruit printer starter pack](https://www.adafruit.com/product/600) would be the easiest way to get started, as it includes all the parts needed to print (except the conversion cable). Make sure to enable the printer driver and set the baudrate value in [settings](./getting-started/settings.md/#thermal) for 19200 or 9600 as explained in this [Adafruit printer tutorial](https://learn.adafruit.com/mini-thermal-receipt-printer/first-test). You will also need to connect 2 cables, the device TX to the printer RX and ground. For more info, [see this discussion](https://github.com/selfcustody/krux/discussions/312).
Many thermal printers may be compatible, but currently, the Goojprt QR203 (easily found on AliExpress) has the best support. The [Adafruit printer starter pack](https://www.adafruit.com/product/600) can also be a convenient option to get started, as it includes all the necessary components for printing (except the conversion cable). To ensure proper functionality, enable the printer driver in the [Krux settings](./getting-started/settings.md/#thermal), set the Tx pin and baud rate value to either 19200 or 9600, as explained in this [Adafruit printer tutorial](https://learn.adafruit.com/mini-thermal-receipt-printer/first-test). You will need to connect the device's Tx to the printer's Rx and ground. The printer requires a dedicated power supply, typically with an output of 5 to 9V and capable of supplying at least 2A. For more information, [see this discussion](https://github.com/selfcustody/krux/discussions/312).

### (Optional) Conversion Cable for Thermal Printer
To connect the printer to the device, you will need a [conversion cable](https://store-usa.arduino.cc/products/grove-4-pin-male-to-grove-4-pin-cable-5-pcs) with a 4-pin female Grove connector on one end (to connect to the device) and 4-pin male jumpers on the other end (to connect to the printer).
To connect the printer to the device, you will need a [conversion cable](https://store-usa.arduino.cc/products/grove-4-pin-male-to-grove-4-pin-cable-5-pcs)with a 4-pin female Grove connector on one end (to connect to the device) and 4-pin male jumpers on the other end (to connect to the printer). For a more reliable connection, it is recommended to cut and solder the wires of your custom cables instead of using jumpers.

0 comments on commit 10037be

Please sign in to comment.