#lurk_docs

1 messages · Page 1 of 1 (latest)

cursive cargoBOT
#

👋 Welcome to your new thread!

⏲️ We'll be here soon! Typically we respond in a few minutes, but sometimes we might take a bit longer if the server is busy or if you have a particularly tricky question.

⏱️ We close idle threads, which makes them read-only. Once a thread is closed it won't be reopened, but you can always start a new thread if you have another question.

🔗 This thread will always be available, even after it's closed. You can find it again using Discord's search, or you can save this link: https://discord.com/channels/841573134531821608/1433766287615594517

📝 Have more to share? Add more details, code, screenshots, videos, etc. below.

elder sluice
#

👋 Hi there! Let me take a look

cyan tapir
#

Hey Arran, thanks!

elder sluice
#

Since each Terminal location can have a different configuration, and locations can be in different countries (which can require different software config to be downloaded to the reader), I think that's what it refers to

cyan tapir
#

I think how the location factors into this requirement is still confusing me a bit. The wording in the doc sounds like maybe a specific firmware version can be tied to a location somehow? I looked at the Terminal Configurations doc and didnt see any mention of reader firmware though.

#

Say my reader has always had the same location and has updated from that location before. Say my reader is on firmware version "2.01.00.36". If the latest required firmware update is "2.01.00.38" (the most recent update available), how would that flow with the ""The reader runs the latest software version for the location within the last 30 days." requirement?

elder sluice
#

From that page, it says this:

The software on the Stripe Reader M2 consists of a firmware version, configuration name, and key identifier. The reader software version joins these three components with underscores into a single string.

I believe the location is referring to the configuration. e.g. you can see that the configuration is for US in the example below it.

cyan tapir
#

Would a reader connection attempt succeed or fail in that case?

elder sluice
#

2.01.00.38 is newer than 2.01.00.36 — that's the only thing you need to care about, I would say

cursive cargoBOT
cyan tapir
#

If im on version .36, is that the "latest" version for my location/configuration?

(Meaning I'd satisfy this "latest software version" requirement, and be able to still connect despite a failed update?)

true oxide
#

Hey! Taking over for my colleague. Let me catch up.

cyan tapir
#

Maybe another way of asking this question is: How old does my reader's software version have to be in order for me to fail the above requirement?

true oxide
#

Sorry not sure I understand the context here well, but why not updating to the latest version simply ?

cyan tapir
#

Sorry, the question I had was regarding a specific case with reader updates mentioned in the docs.

Per the docs, if a required update fails, we cannot connect to the reader unless:
The reader runs the latest software version for the location within the last 30 days.
The Android SDK version is greater than or equal to 3.5.0.

If these conditions are met, the connection is successful despite the failed update.

My question was about the first requirement.

What does "latest" mean in this context? What does "for the location" mean here?

cyan tapir
# true oxide Sorry not sure I understand the context here well, but why not updating to the l...

I'm looking at the "LOW_BATTERY" update type here: https://docs.stripe.com/terminal/references/testing?terminal-sdk-platform=android#simulated-reader-updates

"A required update starts to install but fails due to the reader running low on battery. Connecting to the reader also fails. This simulates the reader running an older version of software."

This is the scenario I want clarity on. This appears to be the case where a reader's software is too old to proceed despite a failed update. How old is too old? The only recourse here is to charge the reader battery and update, correct?

true oxide
#

What does "latest" mean in this context? What does "for the location" mean here?
Some readers are supported in multiple location (country) so here it refers to the latest version of that location/country

#

M2 is supported only in US so there is only one latest version at a given moment

#

How old is too old?
There isn't a clear mention of this but I think this means couple of years ago

#

But why you can't update your readers to the latest version always while beeing on charge? I think you should consider this in order to avoid all these edge cases.

cursive cargoBOT
cyan tapir
#

Semi-related question: For the android terminal sdk, is there any way to check if a reader has a required update available, before attempting to connect to it?

true oxide
#

By "being on charge" do you mean when the reader is plugged in and/or fully charged? If so I agree, seems to be a good rule of thumb.
Yes

true oxide
#

If the reader has screen, you should be able to see it's version from there