Support Apnea Board & OSCAR  

Difference between revisions of "OSCAR Installation: Chrome OS"

From Apnea Board Wiki
Jump to: navigation, search

(→‎How do I take a screenshot on a Chromebook?)
(→‎Install OSCAR)
 
(4 intermediate revisions by 3 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 />
−
To run OSCAR on a Chromebook, it must have a feature called '''Linux(Beta)''', also known as '''Crostini'''. If your ChromeBook supports Linux(Beta), then you can run OSCAR on it. If it doesn't, then you can't.
 
  
−
=== I'm thinking of buying a ChromeBook, how can I tell if it supports Linux(Beta)? ===
+
To install OSCAR, your Chromebook
−
To learn how to answer that, go to this page [[What ChromeBooks support Linux(Beta) aka Crostini?]]  <!-- If this is to be a short section, it's probably better to keep it in line rather than on a separate page. I think I went too far with separate pages in the Oscar Help system. -->
+
# 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]
 +
# and have the current Chrome OS
 +
# and the correct version of OSCAR for your Chromebook (This depends on the CPU your Chromebook has)
  
−
=== I already have a ChromeBook, how can I tell if it supports Linux(Beta)? ===
+
== Installation ==
−
<!-- This sentence doesn't really add any value You could follow the instructions above, but as you already have one, it's probably easiest to just see if it can be enabled. -->
+
=== Verify your Chromebook will work with Linux (Beta) and OSCAR ===
 +
# 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.
  
−
The first thing to do is to make sure your Chromebook is up to date.
+
== Update Chrome OS to the latest Version ==
−
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.
 
−
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.
 
−
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.
 
−
If it starts updating, then wait for it to finish, and then follow its instructions to restart.
 
  
−
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.
+
# Turn on your Chromebook.
−
If there is, then you need to enable it.  
+
# Connect your Chromebook to Wi-Fi.
−
Click in the "Turn On" box, and another windows will pop up saying "Install Linux (Beta) on your ChromeBook".
+
# At the bottom right, select the time. [[File:How-to-update-your-Chromebook-1.jpg|400px]]
−
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.
+
# Select Settings[[File:Settings.png|18px]]).
 +
# At the bottom of the left panel, select "About Chrome OS".  
 +
# 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]]
 +
# 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"
  
−
<!--  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.  -->
+
== Load Linux (Beta) ==
 +
if Linux (beta) is not installed load Linux (beta) per [https://support.google.com/chromebook/answer/9145439?hl=en 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.
 +
# 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
  
−
===What type of CPU do I have?===
+
=== Install OSCAR ===
−
Oscar has several versions, and you need to select the correct version to work with the CPU in your Chromebook. If you have enabled Linux(Beta), then the next stage in the installation process is to learn which kind of CPU your ChromeBook uses.
 
−
To do this:
 
−
*Open the browser, and type chrome://version and press enter
 
−
*You will see a list of headings in Bold type foolowed 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 normal font that looks like
 
−
*Mozilla/5.0 (X11; CrOS aarch64 12871.67.0)
 
  
−
or
+
# 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
 +
## OSCAR_x.x.x_Debian9_amd64
 +
## OSCAR_x.x.x_Debian9_arm64
 +
# 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
  
−
*Mozilla/5.0 (X11; CrOS x86_64 12871.67.0)
+
CLARIFICATION REQUIRED HERE
−
*We are interested in whether your ChromeBook says aarch64 or x86_64 on that first line after CrOS
+
NEED SECTION ON HOW TO SETUP SD CARD(may be fixed in next OSCAR releaser)
−
*If you see x86_64, then you will need the Oscar package with '''amd64''' in its name (see next section), or
+
If you launch it now...
−
*If you see aarch64, then you will need the Oscar package with '''arm64''' in its name.
+
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.
  
−
=== Does my ChromeBook have an SD Card slot? ===
+
After it's been done once, it will be simple.
−
It almost certainly does, but it might be a slot for a micro SD Card.
 
−
Most CPAP machines use a full size SD Card though.
 
−
 
 
−
If your ChromeBook has a micro SD Card slot, then you can still use it, but you must either
 
−
* Use a micro SD Card to full size SD Card adapter (many micro SD Cards are sold with one.
 
−
* 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).
 
−
 
 
−
===How do I take a screenshot on a Chromebook?===
 
−
You may need to create an image of what's on your Chromebook screen if you have problems installing Oscar.
 
−
 
 
−
  *Hold down the Ctrl + Switch window keys to capture a full screenshot.
 
−
  *Hold down the Ctrl + Shift + Switch window keys to capture a partial screenshot.
 
−
 
 
−
For a more detailed explanation go to this site: https://www.digitaltrends.com/computing/how-to-take-a-screenshot-on-a-chromebook/
 
−
 
 
−
At the moment, April 2020, and Chrome OS Versions 81 to 83, there may be a problem with having OSCAR take a screenshot for you. It will make a screenshot,
 
−
(which you might want to do to post a display of your CPAP results) but it may be all black, or have blue diagonal lines on a white background.
 
−
 
 
−
We expect the Chrome OS developers will fix this, but in the meantime, use the Chrome OS way of taking a screenshot. It still works just fine, either
 
−
as a full screen or partial selectable one.
 
−
Remember that ChromeBooks do not have function keys by default, and so all Oscar shortcuts using functions keys will be inaccessible with the function key. However they can all be invokes by another method.
 
  
−
== How do I install OSCAR on my ChromeBook? ==
+
=== Setup SD Card Reader (Linux) ===
  
−
Go to the [https://www.sleepfiles.com/OSCAR/ Oscar downloads page] <!-- Just use the link, not a description that is subject to confusion -->
+
It almost certainly does, but it might be a slot for a micro SD Card. Most CPAP machines use a full-size SD Card.
  
−
Go to that page on your Chromebook, and over on the right side, you'll see the two ChromeBook installation packages labelled
+
If your Chromebook has a micro SD card slot, then you can still use it, but you must either
−
OSCAR_1.1.0_Debian9_amd64
+
# Use a micro SD Card to full-size SD Card adapter.
−
OSCAR_1.1.0_Debian9_arm64
+
# 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).
  
−
Download the appropriate one for your CPU.
+
== end of article ==
−
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.
 
−
 
 
−
<!-- We can probably delete this bit as I've included the link above 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
 
−
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.  -->
 
−
 
 
−
 
 
−
=== 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? -->
 
−
<!-- We don't need to do this in Linux, it's simpler to do it from Chrome. -->
 
−
If you're still in Linux, return to the Chrome desktop .
 
−
 
 
−
<!-- 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-->
 
−
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  

Retrieved from "http://www.apneaboard.com/wiki/index.php?title=OSCAR_Installation:_Chrome_OS&oldid=7366"