Support Apnea Board & OSCAR  

Difference between revisions of "OSCAR Installation: Chrome OS"

From Apnea Board Wiki
Jump to: navigation, search

(If you launch it now...: Notes about navigation)
(Install OSCAR)
 
(14 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{incomplete}}
 
  
A ChromeBook is a laptop, while a ChromeBox is a box to which you connect your own mouse, keyboard and monitor.
+
== Requirements ==
In this wiki, we will use the term ChromeBook to cover both.
+
Chromebook is a laptop. <br />
  
== Can I install OSCAR on a ChromeBook or a ChromeBox? ==
+
Chromebox is a computer without a monitor, keyboard, or mouse. To install OSCAR on a Chromebox, the user must first connect the additional hardware: keyboard, mouse, and monitor.<br />
If it is a recent one, then you can.
 
  
== Linux(Beta) ==
+
The OSCAR installation procedure is the same for both the Chromebook and Chromebox. In the following directions, the term Chromebook refers to both the laptop and the Chromebox.<br />
The feature added to recent ChromeBooks is called Linux(Beta). You may also find this feature described by the codeword Crostini. If you ChromeBook supports Linux(Beta), then you can run OSCAR on it. If it doesn't, then you can't.
 
  
== Does my ChromeBook have an SD Card slot? ==
+
To install OSCAR, your Chromebook
It almost certainly does, but it might be a slot for a micro SD Card.  
+
# must support Linux (Beta), also known as Crostini, [https://sites.google.com/a/chromium.org/dev/chromium-os/chrome-os-systems-supporting-linux chrome-os-systems-supporting-linux]
Most CPAP machines use a full size SD Card though.
+
# and have the current Chrome OS
 +
# and the correct version of OSCAR for your Chromebook (This depends on the CPU your Chromebook has)
  
If your ChromeBook has a micro SD Card slot, then you can still use it, but you must either
+
== Installation ==
* Use a micro SD Card to full size SD Card adapter (many micro SD Cards are sold with one.
+
=== Verify your Chromebook will work with Linux (Beta) and OSCAR ===
* Use your full size SD Card with a USB adapter which will fit in a USB port in your ChromeBook. (Some ChromeBooks may have only USB-C ports, so check this before buying an adapter).
+
# Click on the following link to determine if a Chromebook is able to support Linux (Beta) / Crostini: [https://sites.google.com/a/chromium.org/dev/chromium-os/chrome-os-systems-supporting-linux chrome-os-systems-supporting-linux]
+
# From that link: Unless otherwise specified, all devices launched in 2019 will support Linux (Beta).
 +
# As of OS version 91, Linux is no longer in Beta. Ignore further mentions of (Beta).
 +
# If your Chromebook is listed, verify whether or not Chromebook has Linux (Beta) / Crostini
 +
## At the bottom right of the Chromebook page, select the time.
 +
## Select Settings [[File:Settings.png|18px]]
 +
## Under "Linux (Beta)," See the Linux status (Screenprint needed)
 +
# If purchasing a new Chromebook, ensure the Chromebook is listed on the link [https://sites.google.com/a/chromium.org/dev/chromium-os/chrome-os-systems-supporting-linux chrome-os-systems-supporting-linux].
 +
# If the Chromebook does not support Linux (Beta) / Crostini, OSCAR cannot be installed.
  
== I'm thinking of buying a ChromeBook, how can I tell if it supports Linux(Beta)? ==
+
== Update Chrome OS to the latest Version ==
To learn how to answer that, go to this page [[What ChromeBooks support Linux(Beta) aka Crostini?]]
 
  
== I already have a ChromeBook, how can I tell if it supports Linux(Beta)? ==
+
# Turn on your Chromebook.
You could follow the instructions above, but as you already have one, it's probably easiest to just see if it can be enabled.  
+
# Connect your Chromebook to Wi-Fi.
=== The first thing to do is to make sure your Chromebook is up to date. ===
+
# At the bottom right, select the time. [[File:How-to-update-your-Chromebook-1.jpg|400px]]
If a ChromeBook is left on and connected to the Internet, it will update itself, and then ask you to restart it so it uses the latest version.
+
# Select Settings[[File:Settings.png|18px]]).
But we want to make sure, so, on your ChromeBook, go to Settings->About Chrome OS and see if there are any updates to apply.
+
# At the bottom of the left panel, select "About Chrome OS".  
You do this by going to the settings page (which is accessed by clicking on the little toothed gear symbol) and then finding the legend "About Chrome OS" over to the left and clicking on that. Then you should see a box up towards the top that says "Check for Updates". Click on that, and it will either tell you that you are up to date, or else start updating your system.
+
# Under "Google Chrome OS," you will find which version of the Chrome operating system your Chromebook uses. [[File:How-to-update-your-Chromebook-2.jpg|400px]]
If it starts updating, then wait for it to finish, and then follow its instructions to restart.
+
# Select "Check for updates".  
 +
# If your Chromebook finds a software update, it will start to download automatically.
 +
# If Update was found, after downloading you will see "Update available<br />
 +
RESTART TO UPDATE, Click on "RESTART TO UPDATE"
  
After the restart, or if your ChromeBook was up to date, go back to the Settings Page, and see if there is an option for "Linux(Beta)". If you do not have this option, then you can not install OSCAR.
+
== Load Linux (Beta) ==
If there is, then you need to enable it.  
+
if Linux (beta) is not installed load Linux (beta) per [https://support.google.com/chromebook/answer/9145439?hl=en Chromebook Supports Linux (Beta)]
Click in the "Turn On" box, and another windows will pop up saying "Install Linux (Beta) on your ChromeBook".
+
This is the Vendor Installation document.
Click on the Install button, and after the progress bar finishes, a window with a black background will come up, looking a bit like a neater version of the old MS-DOS window.
+
=== ID Chromebook CPU type ===
 +
OSCAR runs on multiple platforms, The CPU on your machine is a determining factor in which download of OSCAR is needed. We are looking for either aarch64 or x86_64.
 +
# Open the browser, and type chrome://version and press enter
 +
# You will see a list of headings in Bold type followed by a colon, on the left-hand side of the page.
 +
# To the right of that there will be lots of information about Chrome and Chrome OS
 +
# Look for the left side heading User-Agent:
 +
# to the right of that there will be a line in the normal font that looks like
 +
## Mozilla/5.0 (X11; CrOS aarch64 12871.67.0) or
 +
## Mozilla/5.0 (X11; CrOS x86_64 12871.67.0)
 +
# We are interested in whether your Chromebook says after the first line after CrOS
 +
## aarch64
 +
### If you see aarch64, then you will need the OSCAR package with arm64 in its name
 +
## x86_64
 +
### If you see x86_64, then you will need the OSCAR package with amd64 in its name
  
<!--  There are an awful of of words here. It's very very hard to follow as written. I strongly suggest re-writing this section with some images.  -->
+
=== Install OSCAR ===
  
=== If you have enabled Linux(Beta), then the next stage in the installation process is to learn which kind of CPU your ChromeBook uses. ===
+
# Go to the OSCAR Download page at https://www.sleepfiles.com/OSCAR/ on your Chromebook, on the right side under Linux, you'll see the two Chromebook installation packages labeled
To do this, open the browser, and type chrome://system and press enter
+
## OSCAR_x.x.x_Debian9_amd64
Search <!-- "Search" implies you're using a software search tool - is this the case? If not use "Look for" -->for the term "uname". To the right of uname, you will see text that tells you what type of CPU you have. this will likely be AMD, or Intel, or you may see aarch64 or ARMv8.
+
## OSCAR_x.x.x_Debian9_arm64
If you see Intel or AMD, then you will need the Oscar package with amd64 in its name (see next section), or if you see aarch64 or ARMv8, then you will need the Oscar package with arm64 in its name.
+
# Download the appropriate one for your CPU. See '''ID Chromebook CPU type''' above, and save it.  Make a note of this location, you will need it for the next step.
 +
# Install the .deb file that you downloaded.
 +
## If you're still in Linux, return to the Chrome desktop.
 +
## Now open the Chrome Files App, and go to the folder with the OSCAR package that you downloaded. It will show as a .deb file (eg OSCAR_xxxxx.deb)
 +
## When you find it, we can open it and install it
  
== How do I install OSCAR on my ChromeBook? ==
+
CLARIFICATION REQUIRED HERE
 +
NEED SECTION ON HOW TO SETUP SD CARD(may be fixed in next OSCAR releaser)
 +
If you launch it now...
 +
If we are successful, we will be given a small square window that asks us to select our language as English. When you get to this point, or if you see OSCAR start up, then you are halfway there, but please STOP NOW and don't go any further. The next part of the installation on Chrome will be to create a profile and then to import from an SD Card. You may have made a profile before, and you may have imported from an SD Card before, but importing from an SD card on Chrome OS for the first time is quite different, so do NOT try it until you have gone back to and read all of the instructions about how to do it.
  
Go to the [https://www.sleepfiles.com/OSCAR/ Oscar downloads page] <!-- Just use the link, not a description that is subject to confusion -->
+
After it's been done once, it will be simple.
 
 
Go to that page on your Chromebook, and over on the right side, you'll see the 2 ChromeBook installation packages labelled
 
OSCAR_1.1.0_Debian9_amd64
 
OSCAR_1.1.0_Debian9_arm64
 
 
 
Download the appropriate one.
 
Your Chrome browser will probably ask you to save it, probably in your Downloads folder, so go ahead and do that.
 
If it didn't ask you, it put it in Downloads. Make a note of this location, you'll need it for the next step.
 
  
I'll include one more link that tells you how to take a screenshot on a Chromebook, so you can post a screenshot of any difficulty you have. It is
+
=== Setup SD Card Reader (Linux) ===
omg chrome.com/ take-screenshot-chromebook-chromeos  I'll need permission for this link; it's only required if we wish to support users in this way.
 
That isn't my call:mjphyi  DeepBreathing says: Links are OK so long as they comply with our commercial rules - No sites owned by a DME and no sites with a {Buy} button. Otherwise OK.
 
  
 +
It almost certainly does, but it might be a slot for a micro SD Card. Most CPAP machines use a full-size SD Card.
  
=== What you need to do now is to install the .deb file that you downloaded. === <!-- I didn't know that I downloaded a .deb file! I thought I downloaded Oscar! What's the story? -->
+
If your Chromebook has a micro SD card slot, then you can still use it, but you must either
<!-- We don't need to do this in Linux, it's simpler to do it from Chrome. -->
+
# Use a micro SD Card to full-size SD Card adapter.
If you're still in Linux, return to the Chrome desktop .
+
# Use your full-size SD Card with a USB adapter that will fit in a USB port in your Chromebook. (Some Chromebooks may have only USB-C ports, so check this before buying an adapter).
  
<!-- Do you know where the file was saved? You may have had your browser set to save it in your Downloads folder, or you may have had it set to ask you where to save anything (in which case, you probably know). Either way, n-->
+
== end of article ==
Now open the Chrome Files App, and go to the folder with the Oscar package that you downloaded. It will show as a .deb file (eg Oscar_blah_blah.deb)
 
                                         
 
When you find it, we can open it and install it from the files App.
 
If you are on a ChromeBox, then you are probably using a mouse, while if you are using a ChromeBook, you might be using a mouse, or you may be using the trackpad that is below the keyboard. Your trackpad supports a click anywhere in the trackpad the same way as it supports a left click with a 2 or 3 button mouse.
 
 
A mouse right click is sometimes useful, and you can get the same effect by holding down the Alt key and clicking in the touchpad.
 
If a mouse right click is required in these instructions, it will be shown as Alt-touchpad-click and as Mouse-right-click. Pick one, don't do both.
 
mjphyi has noticed that although the above paragraph is correct, right clicking isn't going to be required when installing Beta-2 or later up to this point.
 
It WILL be required as part of importing for the first time, and it will be repeated there, but maybe it'll disappear from here.
 
Note that each line is indented, causing that text to appear in a box - useful for asides like this which interrupt the flow of the narrative.
 
 
 
In the Chrome Files App, double click on the name of the install package that you downloaded.
 
needs fleshing out, may need pictures:mjphyi
 
It will then tell you that is has successfully started to install
 
After a while it will tell you that the install has been successful, and invite you to launch it.
 
You can launch it now, and you can also close the window that told you that invited you to install it.
 
 
 
== '''If you launch it now...''' ==
 
If we are successful, we will be given a small square window that asks us to select our language as English.
 
When you get to this point, or if you see OSCAR start up, then you are halfway there, but please '''STOP NOW''' and don't go any further.
 
The next part of installation on Chrome will be to create a profile and then to import from an SD Card.
 
You may have made a profile before, and you may have imported from an SD Card before, but importing from an SD card on Chrome OS for the first time is quite different, so do '''NOT''' try it until you have gone back to <!-- the page above this one, Don't use this sort of terminology else people will quickly get lost in the wiki. Put the section name and a link --> and read all of the instructions about how to do it.
 
 
 
After it's been done once, it will be simple.
 

Latest revision as of 20:25, 13 May 2024

Requirements

Chromebook is a laptop.

Chromebox is a computer without a monitor, keyboard, or mouse. To install OSCAR on a Chromebox, the user must first connect the additional hardware: keyboard, mouse, and monitor.

The OSCAR installation procedure is the same for both the Chromebook and Chromebox. In the following directions, the term Chromebook refers to both the laptop and the Chromebox.

To install OSCAR, your Chromebook

  1. must support Linux (Beta), also known as Crostini, chrome-os-systems-supporting-linux
  2. and have the current Chrome OS
  3. and the correct version of OSCAR for your Chromebook (This depends on the CPU your Chromebook has)

Installation

Verify your Chromebook will work with Linux (Beta) and OSCAR

  1. Click on the following link to determine if a Chromebook is able to support Linux (Beta) / Crostini: chrome-os-systems-supporting-linux
  2. From that link: Unless otherwise specified, all devices launched in 2019 will support Linux (Beta).
  3. As of OS version 91, Linux is no longer in Beta. Ignore further mentions of (Beta).
  4. If your Chromebook is listed, verify whether or not Chromebook has Linux (Beta) / Crostini
    1. At the bottom right of the Chromebook page, select the time.
    2. Select Settings Settings.png
    3. Under "Linux (Beta)," See the Linux status (Screenprint needed)
  5. If purchasing a new Chromebook, ensure the Chromebook is listed on the link chrome-os-systems-supporting-linux.
  6. If the Chromebook does not support Linux (Beta) / Crostini, OSCAR cannot be installed.

Update Chrome OS to the latest Version

  1. Turn on your Chromebook.
  2. Connect your Chromebook to Wi-Fi.
  3. At the bottom right, select the time. How-to-update-your-Chromebook-1.jpg
  4. Select SettingsSettings.png).
  5. At the bottom of the left panel, select "About Chrome OS".
  6. Under "Google Chrome OS," you will find which version of the Chrome operating system your Chromebook uses. How-to-update-your-Chromebook-2.jpg
  7. Select "Check for updates".
  8. If your Chromebook finds a software update, it will start to download automatically.
  9. If Update was found, after downloading you will see "Update available

RESTART TO UPDATE, Click on "RESTART TO UPDATE"

Load Linux (Beta)

if Linux (beta) is not installed load Linux (beta) per Chromebook Supports Linux (Beta) This is the Vendor Installation document.

ID Chromebook CPU type

OSCAR runs on multiple platforms, The CPU on your machine is a determining factor in which download of OSCAR is needed. We are looking for either aarch64 or x86_64.

  1. Open the browser, and type chrome://version and press enter
  2. You will see a list of headings in Bold type followed by a colon, on the left-hand side of the page.
  3. To the right of that there will be lots of information about Chrome and Chrome OS
  4. Look for the left side heading User-Agent:
  5. to the right of that there will be a line in the normal font that looks like
    1. Mozilla/5.0 (X11; CrOS aarch64 12871.67.0) or
    2. Mozilla/5.0 (X11; CrOS x86_64 12871.67.0)
  6. We are interested in whether your Chromebook says after the first line after CrOS
    1. aarch64
      1. If you see aarch64, then you will need the OSCAR package with arm64 in its name
    2. x86_64
      1. If you see x86_64, then you will need the OSCAR package with amd64 in its name

Install OSCAR

  1. Go to the OSCAR Download page at https://www.sleepfiles.com/OSCAR/ on your Chromebook, on the right side under Linux, you'll see the two Chromebook installation packages labeled
    1. OSCAR_x.x.x_Debian9_amd64
    2. OSCAR_x.x.x_Debian9_arm64
  2. Download the appropriate one for your CPU. See ID Chromebook CPU type above, and save it. Make a note of this location, you will need it for the next step.
  3. Install the .deb file that you downloaded.
    1. If you're still in Linux, return to the Chrome desktop.
    2. Now open the Chrome Files App, and go to the folder with the OSCAR package that you downloaded. It will show as a .deb file (eg OSCAR_xxxxx.deb)
    3. When you find it, we can open it and install it

CLARIFICATION REQUIRED HERE NEED SECTION ON HOW TO SETUP SD CARD(may be fixed in next OSCAR releaser) If you launch it now... If we are successful, we will be given a small square window that asks us to select our language as English. When you get to this point, or if you see OSCAR start up, then you are halfway there, but please STOP NOW and don't go any further. The next part of the installation on Chrome will be to create a profile and then to import from an SD Card. You may have made a profile before, and you may have imported from an SD Card before, but importing from an SD card on Chrome OS for the first time is quite different, so do NOT try it until you have gone back to and read all of the instructions about how to do it.

After it's been done once, it will be simple.

Setup SD Card Reader (Linux)

It almost certainly does, but it might be a slot for a micro SD Card. Most CPAP machines use a full-size SD Card.

If your Chromebook has a micro SD card slot, then you can still use it, but you must either

  1. Use a micro SD Card to full-size SD Card adapter.
  2. Use your full-size SD Card with a USB adapter that will fit in a USB port in your Chromebook. (Some Chromebooks may have only USB-C ports, so check this before buying an adapter).

end of article




Donate to Apnea Board