Changeset 16457 in niluje


Ignore:
Timestamp:
Sep 7, 2019, 10:42:02 PM (12 days ago)
Author:
NiLuJe
Message:

Kindle Hacks:

  • USBNet:
    • Do a quick review pass on the doc.
Location:
Configs/trunk/Kindle
Files:
2 edited

Legend:

Unmodified
Added
Removed
  • Configs/trunk/Kindle/Hacks/USBNetwork/README_FIRST.txt

    r15504 r16457  
    3434usbnet (CONFIG_USB_USBNET) & cdc_ether (CONFIG_USB_NET_CDCETHER)
    3535
    36 (Still, a note to the poor Windows users: Yes, that means you'll need a non-default driver.)
     36(Still, a note to the poor Windows < 8 users: Yes, that means you'll need a non-default driver.)
    3737
    3838* Plug & mount your Kindle.
     
    7878;debugOff
    7979
    80 * Now, to actually connect to the device, we'll need to bring the shiny usb network interface
     80* Now, to actually connect to the device, we'll need to bring up the shiny usb network interface
    8181the kernel prepared for us. I'm assuming it's the only USB network interface in the system, so, usb0 on Linux.
    8282I'm also assuming the default usbnet config, ie. HOST_IP=192.168.2.1 & KINDLE_IP=192.168.2.2
     
    8585  On the K4, the defaults are different (to match Amazon's defaults in diags): HOST_IP=192.168.15.201 & KINDLE_IP=192.168.15.244
    8686
    87 Note to OS X users: You'll have to configure the network interface manually via OS X's GUI (cf. http://www.mobileread.com/forums/showpost.php?p=2895606&postcount=13).
     87Note to OS X users: You'll have to configure the network interface manually via OS X's GUI (c.f., http://www.mobileread.com/forums/showpost.php?p=2895606&postcount=13).
    8888
    8989If you're also using a Kindle Touch or a Kindle 4 in diags, make sure you update your settings accordingly if you use some
     
    173173Optionally use OpenSSH instead of dropbear.
    174174
    175 Bundles a number of useful tools (OpenSSH, rsync, mosh, sshfs, kindletool, htop, lsof, fbgrab, strace, ltrace, elfutils, nano, zsh, ag, gdb, tmux).
     175Bundles a number of useful tools (OpenSSH, rsync, mosh, sshfs, kindletool, htop, lsof, fbgrab, strace, ltrace, elfutils, nano, zsh, ag, gdb, tmux, among others, check the README for credits).
    176176
    177177The busybox build includes the full ash shell, and we also bundle zsh. Since they live in the userstore,
    178178do NOT change the default shell of an account to those. You can instead try to launch them automatically
    179179by abusing the command option in your authorized_keys file, or use local aliases.
    180 Don't forget to run login shells (usually by passing the -l to your shell).
     180Don't forget to run login shells (usually by passing the -l flag to your shell).
    181181
    182182The tethering scripts (Use Host networking on the Kindle) are in usbnet/bin/usbnet-*
  • Configs/trunk/Kindle/Touch_Hacks/USBNetwork/README_FIRST.txt

    r15032 r16457  
    3434usbnet (CONFIG_USB_USBNET) & cdc_ether (CONFIG_USB_NET_CDCETHER)
    3535
    36 (Still, a note to the poor Windows users: Yes, that means you'll need a non-default driver.)
     36(Still, a note to the poor Windows < 8 users: Yes, that means you'll need a non-default driver.)
    3737
    3838* Plug & mount your Kindle.
     
    6262
    6363* unmount & eject your Kindle
    64 (You might also want to unplug it, some devices behave strangely when toggling usbnet/usbms while plugged in).
     64(You might also want to unplug it, some devices behave strangely when toggling usbnet/usbms while plugged in.
     65If that's relevant on your specific device, the KUAL button will also warn you about it.).
    6566
    6667* On the Home screen, enter (in the search bar):
     
    7071* Your Kindle should now be detected as something like a RNDIS/Ethernet Gadget or CDC Ethernet Device network adapter.
    7172
    72 * Now, to actually connect to the device, we'll need to bring the shiny usb network interface
     73* Now, to actually connect to the device, we'll need to bring up the shiny usb network interface
    7374the kernel prepared for us. I'm assuming it's the only USB network interface in the system, so, usb0 on Linux.
    7475I'm also assuming the default usbnet config, ie. KINDLE_IP=192.168.15.244
    75 Note to OS X users: You'll have to configure the network interface manually via OS X's GUI (cf. http://www.mobileread.com/forums/showpost.php?p=2895606&postcount=13).
     76Note to OS X users: You'll have to configure the network interface manually via OS X's GUI (c.f., http://www.mobileread.com/forums/showpost.php?p=2895606&postcount=13).
    7677
    7778Also, if your distribution is using a recent udev version, it might be using the new predictable network interface names
     
    158159Optionally use OpenSSH instead of dropbear.
    159160
    160 Bundles a number of useful tools (OpenSSH, rsync, mosh, sshfs, kindletool, htop, lsof, fbgrab, strace, ltrace, elfutils, nano, zsh, ag, gdb, tmux).
     161Bundles a number of useful tools (OpenSSH, rsync, mosh, sshfs, kindletool, htop, lsof, fbgrab, strace, ltrace, elfutils, nano, zsh, ag, gdb, tmux, among others, check the README for credits).
    161162
    162163The busybox build includes the full ash shell, and we also bundle zsh. Since they live in the userstore,
    163164do NOT change the default shell of an account to those. You can instead try to launch them automatically
    164165by abusing the command option in your authorized_keys file, or use local aliases.
    165 Don't forget to run login shells (usually by passing the -l to your shell).
     166Don't forget to run login shells (usually by passing the -l flag to your shell).
    166167
    167168=== BUGS ===
    168169
    169170In order to avoid the "nothing is exported over usb ms" issue after an update,
    170 your Kindle will automatically switch back to USB MS before launching the update process.
     171your Kindle will automatically switch back to USB MS before launching the UYK update process.
    171172
    172173To that effect, I'd recommend properly exiting your shell sessions and unplugging your Kindle
    173174before launching an update, or wall will shout at you, and your terminal will freeze ;).
     175This is not an issue when you're using MRPI.
    174176
    175177In the same vein, if you're not actively debugging a boot process issue,
Note: See TracChangeset for help on using the changeset viewer.